setVideoTransform

Sets the framing controls: a forced display aspect, magnification, and pan, mpv's video-aspect-override, video-zoom and video-pan-x/-y.

Folded into the same one-pass geometry setVideoScale drives, so it costs nothing per frame and composes with every scale mode: the aspect override reshapes the content, the mode fits it, the zoom scales the fitted rectangle about its centre, and the pan moves it by a fraction of its own drawn size. Pass VideoTransform.Identity to reset. Published as PlayerSnapshot.videoTransform.

It also turns the picture in quarter steps and mirrors it either way (#428), on top of what the file asks for, and every renderer, the subtitles, picture in picture and captureFrame follow the turn.

Throws

outside the documented ranges: aspect 0.1..10 (or null), zoom 0.25..4, pan -1..1 on each axis, all finite, and a turn of 0, 90, 180 or 270.