IG_ARTX_image_embedded

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 );

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:

The caller is responsible for deleting the newly created annotation using IG_ARTX_mark_delete.