ImageGear for C and C++ on Windows v19.1 - Updated
IG_IP_alpha_create
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_alpha_create

This function has been deprecated and will be removed from the public API in a future release. Please use IG_image_create instead.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_alpha_create(
        HIGEAR hIGear,
        HIGEAR hIBackgrnd, 
        AT_MODE nCreateMode,
        LPHIGEAR lphAlpha
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of image.
hIBackgrnd HIGEAR HIGEAR handle to a background image.
nCreateMode AT_MODE An integer value of type AT_MODE that tells ImageGear what bit depth the alpha channel should have. The possible settings for this variable, which are defined in accucnst.h are: IG_ALPHA_CREATE_1 and IG_ALPHA_CREATE_8.
lphAlpha LPHIGEAR Far pointer to the newly created alpha channel.

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:

All pixel formats supported by ImageGear for C and C++.

Sample:

GUI Windows

Remarks:

This function creates an alpha channel.

The difference from function IG_image_create_alpha() is that newly created alpha channel is not associated with any HIGEAR - it's only created and returned via last parameter lphAlpha. Other parameters have the same meaning as those of IG_image_create_alpha().