WWW.NNC.IR
Macro Reference
601
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
LoadScene
Loads the scene data.
Format
LoadScene <sceneNo>, <fileName>
Parameter
Return value
None.
Description
The scene data file specified in the <fileName> parameter is loaded into the scene number specified in the
<sceneNo> parameter.
In the <fileName> parameter, use an absolute path to specify the file name of the file to be loaded.
In the <fileName> parameter, specify a scene data file name. If a file other than a scene data file is specified,
an "Illegal function call" error will occur.
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
Loads scene data into scene 2 and then changes the scene used to scene 2.
Useable Modules
Scene Control Macro / Communication Command Macro
Parameter
name
Data type Description
<sceneNo> Integer type Scene number of the destination to read in (0 to 127)
<fileName>
Character
string type
File name of the scene data to read in (*.scn)
Rem Load the file of the scene data.
LoadScene 2, "C:\BACKDIR\scene02.scn"
Rem Switch the scene.
ChangeScene 2