IG_mpi_file_save

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.