filters_properties

Warning

GPAC's wiki has moved to wiki.gpac.io.

This github wiki will no longer be updated.

You can contribute to GPAC's documentation here.

GPAC Built-in properties

Built-in property types

Name	Description
sint	signed 32 bit integer
uint	unsigned 32 bit integer
lsint	signed 64 bit integer
luint	unsigned 32 bit integer
bool	boolean
frac	32/32 bit fraction
lfrac	64/64 bit fraction
flt	32 bit float number
dbl	64 bit float number
v2di	2D 32-bit integer vector
v2d	2D 64-bit float vector
v3di	3D 32-bit integer vector
v4di	4D 32-bit integer vector
str	UTF-8 string
mem	data buffer
cstr	const UTF-8 string
cmem	const data buffer
ptr	32 or 64 bit pointer
strl	UTF-8 string list
uintl	unsigned 32 bit integer list
sintl	signed 32 bit integer list
v2il	2D 32-bit integer vector list
4cc	Four character code
4ccl	four-character codes list
pfmt	raw pixel format
afmt	raw audio format
cprm	color primaries, string or int value from ISO/IEC 23091-2
ctfc	color transfer characteristics, string or int value from ISO/IEC 23091-2
cmxc	color matrix coefficients, string or int value from ISO/IEC 23091-2

Built-in properties for PIDs and packets, pixel formats and audio formats

Flags can be:

D: droppable property, see GSF multiplexer filter help for more info
P: property applying to packet

