<h1 id="bruxosdovfx-camera-h3-v19.1">bruxosdovfx - Camera H3 v19.1</h1>Visual camera editor for MiniMax H3 inside ComfyUI.Drag the camera, create keyframes, and generate camera-path prompts for H3.The node compiles prompts. It is not a geometric camera adapter, so H3 can still miss angle, timing, or scale.<hr /><h2 id="installation">Installation</h2><pre><code>cd ComfyUI/custom_nodes
git clone https://github.com/NyckM/3d-Camera-control-H3-Minimax.git</code></pre>Restart ComfyUI and search for:<code>bruxosdovfx • Camera H3</code><hr /><h2 id="what's-new-in-v19.1">What's new in v19.1</h2><ul><li>Smooth - smoother motion between keyframes.</li><li>Linear - linear motion per segment.</li><li>Redistribute Timing - balances average speed between keyframes.</li><li>Unwrap - converts crossings such as <code>350° -&gt; 10°</code> to the short arc.</li><li>Start / End Hold - adds a 0.5 second hold.</li><li>Presets - orbit, rise, fall, move closer, move away, and static camera.</li><li>Diagnostics - detects holds, static paths, and zero crossings.</li><li>Loop Closure - <code>auto</code> closes compatible orbits; <code>off</code> disables it.</li><li>UI Language - Portuguese / English interface and diagnostics.</li></ul><hr /><h2 id="basic-use">Basic use</h2><ul><li>Drag the purple camera to orbit.</li><li>Mouse wheel changes distance.</li><li>Drag the background to rotate the preview only.</li><li>Use keyframes to build the path.</li><li>Pure Orbit resets elevation while keeping the orbit.</li><li>Play previews the planned camera path.</li></ul>The preview shows the planned trajectory, not the final H3 result.<hr /><h2 id="main-connections">Main connections</h2>H3 Edit<ul><li><code>compiled_prompt</code> -&gt; H3 Edit Text Encode</li><li><code>options</code> -&gt; H3 Edit Text Encode</li><li><code>reference_first</code> -&gt; H3 Edit source image</li><li><code>length</code> -&gt; generation length</li><li><code>fps</code> -&gt; video output FPS</li></ul>Use <code>compiled_prompt</code> and <code>options</code> together.Native H3 / Ref2VA<ul><li>Use <code>minimax_prompt</code> instead of <code>compiled_prompt</code>.</li></ul><hr /><h2 id="subject-box">Subject Box</h2><code>subject_box</code> tells the model who the camera should orbit around.If empty, the image center is used as the reference target.If filled, it identifies the subject position in the first frame.Example:<pre><code>[L=0.62, T=0.18, W=0.24, H=0.55]</code></pre><ul><li><code>L</code> - left position</li><li><code>T</code> - top position</li><li><code>W</code> - width</li><li><code>H</code> - height</li></ul>Values range from <code>0</code> to <code>1</code>.<h3 id="easy-setup">Easy setup</h3>Add:<code>bruxosdovfx • H3 Subject Box</code>Connect your image to <code>reference_image</code>, draw the box over the subject, and connect its <code>subject_box</code> output to Camera H3.This is especially useful when the subject is off-center.It does not crop, zoom, move the camera, or track the subject. It only identifies the orbit target in the first frame.<hr /><h2 id="freeze-frame">Freeze Frame</h2>Use a still image or reference frame.<ul><li>Connect <code>reference_image</code>.</li><li><code>freeze_index</code> selects the frame from the batch.</li><li>Connect <code>reference_first</code> to the H3 Edit source image.</li><li>Connect <code>compiled_prompt</code> and <code>options</code> to the H3 Edit encoder.</li></ul>With native H3, use <code>minimax_prompt</code> plus the first frame in an FL2VA workflow.<hr /><h2 id="motion-frame">Motion Frame</h2>Use a video or frame sequence as motion reference.<ul><li>Reference length: 2-15 seconds.</li><li>Set the real FPS in <code>source_fps</code>.</li><li>Use <code>scene coverage | camera path</code>.</li><li>Use an H3 Ref2VA model.</li><li>Use <code>bruxosdovfx • H3 Motion Reference</code>.</li></ul>Connections:<ul><li><code>reference_frames</code> -&gt; <code>reference_frames</code></li><li><code>minimax_prompt</code> -&gt; <code>prompt</code></li><li><code>length</code> -&gt; <code>length</code></li><li>Qwen H3 encoder -&gt; <code>clip</code></li><li>H3 video VAE -&gt; <code>vae</code></li></ul>The reference is converted to 24 fps and trimmed to the format expected by H3.Original audio is not forwarded.<hr /><h2 id="interpolation">Interpolation</h2>SmoothSmoothed camera motion. With <code>extended contracts</code>, movement stays more continuous between waypoints.LinearStraight interpolation between keyframes.<hr /><h2 id="timing">Timing</h2>Video timing uses the timestamp of the last visible frame:<pre><code>(length - 1) / fps</code></pre>Redistribute Timing adjusts keyframe timing for more even average camera speed.<hr /><h2 id="loop-closure">Loop Closure</h2><code>loop_closure = auto</code> can anchor the last frame to the first when the path is compatible.Usually ON when:<ul><li>Freeze Frame is active.</li><li><code>scene coverage | camera path</code> is used.</li><li>Orbit is exactly <code>+360°</code> or <code>-360°</code>.</li><li>Final elevation matches the start.</li><li>Final distance matches the start.</li><li>A reference image is connected.</li></ul>OFF when:<ul><li>Orbit is <code>359°</code>.</li><li>Orbit is <code>720°</code>.</li><li>Motion Frame is used.</li><li>A still-image angle task is used.</li><li>Final elevation or distance is different.</li><li><code>loop_closure = off</code>.</li></ul>Close Orbit adjusts the final pose so the path closes correctly.<hr /><h2 id="main-controls">Main controls</h2><ul><li><code>ui_language</code> - interface language.</li><li><code>camera_trajectory</code> - time, azimuth, elevation, and distance keyframes.</li><li><code>instruction</code> - extra prompt instruction.</li><li><code>subject_box</code> - identifies the subject and orbit target in the first frame.</li><li><code>orbit_direction</code> - corrects the direction sent to H3.</li><li><code>elevation_range</code> - vertical control range.</li><li><code>subject_framing</code> - records close-up, medium, or wide framing.</li><li><code>minimax_format</code> - controls <code>minimax_prompt</code> formatting.</li><li><code>prompt_detail</code> - baseline or extended contracts.</li><li><code>runtime_task</code> - video camera path or new still-image angle.</li></ul><code>subject_framing</code> does not apply zoom or cropping.<hr /><h2 id="outputs">Outputs</h2><ul><li><code>compiled_prompt</code> - prompt for H3 Edit.</li><li><code>options</code> - H3 Edit options.</li><li><code>minimax_prompt</code> - alternative prompt for native H3.</li><li><code>storyboard_json</code> - camera-path data.</li><li><code>info</code> - diagnostics.</li><li><code>length</code> - frame count.</li><li><code>fps</code> - output FPS.</li><li><code>h3world_actions</code> - approximate pan / tilt action text.</li></ul><hr /><h2 id="limitations">Limitations</h2><ul><li>H3 can still miss angle, scale, or timing.</li><li>The preview does not simulate the generated result.</li><li>Empty <code>subject_box</code> uses the image center as reference target.</li><li>Motion Frame depends on Ref2VA preserving the source action.</li><li><code>h3world_actions</code> describes approximate pan / tilt behavior, not a true geometric orbit.</li></ul><hr /><h2 id="credits">Credits</h2>Node by Bruxos do VFX.Based on the H3 Edit integration from:<a target="_blank" rel="ugc" href="https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit">https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit</a>Repository:<a target="_blank" rel="ugc" href="https://github.com/NyckM/3d-Camera-control-H3-Minimax">https://github.com/NyckM/3d-Camera-control-H3-Minimax</a><div data-youtube-video><iframe width="640" height="480" allowfullscreen="true" autoplay="false" disablekbcontrols="false" enableiframeapi="false" endtime="0" ivloadpolicy="0" loop="false" modestbranding="false" origin playlist src="https://www.youtube.com/embed/1QdCyhzACzQ?rel=1" start="0"></iframe></div>Visual camera editor for MiniMax H3 inside ComfyUI.Drag the camera, create keyframes, and generate camera-path prompts for H3.The node compiles prompts. It is not a geometric camera adapter, so H3 can still miss angle, timing, or scale.<hr /><h2 id="installation">Installation</h2><pre><code>cd ComfyUI/custom_nodes
git clone https://github.com/NyckM/3d-Camera-control-H3-Minimax.git</code></pre>Restart ComfyUI and search for:<code>bruxosdovfx • Camera H3</code><hr /><h2 id="what's-new-in-v19.1">What's new in v19.1</h2><ul><li>Smooth - smoother motion between keyframes.</li><li>Linear - linear motion per segment.</li><li>Redistribute Timing - balances average speed between keyframes.</li><li>Unwrap - converts crossings such as <code>350° -&gt; 10°</code> to the short arc.</li><li>Start / End Hold - adds a 0.5 second hold.</li><li>Presets - orbit, rise, fall, move closer, move away, and static camera.</li><li>Diagnostics - detects holds, static paths, and zero crossings.</li><li>Loop Closure - <code>auto</code> closes compatible orbits; <code>off</code> disables it.</li><li>UI Language - Portuguese / English interface and diagnostics.</li></ul><hr /><h2 id="basic-use">Basic use</h2><ul><li>Drag the purple camera to orbit.</li><li>Mouse wheel changes distance.</li><li>Drag the background to rotate the preview only.</li><li>Use keyframes to build the path.</li><li>Pure Orbit resets elevation while keeping the orbit.</li><li>Play previews the planned camera path.</li></ul>The preview shows the planned trajectory, not the final H3 result.<hr /><h2 id="main-connections">Main connections</h2>H3 Edit<ul><li><code>compiled_prompt</code> -&gt; H3 Edit Text Encode</li><li><code>options</code> -&gt; H3 Edit Text Encode</li><li><code>reference_first</code> -&gt; H3 Edit source image</li><li><code>length</code> -&gt; generation length</li><li><code>fps</code> -&gt; video output FPS</li></ul>Use <code>compiled_prompt</code> and <code>options</code> together.Native H3 / Ref2VA<ul><li>Use <code>minimax_prompt</code> instead of <code>compiled_prompt</code>.</li></ul><hr /><h2 id="subject-box">Subject Box</h2><code>subject_box</code> tells the model who the camera should orbit around.If empty, the image center is used as the reference target.If filled, it identifies the subject position in the first frame.Example:<pre><code>[L=0.62, T=0.18, W=0.24, H=0.55]</code></pre><ul><li><code>L</code> - left position</li><li><code>T</code> - top position</li><li><code>W</code> - width</li><li><code>H</code> - height</li></ul>Values range from <code>0</code> to <code>1</code>.<h3 id="easy-setup">Easy setup</h3>Add:<code>bruxosdovfx • H3 Subject Box</code>Connect your image to <code>reference_image</code>, draw the box over the subject, and connect its <code>subject_box</code> output to Camera H3.This is especially useful when the subject is off-center.It does not crop, zoom, move the camera, or track the subject. It only identifies the orbit target in the first frame.<hr /><h2 id="freeze-frame">Freeze Frame</h2>Use a still image or reference frame.<ul><li>Connect <code>reference_image</code>.</li><li><code>freeze_index</code> selects the frame from the batch.</li><li>Connect <code>reference_first</code> to the H3 Edit source image.</li><li>Connect <code>compiled_prompt</code> and <code>options</code> to the H3 Edit encoder.</li></ul>With native H3, use <code>minimax_prompt</code> plus the first frame in an FL2VA workflow.<hr /><h2 id="motion-frame">Motion Frame</h2>Use a video or frame sequence as motion reference.<ul><li>Reference length: 2-15 seconds.</li><li>Set the real FPS in <code>source_fps</code>.</li><li>Use <code>scene coverage | camera path</code>.</li><li>Use an H3 Ref2VA model.</li><li>Use <code>bruxosdovfx • H3 Motion Reference</code>.</li></ul>Connections:<ul><li><code>reference_frames</code> -&gt; <code>reference_frames</code></li><li><code>minimax_prompt</code> -&gt; <code>prompt</code></li><li><code>length</code> -&gt; <code>length</code></li><li>Qwen H3 encoder -&gt; <code>clip</code></li><li>H3 video VAE -&gt; <code>vae</code></li></ul>The reference is converted to 24 fps and trimmed to the format expected by H3.Original audio is not forwarded.<hr /><h2 id="interpolation">Interpolation</h2>SmoothSmoothed camera motion. With <code>extended contracts</code>, movement stays more continuous between waypoints.LinearStraight interpolation between keyframes.<hr /><h2 id="timing">Timing</h2>Video timing uses the timestamp of the last visible frame:<pre><code>(length - 1) / fps</code></pre>Redistribute Timing adjusts keyframe timing for more even average camera speed.<hr /><h2 id="loop-closure">Loop Closure</h2><code>loop_closure = auto</code> can anchor the last frame to the first when the path is compatible.Usually ON when:<ul><li>Freeze Frame is active.</li><li><code>scene coverage | camera path</code> is used.</li><li>Orbit is exactly <code>+360°</code> or <code>-360°</code>.</li><li>Final elevation matches the start.</li><li>Final distance matches the start.</li><li>A reference image is connected.</li></ul>OFF when:<ul><li>Orbit is <code>359°</code>.</li><li>Orbit is <code>720°</code>.</li><li>Motion Frame is used.</li><li>A still-image angle task is used.</li><li>Final elevation or distance is different.</li><li><code>loop_closure = off</code>.</li></ul>Close Orbit adjusts the final pose so the path closes correctly.<hr /><h2 id="main-controls">Main controls</h2><ul><li><code>ui_language</code> - interface language.</li><li><code>camera_trajectory</code> - time, azimuth, elevation, and distance keyframes.</li><li><code>instruction</code> - extra prompt instruction.</li><li><code>subject_box</code> - identifies the subject and orbit target in the first frame.</li><li><code>orbit_direction</code> - corrects the direction sent to H3.</li><li><code>elevation_range</code> - vertical control range.</li><li><code>subject_framing</code> - records close-up, medium, or wide framing.</li><li><code>minimax_format</code> - controls <code>minimax_prompt</code> formatting.</li><li><code>prompt_detail</code> - baseline or extended contracts.</li><li><code>runtime_task</code> - video camera path or new still-image angle.</li></ul><code>subject_framing</code> does not apply zoom or cropping.<hr /><h2 id="outputs">Outputs</h2><ul><li><code>compiled_prompt</code> - prompt for H3 Edit.</li><li><code>options</code> - H3 Edit options.</li><li><code>minimax_prompt</code> - alternative prompt for native H3.</li><li><code>storyboard_json</code> - camera-path data.</li><li><code>info</code> - diagnostics.</li><li><code>length</code> - frame count.</li><li><code>fps</code> - output FPS.</li><li><code>h3world_actions</code> - approximate pan / tilt action text.</li></ul><hr /><h2 id="limitations">Limitations</h2><ul><li>H3 can still miss angle, scale, or timing.</li><li>The preview does not simulate the generated result.</li><li>Empty <code>subject_box</code> uses the image center as reference target.</li><li>Motion Frame depends on Ref2VA preserving the source action.</li><li><code>h3world_actions</code> describes approximate pan / tilt behavior, not a true geometric orbit.</li></ul><hr /><h2 id="credits">Credits</h2>Node by Bruxos do VFX.Based on the H3 Edit integration from:<a target="_blank" rel="ugc" href="https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit">https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit</a>Repository:<a target="_blank" rel="ugc" href="https://github.com/NyckM/3d-Camera-control-H3-Minimax">https://github.com/NyckM/3d-Camera-control-H3-Minimax</a>

