gstreamer/subprojects/gst-devtools/docs/gst-validate-action-types.md

GstValidate action types

meta

meta,
    [duration=(double, int)],
    [handles-states=(boolean)],
    [ignore-eos=(boolean)],
    [is-config=(boolean)],
    [max-dropped=(int)],
    [max-latency=(double, int)],
    [min-audio-track=(int)],
    [min-media-duration=(double)],
    [min-video-track=(int)],
    [need-clock-sync=(boolean)],
    [pipeline-name=(string)],
    [reverse-playback=(boolean)],
    [seek=(boolean)],
    [summary=(string)];

Scenario metadata. NOTE: it used to be called "description"

• Implementer namespace: core
• Is config action (meaning it will be executing right at the beginning of the execution of the pipeline)

Parameters

• duration:(optional): Lets the user know the time the scenario needs to be fully executed

  Possible types: double, int

  Default: infinite (GST_CLOCK_TIME_NONE)

• handles-states:(optional): Whether the scenario handles pipeline state changes from the beginning in that case the application should not set the state of the pipeline to anything and the scenario action will be executed from the beginning

  Possible types: boolean

  Default: false

• ignore-eos:(optional): Ignore EOS and keep executing the scenario when it happens. By default a 'stop' action is generated one EOS

  Possible types: boolean

  Default: false

• is-config:(optional): Whether the scenario is a config only scenario

  Possible types: boolean

  Default: false

• max-dropped:(optional): The maximum number of buffers which can be dropped by the QoS system allowed for this pipeline. It can be overridden using core configuration, like for example by defining the env variable GST_VALIDATE_CONFIG=core,max-dropped=100

  Possible types: int

  Default: infinite (-1)

• max-latency:(optional): The maximum latency in nanoseconds allowed for this pipeline. It can be overridden using core configuration, like for example by defining the env variable GST_VALIDATE_CONFIG=core,max-latency=33000000

  Possible types: double, int

  Default: infinite (GST_CLOCK_TIME_NONE)

• min-audio-track:(optional): Lets the user know the minimum number of audio tracks the stream needs to contain for the scenario to be usable

  Possible types: int

  Default: 0

• min-media-duration:(optional): Lets the user know the minimum duration of the stream for the scenario to be usable

  Possible types: double

  Default: 0.0

• min-video-track:(optional): Lets the user know the minimum number of video tracks the stream needs to contain for the scenario to be usable

  Possible types: int

  Default: 0

• need-clock-sync:(optional): Whether the scenario needs the execution to be synchronized with the pipeline's clock. Letting the user know if it can be used with a 'fakesink sync=false' sink

  Possible types: boolean

  Default: true if some action requires a playback-time false otherwise

• pipeline-name:(optional): The name of the GstPipeline on which the scenario should be executed. It has the same effect as setting the pipeline using pipeline_name->scenario_name.

  Possible types: string

  Default: NULL

• reverse-playback:(optional): Whether the scenario plays the stream backward

  Possible types: boolean

  Default: false

• seek:(optional): Whether the scenario executes seek actions or not

  Possible types: boolean

  Default: false

• summary:(optional): Whether the scenario is a config only scenario (ie. explain what it does)

  Possible types: string

  Default: 'Nothing'

seek

seek,
    flags=(string describing the GstSeekFlags to set),
    start=(double or string (GstClockTime)),
    [rate=(double)],
    [start_type=(string)],
    [stop=(double or string (GstClockTime))],
    [stop_type=(string)],
    [playback-time=(double,string)];

Seeks into the stream. This is an example of a seek happening when the stream reaches 5 seconds or 1 eighth of its duration and seeks to 10s or 2 eighths of its duration: seek, playback-time="min(5.0, (duration/8))", start="min(10, 2*(duration/8))", flags=accurate+flush

• Implementer namespace: core

Parameters

• flags:(mandatory): The GstSeekFlags to use

  Possible types: string describing the GstSeekFlags to set

• start:(mandatory): The starting value of the seek

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double or string (GstClockTime)

• rate:(optional): The rate value of the seek

  Possible types: double

  Default: 1.0

• start_type:(optional): The GstSeekType to use for the start of the seek, in: [none, set, end]

  Possible types: string

  Default: set

