@woosh/meep-engine 3.9.0 → 3.11.0

package/src/avif/native/av1/obu/FrameHeader.d.ts

@@ -0,0 +1,248 @@
+/**
+ * `MAX_TILE_ROWS` and `MAX_TILE_COLS` are both 64, so one bound covers the start arrays. The extra
+ * entry holds the end of the last tile.
+ * @type {number}
+ */
+export const MAX_TILE_STARTS: number;
+/**
+ * Number of CDEF strength sets a frame may signal, `1 << cdef_bits` with `cdef_bits` at most 3.
+ * @type {number}
+ */
+export const MAX_CDEF_STRENGTHS: number;
+/**
+ * The AV1 uncompressed frame header, as a struct.
+ *
+ * Holds both the coded syntax elements and the values the specification derives from them
+ * (`FrameWidth`, `MiCols`, `CodedLossless`, the tile boundaries, …), because everything downstream
+ * reads the derived values and recomputing them at each use would be both slower and a second place
+ * to be wrong.
+ *
+ * Inter-frame fields are absent: this decoder handles key frames only, and a header that turns out
+ * to be an inter frame is rejected while parsing rather than half-populated.
+ *
+ * @see AV1 spec 5.9.2 "Uncompressed header syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class FrameHeader {
+    /** @type {number} */
+    show_existing_frame: number;
+    /** @type {number} `KEY_FRAME` for everything this decoder accepts */
+    frame_type: number;
+    /** @type {number} */
+    frame_is_intra: number;
+    /** @type {number} */
+    show_frame: number;
+    /** @type {number} */
+    showable_frame: number;
+    /** @type {number} */
+    error_resilient_mode: number;
+    /** @type {number} */
+    disable_cdf_update: number;
+    /** @type {number} */
+    allow_screen_content_tools: number;
+    /** @type {number} */
+    force_integer_mv: number;
+    /** @type {number} */
+    current_frame_id: number;
+    /** @type {number} */
+    frame_size_override_flag: number;
+    /** @type {number} */
+    order_hint: number;
+    /** @type {number} */
+    primary_ref_frame: number;
+    /** @type {number} */
+    refresh_frame_flags: number;
+    /** @type {number} */
+    allow_intrabc: number;
+    /** @type {number} */
+    disable_frame_end_update_cdf: number;
+    /** @type {number} width after superres downscaling — the coded width */
+    frame_width: number;
+    /** @type {number} */
+    frame_height: number;
+    /** @type {number} width before superres downscaling — the width after upscaling */
+    upscaled_width: number;
+    /** @type {number} */
+    render_width: number;
+    /** @type {number} */
+    render_height: number;
+    /** @type {number} */
+    use_superres: number;
+    /** @type {number} */
+    superres_denom: number;
+    /** @type {number} width in 4x4 units */
+    mi_cols: number;
+    /** @type {number} height in 4x4 units */
+    mi_rows: number;
+    /** @type {number} */
+    render_and_frame_size_different: number;
+    /** @type {number} */
+    uniform_tile_spacing_flag: number;
+    /** @type {number} */
+    tile_cols: number;
+    /** @type {number} */
+    tile_rows: number;
+    /** @type {number} */
+    tile_cols_log2: number;
+    /** @type {number} */
+    tile_rows_log2: number;
+    /** @type {Int32Array} tile column boundaries in 4x4 units, `tile_cols + 1` entries */
+    mi_col_starts: Int32Array;
+    /** @type {Int32Array} tile row boundaries in 4x4 units, `tile_rows + 1` entries */
+    mi_row_starts: Int32Array;
+    /** @type {number} */
+    context_update_tile_id: number;
+    /** @type {number} */
+    tile_size_bytes: number;
+    /** @type {number} */
+    base_q_idx: number;
+    /** @type {number} */
+    delta_q_y_dc: number;
+    /** @type {number} */
+    delta_q_u_dc: number;
+    /** @type {number} */
+    delta_q_u_ac: number;
+    /** @type {number} */
+    delta_q_v_dc: number;
+    /** @type {number} */
+    delta_q_v_ac: number;
+    /** @type {number} */
+    diff_uv_delta: number;
+    /** @type {number} */
+    using_qmatrix: number;
+    /** @type {number} */
+    qm_y: number;
+    /** @type {number} */
+    qm_u: number;
+    /** @type {number} */
+    qm_v: number;
+    /** @type {number} */
+    segmentation_enabled: number;
+    /** @type {number} */
+    segmentation_update_map: number;
+    /** @type {number} */
+    segmentation_temporal_update: number;
+    /** @type {number} */
+    segmentation_update_data: number;
+    /** @type {Uint8Array} `[segment][feature]`, row-major over `SEG_LVL_MAX` */
+    feature_enabled: Uint8Array;
+    /** @type {Int16Array} `[segment][feature]`, row-major over `SEG_LVL_MAX` */
+    feature_data: Int16Array;
+    /** @type {number} */
+    seg_id_pre_skip: number;
+    /** @type {number} */
+    last_active_seg_id: number;
+    /** @type {number} */
+    delta_q_present: number;
+    /** @type {number} */
+    delta_q_res: number;
+    /** @type {number} */
+    delta_lf_present: number;
+    /** @type {number} */
+    delta_lf_res: number;
+    /** @type {number} */
+    delta_lf_multi: number;
+    /** @type {number} */
+    coded_lossless: number;
+    /** @type {number} */
+    all_lossless: number;
+    /** @type {Uint8Array} per segment */
+    lossless_array: Uint8Array;
+    /** @type {Uint8Array} `[plane][segment]`, row-major over `MAX_SEGMENTS` */
+    seg_qm_level: Uint8Array;
+    /** @type {Uint8Array} four levels: luma vertical, luma horizontal, U, V */
+    loop_filter_level: Uint8Array;
+    /** @type {number} */
+    loop_filter_sharpness: number;
+    /** @type {number} */
+    loop_filter_delta_enabled: number;
+    /** @type {number} */
+    loop_filter_delta_update: number;
+    /** @type {Int8Array} */
+    loop_filter_ref_deltas: Int8Array;
+    /** @type {Int8Array} */
+    loop_filter_mode_deltas: Int8Array;
+    /** @type {number} */
+    cdef_damping: number;
+    /** @type {number} */
+    cdef_bits: number;
+    /** @type {Uint8Array} */
+    cdef_y_pri_strength: Uint8Array;
+    /** @type {Uint8Array} */
+    cdef_y_sec_strength: Uint8Array;
+    /** @type {Uint8Array} */
+    cdef_uv_pri_strength: Uint8Array;
+    /** @type {Uint8Array} */
+    cdef_uv_sec_strength: Uint8Array;
+    /** @type {Uint8Array} one `RESTORE_*` per plane */
+    frame_restoration_type: Uint8Array;
+    /** @type {number} */
+    uses_lr: number;
+    /** @type {Int32Array} */
+    loop_restoration_size: Int32Array;
+    /** @type {number} */
+    lr_unit_shift: number;
+    /** @type {number} */
+    lr_uv_shift: number;
+    /** @type {number} `ONLY_4X4`, `TX_MODE_LARGEST` or `TX_MODE_SELECT` */
+    tx_mode: number;
+    /** @type {number} */
+    reduced_tx_set: number;
+    /** @type {number} */
+    apply_grain: number;
+    /** @type {number} */
+    grain_seed: number;
+    /** @type {number} */
+    num_y_points: number;
+    /** @type {Uint8Array} */
+    point_y_value: Uint8Array;
+    /** @type {Uint8Array} */
+    point_y_scaling: Uint8Array;
+    /** @type {number} */
+    chroma_scaling_from_luma: number;
+    /** @type {number} */
+    num_cb_points: number;
+    /** @type {Uint8Array} */
+    point_cb_value: Uint8Array;
+    /** @type {Uint8Array} */
+    point_cb_scaling: Uint8Array;
+    /** @type {number} */
+    num_cr_points: number;
+    /** @type {Uint8Array} */
+    point_cr_value: Uint8Array;
+    /** @type {Uint8Array} */
+    point_cr_scaling: Uint8Array;
+    /** @type {number} */
+    grain_scaling_minus_8: number;
+    /** @type {number} */
+    ar_coeff_lag: number;
+    /** @type {Int16Array} stored as read, i.e. offset by 128 */
+    ar_coeffs_y_plus_128: Int16Array;
+    /** @type {Int16Array} */
+    ar_coeffs_cb_plus_128: Int16Array;
+    /** @type {Int16Array} */
+    ar_coeffs_cr_plus_128: Int16Array;
+    /** @type {number} */
+    ar_coeff_shift_minus_6: number;
+    /** @type {number} */
+    grain_scale_shift: number;
+    /** @type {number} */
+    cb_mult: number;
+    /** @type {number} */
+    cb_luma_mult: number;
+    /** @type {number} */
+    cb_offset: number;
+    /** @type {number} */
+    cr_mult: number;
+    /** @type {number} */
+    cr_luma_mult: number;
+    /** @type {number} */
+    cr_offset: number;
+    /** @type {number} */
+    overlap_flag: number;
+    /** @type {number} */
+    clip_to_restricted_range: number;
+}
+//# sourceMappingURL=FrameHeader.d.ts.map

