2.1 KiB
2.1 KiB
LoadImageCombined
LoadImageCombined is a flexible image loader that handles single files, folders, and auto-advancing batches in one node. It keeps multi-shot reviews moving without juggling separate loaders.
Inputs
image_path– File path to a single image. Leave blank if you want to use folder mode.folder_path– Directory to scan for images. Works with recursive or flat structures.recursive– Search subfolders when set toTrue.auto_next– WhenTrue, the node advances to the next image each time it executes.loop– Restart from the beginning when the folder list is exhausted.shuffle– Randomise the order for variety during reviews.max_batch– Number of images to load per run. Set to1for single-image mode.
Outputs
image– Loaded image tensor or batch.mask– Optional alpha/mask channel when the file provides one; otherwise emits zeros.filename– Name of the file currently loaded.next_index– Position of the next image the node will load (useful for sequencing).
Where It Fits
Use LoadImageCombined at the front of portrait pipelines when you bounce between single reference frames and whole folders of stills. It’s also handy for QA passes where you want to step through before/after pairs without reconfiguring the graph.
Tuning Tips
- Enable
auto_nextwithloopfor unattended slideshows or automated batch processing. - Keep
shuffleoff when the order matters (e.g., matching filenames later in the workflow). - Set
max_batchhigher than1only when downstream nodes can handle true batches; many portrait tools expect single images.
Troubleshooting
- Node repeats the same image – Confirm
auto_nextis enabled andmax_batchis1. In batch mode it stays on the same set until the next execution. - Images appear in strange order – Disable
shuffleand ensurerecursiveis set according to your folder structure. - Mask output is empty – The source file likely lacks an alpha channel; this is normal. Supply a separate mask if needed.
Screenshot: docs/screenshots/load_image_combined.png