Functions

add_missing_uri_relocation_uri (uri, recurse)

deinit ()

edge_name (edge)

edit_mode_name (mode)

find_formatter_for_uri (uri)

init ()

init_check (argv)

is_initialized ()

list_assets (filter)

play_sink_convert_frame (playsink, caps)

pspec_equal (key_spec_1, key_spec_2)

pspec_hash (key_spec)

track_type_name (type)

validate_register_action_types ()

version ()

Details

GES.add_missing_uri_relocation_uri(uri, recurse)[source]
Parameters:
Return type:

bool

GES.deinit()[source]

Clean up any resources created by GES in GES.init().

It is normally not needed to call this function in a normal application as the resources will automatically be freed when the program terminates. This function is therefore mostly used by testsuites and other memory profiling tools. This function should be called from the thread where GES.init() was called.

After this call GES should not be used until another GES.init() call.

GES.edge_name(edge)[source]
Parameters:

edge (GES.Edge) – The GES.Edge to get the name of

Returns:

A human friendly name for edge

Return type:

str

New in version 1.16.

GES.edit_mode_name(mode)[source]
Parameters:

mode (GES.EditMode) – a GES.EditMode

Returns:

a string representation of mode.

Return type:

str

Return a string representation of mode.

New in version 1.18.

GES.find_formatter_for_uri(uri)[source]
Parameters:

uri (str) –

Returns:

The GES.Asset for the best formatter to save to uri

Return type:

GES.Asset

Get the best formatter for uri. It tries to find a formatter compatible with uri extension, if none is found, it returns the default formatter asset.

New in version 1.18.

GES.init()[source]
Return type:

bool

Initialize the GStreamer Editing Service. Call this before any usage of GES. You should take care of initilizing GStreamer before calling this function.

MT safety. GStreamer Editing Services do not guarantee MT safety. An application is required to use GES APIs (including GES.deinit()) in the thread where GES.init() was called.

GES.init_check(argv)[source]
Parameters:

argv ([str] or None) – pointer to application’s argv

Raises:

GLib.Error

Returns:

True if GES could be initialized.

argv:

pointer to application’s argv

Return type:

(bool, argv: [str])

Initializes the GStreamer Editing Services library, setting up internal path lists, and loading evrything needed.

This function will return False if GES could not be initialized for some reason.

GES.is_initialized()[source]
Returns:

True if initialization has been done, False otherwise.

Return type:

bool

Use this function to check if GES has been initialized with GES.init() or GES.init_check().

New in version 1.16.

GES.list_assets(filter)[source]
Parameters:

filter (GObject.GType) – The type of object that can be extracted from the asset

Returns:

A list of all GES.Asset-s currently in the cache whose GES.Asset :extractable-type is of the filter type.

Return type:

[GES.Asset]

List all the assets in the current cache whose GES.Asset :extractable-type are of the given type (including subclasses).

Note that, since only a GES.Extractable can be extracted from an asset, using GES_TYPE_EXTRACTABLE as filter will return all the assets in the current cache.

GES.play_sink_convert_frame(playsink, caps)[source]
Parameters:
  • playsink (Gst.Element) – The playsink to get last frame from

  • caps (Gst.Caps) – The caps defining the format the return value will have

Returns:

A Gst.Sample containing the last frame from playsink in the format defined by the caps

Return type:

Gst.Sample or None

Get the last buffer playsink showed

Deprecated since version 1.18: Use the “convert-sample” action signal of #playsink instead.

GES.pspec_equal(key_spec_1, key_spec_2)[source]
Parameters:
Return type:

bool

GES.pspec_hash(key_spec)[source]
Parameters:

key_spec (object or None) –

Return type:

int

GES.track_type_name(type)[source]
Parameters:

type (GES.TrackType) –

Return type:

str

GES.validate_register_action_types()[source]
Return type:

bool

GES.version()[source]
Returns:

major:

pointer to a int to store the major version number

minor:

pointer to a int to store the minor version number

micro:

pointer to a int to store the micro version number

nano:

pointer to a int to store the nano version number

Return type:

(major: int, minor: int, micro: int, nano: int)

Gets the version number of the GStreamer Editing Services library.