Name	type	Flags	Description	4CC
ID	uint		Stream ID	PIDI
ESID	uint	D	MPEG-4 ESID of PID	ESID
ItemID	uint		ID of image item in HEIF, same value as ID	ITID
ItemNumber	uint		Number (1-based) of image item in HEIF, in order of declaration in file	ITIX
TrackNumber	uint		Number (1-based) of track in order of declaration in file	PIDX
ServiceID	uint	D	ID of parent service	PSID
ClockID	uint	D	ID of clock reference PID	CKID
DependencyID	uint		ID of layer depended on	DPID
SubLayer	bool		PID is a sublayer of the stream depended on rather than an enhancement layer	DPSL
PlaybackMode	uint	D	Playback mode supported: * 0: no time control * 1: play/pause/seek,speed=1 * 2: play/pause/seek,speed>=0 * 3: play/pause/seek, reverse playback	PBKM
Scalable	bool		Scalable stream	SCAL
TileBase	bool		Tile base stream	SABT
TileID	uint		ID of the tile for hvt1/hvt2 PIDs	PTID
Language	cstr		Language code: ISO639 2/3 character code or RFC 4646	LANG
ServiceName	str	D	Name of parent service	SNAM
ServiceProvider	str	D	Provider of parent service	SPRO
StreamType	uint		Media stream type	PMST
StreamSubtype	4cc	D	Media subtype 4CC (auxiliary, pic sequence, etc ..), matches ISOM handler type	PSST
ISOMSubtype	4cc	D	ISOM media subtype 4CC (avc1 avc2...)	PIST
OrigStreamType	uint		Original stream type before encryption	POST
CodecID	uint		Codec ID (MPEG-4 OTI or ISOBMFF 4CC)	POTI
InitialObjectDescriptor	bool		PID is declared in the IOD for MPEG-4	PIOD
Unframed	bool		The media data is not framed, i.e. each packet is not a complete AU/frame or is not in internal format (e.g. annexB for avc/hevc, adts for aac)	PFRM
UnframedAU	bool		The unframed media still has correct AU boundaries: one packet is one full AU, but the packet format might not be the internal one (e.g. annexB for avc/hevc, adts for aac)	PFRF
LATM	bool		Media is unframed AAC in LATM format	LATM
Duration	lfrac		Media duration (a negative value means an estimated duration based on rate)	PDUR
NumFrames	uint	D	Number of frames in the stream	NFRM
FrameOffset	uint	D	Index of first frame in the stream (used for reporting)	FRMO
ConstantFrameSize	uint		Size of the frames for constant frame size streams	CFRS
TimeshiftDepth	frac	D	Depth of the timeshift buffer	PTSD
TimeshiftTime	dbl	D	Time in the timeshift buffer in seconds - changes are signaled through PID info (no reconfigure)	PTST
TimeshiftState	uint	D	State of timeshift buffer: 0 is OK, 1 is underflow, 2 is overflow - changes are signaled through PID info (no reconfigure)	PTSS
Timescale	uint		Media timescale (a timestamp delta of N is N/timescale seconds)	TIMS
ProfileLevel	uint	D	MPEG-4 profile and level	PRPL
DecoderConfig	mem		Decoder configuration data	DCFG
DecoderConfigEnhancement	mem		Decoder configuration data of the enhancement layer(s). Also used by 3GPP/Apple text streams to give the full sample description table used in SDP.	ECFG
DSISuperset	bool		Decoder config is a superset of previous decoder config	DCFS
DecoderConfigIndex	uint		1-based index of decoder config for ISO base media files	ICFG
SampleRate	uint		Audio sample rate	AUSR
SamplesPerFrame	uint		Number of audio sample in one coded frame	FRMS
NumChannels	uint		Number of audio channels	CHNB
BPS	uint		Number of bits per sample in compressed source	ABPS
ChannelLayout	luint		Channel Layout mask	CHLO
AudioFormat	afmt		Audio sample format	AFMT
AudioPlaybackSpeed	dbl	D	Audio playback speed, only used for audio output reconfiguration	ASPD
Delay	lsint		Delay of presentation compared to composition timestamps, in media timescale. Positive value imply holding (delaying) the stream. Negative value imply skipping the beginning of stream	MDLY
CTSShift	uint		CTS offset to apply in case of negative ctts	MDTS
SkipPriming	bool		Audio priming shall not to be removed when initializing decoding	ASKP
Width	uint		Visual Width (video / text / graphics)	WIDT
Height	uint		Visual Height (video / text / graphics)	HEIG
PixelFormat	pfmt		Pixel format	PFMT
PixelFormatWrapped	pfmt		Underlying pixel format of video stream if pixel format is external GL texture	PFMW
Stride	uint		Image or Y/alpha plane stride	VSTY
StrideUV	uint		UV plane or U/V planes stride	VSTC
BitDepthLuma	uint		Bit depth for luma components	YBPS
BitDepthChroma	uint		Bit depth for chroma components	CBPS
FPS	frac		Video framerate	VFPF
Interlaced	bool		Video is interlaced	VILC
SAR	frac		Sample (i.e. pixel) aspect ratio	PSAR
MaxWidth	uint		Maximum width (video / text / graphics) of all enhancement layers	MWID
MaxHeight	uint		Maximum height (video / text / graphics) of all enhancement layers	MHEI
ZOrder	sint		Z-order of the video, from 0 (first) to max int (last)	VZIX
TransX	sint		Horizontal translation of the video (positive towards right)	VTRX
TransY	sint		Vertical translation of the video (positive towards up)	VTRY
TransXRight	sint		Horizontal offset of the video from right (positive towards right), for cases where reference width is unknown	VTRx
TransYTop	sint		Vertical translation of the video (0 is top, positive towards down), for cases where reference height is unknown	VTRy
Hidden	bool		PID is hidden in visual/audio rendering	HIDE
CropOrigin	v2di		Position in source window, X,Y indicate coordinates in source (0,0 for top-left)	VCXY
OriginalSize	v2di		Original resolution of video	VOWH
SRD	v4di		Position and size of the video in the referential given by SRDRef	SRD
SRDRef	v2di		Width and Height of the SRD referential	SRDR
SRDMap	uintl		Mapping of input videos in reconstructed video, expressed as {Ox,Oy,Ow,Oh,Dx,Dy,Dw,Dh} per input, with: * Ox,Oy,Ow,Oh: position and size of the input video (usually matching its `SRD` property), expressed in the output referential given by `SRDRef` * Dx,Dy,Dw,Dh: Position and Size of the input video in the reconstructed output, expressed in the output referential given by `SRDRef`	SRDM
Alpha	bool		Video in this PID is an alpha map	VALP
Mirror	uint		Mirror mode (as bit mask with flags 0: no mirror, 1: along Y-axis, 2: along X-axis)	VMIR
Rotate	uint		Video rotation as value*90 degree anti-clockwise	VROT
ClapW	frac		Width of clean aperture in luma pixels	CLPW
ClapH	frac		Height of clean aperture in luma pixels	CLPH
ClapX	frac		Horizontal offset of clean aperture center in luma pixels, 0 at image center	CLPX
ClapY	frac		Vertical offset of clean aperture center in luma pixels, 0 at image center	CLPY
NumViews	uint		Number of views packed in a frame (top-to-bottom only)	PNBV
Bitrate	uint		Bitrate in bps	RATE
Maxrate	uint		Max bitrate in bps	MRAT
TargetRate	uint		Target bitrate in bps, used to setup encoders	TBRT
DBSize	uint		Decode buffer size in bytes	DBSZ
MediaDataSize	luint	D	Size in bytes of media data	MDSZ
DataRef	bool	D	Data referencing is possible (each compressed frame is a continuous set of bytes in source, with no transformation)	DREF
URL	str	D	URL of source	FURL
RemoteURL	str	D	Remote URL of source - used for MPEG-4 systems	RURL
RedirectURL	str	D	Redirection URL of source	RELO
SourcePath	str	D	Path of source file on file system	FSRC
MIMEType	str	D	MIME type of source	MIME
Extension	str	D	File extension of source	FEXT
Cached	bool	D	File is completely cached	CACH
DownloadRate	uint	D	Download rate of resource in bits per second - changes are signaled through PID info (no reconfigure)	DLBW
DownloadSize	luint	D	Size of resource in bytes	DLSZ
DownBytes	luint	D	Number of bytes downloaded - changes are signaled through PID info (no reconfigure)	DLBD
ByteRange	lfrac	D	Byte range of resource	FBRA
DisableProgressive	uint		Some blocks in file need patching (replace or insertion) upon closing, potentially disabling progressive upload	NPRG
IsoAltBrands	4ccl	D	ISOBMFF brands associated with PID/file	ABRD
IsoBrand	4cc	D	ISOBMFF major brand associated with PID/file	MBRD
MovieTime	lfrac	D	ISOBMFF movie header duration and timescale	MHTS
HasSync	bool	D	PID has sync points	PSYN
ServiceWidth	uint	D	Display width of service	DWDT
ServiceHeight	uint	D	Display height of service	DHGT
IsDefault	bool	D	Default PID for this stream type	PDEF
CarouselRate	uint	D	Repeat rate in ms for systems carousel data	CARA
AudioVolume	uint	D	Volume of audio	AVOL
AudioPan	uint	D	Balance/Pan of audio	APAN
AudioPriority	uint	D	Audio thread priority	APRI
ProtectionScheme	4cc		Protection scheme type (4CC) used	SCHT
SchemeVersion	uint		Protection scheme version used	SCHV
SchemeURI	str		Protection scheme URI	SCHU
KMS_URI	str		URI for key management system	KMSU
SelectiveEncryption	bool		ISMA/OMA selective encryption is used	ISSE
IVLength	uint		ISMA IV size	ISIV
KILength	uint		ISMA KeyIndication size	ISKI
CryptType	uint		OMA encryption type	OMCT
ContentID	str		OMA Content ID	OMID
TextualHeaders	str		OMA textual headers	OMTH
PlaintextLen	luint		OMA size of plaintext data	OMPT
CryptInfo	str	D	URL (local file only) of crypt info file for this PID, use `clear` to force passthrough	ECRI
DecryptInfo	str	D	URL (local file only) of crypt info file for this PID - see decrypter help	EDRI
SenderNTP	luint	DP	NTP 64 bits timestamp at sender side or grabber side	NTPS
ReceiverNTP	luint	DP	Receiver NTP (64 bits timestamp) usually associated with the sender NTP property	NTPR
UTC	luint	DP	UTC timestamp (in milliseconds) of parent packet	UTCD
Encrypted	bool		Packets for the stream are by default encrypted (however the encryption state is carried in packet crypt flags) - changes are signaled through PID info change (no reconfigure)	EPCK
OMAPreview	luint		OMA Preview range	ODPR
CENC_PSSH	mem		PSSH blob for CENC, formatted as (u32)NbSystems [ (bin128)SystemID(u32)version(u32)KID_count[ (bin128)keyID ] (u32)priv_size(char*priv_size)priv_data]	PSSH
CENC_SAI	mem	P	CENC SAI for the packet, formatted as (char(IV_Size))IV(u16)NbSubSamples [(u16)ClearBytes(u32)CryptedBytes]	SAIS
KeyInfo	mem		Multi key info formatted as: `is_mkey(u8);` nb_keys(u16); [ IV_size(u8); KID(bin128); if (!IV_size) {; const_IV_size(u8); constIV(const_IV_size); } ] `	CBIV `
CENCPattern	frac		CENC crypt pattern, CENC pattern, skip as frac.num crypt as frac.den	CPTR
CENCStore	4cc		Storage location 4CC of SAI data	CSTR
CENCstsdMode	uint		Mode for CENC sample description when using clear samples: * 0: single sample description is used * 1: a clear clone of the sample description is created, inserted before the CENC sample description * 2: a clear clone of the sample description is created, inserted after the CENC sample description	CSTM
AMRModeSet	uint		ModeSet for AMR and AMR-WideBand	AMST
SubSampleInfo	mem		Binary blob describing N subsamples of the sample, formatted as N [(u32)flags(u32)size(u32)codec_param(u8)priority(u8) discardable]. Subsamples for a given flag MUST appear in order, however flags can be interleaved	SUBS
NALUMaxSize	uint		Max size of NAL units in stream - changes are signaled through PID info change (no reconfigure)	NALS
FileNumber	uint	P	Index of file when dumping to files	FNUM
FileName	str	P	Name of output file when dumping / dashing. Must be set on first packet belonging to new file	FNAM
IDXName	str	P	Name of index file when dashing MPEG-2 TS. Must be set on first packet belonging to new file	INAM
FileSuffix	str	P	File suffix name, replacement for $FS$ in tile templates	FSUF
EODS	bool	P	End of DASH segment	EODS
CueStart	bool	P	Set on packets marking the beginning of a DASH/HLS segment for cue-driven segmentation - see dasher help	PCUS
MediaTime	dbl	D	Corresponding media time of the parent packet (0 being the origin)	MTIM
MaxFrameSize	uint	D	Max size of frame in stream - changes are signaled through PID info change (no reconfigure)	MFRS
AvgFrameSize	uint	D	Average size of frame in stream (ISOBMFF only, static property)	AFRS
MaxTSDelta	uint	D	Maximum DTS delta between frames (ISOBMFF only, static property)	MTSD
MaxCTSOffset	uint	D	Maximum absolute CTS offset (ISOBMFF only, static property)	MCTO
ConstantDuration	uint	D	Constant duration of samples, 0 means variable duration (ISOBMFF only, static property)	SCTD
TrackTemplate	mem	D	ISOBMFF serialized track box for this PID, without any sample info (empty stbl and empty dref)	ITKT
TrexTemplate	mem	D	ISOBMFF serialized trex box for this PID	ITXT
STSDTemplate	mem	D	ISOBMFF serialized sample description box (stsd entry) for this PID	ISTD
MovieUserData	mem	D	ISOBMFF serialized moov UDTA and other moov-level boxes (list) for this PID	IMUD
HandlerName	str	D	ISOBMFF track handler name	IHDL
TrackFlags	uint	D	ISOBMFF track header flags	ITKF
TrackMatrix	sintl	D	ISOBMFF track header matrix	ITKM
AltGroup	uint	D	ISOBMFF alt group ID	IALG
ForceNCTTS	bool	D	ISOBMFF force negative CTS offsets	IFNC
Disable	bool	D	ISOBMFF disable flag	ITKD
Period	str	D	ID of DASH period	PEID
PStart	lfrac	D	DASH Period start - cf dasher help	PEST
PDur	lfrac	D	DASH Period duration - cf dasher help	PEDU
Representation	str	D	ID of DASH representation	DRID
ASID	uint	D	ID of parent DASH AS	DAID
MuxSrc	str	D	Name of mux source(s), set by dasher to direct its outputs	MSRC
DashMode	uint	D	DASH mode to be used by multiplexer if any, set by dasher. 0 is no DASH, 1 is regular DASH, 2 is VoD	DMOD
SegSync	bool	D	Indicate segment must be completely flushed before sending segment/fragment size events	DFSS
DashDur	frac	D	DASH target segment duration in seconds	DDUR
Role	strl	D	List of roles for this PID, where each role string can be a DASH role, a `URN:role-value` or any other string (this will throw a warning and use a custom URI for the role)	ROLE
PDesc	strl	D	List of descriptors for the DASH period containing this PID	PDES
ASDesc	strl	D	List of conditional descriptors for the DASH AdaptationSet containing this PID. If a PID with the same property type but different value is found, the PIDs will be in different AdaptationSets	ACDS
ASCDesc	strl	D	List of common descriptors for the DASH AdaptationSet containing this PID	AADS
RDesc	strl	D	List of descriptors for the DASH Representation containing this PID	RDES
BUrl	strl	D	List of base URLs for this PID	BURL
Template	str		Template to use for DASH generation for this PID	DTPL
StartNumber	uint		Start number to use for this PID - cf dasher help	DRSN
xlink	str	D	Remote period URL for DASH - cf dasher help	XLNK
ClampDur	lfrac	D	Max media duration to process from PID in DASH mode	DCMD
HLSPL	str	D	Name of the HLS variant playlist for this media	HLVP
HLSGroup	str	D	Name of HLS Group of a stream	HLGI
HLSForce	str	D	Force writing EXT-X-STREAM-INF if stream is in a rendition group, value is the name of associated groups (can be empty)	HLFI
HLSMExt	strl	D	List of extensions to add to the master playlist for this PID	HLMX
HLSVExt	strl	D	List of extensions to add to the variant playlist for this PID	HLVX
DCue	str	D	Name of a cue list file for this PID - see dasher help	DCUE
DSegs	uint	D	Number of DASH segments defined by the DASH cue info	DCNS
Codec	str	D	codec parameter string to force. If starting with '.', appended to ISOBMFF code point; otherwise replace the codec string	CODS
SingleScale	bool	D	Movie header should use the media timescale of the first track added	DSTS
RequireReorder	bool	D	PID packets come from source with losses and reordering happening (UDP)	PUDP
Primary	bool	D	Primary item in ISOBMFF	PITM
DFMode	uint	D	DASH forward mode is used for this PID. If 2, the manifest is also carried in packet propery	DFWD
DFManifest	str	D	Value of manifest in forward mode	DMPD
DFVariant	strl	D	Value of variant playlist in forward mode	DHLV
DFVariantName	strl	D	Value of variant playlist name in forward mode	DHLN
DFPStart	luint	D	Value of active period start time in forward mode	DPST
HLSKey	str		URI, KEYFORMAT and KEYFORMATVERSIONS for HLS full segment encryption creation, Key URI otherwise ( decoding and sample-AES)	HLSK
HLSIV	mem		Init Vector for HLS decode	HLSI
CKUrl	str		URL for ClearKey licence server	CCKU
ColorPrimaries	cprm	D	Color primaries	CPRM
ColorTransfer	ctfc	D	Color transfer characteristics	CTRC
ColorMatrix	cmxc	D	Color matrix coefficient	CMXC
FullRange	bool	D	Color full range flag	CFRA
Chroma	uint	D	Chroma format (see ISO/IEC 23001-8 / 23091-2)	CFMT
ChromaLoc	uint	D	Chroma location (see ISO/IEC 23001-8 / 23091-2)	CLOC
ContentLightLevel	mem	D	Content light level, payload of clli box (see ISO/IEC 14496-12), can be set as a list of 2 integers in fragment declaration (e.g. "=max_cll,max_pic_avg_ll")	CLLI
MasterDisplayColour	mem	D	Master display colour info, payload of mdcv box (see ISO/IEC 14496-12), can be set as a list of 10 integers in fragment declaration (e.g. "=dpx0,dpy0,dpx1,dpy1,dpx2,dpy2,wpx,wpy,max,min")	MDCV
ICC	mem	D	ICC profile (see ISO 15076-1 or ICC.1)	ICCP
SrcMagic	luint	D	Magic number to store in the track, only used by importers	PSMG
MuxIndex	uint	D	Target track index in destination file, stored by lowest value first (not set by demultiplexers)	TIDX
NoTSLoop	bool		Timestamps on this PID are adjusted in case of loops (used by TS multiplexer output)	NTSL
MHAProfiles	uintl	D	List of compatible profiles for this MPEG-H Audio object	MHCP
FragStart	uint	DP	Packet is a fragment start (value 1) or a segment start (value 2)	PFRB
FragRange	lfrac	DP	Start and end position in bytes of fragment if packet is a fragment or segment start	PFRR
FragTFDT	luint	DP	Decode time of first packet in fragmentt	PFRT
SIDXRange	lfrac	DP	Start and end position in bytes of sidx if packet is a fragment or segment start	PFSR
MoofTemplate	mem	DP	Serialized moof box corresponding to the start of a movie fragment or segment (with styp and optionally sidx)	MFTP
InitSeg	bool	P	Set to true if packet is a complete DASH init segment file	PCKI
RawGrab	uint	D	PID is a raw media grabber (webcam, microphone, etc...). Value 2 is used for front camera	PGRB
KeepAfterEOS	bool	D	PID must be kept alive after EOS (LASeR and BIFS)	PKAE
CoverArt	mem	D	PID cover art image data. If associated data is NULL, the data is carried in the PID	PCOV
BufferLength	uint	D	Playout buffer in ms	PBPL
MaxBuffer	uint	D	Maximum buffer occupancy in ms	PBMX
ReBuffer	uint	D	Rebuffer threshold in ms, 0 disable rebuffering	PBRE
ViewIdx	uint	D	View index for multiview (1 being left)	VIDX
FragURL	str	D	Fragment URL (without '#') of original URL (used by some filters to set the property on media PIDs)	OFRA
ROUTEIP	str	D	ROUTE session IP address	RSIP
ROUTEPort	uint	D	ROUTE session port number	RSPN
ROUTEName	str	D	Name (location) of raw file to advertise in ROUTE session	RSFN
ROUTECarousel	frac	D	Carousel period in seconds of raw file in ROUTE session	RSCR
ROUTEUpload	frac	D	Upload time in seconds of raw file in ROUTE session	RSST
Stereo	uint	D	Stereo type of video	PSTT
Projection	uint	D	Projection type of video	PPJT
InitalPose	v3di	D	Initial pose for 360 video, in degrees expressed as 16.16 bits (x is yaw, y is pitch, z is roll)	PPOS
CMPad	uint	D	Number of pixels to pad from edge of each face in cube map	PCMP
EQRClamp	v4di	D	Clamping of frame for EQR as 0.32 fixed point (x is top, y is bottom, z is left and w is right)	PEQC
SceneNode	bool		PID is a scene node decoder (AFX BitWrapper in BIFS)	PSND
OrigCryptoScheme	4cc		Original crypto scheme on a decrypted PID	POCS
TSBSegs	uint	D	Time shift in number of segments for HAS streams, only set by dashin and dasher filters	PTSN
IsManifest	uint	D	PID is a HAS manifest * 0: not a manifest * 1: DASH manifest * 2: HLS manifest * 3: GHI(X) manifest	PHSM
Sparse	bool	D	PID has potentially empty times between packets	PSPA
CharSet	str	D	Character set for input text PID	PCHS
ForcedSub	uint	D	PID or Packet is forced sub 0: not forced 1: forced frame 2: all frames are forced (PID only)	PFCS
ChapTimes	uintl	D	Chapter start times	CHPT
ChapNames	strl	D	Chapter names	CHPN
IsChap	bool	D	Subtitle PID is chapter (for QT-like chapters)	PCHP
SkipBegin	uint	P	Amount of media to skip from beginning of packet in PID timescale	PCKS
SkipPres	bool	P	Packet and any following with CTS greater than this packet shall not be presented (used by reframer to create edit lists)	PCKD
HLSRef	luint	DP	HLS playlist reference, gives a unique ID identifying media mux, and indicated in packets carrying child playlists	HPLR
LLHLS	uint	D	HLS low latency mode	HLSL
LLHLSFragNum	uint	P	LLHLS fragment number	HLSN
DownloadSession	ptr	D	Pointer to download session	GHTT
HasTemi	bool	D	TEMI present flag	PTEM
XPSMask	uint	DP	Parameter set mask	PXPM
RangeEnd	bool	P	Signal packet is the last in the desired play range	PCER

