ImageGear for C and C++ on Linux v18.8 - Updated
ART_mark_visible
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Mark Management Functions > ART_mark_visible

This function sets the visibility of a mark.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_mark_visible(
        HIGEAR hIGear, 
        ART_MARK_INDEX hMarkIndex, 
        BOOL fVisible
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
hMarkIndex ART_MARK_INDEX Mark identifier.
fVisible BOOL If set to TRUE, the mark is made visible; FALSE, invisible.

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:

 
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);
nErrcount = ART_mark_is_visible(hIGear, hMarkIndex, 
fVisible);
if (fVisible == TRUE && ma.dwType == 10){ 
/* if an attach-a-note mark is visible  */
nErrcount = ART_mark_visible(hIGear, hMarkIndex, 
FALSE); 
/* make it invisible    */
}

Remarks:

When fVisible is set to TRUE, the function show marks; when fVisible is set to FALSE, it hides marks. The bVisible field of the mark's attribute structure is set to the latest value for fVisible.

The mark must be repainted in order to see a change in the visibility state. Use ART_GUI_mark_paint() function.

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