• stop:(optional): The stop value of the seek

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double or string (GstClockTime)

  Default: GST_CLOCK_TIME_NONE

• stop_type:(optional): The GstSeekType to use for the stop of the seek, in: [none, set, end]

  Possible types: string

  Default: set

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

pause

pause,
    [duration=(double or string (GstClockTime))],
    [playback-time=(double,string)];

Sets pipeline to PAUSED. You can add a 'duration' parameter so the pipeline goes back to playing after that duration (in second)

• Implementer namespace: core

Parameters

• duration:(optional): The duration during which the stream will be paused

  Possible types: double or string (GstClockTime)

  Default: 0.0

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

play

play,
    [playback-time=(double,string)];

Sets the pipeline state to PLAYING

• Implementer namespace: core

Parameters

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

stop

stop,
    [playback-time=(double,string)];

Stops the execution of the scenario. It will post a 'request-state' message on the bus with NULL as a requested state and the application is responsible for stopping itself. If you override that action type, make sure to link up.

• Implementer namespace: core

Parameters

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

eos

eos,
    [playback-time=(double,string)];

Sends an EOS event to the pipeline

• Implementer namespace: core

Parameters

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

switch-track

switch-track,
    [index=(string: to switch track relatively
int: To use the actual index to use)],
    [type=(string)],
    [playback-time=(double,string)];

The 'switch-track' command can be used to switch tracks.

• Implementer namespace: core

Parameters

• index:(optional): Selects which track of this type to use: it can be either a number, which will be the Nth track of the given type, or a number with a '+' or '-' prefix, which means a relative change (eg, '+1' means 'next track', '-1' means 'previous track')

  Possible types: string: to switch track relatively int: To use the actual index to use

  Default: +1

• type:(optional): Selects which track type to change (can be 'audio', 'video', or 'text').

  Possible types: string

  Default: audio

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

wait

wait,
    [duration=(double or string (GstClockTime))],
    [message-type=(string)],
    [signal-name=(string)],
    [target-element-name=(string)],
    [playback-time=(double,string)];

Waits for signal 'signal-name', message 'message-type', or during 'duration' seconds

• Implementer namespace: core

Parameters

• duration:(optional): the duration while no other action will be executed

  Possible types: double or string (GstClockTime)

  Default: (null)

• message-type:(optional): The name of the message type to wait for (on @target-element-name if specified)

  Possible types: string

  Default: (null)

• signal-name:(optional): The name of the signal to wait for on @target-element-name

  Possible types: string

  Default: (null)

• target-element-name:(optional): The name of the GstElement to wait @signal-name on.

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

dot-pipeline

dot-pipeline,
    [playback-time=(double,string)];

Dots the pipeline (the 'name' property will be used in the dot filename). For more information have a look at the GST_DEBUG_BIN_TO_DOT_FILE documentation. Note that the GST_DEBUG_DUMP_DOT_DIR env variable needs to be set

• Implementer namespace: core

Parameters

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

set-rank

set-rank,
    name=(string),
    rank=(string, int);

Changes the ranking of a particular plugin feature(s)

• Implementer namespace: core
• Is config action (meaning it will be executing right at the beginning of the execution of the pipeline)

Parameters

• name:(mandatory): The name of a GstFeature or GstPlugin

  Possible types: string

• rank:(mandatory): The GstRank to set on @name

  Possible types: string, int

set-feature-rank

set-feature-rank,
    feature-name=(string),
    rank=(string, int);

Changes the ranking of a particular plugin feature

• Implementer namespace: core
• Is config action (meaning it will be executing right at the beginning of the execution of the pipeline)

Parameters

• feature-name:(mandatory): The name of a GstFeature

  Possible types: string

• rank:(mandatory): The GstRank to set on @feature-name

  Possible types: string, int

set-state

set-state,
    state=(string),
    [playback-time=(double,string)];

Changes the state of the pipeline to any GstState

• Implementer namespace: core

Parameters

• state:(mandatory): A GstState as a string, should be in:

  • ['null', 'ready', 'paused', 'playing']

  Possible types: string

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

set-vars

set-vars,
    [playback-time=(double,string)];

