Av

-------

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`).

-------

Features:

- Add a `make_writable` method to `Frame` instances (:issue:`1414`).
- Use `av_guess_sample_aspect_ratio` to report sample and display aspect ratios.

Fixes:

- Fix a crash when assigning an `AudioLayout` to `AudioCodecContext.layout` (:issue:`1434`).
- Remove a circular reference which caused `AudioSampler` to occupy memory until garbage collected (:issue:`1429`).
- Fix more type stubs, remove incorrect `__init__.pyi`.

-------

Features:

- Build binary wheels with webp support.
- Allow disabling logs, disable logs by default.
- Add bitstream filters by :gh-user:`skeskinen` in (:pr:`1379` :issue:`1375`).
- Expose CodecContext flush_buffers by :gh-user:`skeskinen` in (:pr:`1382`).

Fixes:

- Fix type stubs, add missing type stubs.
- Add S12M_TIMECODE by :gh-user:`WyattBlue` in (:pr:`1381`).
- Subtitle.text now returns bytes by :gh-user:`WyattBlue` in (:pr:`1398`).
- Allow packet.duration to be writable by :gh-user:`WyattBlue` in (:pr:`1399`).
- Remove deprecated `VideoStream.frame_rate` by :gh-user:`WyattBlue` in (:pr:`1351`).
- Build with Arm for PyPy now by :gh-user:`WyattBlue` in (:pr:`1395`).
- Fix 1378 by :gh-user:`WyattBlue` in (:pr:`1400`).
- setup.py: use PKG_CONFIG env var to get the pkg-config to use by :gh-user:`Artturin` in (:pr:`1387`).

-------

Major:

- Add type hints.
- Update FFmpeg to 6.1.1 for the binary wheels.
- Update libraries for the binary wheels (notably dav1d to 1.4.1).
- Deprecate VideoCodecContext.gop_size for decoders by :gh-user:`JoeSchiff` in (:pr:`1256`).
- Deprecate frame.index by :gh-user:`JoeSchiff` in (:pr:`1218`).

Features:

- Allow using pathlib.Path for av.open by :gh-user:`WyattBlue` in (:pr:`1231`).
- Add `max_b_frames` property to CodecContext by :gh-user:`davidplowman` in (:pr:`1119`).
- Add `encode_lazy` method to CodecContext by :gh-user:`rawler` in (:pr:`1092`).
- Add `color_range` to CodecContext/Frame by :gh-user:`johanjeppsson` in (:pr:`686`).
- Set `time_base` for AudioResampler by :gh-user:`daveisfera` in (:issue:`1209`).
- Add support for ffmpeg's AVCodecContext::delay by :gh-user:`JoeSchiff` in (:issue:`1279`).
- Add `color_primaries`, `color_trc`, `colorspace` to VideoStream by :gh-user:`WyattBlue` in (:pr:`1304`).
- Add `bits_per_coded_sample` to VideoCodecContext by :gh-user:`rvanlaar` in (:pr:`1203`).
- AssSubtitle.ass now returns as bytes by :gh-user:`WyattBlue` in (:pr:`1333`).
- Expose DISPLAYMATRIX side data by :gh-user:`hyenal` in (:pr:`1249`).

Fixes:

- Convert deprecated Cython extension class properties to decorator syntax by :gh-user:`JoeSchiff`.
- Check None packet when setting time_base after decode by :gh-user:`philipnbbc` in (:pr:`1281`).
- Remove deprecated `Buffer.to_bytes` by :gh-user:`WyattBlue` in (:pr:`1286`).
- Remove deprecated `Packet.decode_one` by :gh-user:`WyattBlue` in (:pr:`1301`).