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

Declaration:

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

Arguments:

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++.

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:

• hIGear does not reference a valid ImageGear handle.
• The memory pointed to by lpMarkAttr is read-only (or not NULL), invalid or not large enough.
• The memory pointed to by lpMarkIndex is read-only, invalid or not large enough.