Nodes/VRGameDevGirl Video Enhancement Nodes/Video Enhance - Prepare Video and Anchors
ComfyUI Node

Video Enhance - Prepare Video and Anchors

Slice your video, choose anchors, plan the LTX pass

By vrgamegirl19·Created about a year ago·Updated about 7 hours ago· 718
Video Enhance - Prepare Video and Anchors
  • video_frames
  • video_info
  • ltx_working_frames
  • anchor_images
  • anchor_count
  • anchor_indices
  • ltx_video_path
  • ltx_width
  • ltx_height
  • fps
  • video_enhance_context
anchor_interval16 frames (recommended)
anchor_width768
anchor_height432
ltx_width960
ltx_height544
dimension_multiple32 (recommended)
fit_modeFit with letterbox (preserve all)
resize_methodBicubic (recommended)
fallback_fps24.000

Video enhancement in this pack isn't "upscale the pixels and hope." It's a pipeline: slice your source into guide anchors, enhance those anchors with Z-Image, let LTX use the enhanced anchors to rebuild the whole video, then restore the exact original resolution. Every one of those steps needs a clean, consistent starting state - and that's what VRGDG Video Enhance - Prepare Video and Anchors produces. It's the front door of the whole Video Enhance node set.

You feed it the raw frames from a VHS Load Video node, and it does the prep work in one pass: creates an independent full-frame Video Enhance job, builds a temporary LTX video at working resolution, and picks regularly spaced frames to become Z-Image anchors - while keeping the original frames untouched and stashed in the context so the final restore step can enforce the exact source resolution and frame count.

The inputs

  • video_frames - the full IMAGE batch from VHS Load Video. The tooltip is emphatic: these original frames remain unchanged and are what guarantees the final output matches the source exactly.
  • video_info (optional) - the VHS_VIDEOINFO output from the loader, so the temporary LTX video uses the exact source FPS instead of a guess. Connect it; the fallback_fps (default 24) only kicks in when you don't.

The rest are the settings that decide the shape of the job:

  • anchor_interval (default 16 frames) - how often an anchor frame is pulled. First and final frames are always included. Smaller spacing = more LTX reference, more Z-Image runs. 16 is the recommended middle ground.
  • anchor_width / anchor_height (defaults 768×432) - the resolution Z-Image enhances at. These don't change the final video; they're the guide-frame working size. Match the source aspect ratio.
  • ltx_width / ltx_height (defaults 960×544) - the temporary LTX working resolution. Higher = more spatial detail but noticeably more VRAM and runtime. Final output is restored to the source regardless.
  • dimension_multiple (default 32) - rounds all dimensions to a model-friendly multiple. LTX is strict: width and height must be divisible by 32, or it fails. The resolved values come out as outputs so loaders can match them exactly.
  • fit_mode - Fit with letterbox (preserve all, black bars if ratios differ), Crop to fill (trim edges), or Stretch (usually not recommended - it changes aspect ratio).
  • resize_method - Bicubic recommended; Area helps on big downscales.

The outputs

ltx_working_frames and anchor_images (the picked guides), plus anchor_count, anchor_indices, ltx_video_path, ltx_width, ltx_height, and fps - and the video_enhance_context that carries the untouched source frames through the rest of the pipeline. The outputs you'll actually wire downstream are anchor_count (into the VHS Meta Batch setup) and the context.

Where it fits and the gotchas

Order of operations: Prepare → Load Anchors (Meta Batch) → Z-Image enhance → Store Enhanced Anchors → Collect LTX Inputs → LTX → Restore Original Resolution.

The classic mistakes are all resolution math. Don't set ltx_width/ltx_height to your final deliverable - you're paying for it in VRAM and the output gets restored anyway. Keep the working LTX size modest. And don't fight dimension_multiple; off-multiple dimensions are exactly the kind of thing that makes LTX silently fail. Start with the defaults on a short clip before committing a long video - the author's own guidance, and it applies double here because this node sets up an expensive chain.

Install

Standard pack install (Manager → search vrgamedev, restart, hard-refresh). This stage assumes the Video Helper Suite (VHS) for loading frames and video info, and a Z-Image checkpoint for the anchor-enhancement stage that follows. The pack's Video Enhance workflows come bundled under Workflows/ and show the full wiring.

CategoryVRGameDevGirl/Video Enhance

Inputs (11)

NameTypeDefaultDescription
video_framesIMAGEConnect the full IMAGE batch from VHS Load Video. These original frames remain unchanged in the context and are used to enforce the exact final resolution and frame count.
anchor_intervalCOMBO16 frames (recommended)Spacing between full-frame Z-Image guide anchors. The first and final frames are always included. Smaller spacing gives LTX more enhanced references but requires more Z-Image runs.
anchor_widthINT768128–4096Requested width used only for Z-Image anchor enhancement. It does not change the source or final video resolution.
anchor_heightINT432128–4096Requested height used only for Z-Image anchor enhancement. Choose dimensions matching the source aspect ratio unless using Fit with letterbox.
ltx_widthINT960128–4096Temporary LTX working width. Higher values can improve spatial detail but substantially increase VRAM use and runtime. Final output is restored to the source width.
ltx_heightINT544128–4096Temporary LTX working height. Higher values can improve spatial detail but substantially increase VRAM use and runtime. Final output is restored to the source height.
dimension_multipleCOMBO32 (recommended)Rounds requested anchor and LTX dimensions to a model-friendly multiple. The resolved dimensions are exposed as outputs so downstream loaders can match them exactly.
fit_modeCOMBOFit with letterbox (preserve all)Fit preserves the entire frame and adds black bars if aspect ratios differ. Crop fills the dimensions while trimming edges. Stretch changes aspect ratio and is usually not recommended.
resize_methodCOMBOBicubic (recommended)Interpolation used for temporary anchor and LTX resizing. Bicubic is a strong general default. Area can be useful for large downscales.
fallback_fpsFLOAT24.0001–240Used only when video_info is not connected or lacks FPS metadata. Connect video_info to preserve exact source timing.
video_infooptVHS_VIDEOINFOConnect VHS Load Video video_info so the temporary LTX video uses the exact source FPS.

Outputs (9)

NameTypeDescription
ltx_working_framesIMAGE
anchor_imagesIMAGE
anchor_countINT
anchor_indicesSTRING
ltx_video_pathSTRING
ltx_widthINT
ltx_heightINT
fpsFLOAT
video_enhance_contextVRGDG_VIDEO_ENHANCE_CONTEXT