> ## 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.

# background

> Analyzes video backgrounds to check for desired and undesired elements

## Overview

Analyzes video backgrounds to evaluate whether specific elements are present or absent. The detector uses configurable criteria to check for desired elements that should be present and undesired elements that should not be present.

## Configuration

<ParamField body="config.desired_elements" type="array">
  List of elements that SHOULD be present in the background (e.g., "professional setting", "clean workspace", "natural lighting")
</ParamField>

<ParamField body="config.undesired_elements" type="array">
  List of elements that should NOT be present in the background (e.g., "clutter", "car interior", "distracting objects")
</ParamField>

## Example Configuration

```json theme={null}
{
  "detector_name": "background",
  "config": {
    "desired_elements": ["professional setting", "clean workspace", "good lighting"],
    "undesired_elements": ["clutter", "distracting objects", "inappropriate content"]
  }
}
```

## Minimal Configuration

If no elements are specified, the detector will pass by default:

```json theme={null}
{
  "detector_name": "background",
  "config": {}
}
```

## Result Schema

```json theme={null}
{
  "detector_name": "background",
  "pass_check": false,
  "score": 0.67,
  "rationale": "Background issues: Missing desired element: professional setting; Detected undesired element: clutter. Cluttered room with visible piles and unprofessional appearance.",
  "metrics": {
    "element_results": {
      "professional setting": false,
      "clean workspace": true,
      "good lighting": true,
      "clutter": true,
      "distracting objects": false
    },
    "missing_desired": ["professional setting"],
    "detected_undesired": ["clutter"],
    "reasons": "Cluttered room with visible piles and unprofessional appearance",
    "desired_elements": ["professional setting", "clean workspace", "good lighting"],
    "undesired_elements": ["clutter", "distracting objects"]
  },
  "timestamps": [1.2, 3.6, 4.8]
}
```