Define vars to be used in other actions. For example you can define vars for buffer checksum to be used in the "check-last-sample" action type as follow:

 set-vars, frame1=SomeRandomHash1,frame2=Anotherhash...
 check-last-sample, checksum=frame1

• Implementer namespace: core

Parameters

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

set-property

set-property,
    property-name=(string),
    property-value=(The same type of @property-name),
    [target-element-factory-name=(string)],
    [target-element-klass=(string)],
    [target-element-name=(string)],
    [playback-time=(double,string)];

Sets a property of an element or klass of elements in the pipeline. Besides property-name and value, either 'target-element-name' or 'target-element-klass' needs to be defined

• Implementer namespace: core

Parameters

• property-name:(mandatory): The name of the property to set on @target-element-name

  Possible types: string

• property-value:(mandatory): The value of @property-name to be set on the element

  Possible types: The same type of @property-name

• target-element-factory-name:(optional): The name factory for which to set a property on built elements

  Possible types: string

  Default: (null)

• target-element-klass:(optional): The klass of the GstElements to set a property on

  Possible types: string

  Default: (null)

• target-element-name:(optional): The name of the GstElement to set a property on

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null) optional : Don't raise an error if this action hasn't been executed or failed ### Possible types: boolean Default: false

check-property

check-property,
    property-name=(string),
    property-value=(The same type of @property-name),
    [target-element-factory-name=(string)],
    [target-element-klass=(string)],
    [target-element-name=(string)],
    [playback-time=(double,string)];

Check the value of property of an element or klass of elements in the pipeline. Besides property-name and value, either 'target-element-name' or 'target-element-klass' needs to be defined

• Implementer namespace: core

Parameters

• property-name:(mandatory): The name of the property to set on @target-element-name

  Possible types: string

• property-value:(mandatory): The expected value of @property-name

  Possible types: The same type of @property-name

• target-element-factory-name:(optional): The name factory for which to check a property value on built elements

  Possible types: string

  Default: (null)

• target-element-klass:(optional): The klass of the GstElements to check a property on

  Possible types: string

  Default: (null)

• target-element-name:(optional): The name of the GstElement to check a property value

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

set-debug-threshold

set-debug-threshold,
    debug-threshold=(string),
    [playback-time=(double,string)];

Sets the debug level to be used, same format as setting the GST_DEBUG env variable

• Implementer namespace: core

Parameters

• debug-threshold:(mandatory): String defining debug threshold See gst_debug_set_threshold_from_string

  Possible types: string

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

emit-signal

emit-signal,
    signal-name=(string),
    target-element-name=(string),
    [playback-time=(double,string)];

Emits a signal to an element in the pipeline

• Implementer namespace: core

Parameters

• signal-name:(mandatory): The name of the signal to emit on @target-element-name

  Possible types: string

• target-element-name:(mandatory): The name of the GstElement to emit a signal on

  Possible types: string

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

appsrc-push

appsrc-push,
    file-name=(string),
    target-element-name=(string),
    [caps=(caps)],
    [offset=(uint64)],
    [size=(uint64)],
    [playback-time=(double,string)];

Queues a buffer in an appsrc. If the pipeline state allows flow of buffers, the next action is not run until the buffer has been pushed.

• Implementer namespace: core

Parameters

• file-name:(mandatory): Relative path to a file whose contents will be pushed as a buffer

  Possible types: string

• target-element-name:(mandatory): The name of the appsrc to push data on

  Possible types: string

• caps:(optional): Caps for the buffer to be pushed

  Possible types: caps

  Default: (null)

• offset:(optional): Offset within the file where the buffer will start

  Possible types: uint64

  Default: (null)

• size:(optional): Number of bytes from the file that will be pushed as a buffer

  Possible types: uint64

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

appsrc-eos

appsrc-eos,
    target-element-name=(string),
    [playback-time=(double,string)];

Queues a EOS event in an appsrc.

• Implementer namespace: core

Parameters

• target-element-name:(mandatory): The name of the appsrc to emit EOS on

  Possible types: string

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

flush

flush,
    target-element-name=(string),
    [reset-time=(boolean)],
    [playback-time=(double,string)];

Sends FLUSH_START and FLUSH_STOP events.

• Implementer namespace: core

Parameters

