-------------------------------------------------------------------------------- Matrox Imaging Library (MIL) 8.0 mildisplay.txt October 26, 2006 Copyright© 2006 by Matrox Electronic Systems Ltd. All rights reserved. -------------------------------------------------------------------------------- This document outlines what is new with MIL display module. It also presents last minute information that did not make it into the manual or on-line help. Note that this text file serves to complement your manual. The information found in this file overrides your formally documented material. Contents What’s new - 1 Additions - 2 Optimizations - 3 Bug Fixes - 4 Changes to the Mdisp API. - 4.1 MdispAlloc() - 4.2 MdispControl() - 4.3 MdispInquire() - 5 Modified Example - 6 Matrox P-Series Display Drivers - 7 Matrox G-Series Display Drivers. - 8 Matrox 4-SightII Encoder. - 9 Limitations - 1 Additions =============== 1.1 Added better memory management with large buffers (> 25MB) 1.2 Added the possibility to set and retrieve regions-of-interest in windowed displays. 1.3 Added handling of CTRL-ALT-DEL, screen saver and computer lock. 1.4 Added support for encoder with P-Series (except Parhelia 256) 1.5 Added support for displaying Mono32 and RGB96 images in Matrox P-Series gigacolor resolution(10-10-10). 1.6 Added possibility to allocate a display on a specific video-device (see 4.1) 1.7 Added possibility to control the update rate of the display. (MdispControl M_UPDATE_RATE_DIVIDER) - 2 Optimizations =================== - Faster internal calls. - Faster updates when a continuous grab is running. - Faster updates in auxiliary mode. - 0% CPU continuous grab on the 4-Sight M can now be achieved. - Better management of device number for all types of display. - 3 Bug Fixes =============== - Fixed an overlay problem with continuous grab in video-encoder mode. - Fixed problems with auto-scale view mode on Parhelia. - Fixed a crash when doing MappFree while a display buffer is still allocated. - Fixed problems with M_SIGNED buffers selected on display. - Fixed flickering troubles while panning and zooming in auxiliary mode. display. - 4 Changes to the Mdisp API. =============================== - 4.1 MdispAlloc() - DispNum: Auxiliary display allocation can now be done on a specific video-device (M_DEV0, M_DEV1, etc.) If MIL needs to use video-memory, specifying a DispNum in MdispAlloc will insure the appropriate video-memory bank will be initially used, which can result in a faster MdispSelect. Use this parameter if you want to specify in which monitor your display will initially appear, otherwise use M_DEFAULT. *Exception*: If video-encoder display is allocated on M_SYSTEM_CORONA_II or M_SYSTEM_ORION, always set DispNum to M_DEFAULT. - 4.2 MdispControl() - New Control types: - M_ROI_DEFINE: Enable or disable the ROI-defining mode. In this mode, user can define a region-of-interest using the mouse. Note that in this mode, ROI is automatically shown. Control Values: M_START:To start the defining mode. If a ROI exist, it allows modifiying it. M_START+M_RESET: To start the defining mode, with reset of the existing ROI (starts a new one). M_STOP: To stop the defining mode. - M_ROI_SHOW: Enable or disable the ROI-show mode. Control Values: M_ENABLE: To show current ROI. M_DISABLE: To hide current ROI. - M_ROI_LINE_COLOR: Sets the color used by MIL to draw ROI lines. Control Value: RGB color value [M_RGB888(Red, Green, Blue)] - M_ROI_ANCHOR_COLOR: Sets the color used by MIL to draw ROI anchors (in defining mode). Control Value: RGB color value [M_RGB888(Red, Green, Blue)] - M_ROI_DISPLAY_OFFSET_X: Sets ROI offsetX in display coordinates. - M_ROI_DISPLAY_OFFSET_Y: Sets ROI offsetY in display coordinates. - M_ROI_DISPLAY_SIZE_X: Sets ROI sizeX in display coordinates. - M_ROI_DISPLAY_SIZE_Y: Sets ROI sizeY in display coordinates. Control Values: Value to set. - M_ROI_BUFFER_OFFSET_X: Sets ROI offsetX in buffer coordinates. - M_ROI_BUFFER_OFFSET_Y: Sets ROI offsetY in buffer coordinates. - M_ROI_BUFFER_SIZE_X: Sets ROI sizeX in buffer coordinates. - M_ROI_BUFFER_SIZE_Y: Sets ROI sizeY in buffer coordinates. Control Values: Value to set. - M_UPDATE_RATE_DIVIDER : Sets the divider of the update rate of the display. Control Values: Divider of the update rate. Ex.: to update 1 frame out of 4 in continuous grab, set the divider to 4. - 4.3 MdispInquire() All the control types enumerated in 4.2 can also be given to MdispInquireas Inquire Value. - 5 Modified Example. ======================= - MdispMFC example has been modified to show how to use ROI features in an application using user-defined window. Note that using MIL default window, ROI-defining mode is easilly accessible using standard toolbar - 6 Matrox P-Series Display Drivers. ====================================== - Matrox Graphics P-Series display drivers has been updated to 1.11.0.14 - Silent installation won't install those drivers. Please contact Matrox Imaging for more information. - If you've installed P650 or P750 display drivers obtained from the Matrox Graphics website, please uninstall those drivers and Matrox PowerDesk-HF before applying the Display Update. - 7 Matrox G-Series Display Drivers. ====================================== - Matrox Graphics G-Series display drivers has been updated to 5.96.004 - Silent installation won't install those drivers. Please contact your Matrox Imaging for more information. - 8 Matrox 4-SightII Encoder. ====================================== - It's recommended not to install the Display Update (M800DU09). Keep using the current MIL 8.0 Official Release. - 9 Limitations ====================================== - Matrox Graphics boards may have some compatibility issues with third-party graphic adapters.