ImageGear for C and C++ on Windows v19.1 - Updated
ART_mark_rotate
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Mark Management Functions > ART_mark_rotate

This function allows individual mark rotation.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_mark_rotate (
        HIGEAR hIGear, 
        ART_MARK_INDEX hMarkIndex, 
        DOUBLE dblRotate
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
hMarkIndex ART_MARK_INDEX Mark identifier.
dblRotate DOUBLE Rotation angle.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

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

Sample:

None

Example:

 
Copy Code
HIGEAR               hIGear;       /* HIGEAR handle of image  */
AT_ERRCOUNT          nErrcount;     /* tally of IG errors on  */
/* stack    */
ART_MARK_INDEX       hMarkIndex;    /* index to current mark  */
ART_MARK_ATTRIBUTES ma;    /* structures for  */
/* attributes of current  */
/* mark  */
nErrcount = ART_mark_query(hIGear, hMarkIndex, &ma);
if ((ma.dwType == ART_MARK_IMAGE_EMBEDDED) || 
   (ma.dwType == ART_MARK_IMAGE_REFERENCE))
{               /* if mark is an embedded image or image reference*/
                nErrcount = ART_mark_rotate(hIGear, hMarkIndex, 45.0);
}

Remarks:

Currently only image marks (embedded and image reference) can be rotated.

An error is set if any of the following conditions are met: