Steps to performing annotations

Reference:

Availability

Available in MIL-Lite

Available in MIL

The following steps provide a basic methodology for using the MIL Graphics module to perform annotations:

Allocate a 2D graphics context, using MgraAlloc() to store your drawing preference (for example, foreground and background color).
Allocate an image buffer, using MbufAlloc...(), or, allocate a 2D graphics list, using MgraAllocList(), on which to perform the drawing operation.
If necessary, associate the 2D graphics list with a display, using MdispControl() with M_ASSOCIATED_GRAPHIC_LIST_ID, to non-destructively annotate the image selected to the display.
If necessary, modify 2D graphics context or 2D graphics list settings, using MgraControl() or MgraControlList().
Draw graphics destructively in an image buffer or add graphics to the 2D graphics list, using:
- One of the functions provided in the MIL Graphics module, such as MgraArc() or MgraRect().
- A draw function of a processing or analysis module (for example, MbeadDraw() or MmetDraw()).
- MgraInteractive(), to interactively create and add graphics to the 2D graphics list. A display must have the 2D graphics list associated with it (MdispControl() with M_ASSOCIATED_GRAPHIC_LIST_ID) and the display must allow modification to graphics associated with it (MdispControl() with M_GRAPHIC_LIST_INTERACTIVE).
If necessary, annotate an image destructively with the graphics contained in the 2D graphics list, using MgraDraw().
Free all your allocated objects using MgraFree().