RenderWare V2.1

Previous Page Index Next Page

RwRaster *

RwReadRaster(char *filename, RwRasterOptions options);

Description

Reads a raster from the specified file. The raster will be processed according to the specified options.

Arguments

filename Name of the raster file.

options A bitfield representing a raster processing option (or "bitwise or" of options).

Return Value

A pointer to the new raster if successful, and NULL otherwise.

Comments

If filename is not a full path, the library searches for the specified file in all directories on its shape path.

The supported raster options are as follows:

• rwAUTODITHERRASTER Dither the raster only if the source bitmap is to be resized (rwFITRASTER has been specified) or if the bitmap is a different depth from the current RenderWare render depth.

• rwDITHERASTER Dither the raster.

• rwFITRASTER Resize the raster to texture map dimensions,
i.e. 128 x n * 128 (where n is the number of frames in a multi-frame texture).

• rwGAMMARASTER Gamma correct the raster.

See Also

RwBitmapRaster()

RwCreateRaster()

RwCreateTexture()

RwDestroyRaster()

RwDuplicateRaster()

RwGetDeviceInfo()

RwGetShapePath()

RwReadMaskRaster()

RwSetCameraBackdrop()

RwSetShapePath()

RwSetTextureDithering()

RwSetTextureGammaCorrection()

RwSetTextureRaster()