SDR content is automatically tone-mapped to HDR when requested. The default SDR-to-HDR pipeline relies on the zimg image processing library for scaling and tone mapping, while an advanced Colorfront engine provides enhanced control. Tone mapping parameters are managed via the tonemap block.
<?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|apple_prores]</output> <!-- required-->
<hdr>[hdr10|hlg]</hdr>
<tonemap>
<engine>[zscale|cfe]</engine>
<reference_white_level>[Reference white level]</reference_white_level>
<hdr_amount>[HDR Amount]</hdr_amount>
<hdr_surround>[HDR Surround]</hdr_surround>
</tonemap>
</format>
</query>{
"query": {
"userid": "[UserID]", // required
"userkey": "[UserKey]", // required
"action": "[Action]", // required
"source": "[SourceFile]", // required
"format": {
"output": "[mp4|mpegts|apple_prores]",
"hdr": "[hdr10|hlg]",
"tonemap": {
"engine": "[zscale|cfe]",
"reference_white_level": "[Reference white level]",
"hdr_amount": "[HDR Amount]",
"hdr_surround": "[HDR Surround]"
}
}
}
}| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| tonemap | Configures SDR-to-HDR tone mapping settings | none | |
| engine | Tone mapping engine | zscale - ZScale FFMpeg filter cfe - Colorfront engine | zscale |
| reference_white_level | zscale only - Reference white level for tone mapping specified in nits | 100-1000 | 203 |
| hdr_amount | cfe only - Controls the strength of the remap effect. A value of 0 produces an SDR-like output | 0-1 | 0 |
| hdr_surround | cfe only - This parameter defines how much of the highlight range is boosted. Lower values preserve most of the original luminance, brightening only the upper end of the highlights | 0-1 | 0 |