@woosh/meep-engine 3.9.0 → 3.11.0

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

@@ -0,0 +1,23 @@
+/**
+ * Read one OBU header from `bytes` at `offset` into `header`.
+ *
+ * `available` is how many bytes remain in the enclosing unit. It is only consulted when the OBU
+ * carries no size field, in which case the specification defines the payload as running to the end
+ * of the enclosing unit — which is how AVIF item payloads and some low-overhead streams are laid
+ * out. When a size field is present it wins, and a size that would run past `available` is rejected
+ * rather than clamped.
+ *
+ * @param {Uint8Array} bytes
+ * @param {number} offset absolute offset of the OBU
+ * @param {number} available bytes remaining from `offset` in the enclosing unit
+ * @param {ObuHeader} header filled in place
+ * @param {BitReader} reader scratch, so a walk allocates nothing
+ * @returns {ObuHeader} `header`
+ * @see AV1 spec 5.3.1 "General OBU syntax", 5.3.2 "OBU header syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function parse_obu_header(bytes: Uint8Array, offset: number, available: number, header: ObuHeader, reader: BitReader): ObuHeader;
+import { BitReader } from "../../bitstream/BitReader.js";
+//# sourceMappingURL=parse_obu_header.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse_obu_header.d.ts","sourceRoot":"","sources":["../../../../../../src/avif/native/av1/obu/parse_obu_header.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wCAXW,UAAU,UACV,MAAM,aACN,MAAM,6BAEN,SAAS,aAqDnB;0BApEyB,8BAA8B"}

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

@@ -0,0 +1,69 @@
+import { BitReader } from "../../bitstream/BitReader.js";
+
+/**
+ * Read one OBU header from `bytes` at `offset` into `header`.
+ *
+ * `available` is how many bytes remain in the enclosing unit. It is only consulted when the OBU
+ * carries no size field, in which case the specification defines the payload as running to the end
+ * of the enclosing unit — which is how AVIF item payloads and some low-overhead streams are laid
+ * out. When a size field is present it wins, and a size that would run past `available` is rejected
+ * rather than clamped.
+ *
+ * @param {Uint8Array} bytes
+ * @param {number} offset absolute offset of the OBU
+ * @param {number} available bytes remaining from `offset` in the enclosing unit
+ * @param {ObuHeader} header filled in place
+ * @param {BitReader} reader scratch, so a walk allocates nothing
+ * @returns {ObuHeader} `header`
+ * @see AV1 spec 5.3.1 "General OBU syntax", 5.3.2 "OBU header syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function parse_obu_header(bytes, offset, available, header, reader) {
+    if (available < 1) {
+        throw new Error(`OBU at ${offset} has no header byte`);
+    }
+
+    reader.init(bytes, offset, available);
+
+    if (reader.f(1) !== 0) {
+        throw new Error(`OBU at ${offset} has its forbidden bit set`);
+    }
+
+    header.obu_type = reader.f(4);
+    header.obu_extension_flag = reader.f(1);
+    header.obu_has_size_field = reader.f(1);
+
+    // obu_reserved_1bit. The specification requires it to be zero but decoders are told to ignore
+    // its value, so it is read and discarded rather than validated.
+    reader.f(1);
+
+    if (header.obu_extension_flag === 1) {
+        header.temporal_id = reader.f(3);
+        header.spatial_id = reader.f(2);
+
+        reader.f(3);
+    } else {
+        header.temporal_id = 0;
+        header.spatial_id = 0;
+    }
+
+    let payload_size;
+
+    if (header.obu_has_size_field === 1) {
+        payload_size = reader.leb128();
+    } else {
+        payload_size = available - 1 - header.obu_extension_flag;
+    }
+
+    header.offset = offset;
+    header.payload_offset = offset + reader.position_in_bits / 8;
+    header.payload_size = payload_size;
+
+    if (payload_size < 0 || header.payload_offset + payload_size > offset + available) {
+        throw new Error(`OBU at ${offset} declares a ${payload_size} byte payload that runs past the end of its container`);
+    }
+
+    return header;
+}

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

@@ -0,0 +1,17 @@
+/**
+ * Parse a sequence header OBU payload into `header`.
+ *
+ * `operating_point` selects which operating point this decode targets; for a still image there is
+ * only ever one, and the AVIF `a1op` property is the only thing that would ever ask for another.
+ *
+ * @param {BitReader} reader positioned at the start of the payload
+ * @param {SequenceHeader} header filled in place
+ * @param {number} [operating_point]
+ * @returns {SequenceHeader} `header`
+ * @see AV1 spec 5.5.1 "General sequence header OBU syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function parse_sequence_header(reader: BitReader, header: SequenceHeader, operating_point?: number): SequenceHeader;
+//# sourceMappingURL=parse_sequence_header.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse_sequence_header.d.ts","sourceRoot":"","sources":["../../../../../../src/avif/native/av1/obu/parse_sequence_header.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;GAcG;AACH,mGAPW,MAAM,kBAsKhB"}

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

@@ -0,0 +1,263 @@
+import {
+    CP_BT_709,
+    CP_UNSPECIFIED,
+    CSP_UNKNOWN,
+    MC_IDENTITY,
+    MC_UNSPECIFIED,
+    SELECT_INTEGER_MV,
+    SELECT_SCREEN_CONTENT_TOOLS,
+    TC_SRGB,
+    TC_UNSPECIFIED
+} from "../tables/av1_symbols.js";
+import { MAX_OPERATING_POINTS } from "./SequenceHeader.js";
+
+/**
+ * Parse a sequence header OBU payload into `header`.
+ *
+ * `operating_point` selects which operating point this decode targets; for a still image there is
+ * only ever one, and the AVIF `a1op` property is the only thing that would ever ask for another.
+ *
+ * @param {BitReader} reader positioned at the start of the payload
+ * @param {SequenceHeader} header filled in place
+ * @param {number} [operating_point]
+ * @returns {SequenceHeader} `header`
+ * @see AV1 spec 5.5.1 "General sequence header OBU syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function parse_sequence_header(reader, header, operating_point = 0) {
+    header.seq_profile = reader.f(3);
+
+    if (header.seq_profile > 2) {
+        throw new Error(`seq_profile ${header.seq_profile} is not defined by AV1`);
+    }
+
+    header.still_picture = reader.f(1);
+    header.reduced_still_picture_header = reader.f(1);
+
+    if (header.reduced_still_picture_header === 1) {
+        header.timing_info_present_flag = 0;
+        header.decoder_model_info_present_flag = 0;
+        header.initial_display_delay_present_flag = 0;
+        header.operating_points_cnt_minus_1 = 0;
+        header.operating_point_idc[0] = 0;
+        header.seq_level_idx[0] = reader.f(5);
+        header.seq_tier[0] = 0;
+        header.decoder_model_present_for_this_op[0] = 0;
+        header.initial_display_delay_present_for_this_op[0] = 0;
+    } else {
+        header.timing_info_present_flag = reader.f(1);
+
+        if (header.timing_info_present_flag === 1) {
+            header.num_units_in_display_tick = reader.f(32);
+            header.time_scale = reader.f(32);
+            header.equal_picture_interval = reader.f(1);
+
+            if (header.equal_picture_interval === 1) {
+                header.num_ticks_per_picture_minus_1 = reader.uvlc();
+            }
+
+            header.decoder_model_info_present_flag = reader.f(1);
+
+            if (header.decoder_model_info_present_flag === 1) {
+                header.buffer_delay_length_minus_1 = reader.f(5);
+                header.num_units_in_decoding_tick = reader.f(32);
+                header.buffer_removal_time_length_minus_1 = reader.f(5);
+                header.frame_presentation_time_length_minus_1 = reader.f(5);
+            }
+        } else {
+            header.decoder_model_info_present_flag = 0;
+        }
+
+        header.initial_display_delay_present_flag = reader.f(1);
+        header.operating_points_cnt_minus_1 = reader.f(5);
+
+        if (header.operating_points_cnt_minus_1 + 1 > MAX_OPERATING_POINTS) {
+            throw new Error(`sequence header declares ${header.operating_points_cnt_minus_1 + 1} operating points`);
+        }
+
+        for (let i = 0; i <= header.operating_points_cnt_minus_1; i++) {
+            header.operating_point_idc[i] = reader.f(12);
+            header.seq_level_idx[i] = reader.f(5);
+
+            header.seq_tier[i] = header.seq_level_idx[i] > 7 ? reader.f(1) : 0;
+
+            if (header.decoder_model_info_present_flag === 1) {
+                header.decoder_model_present_for_this_op[i] = reader.f(1);
+
+                if (header.decoder_model_present_for_this_op[i] === 1) {
+                    const n = header.buffer_delay_length_minus_1 + 1;
+
+                    header.decoder_buffer_delay[i] = reader.f(n);
+                    header.encoder_buffer_delay[i] = reader.f(n);
+                    header.low_delay_mode_flag[i] = reader.f(1);
+                }
+            } else {
+                header.decoder_model_present_for_this_op[i] = 0;
+            }
+
+            if (header.initial_display_delay_present_flag === 1) {
+                header.initial_display_delay_present_for_this_op[i] = reader.f(1);
+
+                if (header.initial_display_delay_present_for_this_op[i] === 1) {
+                    header.initial_display_delay_minus_1[i] = reader.f(4);
+                }
+            }
+        }
+    }
+
+    header.operating_point = operating_point <= header.operating_points_cnt_minus_1 ? operating_point : 0;
+    header.operating_point_idc_selected = header.operating_point_idc[header.operating_point];
+
+    header.frame_width_bits_minus_1 = reader.f(4);
+    header.frame_height_bits_minus_1 = reader.f(4);
+    header.max_frame_width_minus_1 = reader.f(header.frame_width_bits_minus_1 + 1);
+    header.max_frame_height_minus_1 = reader.f(header.frame_height_bits_minus_1 + 1);
+
+    header.frame_id_numbers_present_flag = header.reduced_still_picture_header === 1 ? 0 : reader.f(1);
+
+    if (header.frame_id_numbers_present_flag === 1) {
+        header.delta_frame_id_length_minus_2 = reader.f(4);
+        header.additional_frame_id_length_minus_1 = reader.f(3);
+    }
+
+    header.use_128x128_superblock = reader.f(1);
+    header.enable_filter_intra = reader.f(1);
+    header.enable_intra_edge_filter = reader.f(1);
+
+    if (header.reduced_still_picture_header === 1) {
+        header.enable_interintra_compound = 0;
+        header.enable_masked_compound = 0;
+        header.enable_warped_motion = 0;
+        header.enable_dual_filter = 0;
+        header.enable_order_hint = 0;
+        header.enable_jnt_comp = 0;
+        header.enable_ref_frame_mvs = 0;
+        header.seq_force_screen_content_tools = SELECT_SCREEN_CONTENT_TOOLS;
+        header.seq_force_integer_mv = SELECT_INTEGER_MV;
+        header.order_hint_bits = 0;
+    } else {
+        header.enable_interintra_compound = reader.f(1);
+        header.enable_masked_compound = reader.f(1);
+        header.enable_warped_motion = reader.f(1);
+        header.enable_dual_filter = reader.f(1);
+        header.enable_order_hint = reader.f(1);
+
+        if (header.enable_order_hint === 1) {
+            header.enable_jnt_comp = reader.f(1);
+            header.enable_ref_frame_mvs = reader.f(1);
+        } else {
+            header.enable_jnt_comp = 0;
+            header.enable_ref_frame_mvs = 0;
+        }
+
+        header.seq_choose_screen_content_tools = reader.f(1);
+
+        header.seq_force_screen_content_tools = header.seq_choose_screen_content_tools === 1
+            ? SELECT_SCREEN_CONTENT_TOOLS
+            : reader.f(1);
+
+        if (header.seq_force_screen_content_tools > 0) {
+            header.seq_choose_integer_mv = reader.f(1);
+
+            header.seq_force_integer_mv = header.seq_choose_integer_mv === 1
+                ? SELECT_INTEGER_MV
+                : reader.f(1);
+        } else {
+            header.seq_force_integer_mv = SELECT_INTEGER_MV;
+        }
+
+        if (header.enable_order_hint === 1) {
+            header.order_hint_bits_minus_1 = reader.f(3);
+            header.order_hint_bits = header.order_hint_bits_minus_1 + 1;
+        } else {
+            header.order_hint_bits = 0;
+        }
+    }
+
+    header.enable_superres = reader.f(1);
+    header.enable_cdef = reader.f(1);
+    header.enable_restoration = reader.f(1);
+
+    parse_color_config(reader, header);
+
+    header.film_grain_params_present = reader.f(1);
+
+    return header;
+}
+
+/**
+ * @param {BitReader} reader
+ * @param {SequenceHeader} header
+ * @see AV1 spec 5.5.2 "Color config syntax"
+ */
+function parse_color_config(reader, header) {
+    header.high_bitdepth = reader.f(1);
+
+    if (header.seq_profile === 2 && header.high_bitdepth === 1) {
+        header.twelve_bit = reader.f(1);
+        header.bit_depth = header.twelve_bit === 1 ? 12 : 10;
+    } else {
+        header.twelve_bit = 0;
+        header.bit_depth = header.high_bitdepth === 1 ? 10 : 8;
+    }
+
+    header.mono_chrome = header.seq_profile === 1 ? 0 : reader.f(1);
+    header.num_planes = header.mono_chrome === 1 ? 1 : 3;
+
+    header.color_description_present_flag = reader.f(1);
+
+    if (header.color_description_present_flag === 1) {
+        header.color_primaries = reader.f(8);
+        header.transfer_characteristics = reader.f(8);
+        header.matrix_coefficients = reader.f(8);
+    } else {
+        header.color_primaries = CP_UNSPECIFIED;
+        header.transfer_characteristics = TC_UNSPECIFIED;
+        header.matrix_coefficients = MC_UNSPECIFIED;
+    }
+
+    if (header.mono_chrome === 1) {
+        header.color_range = reader.f(1);
+        header.subsampling_x = 1;
+        header.subsampling_y = 1;
+        header.chroma_sample_position = CSP_UNKNOWN;
+        header.separate_uv_delta_q = 0;
+
+        return;
+    }
+
+    if (header.color_primaries === CP_BT_709
+        && header.transfer_characteristics === TC_SRGB
+        && header.matrix_coefficients === MC_IDENTITY) {
+        // sRGB signalling implies full range 4:4:4 and codes none of it
+        header.color_range = 1;
+        header.subsampling_x = 0;
+        header.subsampling_y = 0;
+    } else {
+        header.color_range = reader.f(1);
+
+        if (header.seq_profile === 0) {
+            header.subsampling_x = 1;
+            header.subsampling_y = 1;
+        } else if (header.seq_profile === 1) {
+            header.subsampling_x = 0;
+            header.subsampling_y = 0;
+        } else if (header.bit_depth === 12) {
+            header.subsampling_x = reader.f(1);
+            header.subsampling_y = header.subsampling_x === 1 ? reader.f(1) : 0;
+        } else {
+            header.subsampling_x = 1;
+            header.subsampling_y = 0;
+        }
+
+        if (header.subsampling_x === 1 && header.subsampling_y === 1) {
+            header.chroma_sample_position = reader.f(2);
+        } else {
+            header.chroma_sample_position = CSP_UNKNOWN;
+        }
+    }
+
+    header.separate_uv_delta_q = reader.f(1);
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Emit an uncompressed frame header for a key frame.
+ *
+ * The mirror of {@link parse_frame_header}, restricted to what that accepts. Header fields the
+ * syntax derives are recomputed by the reader and are not written.
+ *
+ * @param {BitWriter} writer
+ * @param {SequenceHeader} sequence
+ * @param {FrameHeader} header
+ * @see AV1 spec 5.9.2 "Uncompressed header syntax"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function write_frame_header(writer: BitWriter, sequence: SequenceHeader, header: FrameHeader): void;
+//# sourceMappingURL=write_frame_header.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write_frame_header.d.ts","sourceRoot":"","sources":["../../../../../../src/avif/native/av1/obu/write_frame_header.js"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;GAaG;AACH,2GAoFC"}