ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / Image Processing Functions / IG_IP_alpha_create
In This Topic
    IG_IP_alpha_create
    In This Topic

    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().