Main Page   Modules   Alphabetical List   Data Structures   Data Fields  

RtBMP
[Image Conversion Tools]


Functions
RwImage *  RtBMPImageRead (const RwChar *imageName)
RwImage *  RtBMPImageWrite (RwImage *image, const RwChar *imageName)

Detailed Description

BMP Image Format Toolkit for RenderWare.

See also http://www.daubnet.com/formats/BMP.html

RtBMP Toolkit Overview

Requirements

Overview

The RtBMP toolkit provides reading and writing functions for the BMP image format.

BMP stands for Bitmap, and is a standard Microsoft Windows image format. Supports paletted, 24 bit RGB color, and greyscale images. This format does not support alpha channels.

20/03/03: Added support for loading 32 bit RGB color BMPs, it's unclear whether these are valid in the BMP format without extended Bitmap headers specifying bit masks. However adding support was a trivial case of fixing the hard coded 3 byte per pixel scanline malloc which also has the benefit of reducing memory overhead for 4 and 8 bit Bitmap reading

Function Documentation

RwImage* RtBMPImageRead (  const RwChar *    imageName ) 
 

RtBMPImageRead is used to read a BMP file to create an RwImage.

The file name can either be absolute or relative to the directory the application is running from. The image search path is not used to find image files and no gamma correction is applied to the image as it is read.

Parameters:
imageName  Pointer to the filename of the BMP file to read.
Returns:
Returns an image on success, or NULL on failure.
See also:
RtBMPImageWrite , RwImageRead , RwImageWrite , RwImageRegisterImageFormat
RwImage* RtBMPImageWrite (  RwImage *    image,
const RwChar *    imageName
) 
 

RtBMPImageWrite is used to write an image as a BMP file.

The image file name can either be absolute or relative to the directory the application is running from.

Note that if the image has been gamma corrected using RwImageGammaCorrect, the gamma correction is not removed from the image before writing it to disk.

Parameters:
image  Pointer to the image to write
imageName  Pointer to the filename of the BMP file to write.
Returns:
Returns an image on success, or NULL on failure.
See also:
RtBMPImageRead , RwImageRead , RwImageWrite , RwImageRegisterImageFormat
Criterion Software © 1993-2003 Criterion Software Limited. All rights reserved. Built Tue Apr 22 12:46:53 2003. Send Feedback
Converted from CHM to HTML with chm2web Pro 2.85 (unicode)