Image Export Functions

All of these functions will enable your application to convert a given ImageMan image handle into a readily-transferable image format, either in memory, on the clipboard, or on disk.

Memory based export functions:

ImgGetDIB Returns a packed DIB handle.

ImgGetDDB Returns a handle to a Windows DDB

ImgGetWMF Returns a handle to a Windows Metafile (vector images only)

ImgToClipboard Places an image on the Windows clipboard.

ImgXBeginWriteMem First part of the process of writing an image to a memory block.

ImgXWriteBlock Writes data to memory using the handle returned from ImgXBeginWriteMem.

ImgXEndWriteMem Completes the process of writing an image to memory.

Disk-based export functions:

These functions allow you to export a given image to a disk file in any one of several supported raster images (vector images cannot currently be written to disk). Most of these functions require a handle to a packed DIB; this is easily created from an ImageMan image handle via the ImgGetDIB function. These functions also require an Option Block for greatest control over the export process (an Option Block is simply a list of exporting options, i.e.: compression on or off, type of compression to use, etc.)

ImgXWriteImage This is the easiest way to export an image. Simply pass in the ImageMan image handle you want exported, and this function does the rest. Your application doesn't even need to know which image formats are available for export

ImgXWriteDIB This is the second easiest way to export an image. Simply pass in the DIB you want exported, and this function also does the rest. Again, your application doesn't even need to know which image formats are available for export.

ImgXBeginWrite / ImgXWriteBlock / ImgXEndWrite / ImgXWriteBMPBlock

These functions can be used to export an image in blocks (for instance, an extremely large image that doesn't fit into available memory) or whenever your application needs greater control over the export process. Use ImgXWriteBlock when exporting a Device Independent Bitmap (DIB), ImgXWriteBMPBlock when exporting a Device Dependent Bitmap (DDB).