• target-element-name:(mandatory): The name of the appsrc to flush on

  Possible types: string

• reset-time:(optional): Whether the flush should reset running time

  Possible types: boolean

  Default: TRUE

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

disable-plugin

disable-plugin,
    plugin-name=(string),
    [as-config=(boolean)],
    [playback-time=(double,string)];

Disables a GstPlugin

• Implementer namespace: core

Parameters

• plugin-name:(mandatory): The name of the GstPlugin to disable

  Possible types: string

• as-config:(optional): Execute action as a config action (meaning when loading the scenario)

  Possible types: boolean

  Default: false

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

check-last-sample

check-last-sample,
    [checksum=(string)],
    [sink-factory-name=(string)],
    [sink-name=(string)],
    [sinkpad-caps=(string)],
    [timecode-frame-number=(string)],
    [playback-time=(double,string)];

Checks the last-sample checksum or frame number (set on its GstVideoTimeCodeMeta) on declared Sink element. This allows checking the checksum of a buffer after a 'seek' or after a GESTimeline 'commit' for example

• Implementer namespace: core

Parameters

• checksum:(optional): The reference checksum of the buffer.

  Possible types: string

  Default: (null)

• sink-factory-name:(optional): The name of the factory of the sink element to check sample on.

  Possible types: string

  Default: (null)

• sink-name:(optional): The name of the sink element to check sample on.

  Possible types: string

  Default: (null)

• sinkpad-caps:(optional): The caps (as string) of the sink to check.

  Possible types: string

  Default: (null)

• timecode-frame-number:(optional): The frame number of the buffer as specified on its GstVideoTimeCodeMeta

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

crank-clock

crank-clock,
    [checksum=(string)],
    [expected-elapsed-time=(GstClockTime)],
    [expected-time=(GstClockTime)],
    [sinkpad-caps=(string)],
    [timecode-frame-number=(string)],
    [playback-time=(double,string)];

Crank the clock, possibly checking how much time was supposed to be waited on the clock and/or the clock running time after the crank. Using one crank-clock action in a scenario implies that the scenario is driving the clock and a #GstTestClock will be used. The user will need to crank it the number of time required (using the repeat parameter comes handy here).

• Implementer namespace: core

Parameters

• checksum:(optional): The reference checksum of the buffer.

  Possible types: string

  Default: (null)

• expected-elapsed-time:(optional): Check time elapsed during the clock cranking

  Possible types: GstClockTime

  Default: (null)

• expected-time:(optional): Expected clock time after cranking

  Possible types: GstClockTime

  Default: (null)

• sinkpad-caps:(optional): The caps (as string) of the sink to check.

  Possible types: string

  Default: (null)

• timecode-frame-number:(optional): The frame number of the buffer as specified on its GstVideoTimeCodeMeta

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

video-request-key-unit

video-request-key-unit,
    direction=(string),
    [all-headers=(boolean)],
    [count=(int)],
    [pad=(string)],
    [running-time=(double or string)],
    [srcpad=(string)],
    [target-element-factory-name=(string)],
    [target-element-klass=(string)],
    [target-element-name=(string)],
    [playback-time=(double,string)];

Request a video key unit

• Implementer namespace: core

Parameters

• direction:(mandatory): The direction for the event to travel, should be in

  • [upstream, downstream]

  Possible types: string

• all-headers:(optional): TRUE to produce headers when starting a new key unit

  Possible types: boolean

  Default: FALSE

• count:(optional): integer that can be used to number key units

  Possible types: int

  Default: 0

• pad:(optional): The name of the GstPad to send a send force-key-unit to

  Possible types: string

  Default: sink

• running-time:(optional): The running_time can be set to request a new key unit at a specific running_time. If not set, GST_CLOCK_TIME_NONE will be used so upstream elements will produce a new key unit as soon as possible.

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double or string

  Default: (null)

• srcpad:(optional): The name of the GstPad to send a send force-key-unit to

  Possible types: string

  Default: src

• target-element-factory-name:(optional): The factory name of the GstElements to send a send force-key-unit to

  Possible types: string

  Default: (null)

• target-element-klass:(optional): The klass of the GstElements to send a send force-key-unit to

  Possible types: string

  Default: Video/Encoder

