LoadImage
Loads an image
Synopsis
ubyte * LoadImage (char *name, ubyte *dest, VdlChunk **rawVDLPtr, ScreenContext *sc)
Description
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).
Arguments
- 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.
Associated Files
lib3do.lib, displayutils.h
Return Value
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.
See Also
UnloadImage