<!-- # hard line break macro for HTML -->

# fiftyone.core.threed.camera

Camera definition for 3D visualization.

Copyright 2017-2026, Voxel51, Inc.
<br/>
[voxel51.com](https://voxel51.com/)
<br/>
<br/>

**Classes:**

| [`PerspectiveCamera`](#fiftyone.core.threed.camera.PerspectiveCamera)([position, look_at, up, ...])   | Represents the configuration of a 3D perspective camera.   |
|-------------------------------------------------------------------------------------------------------|------------------------------------------------------------|

### *class* fiftyone.core.threed.camera.PerspectiveCamera(position: [Vector3](fiftyone.core.threed.transformation.md#fiftyone.core.threed.transformation.Vector3) | None = None, look_at: [Vector3](fiftyone.core.threed.transformation.md#fiftyone.core.threed.transformation.Vector3) | None = None, up: Literal['X', 'Y', 'Z', '-X', '-Y', '-Z'] | None = None, aspect: float | None = None, fov: float = 50.0, near: float = 0.1, far: float = 2000.0)

Bases: [`BaseValidatedDataClass`](fiftyone.core.threed.validators.md#fiftyone.core.threed.validators.BaseValidatedDataClass)

Represents the configuration of a 3D perspective camera.

* **Parameters:**
  * **position** (*None*) – the position of the camera. If `None`, the camera
    position is calculated based on the bounding box of the scene
  * **look_at** (*None*) – the point the camera is looking at. If `None`, the
    camera looks at the center of the scene
  * **up** (*None*) – the orthonormal axis that is considered up. Must be one of
    “X”, “Y”, “Z”, “-X”, “-Y”, or “-Z”. If `None`, it will fallback
    to the global `up` as defined in 3D plugin settings. If that too
    is not defined, it will fallback to “Z”
  * **aspect** (*None*) – the aspect ratio of the camera. If `None`, the aspect
    ratio is calculated based on the width and height of the canvas
  * **fov** (*50*) – camera frustum vertical field of view in degrees. If
    `None`, the field of view is 50 degrees
  * **near** (*0.1*) – the near clipping plane of the camera
  * **far** (*2000*) – the far clipping plane of the camera

**Attributes:**

| [`position`](#fiftyone.core.threed.camera.PerspectiveCamera.position)   |    |
|-------------------------------------------------------------------------|----|
| [`look_at`](#fiftyone.core.threed.camera.PerspectiveCamera.look_at)     |    |
| [`up`](#fiftyone.core.threed.camera.PerspectiveCamera.up)               |    |
| [`aspect`](#fiftyone.core.threed.camera.PerspectiveCamera.aspect)       |    |
| [`fov`](#fiftyone.core.threed.camera.PerspectiveCamera.fov)             |    |
| [`near`](#fiftyone.core.threed.camera.PerspectiveCamera.near)           |    |
| [`far`](#fiftyone.core.threed.camera.PerspectiveCamera.far)             |    |

**Methods:**

| [`as_dict`](#fiftyone.core.threed.camera.PerspectiveCamera.as_dict)()   |    |
|-------------------------------------------------------------------------|----|

#### *property* position *: [Vector3](fiftyone.core.threed.transformation.md#fiftyone.core.threed.transformation.Vector3)*

#### *property* look_at *: [Vector3](fiftyone.core.threed.transformation.md#fiftyone.core.threed.transformation.Vector3)*

#### *property* up *: str | None*

#### *property* aspect

#### *property* fov *: float*

#### *property* near *: float*

#### *property* far *: float*

#### as_dict() → dict