Difference between revisions of "Hacker Guide"
Jump to navigation
Jump to search
m (→Coding for VLC: Add Code Signing) |
m (→Coding for VLC: Add API doxygen link so doxygen can be browsed without JavaScript) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 4: | Line 4: | ||
It uses a large number of [[Contrib Status|3rd party libraries]]. | It uses a large number of [[Contrib Status|3rd party libraries]]. | ||
| − | VLC development is open source, and then a large community of developers worldwide contribute to it.<br /> | + | VLC development is [[open source]], and then a large community of developers worldwide contribute to it.<br /> |
| − | However, entering a project such as | + | However, entering a project such as VLC can be long and complex for new developers. |
This '''guide''' seeks to help understanding the VLC code base and VLC internals to quickly get up to speed.<br /> | This '''guide''' seeks to help understanding the VLC code base and VLC internals to quickly get up to speed.<br /> | ||
| − | ''NB: this guide is '''not''' about [[ | + | ''NB: this guide is '''not''' about [[compiling]] VLC.'' |
| Line 17: | Line 17: | ||
=== VLC's Core / libVLCcore === | === VLC's Core / libVLCcore === | ||
| − | The most important (and probably most complex) part of VLC is the core, located | + | The most important (and probably most complex) part of VLC is the core, located under {{VLCSourceFolder|src}} in the repository. |
*[[{{#rel2abs:/Core}}|Introduction to the core]] | *[[{{#rel2abs:/Core}}|Introduction to the core]] | ||
| Line 37: | Line 37: | ||
** An access module provides a byte stream from a location string [[MRL]], like support for files, HTTP streams, webcams... | ** An access module provides a byte stream from a location string [[MRL]], like support for files, HTTP streams, webcams... | ||
*[[{{#rel2abs:/Demux}}|Demuxer]] | *[[{{#rel2abs:/Demux}}|Demuxer]] | ||
| − | ** A demux module parses a byte stream and splits it into [ | + | ** A demux module parses a byte stream and splits it into [[elementary stream]]s (tracks). |
*[[{{#rel2abs:/Access Demux}}|Access-Demuxer]] | *[[{{#rel2abs:/Access Demux}}|Access-Demuxer]] | ||
** An access_demux module combines the functionality of access and demux (and bypass any stream filters), splitting elementary streams directly from a location string. It's used where the bytestream abstraction is inadequate. | ** An access_demux module combines the functionality of access and demux (and bypass any stream filters), splitting elementary streams directly from a location string. It's used where the bytestream abstraction is inadequate. | ||
| Line 84: | Line 84: | ||
== Coding for VLC == | == Coding for VLC == | ||
| − | *[[Patch]]ing | + | *[[Patch]]ing ([[Sending Patches|sending]]) |
| − | |||
*[[Code Conventions]] | *[[Code Conventions]] | ||
| − | *[[Code Signing]] | + | *[[Code Signing]] |
| − | *[[{{#rel2abs:/How To Write a Module}}|Adding a module]] | + | *[[{{#rel2abs:/How To Write a Module}}|Adding a module]] |
| − | *[[Documentation:Unicode]] | + | *[[Documentation:Unicode]] |
| − | *[ | + | *[https://www.videolan.org/developers/vlc/doc/doxygen/html/index.html Doxygen Documentation] <span class="plainlinks">([https://www.videolan.org/developers/vlc/doc/doxygen/html/pages.html pages] • [https://www.videolan.org/developers/vlc/doc/doxygen/html/modules.html modules] • [https://www.videolan.org/developers/vlc/doc/doxygen/html/annotated.html data structures] • [https://www.videolan.org/developers/vlc/doc/doxygen/html/files.html files] • [https://www.videolan.org/developers/vlc/doc/doxygen/html/group__vlc.html API])</span> |
| − | *[[C Types]] | + | *[[C Types]] |
*[[Strings]] | *[[Strings]] | ||
Latest revision as of 08:47, 17 April 2019
Contents
Introduction
VLC media player is a very popular, but quite large and complex piece of software.
It uses a large number of 3rd party libraries.
VLC development is open source, and then a large community of developers worldwide contribute to it.
However, entering a project such as VLC can be long and complex for new developers.
This guide seeks to help understanding the VLC code base and VLC internals to quickly get up to speed.
NB: this guide is not about compiling VLC.
A very good introduction to VLC can also be found on (an archived copy of the site) enjoythearchitecture.
The layers of VLC and libVLC
VLC's Core / libVLCcore
The most important (and probably most complex) part of VLC is the core, located under in the repository.
- Introduction to the core
- This is a MUST-READ for developers.
- VLC modules loading
- How the numerous VLC modules work and are loaded.
- Input
- How the main input chain works (slightly outdated)
- VLC Object Management
- VLC variables
- VLM Internals
Plugins / Modules
Input
- Access
- An access module provides a byte stream from a location string MRL, like support for files, HTTP streams, webcams...
- Demuxer
- A demux module parses a byte stream and splits it into elementary streams (tracks).
- Access-Demuxer
- An access_demux module combines the functionality of access and demux (and bypass any stream filters), splitting elementary streams directly from a location string. It's used where the bytestream abstraction is inadequate.
- Stream Filters
- A stream filter module converts a byte stream into another byte stream. It could be used for file or byte stream decryption, as it is already used for decompression (gzip, Bzip2, XZ) and multi-part files.
- Decoder
- A decoder takes an elementary stream and convert into raw video, audio or text data, reading for output.
Audio
Video
Interfaces
Modules types not documented (yet)
Misc
Streaming output
libVLC and bindings
- Using libvlc
- bindings
VLC source code overview
- Hacker Guide/VLC source tree
- Hacker Guide/Modules source tree
- VLC Preferences
- VLC Playlist and Media Library
Coding for VLC
- Patching (sending)
- Code Conventions
- Code Signing
- Adding a module
- Documentation:Unicode
- Doxygen Documentation (pages • modules • data structures • files • API)
- C Types
- Strings
User Experience
Testing
Mozilla plugins
This page is part of official VLC media player Documentation (User Guide • Streaming HowTo • Hacker Guide • Modules)
Please read the Documentation Editing Guidelines before you edit the documentation
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
