The RenderMan Interface - Paul Bourke

This function marks the coordinate system defined by the current transformation
with the name space and saves it. This coordinate system can then be referred to by
name in subsequent shaders, or in RiTransformPoints. A shader cannot refer to a
coordinate system that has not already been named. The list of named coordinate
systems is global.
RIB BINDING
CoordinateSystem name
EXAMPLE
CoordinateSystem ”lamptop”
SEE ALSO
RiCoordSysTransform, RiTransformPoints
RiCoordSysTransform ( RtToken name )
This function replaces the current transformation matrix with the matrix that forms
the name coordinate system. This permits objects to be placed directly into special or
user-defined coordinate systems by their names.
RIB BINDING
CoordSysTransform name
EXAMPLE
CoordSysTransform ”lamptop”
SEE ALSO
RiCoordinateSystem
RtPoint *
RiTransformPoints ( RtToken fromspace, RtToken tospace, RtInt n, RtPoint points[] )
This procedure transforms the array of points from the coordinate system fromspace
to the coordinate system tospace. This array contains n points. If the transformation
is successful, the array points is returned. If the transformation cannot be computed
for any reason (e.g., one of the space names is unknown or the transformation requires
the inversion of a noninvertable transformation), NULL is returned.
EXAMPLE
RtPoint four points[4];
RiTransformPoints (”current,” ”lamptop,” 4, four points);
SEE ALSO
RiCoordinateSystem, RiProjection, RiWorldBegin
59