NAME

translate_frame - create unit to translate object(s)

PROTOTYPE

unitptr translate_frame( float x, float y, float z, unitptr host)

ARGUMENTS

float x
translation distance along x-axis
float y
translation distance along y-axis
float z
translation distance along z-axis
unitptr host
host unit for newly created instance

RETURN VALUE:

unitptr u:
pointer to newly created unit

INTERFACE OF CREATED UNIT:

X_in[3]:
(input field 0) additive offset to translation vector (x,y,z)

DESCRIPTION:

Creates a unit execution of which translates the coordinate frame used for rendering objects by a vector (x+X_in[0],y+X_in[1], z+X_in[2]) (the exec-routine of this unit is the GL-translate-routine). As a result, all objects rendered after a (single) execution of this unit will appear translated by (x+X_in[0],y+X_in[1], z+X_in[2]). Note that rotations effected by subsequent execution of rotate_frame- units will be about the origin of the new, i.e. translated coordinate frame.

EXAMPLES:

The program logo.c illustrates the use of the translate_frame-unit.

FILE

/local/homes/rhaschke/nst7/man/../o.linx86_64//../foldersrc/nst_solid.c