Pixel formats

Name	File extensions	QT 4CC	Description
yuv420	yuv	j420	Planar YUV 420 8 bit
yvu420	yvu		Planar YVU 420 8 bit
yuv420_10	yuvl		Planar YUV 420 10 bit
yuv422	yuv2		Planar YUV 422 8 bit
yuv422_10	yp2l		Planar YUV 422 10 bit
yuv444	yuv4		Planar YUV 444 8 bit
yuv444_10	yp4l		Planar YUV 444 10 bit
uyvy	uyvy	2vuy	Packed UYVY 422 8 bit
vyuy	vyuy		Packed VYUV 422 8 bit
yuyv	yuyv	yuv2	Packed YUYV 422 8 bit
yvyu	yvyu	YVYU	Packed YVYU 422 8 bit
uyvl	uyvl	v216	Packed UYVY 422 10->16 bit
vyul	vyul		Packed VYUV 422 10->16 bit
yuyl	yuyl		Packed YUYV 422 10->16 bit
yvyl	yvyl		Packed YVYU 422 10->16 bit
nv12	nv12		Semi-planar YUV 420 8 bit, Y plane and UV packed plane
nv21	nv21		Semi-planar YVU 420 8 bit, Y plane and VU packed plane
nv1l	nv1l		Semi-planar YUV 420 10 bit, Y plane and UV plane
nv2l	nv2l		Semi-planar YVU 420 8 bit, Y plane and VU plane
yuva	yuva		Planar YUV+alpha 420 8 bit
yuvd	yuvd		Planar YUV+depth 420 8 bit
yuv444a	yp4a		Planar YUV+alpha 444 8 bit
yuv444p	yv4p		Packed YUV 444 8 bit
v308	v308	v308	Packed VYU 444 8 bit
yuv444ap	y4ap		Packed YUV+alpha 444 8 bit
v408	v408	v408	Packed UYV+alpha 444 8 bit
v410	v410	v410	Packed UYV 444 10 bit LE
v210	v210	v210	Packed UYVY 422 10 bit LE
grey	grey		Greyscale 8 bit
algr	algr		Alpha+Grey 8 bit
gral	gral		Grey+Alpha 8 bit
rgb4	rgb4		RGB 444, 12 bits (16 stored) / pixel
rgb5	rgb5		RGB 555, 15 bits (16 stored) / pixel
rgb6	rgb6		RGB 555, 16 bits / pixel
rgba	rgba	RGBA	RGBA 32 bits (8 bits / component)
argb	argb		ARGB 32 bits (8 bits / component)
bgra	bgra		BGRA 32 bits (8 bits / component)
abgr	abgr	ABGR	ABGR 32 bits (8 bits / component)
rgb	rgb	raw	RGB 24 bits (8 bits / component)
bgr	bgr		BGR 24 bits (8 bits / component)
xrgb	xrgb		xRGB 32 bits (8 bits / component)
rgbx	rgbx		RGBx 32 bits (8 bits / component)
xbgr	xbgr		xBGR 32 bits (8 bits / component)
bgrx	bgrx		BGRx 32 bits (8 bits / component)
rgbd	rgbd		RGB+depth 32 bits (8 bits / component)
rgbds	rgbds		RGB+depth+bit shape (8 bits / RGB component, 7 bit depth (low bits) + 1 bit shape)
extgl	extgl		External OpenGL texture of unknown format, to be used with samplerExternalOES
uncv	uncv		Generic uncompressed format ISO/IEC 23001-17

