GstParse

Gst.ParseContext

Gst.ParseContext.prototype.new

function Gst.ParseContext.prototype.new(): {
    // javascript wrapper for 'gst_parse_context_new'
}

Allocates a parse context for use with Gst.prototype.parse_launch_full or Gst.prototype.parse_launchv_full.

Free-function: gst_parse_context_free

Gst.ParseContext.prototype.copy

function Gst.ParseContext.prototype.copy(): {
    // javascript wrapper for 'gst_parse_context_copy'
}

Copies the context.

Since : 1.12.1

Gst.ParseContext.prototype.free

function Gst.ParseContext.prototype.free(): {
    // javascript wrapper for 'gst_parse_context_free'
}

Frees a parse context previously allocated with Gst.ParseContext.prototype.new.

Gst.ParseContext.prototype.get_missing_elements

function Gst.ParseContext.prototype.get_missing_elements(): {
    // javascript wrapper for 'gst_parse_context_get_missing_elements'
}

Retrieve missing elements from a previous run of Gst.prototype.parse_launch_full or Gst.prototype.parse_launchv_full. Will only return results if an error code of Gst.ParseError.NO_SUCH_ELEMENT was returned.

Gst.ParseContext.prototype.get_untrusted_report

function Gst.ParseContext.prototype.get_untrusted_report(): {
    // javascript wrapper for 'gst_parse_context_get_untrusted_report'
}

Retrieve what a previous run of Gst.prototype.parse_launch_full or Gst.prototype.parse_launchv_full refused because Gst.ParseFlags.NO_UNTRUSTED was set, so an application can tell the user exactly what a description was refused for and decide whether to build it in a trusted mode.

Everything that was refused is listed, whichever error the parse reported. The result is a Gst.Structure named untrusted-content with:

• elements: a list of the factory names that are not marked untrusted-aware, see Gst.ElementClass.prototype.mark_as_untrusted_aware. Absent when no element was refused.
• properties: a Gst.Structure named untrusted-sensitive-properties, with one field per refused assignment named element-name:property, where element-name is the unique name of the element instance and property is the property as written in the description, possibly a child::property path. The field holds the refused value, parsed into the property's own type when that type is known and parsing the value cannot have side effects, and the string as written otherwise. A refused value is never handed to the property setter. Absent when no property was refused.
• unresolved-properties: a Gst.Structure named untrusted-unresolved-properties, same field shape, for assignments to a child that never materialized during the parse (demuxer pads and other runtime-only children). The value is always the string as written, since the property type is not known. Absent when no such assignment was refused.

Gst.prototype.parse_untrusted_report unpacks these fields without knowing the layout.

Since : 1.30

Gst.prototype.parse_error_quark

function Gst.prototype.parse_error_quark(): {
    // javascript wrapper for 'gst_parse_error_quark'
}

Get the error quark used by the parsing subsystem.

Gst.prototype.parse_launch

function Gst.prototype.parse_launch(pipeline_description: String): {
    // javascript wrapper for 'gst_parse_launch'
}

Create a new pipeline based on command line syntax. Please note that you might get a return value that is not null even though the error is set. In this case there was a recoverable parsing error and you can try to play the pipeline.

To create a sub-pipeline (bin) for embedding into an existing pipeline use Gst.prototype.parse_bin_from_description.

Gst.prototype.parse_launch_full

function Gst.prototype.parse_launch_full(pipeline_description: String, context: Gst.ParseContext, flags: Gst.ParseFlags): {
    // javascript wrapper for 'gst_parse_launch_full'
}

Create a new pipeline based on command line syntax. Please note that you might get a return value that is not null even though the error is set. In this case there was a recoverable parsing error and you can try to play the pipeline.

To create a sub-pipeline (bin) for embedding into an existing pipeline use Gst.prototype.parse_bin_from_description_full.

Gst.prototype.parse_launchv

function Gst.prototype.parse_launchv(argv: [ String ]): {
    // javascript wrapper for 'gst_parse_launchv'
}

Create a new element based on command line syntax. error will contain an error message if an erroneous pipeline is specified. An error does not mean that the pipeline could not be constructed.

Gst.prototype.parse_launchv_full

function Gst.prototype.parse_launchv_full(argv: [ String ], context: Gst.ParseContext, flags: Gst.ParseFlags): {
    // javascript wrapper for 'gst_parse_launchv_full'
}

Create a new element based on command line syntax. error will contain an error message if an erroneous pipeline is specified. An error does not mean that the pipeline could not be constructed.

Gst.prototype.parse_untrusted_report

function Gst.prototype.parse_untrusted_report(report: Gst.Structure): {
    // javascript wrapper for 'gst_parse_untrusted_report'
}

Unpacks an untrusted-content report into its parts, so a caller does not have to know the field names and nesting the structure uses. Each output is filled with the corresponding part when it is present, and set to null when it is not; pass null for the parts you do not care about.

Since : 1.30

Gst.ParseError

The different parsing errors that can occur.

Gst.ParseFlags

Parsing options.