Back to Adaptive Vision Library website

You are here: Start » Function Reference » Image » Image IO » GrabImage_FromFiles

GrabImage_FromFiles


Header: AVL.h
Namespace: avl
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.

Syntax

C++
C#
 
bool avl::GrabImage_FromFiles
(
	const atl::Directory& inDirectory,
	atl::Optional<avl::ImageFileFormat::Type> inFileType,
	avl::FileSortingOrder::Type inSortingOrder,
	bool inRepeat,
	bool inProcessSubdirectories,
	bool inInvert,
	bool inLoadAlphaChannel,
	avl::Image& outImage,
	atl::File& outFilePath,
	atl::String& outFileName
)

Parameters

Name Type Default Description
inDirectory const Directory& \".\" Input directory
inFileType Optional<ImageFileFormat::Type> NIL File format of the images
inSortingOrder FileSortingOrder::Type Sorting order
inRepeat bool Determines whether to repeat reading directory after reading all files
inProcessSubdirectories bool Flag indicating whether to load images from the subdirectories or not
inInvert bool Flag indicating whether to enumerate images backwards or not
inLoadAlphaChannel bool Flag indicating whether to load alpha channel of the image or not
outImage Image& Output image
outFilePath File& Output file path
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.

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.