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

This function is called after ART_mark_first() to get the mark index and attributes of the next mark.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_mark_next(
        HIGEAR hIGear, 
        LPART_MARK_INDEX lpMarkIndex, 
        LPART_MARK_ATTRIBUTES lpMarkAttr
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
lpMarkIndex LPART_MARK_INDEX Mark identifier.
lpMarkAttr LPART_MARK_ATTRIBUTES Mark description.

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:

Annotation

Example:

See example under ART_mark_first() function.

Remarks:

The attributes for the mark are copied into lpMarkAttr. The lpMarkAttr parameter is set to NULL if the mark attributes are not needed. Both this function and ART_mark_first() set lpMarkIndex to ART_INVALID_MARK when there are no more marks to iterate through. Mark indexes are returned in the same order as the stacking order.

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