@@ -12535,7 +12535,7 @@ <h2>Property list</h2>
12535
12535
<dd>The primaries in use as string. (Exact values subject to change.)</dd>
12536
12536
<dt><tt class="docutils literal"><span class="pre">video-params/gamma</span></tt></dt>
12537
12537
<dd>The gamma function in use as string. (Exact values subject to change.)</dd>
12538
- <dt><tt class="docutils literal"><span class="pre">video-params/sig-peak</span></tt></dt>
12538
+ <dt><tt class="docutils literal"><span class="pre">video-params/sig-peak</span></tt> (deprecated) </dt>
12539
12539
<dd>The video file's tagged signal peak as float.</dd>
12540
12540
<dt><tt class="docutils literal"><span class="pre">video-params/light</span></tt></dt>
12541
12541
<dd>The light type in use as a string. (Exact values subject to change.)</dd>
@@ -12550,6 +12550,24 @@ <h2>Property list</h2>
12550
12550
<dd>Alpha type. If the format has no alpha channel, this will be unavailable
12551
12551
(but in future releases, it could change to <tt class="docutils literal">no</tt>). If alpha is
12552
12552
present, this is set to <tt class="docutils literal">straight</tt> or <tt class="docutils literal">premul</tt>.</dd>
12553
+ <dt><tt class="docutils literal"><span class="pre">video-params/min-luma</span></tt></dt>
12554
+ <dd>Minimum luminance, as reported by HDR10 metadata (in cd/m2)</dd>
12555
+ <dt><tt class="docutils literal"><span class="pre">video-params/max-luma</span></tt></dt>
12556
+ <dd>Maximum luminance, as reported by HDR10 metadata (in cd/m2)</dd>
12557
+ <dt><tt class="docutils literal"><span class="pre">video-params/max-cll</span></tt></dt>
12558
+ <dd>Maximum content light level, as reported by HDR10 metadata (in cd/m2)</dd>
12559
+ <dt><tt class="docutils literal"><span class="pre">video-params/max-fall</span></tt></dt>
12560
+ <dd>Maximum frame average light level, as reported by HDR10 metadata (in cd/m2)</dd>
12561
+ <dt><tt class="docutils literal"><span class="pre">video-params/scene-max-r</span></tt></dt>
12562
+ <dd>MaxRGB of a scene for R component, as reported by HDR10+ metadata (in cd/m2)</dd>
12563
+ <dt><tt class="docutils literal"><span class="pre">video-params/scene-max-g</span></tt></dt>
12564
+ <dd>MaxRGB of a scene for G component, as reported by HDR10+ metadata (in cd/m2)</dd>
12565
+ <dt><tt class="docutils literal"><span class="pre">video-params/scene-max-b</span></tt></dt>
12566
+ <dd>MaxRGB of a scene for B component, as reported by HDR10+ metadata (in cd/m2)</dd>
12567
+ <dt><tt class="docutils literal"><span class="pre">video-params/max-pq-y</span></tt></dt>
12568
+ <dd>Maximum PQ luminance of a frame, as reported by peak detection (in PQ, 0-1)</dd>
12569
+ <dt><tt class="docutils literal"><span class="pre">video-params/avg-pq-y</span></tt></dt>
12570
+ <dd>Average PQ luminance of a frame, as reported by peak detection (in PQ, 0-1)</dd>
12553
12571
</dl>
12554
12572
<p>When querying the property with the client API using <tt class="docutils literal">MPV_FORMAT_NODE</tt>,
12555
12573
or with Lua <tt class="docutils literal">mp.get_property_native</tt>, this will return a mpv_node with
@@ -12575,45 +12593,15 @@ <h2>Property list</h2>
12575
12593
"stereo-in" MPV_FORMAT_STRING
12576
12594
"average-bpp" MPV_FORMAT_INT64
12577
12595
"alpha" MPV_FORMAT_STRING
12578
- </pre>
12579
- </dd>
12580
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata</span></tt></dt>
12581
- <dd><p class="first">Video HDR metadata per frame, including peak detection result.
12582
- This has a number of sub-properties:</p>
12583
- <dl class="docutils">
12584
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/min-luma</span></tt></dt>
12585
- <dd>Minimum luminance, as reported by HDR10 metadata (in cd/m2)</dd>
12586
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/max-luma</span></tt></dt>
12587
- <dd>Maximum luminance, as reported by HDR10 metadata (in cd/m2)</dd>
12588
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/max-cll</span></tt></dt>
12589
- <dd>Maximum content light level, as reported by HDR10 metadata (in cd/m2)</dd>
12590
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/max-fall</span></tt></dt>
12591
- <dd>Maximum frame average light level, as reported by HDR10 metadata (in cd/m2)</dd>
12592
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/scene-max-r</span></tt></dt>
12593
- <dd>MaxRGB of a scene for R component, as reported by HDR10+ metadata (in cd/m2)</dd>
12594
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/scene-max-g</span></tt></dt>
12595
- <dd>MaxRGB of a scene for G component, as reported by HDR10+ metadata (in cd/m2)</dd>
12596
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/scene-max-b</span></tt></dt>
12597
- <dd>MaxRGB of a scene for B component, as reported by HDR10+ metadata (in cd/m2)</dd>
12598
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/max-pq-y</span></tt></dt>
12599
- <dd>Maximum PQ luminance of a frame, as reported by peak detection (in PQ, 0-1)</dd>
12600
- <dt><tt class="docutils literal"><span class="pre">hdr-metadata/avg-pq-y</span></tt></dt>
12601
- <dd>Average PQ luminance of a frame, as reported by peak detection (in PQ, 0-1)</dd>
12602
- </dl>
12603
- <p>When querying the property with the client API using <tt class="docutils literal">MPV_FORMAT_NODE</tt>,
12604
- or with Lua <tt class="docutils literal">mp.get_property_native</tt>, this will return a mpv_node with
12605
- the following contents:</p>
12606
- <pre class="last literal-block">
12607
- MPV_FORMAT_NODE_MAP
12608
- "min-luma" MPV_FORMAT_DOUBLE
12609
- "max-luma" MPV_FORMAT_DOUBLE
12610
- "max-cll" MPV_FORMAT_DOUBLE
12611
- "max-fall" MPV_FORMAT_DOUBLE
12612
- "scene-max-r" MPV_FORMAT_DOUBLE
12613
- "scene-max-g" MPV_FORMAT_DOUBLE
12614
- "scene-max-b" MPV_FORMAT_DOUBLE
12615
- "max-pq-y" MPV_FORMAT_DOUBLE
12616
- "avg-pq-y" MPV_FORMAT_DOUBLE
12596
+ "min-luma" MPV_FORMAT_DOUBLE
12597
+ "max-luma" MPV_FORMAT_DOUBLE
12598
+ "max-cll" MPV_FORMAT_DOUBLE
12599
+ "max-fall" MPV_FORMAT_DOUBLE
12600
+ "scene-max-r" MPV_FORMAT_DOUBLE
12601
+ "scene-max-g" MPV_FORMAT_DOUBLE
12602
+ "scene-max-b" MPV_FORMAT_DOUBLE
12603
+ "max-pq-y" MPV_FORMAT_DOUBLE
12604
+ "avg-pq-y" MPV_FORMAT_DOUBLE
12617
12605
</pre>
12618
12606
</dd>
12619
12607
<dt><tt class="docutils literal">dwidth</tt>, <tt class="docutils literal">dheight</tt></dt>
0 commit comments