---
title: "Stage"
description: "API documentation for Stage"
url: https://developer.disguise.one/python-api/docs/stage/
---

# Stage

See also: [Stage Guide](/plugins/guides/stage)

Base class (inherits properties and methods): _[Object](/python-api/docs/object#object)_

## Properties

#### **Adaptive\_Tone\_map** : _int_

#### **Area\_lighting** : _int_

#### **Chicago\_renderer** : _int_

#### **Export\_Frame\_Of\_Reference** : _[AnimationAxisSettings](/python-api/docs/animationaxissettings#animationaxissettings)_

_Category: Animation  
UserName: Export frame of reference_

#### **Floor\_normal\_map** : _[DxTexture](/python-api/docs/dxtexture#dxtexture)_

Normal map for the floor

_UserName: Floor normal map_

#### **Glow** : _int_

#### **Local\_Frame\_Of\_Reference** : _[AnimationAxisSettings](/python-api/docs/animationaxissettings#animationaxissettings)_

_Category: Animation  
UserName: Local frame of reference_

#### **Reflections** : _int_

#### **ambientColour** : _[Colour](/python-api/docs/colour#colour)_

The colour of the ambient light.  
It is recommended to select a ‘full brightness’ version of colours chosen, by changing Luminance in the colour picker to 1.

_Category: Scene  
UserName: Ambient colour_

#### **ambientLight** : _float_

Brightness in lux that uniformly illuminates the scene. Sunlight at midday can be 111000 lux, while moonlight could be 0.25 lux

_Category: Scene  
UserName: Ambient brightness_

#### **areaLightingBrightness** : _float_

_UserName: Area lighting Brightness_

#### **autoSoftEdge** : _int_

Toggle dynamic blend on outputs

_Options: {0: ‘Off’, 1: ‘On’}  
Category: Projectors  
UserName: Dynamic blend_

#### **blurPasses** : _int_

_UserName: Blur Passes_

#### **blurSigma** : _float_

_UserName: Blur Sigma_

#### **cameras** : _List\[[Camera](/python-api/docs/camera#camera)\]_

List of cameras viewing the stage

_Category: Cameras  
UserName: Cameras_

#### **debugObject** : _[DbgObject](/python-api/docs/dbgobject#dbgobject)_

#### **depthFogDistance** : _float_

Depth fog distance

_UserName: Depth-fog distance_

#### **displays** : _List\[[Display](/python-api/docs/display#display)\]_ _(Read-Only)_

Get item by index or slice

#### **dmxLights** : _List\[[FixtureGroup](/python-api/docs/fixturegroup#fixturegroup)\]_

List of lighting fixture grids driven via DMX

_Category: DMX Lights  
UserName: DMX Lights_

#### **dmxScreens** : _List\[[DmxScreen](/python-api/docs/dmxscreen#dmxscreen)\]_

List of emissive LED screens driven via DMX

_Category: DMX Screens  
UserName: DMX Screens_

#### **exportOptions** : _List\[ExportOptionsResource\]_

#### **extraSerialisedObjects** : _List\[[Object](/python-api/docs/object#object)\]_

#### **floorAlpha** : _float_

Floor alpha

_UserName: Floor alpha_

#### **floorLuminosity** : _float_

Floor luminosity

_UserName: Floor luminosity_

#### **floorNormalMapScalar** : _[Vec2](/python-api/docs/vec2#vec2)_

Floor normal map UV scalar

_UserName: Floor normal Map Scale_

#### **floor\_plan** : _[DxTexture](/python-api/docs/dxtexture#dxtexture)_

Bitmap to display on the floor. Useful when working to a plan view diagram

_Category: Scene  
UserName: Floor plan_

#### **floor\_pos** : _[Vec](/python-api/docs/vec#vec)_

Floor position, in meters

_Category: Scene  
UserName: Floor position_

#### **floor\_size** : _[Vec2](/python-api/docs/vec2#vec2)_

Floor size, in meters

_Category: Scene  
UserName: Floor size_

#### **footprintsQuality** : _float_

Resolution multiplier for projector shadow buffers. 0 disables footprints

_Category: Scene  
UserName: Footprints Quality_

#### **glowThreshold** : _float_

_UserName: Glow threshold_

#### **greenScreens** : _List\[[GreenScreen](/python-api/docs/greenscreen#greenscreen)\]_

Surfaces used for background removal

_Category: MR Sets  
UserName: Green screens_

#### **heatMapMaxLux** : _float_

#### **heatMapMinLux** : _float_

#### **ledScreens** : _List\[[LedScreen](/python-api/docs/ledscreen#ledscreen)\]_

List of emissive LED screens

_Category: LED Screens  
UserName: LED Screens_

#### **lightBleedReduction** : _float_

_UserName: Light Bleed Reduction_

#### **lights** : _List\[[Light](/python-api/docs/light#light)\]_

Lights which affect Lux rendering

_Category: Scene  
UserName: Scene lights_

#### **measurementsObject** : _[MeasurementSet](/python-api/docs/measurementset#measurementset)_

#### **minVariance** : _float_

_UserName: Min Variance_

#### **mixedRealitySets** : _List\[[MixedRealitySet](/python-api/docs/mixedrealityset#mixedrealityset)\]_

List of mixed reality sets present

_Category: MR Sets  
UserName: MR Sets_

#### **people** : _int_

Number of people to display

_Category: Scene  
UserName: People_

#### **projectors** : _List\[[Projector](/python-api/docs/projector#projector)\]_

List of active projectors

_Category: Projectors  
UserName: Projectors_

#### **projfrustummultiplier** : _float_

Set this to multiply the far distance of the projector

_UserName: Projection Frustum Multiplier_

#### **pucks** : _List\[[Puck](/python-api/docs/puck#puck)\]_

#### **scatterDensity** : _float_

_UserName: Scattering Density_

#### **sceneAmbientColour** : _[Col](/python-api/docs/col#col)_

_UserName: Scene ambient colour_

#### **scrollScalar** : _float_

_UserName: Normal map scroll scale_

#### **shadowBias** : _float_

_UserName: Shadow Bias_

#### **skeletons** : _List\[[Skeleton](/python-api/docs/skeleton#skeleton)\]_

_Category: Skeletons  
UserName: Skeletons_

#### **softEdgeProfile** : _[AutoSoftEdgeProfile](/python-api/docs/autosoftedgeprofile#autosoftedgeprofile)_

Configuration for dynamic blend profile

_Category: Projectors  
UserName: Blend Profile_

#### **stageReferencePoints** : _[ReferencePointSet](/python-api/docs/referencepointset#referencepointset)_

#### **surfaces** : _List\[[Screen2](/python-api/docs/screen2#screen2)\]_

List of passive screen surfaces hit by projectors

_Category: Projection Surfaces  
UserName: Projection Surfaces_

#### **twoPoint5DPlates** : _List\[[TwoPoint5DPlate](/python-api/docs/twopoint5dplate#twopoint5dplate)\]_

#### **venue** : _[Venue](/python-api/docs/venue#venue)_

List of props and buildings to display

_Category: Scene  
UserName: Venue_

## Methods

#### **addReferencePoint**(self, pt: _[ReferencePoint](/python-api/docs/referencepoint#referencepoint)_)

#### **display**(self, i: _int_) -> _[Display](/python-api/docs/display#display)_

#### **exportStage**(self, path: _[Path](/python-api/docs/path#path) | str_)

#### **importObjectsFromTable**(self, table: _[Table](/python-api/docs/table#table)_)

#### **luxTicks**(self) -> _List\[float\]_

#### **nDisplays**(self) -> _int_

#### **removeReferencePoint**(self, pt: _[ReferencePoint](/python-api/docs/referencepoint#referencepoint)_)

#### **removeReferencePoints**(self, pts: _List\[[ReferencePoint](/python-api/docs/referencepoint#referencepoint)\]_) -> _List\[[ReferencePoint](/python-api/docs/referencepoint#referencepoint)\]_

#### **simulatingStackedOutputs**(self) -> _bool_

#### **simulatingWarps**(self) -> _bool_