RenderWare V2.1

Previous Page Index Next Page

RwCamera *

RwSetCameraBackdrop(RwCamera *camera, RwRaster *raster);

Description

Sets the camera’s backdrop raster.

Arguments

camera Pointer to the camera.

raster Pointer to the raster.

Return Value

The argument camera if successful, and NULL otherwise.

Comments

To ensure that a camera has a visible backdrop it is not only necessary to set the camera’s backdrop but also to set the rectangle of the viewport which will be filled by the backdrop. As the default backdrop viewport rectangle has a width and height of 0 the backdrop will not be visible unless a non-empty rectangle is specified. This is accomplished by RwSetCameraBackdropViewportRect().

Areas of the viewport outside the backdrop viewport rectangle will be filled with the camera’s background color.

The backdrop raster associated with a camera is not destroyed automatically when the camera is destroyed. The backdrop raster (if any) must by explicitly destroyed by RwDestroyRaster().

See Also

RwDestroyRaster()

RwGetCameraBackdrop()

RwGetCameraBackdropOffset()

RwGetCameraBackdropViewportRect()

RwSetCameraBackColor()

RwSetCameraBackColorStruct()

RwSetCameraBackdropOffset()

RwSetCameraBackdropViewportRect()