IG_GUI_pixdump_attribute_set
This function sets the attribute settings of the GUI Pixel Dump window.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ACCUAPIIG_GUI_pixdump_attribute_set(
HWND hWnd,
AT_MODE nAttributeID,
LPVOID lpData
);
|
Arguments:
Name |
Type |
Description |
hWnd |
HWND |
Handle of window in which image is displayed. |
nAttributeID |
AT_MODE |
A variable of type AT_MODE, such as IG_GUI_WINDOW_PAINT. |
lpData |
LPVOID |
A VOID pointer to a variable of the type required by the nAttributeID parameter. This sets the value for the attribute defined by nAttributeID. |
Supported Raster Image Formats:
This function does not process image pixels.
Return Value:
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
Sample:
GUI Windows
Remarks:
The settings available for nAttributeID are as follows:
- IG_GUI_PIXDUMP_FONT - Set font to use for text output
- IG_GUI_PIXDUMP_MODE - Set output mode
- IG_GUI_DATA_COLOR_COMPONENT - Set information about color components to
display
lpData specifies the value of attribute to set. This is not address but value itself (32 bit). If nAttributeID is set to IG_GUI_PIXDUMP_FONT then lpData should contain handle HFONT of the font. For old font DeleteObject will be called.
If nAttributeID is set to IG_GUI_PIXDUMP_MODE then lpData should contain one of following values:
- IG_GUI_COLOR_COMPONENT_R - shows value of Red component
- IG_GUI_COLOR_COMPONENT_G - shows value of Green component
- IG_GUI_COLOR_COMPONENT_B - shows value of Blue component
- IG_GUI_COLOR_COMPONENT_I - shows value of Intensity
- IG_GUI_COLOR_COMPONENT_RGB - shows all 3 (RGB) components
The default value forIG_GUI_DATA_COLOR_COMPONENT is: IG_GUI_PIXDUMP_COMPONENT_RGB.
If nAttributeID is IG_GUI_PIXDUMP_MODE then lpData should contain a combination of the following flags:
- IG_GUI_PIXDUMP_DIGITS_HEX Display hexadecimal numbers
- IG_GUI_PIXDUMP_DATA_COLOR If the image contains a palette, then this flag specifies whether to display entries of the actual RGB values or to display the index.
The default value for IG_GUI_PIXDUMP_MODE is: NULL
For 16-bit grayscale images, the intensity value will be displayed with any of the IG_GUI_DATA_COLOR_COMPONENT values.