---

Raster Types
[D3D9]

RwRasterType represents the choice of types of raster to create using RenderWare (see API function RwRasterCreate). These types are listed below along with D3D9 RenderWare Graphics specific information.

The format and dimensions of the raster are tested for compliance with the requirements of the video card drivers in the host machine. If they do not meet the requirements, they are adjusted to do so.

rwRASTERTYPENORMAL

This is the normal raster type. This type of raster can be used to store any pixel data. These rasters can be created at any size and any format, driver permitting, and may be locked. Note that some drivers may force the raster to take on specific dimensions, e.g. square and/or sides are a power-of-two.

rwRASTERTYPETEXTURE

This is the texture raster type. This type of raster may also be locked. Under RenderWare Graphics rwRASTERTYPETEXTURE rasters are treated as the same as rwRASTERTYPENORMAL rasters.

rwRASTERTYPECAMERA

This is the camera frame buffer raster. This raster is special under RenderWare Graphics since no storage is allocated to it by RenderWare. D3D9 manages this raster itself. This type of raster may be locked.

rwRASTERTYPECAMERATEXTURE

This is the camera texture raster which is similar to the rwRASTERTYPECAMERA format but may be the destination of a render. This may then be used as a texture in a future render. This type of raster may be locked.

Some video cards do not support camera textures. In these cases, a D3D9 texture is created that has the same format as the backbuffer. The backbuffer is then selected as the render target, and an area of it is later copied to that texture.

rwRASTERTYPEZBUFFER

This is the camera Z-buffer raster. The main Z-buffer is completely managed by D3D9. Any other Z-buffers are managed by RenderWare Graphics. This type of raster cannot be locked.

See also:

RwRasterCreate , RwRasterLock , RwRasterUnlock , RwRasterSetFromImage

---