Skip to content

Preview and Output

Preview and output are independent consumers of rendered views. Window size, preview policy and external-output resolution solve different problems and should remain independently understandable.

flowchart LR
  R[ziviDomeLive<br/>RenderMode.FULL] --> P[Preview<br/>stored ViewType]
  R --> N[NDI<br/>stored ViewType]
  R --> L[Local texture<br/>stored ViewType]
  P --> W[Processing window]
  N --> NR[Network receiver]
  L --> LR[Syphon or Spout receiver]

  • Preview

    Interactive inspection in the current Processing window. Its resolution follows the preview policy, not the external output target.

  • Output

    Final representation delivered to an enabled destination at the configured output resolution/aspect.

Preview

  • Standard preview follows the current Processing window dimensions.
  • Spherical preview uses the library's automatic square preview policy rather than the output resolution.
  • Resizing the window therefore does not redefine external-output resolution.

Output resolution

The public resize entry point is resetGraphics(int). Documentation and examples must use that implemented API name.

Graphics changes are deferred

Output-target changes are applied at the render/draw boundary so graphics resources are recreated in the correct Processing/OpenGL context.

Changing output resolution must not silently redefine preview resolution. Domemaster Size% is calibration state and must remain persistent across output-target recreation.

Independent routing in FULL

Preview Output Why it is useful
Standard Domemaster NDI Work conventionally while feeding a dome pipeline
Standard Equirectangular Keep an operator view while publishing a 360° representation
Domemaster Another enabled ViewType Inspect calibration while another route remains active

A dedicated RenderMode temporarily overrides effective representation without deleting the stored ViewType selections.

Do not equate window size with output size

The Processing window is an interaction/preview surface. External output resolution is a separate contract.