ImageGear for C and C++ on Windows v19.1 - Updated
MED_overlay_apply
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Overlay Functions > MED_overlay_apply

Loads overlay planes from DICOM metadata (DataSet) attached to the image and creates ART marks of type IMAGE_EMBEDDED for each overlay plane.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_overlay_apply(HIGEAR hIGear);

Arguments:

Name Type Description
hIGear HIGEAR Page from which to load overlay planes into ART marks.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

The image must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet.

Remarks:

Each mark is placed in a separate ART group.

Overlay planes do not support specifying the colors (even black or white). An overlay pixel can only be visible or invisible. All visible overlay pixels are displayed with the same color, which is specified by the application and not stored in the DICOM DataSet. By default, ImageGear uses yellow color to display overlays. The application can change overlay color by going through all marks in the HIGEAR and changing the image palette of IMAGE_EMBEDDED marks.

This function requires the ImageGear ART Component to be attached to ImageGear. See Attaching Components.

See Also

ART Component API Function Reference