ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ART Component API Reference / ART Component Functions Reference / Mark Management Functions / ART_mark_rotate
In This Topic
    ART_mark_rotate
    In This Topic

    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: