Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

:ROTATE

source files: [xc]tfm.[ch]

SYNTAX

(SEND <tfm> :ROTATE
    [ { :AXIS    | :TRANSFORMED-AXIS   } '( 1  0  0) ]
    [ { :ORIGIN  | :TRANSFORMED-ORIGIN } '(10 10 10) ]
    [ { :RADIANS | :DEGREES } 0.1 ] )
(SEND <tfm> :ROTATE-PRE  ... )   ; Same arg syntax as :ROTATE
(SEND <tfm> :ROTATE-POST ... )   ; Same arg syntax as :ROTATE

(SEND <tfm> :X-ROTATE      ... ) ; Same arg syntax as :ROTATE
(SEND <tfm> :X-ROTATE-PRE  ... ) ; Same arg syntax as :ROTATE
(SEND <tfm> :X-ROTATE-POST ... ) ; Same arg syntax as :ROTATE

(SEND <tfm> :Y-ROTATE      ... ) ; Same arg syntax as :ROTATE
(SEND <tfm> :Y-ROTATE-PRE  ... ) ; Same arg syntax as :ROTATE
(SEND <tfm> :Y-ROTATE-POST ... ) ; Same arg syntax as :ROTATE

(SEND <tfm> :Z-ROTATE      ... ) ; Same arg syntax as :ROTATE
(SEND <tfm> :Z-ROTATE-PRE  ... ) ; Same arg syntax as :ROTATE
(SEND <tfm> :Z-ROTATE-POST ... ) ; Same arg syntax as :ROTATE

DESCRIPTION

The first form sets <tfm> to rotate the world around the given origin and axis, through the given angle. A :TRANSFORMED- argument is transformed by the current value of <tfm> before being used.

If no axis is specified, it defaults to the Y axis.

If no origin is specified, it defaults to '(0 0 0).

If no angle is specified, it defaults to five degrees.

The second and third forms differ from the first only in that the computed transform, instead of replacing the original one, is pre- or post-multiplied with it to yield the replacement value.

The X- Y- and Z forms differ from the first three forms only in that the default axis of rotation is the X, Y or Z axis, respectively. :Y-ROTATE* is semantically identical to :ROTATE*, but is somewhat more efficient if only an angle is specified.

All the numeric parameters may be either fixnums or floats, in any combination.


Go to the first, previous, next, last section, table of contents.