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

# VirtualCamera

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

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

## Properties

#### **coordSystemDisplay** : _int_

The coordinate system of the position and rotation values displayed in the editor.  
Relative: Relative to the parent camera.  
Global: World-space global coordinates.

_Options: {0: ‘Relative’, 1: ‘Global’}  
Category: Settings  
UserName: Coordinate system_

#### **lensSource** : _int_

The source of the lens intrinsics values for the virtual camera.

_Options: {0: ‘Local intrinsics’, 1: ‘Zoom from parent’, 2: ‘Intrinsics from parent’}  
Category: Lens  
UserName: Lens source_

#### **maxZoomInFactor** : _float_

Maximum factor the camera can zoom in by before using purely virtual content, to avoid excessive pixellation

_Category: Settings  
UserName: Max zoom in factor_

#### **objectPositionReference** : _[Object](/python-api/docs/object#object)_

Object used as a reference for the average position of real objects on the stage.  
Used to calculate virtual camera viewpoints.

_Category: Settings  
UserName: Live action position marker_

#### **outputType** : _int_

Whether the virtual camera outputs as a regular or spherical camera.

_Options: {0: ‘Regular’, 1: ‘Spherical’}  
Category: Output  
UserName: Output type_

#### **parentCamera** : _[Camera](/python-api/docs/camera#camera)_

Camera used as source for reprojection.

_Category: Settings  
UserName: Parent camera_

#### **posRelativeOrGlobal** : _[Vec](/python-api/docs/vec#vec)_

Position of the virtual camera in either global or relative coordinates.

#### **relativePosition** : _[Vec](/python-api/docs/vec#vec)_

The position of the virtual camera relative to the parent camera.

#### **relativeRotation** : _[Vec](/python-api/docs/vec#vec)_

The rotation of the camera relative to the parent camera.

#### **rotRelativeOrGlobal** : _[Vec](/python-api/docs/vec#vec)_

The rotation of the virtual camera as either relative or global Euler angles, in degrees.

#### **sphericalImpl** : _SphericalCameraImpl_

The spherical implementation of the virtual camera.

#### **zoomScale** : _float_

Zoom scaling to be applied to the parent camera.

_Category: Lens  
UserName: Zoom scale_

## Variables

#### **INTRINSICS\_FROM\_PARENT** : _Final\[[VirtualCameraLensSource](/python-api/docs/virtualcameralenssource#virtualcameralenssource)\]_ = VirtualCameraLensSource.IntrinsicsFromParent

#### **LOCAL\_INTRINSICS** : _Final\[[VirtualCameraLensSource](/python-api/docs/virtualcameralenssource#virtualcameralenssource)\]_ = VirtualCameraLensSource.LocalIntrinsics

#### **ZOOM\_FROM\_PARENT** : _Final\[[VirtualCameraLensSource](/python-api/docs/virtualcameralenssource#virtualcameralenssource)\]_ = VirtualCameraLensSource.ZoomFromParent