MdispSelect

This function outputs the content of the specified image buffer to the specified MIL display. You can only display one image buffer at a time on a specific display.

For a windowed display, the image is presented in a window that has the same size as the image, unless such a window would not fit on the desktop or would be too small. If the image is too large to fit in the largest possible window given the selected display resolution, the top-left corner of the image will be aligned with the top-left corner of the largest possible window, and the right and bottom portion of the image, the part that exceeds the window area, will not be displayed; to view the missing portions of the image, you can pan the displayed image (see the Panning and zooming section of Chapter 21: Displaying an image for more information). If the image is smaller in size than the smallest possible window, the image will be centered in the smallest possible window, and the surrounding area will be filled with the background color (MdispControl() with M_BACKGROUND_COLOR). If the window is enlarged or maximized, the image will remain the same size and centered.

For an exclusive display, the image is presented full-screen, without a windowed border or frame, on one of the Windows desktop screens. The image is presented at the center of the screen. If the image is too large to fit on screen given the selected display resolution, the top-left corner of the image will be aligned with the top-left corner of the screen, and the right and bottom portion of the image, the part that exceeds the screen area, will not be displayed; to view the missing portions of the image, you can pan the displayed image (see the Panning and zooming section of Chapter 21: Displaying an image for more information). If the image is smaller in size than the screen area, the image will be centered on screen, and the surrounding area will be filled with the background color (MdispControl() with M_BACKGROUND_COLOR).

For an auxiliary display, the image is presented at the top-left corner of an auxiliary screen. If the image is smaller in size than the screen area, the border outside the image will be filled with the background color (MdispControl() with M_BACKGROUND_COLOR) if this is supported by the hardware. If the image is too large to fit on screen given the selected display resolution, the right and bottom portion of the image, the part that exceeds the display size, is not displayed.

You can control the displayed area using MdispControl(), MdispPan(), or MdispZoom(). For example, you can center the selected image in the display using MdispControl() with M_CENTER_DISPLAY.

You can remove an image buffer selected to the display using MdispSelect() with M_NULL. For windowed displays, this closes the associated window. For exclusive displays, this causes the display to disappear, allowing the desktop to reappear on the screen. For auxiliary and network displays, this leaves the display blank.

You can only remove the entire image buffer from the display. Therefore, when displaying a parent buffer, you cannot remove one of its child buffers from the display.

Note that it is not necessary to stop displaying the image buffer before selecting another buffer for display.

If the selected image is calibrated, the image is not physically corrected on display. If the display is associated with an overlay buffer (MdispControl() with M_OVERLAY), the calibration information of the selected buffer is copied to the overlay buffer; this allows you to draw in the overlay buffer in world units. If the calibration information of the overlay buffer is modified with McalAssociate(), MbufClear(), or some other function, the calibration information of the selected buffer will not be updated accordingly. However, changing the calibration information of the selected buffer will re-copy the calibration information of the selected buffer to the overlay buffer, even if the calibration information of the overlay buffer was manually changed.