media-core/container/facts.zig

Página generada desde native/zig/media-core/media_engine.zig. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere.

Modelo de facts de contenedor (StreamInfo / ContainerInfo): la estructura que emiten AMBOS motores (dec-0110 §1: engine=zig y engine=libav dan la misma forma; dec-0109 propone esta). Promovido de spikes/zig-container-facts (w2/zig-demux-spike).

Son hechos observados en las cabeceras, sin política: qué códec, qué dimensiones, qué color, qué índice de keyframes. La política (ranking de códecs, fallback, selección de pista) no vive aquí.

La memoria de un ContainerInfo vive en su arena (codec_private, strings, streams), salvo el índice de keyframes de cada stream, que es un slice de tamaño exacto del allocator del probe (una arena reserva nodos 1,5 veces mayores que la petición, y el índice es lo único grande). deinit libera las dos cosas.

facts.FormatCopiar enlace

type · línea 19

pub const Format = enum

Sin ///.

facts.KindCopiar enlace

type · línea 21

pub const Kind = enum

Sin ///.

facts.CodecCopiar enlace

type · línea 24

pub const Codec = enum

Nombres alineados con codec_name de ffprobe para poder comparar 1:1.

facts.Codec.fromNameCopiar enlace

fn · línea 55

pub fn fromName(name: []const u8) Codec

Inverse of @tagName (the ffprobe codec_name spelling).

facts.ChromaCopiar enlace

type · línea 60

pub const Chroma = enum

Sin ///.

facts.Chroma.pixFmtCopiar enlace

fn · línea 66

pub fn pixFmt(self: Chroma, bit_depth: u8) ?[]const u8

Sin ///.

facts.ColourCopiar enlace

type · línea 97

pub const Colour = struct

Code points ISO/IEC 23091-2 (H.273). null = el contenedor no lo declara.

facts.Colour.mergeCopiar enlace

fn · línea 107

pub fn merge(self: *Colour, other: Colour) void

Sin ///.

facts.HdrFormatCopiar enlace

type · línea 118

pub const HdrFormat = enum

Sin ///.

facts.RationalCopiar enlace

type · línea 120

pub const Rational = struct

Sin ///.

facts.Rational.reducedCopiar enlace

fn · línea 124

pub fn reduced(self: Rational) Rational

Sin ///.

facts.Rational.approxCopiar enlace

fn · línea 133

pub fn approx(self: Rational, max: u64) Rational

Mejor aproximación con numerador y denominador <= max (fracciones continuas con semiconvergente final, mismo criterio que av_reduce).

facts.KeyframeCopiar enlace

type · línea 160

pub const Keyframe = struct

Sin ///.

facts.IndexSourceCopiar enlace

type · línea 169

pub const IndexSource = enum

De dónde sale el índice de keyframes y si está completo.

facts.IssueCopiar enlace

type · línea 186

pub const Issue = enum

Estructuras opcionales que estaban presentes pero no se pudieron decodificar. Los campos que dependían de ellas quedan en null; la pista sigue siendo válida.

facts.StreamInfoCopiar enlace

type · línea 192

pub const StreamInfo = struct

Sin ///.

facts.StreamInfo.pixFmtCopiar enlace

fn · línea 229

pub fn pixFmt(self: *const StreamInfo) ?[]const u8

Sin ///.

facts.StreamInfo.profileNameCopiar enlace

fn · línea 235

pub fn profileName(self: *const StreamInfo) ?[]const u8

Nombre de perfil con la misma ortografía que ffprobe.

facts.StreamInfo.deriveHdrCopiar enlace

fn · línea 282

pub fn deriveHdr(self: *StreamInfo) void

Sin ///.

facts.IndexLocationCopiar enlace

type · línea 292

pub const IndexLocation = enum

Sin ///.

facts.ContainerInfoCopiar enlace

type · línea 296

pub const ContainerInfo = struct

Sin ///.

facts.ContainerInfo.deinitCopiar enlace

fn · línea 315

pub fn deinit(self: *ContainerInfo) void

Sin ///.

facts.primariesNameCopiar enlace

fn · línea 323

pub fn primariesName(v: u8) ?[]const u8

Traducción de los code points de color a los nombres de ffprobe.

facts.transferNameCopiar enlace

fn · línea 340

pub fn transferName(v: u8) ?[]const u8

Sin ///.

facts.matrixNameCopiar enlace

fn · línea 359

pub fn matrixName(v: u8) ?[]const u8

Sin ///.

container.ContainerInfoCopiar enlace

type · línea 296

pub const ContainerInfo = struct

Sin ///.

container.ContainerInfo.deinitCopiar enlace

fn · línea 315

pub fn deinit(self: *ContainerInfo) void

Sin ///.

contract.RationalCopiar enlace

type · línea 120

pub const Rational = struct

Sin ///.

contract.Rational.reducedCopiar enlace

fn · línea 124

pub fn reduced(self: Rational) Rational

Sin ///.

contract.Rational.approxCopiar enlace

fn · línea 133

pub fn approx(self: Rational, max: u64) Rational

Mejor aproximación con numerador y denominador <= max (fracciones continuas con semiconvergente final, mismo criterio que av_reduce).