kenzuya/unshackle
1
0
Fork 2
mirror of https://github.com/unshackle-dl/unshackle.git synced 2026-11-13 12:35:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Deployed 0c45195 with MkDocs version: 1.6.1

Browse Source
This commit is contained in:
2026-10-31 05:23:11 +00:00
parent 802ce0d6a1
commit dad55e4568
8 changed files with 277 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files
reference/api/tracks/index.html
+227 -3
View File
@@ -1981,6 +1981,28 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Audio.dolby_channel_layout" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;dolby_channel_layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Audio.channels_from_count" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;channels_from_count
</span>
</a>
</li>
<li class="md-nav__item">
@@ -2269,6 +2291,28 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Subtitle.dash_offset_ms" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;dash_offset_ms
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Subtitle.rebase_ttml" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;rebase_ttml
</span>
</a>
</li>
<li class="md-nav__item">
@@ -3113,6 +3157,17 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Video.vp9_colour_args" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;vp9_colour_args
</span>
</a>
</li>
<li class="md-nav__item">
@@ -3366,6 +3421,28 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Audio.dolby_channel_layout" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;dolby_channel_layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Audio.channels_from_count" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;channels_from_count
</span>
</a>
</li>
<li class="md-nav__item">
@@ -3654,6 +3731,28 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Subtitle.dash_offset_ms" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;dash_offset_ms
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Subtitle.rebase_ttml" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;rebase_ttml
</span>
</a>
</li>
<li class="md-nav__item">
@@ -4498,6 +4597,17 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#unshackle.core.tracks.Video.vp9_colour_args" class="md-nav__link">
<span class="md-ellipsis">
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;vp9_colour_args
</span>
</a>
</li>
<li class="md-nav__item">
@@ -4717,7 +4827,7 @@ If mime_type is not provided, it will try to guess it.</p>
<code>session</code>
</td>
<td>
<code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.tracks.attachment.AnySession">AnySession</span>]</code>
<code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.session.AnySession">AnySession</span>]</code>
</td>
<td>
<div class="doc-md-description">
@@ -4947,7 +5057,7 @@ If mime_type is not provided, it will try to guess it.</p>
<code>session</code>
</td>
<td>
<code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.tracks.attachment.AnySession">AnySession</span>]</code>
<code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.session.AnySession">AnySession</span>]</code>
</td>
<td>
<div class="doc-md-description">
@@ -5206,6 +5316,56 @@ It does not convert the value to assume a sub speaker channel layout, e.g. 5.1-&
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Audio.dolby_channel_layout" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">dolby_channel_layout</span>
<span class="doc doc-labels">
<small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small>
</span>
<a href="#unshackle.core.tracks.Audio.dolby_channel_layout" class="headerlink" title="Permanent link">&para;</a></h3>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">dolby_channel_layout</span><span class="p">(</span><span class="n">mask</span><span class="p">)</span>
</span></code></pre></div>
<div class="doc doc-contents ">
<p>Channel layout of a Dolby DASH channel configuration mask, e.g. 0xF801 -&gt; 5.1.</p>
</div>
</div>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Audio.channels_from_count" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">channels_from_count</span>
<span class="doc doc-labels">
<small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small>
</span>
<a href="#unshackle.core.tracks.Audio.channels_from_count" class="headerlink" title="Permanent link">&para;</a></h3>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">channels_from_count</span><span class="p">(</span><span class="n">count</span><span class="p">)</span>
</span></code></pre></div>
<div class="doc doc-contents ">
<p>Channel layout for a bare number of channels, as HLS CHANNELS, Smooth Streaming and most DASH schemes give it.</p>
<p>A count does not say which channel is the LFE, so 6, 7 and 8 take the 5.1, 6.1 and 7.1 layouts those streams
carry in practice. Any other value goes back as-is, for parse_channels to read.</p>
</div>
</div>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Audio.channel_total" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">channel_total</span>
@@ -6072,6 +6232,48 @@ explanation list above.</p>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Subtitle.dash_offset_ms" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">dash_offset_ms</span>
<a href="#unshackle.core.tracks.Subtitle.dash_offset_ms" class="headerlink" title="Permanent link">&para;</a></h3>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">dash_offset_ms</span><span class="p">()</span>
</span></code></pre></div>
<div class="doc doc-contents ">
<p>The DASH presentationTimeOffset and one segment's length, in ms, from the merged SegmentTemplate.
Returns (0, 0) for a track that is not DASH or has no SegmentTemplate.</p>
</div>
</div>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Subtitle.rebase_ttml" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">rebase_ttml</span>
<a href="#unshackle.core.tracks.Subtitle.rebase_ttml" class="headerlink" title="Permanent link">&para;</a></h3>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">rebase_ttml</span><span class="p">(</span><span class="n">offset_ms</span><span class="p">,</span> <span class="n">segment_ms</span><span class="p">)</span>
</span></code></pre></div>
<div class="doc doc-contents ">
<p>Move the TTML cues back by offset_ms, under the same first-cue guard as rebase_webvtt.
A cue carried in from before the offset starts at 0; this method drops a cue that ends by then.</p>
</div>
</div>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Subtitle.strip_webvtt_cue_classes" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">strip_webvtt_cue_classes</span>
@@ -7826,7 +8028,7 @@ is larger than it. Use a value of 20000 (20KB) or higher.</p>
<code>session</code>
</td>
<td>
<code><span title="typing.Optional">Optional</span>[<span title="requests.Session">Session</span>]</code>
<code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.session.AnySession">AnySession</span>]</code>
</td>
<td>
<div class="doc-md-description">
@@ -8955,6 +9157,28 @@ the bitstream.</p>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Video.vp9_colour_args" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">vp9_colour_args</span>
<a href="#unshackle.core.tracks.Video.vp9_colour_args" class="headerlink" title="Permanent link">&para;</a></h3>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">vp9_colour_args</span><span class="p">(</span><span class="n">track_id</span><span class="p">)</span>
</span></code></pre></div>
<div class="doc doc-contents ">
<p>Return mkvmerge colour args for an HDR VP9 track.</p>
<p>mkvmerge drops the MP4 vpcC/SmDm/CoLL colour boxes of VP9, which leaves an HDR10 file tagged as SDR.
The transfer the file states wins; <code>self.range</code> applies only when the file states none.</p>
</div>
</div>
<div class="doc doc-object doc-function">
<h3 id="unshackle.core.tracks.Video.ccextractor" class="doc doc-heading">
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">ccextractor</span>