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

# transition_detection

> Counts scene transitions

## Overview

Counts scene transitions and compares them to an optional limit.

## Configuration

<ParamField body="config.max_transitions" type="integer">
  Maximum number of transitions allowed.
</ParamField>

## Example Configuration

```json theme={null}
{
  "detector_name": "transition_detection",
  "config": {
    "max_transitions": 5
  }
}
```

## Result Schema

```json theme={null}
{
  "detector_name": "transition_detection",
  "pass_check": true,
  "score": 1.0,
  "rationale": "Detected 3 transitions (within limit of 5)",
  "metrics": {
    "transition_count": 3,
    "transition_timestamps": [1.2, 3.4, 7.8],
    "transition_frames": [15, 42, 98],
    "max_transitions": 5
  },
  "timestamps": [1.2, 3.4, 7.8]
}
```

## Interpreting Results

* **transition\_count**: Total detected transitions.
* **transition\_timestamps/transition\_frames**: Locations of detected transitions.
* **max\_transitions**: If set, determines pass/fail.