Minimax h3 Camera Control

bruxosdovfx - Camera H3 v19.1Visual camera editor for MiniMax H3 inside ComfyUI.Drag the camera, create keyframes, and generate camera-path prompts for H3.The node compiles prompts. It is not a geometric camera adapter, so H3 can still miss angle, timing, or scale.Installation<pre><code>cd ComfyUI/custom_nodes
git clone https://github.com/NyckM/3d-Camera-control-H3-Minimax.git</code></pre>Restart ComfyUI and search for:<code>bruxosdovfx • Camera H3</code>What's new in v19.1<ul><li>Smooth - smoother motion between keyframes.</li><li>Linear - linear motion per segment.</li><li>Redistribute Timing - balances average speed between keyframes.</li><li>Unwrap - converts crossings such as <code>350° -&gt; 10°</code> to the short arc.</li><li>Start / End Hold - adds a 0.5 second hold.</li><li>Presets - orbit, rise, fall, move closer, move away, and static camera.</li><li>Diagnostics - detects holds, static paths, and zero crossings.</li><li>Loop Closure - <code>auto</code> closes compatible orbits; <code>off</code> disables it.</li><li>UI Language - Portuguese / English interface and diagnostics.</li></ul>Basic use<ul><li>Drag the purple camera to orbit.</li><li>Mouse wheel changes distance.</li><li>Drag the background to rotate the preview only.</li><li>Use keyframes to build the path.</li><li>Pure Orbit resets elevation while keeping the orbit.</li><li>Play previews the planned camera path.</li></ul>The preview shows the planned trajectory, not the final H3 result.Main connectionsH3 Edit<ul><li><code>compiled_prompt</code> -&gt; H3 Edit Text Encode</li><li><code>options</code> -&gt; H3 Edit Text Encode</li><li><code>reference_first</code> -&gt; H3 Edit source image</li><li><code>length</code> -&gt; generation length</li><li><code>fps</code> -&gt; video output FPS</li></ul>Use <code>compiled_prompt</code> and <code>options</code> together.Native H3 / Ref2VA<ul><li>Use <code>minimax_prompt</code> instead of <code>compiled_prompt</code>.</li></ul>Subject Box<code>subject_box</code> tells the model who the camera should orbit around.If empty, the image center is used as the reference target.If filled, it identifies the subject position in the first frame.Example:<pre><code>[L=0.62, T=0.18, W=0.24, H=0.55]</code></pre><ul><li><code>L</code> - left position</li><li><code>T</code> - top position</li><li><code>W</code> - width</li><li><code>H</code> - height</li></ul>Values range from <code>0</code> to <code>1</code>.Easy setupAdd:<code>bruxosdovfx • H3 Subject Box</code>Connect your image to <code>reference_image</code>, draw the box over the subject, and connect its <code>subject_box</code> output to Camera H3.This is especially useful when the subject is off-center.It does not crop, zoom, move the camera, or track the subject. It only identifies the orbit target in the first frame.Freeze FrameUse a still image or reference frame.<ul><li>Connect <code>reference_image</code>.</li><li><code>freeze_index</code> selects the frame from the batch.</li><li>Connect <code>reference_first</code> to the H3 Edit source image.</li><li>Connect <code>compiled_prompt</code> and <code>options</code> to the H3 Edit encoder.</li></ul>With native H3, use <code>minimax_prompt</code> plus the first frame in an FL2VA workflow.Motion FrameUse a video or frame sequence as motion reference.<ul><li>Reference length: 2-15 seconds.</li><li>Set the real FPS in <code>source_fps</code>.</li><li>Use <code>scene coverage | camera path</code>.</li><li>Use an H3 Ref2VA model.</li><li>Use <code>bruxosdovfx • H3 Motion Reference</code>.</li></ul>Connections:<ul><li><code>reference_frames</code> -&gt; <code>reference_frames</code></li><li><code>minimax_prompt</code> -&gt; <code>prompt</code></li><li><code>length</code> -&gt; <code>length</code></li><li>Qwen H3 encoder -&gt; <code>clip</code></li><li>H3 video VAE -&gt; <code>vae</code></li></ul>The reference is converted to 24 fps and trimmed to the format expected by H3.Original audio is not forwarded.InterpolationSmoothSmoothed camera motion. With <code>extended contracts</code>, movement stays more continuous between waypoints.LinearStraight interpolation between keyframes.TimingVideo timing uses the timestamp of the last visible frame:<pre><code>(length - 1) / fps</code></pre>Redistribute Timing adjusts keyframe timing for more even average camera speed.Loop Closure<code>loop_closure = auto</code> can anchor the last frame to the first when the path is compatible.Usually ON when:<ul><li>Freeze Frame is active.</li><li><code>scene coverage | camera path</code> is used.</li><li>Orbit is exactly <code>+360°</code> or <code>-360°</code>.</li><li>Final elevation matches the start.</li><li>Final distance matches the start.</li><li>A reference image is connected.</li></ul>OFF when:<ul><li>Orbit is <code>359°</code>.</li><li>Orbit is <code>720°</code>.</li><li>Motion Frame is used.</li><li>A still-image angle task is used.</li><li>Final elevation or distance is different.</li><li><code>loop_closure = off</code>.</li></ul>Close Orbit adjusts the final pose so the path closes correctly.Main controls<ul><li><code>ui_language</code> - interface language.</li><li><code>camera_trajectory</code> - time, azimuth, elevation, and distance keyframes.</li><li><code>instruction</code> - extra prompt instruction.</li><li><code>subject_box</code> - identifies the subject and orbit target in the first frame.</li><li><code>orbit_direction</code> - corrects the direction sent to H3.</li><li><code>elevation_range</code> - vertical control range.</li><li><code>subject_framing</code> - records close-up, medium, or wide framing.</li><li><code>minimax_format</code> - controls <code>minimax_prompt</code> formatting.</li><li><code>prompt_detail</code> - baseline or extended contracts.</li><li><code>runtime_task</code> - video camera path or new still-image angle.</li></ul><code>subject_framing</code> does not apply zoom or cropping.Outputs<ul><li><code>compiled_prompt</code> - prompt for H3 Edit.</li><li><code>options</code> - H3 Edit options.</li><li><code>minimax_prompt</code> - alternative prompt for native H3.</li><li><code>storyboard_json</code> - camera-path data.</li><li><code>info</code> - diagnostics.</li><li><code>length</code> - frame count.</li><li><code>fps</code> - output FPS.</li><li><code>h3world_actions</code> - approximate pan / tilt action text.</li></ul>Limitations<ul><li>H3 can still miss angle, scale, or timing.</li><li>The preview does not simulate the generated result.</li><li>Empty <code>subject_box</code> uses the image center as reference target.</li><li>Motion Frame depends on Ref2VA preserving the source action.</li><li><code>h3world_actions</code> describes approximate pan / tilt behavior, not a true geometric orbit.</li></ul>CreditsNode by Bruxos do VFX.Based on the H3 Edit integration from:<a target="_blank" rel="ugc" href="https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit">https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit</a>Repository:<a target="_blank" rel="ugc" href="https://github.com/NyckM/3d-Camera-control-H3-Minimax">https://github.com/NyckM/3d-Camera-control-H3-Minimax</a>

Files with SHA256: 4be75332db790b04e4f1180b257358f35cbd9acbefaaf11a794a01f760bd7bc4