ComfyUI Node

Custom Crop Area

Crop plans for the VACE upscaler when the default grid is wrong

By bbaudio-2025·Created about a year ago·Updated 10 months ago· 139
Custom Crop Area
    • LIST
    width_upscale1280
    height_upscale720
    presets'H' for wide screen

    SuperUltimate VACE Upscale tiles your video by default: it cuts the target size into an even grid of rectangles and denoises each tile, blending them back with feathered masks. That works, but "even grid" is a default, not a law. This node hands you two hand-built crop plans for when the uniform grid fights the actual composition.

    How it works

    It's a preset generator. Give it your target dimensions (which should match the upscaler's width_upscale / height_upscale), pick a presets, and it returns a LIST of crop areas - each with its crop size, offset, mask margins and feather widths - in exactly the format the upscaler's croparea_list input expects. Wire the output into the upscaler's croparea_list and it uses your plan instead of the auto grid.

    The two presets:

    • "'H' for wide screen" - a 4-tile layout that splits the frame into a central region plus left/right flanks, with overlap and feathering on the inner borders. The idea is to keep the middle of a wide shot in one coherent tile instead of slicing it down the middle.
    • "'三' for long narrow screen" - a stacked, four-band layout for tall/narrow compositions (the character name is literally the Chinese character for three, 三, as in three stacked bands plus a footer). Overlap lives on the horizontal seams.

    Each plan sets its own masks and feathering so the tiles blend cleanly - that's the part you'd otherwise be hand-rolling.

    The one real constraint

    The plans do geometry math that assumes your dimensions line up, so:

    • 'H' requires height_upscale to be a multiple of 16, or the node raises an error ("'H' plan requires height_upscale to be multiplier of 16").
    • '三' requires width_upscale to be a multiple of 16.

    Set your upscaler's target to something 16-aligned (1280x720 is fine; 1279x720 is not) and this disappears. The presets also need the crop math to produce valid tiles - keep the aspect ratio sane and you're fine.

    Install

    Same pack:

    cd ComfyUI/custom_nodes
    git clone https://github.com/bbaudio-2025/ComfyUI-SuperUltimateVaceTools
    

    Restart ComfyUI (or search "SuperUltimateVaceTools" in Manager). No dependencies, no models - it's pure list generation.

    Gotchas

    • Both presets assume the target dims you pass in match what the upscaler is actually rendering to. Mismatch them and the tiles won't cover the frame. Keep the numbers in sync between the two nodes.
    • The tooltip calls these "presets of cropping plan" - there are exactly two. If neither fits, your options are to use the default grid or (since the list format is just dictionaries) build your own crop plan with a custom LIST.
    • width_upscale/height_upscale here mirror the upscaler's target, not the tile size. It's an easy slip to paste the tile dims in and get a plan that doesn't cover the frame.

    It's a small helper, but the 三 preset genuinely changes how good long-narrow upscales look - the default grid can put a seam right through the subject, and this plan moves the seams to where they're invisible. Try both presets once and you'll know which frame shapes they were built for.

    CategorySuperUltimateVaceTools

    Inputs (3)

    NameTypeDefaultDescription
    width_upscaleINT128016–16384
    height_upscaleINT72016–16384
    presetsCOMBO'H' for wide screen预设分割方案 Presets of cropping plan

    Outputs (1)

    NameTypeDescription
    LISTLIST