ImageGear for C and C++ on Windows v19.9 - Updated
IG_GUI_color_profile_attribute_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Color Profile Functions > IG_GUI_color_profile_attribute_set

This function sets the attribute settings of the GUI Color Profile window.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_color_profile_attribute_set(
        HWND hWnd, 
        AT_MODE nAttributeID, 
        LPVOID lpData
);

Arguments:

Name Type Description
hWnd HWND Handle of the window in which an 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.

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.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

GUI Windows

Remarks:

Here are the settings available for nAttributeID as defined in accucnst.h, and what they mean:

lpData is not the address of the data, but a value to which the address should be passed.

  1. If nAttributeID is set to a IG_GUI_DATA_COLOR_COMPONENT constant, then lpData should contain combinations of following flags:
    • IG_GUI_COLOR_COMPONENT_R: show chart for Red component
    • IG_GUI_COLOR_COMPONENT_G: show chart for Green component
    • IG_GUI_COLOR_COMPONENT_B: show chart for Blue component
    • IG_GUI_COLOR_COMPONENT_I: show chart for Intensity

    The ImageGear default value for IG_GUI_DATA_COLOR_COMPONENT is:

    IG_GUI_COLOR_COMPONENT_R | IG_GUI_COLOR_COMPONENT_G | IG_GUI_COLOR_COMPONENT_B

  2. If nAttributeID is set to a constant, then lpData should contain a combination of the following flags:
    • IG_GUI_COLORPROFILE_STYLE_STACK - Draw stacked chart. Each chart bottom is the top of the previous chart.
    • IG_GUI_COLORPROFILE_STYLE_SEPARATE - Draw each chart in separate area. Each chart has its own base line
    • IG_GUI_COLORPROFILE_STYLE_OVERLAID - Draw one chart over previous. Only one of the styles listed above may be specified.
    • IG_GUI_COLORPROFILE_STYLE_TRACK-- Draw line following the mouse
    • IG_GUI_COLORPROFILE_STYLE_XY-- Show mouse cursor coordinates in the GUI window.

    The default ImageGear setting for IG_GUI_DATA_COLORPROFILE_STYLE is:

    IG_GUI_COLORPROFILE_STYLE_TRACK |IG_GUI_COLORPROFILE_STYLE_SEPARATE