8e57db1d80
Functions changes summary: 0 Removed, 1 Changed (780 filtered out), 0 Added functions
Variables changes summary: 0 Removed, 0 Changed, 0 Added variable
1 function with some indirect sub-type change:
[C] 'function GF_Err gf_bifs_decode_au(GF_BifsDecoder*, u16, const u8*, u32, Double)' at bifs_codec.c:258:1 has some indirect sub-type changes:
parameter 1 of type 'GF_BifsDecoder*' has sub-type changes:
in pointed to type 'typedef GF_BifsDecoder' at bifs.h:55:1:
underlying type 'struct __tag_bifs_dec' at bifs_dev.h:92:1 changed:
type size hasn't changed
1 data member changes (3 filtered):
type of 'GF_SceneGraph* scenegraph' changed:
in pointed to type 'typedef GF_SceneGraph' at scenegraph.h:480:1:
underlying type 'struct __tag_scene_graph' at scenegraph_dev.h:136:1 changed:
type size hasn't changed
1 data member changes (14 filtered):
type of 'gf_sg_script_action script_action' changed:
underlying type 'typedef Bool (void*, typedef GF_JSAPIActionType, GF_Node*, GF_JSAPIParam*)*' changed:
in pointed to type 'function type typedef Bool (void*, typedef GF_JSAPIActionType, GF_Node*, GF_JSAPIParam*)':
parameter 4 of type 'GF_JSAPIParam*' has sub-type changes:
in pointed to type 'typedef GF_JSAPIParam' at scenegraph.h:727:1:
underlying type 'union GF_JSAPIParam' at scenegraph.h:711:1 changed:
type size hasn't changed
1 data member changes (2 filtered):
type of '__gf_download_manager* dnld_man' changed:
in pointed to type 'struct __gf_download_manager' at downloader.h:374:1:
type size hasn't changed
1 data member change:
type of 'GF_FilterSession* filter_session' changed:
in pointed to type 'typedef GF_FilterSession' at filters.h:119:1:
underlying type 'struct __gf_filter_session' at filter_session.h:374:1 changed:
type size changed from 4672 to 4416 (in bits)
4 data member deletions:
'__jsfs_task* new_f_task', at offset 4032 (in bits) at filter_session.h:507:1
'__jsfs_task* del_f_task', at offset 4096 (in bits) at filter_session.h:507:1
'__jsfs_task* on_evt_task', at offset 4160 (in bits) at filter_session.h:507:1
'__jsfs_task* on_auth_task', at offset 4224 (in bits) at filter_session.h:507:1
7 data member changes (4 filtered):
'gf_fs_on_filter_creation on_filter_create_destroy' offset changed from 4288 to 4032 (in bits) (by -256 bits)
'void* rt_udta' offset changed from 4352 to 4096 (in bits) (by -256 bits)
'Bool force_main_thread_tasks' offset changed from 4416 to 4160 (in bits) (by -256 bits)
'void* ext_gl_udta' offset changed from 4480 to 4224 (in bits) (by -256 bits)
'gf_fs_gl_activate ext_gl_callback' offset changed from 4544 to 4288 (in bits) (by -256 bits)
'u32 dbg_flags' offset changed from 4608 to 4352 (in bits) (by -256 bits)
'Bool check_props' offset changed from 4640 to 4384 (in bits) (by -256 bits)
GPAC Introduction
Current version: 2.5-DEV
Latest Release: 2.4
GPAC is an open-source multimedia framework focused on modularity and standards compliance. GPAC provides tools to process, inspect, package, stream, playback and interact with media content. Such content can be any combination of audio, video, subtitles, metadata, scalable graphics, encrypted media, 2D/3D graphics and ECMAScript. GPAC is best-known for its wide MP4/ISOBMFF capabilities and is popular among video enthusiasts, academic researchers, standardization bodies, and professional broadcasters.
For more information, visit https://gpac.io
GPAC is distributed under the LGPL v2.1 or later, and is also available, for most of it, under a commercial license.
Please ! cite ! our work in your research:
- "GPAC Filters" (https://doi.org/10.1145/3339825.3394929) for recent versions (0.9 or above)
- "GPAC: open source multimedia framework" (https://doi.org/10.1145/1291233.1291452) for older versions.
Features
GPAC can process, analyse, package, stream, encode, decode and playback a wide variety of contents. Selected feature list:
- Audio: MPEG audio (mp1/2/3, aac), AC3, E-AC3, Opus, FLAC, …
- Video: MPEG 1 / 2 / 4 (H264/AVC) / H (HEVC), VVC, AV1, VP9, Theora, ...
- Subtitles: WebVTT, TTML (full, EBU-TTD, …), 3GPP/Apple Timed Text, …
- Encryption: CENC, PIFF, ISMA, OMA, ...
- Containers: MP4/fMP4/CMAF/Quicktime MOV/ProRes MOV, AVI, MPG, OGG, MKV, ...
- Streaming: MPEG-2 Transport Stream, RTP, RTSP, HTTP, Apple HLS, MPEG-DASH, ATSC 3.0 ROUTE, ...
- Supported IOs: local files, pipes, UDP/TCP, HTTP(S), custom IO
- Presentation formats: MPEG-4 BIFS, SVG Tiny 1.2, VRML/X3D
- JS scripting through QuickJS for both SVG/BIFS/VRML and extending GPAC framework tools
- 3D support (360 videos, WebGL JS filters…)
- Inputs: microphone, camera, desktop grabbing
- Highly configurable media processing pipeline
- Python and NodeJS bindings
Features are encapsulated in processing modules called filters:
- to get the full list of available features, you can run the command line
gpac -h filtersor check filters' wiki. - to get the full list of playback features, check the dedicated wiki page.
Tools
MP4Box
MP4Box is a multi-purpose MP4 file manipulation for the prompt, featuring media importing and extracting, file inspection, DASH segmentation, RTP hinting, ... See MP4Box -h, man MP4Box or our wiki.
gpac
GPAC includes a filter engine in charge of stream management and used by most applications in GPAC - read this post for more discussion on how this impacts MP4Box.
The gpac application is a direct interface to the filter engine of GPAC, allowing any combination of filters not enabled by other applications. See gpac -h, man gpac, man gpac-filters or our wiki for more details.
Getting started
Download
Stable and nightly builds installers for Windows, Linux, OSX, Android, iOS are available on gpac.io.
If you want to compile GPAC yourself, please follow the instructions in the build section of our wiki.
Documentation
The general GPAC framework documentation is available on wiki.gpac.io, including HowTos.
GPAC tools are mostly wrappers around an underlying library called libgpac which can easily be embedded in your projects. The libgpac developer documentation is available at doxygen.gpac.io, including documentation of JS APIs, Python APIs and NodeJS APIs.
Testing
GPAC has a test suite exercising most features of the framework. The test suite is in a separate repository https://github.com/gpac/testsuite/, but is available as a submodule of the GPAC main repository. To initialize the testsuite submodule, do git submodule update --init.
For more details on the test suite, read this page and check the testsuite readme.
Per-commit build and tests results are available.
Support, ongoing tasks and bugs
Please use github for feature requests and bug reports. When filing a request there, please tag it as feature-request.
Contributing
A complex project like GPAC wouldn’t exist and persist without the support of its community. Please contribute: a nice message, supporting us in our communication, reporting issues when you see them… any gesture, even the smallest ones, counts.
If you want to contribute to GPAC, you can find ideas at GSoC page or look for a good first issue. In any doubt please feel free to contact us.
Team
GPAC is brought to you by an experienced team of developers with a wide track-record on media processing.
The project is mainly developed in the MultiMedia group of Telecom Paris with the help of many great contributors.
GPAC has a peculiar story: started as a startup in NYC, GPAC gained traction from research and a nascent multimedia community as it was open-sourced in 2003. Since then we have never stopped transforming GPAC into a useful and up-to-date project, with many industrial R&D collaborations and a community of tens of thousands of users. This makes GPAC one of the few open-source multimedia projects that gathers so much diversity.
Roadmap
Users are encouraged to use the latest tag or the master branch.
V2.X
Targets:
- DASH event support
- Web GUI
- QUIC support
- ROUTE file repair support
- FLUTE support
- Rust Bindings