MgraDot

This function draws a dot destructively (raster-based) in the specified image. Alternatively, this function can add a vector-based version of a dot to the specified graphics list, allowing you to, for example, non-destructively annotate a display without pixelation effects upon scaling.

The dot is based on a point positioned at XPos and YPos. The dot inherits all the relevant settings of the specified graphics context, such as the foreground color (see MgraAlloc() for default context settings). If the dot falls outside of the specified area, it is not created.

To modify or inquire graphics context settings, use MgraControl() or MgraInquire(). To modify or inquire graphics list settings, use MgraControlList() or MgraInquireList().

The dot's coordinates are interpreted with respect to the input coordinate system, specified using MgraControl() or MgraControlList() with M_INPUT_UNITS. Note that if you set your input coordinate system to M_WORLD and you pass MgraDot() an uncalibrated image, the function will generate an error.

To create one or more dots, use MgraDots().

Unlike most other functions that modify a MIL object, you can call this function concurrently from multiple threads on the same MIL graphics list (DstImageBufOrListGraId) without using an M_MUTEX object, as long as all the other parameters of the concurrent calls do not also share data.