package/src/avif/native/av1/obu/FrameHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/avif/native/av1/obu/FrameHeader.js"],"names":[],"mappings":"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"}

package/src/avif/native/av1/obu/FrameHeader.js

@@ -0,0 +1,381 @@
+import { MAX_SEGMENTS, SEG_LVL_MAX, TOTAL_REFS_PER_FRAME } from "../tables/av1_symbols.js";
+
+/**
+ * `MAX_TILE_ROWS` and `MAX_TILE_COLS` are both 64, so one bound covers the start arrays. The extra
+ * entry holds the end of the last tile.
+ * @type {number}
+ */
+export const MAX_TILE_STARTS = 65;
+
+/**
+ * Number of CDEF strength sets a frame may signal, `1 << cdef_bits` with `cdef_bits` at most 3.
+ * @type {number}
+ */
+export const MAX_CDEF_STRENGTHS = 8;
+
+/**
+ * The AV1 uncompressed frame header, as a struct.
+ *
+ * Holds both the coded syntax elements and the values the specification derives from them
+ * (`FrameWidth`, `MiCols`, `CodedLossless`, the tile boundaries, …), because everything downstream
+ * reads the derived values and recomputing them at each use would be both slower and a second place
+ * to be wrong.
+ *
+ * Inter-frame fields are absent: this decoder handles key frames only, and a header that turns out
+ * to be an inter frame is rejected while parsing rather than half-populated.
+ *
+ * @see AV1 spec 5.9.2 "Uncompressed header syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class FrameHeader {
+    /** @type {number} */
+    show_existing_frame = 0;
+
+    /** @type {number} `KEY_FRAME` for everything this decoder accepts */
+    frame_type = 0;
+
+    /** @type {number} */
+    frame_is_intra = 1;
+
+    /** @type {number} */
+    show_frame = 1;
+
+    /** @type {number} */
+    showable_frame = 0;
+
+    /** @type {number} */
+    error_resilient_mode = 1;
+
+    /** @type {number} */
+    disable_cdf_update = 0;
+
+    /** @type {number} */
+    allow_screen_content_tools = 0;
+
+    /** @type {number} */
+    force_integer_mv = 1;
+
+    /** @type {number} */
+    current_frame_id = 0;
+
+    /** @type {number} */
+    frame_size_override_flag = 0;
+
+    /** @type {number} */
+    order_hint = 0;
+
+    /** @type {number} */
+    primary_ref_frame = 7;
+
+    /** @type {number} */
+    refresh_frame_flags = 0;
+
+    /** @type {number} */
+    allow_intrabc = 0;
+
+    /** @type {number} */
+    disable_frame_end_update_cdf = 0;
+
+    // ---- geometry ------------------------------------------------------------------------------
+
+    /** @type {number} width after superres downscaling — the coded width */
+    frame_width = 0;
+
+    /** @type {number} */
+    frame_height = 0;
+
+    /** @type {number} width before superres downscaling — the width after upscaling */
+    upscaled_width = 0;
+
+    /** @type {number} */
+    render_width = 0;
+
+    /** @type {number} */
+    render_height = 0;
+
+    /** @type {number} */
+    use_superres = 0;
+
+    /** @type {number} */
+    superres_denom = 8;
+
+    /** @type {number} width in 4x4 units */
+    mi_cols = 0;
+
+    /** @type {number} height in 4x4 units */
+    mi_rows = 0;
+
+    /** @type {number} */
+    render_and_frame_size_different = 0;
+
+    // ---- tiling --------------------------------------------------------------------------------
+
+    /** @type {number} */
+    uniform_tile_spacing_flag = 1;
+
+    /** @type {number} */
+    tile_cols = 1;
+
+    /** @type {number} */
+    tile_rows = 1;
+
+    /** @type {number} */
+    tile_cols_log2 = 0;
+
+    /** @type {number} */
+    tile_rows_log2 = 0;
+
+    /** @type {Int32Array} tile column boundaries in 4x4 units, `tile_cols + 1` entries */
+    mi_col_starts = new Int32Array(MAX_TILE_STARTS);
+
+    /** @type {Int32Array} tile row boundaries in 4x4 units, `tile_rows + 1` entries */
+    mi_row_starts = new Int32Array(MAX_TILE_STARTS);
+
+    /** @type {number} */
+    context_update_tile_id = 0;
+
+    /** @type {number} */
+    tile_size_bytes = 1;
+
+    // ---- quantization --------------------------------------------------------------------------
+
+    /** @type {number} */
+    base_q_idx = 0;
+
+    /** @type {number} */
+    delta_q_y_dc = 0;
+
+    /** @type {number} */
+    delta_q_u_dc = 0;
+
+    /** @type {number} */
+    delta_q_u_ac = 0;
+
+    /** @type {number} */
+    delta_q_v_dc = 0;
+
+    /** @type {number} */
+    delta_q_v_ac = 0;
+
+    /** @type {number} */
+    diff_uv_delta = 0;
+
+    /** @type {number} */
+    using_qmatrix = 0;
+
+    /** @type {number} */
+    qm_y = 0;
+
+    /** @type {number} */
+    qm_u = 0;
+
+    /** @type {number} */
+    qm_v = 0;
+
+    // ---- segmentation --------------------------------------------------------------------------
+
+    /** @type {number} */
+    segmentation_enabled = 0;
+
+    /** @type {number} */
+    segmentation_update_map = 0;
+
+    /** @type {number} */
+    segmentation_temporal_update = 0;
+
+    /** @type {number} */
+    segmentation_update_data = 0;
+
+    /** @type {Uint8Array} `[segment][feature]`, row-major over `SEG_LVL_MAX` */
+    feature_enabled = new Uint8Array(MAX_SEGMENTS * SEG_LVL_MAX);
+
+    /** @type {Int16Array} `[segment][feature]`, row-major over `SEG_LVL_MAX` */
+    feature_data = new Int16Array(MAX_SEGMENTS * SEG_LVL_MAX);
+
+    /** @type {number} */
+    seg_id_pre_skip = 0;
+
+    /** @type {number} */
+    last_active_seg_id = 0;
+
+    // ---- delta q and delta lf ------------------------------------------------------------------
+
+    /** @type {number} */
+    delta_q_present = 0;
+
+    /** @type {number} */
+    delta_q_res = 0;
+
+    /** @type {number} */
+    delta_lf_present = 0;
+
+    /** @type {number} */
+    delta_lf_res = 0;
+
+    /** @type {number} */
+    delta_lf_multi = 0;
+
+    // ---- losslessness --------------------------------------------------------------------------
+
+    /** @type {number} */
+    coded_lossless = 0;
+
+    /** @type {number} */
+    all_lossless = 0;
+
+    /** @type {Uint8Array} per segment */
+    lossless_array = new Uint8Array(MAX_SEGMENTS);
+
+    /** @type {Uint8Array} `[plane][segment]`, row-major over `MAX_SEGMENTS` */
+    seg_qm_level = new Uint8Array(3 * MAX_SEGMENTS);
+
+    // ---- loop filter ---------------------------------------------------------------------------
+
+    /** @type {Uint8Array} four levels: luma vertical, luma horizontal, U, V */
+    loop_filter_level = new Uint8Array(4);
+
+    /** @type {number} */
+    loop_filter_sharpness = 0;
+
+    /** @type {number} */
+    loop_filter_delta_enabled = 0;
+
+    /** @type {number} */
+    loop_filter_delta_update = 0;
+
+    /** @type {Int8Array} */
+    loop_filter_ref_deltas = new Int8Array(TOTAL_REFS_PER_FRAME);
+
+    /** @type {Int8Array} */
+    loop_filter_mode_deltas = new Int8Array(2);
+
+    // ---- CDEF ----------------------------------------------------------------------------------
+
+    /** @type {number} */
+    cdef_damping = 3;
+
+    /** @type {number} */
+    cdef_bits = 0;
+
+    /** @type {Uint8Array} */
+    cdef_y_pri_strength = new Uint8Array(MAX_CDEF_STRENGTHS);
+
+    /** @type {Uint8Array} */
+    cdef_y_sec_strength = new Uint8Array(MAX_CDEF_STRENGTHS);
+
+    /** @type {Uint8Array} */
+    cdef_uv_pri_strength = new Uint8Array(MAX_CDEF_STRENGTHS);
+
+    /** @type {Uint8Array} */
+    cdef_uv_sec_strength = new Uint8Array(MAX_CDEF_STRENGTHS);
+
+    // ---- loop restoration ----------------------------------------------------------------------
+
+    /** @type {Uint8Array} one `RESTORE_*` per plane */
+    frame_restoration_type = new Uint8Array(3);
+
+    /** @type {number} */
+    uses_lr = 0;
+
+    /** @type {Int32Array} */
+    loop_restoration_size = new Int32Array(3);
+
+    /** @type {number} */
+    lr_unit_shift = 0;
+
+    /** @type {number} */
+    lr_uv_shift = 0;
+
+    // ---- transform -----------------------------------------------------------------------------
+
+    /** @type {number} `ONLY_4X4`, `TX_MODE_LARGEST` or `TX_MODE_SELECT` */
+    tx_mode = 0;
+
+    /** @type {number} */
+    reduced_tx_set = 0;
+
+    // ---- film grain ----------------------------------------------------------------------------
+
+    /** @type {number} */
+    apply_grain = 0;
+
+    /** @type {number} */
+    grain_seed = 0;
+
+    /** @type {number} */
+    num_y_points = 0;
+
+    /** @type {Uint8Array} */
+    point_y_value = new Uint8Array(14);
+
+    /** @type {Uint8Array} */
+    point_y_scaling = new Uint8Array(14);
+
+    /** @type {number} */
+    chroma_scaling_from_luma = 0;
+
+    /** @type {number} */
+    num_cb_points = 0;
+
+    /** @type {Uint8Array} */
+    point_cb_value = new Uint8Array(10);
+
+    /** @type {Uint8Array} */
+    point_cb_scaling = new Uint8Array(10);
+
+    /** @type {number} */
+    num_cr_points = 0;
+
+    /** @type {Uint8Array} */
+    point_cr_value = new Uint8Array(10);
+
+    /** @type {Uint8Array} */
+    point_cr_scaling = new Uint8Array(10);
+
+    /** @type {number} */
+    grain_scaling_minus_8 = 0;
+
+    /** @type {number} */
+    ar_coeff_lag = 0;
+
+    /** @type {Int16Array} stored as read, i.e. offset by 128 */
+    ar_coeffs_y_plus_128 = new Int16Array(24);
+
+    /** @type {Int16Array} */
+    ar_coeffs_cb_plus_128 = new Int16Array(25);
+
+    /** @type {Int16Array} */
+    ar_coeffs_cr_plus_128 = new Int16Array(25);
+
+    /** @type {number} */
+    ar_coeff_shift_minus_6 = 0;
+
+    /** @type {number} */
+    grain_scale_shift = 0;
+
+    /** @type {number} */
+    cb_mult = 0;
+
+    /** @type {number} */
+    cb_luma_mult = 0;
+
+    /** @type {number} */
+    cb_offset = 0;
+
+    /** @type {number} */
+    cr_mult = 0;
+
+    /** @type {number} */
+    cr_luma_mult = 0;
+
+    /** @type {number} */
+    cr_offset = 0;
+
+    /** @type {number} */
+    overlap_flag = 0;
+
+    /** @type {number} */
+    clip_to_restricted_range = 0;
+}

