Skip to content

CHANGELOG.md

Latest commit

 

History

History
118 lines (94 loc) · 7.22 KB

CHANGELOG.md

File metadata and controls

118 lines (94 loc) · 7.22 KB

Change Log

Unreleased

Changed

  • BREAKING CHANGE: sps::ScalingMatrix and pps::ScalingMatrix now store next_scale intermediate values ([u8; S]) instead of final computed scaling values ([NonZeroU8; S]). In the new representation, a 0 at position j means the list was frozen at that position (all positions from j onward are also 0). This is a more bitstream-faithful representation: it preserves the freeze point, enabling the encoder to reproduce the original delta_scale sequence exactly.
  • BREAKING CHANGE: Updated bitstream-io dependency from 2.2 to 4.9 and altered rbsp::BitRead trait to match its conventions.
  • BREAKING CHANGE: Profile::from_profile_idc() now accepts ConstraintFlags to distinguish constrained/intra profile variants. Add Profile enum variants: ConstrainedBaseline, ProgressiveHigh, ConstrainedHigh, High10Intra, High422Intra, High444Intra, ScalableConstrainedBaseline, ScalableConstrainedHigh, ScalableHighIntra.
  • BREAKING CHANGE: SliceHeader::from_bits() now takes an additional header_extension: Option<&NalHeaderExtension> parameter. Pass None for standard AVC NAL types (1/5). For MVC NAL types (20/21), pass the parsed extension to enable correct idr_pic_flag derivation and MVC ref pic list modification parsing.
  • Update minimum supported Rust version from 1.81 to 1.83.

