Documentation:Modules/dummy: Difference between revisions
Jump to navigation
Jump to search
→Source code: New section: copy source code links from Dummy (bare URLs are not copyrightable); remove {{Stub}} |
→Interface: Explain how a dummy interface might be useful |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Dummy modules are the VLC equivalent of <code>/dev/null</code> on GNU/Linux: they represent doing nothing. | [[Dummy]] modules are the VLC equivalent of <code>/dev/null</code> on GNU/Linux: they represent doing nothing. | ||
== List == | == List == | ||
| Line 19: | Line 19: | ||
| Control interface [[Category:Interfaces]] [[Category:Control VLC]] || Dummy interface || (none) | | Control interface [[Category:Interfaces]] [[Category:Control VLC]] || Dummy interface || (none) | ||
|- | |- | ||
| Muxer [[Category:Muxers]] || Dummy/Raw muxer || dummy, raw, es | | Muxer [[Category:Muxers]] || Dummy/[[Raw]] muxer || dummy, raw, es | ||
|- | |- | ||
| Stream output [[Category:Stream output]] || Dummy stream output || dummy, drop | | Stream output [[Category:Stream output]] || Dummy stream output || dummy, drop | ||
| Line 30: | Line 30: | ||
|} | |} | ||
== | == Descriptions == | ||
=== Interface === | |||
A dummy interface works well with [[command-line]] usage. It consumes fewer computing resources, something that can be used to reduce a bottleneck effect during [[transcoding]], or simply when opening a window makes little sense. | |||
This will play an [[Ogg]] file with no interface: | |||
{{$}} vlc -I dummy audio.ogg vlc://quit | |||
No window is launched, and control is returned to the calling application after the file plays. | |||
This will play a [[Schroedinger]] file with a minimalist interface: | |||
{{$}} vlc -I dummy video.drc vlc://quit | |||
A window with no buttons or toolbars is launched (no [[skin]]), because [[video output]] requires a window. [[Hotkey]]s may be used to control playback by default, something that can be disabled if necessary with <code>--no-keyboard-events</code>. | |||
=== Stream output === | |||
Doesn't do anything. Can be used to test other stream output chain modules without actually streaming anything. | |||
== Options == | |||
=== Dummy decoder === | === Dummy decoder === | ||
{{Option | {{Option | ||
|name=dummy-save-es | |name=dummy-save-es | ||
|value=boolean | |value=boolean | ||
|default=disabled | |default=disabled | ||
|description=Save the raw codec data if you have selected/forced the dummy decoder in the main options. | |description=Save the raw [[codec]] data if you have selected/forced the dummy decoder in the main options. | ||
}} | }} | ||
=== Video output === | === Video output === | ||
{{Option | {{Option | ||
|name=dummy-chroma | |name=dummy-chroma | ||
| Line 52: | Line 61: | ||
|description=Force the dummy video output to create images using a specific [[chroma]] format instead of trying to improve performances by using the most efficient one. | |description=Force the dummy video output to create images using a specific [[chroma]] format instead of trying to improve performances by using the most efficient one. | ||
}} | }} | ||
== Source code == | == Source code == | ||
{{ | * {{VLCSourceFile|modules/access/idummy.c|Access}} | ||
{{ | * {{VLCSourceFile|modules/access_output/dummy.c|Access output}} | ||
{{ | * {{VLCSourceFile|modules/audio_output/adummy.c|Audio output}} | ||
{{ | * {{VLCSourceFile|modules/codec/ddummy.c|Decoder}} | ||
{{ | * {{VLCSourceFile|modules/codec/edummy.c|Encoder}} | ||
{{ | * {{VLCSourceFile|modules/control/dummy.c|Interface}} | ||
{{ | * {{VLCSourceFile|modules/mux/dummy.c|Output muxer}} | ||
{{ | * {{VLCSourceFile|modules/stream_out/dummy.c|Stream output}} | ||
{{ | * {{VLCSourceFile|modules/text_renderer/tdummy.c|Text rendering}} | ||
{{ | * {{VLCSourceFile|modules/video_output/vdummy.c|Video output}} | ||
{{ | * {{VLCSourceFile|modules/video_output/wdummy.c|Video output for legacy video plugins}} | ||
{{Documentation}} | {{Documentation}} | ||
Latest revision as of 20:08, 29 May 2019
Dummy modules are the VLC equivalent of /dev/null on GNU/Linux: they represent doing nothing.
List
| Type | Description | Shortcut(s) |
|---|---|---|
| Access | Dummy input | dummy, vlc |
| Access output | Dummy stream output | dummy |
| Audio output | Dummy audio output | dummy |
| Decoder | Dummy decoder | dummy, dump |
| Encoder | Dummy encoder | dummy |
| Control interface | Dummy interface | (none) |
| Muxer | Dummy/Raw muxer | dummy, raw, es |
| Stream output | Dummy stream output | dummy, drop |
| Text renderer | Dummy font renderer | (none) |
| Video output | Dummy video output | dummy, stats |
| Video output (legacy video plugins) | Dummy window | dummy |
Descriptions
Interface
A dummy interface works well with command-line usage. It consumes fewer computing resources, something that can be used to reduce a bottleneck effect during transcoding, or simply when opening a window makes little sense.
This will play an Ogg file with no interface:
$ vlc -I dummy audio.ogg vlc://quit
No window is launched, and control is returned to the calling application after the file plays.
This will play a Schroedinger file with a minimalist interface:
$ vlc -I dummy video.drc vlc://quit
A window with no buttons or toolbars is launched (no skin), because video output requires a window. Hotkeys may be used to control playback by default, something that can be disabled if necessary with --no-keyboard-events.
Stream output
Doesn't do anything. Can be used to test other stream output chain modules without actually streaming anything.
Options
Dummy decoder
- dummy-save-es <boolean> : Save the raw codec data if you have selected/forced the dummy decoder in the main options. default value: disabled
Video output
- dummy-chroma <string> : Force the dummy video output to create images using a specific chroma format instead of trying to improve performances by using the most efficient one. default value: NULL
Source code
- modules/access/idummy.c (Access)
- modules/access_output/dummy.c (Access output)
- modules/audio_output/adummy.c (Audio output)
- modules/codec/ddummy.c (Decoder)
- modules/codec/edummy.c (Encoder)
- modules/control/dummy.c (Interface)
- modules/mux/dummy.c (Output muxer)
- modules/stream_out/dummy.c (Stream output)
- modules/text_renderer/tdummy.c (Text rendering)
- modules/video_output/vdummy.c (Video output)
- modules/video_output/wdummy.c (Video output for legacy video 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.