jackaudiosrc
A Src that inputs data from Jack ports.
It will create N Jack ports named in_<name>_<num> where <name> is the element name and <num> is starting from 1. Each port corresponds to a gstreamer channel.
The samplerate as exposed on the caps is always the same as the samplerate of the jack server.
When the connect property is set to auto, this element will try to connect each input port to a random physical jack output pin.
When the connect property is set to none, the element will accept any number of output channels and will create (but not connect) an input port for each channel.
The element will generate an error when the Jack server is shut down when it was PAUSED or PLAYING. This element does not support dynamic rate and buffer size changes at runtime.
Example launch line
gst-launch-1.0 jackaudiosrc connect=0 ! jackaudiosink connect=0
Get audio input into gstreamer from jack.
Hierarchy
GObject ╰──GInitiallyUnowned ╰──GstObject ╰──GstElement ╰──GstBaseSrc ╰──GstPushSrc ╰──GstAudioBaseSrc ╰──jackaudiosrc
Factory details
Authors: – Tristan Matthews
Classification: – Source/Audio
Rank – primary
Plugin – gstjack
Package – GStreamer Good Plug-ins
Pad Templates
src
audio/x-raw:
format: F32LE
layout: interleaved
rate: [ 1, 2147483647 ]
channels: [ 1, 2147483647 ]
Properties
actual-buffer-time
“actual-buffer-time” gint64
Actual configured size of audio buffer in microseconds
Flags : Read
Default value : 18446744073709551615
actual-latency-time
“actual-latency-time” gint64
Actual configured audio latency in microseconds
Flags : Read
Default value : 18446744073709551615
blocksize
“blocksize” guint
Size in bytes to read per buffer (-1 = default)
Flags : Read / Write
Default value : 0
buffer-time
“buffer-time” gint64
Size of audio buffer in microseconds. This is the maximum amount of data that is buffered in the device and the maximum latency that the source reports. This value might be ignored by the element if necessary; see "actual-buffer-time"
Flags : Read / Write
Default value : 200000
client-name
“client-name” gchararray
The client name to use.
Flags : Read / Write
Default value : NULL
connect
“connect” GstJackConnect *
Specify how the input ports will be connected
Flags : Read / Write
Default value : auto (1)
do-timestamp
“do-timestamp” gboolean
Apply current stream time to buffers
Flags : Read / Write
Default value : false
latency-time
“latency-time” gint64
The minimum amount of data to read in each iteration in microseconds. This is the minimum latency that the source reports. This value might be ignored by the element if necessary; see "actual-latency-time"
Flags : Read / Write
Default value : 10000
num-buffers
“num-buffers” gint
Number of buffers to output before sending EOS (-1 = unlimited)
Flags : Read / Write
Default value : -1
port-pattern
“port-pattern” gchararray
autoconnect to ports matching pattern, when NULL connect to physical ports
Flags : Read / Write
Default value : NULL
provide-clock
“provide-clock” gboolean
Provide a clock to be used as the global pipeline clock
Flags : Read / Write
Default value : true
server
“server” gchararray
The Jack server to connect to (NULL = default)
Flags : Read / Write
Default value : NULL
slave-method
“slave-method” GstAudioBaseSrcSlaveMethod *
Algorithm used to match the rate of the masterclock
Flags : Read / Write
Default value : skew (2)
transport
“transport” GstJackTransport *
Jack transport behaviour of the client
Flags : Read / Write
Default value : (none)
typefind
“typefind” gboolean
Run typefind before negotiating (deprecated, non-functional)
Flags : Read / Write
Default value : false
Named constants
GstJackConnect
Specify how the output ports will be connected.
Members
none
(0) – Don't automatically connect ports to physical ports
auto
(1) – Automatically connect ports to physical ports
auto-forced
(2) – Automatically connect ports to as many physical ports as possible
GstJackTransport
The jack transport state allow to sync multiple clients. This enum defines a client behaviour regarding to the transport mechanism.
Members
master
(0x00000001) – Start and stop transport with state changes
slave
(0x00000002) – Follow transport state changes
The results of the search are