ImageGear for C and C++ on Windows v19.1 - Updated
AT_IGGUI_FX_SPOTLIGHT
API Reference Guide > GUI Component API Reference > GUI Component Structures Reference > AT_IGGUI_FX_SPOTLIGHT

This structure is used by the IG_gui_fx_spotlight_dlg function to produce a "spotlight" effect within the circle.

Declaration:

 
Copy Code
typedef struct tag AT_IGGUI_FX_SPOTLIGHT
{
        DWORD cbSize;
        UINT uFlags;
        HIGEAR hIGear;
        HWND hWnd;
        LPCHAR lpszTitle;
        AT_RECT rc;
        AT_PIXPOS nCenterX;
        AT_PIXPOS nCenterY;
        AT_DIMENSION nRadius;
        UINT nDarkenBy;
        AT_PIXEL nSmoothing;
        AT_ERRCOUNT nErrCount;
        LPFNIGGUI_FX_UPDATE lpfnUpdateProc;
}AT_IGGUI_FX_SPOTLIGHT;

Members:

Name Type Description
cbSize DWORD Specifies the length, in bytes, of the structure.
uFlags UINT A set of bit flags you can use to initialize the dialog box.
hIGear HIGEAR A handle of an image.
hWnd HWND A handle of the window to update.
lpszTitle LPCHAR A dialog title.
rc AT_RECT An AT_RECT struct specifying the rectangular portion of the image to be processed.
nCenterX AT_PIXPOS The X coordinate of the circle's center to receive the spotlight effect; 0 to Width - 1.
nCenterY AT_PIXPOS The Y coordinate of the circle's center; 0 to Height - 1.
nRadius AT_DIMENSION Radius of the circle, in pixels; 2 to Height - 2.
nDarkenBy UINT How much to darken the remainder of the image.
nSmoothing AT_PIXEL 0 to 255, specifying how much smoothing to apply at the edges; 0 = sharp edges, > 0 = smoother edges.
nErrCount AT_ERRCOUNT The number of ImageGear errors that occurred during this function call.
lpfnUpdateProc LPFNIGGUI_FX_UPDATE A pointer to the function that is called when the 'Apply' button is clicked.