Av

-------

Features:

- Add hardware decoding by :gh-user:`matthewlai` and :gh-user:`WyattBlue` in (:pr:`1685`).
- Add ``Stream.disposition`` and ``Disposition`` enum by :gh-user:`WyattBlue` in (:pr:`1720`).
- Add ``VideoFrame.rotation`` by :gh-user:`lgeiger` in (:pr:`1675`).
- Support grayf32le and gbrapf32le in numpy convertion by :gh-user:`robinechuca` in (:pr:`1712`).
- Support yuv[a]p16 formats in numpy convertion by :gh-user:`robinechuca` in (:pr:`1722`).

-------

Fixes:

- Include header files in source distribution by :gh-user:`hmaarrfk` in (:pr:`1662`).
- Cleanup ``AVStream.side_data`` leftovers by :gh-user:`lgeiger` in (:pr:`1674`).
- Address :issue:`1663` by :gh-user:`WyattBlue`.
- Make ``mp3`` work with ``OutputContainer.add_stream_from_template()``.

-------

Major:

- Drop FFmpeg 6.
- Drop support for MacOS <11 in our binary wheels.
- Deleted PyAV's custom Enum class in favor of Python's standard Enums.
- Remove ``CodecContext.close()`` and ``Stream.side_data`` because it's deprecated in ffmpeg.
- Remove ``AVError`` alias (use ``FFmpegError`` directly instead).
- Remove the `template` arg from ``OutputContainer.add_stream()``.

Features:

- Add ``OutputContainer.add_stream_from_template()`` by :gh-user:`WyattBlue` and :gh-user:`cdce8p`.
- Add ``OutputContainer.add_data_stream()`` by :gh-user:`WyattBlue`.
- Add ``filter.loudnorm.stats()`` function that returns the stats of loudnorm for 2-pass filtering by :gh-user:`WyattBlue`.
- Add ``qmin`` and ``qmax`` parameters to the ``VideoCodecContext`` by :gh-user:`davidplowman` in (:pr:`1618`).
- Allow the profile of a codec to be set as well as queried by :gh-user:`davidplowman` in (:pr:`1625`).

Fixes:

- Make ``VideoFrame.from_numpy_buffer()`` support buffers with padding by :gh-user:`davidplowman` in (:pr:`1635`).
- Correct ``Colorspace``'s lowercase enums.
- Updated ``sidedata.Type`` enum.
- Ensure streams in StreamContainer are released. Fixes :issue:`1599`.

-------

Features:

- Allow passing Python objects around using `Frame.opaque` and `Packet.opaque` by :gh-user:`CarlosRDomin` and :gh-user:`WyattBlue` in (:pr:`1533`).
- Allow extradata to be set by encoders by :gh-user:`daveisfera` in (:pr:`1526`).
- Add getting ffmpeg version info string by :gh-user:`hmaarrfk` in (:pr:`1564`).

Fixes:

- Remove the `deprecation` module in anticipation of `PEP 702 <https://peps.python.org/pep-0702/>`_.
- Add type stubs to previously unannotated API sections.
- Improve type stubs for both `mypy` and `mypy --strict`.
- Permit only setting `time_base` with a Fraction, as mypy is unable to respect different types in getters vs setters.
- Declare `write_packet` function as const by :gh-user:`hmaarrfk` in (:pr:`1517`).

-------

Major:

- Drop FFmpeg 5, Support FFmpeg 7.
- Drop Python 3.8, Support Python 3.13.
- Update FFmpeg to 7.0.2 for the binary wheels.
- Disallow initializing an AudioLayout object with an int.
- Disallow accessing gop_size, timebase as a decoder (Raised deprecation warning before).
- Remove `ticks_per_frame` property because it was deprecated in FFmpeg.

Features:

- Add AttachmentStream class.
- Add `best()` method to StreamContainer.
- Add `set_audio_frame_size()` method to Graph object.
- Add `nb_channels` property to AudioLayout object.
- Add `from_bytes()` method to VideoFrame object.

Fixes:

- Fix VideoCC's repl breaking when `self._format` is None.
- Fix getting `pix_fmt` property when VideoCC's `self._format` is None.

-------

Features:

- Support libav's `av_log_set_level` by :gh-user:`materight` in (:pr:`1448`).
- Add Graph.link_nodes by :gh-user:`WyattBlue` in (:pr:`1449`).
- Add default codec properties by :gh-user:`WyattBlue` in (:pr:`1450`).
- Remove the xvid and ass packages in ffmpeg binaries because they were unused by :gh-user:`WyattBlue` in (:pr:`1462`).
- Add supported_codecs property to OutputContainer by :gh-user:`WyattBlue` in (:pr:`1465`).
- Add text and dialogue property to AssSubtitle, remove TextSubtitle by :gh-user:`WyattBlue` in (:pr:`1456`).

Fixes:

- Include libav headers in final distribution by :gh-user:`materight` in (:pr:`1455`).
- Fix segfault when calling subtitle_stream.decode() by :gh-user:`WyattBlue` in (:pr:`1460`).
- flushing subtitle decoder requires a new uninitialized packet by :gh-user:`moonsikpark` in (:pr:`1461`).
- Set default color range for VideoReformatter.format() by :gh-user:`elxy` in (:pr:`1458`).
- Resampler: format, layout accepts `str` `int` too by :gh-user:`WyattBlue` in (:pr:`1446`).