GsSetView2

Sets the viewpoint position

int GsSetView2 (
        GsVIEW2 *pv
)

Arguments

pv Pointer to viewpoint position information (matrix type)

Return Value

0 is returned if the viewpoint was successfully set, otherwise, 1 is returned.

Explanation

The World Screen (WS) matrix is directly set from the viewpoint information pointed to by pv.
When GsSetRefView2() is used to determine the WS matrix from the viewpoint, errors may occur when the viewpoint is moved due to insufficient precision in the operation. For this reason it is usually better to use GsSetView2(). GsSetView2() should be called each frame if the GsRVIEW2 member super is set to anything other than WORLD. In this case, the viewpoint will move if the parameters of the parent coordinate system change even if the other viewpoint parameters have not changed.
If GsIDMATRIX2 is used as the base matrix, then the aspect ratio of the screen will be adjusted automatically.

See Also

GsVIEW2, GsWSMATRIX, GsSetRefView2()