RwCamera* RwCameraSetViewWindow ( RwCamera * camera,
const RwV2d * viewWindow
)
RwCameraSetViewWindow is used to set the size of the specified camera's view-window (in world units). The specified 2D vector represents the half-width and half-height of the view-window. The default view-window has dimensions (1.0, 1.0) giving a window 2.0 units on each side.
This function can be used to control the angular field-of-view of the camera. Larger values give a wider field-of-view while smaller values give a narrower view. Hence changing the size of the view-window gives the effect of a zoom-lens. Note that changing the size of the view-window does not alter the size of the camera's image raster, so unless the aspect ratios match, the resulting image will be distorted to conform to the image raster's aspect ratio.
Note:
This function should not be called between RwCameraBeginUpdate and RwCameraEndUpdate.
Parameters:
camera Pointer to the camera.
viewWindow An RwV2d describing the view-window dimensions.
Returns:
Returns pointer to the specified camera.