Nodes/ComfyUI-ArchAi3d-Qwen/ArchAi3D_Qwen_Object_Rotation_Control
ComfyUI Node

ArchAi3D_Qwen_Object_Rotation_Control

Orbit the product, get a turntable — Object Rotation Control's multi-step trick

By amir84ferdos·Created 11 months ago·Updated 5 months ago· 70
ArchAi3D_Qwen_Object_Rotation_Control
    • prompt
    • multi_step_prompts
    • frame_count
    • rotation_description
    • system_prompt
    presetproduct_turntable_360
    scene_context
    targetthe product
    directionright
    angle90
    distanceclose
    revealall sides
    multi_step_modefalse
    steps8
    debug_modefalse

    A 360° product turntable is the single most requested camera shot in e-commerce, and it's the one thing a single image edit can't do - which is why ArchAi3D_Qwen_Object_Rotation_Control ships with multi-step mode built in. Its default preset is product_turntable_360, and it's the pack's answer to "orbit the camera around the product without melting it."

    The mechanism is the "orbit around" phrase, which the pack's Reddit-sourced research calls the single most reliable rotation instruction for Qwen-Edit - more dependable than "rotate 90 degrees," which the model reads about as precisely as you'd guess. You name the target, pick a direction, pick an angle, and the node writes the orbit prompt plus a system prompt that keeps the subject glued together while the camera travels.

    The input that makes it special

    multi_step_mode is the feature worth caring about. A single edit asking for 360° reliably produces a mush; asking for 8×45° steps, generating each one from the previous output, produces an actual turntable. Turn it on and set:

    • steps - 8 is standard, 12 for detail, up to 24 for smooth video sequences. More steps means more passes, so it's also a time budget.
    • angle - 1–360°, default 90. For full turntables, keep it on 360 with multi-step on.
    • distance - close for product detail, medium standard, wide for context.
    • reveal - a plain-text hint for what the rotation should show: "all sides", "details", "features", "back".

    Outputs include the single prompt, a multi_step_prompts string (the per-frame sequence when multi-step is on), a frame_count integer telling you how many passes to expect, plus the standard rotation_description and system_prompt.

    How it works

    The node assembles a "camera orbit around [target] to the [direction] by [angle]° revealing [reveal]" instruction using the verified orbit pattern, and when multi-step is enabled it generates an ordered list of step prompts - 1/N, 2/N, up to 360° - designed to be chained through the encoder. Direction is right (clockwise) or left (counter-clockwise), and the pack's docs stress that left/right means picture-left/right, not the subject's perspective.

    Installing it

    This is one node inside ComfyUI-ArchAi3d-Qwen by Amir Ferdos (ArchAi3d). Standard install:

    # ComfyUI Manager: search "ArchAi3d Qwen"
    cd ComfyUI/custom_nodes
    git clone https://github.com/amir84ferdos/ComfyUI-ArchAi3d-Qwen.git
    cd ComfyUI-ArchAi3d-Qwen
    pip install -r requirements.txt
    

    Restart. No models shipped - you load Qwen-Image-Edit yourself (GGUF-quantized is the realistic path; the 20B full-precision weights are brutal on VRAM).

    Common issues

    • The product mutates between steps. Because Qwen-Edit re-emits the whole frame, each step in a chain drifts - logos warp, handles move. Chain edits by feeding the previous output image in, and keep the system prompt connected.
    • Angles stay approximate. Direction is consistent, degrees are vibes. Don't expect a mathematically exact 45°.
    • Centered subjects win. Off-center products make the model invent rotation instead of orbiting. Center it first.
    • Multi-step is slow. 8+ full Qwen-Edit passes per turntable adds up fast on a consumer card - plan the render.

    For product turntables and building fly-arounds it's the node in this pack with an actual reason to exist over a hand-typed prompt: the step chaining is the part nobody wants to write manually.

    CategoryArchAi3d/Camera/Object

    Inputs (10)

    NameTypeDefaultDescription
    presetCOMBOproduct_turntable_360Select rotation preset. Product turntable is standard 360° rotation in 8 frames.
    scene_contextSTRINGOptional: Product description. Example: 'wooden chair on white background', 'coffee mug'. Improves consistency.
    targetSTRINGthe productTarget object to orbit around. Example: 'the product', 'the chair', 'the building'
    directionCOMBOrightOrbit direction: right=clockwise (standard), left=counter-clockwise
    angleINT901–360Rotation angle in degrees (1-360°). For 360° turntables, use multi-step mode.
    distanceCOMBOcloseOrbit distance: close=product detail, medium=standard, wide=context/environment
    revealSTRINGall sidesWhat to reveal: 'all sides', 'details', 'features', 'back', etc.
    multi_step_modeBOOLEANfalseEnable multi-step rotation for smooth video sequences (e.g., 360° as 8x45° steps)
    stepsINT82–24Number of frames for multi-step rotation. 8=standard, 12=detailed, 24=ultra-smooth
    debug_modeBOOLEANfalsePrint detailed prompt information to console

    Outputs (5)

    NameTypeDescription
    promptSTRINGGenerated rotation prompt for Qwen Edit 2509
    multi_step_promptsSTRINGMulti-frame prompts for video sequence (if multi_step_mode=True)
    frame_countINTNumber of frames (1 for single, or steps for multi-step)
    rotation_descriptionSTRINGDescription of the selected rotation preset
    system_promptSTRING⭐ v5.0: Research-validated system prompt for object rotation! Connect to encoder's system_prompt input.