StageDesigner

Viewport performance

How to speed up the 3D viewport: quality modes, automatic optimization, the number of lights, haze and video source resolution.

4 min read
Documentation contents ▾

Smoothness depends on the graphics card, the window size, the number of lights with shadows and the video sources on screens. The app lowers quality by itself when the frame rate drops, but a few settings give you much more.

Image quality modes

ViewImage qualityDraft / Standard / Photo
ModeUse forGPU load
DraftDesigning on a less powerful computer. No real lights, shadows, beams or bloom.low
StandardDefault mode: a balance of quality and smoothness.medium
PhotoPhotorealistic preview: panorama lighting, ambient occlusion, soft shadows, anti-aliasing.high

The Present button in the top bar and the frame render to PNG always use Photo mode. On a laptop with integrated graphics, design in Draft or Standard mode and turn on Photo for the presentation. More in Quality modes.

Lamps off while you work

The fastest way to a smooth viewport is the light bulb button in the top bar, next to the quality modes (⌥⌘L / Ctrl+Alt+L, also View → Turn lamps off while working). It turns off all fixtures and moving heads (real lights, beams, halos and spots on the floor) and glowing surfaces: solids with emission turned on, candle flames and decorative lamp shades. LED screens keep showing content. Ambient light stays, so you still see the whole scene. The settings in the project do not change, and Present always shows the lamps on. You turn the lamps back on with the same button.

Automatic optimization

The Auto optimization switch in Project settings → Render → Performance lowers quality when the frame rate drops below the target. In Photo mode the app steps down gradually: first render resolution, then ambient occlusion, soft shadows and shadow map size, and finally anti-aliasing. It returns to higher quality only after a few seconds of stable operation and remembers what the computer can handle, so the image does not keep switching back and forth.

You set the target in Target FPS (30, 60 or 120). On less powerful hardware choose 30: the app then keeps more effects.

In Photo mode with a large window, e.g. on an ultrawide monitor, the app also limits the total number of render pixels. While the camera moves the image is slightly softened, and it sharpens when you stop.

Lights and shadows

Project settings (⌘ ,)RenderPerformance
Max real lights
How many fixtures light the scene at the same time: Auto, 8, 16, 24 or 32. The other fixtures are visible but do not calculate lighting. Every real light adds load to all materials in the scene.
Max shadow-casting lights
Auto, 0, 2, 4 or 8. Shadows are the most expensive element; 0 to 2 speeds up the viewport noticeably.
Beam quality
Quality of light beams in the air.
Shadow quality
Shadow map resolution.

Stage haze with volumetric beams on the Studio plan puts a heavy load on the graphics card. While designing, lower its density or turn it off. Ready-made arrangements start with lamps off so the viewport is smooth from the first moment.

Video sources on screens

  • Every live source (NDI, Syphon, window, camera) means decoding frames and uploading them to the graphics card.
  • Turn on Render statistics in Project settings → Render → Image quality. The overlay shows FPS, the number of active sources, input frames and decoding time.
  • In the overlay change source scaling to max 1920 px or max 1280 px. The frame is scaled down before it reaches the viewport, which takes load off the processor and graphics card. The default limit is 2560 px.
  • Screens that use the same source share one texture, so you do not need to duplicate them.

Other settings that help

  • People simulation: lower Density in Project settings → View → People simulation or turn it off while you work.
  • Make the app window smaller or move it to a lower-resolution monitor during heavy operations.
  • On a laptop, plug in the power adapter and choose the high performance mode in the system.
  • On Windows with two graphics cards, assign StageDesigner to the dedicated card in the system graphics settings.

Hardware requirements

MinimumRecommended
Processor4 cores8 cores
Memory8 GB RAM16 GB RAM
GraphicsGPU with OpenGL 4.1 / Metaldedicated graphics card
Disk2 GB for the app + space for projects
Did not find the answer?
Describe the problem and we will reply with a solution or add an article.