Skip to content

Media Playback

Exaplay 3 is built for smooth, glitch-free playback of large media files at high frame rates.

Decode pipeline diagnostics — File I/O → Demux → GPU Decode → Compose → Output

Supported Formats

FormatContainerNotes
HAPMOV, AVIGPU-decoded; recommended for 4K+
HAP QMOV, AVIHigher quality HAP; 2× file size
HAP AlphaMOV, AVIHAP with transparency channel
HAP RMOV, AVIBC7 / BPTC variant; high-quality GPU-decoded RGB(A) (new in 3.2)
NotchLCMOVHigh-quality with alpha; GPU-decoded
H.264 / AVCMP4, MOVHardware-accelerated via QuickSync; High 4:4:4 Predictive profile via software fallback
H.265 / HEVCMP4, MOVHardware-accelerated via QuickSync; 4:4:4 chroma (RExt) via software fallback
Apple ProResMOVVia Medialooks decoder (Windows)
PNG / JPEG / BMPStill images
TIFF / PSDHigh-bit-depth stills
WAV / AAC / MP3Audio-only

Format Families Explained

  • HAP family (HAP, HAP Q, HAP Alpha, HAP R) — GPU-decoded intra-frame codecs. Each frame is stored as a GPU-native compressed texture, so decoding is offloaded to the graphics card and CPU load stays low even at 4K+ and high frame rates. HAP is the baseline, HAP Q trades file size for higher quality, HAP Alpha adds a transparency channel, and HAP R is the BC7/BPTC variant for high-quality RGB(A). This is the recommended family for demanding playback.
  • NotchLC — a high-quality GPU-decoded codec with an alpha channel, well suited to content authored in Notch and to overlays/transparency.
  • H.264 / H.265 — long-GOP delivery codecs decoded on the GPU's fixed-function decoder (NVDEC, QuickSync, AMD AMF, or DXVA). Efficient on disk, but seeking and very high resolutions are heavier than with the intra-frame HAP family; uncommon profiles fall back to software. See the encoding tips below.
  • Apple ProRes — decoded via the Medialooks decoder on Windows; convenient for interchange with edit/finishing workflows.
  • Image stills (PNG, JPEG, BMP, TIFF, PSD) — single frames; TIFF/PSD carry high bit depth. Useful for logos, backgrounds, and slates.
  • Audio (WAV, AAC, MP3) — audio-only assets that mix into the audio path like any clip's audio track.

Codec Recommendations

For the best performance with 4K content:

  1. HAP Q — highest quality, GPU-decoded, no CPU bottleneck
  2. NotchLC — excellent for content with transparency
  3. H.264 with hardware decode — good quality, uses the GPU's fixed-function decoder (NVDEC, QuickSync, AMD AMF, or DXVA)

Avoid software-decoded codecs (standard H.264 without hardware acceleration, MPEG-2) for streams above 1080p/60.

H.264 Encoding Tips for Best Playback

When encoding H.264 content for Exaplay, use these settings for optimal decode performance:

  • Profile: High (4:2:0 chroma) — universally supported by hardware decoders
  • B-frames: 0–2 — fewer B-frames reduce decode latency
  • Keyframe interval: 1–2 seconds — enables fast seeking and buffer fill
  • Bitrate mode: CBR or capped VBR — avoids storage throughput spikes

See also: Medialooks H.264 encoding options

Looping

Set the Loop property in the Inspector to:

ValueBehaviour
OncePlay once and stop on the last frame
LoopLoop the entire clip
Ping-pongPlay forward then reverse, continuously
∞ InfiniteLoop without a defined end time

Trimming In and Out Points

In the Inspector, Start and End set the in and out points within the source file. Only the trimmed region is decoded and played — no pre-buffering of unused frames.

Performance Diagnostics

Use the built-in Performance Diagnostics panel (accessible via the header toolbar) to monitor:

  • Engine FPS (green ≥ 57 fps, yellow 48–57 fps, red < 48 fps)
  • Per-clip buffer health and decode time
  • CPU and RAM utilisation

Offline Media

If a media file is missing on load, its clip shows a red Missing Media badge. Re-link it by right-clicking the clip and choosing Re-link Media.

Exaplay 3 User Documentation