kivy / kivy / 27977373136

60%

Build Type

push

github

Committed by web-flow

Commit Message

Video: AVFoundation provider (macOS+IOS) + thumbnails, buffering, options, cross-platform demo (#9314)

* Video: add AVFoundation provider (macOS/iOS) + thumbnails, buffering, options on VideoBase

- New core video provider `video_avfoundation` (default on Darwin):
  Cython .pyx + Objective-C++ implementation shared between macOS and
  iOS. Zero-copy texture pipeline (IOSurface -> ANGLE pbuffer ->
  GL_TEXTURE_2D, wrapped via Texture(id=..., nofree=True)) is compiled
  when the build environment exposes ANGLE EGL headers; otherwise the
  provider falls back to a CPU memcpy path via Texture.blit_buffer.
  Thumbnails via AVAssetImageGenerator with an in-place BGRA->RGBA
  swizzle so the result blits on ANGLE/Metal as well as GL.

- VideoBase 3.0.0 surface:
  - `generate_thumbnail(filename, time)` classmethod (default: None).
  - `options` dict forwarded opaquely to providers; AVFoundation
    whitelist: `automatically_waits_to_minimize_stalling`,
    `force_cpu_copy`. Unknown keys are logged once and tolerated so
    apps can stash extra metadata in the dict.
  - `buffering` BooleanProperty + `on_buffering` event: a single
    signal that covers both the initial pre-playback wait and any
    mid-stream rebuffer (mapped to `AVPlayer.timeControlStatus` in the
    AVF provider). Mirrored on the Video widget.
  - Drive-by: add `_fps` to `VideoBase.__slots__` (latent
    AttributeError on instantiation).

- Video widget:
  - Forwards `options` to the core video and exposes the new
    `buffering` boolean.
  - `options` reclassified from `ObjectProperty` to
    `DictProperty(allownone=True)`: per-instance fresh defaults
    (no shared mutable default), validates dict-or-None at assign,
    and dispatches on top-level mutation as well as reassignment.
  - Docstring now lists the supported keys for each provider that
    consumes `options`.

- `Texture.__init__` gains `nofree=False` so externally-owned GL
  texture ids (e.g. the AVF zero-copy id) survive Kivy's... (continued)

Coverage Stats

2405 of 4866 branches covered (49.42%)

82 of 141 new or added lines in 4 files covered. (58.16%)

7 existing lines in 2 files now uncovered.

23803 of 39404 relevant lines covered (60.41%)

1.45 hits per line