
OMI 2.3.1 Release Notes
OMI 2.3.1 Release Notes 41
Image and Mask Editor
The Edit Mask button in the Mask Object dialog box now opens the Cognex Image and
Mask Editor. In earlier releases, the Edit Mask button opened the Paint program
supplied with Windows.
The Cognex Image and Mask Editor enables users to view and edit a mask "in place" on
top of the image being masked. When opened from the Mask Object dialog box, the
editor is automatically initialized with the mask values appropriate for the vision object
using the mask.
Masks that are children of CNLSModel and PMTool objects have a palette of Care and
Don’t Care pixel values that can be set as the foreground and background colors for
drawing. Masks used by PMPattern objects have a palette that includes Care, Don’t
Care But Score, and Don’t Care and Don’t Score pixel values.
Note The Image and Mask Editor must be opened from the Mask dialog
box to create masks that OMI objects can use. If you run the editor
as a standalone application, OMI cannot use the masks you create.
The introduction of the Image and Mask Editor changes the interface of the Mask object.
Because the editor works with both an underlying image and the mask image, the Mask
object interface now refers both to an "original image" (the image being masked) and to
the mask image. Refer to the documentation of the Mask object dialog box and API in
the OMI Object Reference for additional information. A new Deprecated Functions
section contains a list of API changes.
Visual Basic Notes
Strings Returned by Functions Must be Allocated
When an OMI function takes a string as input, such as to supply a file name, the string
may be declared like this:
Dim InputString As String
If an OMI function returns a value as a string, such as AcuBc_GetString() and other
functions, the string declaration must allocated enough storage for the expected string,
like this:
Dim OutputString As String * 20
Commentaires sur ces manuels