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

# CameraPosition

Camera position based on rotations about a pivot point. Used to define a camera preset in the AnimateCameraPreset layer.

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

Subclasses: _[VirtualCameraPosition](/python-api/docs/virtualcameraposition#virtualcameraposition)_

## Properties

#### **distance\_to\_pivot** : _float_

The distance between the camera and the pivot point.

_UserName: Distance to pivot_

#### **elevation** : _float_

Elevation of the camera position in degrees.

_UserName: Elevation_

#### **heading** : _float_

The heading of the camera in degrees

_UserName: Heading_

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

The pivot point (centre of rotation) of the camera.

_UserName: Pivot_

#### **roll** : _float_

Roll angle of the camera in degrees.

_UserName: Roll_

#### **view\_angle** : _float_

The view angle of the camera in degrees.

_UserName: Field of view_

#### **virtual\_camera\_coordinates** : _int_

Apply virtual camera position and rotation offsets relative to original camera, or in global coordinate space.

_Options: {0: ‘Relative’, 1: ‘Global’}  
UserName: Virtual camera coordinates_

#### **virtual\_camera\_position** : _[Vec](/python-api/docs/vec#vec)_

Virtual camera position.

#### **virtual\_camera\_rotation** : _[Vec](/python-api/docs/vec#vec)_

The virtual camera rotation.

#### **virtual\_camera\_zoom** : _float_

Gain applied to focal length of camera to give virtual zoom in or out.

_UserName: Virtual camera zoom_

## Methods

#### **getViewPos**(self)

Updates the view position members from the visualiser camera

This method updates the instances position and attitude variables from the current active visualiser camera.