Skip to content
ArcBrush ArcBrush Docs

Image Folder

Image Folder
Inputs

Loads all images from a folder as a batch output for downstream batch processing.

Image Folder scans a directory on disk and loads every matching image into a single batch output. It reads the same formats as Image In (PNG, JPEG, WebP, TIFF, OpenEXR, TGA, BMP), including high-bit-depth sources, per frame - multi-layer, multi-part, and tiled EXR files load here too. A file pattern filter (e.g. .png;.jpg) controls which files are included, and an Include Subfolders toggle optionally recurses into child directories.

Sort results by Name, Date Modified, or File Size, with an optional Reverse Order toggle. A Limit parameter caps the number of loaded images when you only need a subset. The output is a BATCH pin that feeds directly into Sprite Sheet, Export Batch, Split, or any other batch-consuming node.

Like Image In, Image Folder has an Output Format control (Auto / RGBA / Grayscale) that sets each frame’s channel layout, plus a Grayscale From option (Luminance, Red, Green, Blue, or Alpha) for converting multi-channel sources. The setting applies per frame, so a mixed folder of grayscale and color files produces a mixed batch.

Parameters

Section titled “Parameters”

Folder

FolderText

Path to folder containing images

Filter & Sort

File PatternText
Default: *.png;*.jpg;*.jpeg;*.webp;*.tif;*.tiff;*.bmp;*.tga;*.exr

Semicolon-separated file patterns (e.g. *.png;*.jpg)

Include SubfoldersToggle
Default: false

Walk subdirectories to find images

Sort ByChoice
Default: Name

Sort order: Name, Date Modified, or File Size

  • NameSort alphabetically by filename.
  • Date ModifiedSort by file modification timestamp.
  • File SizeSort by file size on disk.
Reverse OrderToggle
Default: false

Sort in descending order

LimitInteger
Default: 0 Range: 0–10000

0 = no limit. Load only the first N images

Output

Output FormatChoice
Default: Auto

Note: a grayscale frame becomes RGBA again at any color-only downstream node; the node body shows 'Gray' where it is still single-channel

  • AutoPer frame, keep a natively single-channel file as a single-channel image and promote everything else to RGBA, so a mixed folder yields a mixed batch. The default.
  • RGBALoad every frame as a full-color RGBA image, widening single-channel sources.
  • GrayscaleLoad every frame as a single-channel image, reducing color sources using the Grayscale From channel.
Grayscale FromChoice
Default: Luminance
When Output Format is Grayscale and source is multi-channel

Which channel or formula to use when converting a multi-channel source to grayscale.

Shown only when Output Format is Grayscale and the source is multi-channel.

  • LuminanceDerive the gray value from perceived brightness (weighted RGB). The most natural choice.
  • RedUse the red channel as the gray value.
  • GreenUse the green channel as the gray value.
  • BlueUse the blue channel as the gray value.
  • AlphaUse the alpha channel as the gray value.

Usage Tips

Section titled “Usage Tips”
  • Use the file pattern filter (e.g. .png;.jpg) to load only specific formats from a mixed folder.
  • Enable Include Subfolders to recursively gather images from a nested directory structure.
  • Set Sort By to Date Modified and enable Reverse Order to load newest files first.
  • Use Limit to cap the batch size when testing a pipeline on a large folder.
  • Wire into Sprite Sheet to pack an entire folder of assets into a single atlas.
  • Set Output Format to Grayscale to load a folder of masks or height maps as single-channel frames instead of upcasting them to color.
Section titled “Related Nodes”