3D Scene Editor

Framo's 3D editor lets you import models, add primitives, light and texture a scene, frame a camera, and capture the result as a screenshot or ray-traced render.

Add Object menu

Most scene content is added from one menu.

To open it: press Shift+A, or right-click in an empty part of the viewport. The menu groups everything under: Objects, Stage, Lights, Effects, and Add Viewpoint.

Import & place 3D models

To import a model:

1. Open the Add Object menu (Shift+A) → Objects → Add Model....
2. In the Add Model dialog choose a tab: My Models (your uploaded models), 3D Assets (shared library), Upload (drop in a .glb file from your computer), or Blender Bridge (live connection to Blender).
3. Select or upload, then confirm. The model is placed in the scene and selected.

Models must be .glb. Delete a selected model with Delete / Backspace.

Create primitives

To add a primitive: Add Object menu → Objects, then pick Cube, Sphere, Cylinder, Plane, Torus, or Cone. The new primitive is selected automatically.

To duplicate a selected primitive: press Shift+D.

You can also add an image as a flat plane: Add Object menu → Objects → Image as Plane, then pick an image. (See the image library for sourcing images.)

Selecting objects

A selection mode controls what a click picks. Switch modes from the selection dropdown in the top toolbar, or by keyboard:

• V — select the whole (root) object.
• VV (double-tap V) — select a part.
• VG (V then G) — select a group.
• M — select by material (picks the clicked mesh's material).

Visibility shortcuts (Blender-style):

• H — hide selected objects
• Shift+H — hide everything except the selection
• Alt+H — show all objects

Transform objects (move / rotate / scale)

Select an object, then use the top toolbar buttons (Move, Rotate, Scale) or keyboard:

• T — Move / translate tool (press again to clear an axis lock)
• R — Rotate tool
• S — Scale tool
• G — grab/move (Blender-style)

While transforming, lock to an axis with X, Y, or Z (only works when an object is selected and a transform tool is active). Press Escape to cancel an axis-locked transform.

Rotate and Scale are not available for lights.

Materials

Materials are managed in the Scene tab's materials sub-panel (left sidebar). Each material is Standard or Physical — switch with the material-type selector. Physical adds properties like clearcoat, transmission, sheen, iridescence, anisotropy, and IOR on top of the standard color/roughness/metalness set, plus their texture maps.

To apply a saved material from the Material Library: double-click a library material to apply it to the current selection.

To delete a material: select it and press Delete. If it's assigned to meshes you'll be asked to confirm.

Lighting rig

Add lights from the Add Object menu → Lights: Spot Light, Rectangle Light, Directional Light, Point Light, Ambient Light, Hemisphere Light.

Light Presets (also under Lights) replace your current lights with a full rig:

• Three-Point Classic — Key + Fill + Rim
• Rembrandt — dramatic cinematic
• Studio Product — soft even lighting

Lights can be linked to specific meshes (light linking) from the light's controls. Delete a selected light with Delete.

Stage: environment, shadows, floor, fog, backdrop

Add these from the Add Object menu → Stage (each can exist once):

• HDRI — image-based environment lighting (see below).
• Backdrop — a background image behind the scene.
• Fog — distance fog.
• Simple Shadows — fast contact shadows under objects.
• Complex Shadows — accumulated/soft ground shadows (higher quality).
• Reflective Floor — a mirror-like reflector floor.
• World — world/background settings.

HDRI & environment

After adding HDRI from the Stage menu, open its controls to choose the environment. You can:

• Select an HDRI from the picker (Select HDRI Environment dialog) — search, filter by My HDRIs / favorites, and select.
• Upload HDRI — bring in your own .hdr.
• Generate an HDRI with AI from the HDRI generator.

The HDRI both lights the scene and can serve as the visible background. (The environment image can also be reused as a backdrop/world.)

Worlds (3D world generation)

Generate explorable 3D worlds with World Labs (powered by Marble). Worlds are stored as GLB splats with their generation prompt and metadata.

To add a world to your scene: Add Object menu → Stage → World. A World controller panel opens in the left sidebar.

Library vs Generate tabs

The World controller has two tabs:

• Library — Browse your saved worlds (your generated worlds plus admin system assets). Click the thumbnail to open the picker, or clear the current world with Clear World. Generated worlds display their caption and original prompt. If available, a View in Marble link opens the world in the Marble viewer.
• Generate — Create a new world with AI using one of five input modes.

Input modes

Choose how the AI generates your world:

• Text — Describe the environment. Example: "a sunlit Japanese garden with stone lanterns, koi pond, and cherry blossoms at golden hour."
• Single Image — Upload a reference photo to expand into a full 360-degree panorama. The AI infers surrounding environment based on content, perspective, and lighting.
• Pano — Provide an existing equirectangular (360-degree) panoramic image. The AI enhances and refines it into a seamless world environment.
• Multi Image — Add up to 8 reference images from different angles (first 4 slots pre-labeled Front/Right/Back/Left). The AI reconstructs a 3D scene from them, filling gaps automatically.
• Video — Paste a video URL. The AI extracts and generates a world from video frames.

Quality modes

• Draft — Fast generation with lower credits cost, ideal for quick previews and iteration.
• High Quality — Higher-resolution panoramas with better detail and consistency (requires Pro plan).

How worlds appear in the scene

Once generated and applied, a World object:

• Loads as a GLB splat file stored in your project
• Can be positioned, rotated, and scaled like any object
• Can serve as an environment map (enabling Use as Environment switch) to light the scene and appear as the background
• Has optional Depth of Field controls (focal distance, aperture size)
• Generates with a Capture Point offset for precise environment lighting placement

Generated worlds are also automatically saved to your HDRI library for reuse as environment lighting on other scenes.

Camera control & navigation

Drag to orbit, and use scroll to dolly/zoom; panning and orbit limits, auto-rotate, and damping are configurable in the camera controls. Useful shortcuts:

• F — focus the camera on the selected object
• Ctrl+R — reset the camera to its default view

Adjust field of view from the FOV control in the right-side toolbar.

Viewpoints (camera keyframes)

Save and recall camera positions from the Viewpoints list in the left sidebar.

To save the current view: Add Object menu → Add Viewpoint (or the + in the Viewpoints list, "Add Current View"). You can also auto-generate a ring of viewpoints around the subject — 360° or 180° with 10/20/30 views — for turntable-style coverage. Each viewpoint stores position, target, FOV, duration, and a transition (linear / easeInOut / easeIn / easeOut), and viewpoints can be batch-rendered via the Auto Render dialog.

View modes

The right-side toolbar's view mode button switches the viewport shading: Lit, Wireframe, Normals, UV Checker, Clay. (Disabled while ray tracing.)

Realtime vs Ray Tracing render

The top toolbar has a render-mode toggle: Realtime (interactive) and Ray Tracing (path-traced, physically accurate lighting and reflections). Switch to Ray Tracing to accumulate a high-quality image; transform tools and view modes are disabled while it renders, and progress is shown by the render indicator.

Post-processing effects

Add effects from the Add Object menu → Effects: Bloom, Ambient Occlusion, Screen Space Reflections, Vignette, Chromatic Aberration, Hue Saturation, Brightness Contrast, Tonemapping, Noise, Pixelation, Dot Screen, Glitch, Sepia, Autofocus.

Effect Presets stack several at once:

• Performance — Vignette only
• Balanced — Bloom + Vignette
• High Quality — Bloom + Ambient Occlusion + Vignette
• Cinematic — Bloom + Vignette + Chromatic Aberration + Tonemapping

Each effect can be selected and tuned in the left sidebar, and removed with Delete.

Screenshot & render output

Open the Screenshot settings from the right-side toolbar (aperture icon). There you can:

1. Toggle Preview Area to show a dashed overlay of exactly what will be captured.
2. Pick an aspect ratio (1:1 / 16:9 / 9:16) and a resolution preset (HD up to 8K, plus social-media sizes), or set custom W/H and a Quality multiplier (1–3×).
3. Choose Download (save to your computer) and/or Save to Cloud (into your project's image library).
4. Click Screenshot to capture the current viewport.

Captures include the background image/backdrop and the 3D canvas. Press Escape to close the capture preview. (Saved screenshots land in your image library for reuse, e.g. as references for AI generation.)

To turn the live scene into a polished AI render instead of a raw capture, use the Enhance category in the chat bar — see Chat bar: generating images.

Other shortcuts

• Tab — toggle both sidebars
• 1 — Scene tab, 2 — AI tab
• Ctrl+Z — Undo, Ctrl+Y — Redo
• Ctrl+S — Save project
• Escape — clear selection / cancel