IG_REC_converter_picture_saving_mode

Sets enumeration value indicating how the pictures will be saved in the output document.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_converter_picture_saving_mode_set( LPCSTR lpszFormatName, enumIGRecPictureSavingMode nPictures );

Arguments:

Name	Type	Description
lpszFormatName	LPCSTR	Symbolic name of the output format like Converters.Text.Cvs.
nPictures	enumIGRecPictureSavingMode	The enumIGRecPictureSavingMode enumeration value to be set.

Return Value:

The number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
AT_ERRCOUNT ErrCount = 0; AT_BOOL bCPSMIsApplicable = FALSE; LPCSTR lpszFormatName = "Converters.Text.Csv"; enumIGRecPictureSavingMode ePictureSavingMode = IG_REC_PICTURES_SAVE_300; ErrCount += IG_REC_output_format_set(lpszFormatName); ErrCount += IG_REC_converter_picture_saving_mode_is_applicable(lpszFormatName, &bCPSMIsApplicable); if(bCPSMIsApplicable) ErrCount += IG_REC_converter_picture_saving_mode_set(lpszFormatName, ePictureSavingMode);

Copy Code

AT_ERRCOUNT ErrCount = 0;
AT_BOOL bCPSMIsApplicable = FALSE;
LPCSTR lpszFormatName = "Converters.Text.Csv";
enumIGRecPictureSavingMode ePictureSavingMode = IG_REC_PICTURES_SAVE_300;

ErrCount += IG_REC_output_format_set(lpszFormatName);
ErrCount += IG_REC_converter_picture_saving_mode_is_applicable(lpszFormatName,
    &bCPSMIsApplicable);
if(bCPSMIsApplicable)
    ErrCount += IG_REC_converter_picture_saving_mode_set(lpszFormatName,
    ePictureSavingMode);

Remarks:

The function affects all output document formats.

Picture saving mode can't be set if the corresponding output format has not been selected with IG_REC_output_format_set at least once. In this case the function returns a non-zero value and appends IGE_REC_CONVERTER_NOT_INITIALIZED error code to the error stack.