This function allows you to get full information about a control parameter supported by an ImageGear filter. It also returns the current or default value of the parameter.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCODE ACCUAPI IG_fltr_ctrl_get(
DWORD dwFormatID,
const LPCHAR lpcsCtrlName,
AT_BOOL bGetDefault,
LPAT_MODE lpnValueType,
LPDWORD lpdwValueSize,
LPVOID lpBuffer,
DWORD dwBufferSize
);
|
|
Arguments:
| Name | Type | Description |
| dwFormatID | DWORD | A constant indicating the format filter for which the information should be retrived. See enumIGFormats for possible values. |
| lpcsCtrlName | const LPCHAR | Specifies the name of the control parameter you want to get the info about. Use IG_fltr_ctrl_list to obtain the names of control parameters supported for a format filter. |
| bGetDefault | AT_BOOL | Set to TRUE to obtain the default value of the control parameter. Set to FALSE to obtain the current value of the control parameter. |
| lpnValueType | LPAT_MODE | Returns the value type of control parameter. |
| lpdwValueSize | LPDWORD | Returns the size in bytes of the memory buffer that should be allocated for lpBuffer to completely fit the returned value. If NULL then this parameter is ignored. |
| lpBuffer | LPVOID | Pointer to a memory buffer which will be overwritten with the control parameter value. |
| dwBufferSize | DWORD | The size of memory allocated for lpBuffer pointer. If it is less than the value returned through lpdwValueSize then only dwBufferSize bytes will be written to the lpBuffer, and no error will be returned. |
Return Value:
Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.Supported Raster Image Formats:
This function does not process image pixels.
Sample:
ASCII, Flashpix, Medical, and some others.
Example:
| Copy Code |
|
|---|---|
AT_ERRCOUNT nErrcount; // Count of returned errors on stack AT_MODE valueType; DWORD valueSize; DWORD bufferSize; // Get a type and a size of the control parameter nErrcount = IG_fltr_ctrl_get(IG_FORMAT_TIF, "BUFFER_SIZE", FALSE, &valueType, &valueSize, NULL, 0); if(nErrcount == 0) { // Get the control parameter if(valueType == AM_TID_DWORD && valueSize == sizeof(DWORD)) { nErrcount = IG_fltr_ctrl_get(IG_FORMAT_TIF, "BUFFER_SIZE", FALSE, NULL, NULL, &bufferSize, sizeof(bufferSize)); // ... } } |
|
Remarks:
The application is responsible for allocating memory for lpBuffer and freeing it when it is no longer in use.
Use function IG_fltr_ctrl_set to change the value of a control parameter .
See also the section Using Format Filters API for Filter Control.