intrinsic-177 FitTo3DWindow

177: FitTo3DWindow(Handle, Mode);

This intrinsic scales or positions a 3D object so it just fills its window. The program can use several different techniques for fitting an object to the window.

Arguments:

Handle. This argument is an integer handle created by the Add3DObject intrinsic. Any 3D Object including a frame, a mesh, strings, or lines can be fit to the window.

Mode. This is an integer value that specifies the way in which a visual

object is fitted to the screen. Here is a description of each mode:

0 = When this mode is selected, objects are fitted to window by moving the

camera in or out. This mode only works when the handle is -2, specifying the

handle for the whole scene. That means that all visible objects are fitted

at the same time. The objects in the scene are not modified in any way.

1 = When this mode is selected, the object specified by the Handle is fitted

to the window by moving the object nearer or farther from the camera. The

size of the object is not changed; only the position is changed. This mode

only affects the selected object.

2 = When this mode is selected, the object specified by the Handle is fitted

to the window by scaling the object to make it bigger or smaller. This mode

only affects the selected object. The scaling operation permanently modifies

the size of the object.