System information

OMI 2.3.1 Release Notes
40 OMI 2.3.1 Release Notes
Bc Object API Changes
The only change to the Bc object’s API is that the SetCodeType() function accepts a
new value to denote the Bc128 barcode.
Image Object
The Image object now supports the Cognex MVS-8120 frame grabber and a wider
range of cameras and video formats. These are described in detail in Cameras and
Video Formats Supported on page 11.
Previous versions of OMI used video format numbers to specify video formats. Newer
versions of OMI use video format names; you should use video format names in any new
applications you write.
Video formats are either built in to OMI or are available though Camera Configuration
Files (CCFs) in the directory specified by the environment variable
COGNEX_CCF_PATH (usually C:\Program Files\Cognex\Common\ccf).
The image object now lets you use any of the RGB color planes with a vision tool without
acquiring a new image. When a vision tool requires a grey-scale image, the conversion
is performed automatically according to the GreyConversion setting, and the resulting
grey-scale image is cached. If you change the conversion method, the cached image
is released, and a new grey-scale image will be created with the new conversion method
when a vision tool needs it.
Image Object Dialog Box Changes
The list of camera formats in the Acquisition tab no longer includes the video format
numbers. Only video format names are displayed.
Image Object API Changes
Beginning with OMI 2.3, video formats are specified by name instead of by number. This
release introduces four new functions to specify video formats:
• SetVideoFormat / GetVideoFormat
• GetVideoFormatCount
• GetVideoFormatFromIndex
These functions are described in detail in the OMI 2.3 Object Reference.
SetGreyConversion now causes the specified RGB plane to be used when a vision tool
needs to convert a color image into a grey-scale image; this means that you can use all
three planes from the same color image without acquiring the image three times
SetTriggerEnable and GetTriggerEnable allow you to enable or disable triggers.