@@ -7545,8 +7545,18 @@ <h2>GPU renderer options</h2>
7545
7545
<dt>NATIVE (resizable)</dt>
7546
7546
<dd>The combined image, in the source colorspace, before conversion to RGB.</dd>
7547
7547
<dt>MAINPRESUB (resizable)</dt>
7548
- <dd>The image, after conversion to RGB, but before
7549
- <tt class="docutils literal"><span class="pre">--blend-subtitles=video</span></tt> is applied.</dd>
7548
+ <dd><p class="first">The image, after conversion to RGB, but before
7549
+ <tt class="docutils literal"><span class="pre">--blend-subtitles=video</span></tt> is applied.</p>
7550
+ <div class="admonition note last">
7551
+ <p class="first admonition-title">Note</p>
7552
+ <p class="last">With <tt class="docutils literal"><span class="pre">--vo=gpu</span></tt>, <tt class="docutils literal">MAIN</tt> and <tt class="docutils literal">MAINPRESUB</tt> are separate shader
7553
+ stages, this allows rendering overlays directly onto the pre-scaled
7554
+ video stage. <tt class="docutils literal"><span class="pre">--vo=gpu-next</span></tt> does not support this feature,
7555
+ and as such, the <tt class="docutils literal">MAINPRESUB</tt> shader stage does not exist.
7556
+ It is still valid to refer to this name in shaders, but it is
7557
+ handled identically to <tt class="docutils literal">MAIN</tt>.</p>
7558
+ </div>
7559
+ </dd>
7550
7560
<dt>MAIN (resizable)</dt>
7551
7561
<dd>The main image, after conversion to RGB but before upscaling.</dd>
7552
7562
<dt>LINEAR (fixed)</dt>
@@ -8637,6 +8647,23 @@ <h2>GPU renderer options</h2>
8637
8647
margins below a video (for example).</p>
8638
8648
<p>If <tt class="docutils literal">video</tt> is selected, the behavior is similar to <tt class="docutils literal">yes</tt>, but subs are
8639
8649
drawn at the video's native resolution, and scaled along with the video.</p>
8650
+ <div class="admonition note">
8651
+ <p class="first admonition-title">Note</p>
8652
+ <p class="last"><tt class="docutils literal"><span class="pre">--vo=gpu-next</span></tt> with <tt class="docutils literal"><span class="pre">--blend-subtitles=video</span></tt> will
8653
+ correctly follow <tt class="docutils literal"><span class="pre">--video-rotate</span></tt> if rotated in 90-degree steps.</p>
8654
+ </div>
8655
+ <div class="admonition warning">
8656
+ <p class="first admonition-title">Warning</p>
8657
+ <p class="last">With <tt class="docutils literal"><span class="pre">--vo=gpu-next</span></tt>, the <tt class="docutils literal"><span class="pre">--blend-subtitles=video</span></tt> mode
8658
+ blends the subtitles after scaling the video, similar to
8659
+ <tt class="docutils literal"><span class="pre">--blend-subtitles=yes</span></tt>. The difference is that the subtitles
8660
+ are rendered at the video's native resolution and then scaled
8661
+ separately to blend with the video. This is useful for
8662
+ performance reasons, as it allows subtitles to be rendered at a
8663
+ lower resolution, but it does not have the same effect as
8664
+ hardsubbing, which would require blending before scaling. This
8665
+ may change in the future.</p>
8666
+ </div>
8640
8667
<div class="admonition warning last">
8641
8668
<p class="first admonition-title">Warning</p>
8642
8669
<p class="last">This changes the way subtitle colors are handled. Normally,
0 commit comments