VideoStreamMetadata

class torchcodec.decoders.VideoStreamMetadata(duration_seconds_from_header: Optional[float], begin_stream_seconds_from_header: Optional[float], bit_rate: Optional[float], codec: Optional[str], stream_index: int, begin_stream_seconds_from_content: Optional[float], end_stream_seconds_from_content: Optional[float], width: Optional[int], height: Optional[int], num_frames_from_header: Optional[int], num_frames_from_content: Optional[int], average_fps_from_header: Optional[float], pixel_aspect_ratio: Optional[Fraction])

單個影片流的元資料。

VideoStreamMetadata 的用法示例

使用 VideoDecoder 解碼影片

使用 VideoDecoder 解碼影片

property average_fps: Optional[float]

流的平均幀率。如果執行了 掃描，則此值根據幀數和流時長計算得出。否則，我們將回退到 average_fps_from_header。

average_fps_from_header: Optional[float]

從頭資訊中獲得的流的平均幀率（浮點數或 None）。我們建議改用 average_fps 屬性。

property begin_stream_seconds: float

流的開始時間，以秒為單位（浮點數）。概念上，這對應於第一幀的 pts。如果 begin_stream_seconds_from_content 不為 None，則返回該值。否則，該值為 0。

begin_stream_seconds_from_content: Optional[float]

流的開始時間，以秒為單位（浮點數或 None）。概念上，這對應於第一幀的 pts。僅當進行 掃描 時，作為流中所有幀的 min(frame.pts) 來計算。通常，此值為 0。

begin_stream_seconds_from_header: Optional[float]

從頭資訊中獲得的流的開始時間，以秒為單位（浮點數或 None）。通常，此值為 0。

bit_rate: Optional[float]

流的位元率，以秒為單位（浮點數或 None）。

codec: Optional[str]

編解碼器（字串或 None）。

property duration_seconds: Optional[float]

流的持續時間，以秒為單位。我們嘗試從實際幀中計算持續時間（如果執行了 掃描）。否則，我們回退到 duration_seconds_from_header。如果該值也為 None，我們則從 num_frames_from_header 和 average_fps_from_header 計算持續時間。

duration_seconds_from_header: Optional[float]

從頭資訊中獲得的流的持續時間，以秒為單位（浮點數或 None）。這可能不準確。

property end_stream_seconds: Optional[float]

流的結束時間，以秒為單位（浮點數或 None）。概念上，這對應於 last_frame.pts + last_frame.duration。如果 end_stream_seconds_from_content 不為 None，則返回該值。否則，返回 duration_seconds。

end_stream_seconds_from_content: Optional[float]

流的結束時間，以秒為單位（浮點數或 None）。概念上，這對應於 last_frame.pts + last_frame.duration。僅當進行 掃描 時，作為流中所有幀的 max(frame.pts + frame.duration) 來計算。請注意，在此時間值下不播放任何幀，因此使用此值呼叫 get_frame_played_at() 將導致錯誤。最好透過用 [-1] 索引 VideoDecoder 物件來檢索最後一幀。

height: Optional[int]

幀的高度（整數或 None）。

property num_frames: Optional[int]

流中的幀數（整數或 None）。這對應於 num_frames_from_content（如果進行了 掃描），否則對應於 num_frames_from_header。如果該值也為 None，則幀數根據持續時間和平均幀率計算得出。

num_frames_from_content: Optional[int]

TorchCodec 透過掃描流內容計算出的幀數（掃描不涉及解碼）。這比 num_frames_from_header 更準確。我們建議改用 num_frames 屬性。（整數或 None）。

num_frames_from_header: Optional[int]

來自流元資料的幀數。這可能不準確。我們建議改用 num_frames 屬性。（整數或 None）。

pixel_aspect_ratio: Optional[Fraction]

畫素縱橫比（PAR），也稱為取樣縱橫比（SAR — 不要與儲存縱橫比，也稱為 SAR 混淆），是每個畫素的寬度與高度之比（fractions.Fraction 或 None）。

stream_index: int

此元資料所指流的索引（整數）。

width: Optional[int]

幀的寬度（整數或 None）。