MdispControl

Same as M_COLOR_WHITE.

‡

M_RGB888(

MIL_INT Red,

MIL_INT Green,

MIL_INT Blue

)

Specifies the RGB value to which the background color will be set to.

(summarize)

Specifies the RGB value to which the background color will be set to.

(more details...)

‡

Parameters

Red

Specifies the red component, as a value between 0 and 255.

‡

Green

Specifies the green component, as a value between 0 and 255.

‡

Blue

Specifies the blue component, as a value between 0 and 255.

‡

M_COLOR_BLACK

Specifies the color black.

‡

M_COLOR_BLUE

Specifies the color blue.

‡

M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

‡

M_COLOR_CYAN

Specifies the color cyan.

‡

M_COLOR_DARK_BLUE

Specifies the color dark blue.

‡

M_COLOR_DARK_CYAN

Specifies the color dark cyan.

‡

M_COLOR_DARK_GREEN

Specifies the color dark green.

‡

M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

‡

M_COLOR_DARK_RED

Specifies the color dark red.

‡

M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

‡

M_COLOR_GRAY

Specifies the color gray.

‡

M_COLOR_GREEN

Specifies the color green.

‡

M_COLOR_LIGHT_BLUE

Specifies the color light blue.

‡

M_COLOR_LIGHT_GRAY

Specifies the color light gray.

‡

M_COLOR_LIGHT_GREEN

Specifies the color light green.

‡

M_COLOR_LIGHT_WHITE

Specifies the color light white.

‡

M_COLOR_MAGENTA

Specifies the color magenta.

‡

M_COLOR_RED

Specifies the color red.

‡

M_COLOR_WHITE

Specifies the color white.

‡

M_COLOR_YELLOW

Specifies the color yellow.

‡

M_OVERLAY

Sets whether MIL's overlay mechanism is enabled. This mechanism allows you to annotate displayed image buffers non-destructively. For more information on MIL's overlay buffers, see the Annotating the displayed image non-destructively section of Chapter 23: Displaying an image.

Once enabled, use MdispInquire() with the M_OVERLAY_ID inquire type to determine the MIL identifier of the overlay buffer. Note that once created, the overlay buffer is like any other image buffer. That is, you can perform operations on it as you would on a normal buffer (except for grabbing). INQ

(summarize)

Sets whether MIL's overlay mechanism is enabled. INQ

(more details...)

‡

Specifies to disable MIL's overlay mechanism.

This is the default value.

(summarize)

Specifies to disable MIL's overlay mechanism.

(more details...)

‡

Specifies to enable MIL's overlay mechanism.

‡

M_OVERLAY_CLEAR

Sets the value to which the overlay buffer associated with the display should be cleared. The buffer is cleared to the specified value immediately after this control type setting is changed.

(summarize)

Sets the value to which the overlay buffer associated with the display should be cleared.

(more details...)

‡

Same as M_TRANSPARENT_COLOR.

‡

M_RGB888(

MIL_INT Red,

MIL_INT Green,

MIL_INT Blue

)

Specifies the RGB value to which the display's overlay buffer will be cleared for a non 8-bit display mode.

Specifies the RGB value. The buffer must be a non 8-bit 3-band buffer.

(summarize)

Specifies the RGB value to which the display's overlay buffer will be cleared for a non 8-bit display mode.

(more details...)

‡

Parameters

Red

Specifies the red component, as a value between 0 and 255.

‡

Green

Specifies the green component, as a value between 0 and 255.

‡

Blue

Specifies the blue component, as a value between 0 and 255.

‡

M_COLOR_BLACK

Specifies the color black.

‡

M_COLOR_BLUE

Specifies the color blue.

‡

M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

‡

M_COLOR_CYAN

Specifies the color cyan.

‡

M_COLOR_DARK_BLUE

Specifies the color dark blue.

‡

M_COLOR_DARK_CYAN

Specifies the color dark cyan.

‡

M_COLOR_DARK_GREEN

Specifies the color dark green.

‡

M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

‡

M_COLOR_DARK_RED

Specifies the color dark red.

‡

M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

‡

M_COLOR_GRAY

Specifies the color gray.

‡

M_COLOR_GREEN

Specifies the color green.

‡

M_COLOR_LIGHT_BLUE

Specifies the color light blue.

‡

M_COLOR_LIGHT_GRAY

Specifies the color light gray.

‡

M_COLOR_LIGHT_GREEN

Specifies the color light green.

‡

M_COLOR_LIGHT_WHITE

Specifies the color light white.

‡

M_COLOR_MAGENTA

Specifies the color magenta.

‡

M_COLOR_RED

Specifies the color red.

‡

M_COLOR_WHITE

Specifies the color white.

‡

M_COLOR_YELLOW

Specifies the color yellow.

‡