Audio formats

Name	File extensions	Description
u8	pc8	8 bit PCM
s16	pcm	16 bit PCM Little Endian
s16b	pcmb	16 bit PCM Big Endian
s24	s24	24 bit PCM
s24b	s24b	24 bit Big-Endian PCM
s32	s32	32 bit PCM Little Endian
s32b	s32b	32 bit PCM Big Endian
flt	flt	32-bit floating point PCM
fltb	fltb	32-bit floating point PCM Big Endian
dbl	dbl	64-bit floating point PCM
dblb	dblb	64-bit floating point PCM Big Endian
u8p	pc8p	8 bit PCM planar
s16p	pcmp	16 bit PCM Little Endian planar
s24p	s24p	24 bit PCM planar
s32p	s32p	32 bit PCM Little Endian planar
fltp	fltp	32-bit floating point PCM planar
dblp	dblp	64-bit floating point PCM planar

Stream types

Name	Description
Visual	Video or Image stream
Audio	Audio stream
SceneDescription	Scene stream
Text	Text or subtitle stream
Metadata	Metadata stream
File	Raw file stream
Encrypted	Encrypted media stream
ObjectDescriptor	MPEG-4 ObjectDescriptor stream
ClockReference	MPEG-4 Clock Reference stream
MPEG7	MPEG-7 description stream
IPMP	MPEG-4 IPMP/DRM stream
OCI	MPEG-4 ObjectContentInformation stream
MPEGJ	MPEG-4 JAVA stream
Interaction	MPEG-4 Interaction Sensor stream
Font	MPEG-4 Font stream

