MgraRectFill

This function draws a filled rectangle destructively (raster-based) in the specified image. Alternatively, this function can add a vector-based version of a filled rectangle to the specified graphics list, allowing you to, for example, non-destructively annotate a display without pixelation effects upon scaling. Note that the rectangle is filled with the specified foreground color (MgraControl() or MgraControlList() with M_COLOR).

The filled rectangle is created from the top-left corner (XStart, YStart) to the bottom-right corner (XEnd, YEnd). The filled rectangle 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 filled rectangle 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 filled rectangle'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 MgraRectFill() an uncalibrated image, the function will generate an error.

To create a rectangle that is not filled, use MgraRect(). To create a rectangle that can be optionally filled and rotated, use MgraRectAngle().

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.