This function changes the attributes of a mark.

Declaration:

AT_ERRCOUNT ART_mark_modify(
        HIGEAR hIGear, 
        ART_MARK_INDEX hMarkIndex, 
        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++.

Sample:

Annotation

Example:

HIGEAR  hIGear;  /* HIGEAR handle of image */
ART_MARK_ATTRIBUTES ma;  /* mark attributes */
/* structure */
ART_MARK_INDEX markIndex /* index to the mark */
ART_mark_selected_first(hIGear, &hMarkIndex);
if (hMarkIndex != ART_MARK_INVALID)
{
ART_mark_query(hIGear, markIndex, &ma);
ma.dwType = 506;  /* arrow    */
ma.dwLineSize = 5;  /* line thickness =  */
/* 5 pixels    */
nErrcount = ART_mark_modify(hIGear, markIndex, &ma);
}

Remarks:

The attributes are stored in a structure of type ART_MARK_ATTRIBUTES, that is defined in ARTAPI.H. You can set any number of the attributes of this structure and then pass it to this function.

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

• hIGear does not reference a valid ImageGear handle.
• There are no marks with a matching index block.
• lpMarkAttr is an invalid address or has one or more invalid fields.