Codecs

The codec name identifies a codec within GPAC. There can be several names for a given codec. The first name is used as a default file extension when dumping a raw media stream.

NOTE: This table does not include meta filters (ffmpeg, ...). Use gpac -hx codecs to list them.

Name	Description
bifs	MPEG-4 BIFS v1 Scene Description
bifs2	MPEG-4 BIFS v2 Scene Description
bifsX	MPEG-4 BIFS Extended Scene Description
od	MPEG-4 ObjectDescriptor v1
od2	MPEG-4 ObjectDescriptor v2
interact	MPEG-4 Interaction Stream
afx	MPEG-4 AFX Stream
font	MPEG-4 Font Stream
syntex	MPEG-4 Synthetized Texture
m4txt	MPEG-4 Streaming Text
laser	MPEG-4 LASeR
saf	MPEG-4 Simple Aggregation Format
cmp m4ve m4v	MPEG-4 Visual part 2
264 avc h264	MPEG-4 AVC
avcps	MPEG-4 AVC
svc avc 264 h264	MPEG-4 AVC
mvc	MPEG-4 AVC
hvc hevc h265	HEVC Video
lhvc shvc mhvc	HEVC Video Layered Extensions
m2vs	MPEG-2 Visual Simple
m2v	MPEG-2 Visual Main
m2v m2vsnr	MPEG-2 Visual SNR
m2v m2vspat	MPEG-2 Visual Spatial
m2v m2vh	MPEG-2 Visual High
m2v m2v4	MPEG-2 Visual 422
m1v	MPEG-1 Video
jpg jpeg	JPEG Image
png	PNG Image
jp2 j2k	JPEG2000 Image
aac	MPEG-4 AAC Audio
aac aac2m	MPEG-2 AAC Audio Main
aac aac2l	MPEG-2 AAC Audio Low Complexity
aac aac2s	MPEG-2 AAC Audio Scalable Sampling Rate
mp3 m1a	MPEG-1 Audio
mp2	MPEG-2 Audio
mp1	MPEG-1 Audio Layer 1
h263	H263 Video
h263	H263 Video
hvt1	HEVC tiles Video
evc evrc	EVRC Voice
smv	SMV Voice
qcp qcelp	QCELP Voice
amr	AMR Audio
amr amrwb	AMR WideBand Audio
qcp evrcpv	EVRC (PacketVideo MUX) Audio
vc1	SMPTE VC-1 Video
dirac	Dirac Video
ac3	AC3 Audio
eac3	Enhanced AC3 Audio
mlp	Dolby TrueHD
dra	DRA Audio
g719	G719 Audio
dstc	DTS Coherent Acoustics and Digital Surround Audio
dtsh	DTS-HD High Resolution Audio and DTS-Master Audio
dstl	DTS-HD Substream containing only XLLAudio
dtse	DTS Express low bit rate Audio
dtsx	DTS-X UHD Audio Profile 2
dtsy	DTS-X UHD Audio Profile 3
opus	Opus Audio
eti	DVB Event Information
svgr	SVG over RTP
svgzr	SVG+gz over RTP
dims	3GPP DIMS Scene
vtt	WebVTT Text
txt	Simple Text Stream
mtxt	Metadata Text Stream
mxml	Metadata XML Stream
subs	Subtitle text Stream
subx	Subtitle XML Stream
tx3g	Subtitle/text 3GPP/Apple Stream
ssa	SSA /ASS Subtitles
theo theora	Theora Video
vorb vorbis	Vorbis Audio
opus	Opus Audio
flac	Flac Audio
spx speex	Speex Audio
vobsub	VobSub Subtitle
vobsub	VobSub Subtitle
adpcm	AD-PCM
csvd	IBM CSVD
alaw	ALAW
mulaw	MULAW
okiadpcm	OKI ADPCM
dviadpcm	DVI ADPCM
digistd	DIGISTD
yamadpcm	YAMAHA ADPCM
truespeech	DSP TrueSpeech
g610	GSM 610
imulaw	IBM MULAW
ialaw	IBM ALAW
iadpcl	IBM ADPCL
swf	Adobe Flash
raw	Raw media
uncv	Raw Video
av1 ivf obu av1b	AOM AV1 Video
vp8 ivf	VP8 Video
vp9 ivf	VP9 Video
vp10 ivf	VP10 Video
mhas	MPEG-H Audio
mhas	MPEG-H AudioMux
prores apch	ProRes Video 422 HQ
prores apco	ProRes Video 422 Proxy
prores apcn	ProRes Video 422 STD
prores apcs	ProRes Video 422 LT
prores ap4x	ProRes Video 4444 XQ
prores ap4h	ProRes Video 4444
ffmpeg	FFMPEG unmapped codec
tmcd	QT TimeCode
vvc 266 h266	VVC Video
vvs1	VVC Subpicture Video
usac xheaac	xHEAAC / USAC Audio
ffv1	FFMPEG Video Codec 1
dvbs	DVB Subtitles
dvbs	DVB-TeleText
div3	MS-MPEG4 V3
caf	Apple Lossless Audio