Added

  • Derive Clone and Copy for SliceFamily.
  • Add scaling list helper methods that convert stored next_scale intermediates into final ScalingList values:
    • SeqScalingMatrix::scaling_lists_4x4() / scaling_lists_8x8()
    • ChromaInfo::scaling_lists_4x4() / scaling_lists_8x8()
    • PicScalingMatrix::scaling_lists_4x4(&ChromaInfo) / scaling_lists_8x8(&ChromaInfo)
    • ScalingLists8x8Resolved enum for resolved 8x8 lists.
  • Added support for luma_weights_l1 and chroma_weights_l1 to PredWeightTable.
  • Give has_chroma_info() newer profile_idc values 118, 128, 134, 135, 138, 139, implementing SPS parse support for Multiview High, Stereo High, and related profiles.
  • Add Profile::CavlcIntra444 (profile_idc 44) and Profile::MFCHigh (profile_idc 134) enum variants.
  • Parse AvcC extension fields (chroma_format, bit_depth_luma_minus8, bit_depth_chroma_minus8, SPS extension NAL units) for High profile and above.
  • Add slice_group_change_cycle, slice_alpha_c0_offset_div2 and slice_beta_offset_div2 to SliceHeader`
  • Parse access_unit_delimiter_rbsp() (NAL type 9) via new aud::AccessUnitDelimiter.
  • Parse seq_parameter_set_extension_rbsp() (NAL type 13) via new sps_extension::SeqParameterSetExtension.
  • Parse subset_seq_parameter_set_rbsp() (NAL type 15) via new subset_sps::SubsetSps, including SVC extension (profiles 83/86) and MVC extension (profiles 118/128/134).
  • Add Context::put_subset_seq_param_set(), Context::subset_sps_by_id(), and Context::subset_sps() for managing subset SPS state.
  • Add ChromaInfo::chroma_array_type() helper.
  • Added support for user_data_unregistered() SEI syntax
  • Added support for recovery_point() SEI syntax (payloadType 6).
  • Parse prefix_nal_unit_rbsp() (NAL type 14) via new prefix::PrefixNalUnit, including SVC prefix_nal_unit_svc() body and MVC (empty body).
  • Add NalHeaderExtension, NalHeaderMvcExtension, NalHeaderSvcExtension types and parse_nal_header_extension() for parsing the 3-byte NAL unit header extension used by NAL types 14, 20, and 21.
  • Parse MVC slice headers (NAL types 20/21) including ref_pic_list_mvc_modification() with modification_of_pic_nums_idc values 4 and 5. Add ModificationOfPicNums::SubtractViewIdx and AddViewIdx variants.
  • RBSP writing—BitWrite and BitWriter to encode RBSP streams, ByteWriter to add emulation prevention bytes.
  • Write SeqParameterSet to an RBSP stream.
  • A new PpsError::InvalidPicSizeInMapUnitsMinus1 variant

Fixed

  • Fix Profile::High444.profile_idc() returning 144 instead of the correct value 244.
  • Fix PicTiming::read_delays falling back to nal_hrd_parameters instead of vcl_hrd_parameters.
  • Fix pred_weight_table being parsed for SP slices regardless of weighted_pred_flag.
  • Fix ByteReader skipping emulation prevention byte removal for bytes beyond max_fill in a chunk.
  • Fix off-by-one error in SliceGroup::read_rectangles()
  • Fix slice_qp_delta validation to check the derived SliceQPY against [-QpBdOffsetY, 51] per spec, instead of only checking slice_qp_delta > 51.
  • Will now produce an error when parsing max_dec_frame_buffering values that are invalid at the given profile level
  • Fix missing check that the PPS pic_size_in_map_units_minus1 is within bounds

0.8.0 - 2025-01-28

Changed

  • BREAKING CHANGE: The ParamSetId type has been removed and replaced with separate PicParamSetId and SeqParamSetId types, since the allowed range of values needs to be different in these two usages.
  • BREAKING CHANGE: The rbsp::ByteReader::new constructor has been removed in favor of more explicit ByteReader::skipping_h264_header, alongside the new ByteReader::without_skip and ByteReader::skipping_bytes that are suitable for other situations or parsing H.265 streams with two-byte NAL headers.
  • BREAKING CHANGE: the rbsp::BitReaderError::ReadError has been removed; methods consistently return the variant rbsp::BitReaderError::ReadErrorFor which additionally supplies the field name.
  • BREAKING CHANGE: some methods in rbsp::BitRead have been renamed to match the bitstream-io conventions.
  • BREAKING CHANGE: updated rfc6381-codec version from 0.1 to 0.2.

Added

  • Make some fields of SliceType public.
  • Parsing of scaling lists.

Fixed

  • Fix parsing of delta_pic_order_cnt fields in SliceHeader.
  • Fix parsing of slice_group_id fields in SliceGroup (#57).
  • Fix overflow on SliceHeader.qs_y calculation by adding bounds checks on pps.pic_init_qs_minus26.

0.7.0 - 2023-05-30

Changed

  • Make PicOrderCountLsb::FieldsAbsolute field names mirror the spec, rather than doing some calculations during parsing.

Fixed

  • Fixed incorrect size calculation for PicScalingMatrix causing parsing errors for streams having pic_scaling_matrix_present_flag=1 and transform_8x8_mode_flag=1 in the PPS.

Added

  • Make some SliceHeader fields public.

0.6.0 - 2022-08-08

  • BREAKING CHANGE: major simplification of the push API.
  • Annex B parser bugfixes.

0.5.0 - 2021-06-09

  • BREAKING CHANGE: changes to error enums; switched several h264_reader::rbsp::RbspBitReader methods to return RbspBitReaderError rather than bitreader::BitReaderError.
  • bug fixes, mostly found by fuzzing.
  • API additions:
    • h264_reader::rbsp::decode_nal.
    • h264_reader::nal::sps::SeqParameterSet::rfc6381
    • h264_reader::nal::sps::SeqParameterSet::pixel_dimensions
    • exposed fields in h264_reader::nal::sps::TimingInfo
    • exposed inner u8 value of h264_reader::nal::sps::ConstraintFlags
  • removed read_ue and read_se from h264_reader::rbsp::RbspBitReader, in favor of _named variants.

0.4.0 (31 Mar 2020, 5ef73dc)

...