File: gst_custom_elements.rst

package info (click to toggle)
linux-show-player 0.5.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 4,896 kB
  • sloc: python: 12,408; sh: 154; makefile: 17; xml: 8
file content (63 lines) | stat: -rw-r--r-- 1,899 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
GStreamer Backend - Custom Elements
===================================

One of the most used functionality of GStreamer is the ability to create pipelines
from a text description, usually this is done from a CLI interface (e.g. on a terminal)
using the ``gst-launch`` program, in LiSP it's possible to create a custom media-element
using this functionality.

Element Syntax
--------------

From this point ``element(s)`` refer to a GStreamer component and not to LiSP.

Properties
^^^^^^^^^^

*PROPERTY=VALUE*

Sets the property to the specified value. You can use ``gst-inspect`` to find out
about properties and allowed values of different elements.

Elements
^^^^^^^^

*ELEMENT-TYPE [PROPERTY_1 ...]*

Creates an element of type *ELEMENT-TYPE* and sets its *PROPERTIES*.

Links
^^^^^

*ELEMENT_1 ! ELEMENT_2 ! ELEMENT_3*

The simplest link (exclamation mark) connects two adjacent elements. The elements
are connect starting from the left.

Examples
^^^^^^^^

The examples below assume that you have the correct plug-ins available.
Keep in mind that different elements might accept different formats, so you might
need to add converter elements like ``audioconvert`` and ``audioresample`` (for audio)
in front of the element to make things work.

**Add an echo effect to the audio:**

``audioecho delay=500000000 intensity=0.2 feedback=0.3``

**Add a reverb effect to the audio:**

``audioecho delay=20000000 intensity=0.4 feedback=0.45``

**Removes voice from sound (or at least try to do so):**

``audiokaraoke filter-band=200 filter-width=120``

**Remove voice from sound and (then) apply a reverb effect:**

``audiokaraoke filter-band=200 filter-width=120 ! audioecho delay=20000000 intensity=0.4 feedback=0.45``

--------------------------------------------------------------------------------

Extracted from the `GStreamer SDK docs <http://docs.gstreamer.com/display/GstSDK/gst-launch>`_