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

# device.format

> The format each camera in a session is running, and whether the output attached to it can carry the pixels that format produces

Reads from `AVCaptureDevice` and `CMVideoFormatDescriptionGetDimensions`. One
reading per active camera, whenever the format it is running changes.

| | |
| - | - |
| [Delivery](/instruments/metadata) | stream, onChange |
| Mechanism | kvo |
| [Requires](/instruments/metadata) | iOS 17+, hardware only, no simulator, basset 0.1.1+ |

Real output from `basset request get`, captured against a running
`AVCaptureSession`:

```
CAPTURED                  ELAPSED  INSTRUMENT

launch 11331933422406966707
2026-08-23T13:13:04.919Z  +0.0s    camera.device.format(captureDevice)
├─ instanceId                  1
├─ deviceType                  AVCaptureDeviceTypeBuiltInWideAngleCamera
├─ devicePosition              back
├─ deviceUniqueId              com.apple.avfoundation.avcapturedevice.built-in_video:0
├─ formatWidthPixels           1920
├─ formatHeightPixels          1080
├─ formatPixelFormat           420v
├─ formatMinFramesPerSecond    3.0
├─ formatMaxFramesPerSecond    30.0
├─ formatMultiCamSupported     true
├─ formatCount                 50
├─ activeColorSpace            sRGB
├─ systemPressureLevel         AVCaptureSystemPressureLevelNominal
├─ outputPixelFormat           420v
├─ outputPixelFormatSupported  true
├─ videoRotationDegrees        0.0
└─ videoMirrored               false
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.