AM Read Image

A ComfyUI node in AM VFX Tools with 20 inputs and 9 outputs.

By am-pipeline-prod·Created 4 months ago·Updated 2 months ago· 3

AM Read Image

image
mask
resolved_path
info
width
height
frame_rate
frame_count
video

◄file_path►

◄frame_modeall►

◄frame_rate-1.00►

◄first_frame1►

◄last_frame1►

◄missing_framesblack►

◄beforehold►

◄afterhold►

◄input_colorspaceACES/ACES2065-1►

◄raw_datafalse►

◄working_colorspaceDisplay/sRGB - Display►

◄reformat_modeoff►

◄scale1.00►

◄presetWidth/Height►

◄target_width1920►

◄target_height1080►

◄resize_typefit►

◄filtercubic►

◄output_dtypefp16►

◄show_previewtrue►

CategoryAM VFX Tools

Inputs (20)

Name	Type	Default	Description
file_path	STRING		Absolute path to the file or image sequence. For sequences, use a frame token: ``####`` / ``%05d`` / ``$F4`` style. Use the 📂 Browse button to populate from the native file dialog.
frame_mode	COMBO	all	Which frames to load. single = only `first_frame`. range = `first_frame`..`last_frame` inclusive (with `before`/`after` policy at edges). all = every present frame in the resolved directory.
frame_rate	FLOAT	-1.00-1–480	Frame rate for the `frame_rate` output socket. -1 = auto: probe EXR/OIIO metadata (framesPerSecond, input/framesPerSecond, frameRate, framerate, fps); fallback 25 fps. Any other value = explicit override.
first_frame	INT	1-999999–999999	Frame index in single mode; lower bound in range mode. Ignored in all mode. The 🔍 Detect Range button auto-fills this.
last_frame	INT	1-999999–999999	Range upper bound (inclusive). Used in range mode only. The 🔍 Detect Range button auto-fills this from the on-disk scan.
missing_frames	COMBO	black	Policy when a frame inside the requested set is missing on disk. error = abort the load. black / checkerboard = synthesize a placeholder. hold = repeat the last successful frame. nearest = use the nearest existing frame number.
before	COMBO	hold	Edge policy below the on-disk range when `frame_mode=range`. hold = clamp to first frame; loop = wrap; bounce = ping-pong; black = synthesize black.
after	COMBO	hold	Edge policy above the on-disk range when `frame_mode=range`. Mirrors `before` — same options, applied at the upper edge.
input_colorspace	COMBO	ACES/ACES2065-1	Source colorspace of the file. The OCIO transform converts from this to `working_colorspace`. Pick `raw` to honor the file's own tagged colorspace; pick a specific value to override.
raw_data	BOOLEAN	false	When On, skip the OCIO transform — pixels pass through unchanged. `input_colorspace` and `working_colorspace` are ignored.
working_colorspace	COMBO	Display/sRGB - Display	Target colorspace for the IMAGE output — the space downstream nodes (Grade, samplers, ...) will see.
reformat_mode	COMBO	off	Reformat mode. off = bypass, output matches input. scale = uniform scale by `scale` (other widgets ignored). to_box = resize/crop to a target W×H from `preset` or `target_width`/`target_height`.
scale	FLOAT	1.000.01–16	Uniform scale factor. Used when `reformat_mode=scale`; ignored otherwise. Output dimensions are round(input × scale).
preset	COMBO	Width/Height	Named output format. Used when `reformat_mode=to_box`. `Width/Height` = use the `target_width` / `target_height` widgets below. Any other entry overrides those widgets with the preset's resolution.
target_width	INT	19201–16384	Target output width in pixels. Used when `reformat_mode=to_box` AND `preset=Width/Height`; ignored when a named preset is selected.
target_height	INT	10801–16384	Target output height in pixels. Used when `reformat_mode=to_box` AND `preset=Width/Height`; ignored when a named preset is selected.
resize_type	COMBO	fit	How input maps into the target box. Used when `reformat_mode=to_box`. width/height = scale uniformly to match that edge. fit = scale to fit inside the box (letterbox; black where the box exceeds the scaled image). fill = scale to cover the box (crops the overflow). distort = scale W and H independently to exactly match the box (changes aspect). none = no scale; place input centered in the box (crop if larger, pad if smaller). Cropped-away/padded regions are TRANSPARENT — RGB sources are promoted to RGBA with alpha=0 in the padded area so downstream compositing is clean.
filter	COMBO	cubic	Pixel filter for resampling. impulse = nearest-neighbor (mask passes, exact pixel preservation). linear = bilinear (cheap, smooth). cubic = bicubic (default; the safe Nuke-equivalent). Lanczos4 = sharpest; for high-quality stills / final delivery. area = best for downscaling — anti-aliased mean pooling, softer but artifact-free.
output_dtype	COMBO	fp16	Output tensor dtype. fp32 = ComfyUI default (4 bytes/sample). fp16 = half memory + half VRAM (2 bytes/sample). EXR-native precision; fits the [0,1] LDR + scene-linear range with headroom up to ~65504. Some downstream nodes assume fp32 — flip back to fp32 if you hit dtype errors.
show_preview	BOOLEAN	true	Show a thumbnail of the loaded frame on the node.

Outputs (9)

Name	Type	Description
image	IMAGE	Frame batch as IMAGE (N×H×W×3 float in [0,1]). RGB only — alpha is split out to the `mask` socket per stock-ComfyUI convention.
mask	MASK	Alpha channel as MASK (N×H×W float in [0,1]). MASK CONVENTION (stock ComfyUI): mask = 1 - alpha white (1.0) = 'area to inpaint' (source was transparent) black (0.0) = 'keep' (source was opaque) empty mask = all zeros (source has no alpha = fully visible) This is the SD-inpainting convention every stock ComfyUI mask-using node expects (LoadImage, MaskComposite, SetLatentNoiseMask, ImpactPack mask pipeline, etc.). Drop-in compatible with all of them. If you want NUKE-STYLE natural alpha (mask = alpha, where 1.0 = opaque), wire a MaskInvert node between this socket and your downstream consumer. Populated when the source carries alpha: * Image: EXR / PNG / TIFF with α channel * Video: ProRes 4444 / 4444 XQ, QuickTime RLE, FFV1 (yuva*) Otherwise emits the empty mask (zeros = fully opaque source).
resolved_path	STRING	Resolved on-disk path of the last successfully read frame.
info	STRING	Human-readable summary: dimensions, bit depth, source colorspace, frame count.
width	INT	Frame width in pixels.
height	INT	Frame height in pixels.
frame_rate	FLOAT	Effective fps. From the `frame_rate` widget when set, else probed from EXR/OIIO metadata, else 25 fallback.
frame_count	INT	Number of frames in the IMAGE batch.
video	VIDEO	Convenience VIDEO wrapper (`VideoFromComponents`) around the same IMAGE batch + frame_rate. NO RAM benefit — frames are already decoded. Equivalent to wiring `Create Video` downstream. Native `SaveVideo` only accepts this as MP4+H264; use AM Write Video for other codecs.