| Customize Help
| Save Settings

MgraDot


Function Map
Syntax
Description
Parameters
- ContextGraId
Table: For specifying the 2D graphics context
- DstImageBufOrListGraId
- XPos
- YPos
Type-specific versions of the function when using a C compiler under 64-bit
Compilation information
Synopsis
Draw a dot in an image or add a dot to a 2D graphics list.
Syntax
void MgraDot(
MIL_ID ContextGraId, //in
MIL_ID DstImageBufOrListGraId, //in
MIL_DOUBLE XPos, //in
MIL_DOUBLE YPos //in
)
Description

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 2D 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 2D 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 2D graphics context settings, use MgraControl() or MgraInquire(). To modify or inquire 2D 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 2D 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.

Note that when using a C compiler (not a C++ or other compiler) in 64-bit mode, MgraDot() internally calls the MIL_DOUBLE version of this function (MgraDotDouble()). If you need to pass integer values, call the MIL_INT64 version of this function (MgraDotInt64()).
Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
ContextGraId

Specifies the identifier of the 2D graphics context. This parameter must be set to one of the following values:

function map For specifying the 2D graphics context
Click to summarizeValue Description
Click to summarize M_DEFAULT

Specifies that the default 2D graphics context of the current MIL application is used.

Note that there is a different default 2D graphics context for each thread.

(summarize)
Click to summarize MIL 2D graphics context identifier

Specifies a valid 2D graphics context identifier, which you have allocated using MgraAlloc().
DstImageBufOrListGraId

Specifies the identifier of a valid image buffer in which to draw the dot or the identifier of a valid 2D graphics list in which to add the dot. You must have allocated the image buffer or the 2D graphics list using MbufAlloc...() or MgraAllocList(), respectively.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

XPos INQ

Specifies the X-coordinate of the dot in the input coordinate system.

YPos INQ

Specifies the Y-coordinate of the dot in the input coordinate system.

Type-specific versions of the function when using a C compiler under 64-bit
void MgraDotDouble (MIL_ID ContextGraId, MIL_ID DstImageBufOrListGraId, MIL_DOUBLE XPos, MIL_DOUBLE YPos)
Details
Parameters

ContextGraId

See ContextGraId of the main function for a description.

DstImageBufOrListGraId

See DstImageBufOrListGraId of the main function for a description.

XPos

See XPos of the main function for a description.

YPos

See YPos of the main function for a description.
void MgraDotInt64 (MIL_ID ContextGraId, MIL_ID DstImageBufOrListGraId, MIL_INT64 XPos, MIL_INT64 YPos)
Details
Parameters

ContextGraId

See ContextGraId of the main function for a description.

DstImageBufOrListGraId

See DstImageBufOrListGraId of the main function for a description.

XPos

See XPos of the main function for a description.

YPos

See YPos of the main function for a description.
Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll.
DEFAULT NONE