30 lines
2.0 KiB
Markdown
30 lines
2.0 KiB
Markdown
# LTX Reframe Layout
|
|
|
|
`LTX Reframe Layout` is a preparation node for LTX video outpainting. It does not load a model or sample a new video.
|
|
|
|
## What the node does
|
|
|
|
1. Select or upload a source video.
|
|
2. Choose the final canvas aspect ratio and exact LTX-compatible dimensions.
|
|
3. Drag the red source rectangle to reposition the video.
|
|
4. Drag any red corner to resize it without changing the source aspect ratio. Scale below `1.0` zooms out; scale above `1.0` zooms in and crops the source at the target boundary.
|
|
5. Execute the node to decode the video and produce padded frames, an outpaint mask, a source mask, the original frames, audio, FPS, and placement metadata.
|
|
|
|
Target dimensions are snapped to multiples of 64. The source is never stretched. `source_scale` ranges from `0.1` to `4.0`: the fitted source is `1.0`, smaller values create outpaint space, and larger values crop/zoom into the source. In the preview, video beyond the target boundary is dimmed while the red resize handles remain visible. `position_x`, `position_y`, and `source_scale` are ordinary serialized ComfyUI widgets, so the visual placement is reproducible in saved workflows and API prompts.
|
|
|
|
## LTX 2.3 connection
|
|
|
|
- Connect `padded_frames` to `LTXVInpaintPreprocess.images`.
|
|
- Connect `outpaint_mask` to `LTXVInpaintPreprocess.mask`.
|
|
- Feed the preprocessed image into the official LTX 2.3 IC-LoRA outpaint guide path.
|
|
- Use `source_mask` with `padded_frames` for a final source-preserving composite if the generated result changes the original region.
|
|
- Connect `audio` and `fps` to the final video assembly nodes.
|
|
|
|
The official local reference workflow is:
|
|
|
|
`ComfyUI-LTXVideo/example_workflows/2.3/LTX-2.3_ICLoRA_Outpaint_Two_Stage_Distilled.json`
|
|
|
|
## Current boundary
|
|
|
|
The first version supports one static placement for the entire clip. Animated reframing/keyframes, rotation, perspective warping, per-shot layouts, and automatic subject-aware positioning are intentionally left for later nodes or workflow stages.
|