Audio channel layout code points (ISO/IEC 23091-3)

Name	Integer value	ChannelMask
mono	1	0x0000000000000004
stereo	2	0x0000000000000003
3/0.0	3	0x0000000000000007
3/1.0	4	0x0000000000000407
3/2.0	5	0x0000000000000307
3/2.1	6	0x000000000000030f
5/2.1	7	0x000000000000030f
1+1	8	0x0000000000000003
2/1.0	9	0x0000000000000403
2/2.0	10	0x0000000000000033
3/3.1	11	0x000000000000043f
3/4.1	12	0x000000000000033f
11/11.2	13	0x000000003ffe67cf
5/2.1	14	0x000000000006030f
5/5.2	15	0x000000000606630f
5/4.1	16	0x000000000036003f
6/5.1	17	0x00000000023e003f
6/7.1	18	0x00000600023e003f
5/6.1	19	0x000000000036630f
7/6.1	20	0x000000600036630f

Color Primaries code points (ISO/IEC 23091-2)

Name	Integer value
reserved0	0
BT709	1
undef	2
reserved3	3
BT470M	4
BT470G	5
SMPTE170	6
SMPTE240	7
FILM	8
BT2020	9
SMPTE428	10
SMPTE431	11
SMPTE432	12
EBU3213	22

Transfer Characteristics code points (ISO/IEC 23091-2)

Name	Integer value
reserved0	0
BT709	1
undef	2
reserved3	3
BT470M	4
BT470BG	5
SMPTE170	6
SMPTE249	7
Linear	8
Log100	9
Log316	10
IEC61966	11
BT1361	12
sRGB	13
BT2020_10	14
BT2020_12	15
SMPTE2084	16
SMPTE428	17
STDB67	18

Matrix Coefficients code points (ISO/IEC 23091-2)

Name	Integer value
GBR	0
BT709	1
undef	2
unknown	3
FCC	4
BT601	5
SMPTE170	6
SMPTE240	7
YCgCo	8
BT2020	9
BT2020cl	10
YDzDx	11

Extensions and mime types

Extension name can be used to force output formats using ext= option of sink filters.
By default, GPAC does not rely on file extension for source processing unless -no-probe option is set, in which case ext= option may be set on source filter.
NOTE: This table does not include meta filters (ffmpeg, ...), use gpac -hx formats to list them.

