ImageGear for C and C++ on Windows v19.2 - Updated
IG_mpi_file_save_W
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Multi Page Image Functions > IG_mpi_file_save_W

This function saves a multi-page vector document to a file.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_mpi_file_save_W(
   const LPAT_WCHAR lpwszFileName,
   HMIGEAR hMIGear,
   UINT nStartPageFile,
   UINT nStartIndexDoc,
   UINT nPageCount,
   AT_MODE nFormat,
   AT_MODE nSaveMode
);

Arguments:

Name Type Description
lpwszFileName const LPAT_WCHAR Path and name of the file in which to save, specified as a wide string (UTF-16).
hMIGear HMIGEAR A HIGEAR handle to the multi-page vector document.
nStartPageFile UINT The page number in lpwszFileName after which pages from hMIGear are inserted. The first page is 0.
nStartIndexDoc UINT The page number of the first page in hMIGear to save. The first page is 0.
nPageCount UINT Total number of pages to save.
nFormat AT_MODE IG_FORMAT_PDF or IG_FORMAT_POSTSCRIPT format.
nSaveMode AT_MODE An AT_MODE constant (see enumIG_MPISaveMode).

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++. 

Remarks:

This function is only used for multi-page vector documents. The following formats are currently supported by this API:

This function may work slower on PDF and PostScript images that contain Unicode symbols in file names (symbols that are not present in the system's active code page), compared to images whose file names don't contain such symbols.