StageDesigner

Image quality and lighting performance

The Draft, Standard and Photo modes, the budget of real lights, shadows and beams, auto-optimize, target FPS, ambient light and the statistics overlay. How to keep the viewport smooth with dozens of fixtures.

3 min read
Documentation contents ▾

Three quality modes

You switch the mode on the top bar (the image quality switch), in the View → Image quality menu or in Project Settings (⌘ ,), Render tab, Mode field.

ModeDescription in the appReal lightsShadowsBeams
DraftHighest smoothness, low GPU load00none
StandardOptimal balance, medium GPU loadup to 12up to 4up to 6
PhotoPhotorealistic preview, high GPU loadup to 48up to 8up to 14

Photo adds ambient occlusion, soft shadows, edge smoothing, environment lighting and subtle grading. The Presentation button and rendering a frame to PNG always use Photo mode.

Fixtures outside the budget do not disappear: their lens and halo still glow, they just do not light the scene. The budget goes to the brightest fixtures and those closest to the camera. Each fixture also has a level of detail that depends on its distance from the camera, and while the camera moves, quality drops for a moment and comes back when it stops.

Performance settings

Project Settings (⌘ ,), Render tab:

Target FPS
30, 60 or 120. The engine adjusts fixture quality to hold the target.
Render Statistics
Overlay with FPS, draw calls, light budget and video pipeline.
Auto-optimize
When FPS drops below the target, the engine lowers quality in this order: shadows, beams, number of lights. It restores it when there is headroom.
Max real lights
Auto, 8, 16, 24 or 32.
Max shadow-casting lights
Auto, 0, 2, 4 or 8.
Beam quality, Shadow quality
Auto, Low, Medium, High.

In Photo mode the app recognizes the graphics card class and starts at a matching effects level. When FPS drops, the effects step down: first the render resolution, then ambient occlusion, soft shadows and edge smoothing. Stepping back up is slow and requires stable FPS, so the image does not flicker between levels.

Statistics overlay

The Lamps section of the overlay shows how many fixtures are active, rendered, with shadows, volumetric, with real light and simplified. This is how you check whether a gobo is missing because there is no shadow budget, or whether a beam does not fit within the limit.

Ambient light

The Light tab, Ambient Lighting section, sets the base the fixtures work on:

Preset
Neutral Studio (natural base light), Dark Stage (dark event stage), Technical View (brighter working mode), Presentation (balance for the client preview).
Tone mapping, Exposure
ACES Filmic protects bright areas from clipping. Exposure from 0.3 to 2×.
Auto exposure
Gently adjusts the exposure to the number of fixtures within set limits.
Highlight protection, Ambient light, Ambient light color
Brightness and color of the base light.
Contrast, Saturation, Shadow softness, Background brightness
Character of the image.

In Photo mode the View Options menu on the top bar has a quick Ambient light slider (0–200%).

When the viewport slows down

  1. Switch quality to Standard or Draft while editing.
  2. Turn off Visible beam (haze) on wide fixtures.
  3. Turn on Auto-optimize and set Target FPS to 30 on a slower computer.
  4. Lower Max shadow-casting lights. Shadows are the most expensive element.
  5. Check the video sources: see Screen and video source performance.

More in the articles Performance problems and System diagnostics.

Did not find the answer?
Describe the problem and we will reply with a solution or add an article.