package/src/avif/native/av1/obu/ObuHeader.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A parsed OBU header, plus where its payload sits in the buffer.
+ *
+ * Reused across a whole bitstream walk rather than allocated per OBU.
+ *
+ * @see AV1 spec 5.3.2 "OBU header syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class ObuHeader {
+    /**
+     * @type {number} one of the `OBU_*` constants
+     */
+    obu_type: number;
+    /**
+     * @type {number}
+     */
+    obu_extension_flag: number;
+    /**
+     * @type {number}
+     */
+    obu_has_size_field: number;
+    /**
+     * @type {number} valid when {@link obu_extension_flag} is set
+     */
+    temporal_id: number;
+    /**
+     * @type {number} valid when {@link obu_extension_flag} is set
+     */
+    spatial_id: number;
+    /**
+     * Absolute byte offset of the first byte of the OBU, its header included.
+     * @type {number}
+     */
+    offset: number;
+    /**
+     * Absolute byte offset of the first payload byte.
+     * @type {number}
+     */
+    payload_offset: number;
+    /**
+     * Payload length in bytes, `obu_size`.
+     * @type {number}
+     */
+    payload_size: number;
+    /**
+     * Absolute byte offset one past the last byte of the OBU.
+     * @returns {number}
+     */
+    get end(): number;
+}
+//# sourceMappingURL=ObuHeader.d.ts.map

package/src/avif/native/av1/obu/ObuHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObuHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/avif/native/av1/obu/ObuHeader.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH;IACI;;OAEG;IACH,UAFU,MAAM,CAEH;IAEb;;OAEG;IACH,oBAFU,MAAM,CAEO;IAEvB;;OAEG;IACH,oBAFU,MAAM,CAEO;IAEvB;;OAEG;IACH,aAFU,MAAM,CAEA;IAEhB;;OAEG;IACH,YAFU,MAAM,CAED;IAEf;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,kBAEC;CACJ"}