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); |
|
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.