Skip to content
jeanlf edited this page Jan 15, 2020 · 12 revisions

HOME » Filters » Video output

Video output

Register name used to load filter: vout

This filter displays a single visual pid in a window.
The window is created unless a window handle (HWND, xWindow, etc) is indicated in the config file ( [Temp]OSWnd=ptr).
The output uses GPAC video output module indicated in drv option or in the config file (see GPAC core help).
The video output module can be further configured (see GPAC core help).
The filter can use openGL or 2D blitter of the graphics card, depending on the OS support.
The filter can be used do dump frames as written on the grapics card.
In this case, the window is not visible and only the listed frames are drawn to the GPU.
The pixel format of the dumped frame is always RGB in OpenGL and matches the video backbuffer format in 2D mode.


drv (string): video driver name
vsync (boolean, default: true): enable video screen sync
drop (boolean, default: false): enable droping late frames
disp (enum, default: gl): display mode

  • gl: OpenGL
  • pbo: OpenGL with PBO
  • blit: 2D hardware blit
  • soft: software blit

start (number, default: 0.0): set playback start offset. Negative value means percent of media dur with -1 <=> dur
dur (64-bit fraction, default: 0): only play the specified duration
speed (number, default: 1.0): set playback speed when vsync is on. If speed is negative and start is 0, start is set to -1
hold (number, default: 1.0): number of seconds to hold display for single-frame streams. A negative value force a hold on last frame for single or multi-frames streams
linear (boolean, default: false): use linear filtering instead of nearest pixel for GL mode
back (unsigned int, default: 0x808080): back color for transparent images
wsize (vec2d int, default: -1x-1): default init window size. 0x0 holds the window size of the first frame. Negative values indicate video media size
wpos (vec2d int, default: -1x-1): default position (0,0 top-left)
delay (fraction, default: 0, updatable): set delay, positive value displays after audio clock
hide (boolean, default: false): hide output window
fullscreen (boolean, default: false): use fullcreen
buffer (unsigned int, default: 100): set buffer in ms
dumpframes (uint list): ordered list of frames to dump, 1 being first frame - see filter help. Special value 0 means dump all frames.
out (string, default: dump): radical of dump frame filenames. If no extension is provided, frames are exported as $OUT_%d.PFMT.

HOME » Filters

GPAC Configuration

Configuration File
Global Options

Filters Overview

General Filters Concepts
gpac General Usage
Built-in Properties

Filters Help

Inspect packets (inspect)
Probe source (probe)
Compositor (compositor)
ISOBMFF/QT demuxer (mp4dmx)
MPEG-4 BIFS decoder (bifsdec)
MPEG-4 OD decoder (odfdec)
File input (fin)
BT/XMT/X3D loader (btplay)
HTTP input (httpin)
SVG loader (svgplay)
JPG/J2K/PNG/BMP reframer (rfimg)
PNG/JPG decoder (imgdec)
ADTS reframer (rfadts)
LATM reframer (rflatm)
MP3 reframer (rfmp3)
FAAD decoder (faad)
MAD decoder (maddec)
XVid decoder (xviddec)
OpenJPEG2000 decoder (j2kdec)
AC3 reframer (rfac3)
A52 decoder (a52dec)
AMR/EVRC reframer (rfamr)
OGG demuxer (oggdmx)
Vorbis decoder (vorbisdec)
Theora decoder (theoradec)
MPEG-2 TS demuxer (m2tsdmx)
UDP/TCP input (sockin)
OpenSVC decoder (osvcdec)
VideoToolBox decoder (vtbdec)
MPEG-4 LASeR decoder (lsrdec)
SAF demuxer (safdmx)
MPEG-DASH and HLS client (dashin)
CENC decryptor (cdcrypt)
CENC encryptor (cecrypt)
ISOBMFF/QT muxer (mp4mx)
QCP reframer (rfqcp)
H263 reframer (rfh263)
M1V/M2V/M4V reframer (rfmpgvid)
NHNT reader (nhntr)
NHML parser (nhmlr)
AVC/HEVC reframer (rfnalu)
MPEG PS demuxer (m2psdmx)
AVI demuxer (avidmx)
Subtitle loader (txtin)
TTXT/TX3G decoder (ttxtdec)
WebVTT decoder (vttdec)
RTP/RTSP/SDP input (rtpin)
File output (fout)
Raw AAC to LATM writer (uflatm)
ADTS writer (ufadts)
Media Reframer (reframer)
Stream to file (writegen)
AVC/HEVC to AnnexB writer (ufnalu)
QCP writer (writeqcp)
WebVTT writer (writevtt)
NHNT writer (nhntw)
NHML writer (nhmlw)
VobSub demuxer (vobsubdmx)
AVI muxer (avimx)
Audio output (aout)
M4V writer (ufm4v)
Audio resampler (resample)
Video output (vout)
Video crop (vcrop)
Video flip (vflip)
RAW video reframer (rfrawvid)
PCM reframer (rfpcm)
JPG encoder (jpgenc)
PNG encoder (pngenc)
Audio/Video rewinder (rewind)
Sources concatenator (flist)
MPEG-2 TS muxer (m2tsmx)
DASH and HLS segmenter (dasher)
HEVC tile aggregator (tileagg)
pipe input (pin)
pipe output (pout)
GSF Muxer (gsfmx)
GSF Demuxer (gsfdmx)
UDP/TCP output (sockout)
AV1/IVF/VP9 reframer (rfav1)
IVF/OBU/annexB writer (ufobu)
ATSC input (atscin)
RTP Streamer (rtpout)
RTSP Server (rtspout)
HTTP Server (httpout)
HEVC tile spliter (hevcsplit)
HEVC Tile merger (hevcmerge)
FLAC reframer (rfflac)
ProRes reframer (rfprores)
MPEG Transport Stream splitter (tssplit)
FFMPEG demuxer (ffdmx)
FFMPEG decoder (ffdec)
FFMPEG AV Capture (ffavin)
FFMPEG video rescaler (ffsws)
FFMPEG encoder (ffenc)
FFMPEG muxer (ffmx)
FFMPEG AVFilter (ffavf)
JavaScript filter (jsf)
OpenHEVC decoder (ohevcdec)

Clone this wiki locally
You can’t perform that action at this time.