DemoGL::Reference::Functions::DEMOGL_LoadingSplashEnable

DEMOGL_LoadingSplashEnable

DEMOGL_LoadingSplashEnable enables the viewing of a specified picture during startup of the application. This picture will be blended on top of the system console which is always visible during application startup. 

void
DEMOGL_LoadingSplashEnable(
	const char *pszSplashScreenTexture,
	const int iFileType, 
	const float fOpacity
);
Parameters.
pszSplashScreenTexture
Pointer to a zero-terminated string which holds the filename, inclusive relative path, that contains the picture that will be displayed as the splash screen.
iFileType
Specifies the filetype used in the file specified with pszSplashScreenTexture. iFileType can be one of the following values:

FileType Description
DGL_FTYPE_JPGFILE Imagedata stored using the JPEG format.
DGL_FTYPE_TGAFILE Imagedata stored using the TGA format.
DGL_FTYPE_BMPFILE Imagedata stored using the BMP format.
DGL_FTYPE_DDSFILE Imagedata stored using the DDS format (DirectX compressed: DXT1, DXT3 or DXT5 format).

fOpacity
The opacity of the splashscreen. This value is used as the alpha value of the splashscreen when it's blended on top of the system console. fOpacity can be a value in the range of [0.0, 1.0], with 0.0 totally transparent and 1.0 totally opaque.

Return values.

Remarks.
The splash screen is a screenwide quad textured with the texture in the file pszSplashScreenTexture, using the blending function glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA), and using fOpacity as alpha value in the white quad color. The splash screen is blended on top of the system console, which is always rendered, and below the loading progress bar. If the texture is stored in the DDS file format, be sure to store it upside down in the DDS tool of the directx sdk. This way it will appear correct in the console.

When loading a DDS file, the hardware has to support compressed textures, thus has to support the GL_ARB_texture_compression or GL_EXT_texture_compression extension.

Example.

Requirements.
DemoGL v1.3 (build 0112 or higher). For DDS file support: DemoGL v1.31 (build 0528 or higher) and support for compressed textures in hardware.

See also.

Last changed on 01-jun-2001

©1999-2001 Solutions Design