## functions in pl3d.i - o

orient3

orient3, phi, theta or orient3, phi or orient3, , theta or orient3 Set the "orientation" of the object to (PHI,THETA). "Orientations" are a subset of the possible rotation matrices in which the z-axis of the object appears vertical on the screen (that is, the object z-axis projects onto the viewer y-axis). The THETA angle is the angle from the viewer y-axis to the object z-axis, positive if the object z-axis is tilted toward you (toward viewer +z). PHI is zero when the object x-axis coincides with the viewer x-axis. If neither PHI nor THETA is specified, PHI defaults to -pi/4 and THETA defaults to pi/6. If only one of PHI or THETA is specified, the other remains unchanged, unless the current THETA is near pi/2, in which case THETA returns to pi/6, or unless the current orientation does not have a vertical z-axis, in which case the unspecified value returns to its default. Unlike rot3, orient3 is not a cumulative operation. Interpreted function, defined at i/pl3d.i line 127SEE ALSO: rot3, mov3, aim3, save3, restore3, light3, limit3