RenderWare V2.1

Previous Page Index Next Page

RwBool

RwOpenExt(char *devname, void *param, RwInt32 numargs,
RwOpenArgument *args);

Arguments

devname The device name as a null-terminated string. Names currently supported under Windows are:

• "MSWindows"
• "NullDevice"

The "NullDevice" driver allows the library to be used when output to a display is not required (for instance, when reading from or writing to files).

param If you intend to use a Direct Draw bitmap in a full screen mode then the applications window handle should be passed in here. Otherwise this parameter can be NULL.

numargs The number of optional arguments specified.

args An array of optional open arguments.

Comments

RwOpenExt() takes a pointer to an array of RwOpenArgument structures. RwOpenArgument is defined as follows:

typedef struct
{
RwOpenOption option;
void *value;
} RwOpenArgument;

option is one of the identifiers defined below and value is a parameter specific to the option type. If the parameter type is integer, the integer value should be cast to a void *. For example;

args[0].value = (void *)10;

The configuration options supported under Windows are:

• rwGAMMACORRECT Controls whether RenderWare performs gamma correction on its color palette. value should be non-zero to enable gamma correction and zero to disable gamma correction.

• rwWINUSEDIBS If this option is specified RenderWare will use DIBs to handle its bitmaps. value is ignored. See the section "Overriding the Choice of Bitmap Type" for a full discussion of this option.

• rwWINUSERENDERDEPTH Forces RenderWare to use a rendering depth. The depth is specified in the option field of the RwOpenArgument structure and can currently only be 8 or 16. Conversion from the rendering depth to the display depth is operating system specific and may not work in some cases."

• rwAPPCANUSEFULLSCREEN Informs RenderWare that the application can handle a full screen only (i.e. no Windows) device. RenderWare will include such devices in the automatic device selection process.