This function creates a new instance of Text Stamp annotation (HIG_ARTX_TEXT_STAMP).
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_ARTX_text_stamp_create( LPAT_RECTANGLE pRectangle, LPSTR lpszText, LPAT_ARTX_FONT lpFont, LPAT_RGBQUAD pTextColor, LPHIG_ARTX_MARK lphMark ); |
Arguments:
Name | Type | Description |
pRectangle | LPAT_RECTANGLE | Pointer to the annotation bounding rectangle. |
lpszText | LPSTR | The annotation text string. |
lpFont | LPAT_ARTX_FONT | Pointer to the annotation text font. |
pTextColor | LPAT_RGBQUAD | Pointer to the annotation text color. Specify NULL if text color is transparent. |
lphMark | LPHIG_ARTX_MARK | Pointer to storage that is overwritten with the new annotation handle. |
Return Value:
Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.
Supported Raster Image Formats:
This function does not process image pixels.
Remarks:
Upon successful completion:
- The new annotation handle, lphMark, may be used with functions that accept either HIG_ARTX_MARK or HIG_ARTX_TEXT_STAMP as input.
- The caller is responsible for deleting the newly created annotation using IG_ARTX_mark_delete.