Start » Filter Reference » Image » Image IO » GrabImage_FromFiles

GrabImage_FromFiles


Module: FoundationLite

Simulates capturing a frame from a camera.

Applications

Can be used as EnumerateImages, but its state is global in a program - does not reset when some task is finished.
Name Type Range Description
Input value
inDirectory Directory Input directory
Input value
inFileType ImageFileFormat* File format of the images
Input value
inSortingOrder FileSortingOrder Sorting order
Input value
inRepeat Bool Determines whether to repeat reading directory after reading all files
Input value
inProcessSubdirectories Bool Flag indicating whether to load images from the subdirectories or not
Input value
inInvert Bool Flag indicating whether to enumerate images backwards or not
Input value
inLoadAlphaChannel Bool Flag indicating whether to load alpha channel of the image or not
Input value
inDelay Integer 0 - 2000
Output value
outImage Image Output image
Output value
outFilePath File Output file path
Output value
outFileName String Output file name

Description

This filter works similarly to EnumerateImages, but it behaves more like a camera: it preserves its state across the whole program.

For example, you can have two GrabImage_FromFiles filters in two different Task macrofilters. When execution of second Task starts, images loaded previously in the first Task are not loaded again.

Examples

Description of usage of this filter can be found in examples and tutorial: HMI Start Stop.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError All instances of GrabImage_FromFiles must have these same parameters.

Complexity Level

This filter is available on Basic Complexity Level.

See Also

  • EnumerateImages – Scans a disk directory for image files and then returns the images one by one in consecutive iterations sorted according to the specified order.