M_TRANSPARENT_COLOR

Specifies that the display's overlay buffer will be cleared to the transparency color. Set the transparency color with the M_TRANSPARENT_COLOR control type.

(summarize)

Specifies that the display's overlay buffer will be cleared to the transparency color.

(more details...)

‡

M_OVERLAY_SHOW

Sets whether the display's overlay buffer is visible. INQ

(summarize)

Sets whether the display's overlay buffer is visible. INQ

(more details...)

‡

Specifies that the overlay buffer is not visible. Display the image buffer selected on the display only.

(summarize)

Specifies that the overlay buffer is not visible.

(more details...)

‡

Specifies that the overlay buffer is visible. Annotations or other changes made to the overlay buffer in a color other than the transparency color will annotate the image selected to the display. Set the transparency color with the M_TRANSPARENT_COLOR control type.

This is the default value.

(summarize)

Specifies that the overlay buffer is visible.

(more details...)

‡

M_OPAQUE

Specifies that only the overlay buffer is visible. The image buffer selected will be hidden.

(summarize)

Specifies that only the overlay buffer is visible.

(more details...)

‡

M_TITLE

Sets the display's title to the specified string. For windowed displays, set whether the window's title bar is visible using the M_WINDOW_TITLE_BAR control type. For auxiliary displays, the title bar is not visible but the display's title can still be inquired. If no string is specified, the window is given a default title ("MIL Display #x"). INQ

(summarize)

Sets the display's title to the specified string. INQ

(more details...)

‡

M_PTR_TO_DOUBLE(

MIL_CONST_TEXT_PTR * String

)

