This function allocates and initializes a new multi-page image and returns its handle.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_mpi_create(
LPHMIGEAR lphMIGear,
UINT nPages
);
|
|
Arguments:
| lpHMIGear | A pointer indicating where to return the handle of the allocated and initialized multi-page image. |
| nPage | The number of multi-page image pages that should be created. |
Return Value:
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
Supported Raster Image Formats:
All pixel formats supported by ImageGear Professional.
Sample:
MFC Multipage
Example:
| Copy Code |
|
|---|---|
HMIGEAR hMIGear; /* handle to multi-page image */ AT_ERRCOUNT nErrCount = IGE_SUCCESS; /* will hold returned error count */ nErrCount = IG_mpi_create( &hMIGear, 0 ); ... /* any operations with hMIGear */ nErrCount = IG_mpi_delete( hMIGear ); |
|
Remarks:
This new image is set with nPages. Each image is initialized with the default value NULL. If there is a failure, then the returned handle is NULL and an error is set.
The multi-page image is array of pages where each page is a HIGEAR object. All pages are numbered beginning with a 0 index, so that 0 - is the first page, 1 - is the second page, etc. If the image contains nCount number of pages, then its pages can be accessed through indexes 0 - nCount-1. The value of each page can be either NULL (default value) or value HIGEAR image.