WWW.NNC.IR
Macro Reference
673
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
SaveMeasureImage
Saves the measurement image of the processing unit.
Format
SaveMeasureImage <measureImageNo>, <fileName>, <imageFormat>[, <startX>, <startY>,
<sizeX>, <sizeY>]
Parameter
Return value
None.
Description
Saves the measurement image specified in the <measureImageNo> parameter in a file with the file name
specified in the <fileName> parameter, the image format specified in the <imageFormat> parameter, and the
pixel size specified in the <sizeX> and <sizeY> parameters cut off from the position in camera coordinates
that starts from the upper left point specified in the <startX> parameter and <startY> parameter.
If the <start X>, <start Y>, <size X>, and <size Y> parameters are omitted, the entire image is saved.
Always specify 0 in the <measureImageNo> parameter.
In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.
In the file name specified in the <fileName> parameter, specify the file extension ".bmp" or ".jpg/jpeg".
If the file of the file name specified in the <fileName> parameter already exists, it is overwritten.
Specify a value of at least 1 in the <sizeX> and <sizeY> parameters.
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 is 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 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.
Usage Cautions
• None.
Parameter
name
Data type Description
<measureImageNo>
Integer type Measurement image number of the measurement image to be saved (always 0)
<fileName>
Character
string type
File name of file to be saved
<imageFormat>
Integer type
Image format of image to be saved
0: BMP format
10000 to 10100: JPEG format (10000 + JPEG image quality (0 to 100))
<startX> Integer type Start point X of image region to be saved
<startY> Integer type Start point Y of image region to be saved
<sizeX> Integer type X dimension of image to be saved (at least 1)
<sizeY> Integer type Y dimension of image to be saved (at least 1)