WWW.NNC.IR
Macro Reference
675
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
SaveScene
Saves the scene data.
Format
SaveScene <sceneNo>, <fileName>
Parameter
Return value
None.
Description
Saves the scene data of the scene number specified in the <sceneNo> parameter in the file with the file
name specified in the <fileName> parameter.
In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.
Specify the file extension ".scn" in the file name specified in the <fileName> parameter.
If the file 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 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
• Execute this macro function when the BUSY signal or other measurement in progress signal is ON and
measurement is prohibited. (Reference: XState Transitions and Execution Timing (p.227))
Example
Saves the scene data of scene 2 in a file
Useable Modules
Scene Control Macro / Communication Command Macro
Supported Versions
Version 3.50 or later
Parameter
name
Data type Description
<sceneNo> Integer type Scene number to save the scene (0 to 127)
<fileName>
Character
string type
File name of the scene data to save (*.scn)
Rem Save the scene data of scene 2 in a file.
SaveScene 2, "C:\BACKDIR\scene02.scn"