WWW.NNC.IR
Macro Reference
483
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
DrawFigure
Draw a figure on the image window.
Format
DrawFigure <figure()>, <imageNo>[, <unitNo>]
Parameter
Return value
None.
Description
On the measurement image whose specified image number is in the <imageNo> parameter, draw a figure
specified in the <figure()> parameter.
Specify the corresponding Unit Macro processing unit number in the <unitNo> parameter to draw the image
at the position coordinates before applying position compensation. If the <unitNo> parameter is omitted, the
image is drawn at the position coordinates after applying position compensation.
In the <figure()> parameter, specify the 1D integer array variable that will hold the figure data by adding only
() without specifying an element number.
Normally 0 should be specified in the <imageNo> parameter.
In the <unitNo> parameter, normally specify the processing unit number of the Unit Macro processing unit
that executes this process.
If an incorrect data type is specified for a parameter, a "Type mismatch" error will occur.
If a non-existent number, numerical value, or combination of data types or values are specified for a
parameter, an "Illegal function call" error will occur.
If a value outside the range -2147483648 to 2147483647 is specified as an integer parameter, an "Overflow"
error will occur.
If the format is written incorrectly, such as writing the macro function name incorrectly, omitting a comma, or
omitting a half-width space, a "Syntax error" error will occur.
Usage Cautions
• This macro function can only be used in the *MEASUREDISPI subroutine or the *MEASUREDISPG
subroutine. If used in another subroutine, an "Illegal function call" error will occur.
Parameter
name
Data type Description
<figure()> Integer array
1D array that stores the drawn figure data (Reference: XFigure Data Structure List
(p.364))
<imageNo> Integer type Measurement image number to draw on (always 0)
<unitNo> Integer type
Processing unit number to display the processing unit (0 to (the number of registered
processing units in the current scene minus one))