• target-element-name:(optional): The name of the GstElement to send a send force-key-unit to

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

check-position

check-position,
    expected-position=(GstClockTime),
    [all-headers=(boolean)],
    [count=(int)],
    [pad=(string)],
    [running-time=(double or string)],
    [srcpad=(string)],
    [target-element-factory-name=(string)],
    [target-element-klass=(string)],
    [target-element-name=(string)],
    [playback-time=(double,string)];

Check current pipeline position.

• Implementer namespace: core

Parameters

• expected-position:(mandatory): The expected pipeline position

  Possible types: GstClockTime

• all-headers:(optional): TRUE to produce headers when starting a new key unit

  Possible types: boolean

  Default: FALSE

• count:(optional): integer that can be used to number key units

  Possible types: int

  Default: 0

• pad:(optional): The name of the GstPad to send a send force-key-unit to

  Possible types: string

  Default: sink

• running-time:(optional): The running_time can be set to request a new key unit at a specific running_time. If not set, GST_CLOCK_TIME_NONE will be used so upstream elements will produce a new key unit as soon as possible.

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double or string

  Default: (null)

• srcpad:(optional): The name of the GstPad to send a send force-key-unit to

  Possible types: string

  Default: src

• target-element-factory-name:(optional): The factory name of the GstElements to send a send force-key-unit to

  Possible types: string

  Default: (null)

• target-element-klass:(optional): The klass of the GstElements to send a send force-key-unit to

  Possible types: string

  Default: Video/Encoder

• target-element-name:(optional): The name of the GstElement to send a send force-key-unit to

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

corrupt-socket-recv

corrupt-socket-recv,
    errno=(string),
    port=(int),
    [times=(int)],
    [playback-time=(double,string)];

corrupt the next socket receive

• Implementer namespace: validatefaultinjection

Parameters

• errno:(mandatory): errno to set when failing

  Possible types: string

• port:(mandatory): The port the socket to be corrupted listens on

  Possible types: int

• times:(optional): Number of times to corrupt recv, default is one

  Possible types: int

  Default: 1

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

gtk-put-event

gtk-put-event,
    [keys=(string)],
    [string=(string)],
    [type=(string)],
    [widget-name=(string)],
    [playback-time=(double,string)];

Put a GdkEvent on the event list using gdk_put_event

• Implementer namespace: validategtk

Parameters

• keys:(optional): The keyboard keys to be used for the event, parsed with gtk_accelerator_parse_with_keycode, so refer to its documentation for more information

  Possible types: string

  Default: (null)

• string:(optional): The string to be 'written' by the keyboard sending KEY_PRESS GdkEvents

  Possible types: string

  Default: (null)

• type:(optional): The event type to get executed. the string should look like the ones in GdkEventType but without the leading 'GDK_'. It is not mandatory as it can be computed from other present fields (e.g, an action with 'keys' will consider the type as 'key_pressed' by default).

  Possible types: string

  Default: (null)

• widget-name:(optional): The name of the target GdkWidget of the GdkEvent. That widget has to contain a GdkWindow. If not specified, the event will be sent to the first toplevel window

  Possible types: string

  Default: (null)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)

set-subtitle

set-subtitle,
    subtitle-file=(string (A URI)),
    [playback-time=(double,string)];

Action to set a subtitle file to use on a playbin pipeline. The subtitles file that will be used should be specified relative to the playbin URI in use thanks to the subtitle-file action property. You can also specify a folder with subtitle-dir For example if playbin.uri='file://some/uri.mov' and action looks like 'set-subtitle, subtitle-file=en.srt' the subtitle URI will be set to 'file:///some/uri.mov.en.srt'

• Implementer namespace: validate-launcher

Parameters

• subtitle-file:(mandatory): Sets a subtitles file on a playbin pipeline

  Possible types: string (A URI)

• playback-time:(optional): The playback time at which the action will be executed

  Possible variables:

  • position: The current position in the stream

  • duration: The duration of the stream

  Possible types: double,string

  Default: 0.0

• on-message:(optional): Specify on what message type the action will be executed. If both 'playback-time' and 'on-message' is specified, the action will be executed on whatever happens first.

  Possible types: string

  Default: (null)