---
updatedAt: 2025-06-18T10:32:21.000Z
agentTools:
  projectIndex: https://api.encoding.com/llms.txt
---

# Dolby Vision®

Encoding.com has a license with Dolby to produce conforming Dolby Vision content for both profile 5 and profile 8.1 content, including Atmos.  The source provided and metadata file must be conformant with the [Dolby Encoding Engine](https://developer.dolby.com/globalassets/professional/product-manuals/dolbyencodingengineusersguide.pdf) documented standards.

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[mp4|mpegts]</output> <!-- required-->
        <hdr>[dv5|dv81]</hdr>
        <color_range>[full|limited]</color_range>
        <dolby_vision_md>[MetaDataFile]</dolby_vision_md>
        <audio_source_file>[AudioSourceFile]</audio_source_file>
        <master_display>
            <red_x>[RedX]</red_x>
            <red_y>[RedY]</red_y>
            <green_x>[GreenX]</green_x>
            <green_y>[GreenY]</green_y>
            <blue_x>[BlueX]</blue_x>
            <blue_y>[BlueY]</blue_y>
            <white_x>[WhiteX]</white_x>
            <white_y>[WhiteY]</white_y>
            <luminance_min>[MinLuminance]</luminance_min>
            <luminance_max>[MaxLuminance]</luminance_max>
            <max_cll>[MaxCLL]</max_cll>
            <max_fall>[MaxFALL]</max_fall>
        </master_display>
        <!-- Format params -->
    </format>
</query>
```
```json
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[mp4|mpegts]", // required
            "hdr": "[dv5|dv81]",
            "color_range": "[full|limited]",
            "dolby_vision_md": "[MetaDataFile]",
            "audio_source_file": "[AudioSourceFile]",
            "master_display": {
                "red_x": "[RedX]",
                "red_y": "[RedY]",
                "green_x": "[GreenX]",
                "green_y": "[GreenY]",
                "blue_x": "[BlueX]",
                "blue_y": "[BlueY]",
                "white_x": "[WhiteX]",
                "white_y": "[WhiteY]",
                "luminance_min": "[MinLuminance]",
                "luminance_max": "[MaxLuminance]",
                "max_cll": "[MaxCLL]",
                "max_fall": "[MaxFALL]"
            },
            "segment_template": "[number|time]"
            // Format params
        }
    }
}
```
```XML Multi-birate
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[fmp4_hls|advanced_dash|advanced_fmp4]</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <dolby_vision_md>[MetaDataFile]</dolby_vision_md>
        <stream>
            <hdr>[dv5|dv81]</hdr>
            <color_range>[full|limited]</color_range>
            <master_display>
                <red_x>[RedX]</red_x>
                <red_y>[RedY]</red_y>
                <green_x>[GreenX]</green_x>
                <green_y>[GreenY]</green_y>
                <blue_x>[BlueX]</blue_x>
                <blue_y>[BlueY]</blue_y>
                <white_x>[WhiteX]</white_x>
                <white_y>[WhiteY]</white_y>
                <luminance_min>[MinLuminance]</luminance_min>
                <luminance_max>[MaxLuminance]</luminance_max>
                <max_cll>[MaxCLL]</max_cll>
                <max_fall>[MaxFALL]</max_fall>
            </master_display>
        </stream>
        <!-- Format params -->
    </format>
</query>
```
```JSON Multi-birate
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[fmp4_hls|advanced_dash|advanced_fmp4]", // required
            "destination": "[DestinationURL]", // required
            "dolby_vision_md": "[MetaDataFile]",
            "stream": [
                {
                    "hdr": "[dv5|dv81]",
                    "color_range": "[full|limited]",
                    "master_display": {
                        "red_x": "[RedX]",
                        "red_y": "[RedY]",
                        "green_x": "[GreenX]",
                        "green_y": "[GreenY]",
                        "blue_x": "[BlueX]",
                        "blue_y": "[BlueY]",
                        "white_x": "[WhiteX]",
                        "white_y": "[WhiteY]",
                        "luminance_min": "[MinLuminance]",
                        "luminance_max": "[MaxLuminance]",
                        "max_cll": "[MaxCLL]",
                        "max_fall": "[MaxFALL]"
                    }
                }
            ],
            "segment_template": "[number|time]"
            // Format params
        }
    }
}
```

| Parameter                     | Description                        | Available Values                                                            | Default Value |
| :---------------------------- | :--------------------------------- | :-------------------------------------------------------------------------- | :------------ |
| **Master Display Parameters** | -                                  | -                                                                           | -             |
| **hdr**                       | Enable HDR                         | **dv5** – Dolby Vision 5<br/>**dv81** – Dolby Vision 8.1                    | *none*        |
| **color\_range**              | Color range                        | full, limited                                                               | *none*        |
| **red\_x**                    | Red X display primary              | Float number between 0 and 1 included.                                      | 0.68          |
| **red\_y**                    | Red Y display primary              | Float number between 0 and 1 included.                                      | 0.32          |
| **green\_x**                  | Green X display primary            | Float number between 0 and 1 included.                                      | 0.265         |
| **green\_y**                  | Green Y display primary            | Float number between 0 and 1 included.                                      | 0.69          |
| **blue\_x**                   | Blue X display primary             | Float number between 0 and 1 included.                                      | 0.15          |
| **blue\_y**                   | Blue Y display primary             | Float number between 0 and 1 included.                                      | 0.06          |
| **white\_x**                  | White point X                      | Float number between 0 and 1 included.                                      | 0.3127        |
| **white\_y**                  | White point Y                      | Float number between 0 and 1 included.                                      | 0.329         |
| **luminance\_min**            | Minimum luminance                  | Float number between 0 and 65535 included.                                  | 0.0001        |
| **luminance\_max**            | Maximum luminance                  | Float number between 0 and 65535 included.                                  | 1000          |
| **max\_cll**                  | Maximum Content Light Level.       | Float number between 0 and 65535 included.<br/>0 - no maximum is indicated. | 0             |
| **max\_fall**                 | Maximum Frame-Average Light Level. | Float number between 0 and 65535 included.<br/>0 - no maximum is indicated. | 0             |
| **Format Parameters**         | -                                  | -                                                                           | -             |
| **dolby\_vision\_md**         | Dolby Vision metadata file         | Valid URL                                                                   | *none*        |
| **audio\_source\_file**       | Audio source file                  | Valid URL                                                                   | *none*        |

> 🚧 For audio\_source\_file
>
> **\<audio\_source\_file />** parameter available only for **mp4** and **mpegts** output formats.