# 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``