ImageGear for C and C++ on Windows v19.3 - Updated
IG_gui_fx_spotlight_dlg
API Reference Guide > GUI Component API Reference > GUI Component Functions Reference > Image Processing Effects Functions > IG_gui_fx_spotlight_dlg

This function shows the dialog that allows you to produce a "spotlight" effect within the circle.

Declaration:

 
Copy Code
BOOL ACCUAPI IG_gui_fx_spotlight_dlg (
        HWND hWnd, 
        LPAT_IGGUI_FX_SPOTLIGHT lpFxSpotlightData
);

Arguments:

Name Type Description
hWnd HWND A handle of the parent window.
lpFxSpotlightData LPAT_IGGUI_FX_SPOTLIGHT A pointer to the AT_IGGUI_FX_SPOTLIGHT structure.

Return Value:

If the user specifies parameters and clicks the OK button, the return value is non-zero. If the user cancels or closes the dialog box or an error occurs, the return value is zero.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++, except:
Indexed RGB with non-grayscale palette.
Images that have a Grayscale LUT attached to them.

Sample:

Image Processing

Example:

 
Copy Code
#include "IG_gui_common.h"
AT_IGGUI_FX_SPOTLIGHT FxSpotlight;
FxSpotlight.cbSize = sizeof (FxSpotlight);
FxSpotlight.hWnd = hWnd;
FxSpotlight.hIGear = hIGear;
FxSpotlight.uFlags |= IG_IGGUI_FX_SETUP_EMPTY_RECT;
if (IG_gui_fx_spotlight_dlg (hWnd, &FxSpotlight))
{
InvalidateRect(hWnd, NULL, FALSE);
        UpdateWindow(hWnd);
}