ImageGear for C and C++ on Windows v19.1 - Updated
IG_ARTX_image_embedded_create
API Reference Guide > ArtX Component API Reference > ArtX Component Objects Reference > HIG_ARTX_IMAGE_EMBEDDED > IG_ARTX_image_embedded_create

This function creates a new instance of image annotation (IG_ARTX_IMAGE_EMBEDDED).

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ARTX_image_embedded_create(
        LPAT_RECTANGLE pRectangle,
        HIGEAR hGear,
        enumIGOrientationModes nOrientation,
        enumFitModes nFitMode,
        enumAlignModes nAlignmentH,
        enumAlignModes nAlignmentV,
        AT_FLOAT dAspectRatio,
        LPAT_RGBQUAD pTransparentColor,
        LPHIG_ARTX_IMAGE_EMBEDDED lphMark
);

Arguments:

Name Type Description
pRectangle LPAT_RECTANGLE Annotation bounding rectangle.
hGear HIGEAR Handle of the image to associate with the new annotation. A copy of the image is created and stored. This parameter can be NULL.
nOrientation enumIGOrientationModes Specifies orientation of image within annotation bounding rectangle.
nFitMode enumFitModes Specifies fit mode of image.
nAlignmentH enumAlignModes Specifies horizontal alignment of image.
nAlignmentV enumAlignModes Specifies vertical alignment of image.
dAspectRatio AT_FLOAT Specifies image aspect ratio.
pTransparentColor LPAT_RGBQUAD Specifies transparent color.
lphMark LPHIG_ARTX_IMAGE_EMBEDDED Pointer to storage for new annotation handle.

Return Value:

Error count.

Supported Raster Image Formats:

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

Remarks:

Upon successful completion: