> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generalrobotics.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CameraSettings

> Camera configuration settings

```python theme={null}
from grid_types import CameraSettings
```

Camera configuration settings.

Contains intrinsic camera parameters, distortion coefficients,
extrinsic transformation matrix, and other camera-specific configuration.

## Fields

<ResponseField name="fx" type="Optional[float]">
  Focal length in x direction (pixels)
</ResponseField>

<ResponseField name="fy" type="Optional[float]">
  Focal length in y direction (pixels)
</ResponseField>

<ResponseField name="cx" type="Optional[float]">
  Principal point x coordinate (pixels)
</ResponseField>

<ResponseField name="cy" type="Optional[float]">
  Principal point y coordinate (pixels)
</ResponseField>

<ResponseField name="distortion_coeffs" type="Optional[list[float]]">
  Distortion coefficients
</ResponseField>

<ResponseField name="camera_model" type="Optional[CameraModel]">
  Camera projection model
</ResponseField>

<ResponseField name="image_type" type="Optional[ImageType]">
  Type of images captured
</ResponseField>

<ResponseField name="resolution" type="Optional[tuple[int, int]]">
  Image resolution (width, height)
</ResponseField>

<ResponseField name="extrinsics" type="Optional[np.ndarray]">
  4x4 transformation matrix representing the camera pose relative to a reference frame (e.g., robot base or end-effector). None if not configured.
</ResponseField>

## Constructor

```python Signature theme={null}
CameraSettings(
    fx: Optional[float] = None,
    fy: Optional[float] = None,
    cx: Optional[float] = None,
    cy: Optional[float] = None,
    distortion_coeffs: Optional[List[float]] = None,
    camera_model: Optional[CameraModel] = None,
    image_type: Optional[ImageType] = None,
    resolution: Optional[Tuple[int, int]] = None,
    extrinsics: Optional[np.ndarray] = None,
)
```

## Methods

### `from_dict()`

```python Signature theme={null}
from_dict(data: dict) -> CameraSettings
```

Deserialize from dictionary.

<ParamField body="data" type="dict" required>
  Dictionary containing camera settings data
</ParamField>

**Returns:**

CameraSettings: Reconstructed camera settings object

### `to_dict()`

```python Signature theme={null}
to_dict() -> dict
```

Serialize to dictionary for JSON transfer.

**Returns:**

dict: Dictionary representation of the camera settings


## Related topics

- [Sensors](/simulation/isaac/sensors.md)
- [Workflow Config](/simulation/isaac/session_configuration/workflow.md)
- [Camera Calibration](/deployment/camera-calibration.md)
- [Environment Config](/simulation/isaac/session_configuration/env.md)
- [MDP Config](/simulation/isaac/session_configuration/mdp.md)