WWW.NNC.IR
Macro Reference
517
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
ExecuteImageLogging
Executes image logging.
Format
ExecuteImageLogging <directory>, <header>
Parameter
Return value
None.
Description
Executes image logging and saves the logged images using the file name (composed from the header
character string specified in the <header> parameter and a measurement identification) in the subdirectory
specified in the <directory> parameter.
Logged images are saved in the destination folder specified in [System setting] - [Logging setting].
(Reference: XSetting Logging Conditions [Logging Setting] (p.115))
If a subdirectory name is specified in the <directory> parameter, the logged file is saved in a subdirectory
created under the logged image files destination folder.
If any empty string "" is specified in the <directory> parameter, the subdirectory is not created.
Logged images are saved as a file with the file name composed of measurement identification number and
logging file extension .ifz (i.e., YYYY-MM-DD_HH-MM-SS-SSSS.ifz). If a header character string is specified
in the <header> parameter, the specified character string is added to the saved file name. If an empty string
"" is specified in the <header> parameter, no header character string is added to the file name.
If an incorrect data type is specified for a parameter, a "Type mismatch" 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 a character string longer than 63 characters is specified in the <directory> parameter, the 63-character
string before the 64th character is used for the macro function processing. Characters after the 64th
character will be discarded.
If a character string longer than 31 characters is specified in the <header> parameter, the 31-character string
before the 32nd character is used for the macro function processing. Characters after the 32nd character will
be discarded.
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
• This macro function can only be used in the *MEASUREPROC subroutine. If used in any other subroutines,
an error will occur and the function will not be executed.
Parameter
name
Data type Description
<directory>
Character
string type
Subdirectory name that saves the logging images
<header>
Character
string type
Header string added to the file name of the logged image