WWW.NNC.IR
Macro Reference
671
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
SaveImage
Saves image data.
Format
SaveImage <preImageNo>, <fileName>
Parameter
Return value
None.
Description
Saves the image that has the image logging number specified in the <preImageNo> parameter, using the file
name specified in the <fileName> parameter, in ifz format.
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, the most recent input image is saved.
In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.
Specify the file extension ".ifz" in the file name specified in the <fileName> parameter.
If the file of the file name specified in the <fileName> parameter already exists, it is overwritten.
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.
Example
Saves the most recent measurement image.
Useable Modules
Scene Control Macro / Communication Command Macro
Parameter
name
Data type Description
<preImageNo>
Integer type
Number (-1 to (number of images already logged in main unit minus one)) of main unit
logging image to be saved
<fileName>
Character
string type
File name of file to be saved
Rem Save the most recent input image as a file.
SaveImage -1, "C:\IMAGE\sample.ifz"