vorbisenc

This element encodes raw float audio into a Vorbis stream. Vorbis is a royalty-free audio codec maintained by the Xiph.org Foundation.

Example pipelines

 gst-launch-1.0 -v audiotestsrc wave=sine num-buffers=100 ! audioconvert ! vorbisenc ! oggmux ! filesink location=sine.ogg

Encode a test sine signal to Ogg/Vorbis. Note that the resulting file will be really small because a sine signal compresses very well.

 gst-launch-1.0 -v autoaudiosrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=alsasrc.ogg

Record from a sound card and encode to Ogg/Vorbis.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──GstAudioEncoder
                    ╰──vorbisenc

Factory details

Authors: – Monty , Wim Taymans

Classification:Codec/Encoder/Audio

Rank – primary

Plugin – gstvorbis

Package – GStreamer Base Plug-ins git

Pad Templates

sink

audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 1
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 2
   channel-mask: 0x0000000000000003
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 3
   channel-mask: 0x0000000000000007
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 4
   channel-mask: 0x0000000000000033
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 5
   channel-mask: 0x0000000000000037
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 6
   channel-mask: 0x000000000000003f
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 7
   channel-mask: 0x0000000000000d0f
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: 8
   channel-mask: 0x0000000000000c3f
audio/x-raw:
         format: F32LE
         layout: interleaved
           rate: [ 1, 200000 ]
       channels: [ 9, 255 ]
   channel-mask: 0x0000000000000000

Presencealways

Directionsink


src

audio/x-vorbis:
           rate: [ 1, 200000 ]
       channels: [ 1, 255 ]

Presencealways

Directionsrc


Properties

bitrate

“bitrate” gint

Attempt to encode at a bitrate averaging this (in bps). This uses the bitrate management engine, and is not recommended for most users. Quality is a better alternative. (-1 == disabled)

Flags : Read / Write

Default value : -1


hard-resync

“hard-resync” gboolean

Perform clipping and sample flushing upon discontinuity

Flags : Read / Write

Default value : false


last-message

“last-message” gchararray

The last status message

Flags : Read

Default value : NULL


managed

“managed” gboolean

Enable bitrate management engine

Flags : Read / Write

Default value : false


mark-granule

“mark-granule” gboolean

Apply granule semantics to buffer metadata (implies perfect-timestamp)

Flags : Read

Default value : true


max-bitrate

“max-bitrate” gint

Specify a maximum bitrate (in bps). Useful for streaming applications. (-1 == disabled)

Flags : Read / Write

Default value : -1


min-bitrate

“min-bitrate” gint

Specify a minimum bitrate (in bps). Useful for encoding for a fixed-size channel. (-1 == disabled)

Flags : Read / Write

Default value : -1


name

“name” gchararray

The name of the object

Flags : Read / Write / Construct

Default value : NULL


parent

“parent” GstObject *

The parent of the object

Flags : Read / Write


perfect-timestamp

“perfect-timestamp” gboolean

Favour perfect timestamps over tracking upstream timestamps

Flags : Read / Write

Default value : true


quality

“quality” gfloat

Specify quality instead of specifying a particular bitrate.

Flags : Read / Write

Default value : 0.3


tolerance

“tolerance” gint64

Consider discontinuity if timestamp jitter/imperfection exceeds tolerance (ns)

Flags : Read / Write

Default value : 40000000


The results of the search are