rockbox/manual/plugins/h264_player.tex
David Cormier e0136bc7f4 ipod6g: add hardware H.264 video playback
Add S5L8702 VPU-B initialization, reset, bitstream input, frame output,
and cache maintenance to the iPod 6G target. Advertise it with
HAVE_HW_H264 and append a capability-gated decoder interface to the
plugin API.

Keep MP4 parsing, AAC decode and mixer output, A/V synchronization,
playback controls, resume state, and presentation in the multi-file
h264_player plugin. The target layer exposes decoder operations only.

Accept non-fragmented MP4/M4V containing Constrained Baseline H.264
through level 3.0, up to 640x480 at 30 fps, with optional AAC-LC audio.
Validate codec configuration and all sample-table relationships before
activating the hardware.

Read MP4 tables in bulk, boost the CPU while preparing them, and report
staged loading progress so long movies do not appear to hang during
startup.

Register the viewer and document its format limits and controls. The
libm4a compatibility fixes needed by video-first containers remain in
the preceding standalone change.

Tested on an iPod Classic 6G through an isolated Rolo nightly runtime:
H.264/AAC playback and M4V startup succeeded. Normal and
isolated-runtime iPod 6G builds also complete, and git diff --check is
clean.

Change-Id: I1e96c65c7d0b4231a94f602f8052f1b26d6e4a80
2026-09-13 08:07:59 -04:00

26 lines
975 B
TeX

\subsection{H.264 Player}
The H.264 Player uses a supported player's hardware video decoder to play
H.264 video from \fname{.mp4}, \fname{.m4v}, and \fname{.mov} files. It
supports H.264 Baseline Profile through level 3.0 at resolutions up to
640x480. AAC-LC audio is supported.
Select a supported file in the Rockbox \setting{File Browser} to start
playback. Playback resumes from the last saved position unless the previous
playback reached the end or the final five percent of the file.
\begin{btnmap}
\ActionWpsPlay
& Pause / Resume\\
\ActionWpsVolUp{} / \ActionWpsVolDown
& Adjust volume up / down\\
\ActionWpsSkipPrev{} / \ActionWpsSkipNext
& Seek backward / forward by 10 seconds\\
\ActionWpsMenu
& Open the H.264 Player menu\\
\ActionWpsStop
& Exit the player\\
\end{btnmap}
The player menu can resume playback or exit the player. A resume point is
saved when playback is stopped before the final five percent of the file.