IG_REC_output_format_next

Continues the enumeration of the document output formats and returns the name of the next one.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_output_format_next_get( LPSTR lpszFormatName, AT_INT nBufferLength );

Arguments:

Name	Type	Description
lpszFormatName	LPSTR	Buffer to receive the output format name.
nBufferLength	AT_INT	Length of the buffer.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
AT_ERRCOUNT ErrCount = 0; AT_ERRCODE ErrCode = IGE_SUCCESS; char *lpszFormatName = malloc(AM_MAX_OUTPUT_FORMAT_NAME_LEN); ErrCount += IG_REC_output_format_first_get(lpszFormatName, AM_MAX_OUTPUT_FORMAT_NAME_LEN); if(ErrCount == 0) { while(ErrCode == IGE_SUCCESS) { ErrCount += IG_REC_output_format_next_get(lpszFormatName, AM_MAX_OUTPUT_FORMAT_NAME_LEN); IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0); } } //... free(lpszFormatName);

Copy Code

AT_ERRCOUNT ErrCount = 0;
AT_ERRCODE ErrCode = IGE_SUCCESS;
char *lpszFormatName = malloc(AM_MAX_OUTPUT_FORMAT_NAME_LEN);

ErrCount += IG_REC_output_format_first_get(lpszFormatName, AM_MAX_OUTPUT_FORMAT_NAME_LEN);
if(ErrCount == 0)
{
    while(ErrCode == IGE_SUCCESS)
    {
        ErrCount += IG_REC_output_format_next_get(lpszFormatName, AM_MAX_OUTPUT_FORMAT_NAME_LEN);
        IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0);
    }
}

//...

free(lpszFormatName);

Remarks:

As soon as the function finds no further formats to get, the warning IGW_LAST_ITEM_REACHED is added to the warning stack. Function IG_warning_check() returns non-zero value in this case, signaling that the list is complete. Maximal length of the format name is AM_MAX_OUTPUT_FORMAT_NAME_LEN.