Casts the address of the string identifying the specified window title (or display's title), from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(summarize)

Casts the address of the string identifying the specified window title (or display's title), from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(more details...)

‡

Parameters

String

This parameter specifies the string whose address to cast.

‡

MIL_TEXT("WindowTitle") ¹

Specifies the name of the window title (or display's title).

‡

M_TRANSPARENT_COLOR

Sets the transparency (keying) color. Pixels of the image buffer selected to the display are displayed only where the corresponding pixels of the overlay buffer are set to the transparency color. INQ

(summarize)

Sets the transparency (keying) color. INQ

(more details...)

‡

Specifies the optimal transparency color.

‡

M_RGB888(

MIL_INT Red,

MIL_INT Green,

MIL_INT Blue

)

Specifies the RGB value to which to set the transparency color for a non 8-bit display mode.

(summarize)

Specifies the RGB value to which to set the transparency color for a non 8-bit display mode.

(more details...)

‡

Parameters

Red

Specifies the red component, as a value between 0 and 255.

‡

Green

Specifies the green component, as a value between 0 and 255.

‡

Blue

Specifies the blue component, as a value between 0 and 255.

‡

M_COLOR_BLACK

Specifies the color black.

‡

M_COLOR_BLUE

Specifies the color blue.

‡

M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

‡

M_COLOR_CYAN

Specifies the color cyan.

‡

M_COLOR_DARK_BLUE

Specifies the color dark blue.

‡

M_COLOR_DARK_CYAN

Specifies the color dark cyan.

‡

M_COLOR_DARK_GREEN

Specifies the color dark green.

‡

M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

‡

M_COLOR_DARK_RED

Specifies the color dark red.

‡

M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

‡

M_COLOR_GRAY

Specifies the color gray.

‡

M_COLOR_GREEN

Specifies the color green.

‡

M_COLOR_LIGHT_BLUE

Specifies the color light blue.

‡

M_COLOR_LIGHT_GRAY

Specifies the color light gray.

‡

M_COLOR_LIGHT_GREEN

Specifies the color light green.

‡

M_COLOR_LIGHT_WHITE

Specifies the color light white.

‡

M_COLOR_MAGENTA

Specifies the color magenta.

‡

M_COLOR_RED

Specifies the color red.

‡

M_COLOR_WHITE

Specifies the color white.

‡

M_COLOR_YELLOW

Specifies the color yellow.

‡

M_UPDATE

Sets whether MIL should update the display. This control type can be used to temporarily disable display updates when the image buffer is being modified by more than one operation; the display can then be updated at the end of all operations. INQ

(summarize)

Sets whether MIL should update the display. INQ

(more details...)

‡

Specifies not to update the display.

‡

Specifies to update the display. Also, the display is forced to update immediately.

This is the default value.

(summarize)

Specifies to update the display.

(more details...)

‡

M_NOW

Specifies to force an immediate update of the display. In this case, the display is updated even if M_UPDATE is set to M_DISABLE.

(summarize)

Specifies to force an immediate update of the display.

(more details...)

‡

M_UPDATE_RATE_MAX

Sets the maximum rate at which to update the display.

To update the display only after a specific number of buffer modifications, regardless of the time lapsed, use M_UPDATE_RATE_DIVIDER instead. INQ

(summarize)

Sets the maximum rate at which to update the display. INQ

(more details...)

‡

Same as M_INFINITE.

‡

M_INFINITE

Specifies to perform updates as fast as possible (limited by the available bandwidth and transmission delay).

‡

Value > 0

Specifies the maximum number of updates per second. Only integer values are accepted. A minimum delay of 1/ Value seconds will be respected between two consecutive updates.

(summarize)

Specifies the maximum number of updates per second.

(more details...)

‡

M_UPDATE_SYNCHRONIZATION

[This is only applicable to Windows]

Sets the update mode currently used to update the display. INQ

(summarize)

[This is only applicable to Windows]

Sets the update mode currently used to update the display. INQ

(more details...)

‡

MIL system specific

This control type allows you to serialize paint messages sent to update the display. When the display uses a user-defined window, one paint message can interrupt another. This can cause deadlock if, for example, you set up an event handler for the paint message which tries to update the image buffer selected on the display. This will cause another paint message to be called to update the display. This results in the paint message recursively calling itself, causing a deadlock. To solve this problem M_UPDATE_SYNCHRONIZATION can be set to enforce the serialization of paint messages.

Note that this value is not available for auxiliary displays.

‡

This control type allows you to serialize the published image data stream with your remote display.

‡

M_GRAPHIC_LIST_INTERACTIVE

Specifies the default update mode.

(summarize)

Specifies the default update mode.

(more details...)

‡

MIL system specific

The default mode corresponds to M_ASYNCHRONOUS, if the user-defined window thread is the same as the current one. Otherwise, it is M_SYNCHRONOUS.

‡

Same as M_ASYNCHRONOUS.

‡

M_ASYNCHRONOUS

Specifies that the display is updated when possible.

(summarize)

Specifies that the display is updated when possible.

(more details...)

‡

MIL system specific

The paint messages are queued and that the application's window procedure (WndProc) will update the display whenever possible. Basically, when a paint message is issued, MIL calls the Windows InvalidateRect() function. For more information on InvalidateRect(), refer to the MSDN library.

‡

The published image data stream to be asynchronous. The function will return immediately while internal threads are sending data to all clients that are listening for the data stream. MdispControl() using M_UPDATE_SYNCHRONIZATION with a valid display identifier will result in a call to the Remote module's RemoteSetAttribute function, with the proper parameters set.

‡

M_SYNCHRONOUS

Specifies that the display is updated immediately.

The display is updated immediately upon reception of a paint message. Basically, when a paint message is issued, MIL calls the Windows InvalidateRect() function followed by the Windows UpdateWindow() function. For more information on InvalidateRect() and UpdateWindow(), refer to the MSDN library.

(summarize)

Specifies that the display is updated immediately.

(more details...)

‡

MIL system specific

The published image data stream will be synchronous. The function will return only when the information is sent to all clients that are listening for the data stream. The call to MdispControl() using M_UPDATE_SYNCHRONIZATION with a valid display ID will result in a call to the Remote module's RemoteSetAttribute function, with the proper parameters set.

‡

¹ If you are passing the value in a variable, don't enclose it in MIL_TEXT().

The following ControlType and corresponding ControlValue parameter settings are available for windowed, exclusive, and auxiliary displays.

For windowed, exclusive, and auxiliary displays
ControlType		Description
	ControlValue	Description
M_ASSOCIATED_GRAPHIC_LIST_ID		Sets the graphics list to associate with the display. Only one graphics list can be associated with the display at a time. If you associate a graphics list with a display that already has been associated with one, the previous graphics list is disassociated from the display and the new one is associated. INQ (summarize) Sets the graphics list to associate with the display. INQ (more details...)
	M_NULL	Specifies that no graphics list is associated with the display. This is the default value. (summarize) Specifies that no graphics list is associated with the display. (more details...)
	MIL graphics list identifier	Specifies the identifier of the graphics list to associate with the display. The graphics list must have been previously allocated using MgraAllocList(). In this case, the vector-based graphics, contained within the graphics list, will be used to annotate the display non-destructively. By default, modifications to the graphics within the list (added, deleted, or altered graphics) will be immediately reflected in the non-destructive annotation of the display. To change this behavior, use M_UPDATE_GRAPHIC_LIST. To release the graphics list from memory, use MgraFree(). If the associated graphics list is freed, it is automatically disassociated from the display. (summarize) Specifies the identifier of the graphics list to associate with the display. (more details...)
M_CENTER_DISPLAY		Sets whether a selected image buffer will be centered in the display, both in X and Y. INQ (summarize) Sets whether a selected image buffer will be centered in the display, both in X and Y. INQ (more details...)
	M_DEFAULT	Specifies the default value. The default value is M_ENABLE for a MIL default window and an exclusive display. The default value is M_DISABLE for a user-defined window display and an auxiliary display. (summarize) Specifies the default value. (more details...)
	M_DISABLE	Specifies that the image buffer will not be centered in the display. This will overwrite the current panning offsets (MdispPan()) to (0,0). (summarize) Specifies that the image buffer will not be centered in the display. (more details...)
	M_ENABLE	Specifies that the image buffer will always be centered in the display, both in X and Y. This will offset the image buffer by ( (WindowSizeX - BufferSizeX)/2, (WindowSizeY - BufferSizeY)/2) in the window, and current panning offsets (MdispPan()) are overwritten with these values. (summarize) Specifies that the image buffer will always be centered in the display, both in X and Y. (more details...)
M_NO_TEARING		Allows you to enable the no-tearing mechanism for the selected display, if the MIL DirectX-based display service is installed. With Windows Aero (available with Windows 7 and 8), screen tearing is no longer common. In this case, display composition is completely managed by the operating system and display updates are performed without tearing. Screen tearing might still occur if you are using Windows XP or if you have disabled Windows Aero in Windows 7. To determine if the MIL no-tearing mechanism is currently active on the specified display, use MdispInquire() with M_NO_TEARING_ACTIVE. For more information on screen tearing, see the Screen tearing section of Chapter 23: Displaying an image. INQ (summarize) Allows you to enable the no-tearing mechanism for the selected display, if the MIL DirectX-based display service is installed. INQ (more details...)
			Operating system specific
			[This is only applicable to Linux] Under Linux, M_NO_TEARING is only supported for auxiliary displays.
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies not to use a no-tearing mechanism to update the display.
	M_ENABLE	Specifies to use a no-tearing mechanism to update the display.
M_REGION_INSIDE_COLOR		Sets the color that will be used to clear the pixels that are part of a region of interest associated with the selected buffer. The pixels are cleared to the specified color immediately after this control type setting is changed. INQ (summarize) Sets the color that will be used to clear the pixels that are part of a region of interest associated with the selected buffer. INQ (more details...)
	M_DEFAULT	Same as M_COLOR_GREEN.
	M_RGB888( MIL_INT Red, MIL_INT Green, MIL_INT Blue )	Specifies the RGB value to which the pixels that are part of a region will be cleared for a non 8-bit display mode. Specifies the RGB value. The buffer must be a non 8-bit 3-band buffer. (summarize) Specifies the RGB value to which the pixels that are part of a region will be cleared for a non 8-bit display mode. (more details...)
			Parameters
			Red Specifies the red component, as a value between 0 and 255.
			Green Specifies the green component, as a value between 0 and 255.
			Blue Specifies the blue component, as a value between 0 and 255.
	M_COLOR_BLACK	Specifies the color black.
	M_COLOR_BLUE	Specifies the color blue.
	M_COLOR_BRIGHT_GRAY	Specifies the color bright gray.
	M_COLOR_CYAN	Specifies the color cyan.
	M_COLOR_DARK_BLUE	Specifies the color dark blue.
	M_COLOR_DARK_CYAN	Specifies the color dark cyan.
	M_COLOR_DARK_GREEN	Specifies the color dark green.
	M_COLOR_DARK_MAGENTA	Specifies the color dark magenta.
	M_COLOR_DARK_RED	Specifies the color dark red.
	M_COLOR_DARK_YELLOW	Specifies the color dark yellow.
	M_COLOR_GRAY	Specifies the color gray.
	M_COLOR_GREEN	Specifies the color green.
	M_COLOR_LIGHT_BLUE	Specifies the color light blue.
	M_COLOR_LIGHT_GRAY	Specifies the color light gray.
	M_COLOR_LIGHT_GREEN	Specifies the color light green.
	M_COLOR_LIGHT_WHITE	Specifies the color light white.
	M_COLOR_MAGENTA	Specifies the color magenta.
	M_COLOR_RED	Specifies the color red.
	M_COLOR_WHITE	Specifies the color white.
	M_COLOR_YELLOW	Specifies the color yellow.
M_REGION_INSIDE_SHOW		Sets how to display the pixels that are part of a region of interest associated with the selected buffer, if such a region exist. INQ (summarize) Sets how to display the pixels that are part of a region of interest associated with the selected buffer, if such a region exist. INQ (more details...)
	M_DEFAULT	Same as M_TRANSPARENT.
	M_OPAQUE	Specifies that pixels in the region are cleared to the color specified using M_REGION_INSIDE_COLOR.
	M_TRANSPARENT	Specifies that pixels in the region are displayed as is.
M_REGION_OUTSIDE_COLOR		Sets the color that will be used to clear the pixels that are not part of a region of interest associated with the selected buffer. The pixels are cleared to the specified color immediately after this control type setting is changed. INQ (summarize) Sets the color that will be used to clear the pixels that are not part of a region of interest associated with the selected buffer. INQ (more details...)
	M_DEFAULT	Same as M_COLOR_RED.
	M_RGB888( MIL_INT Red, MIL_INT Green, MIL_INT Blue )	Specifies the RGB value to which the pixels that are part of a region will be cleared for a non 8-bit display mode. Specifies the RGB value. The buffer must be a non 8-bit 3-band buffer. (summarize) Specifies the RGB value to which the pixels that are part of a region will be cleared for a non 8-bit display mode. (more details...)
			Parameters
			Red Specifies the red component, as a value between 0 and 255.
			Green Specifies the green component, as a value between 0 and 255.
			Blue Specifies the blue component, as a value between 0 and 255.
	M_COLOR_BLACK	Specifies the color black.
	M_COLOR_BLUE	Specifies the color blue.
	M_COLOR_BRIGHT_GRAY	Specifies the color bright gray.
	M_COLOR_CYAN	Specifies the color cyan.
	M_COLOR_DARK_BLUE	Specifies the color dark blue.
	M_COLOR_DARK_CYAN	Specifies the color dark cyan.
	M_COLOR_DARK_GREEN	Specifies the color dark green.
	M_COLOR_DARK_MAGENTA	Specifies the color dark magenta.
	M_COLOR_DARK_RED	Specifies the color dark red.
	M_COLOR_DARK_YELLOW	Specifies the color dark yellow.
	M_COLOR_GRAY	Specifies the color gray.
	M_COLOR_GREEN	Specifies the color green.
	M_COLOR_LIGHT_BLUE	Specifies the color light blue.
	M_COLOR_LIGHT_GRAY	Specifies the color light gray.
	M_COLOR_LIGHT_GREEN	Specifies the color light green.
	M_COLOR_LIGHT_WHITE	Specifies the color light white.
	M_COLOR_MAGENTA	Specifies the color magenta.
	M_COLOR_RED	Specifies the color red.
	M_COLOR_WHITE	Specifies the color white.
	M_COLOR_YELLOW	Specifies the color yellow.
M_REGION_OUTSIDE_SHOW		Sets how to display the pixels that are not part of a region of interest associated with the selected buffer, if such a region exist. INQ (summarize) Sets how to display the pixels that are not part of a region of interest associated with the selected buffer, if such a region exist. INQ (more details...)
	M_DEFAULT	Same as M_TRANSPARENT.
	M_OPAQUE	Specifies that pixels outside of the region are cleared to the color specified using M_REGION_OUTSIDE_COLOR.
	M_TRANSPARENT	Specifies that pixels outside of the region are displayed as is.
M_SCALE_DISPLAY		Sets whether to fill the display with the selected image buffer, while keeping the same aspect ratio. You can inquire the automatically calculated zoom factor used to scale the image, using MdispInquire() with M_ZOOM_FACTOR_X and M_ZOOM_FACTOR_Y. INQ (summarize) Sets whether to fill the display with the selected image buffer, while keeping the same aspect ratio. INQ (more details...)
	M_DISABLE	Specifies that the image will not be scaled to fit the display. Unless a zoom factor has been applied, using MdispZoom(), the image will retain its original size and aspect ratio, leaving unused portions of the display to the default background color. This is the default value. (summarize) Specifies that the image will not be scaled to fit the display. (more details...)
	M_ENABLE	Specifies to always scale the selected image buffer to fit the display, while keeping the same aspect ratio. In this case, the image is not distorted. This setting overrides current pannning offsets (MdispPan()), as well as the previous zoom factors (MdispZoom()). (summarize) Specifies to always scale the selected image buffer to fit the display, while keeping the same aspect ratio. (more details...)
	M_ONCE	Specifies to compute the scale factors corresponding to M_ENABLE and call MdispZoom() with these factors. Unlike M_ENABLE, this setting changes the scale factors only once and these scale factors will not change if an image buffer with a different size is selected to the display. (summarize) Specifies to compute the scale factors corresponding to M_ENABLE and call MdispZoom() with these factors. (more details...)
M_UPDATE_GRAPHIC_LIST		Sets whether MIL should update the display when modifications are made to the display's associated graphics list. To associate a graphics list to the display, use M_ASSOCIATED_GRAPHIC_LIST_ID. With M_UPDATE_GRAPHIC_LIST, you can temporarily disable display updates (M_DISABLE) when the graphics list is being modified by multiple operations; you can then enable display updates (M_ENABLE) at the end of all operations. INQ (summarize) Sets whether MIL should update the display when modifications are made to the display's associated graphics list. INQ (more details...)
	M_DISABLE	Specifies that the display is not updated when the associated graphics list is modified.
	M_ENABLE	Specifies that the display is immediately updated when the associated graphics list is modified (refresh not required). This is the default value. (summarize) Specifies that the display is immediately updated when the associated graphics list is modified (refresh not required). (more details...)
M_UPDATE_RATE_DIVIDER		Sets after how many buffer modifications to update the display, regardless of the time lapsed. For example, if you set M_UPDATE_RATE_DIVIDER to 10, one out of every 10 buffer modifications will cause a display update. If fewer than the specified number of buffer modifications occur, the display is not updated. The display is only updated with the last buffer modification. This control type is useful when performing a continuous grab. If the display is allocated on a DMIL remote system but displayed on the master computer, another mechanism is also available to limit the number of display updates. You can set an upper limit to the number of display updates to perform per second, using M_UPDATE_RATE_MAX. In this case, updates of modified areas of the buffer are accumulated into one update between transmissions. INQ (summarize) Sets after how many buffer modifications to update the display, regardless of the time lapsed. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.
	Value	Specifies the frequency of the update.
M_VIEW_BIT_SHIFT		Sets the number of bits by which to bit-shift the pixel values of the image buffer selected to the display, when the M_VIEW_MODE control type is set to M_BIT_SHIFT. INQ (summarize) Sets the number of bits by which to bit-shift the pixel values of the image buffer selected to the display, when the M_VIEW_MODE control type is set to M_BIT_SHIFT. INQ (more details...)
	Value	Specifies the number of bits. This value should be set to the number of significant bits in the image buffer minus 8. For example, if a 16-bit image buffer contains data grabbed from a 10-bit digitizer, a shift of 2 should be used. The default value is 0. (summarize) Specifies the number of bits. (more details...)
M_VIEW_MODE		Sets the view mode of the display. The view mode establishes how an image buffer gets remapped to the display; this is especially useful when displaying a non 8-bit image buffer. INQ (summarize) Sets the view mode of the display. INQ (more details...)
	M_DEFAULT	Specifies the default value. The default value is M_TRANSPARENT unless the buffer selected on the display is a 1-bit buffer; when a 1-bit buffer is used, the default value is M_AUTO_SCALE. (summarize) Specifies the default value. (more details...)
	M_AUTO_SCALE	[For essential MIL-Lite information, see remarks ] Specifies to remap the pixel values to the display so that the minimum and maximum values in the image (not the full range of the image buffer) are set to 0 and 255, respectively. If the image buffer contains a single value, the displayed value is determined by linearly re-mapping the full range of the image buffer to that of the display (for example, (0 to 64K) to (0 to 255)). (summarize) [For essential MIL-Lite information, see remarks ] Specifies to remap the pixel values to the display so that the minimum and maximum values in the image (not the full range of the image buffer) are set to 0 and 255, respectively. (more details...)
	M_BIT_SHIFT	Specifies to bit-shift the pixel values of the image buffer by the specified number of bits upon updating the display. Specify the number of bits with the M_VIEW_BIT_SHIFT control type. (summarize) Specifies to bit-shift the pixel values of the image buffer by the specified number of bits upon updating the display. (more details...)
	M_MULTI_BYTES	Specifies to display each byte of the image buffer in separate display pixels. In other words, each pixel of a 16-bit image buffer will occupy two consecutive display pixels. Each pixel of a 32-bit image buffer will occupy four consecutive display pixels. This mode is only supported for 16-bit and 32-bit 1-band buffer. This mode is primarily useful when grabbing from a multi-tap camera. (summarize) Specifies to display each byte of the image buffer in separate display pixels. (more details...)
	M_TRANSPARENT	Specifies that no pixel remapping will be performed. Note that only the 8 least-significant bits of the image buffer will be displayed. (summarize) Specifies that no pixel remapping will be performed. (more details...)

The following ControlType and corresponding ControlValue parameter settings are available for all windowed displays.

For windowed displays
ControlType		Description
	ControlValue	Description
M_WINDOW_ANNOTATIONS		Advises MIL whether annotations will be drawn directly to the window's device context (DC) using GDI functions. You must disable no-tearing (MdispControl() with M_NO_TEARING) before you can enable support for direct window annotations; otherwise, an error is generated. INQ (summarize) Advises MIL whether annotations will be drawn directly to the window's device context (DC) using GDI functions. INQ (more details...)
	M_NULL	Specifies to advise MIL that the X display connection has not been set.
	Value	Specifies the pointer to the X display connection.
M_WINDOW_UPDATE_ON_PAINT		[This is only applicable to Windows] Sets when the display will be updated. INQ (summarize) [This is only applicable to Windows] Sets when the display will be updated. INQ (more details...)
	M_DEFAULT	Allows MIL to decide which message to receive before updating the display.
	M_DISABLE	Updates the display on reception of a WM_ERASEBKGND message in Windows.
	M_ENABLE	Updates the display on reception of a WM_PAINT message in Windows.

The following ControlType and corresponding ControlValue parameter settings are available for displays allocated on a DMIL remote system but displayed on the master computer.

For displays allocated on a DMIL remote system but displayed on the master computer
ControlType		Description
	ControlValue	Description
M_ASYNC_UPDATE		Sets whether to send display updates from the remote computer to the master computer in asynchronous or synchronous mode. INQ (summarize) Sets whether to send display updates from the remote computer to the master computer in asynchronous or synchronous mode. INQ (more details...)
	M_DEFAULT	Specifies to use the default mode, which can be selected using the MILConfig utility. In the MILConfig utility, if you select the High quality display option, the default mode is M_DISABLE; if you select the Optimized for bandwidth usage display option, the default mode is M_ENABLE. (summarize) Specifies to use the default mode, which can be selected using the MILConfig utility. (more details...)
	M_DISABLE	Specifies to send display updates in synchronous mode. In synchronous mode, the display is updated after each modification to the displayed image buffer (or the overlay buffer), and the application waits for the data to be transferred to the display before continuing. When an image, located on a remote computer, is displayed on the master computer, the update time can significantly slow your application. (summarize) Specifies to send display updates in synchronous mode. (more details...)
	M_ENABLE	Specifies that data will be sent asynchronously. In asynchronous mode, the required display updates are queued using multiple internal image bufferss and the application continues once the update has been queued. This mode maximizes your bandwidth usage while minimizing processing delays. There will be a delay of 1/ M_UPDATE_RATE_MAX between two consecutive updates. (summarize) Specifies that data will be sent asynchronously. (more details...)
M_COMPRESSION_TYPE		[For essential MIL-Lite information, see remarks ] Sets how to compress data being transmitted from the remote computer to the master computer. INQ (summarize) [For essential MIL-Lite information, see remarks ] Sets how to compress data being transmitted from the remote computer to the master computer. INQ (more details...)
	M_DEFAULT	Specifies to use the default compression type, which can be selected using the MILConfig utility. In the MILConfig utility, if you select the High quality display option, compression is disabled (M_NULL); if you select the Optimized for bandwidth usage display option, compression is enabled and the compression type is set to M_JPEG_LOSSY. (summarize) Specifies to use the default compression type, which can be selected using the MILConfig utility. (more details...)
	M_NULL	Specifies that compression is disabled.
	M_JPEG2000_LOSSLESS	Specifies that JPEG2000 lossless compression will be used. The supported data formats are: 1-band, 8- or 16-bit data. JPEG2000 compression supports much higher ratios of compression. You might need to use this compression type, for example, when there are fine details in your image or overlay buffer. Note, however, you should avoid this compression type unless absolutely necessary since compression/decompression time is high; you should only use it when the benefits of compression outweigh the overhead associated with the compression/decompression. (summarize) Specifies that JPEG2000 lossless compression will be used. (more details...)
	M_JPEG2000_LOSSY	Specifies JPEG2000 lossy compression will be used. JPEG2000 compression supports much higher ratios of compression without compromising image quality. You might need to use this compression type, for example, when there are fine details in your image or overlay buffer. Note, however, you should avoid this compression type unless absolutely necessary since compression/decompression time is high; you should only use it when the benefits of compression outweigh the overhead associated with the compression/decompression. You can manually set the compression factor using M_Q_FACTOR. (summarize) Specifies JPEG2000 lossy compression will be used. (more details...)
	M_JPEG_LOSSLESS	Specifies JPEG lossless compression will be used. The supported data formats are: 1-band, 8- or 16-bit data. (summarize) Specifies JPEG lossless compression will be used. (more details...)
	M_JPEG_LOSSLESS_INTERLACED	Specifies that JPEG lossless compression will be used in separate fields. The supported data formats are 1-band, 8- or 16-bit data. (summarize) Specifies that JPEG lossless compression will be used in separate fields. (more details...)
	M_JPEG_LOSSY	Specifies that JPEG lossy compression willl be used. You can manually set the compression factor using M_Q_FACTOR. (summarize) Specifies that JPEG lossy compression willl be used. (more details...)
	M_JPEG_LOSSY_INTERLACED	Specifies that JPEG lossy compression will be used in separate fields. You can manually set the compression factor using M_Q_FACTOR. (summarize) Specifies that JPEG lossy compression will be used in separate fields. (more details...)
M_Q_FACTOR		[For essential MIL-Lite information, see remarks ] Sets the quantization factor. This control type is only applied when lossy compression is used. The Q factor is applied to all bands. INQ (summarize) [For essential MIL-Lite information, see remarks ] Sets the quantization factor. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 80.
	1 <= Value <= 99	Specifies the quantization factor. Only integer values are accepted. The higher the factor, the more the compression, but the lower the image quality. (summarize) Specifies the quantization factor. (more details...)

Unless otherwise specified, the following ControlType and corresponding ControlValue parameter settings are only available for windowed displays (selected using MdispSelect() for MIL windows or MdispSelectWindow() for user-defined windows) and exclusive displays.

For windowed and exclusive displays

ControlType

Description

ControlValue

Sets whether a user can interactively modify the graphics in the graphics list associated with the display. Modifications to the graphics in the list include moving, resizing, and rotating.

The user interacts with the graphics using the mouse. Clicking on a graphic selects it, which causes the graphic to be surrounded with a selection box. The selection box has handles around it that can be dragged to resize, rotate, or move the graphic. The user can select multiple graphics by holding down the Ctrl key and clicking on each graphic. New graphics can be added to the graphics list interactively using MgraInteractive().

You can restrict the type of interactions the user can have using MgraControl() or MgraControlList(). INQ

(summarize)

Sets whether a user can interactively modify the graphics in the graphics list associated with the display. INQ

(more details...)

Same as M_DISABLE.

Specifies that the graphics list associated with the display cannot be affected by user interaction.

Specifies that the graphics list associated with the display can be affected by user interaction.

M_KEYBOARD_USE

Sets whether the user can interactively pan and zoom the display using the keyboard.

The default key usage is: INQ

+	Increases the X- and Y-zoom factors.
-	Decreases the X- and Y-zoom factors.
Page-up	Scrolls the image buffer up to the previous display section.
Page-down	Scrolls the image buffer down to the next display section.
Up arrow	Scrolls the image buffer up to the previous line.
Down arrow	Scrolls the image buffer down to the next line.
Left arrow	Scrolls the image buffer left by one pixel.
Right arrow	Scrolls the image buffer right by one pixel.
Ctrl-Up arrow	Scrolls the image buffer up to the previous display section.
Ctrl-Down arrow	Scrolls the image buffer down to the next display section.
Ctrl-Left arrow	Scrolls the image buffer left to the previous display section.
Ctrl-Right arrow	Scrolls the image buffer right to the next display section.

(summarize)

Sets whether the user can interactively pan and zoom the display using the keyboard. INQ

(more details...)

For user-defined windowed displays, this value is the same as M_DISABLE; for MIL windowed and exclusive displays, this value is the same as M_ENABLE.

Specifies that using the keyboard to perform panning and zooming is disabled.

This is the default value for user-defined windowed displays.

(summarize)

Specifies that using the keyboard to perform panning and zooming is disabled.

(more details...)

Specifies that using the keyboard to perform panning and zooming is enabled.

This is the default value for MIL windowed and exclusive displays.

(summarize)

Specifies that using the keyboard to perform panning and zooming is enabled.

(more details...)

M_MOUSE_CURSOR_CHANGE

Sets whether the mouse cursor changes shape in a display with mouse-interaction enabled (M_MOUSE_USE). For example, if interactive panning is possible in the display, the cursor will change to a hand.

If you have enabled M_GRAPHIC_LIST_INTERACTIVE, it is not necessary to enable this setting. INQ

(summarize)

Sets whether the mouse cursor changes shape in a display with mouse-interaction enabled (M_MOUSE_USE). INQ

(more details...)

For user-defined windowed displays, this value is the same as M_DISABLE; for MIL windowed and exclusive displays, this value is the same as M_ENABLE.

Specifies that mouse cursor change is disabled.

This is the default value for user-defined windowed displays.

(summarize)

Specifies that mouse cursor change is disabled.

(more details...)

Specifies that mouse cursor change is enabled.

This is the default value for MIL windowed and exclusive displays.

(summarize)

Specifies that mouse cursor change is enabled.

(more details...)

M_MOUSE_USE

Sets whether the user can interactively pan and zoom the display using the mouse. INQ

(summarize)

Sets whether the user can interactively pan and zoom the display using the mouse. INQ

(more details...)

For user-defined windowed displays, this value is the same as M_DISABLE; for MIL windowed and exclusive displays, this value is the same as M_ENABLE.

Specifies that mouse-interaction will not work inside a display.

This is the default value for user-defined windowed displays.

(summarize)

Specifies that mouse-interaction will not work inside a display.

(more details...)

Specifies that mouse-interaction will work inside a display.

This is the default value for MIL windowed and exclusive displays.

(summarize)

Specifies that mouse-interaction will work inside a display.

(more details...)

M_RESTRICT_CURSOR

Sets whether to restrict the mouse cursor so that it cannot move over the exclusive display. This control type is only applicable to exclusive displays. INQ

(summarize)

Sets whether to restrict the mouse cursor so that it cannot move over the exclusive display. INQ

(more details...)

Specifies to permit the mouse cursor to move over the display.