Extension	Input Filter(s)	Output Filter(s)	Mime(s)
mp4	mp4dmx	mp4mx	video/mp4 audio/mp4 application/mp4
mpg4	mp4dmx	mp4mx	application/mp4
m4a	mp4dmx	mp4mx	audio/mp4
m4i	mp4dmx	mp4mx	application/mp4
3gp	mp4dmx	mp4mx	video/3gpp audio/3gpp
3gpp	mp4dmx	mp4mx	video/3gpp audio/3gpp
3g2	mp4dmx	mp4mx	video/3gp2 audio/3gp2
3gp2	mp4dmx	mp4mx	video/3gp2 audio/3gp2
iso	mp4dmx	mp4mx	video/mp4 audio/mp4 application/mp4
m4s	mp4dmx	mp4mx	video/iso.segment audio/iso.segment
iff	mp4dmx	mp4mx	image/heif
heif	mp4dmx	mp4mx	image/heif
heic	mp4dmx	mp4mx	image/heic
avif	mp4dmx	mp4mx	image/avci
avci	mp4dmx	mp4mx	image/avci
mj2	mp4dmx	mp4mx	video/jp2
ismv	mp4dmx	mp4mx	video/mp4 audio/mp4 application/mp4
mov	mp4dmx	mp4mx	video/quicktime
qt	mp4dmx	mp4mx	video/quicktime
bt	btplay	n/a	application/x-bt
btz	btplay	n/a	application/x-bt
bt.gz	btplay	n/a	application/x-bt
xmt	btplay	n/a	application/x-xmt
xmt.gz	btplay	n/a	application/x-xmt
xmtz	btplay	n/a	application/x-xmt
wrl	btplay	n/a	model/vrml
wrl.gz	btplay	n/a	model/vrml
x3dv	btplay	n/a	model/x3d+vrml
x3dv.gz	btplay	n/a	model/x3d+vrml
x3dvz	btplay	n/a	model/x3d+vrml
x3d	btplay	n/a	model/x3d+xml
x3d.gz	btplay	n/a	model/x3d+xml
x3dz	btplay	n/a	model/x3d+xml
swf	btplay txtin	n/a	application/x-shockwave-flash
xsr	btplay	n/a	application/x-LASeR+xml
svg	svgplay	n/a	image/svg+xml
svgz	svgplay	n/a	image/svg+xml
svg.gz	svgplay	n/a	image/svg+xml
jpg	rfimg	writegen	image/jpg
jpeg	rfimg	writegen	image/jpg
jp2	rfimg	writegen	image/jp2
j2k	rfimg	writegen	image/jp2
bmp	rfimg	writegen	image/bmp
png	rfimg	writegen	image/png
aac	rfadts	writegen	audio/aac
adts	rfadts	writegen	audio/aac
latm	rflatm	writegen	audio/aac+latm
usac	rflatm	writegen	audio/xheaac+latm
xheaac	rflatm	writegen	audio/xheaac+latm
mp3	rfmp3	writegen	audio/mp3 audio/x-mp3
mp2	rfmp3	writegen	audio/mp3 audio/x-mp3
mp1	rfmp3	writegen	audio/mp3 audio/x-mp3
ac3	rfac3	writegen	audio/ac3
eac3	rfac3	writegen	audio/eac3
ec3	rfac3	n/a	audio/x-ac3 audio/ac3 audio/x-eac3 audio/eac3
amr	rfamr	writegen	audio/amr
awb	rfamr	writegen	audio/amr
evc	rfamr	writegen	audio/x-evc
smv	rfamr	writegen	audio/x-smv
oga	oggdmx	oggmx	audio/ogg
spx	oggdmx	writegen oggmx	audio/ogg
ogg	oggdmx	oggmx	video/ogg
ogv	oggdmx	oggmx	video/ogg
oggm	oggdmx	oggmx	application/ogg
opus	oggdmx	oggmx	audio/ogg
ts	m2tsdmx	m2tsmx	video/mp2t
m2t	m2tsdmx	m2tsmx	video/mp2t
mts	m2tsdmx	m2tsmx	video/mp2t
dmb	m2tsdmx	m2tsmx	video/mp2t
trp	m2tsdmx	m2tsmx	video/mp2t
saf	safdmx	n/a	application/x-saf application/saf
lsr	safdmx	n/a	application/x-saf application/saf
mpd	dashin	dasher	application/dash+xml
m3u8	dashin	dasher	application/vnd.apple.mpegurl
3gm	dashin	dasher	application/vnd.3gpp.mpd
ism	dashin	dasher	application/vnd.ms-sstr+xml
qcp	rfqcp	writeqcp	audio/qcelp audio/evr-qcp audio/smv-qcp
263	rfh263	writegen	video/h263
h263	rfh263	writegen	video/h263
s263	rfh263	writegen	video/h263
cmp	rfmpgvid	writegen	video/mp4v-es video/mpgv-es
m1v	rfmpgvid	writegen	video/mp4v-es video/mpgv-es
m2v	rfmpgvid	writegen	video/mp4v-es video/mpgv-es
m4v	rfmpgvid	writegen	video/mp4v-es video/mpgv-es
nhnt	nhntr	nhntw	application/x-nhnt
nhml	nhmlr	nhmlw	application/x-nhml application/dims
dims	nhmlr	nhmlw	application/x-nhml application/dims
dml	nhmlr	nhmlw	application/x-nhml application/dims
264	rfnalu	writegen	video/h264
h264	rfnalu	writegen	video/h264
26l	rfnalu	writegen	video/h264
h26l	rfnalu	writegen	video/h264
avc	rfnalu	writegen	video/h264
svc	rfnalu	writegen	video/svc
mvc	rfnalu	writegen	video/mvc
hevc	rfnalu	writegen	video/hevc
hvc	rfnalu	writegen	video/hevc
265	rfnalu	writegen	video/hevc
h265	rfnalu	writegen	video/hevc
lhvc	rfnalu	writegen	video/lhvc
shvc	rfnalu	writegen	video/shvc
mhvc	rfnalu	writegen	video/mhvc
266	rfnalu	writegen	video/vvc
h266	rfnalu	writegen	video/vvc
vvc	rfnalu	writegen	video/vvc
lvvc	rfnalu	writegen	video/vvc
mpg	m2psdmx	n/a	video/mpeg audio/mpeg video/mpegps
mpeg	m2psdmx	n/a	video/mpeg audio/mpeg video/mpegps
vob	m2psdmx	n/a	video/mpeg audio/mpeg video/mpegps
avi	avidmx	n/a	video/avi video/x-avi
srt	txtin	writegen	subtitle/srt
ttxt	txtin	writegen	subtitle/x-ttxt
sub	txtin vobsubdmx	n/a	subtitle/sub
vtt	txtin	writegen	subtitle/vtt
txml	txtin	writegen	x-quicktime/text
ttml	txtin	writegen	subtitle/ttml
ssa	txtin	n/a	subtitle/ssa
ass	txtin	n/a	subtitle/ssa
sdp	rtpin	rtpout	application/sdp
yuv	rfrawvid	writegen	video/x-raw
yvu	rfrawvid	writegen	video/x-raw
yuvl	rfrawvid	writegen	video/x-raw
yuv2	rfrawvid	writegen	video/x-raw
yp2l	rfrawvid	writegen	video/x-raw
yuv4	rfrawvid	writegen	video/x-raw
yp4l	rfrawvid	writegen	video/x-raw
uyvy	rfrawvid	writegen	video/x-raw
vyuy	rfrawvid	writegen	video/x-raw
yuyv	rfrawvid	writegen	video/x-raw
yvyu	rfrawvid	writegen	video/x-raw
uyvl	rfrawvid	writegen	video/x-raw
vyul	rfrawvid	writegen	video/x-raw
yuyl	rfrawvid	writegen	video/x-raw
yvyl	rfrawvid	writegen	video/x-raw
nv12	rfrawvid	writegen	video/x-raw
nv21	rfrawvid	writegen	video/x-raw
nv1l	rfrawvid	writegen	video/x-raw
nv2l	rfrawvid	writegen	video/x-raw
yuva	rfrawvid	writegen	video/x-raw
yuvd	rfrawvid	writegen	video/x-raw
yp4a	rfrawvid	writegen	video/x-raw
yv4p	rfrawvid	writegen	video/x-raw
v308	rfrawvid	writegen	video/x-raw
y4ap	rfrawvid	writegen	video/x-raw
v408	rfrawvid	writegen	video/x-raw
v410	rfrawvid	writegen	video/x-raw
v210	rfrawvid	writegen	video/x-raw
grey	rfrawvid	writegen	video/x-raw
algr	rfrawvid	writegen	video/x-raw
gral	rfrawvid	writegen	video/x-raw
rgb4	rfrawvid	writegen	video/x-raw
rgb5	rfrawvid	writegen	video/x-raw
rgb6	rfrawvid	writegen	video/x-raw
rgba	rfrawvid	writegen	video/x-raw
argb	rfrawvid	writegen	video/x-raw
bgra	rfrawvid	writegen	video/x-raw
abgr	rfrawvid	writegen	video/x-raw
rgb	rfrawvid	writegen	video/x-raw
bgr	rfrawvid	writegen	video/x-raw
xrgb	rfrawvid	writegen	video/x-raw
rgbx	rfrawvid	writegen	video/x-raw
xbgr	rfrawvid	writegen	video/x-raw
bgrx	rfrawvid	writegen	video/x-raw
rgbd	rfrawvid	writegen	video/x-raw
rgbds	rfrawvid	writegen	video/x-raw
uncv	rfrawvid	writegen	video/x-raw
pc8	rfpcm	writegen	audio/x-pcm
pcm	rfpcm	writegen	audio/x-pcm
pcmb	rfpcm	writegen	audio/x-pcm
s24	rfpcm	writegen	audio/x-pcm
s24b	rfpcm	writegen	audio/x-pcm
s32	rfpcm	writegen	audio/x-pcm
s32b	rfpcm	writegen	audio/x-pcm
flt	rfpcm	writegen	audio/x-pcm
fltb	rfpcm	writegen	audio/x-pcm
dbl	rfpcm	writegen	audio/x-pcm
dblb	rfpcm	writegen	audio/x-pcm
pc8p	rfpcm	writegen	audio/x-pcm
pcmp	rfpcm	writegen	audio/x-pcm
s24p	rfpcm	writegen	audio/x-pcm
s32p	rfpcm	writegen	audio/x-pcm
fltp	rfpcm	writegen	audio/x-pcm
dblp	rfpcm	writegen	audio/x-pcm
wav	rfpcm	writegen	audio/wav audio/wave
obu	rfav1	writegen	video/x-ivf video/av1
av1	rfav1	writegen	video/x-ivf video/av1
av1b	rfav1	writegen	video/x-ivf video/av1
ivf	rfav1	writegen	video/x-ivf video/av1
prores	rfprores	writegen	video/prores
txt	n/a	writegen	x-subtitle/srt subtitle/srt text/srt
xml	n/a	writegen	subtitle/ttml text/ttml application/xml+ttml
qcelp	n/a	writegen	audio/x-qcelp
theo	n/a	writegen	video/x-theora
vorb	n/a	writegen	audio/x-vorbis
flac	rfflac	writegen	audio/flac
mhas	rfmhas	writegen	audio/mpegh
vc1	ffdmx	writegen	video/vc1
mlp	rftruehd	writegen	audio/truehd
thd	rftruehd	writegen	audio/truehd
truehd	rftruehd	writegen	audio/truehd
ffv1	n/a	writegen	video/x-ffv1
y4m	rfrawvid	writegen	video/x-yuv4mpeg
dts	ffdmx	writegen	audio/dts
idx	vobsubdmx	n/a	text/vobsub
m3u	flist	n/a	application/x-gpac-playlist
pl	flist	n/a	application/x-gpac-playlist
ghix	ghidmx	dasher	application/dash+xml video/vnd.3gpp.mpd audio/vnd.3gpp.mpd video/vnd.mpeg.dash.mpd audio/vnd.mpeg.dash.mpd audio/mpegurl video/mpegurl application/vnd.ms-sstr+xml application/x-gpac-ghi application/x-gpac-ghix
ghi	n/a	dasher	application/dash+xml video/vnd.3gpp.mpd audio/vnd.3gpp.mpd video/vnd.mpeg.dash.mpd audio/vnd.mpeg.dash.mpd audio/mpegurl video/mpegurl application/vnd.ms-sstr+xml application/x-gpac-ghi application/x-gpac-ghix
gsf	gsfdmx	gsfmx	application/x-gpac-sf
`ignore	`n/a	writeuf	n/a

Protocol Schemes

NOTE: This table does not include meta filters (ffmpeg, ...), use gpac -hx protocols to list them.

Scheme	Input Filter(s)	Output Filter(s)
file	fin	fout
isobmf	fin	n/a
gmem	fin httpin	n/a
gfio	fin	fout
http	httpin	httpout
https	httpin	httpout
tcp	sockin	sockout
udp	sockin	sockout
tcpu	sockin	sockout
udpu	sockin	sockout
rtp	rtpin	rtpout
rtsp	rtpin	rtspout
rtspu	rtpin	n/a
rtsph	rtpin	rtspout
satip	rtpin	n/a
rtsps	rtpin	rtspout
pipe	pin	pout
atsc	routein	routeout
route	routein	routeout
video	ffavin	n/a
audio	ffavin	n/a
av	ffavin	n/a