Loads an image

ubyte * LoadImage (char *name, ubyte *dest, VdlChunk **rawVDLPtr, ScreenContext *sc)

Loads a 3DO file format image file specified by name into the buffer pointed to by dest. May optionally return a VDL (Video Display List) if the image file specifies per line CLUTs (Color Lookup Tables).

• name Pointer to char string containing a path name of an image file in 3DO file format.

• dest Pointer to destination buffer. If dest is NULL, a page aligned VRAM buffer large enough to hold an image is allocated. If dest is not NULL, it is assumed to point to a page aligned VRAM buffer large enough to hold a screen image.

• rawVDLPtr Pointer to a pointer to a VDL structure. LoadImage() fills this structure if the image file contains a custom VDL.

• sc Pointer to a screen context.

lib3do.lib, displayutils.h

Returns a pointer to the destination buffer if successful, NULL if not. Note that the returned buffer may have been allocated by LoadImage() if the dest input parameter was NULL.

UnloadImage