WWW.NNC.IR
Macro Reference
658
Vision System FH/FZ5 Series
User’s Manual (Z340)
Remeasure
Executes remeasurement.
Format
Remeasure <preImageNo>[, <wait>]
Remeasure <fileName>[, <wait>]
Parameter
Return value
None.
Description
Executes remeasurement at the recovery timing specified in the <wait> parameter for the image of the image
logging number specified in the <preImageNo> parameter or the image of the image file name specified in
the <fileName> parameter.
In the <preImageNo> parameter, specify the number of the logging image already logged as a logging image
in the main unit. (Reference: XSetting Logging Conditions [Logging Setting] (p.115))
If -1 is specified for the <preImageNo> parameter, remeasurement is executed using the most recent input
image.
If 0 is specified for the <preImageNo> parameter, remeasurement is executed using the most recent logged
image of the main unit.
If the <wait> parameter is omitted, operation is the same as when the <wait> parameter is set to 0.
When 0 is specified for the <wait> parameter, there is a possibility that the measurement processing
executed immediately after execution of this macro function will not have ended and the measurement result
cannot be properly gotten. If you want to get the measurement result, specify 1 or 2 for the <wait> parameter.
If an incorrect data type is specified for a parameter, a "Type mismatch" error will occur.
Even if a non-existent number, numerical value, or combination of data types is specified for the parameter,
an "Illegal function call" error will not occur.
If a value outside the range -2147483648 to 2147483647 is specified as an integer parameter, an "Overflow"
error will occur.
If a character string longer than 255 characters is specified for a character string parameter, a "String too
long" 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.
Parameter
name
Data type Description
<preImageNo>
Integer type
Image logging number (-1 to (number of images in main unit already logged minus one))
of image to be remeasured.
<fileName>
Character
string type
Image file name of image to be remeasured.
<wait> Integer type
Recovery timing of macro function
0: Executes subsequent program lines without waiting for measurement to end.
1: Waits for measurement to end and then executes subsequent program lines.
2: Waits for measurement to end and measurement result display to end and then
executes subsequent program lines.