M3ddispSetView

Same as M_AUTO.

Sets the viewpoint and interest point position so that everything in the scene is within the view.

Sets the azimuth and elevation of the viewpoint relative to the interest point, and the roll of the view. These are the viewpoint position and up vector, described in a spherical coordinate system (additionally described by M_DISTANCE).

Azimuth is the angle of the viewpoint relative to the interest point on the XY-plane. An azimuth of 0 corresponds to a view where the viewpoint and interest point are parallel to the X-axis on the XY-plane, with the viewpoint on the positive side. Increasing values for the azimuth correspond to rotating the view counter-clockwise around the interest point.

Elevation is the angle of the viewpoint relative to the interest point on the XZ-plane. An elevation of 0 corresponds to a view where the viewpoint and interest point are parallel to the X-axis on the XZ-plane, with the viewpoint on the positive side. Increasing values for the elevation correspond to rotating the view counter-clockwise around the interest point in the XZ-plane.

Roll is the angle that describes how much the view is rotated to the right. A roll of 0 corresponds to a view for which up is positive on the Z-axis.

Sets the azimuth of the view.

Sets the distance between the viewpoint and the interest point.

Sets the elevation of the view relative to the interest point.

Sets the view to a position and orientation that is flipped around the interest point in the specified axis.

Sets the position of the interest point.

Sets the angle of the viewpoint's horizontal orbit around the interest point. This angle is used relative to the M_UP_VECTOR of the view. For more information, see the Orbit, up-vector, and distance subsection of the Manipulating the view section of Chapter 37: 3D Display and graphics.

Note that orbit is always specified relative to the current position of the view. For example, repeatedly using this function with M_ORBIT_HORIZONTAL and the value 90 will repeatedly orbit the viewpoint horizontally around the interest point, in 90 degree increments.

Sets the angle of the viewpoint's vertical orbit around the interest point. This angle is used relative to the M_UP_VECTOR of the view. For more information, see the Orbit, up-vector, and distance subsection of the Manipulating the view section of Chapter 37: 3D Display and graphics.

Note that orbit is always specified relative to the current position of the view. For example, repeatedly using this function with M_ORBIT_VERTICAL and the value 90 will repeatedly orbit the viewpoint vertically around the interest point, in 90 degree increments.

Sets the roll of the view. This is an angle which defines what direction the top of the view will be pointing, with 0 degrees specifying that the view will be perfectly level. As this value increases, the view rolls to the right.

Applies a translation to the viewpoint and interest point without altering their relative position and orientation.

Sets the vector which defines what direction the top of the view is pointing.

Note that this setting is normalized and adjusted to a unit vector that is orthogonal to the current orientation of the view. If you use M3ddispGetView() with M_UP_VECTOR after setting the up vector, the returned value will therefore typically be different from the vector you specified.

Sets the viewpoint and interest point (without altering the orientation) such that the interest point is at the center of the box and the entire region defined by the box is within view.

Sets the view to match a transformation matrix. If the transformation matrix is the identity matrix, the viewpoint will be at (0,0,1), with the interest point at the origin (0,0,0) and an up-vector of (0,1,0). This can also be thought of as a direct top-down view, with the up-vector aligned with the Y-axis.

You must specify the MIL identifier of a similarity transformation matrix. You can determine whether a transformation matrix is a similarity transformation matrix using M3dgeoInquire() with M_SIMILARITY.

Sets the direction in which the view is looking. This moves the viewpoint (or interest point if combined with M_MOVE_INTEREST_POINT) so that line of sight matches a given orientation, specified using either a predefined orientation or a vector that defines the direction from the viewpoint to the interest point.

Sets the position of the view.

Zooms the view in or out by a factor. This is equivalent to dividing M_DISTANCE by the specified factor.