MgraLine

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

The line is based on a start point (XStart, YStart) and an end point (XEnd, YEnd). The line inherits all the relevant settings of the specified graphics context, such as the foreground color (see MgraAlloc() for default context settings). If part of the line falls outside of the specified area (image or display), that part is clipped off.

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

A line'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 MgraLine() an uncalibrated image, the function will generate an error.

To create multiple lines, a polyline, or a polygon, use MgraLines().

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.