Add a background
================

Background is an optional [ArFrame](../../argaze.md/#argaze.ArFeatures.ArFrame) attribute to display any image behind pipeline visualization.

![Background](../../img/background.png)

## Load and display ArFrame background

[ArFrame.background](../../argaze.md/#argaze.ArFeatures.ArFrame.background) can be enabled thanks to a dedicated JSON entry.

Here is an extract from the JSON ArFrame configuration file where a background picture is loaded and displayed:

```json
{
    "argaze.ArFeatures.ArFrame": {
        "name": "My FullHD screen",
        "size": [1920, 1080],
        ...
        "background": "./bosch.png",
        ...
        "image_parameters": {
            ...
            "background_weight": 1
        }
    }
}
```

!!! note
    As explained in [visualization chapter](visualization.md), the resulting image is accessible thanks to [ArFrame.image](../../argaze.md/#argaze.ArFeatures.ArFrame.image) method.

Now, let's understand the meaning of each JSON entry.

### *background*

The path to an image file on disk.

### *background_weight*

The weight of background overlay in [ArFrame.image](../../argaze.md/#argaze.ArFeatures.ArFrame.image) between 0 and 1.