Click here to show toolbars of the Web Online Help System: show toolbars |
Table: | For specifying the scan line |
MIL_ID ContextGraId, | //in |
MIL_ID ResultCodeId, | //in |
MIL_ID DstImageBufOrListGraId, | //in |
MIL_INT64 Operation, | //in |
MIL_INT ResultIndex, | //in |
MIL_INT ScanIndex, | //in |
MIL_INT64 ControlFlag | //in |
This function draws specific features of results, obtained from an McodeRead(), McodeGrade(), McodeWrite(), or McodeDetect() operation, in the specified destination image buffer or 2D graphics list.
Specifies the identifier of the 2D graphics context to use when drawing. This parameter must be set to one of the following values:
For specifying the 2D graphics context
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies that the default 2D graphics context of the current MIL application is used. |
||||||||||||||||||||||||||||||||||||||
MIL 2D graphics context identifier |
Specifies a valid 2D graphics context identifier, which you have allocated using MgraAlloc(). |
Specifies the identifier of the code read, grade, or detect result buffer from which to extract features to draw. The code result buffer must have been previously allocated on the required system using McodeAllocResult() with M_DEFAULT or M_CODE_DETECT_RESULT.
Specifies the identifier of the destination image buffer or 2D graphics list in which to draw specific features of results.
If specifying an image buffer, it must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error. The image buffer must be an 8-bit, unsigned, 1-band image buffer, allocated using MbufAlloc...().
In general, the destination image buffer should be the same size as the image that you just read. For the M_DRAW_REFLECTANCE_PROFILE and M_DRAW_SCAN_PROFILES drawing operations, determine the required image buffer width using McodeGetResult() with M_SCAN_REFLECTANCE_PROFILE_LENGTH. For best results for a M_DRAW_REFLECTANCE_PROFILE drawing operation, the image buffer must have a height of at least 256.
If you specify a 2D graphics list, the 2D graphics list must have been previously allocated using MgraAllocList().
By drawing into the display's overlay buffer or associating the 2D graphics list with the display, you can also annotate an image non-destructively.
Specifies the type of drawing operation to perform. Drawing operations can be added together to draw multiple features at a time. For example, to draw both the result occurrence's position and code symbol as it was read using McodeRead(), set the Operation parameter to M_DRAW_POSITION + M_DRAW_CODE.
The following drawing operations are only available after performing an McodeRead() or McodeGrade() operation.
For specifying the type of drawing operation after an
McodeRead() or McodeGrade() operation
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DRAW_CODE + |
Draws the specified code occurrence as it was read by McodeRead() or McodeGrade(). |
||||||||||||||||||||||||||||||||||||||
M_DRAW_DECODED_SCANS + |
Draws the specified decoded scan line(s) that an McodeRead() or McodeGrade() operation used to read the specified code occurrence(s). |
The following types of drawing operations are only available after performing an McodeRead(), McodeGrade(), McodeWrite() operation.
For specifying the type of drawing operation after an
McodeRead(), McodeGrade(), McodeWrite() operation
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DRAW_POSITION + |
Draws a cross-like symbol at the mid-point of the code occurrence. |
The following types of drawing operations are only available after performing an McodeGrade() operation.
For specifying the type of drawing operation after an
McodeGrade() operation
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DRAW_EXTENDED_AREA + |
Draws a box around the specified code occurrence, including its extended area, as analyzed by the McodeGrade() operation. |
||||||||||||||||||||||||||||||||||||||
M_DRAW_REFLECTANCE_PROFILE + |
Draws the scan reflectance profile of the specified scan line(s) of the code occurrence, as analyzed by the McodeGrade() operation. |
||||||||||||||||||||||||||||||||||||||
M_DRAW_SCAN_PROFILES + |
Draws the specified scan line(s) analyzed in the code occurrence by the McodeGrade() operation. |
You can use one or more of the following values in combination with each other or with the above-mentioned values, to specify a drawing operation that is available after an McodeRead(), McodeGrade(), McodeWrite(), or McodeDetect() operation.
Refer to individual values for usage details after specific code operations.
For specifying a drawing operation that is available
after either an McodeRead(), McodeGrade(), McodeWrite(), or
McodeDetect() operation
|
|||||||||||||||||||||||||||||||||||||||
|
Description | ||||||||||||||||||||||||||||||||||||||
M_DRAW_BOX + |
Draws a box around the code occurrence. |
||||||||||||||||||||||||||||||||||||||
M_DRAW_QUIET_ZONE + |
Draws a box around the specified code occurrence, including its quiet zone, as analyzed by the McodeRead(), McodeGrade(), or McodeWrite() operation. |
You can add one of the following values to the above-mentioned values to specify the component of a composite code occurrence for which to draw results.
These values are only available to draw results from an McodeGrade() operation.
For specifying the component of a composite code
occurrence from an McodeGrade() operation
|
|||||||||||||||||||||||||||||||||||||||
|
Description | ||||||||||||||||||||||||||||||||||||||
M_LINEAR_COMPONENT |
Draws the grading result for the 1D component (linear component) of a composite code occurrence. |
||||||||||||||||||||||||||||||||||||||
M_2D_COMPONENT |
Draws the grading result for the 2D component of a composite code occurrence. |
Specifies the code occurrence for which to draw results.
This parameter should be set to one of the following values:
For specifying the occurrence index of the code
result
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ALL. |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Performs the specified operation for all code occurrences in the code result buffer. |
||||||||||||||||||||||||||||||||||||||
0 <= OccurrenceIndex < M_NUMBER |
Specifies the index of the code occurrence in the code result buffer. |
Specifies the scan line(s) for which to draw results.
Note that specifying a scan line is only applicable to drawing operations that draw results for specified scan lines (for example, M_DRAW_REFLECTANCE_PROFILE or M_DRAW_SCAN_PROFILES). For all other drawing operations, set this parameter to M_GENERAL. If specifying both a scan line-specific drawing operation and a general drawing operation (for example, M_DRAW_REFLECTANCE_PROFILE + M_DRAW_CODE), set this parameter to the scan line(s) for which to draw results instead of passing M_GENERAL.
This parameter should be set to one of the following values:
For specifying the scan line
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies to perform the scan line-specific drawing operation for all scan lines of the specified code occurrence(s). |
||||||||||||||||||||||||||||||||||||||
M_GENERAL |
Specifies to perform the drawing operation without specifying a scan line. |
||||||||||||||||||||||||||||||||||||||
0 <= Value < M_NUMBER_OF_DECODED_SCANS |
Specifies the index of the decoded scan line for which to perform the drawing operation, for the specified code occurrence. |
||||||||||||||||||||||||||||||||||||||
0 <= Value < M_NUMBER_OF_SCANS |
Specifies the index of the scan line for which to perform the drawing operation, for the specified code occurrence. |
Header | Include mil.h. |
Library | Use mil.lib; milcode.lib. |
DLL | Requires mil.dll; milcode.dll. |