GESSourceTrackMap

A GESSourceTrackMap describes which sources of a GESUriClip's URI should be used, and, for each of them, the GESTrack(s) its source should be placed into. It is set on a clip with ges_uri_clip_set_source_track_map.

Only the sources present in the map produce a core child. A source may be routed to one track, or to several (its source is then copied into each), or to none (%NULL, "selected but unplaced": the core child is created but put in no track).

A GESSourceTrackMap is immutable: once built it cannot be changed, so it can be shared safely between threads and between clips. Build one with a GESSourceTrackMapBuilder (ges_source_track_map_builder_new, ges_source_track_map_builder_add, ges_source_track_map_builder_build) or, in C, all at once with ges_source_track_map_new_full.

GESSourceTrackMap

An immutable routing of a GESUriClip's URI sources to the GESTrack(s) they are placed into, set on a clip with ges_uri_clip_set_source_track_map. Build one with a GESSourceTrackMapBuilder or, in C, ges_source_track_map_new_full.

Since : 1.30


GES.SourceTrackMap

An immutable routing of a GES.UriClip's URI sources to the GES.Track(s) they are placed into, set on a clip with GES.UriClip.prototype.set_source_track_map. Build one with a GES.SourceTrackMapBuilder or, in C, GES.SourceTrackMap.prototype.new_full.

Since : 1.30


GES.SourceTrackMap

An immutable routing of a GES.UriClip's URI sources to the GES.Track(s) they are placed into, set on a clip with GES.UriClip.set_source_track_map. Build one with a GES.SourceTrackMapBuilder or, in C, GES.SourceTrackMap.new_full.

Since : 1.30


Constructors

ges_source_track_map_new_full

GESSourceTrackMap *
ges_source_track_map_new_full (const GESSourceTrackMapEntry * entries)

Creates a GESSourceTrackMap from an inline array of routings, e.g.:

ges_source_track_map_new_full ((GESSourceTrackMapEntry[]) {
    {.source = stream0, .track = atrack0},
    {.source = stream1, .track = atrack1},
    {0},
});

Parameters:

entries ( [array zero-terminated=1]) –

an array of GESSourceTrackMapEntry routings, terminated by an entry whose source is NULL

Returns ( [transfer: full]) –

a new GESSourceTrackMap.

Since : 1.30


GES.SourceTrackMap.prototype.new_full

function GES.SourceTrackMap.prototype.new_full(entries: [ GES.SourceTrackMapEntry ]): {
    // javascript wrapper for 'ges_source_track_map_new_full'
}

Creates a GES.SourceTrackMap from an inline array of routings, e.g.:

ges_source_track_map_new_full ((GESSourceTrackMapEntry[]) {
    {.source = stream0, .track = atrack0},
    {.source = stream1, .track = atrack1},
    {0},
});

Parameters:

entries ([ GES.SourceTrackMapEntry ]) –

an array of GES.SourceTrackMapEntry routings, terminated by an entry whose source is null

Returns (GES.SourceTrackMap) –

a new GES.SourceTrackMap.

Since : 1.30


GES.SourceTrackMap.new_full

def GES.SourceTrackMap.new_full (entries):
    #python wrapper for 'ges_source_track_map_new_full'

Creates a GES.SourceTrackMap from an inline array of routings, e.g.:

ges_source_track_map_new_full ((GESSourceTrackMapEntry[]) {
    {.source = stream0, .track = atrack0},
    {.source = stream1, .track = atrack1},
    {0},
});

Parameters:

entries ([ GES.SourceTrackMapEntry ]) –

an array of GES.SourceTrackMapEntry routings, terminated by an entry whose source is None

Returns (GES.SourceTrackMap) –

a new GES.SourceTrackMap.

Since : 1.30


Methods

ges_source_track_map_contains

gboolean
ges_source_track_map_contains (GESSourceTrackMap * self,
                               GESUriSourceAsset * source)

Parameters:

self –

a GESSourceTrackMap

source ( [transfer: none]) –

a GESUriSourceAsset

Returns –

whether source is routed by self.

Since : 1.30


GES.SourceTrackMap.prototype.contains

function GES.SourceTrackMap.prototype.contains(source: GES.UriSourceAsset): {
    // javascript wrapper for 'ges_source_track_map_contains'
}
Returns (Number) –

whether source is routed by self.

Since : 1.30


GES.SourceTrackMap.contains

def GES.SourceTrackMap.contains (self, source):
    #python wrapper for 'ges_source_track_map_contains'
Returns (bool) –

whether source is routed by self.

Since : 1.30


ges_source_track_map_get_size

guint
ges_source_track_map_get_size (GESSourceTrackMap * self)

Get the number of sources routed by self.

Parameters:

self –

a GESSourceTrackMap

Returns –

the number of mapped sources.

Since : 1.30


GES.SourceTrackMap.prototype.get_size

function GES.SourceTrackMap.prototype.get_size(): {
    // javascript wrapper for 'ges_source_track_map_get_size'
}

Get the number of sources routed by self.

Parameters:

Returns (Number) –

the number of mapped sources.

Since : 1.30


GES.SourceTrackMap.get_size

def GES.SourceTrackMap.get_size (self):
    #python wrapper for 'ges_source_track_map_get_size'

Get the number of sources routed by self.

Parameters:

Returns (int) –

the number of mapped sources.

Since : 1.30


ges_source_track_map_get_sources

GList *
ges_source_track_map_get_sources (GESSourceTrackMap * self)

Get the sources routed by self, in the order they were added.

Parameters:

self –

a GESSourceTrackMap

Returns ( [transfer: full][element-type GESUriSourceAsset]) –

the list of mapped GESUriSourceAsset-s. Free with g_list_free_full (list, gst_object_unref).

Since : 1.30


GES.SourceTrackMap.prototype.get_sources

function GES.SourceTrackMap.prototype.get_sources(): {
    // javascript wrapper for 'ges_source_track_map_get_sources'
}

Get the sources routed by self, in the order they were added.

Parameters:

Returns ([ GES.UriSourceAsset ]) –

the list of mapped GES.UriSourceAsset-s. Free with g_list_free_full (list, gst_object_unref).

Since : 1.30


GES.SourceTrackMap.get_sources

def GES.SourceTrackMap.get_sources (self):
    #python wrapper for 'ges_source_track_map_get_sources'

Get the sources routed by self, in the order they were added.

Parameters:

Returns ([ GES.UriSourceAsset ]) –

the list of mapped GES.UriSourceAsset-s. Free with g_list_free_full (list, gst_object_unref).

Since : 1.30


ges_source_track_map_get_tracks

GList *
ges_source_track_map_get_tracks (GESSourceTrackMap * self,
                                 GESUriSourceAsset * source)

Get the GESTrack-s source is routed to.

Parameters:

self –

a GESSourceTrackMap

source ( [transfer: none]) –

a GESUriSourceAsset

Returns ( [transfer: full][element-type GESTrack]) –

the list of GESTrack-s source is routed to, or NULL if source is unplaced or not in self. Free with g_list_free_full (list, gst_object_unref).

Since : 1.30


GES.SourceTrackMap.prototype.get_tracks

function GES.SourceTrackMap.prototype.get_tracks(source: GES.UriSourceAsset): {
    // javascript wrapper for 'ges_source_track_map_get_tracks'
}

Get the GES.Track-s source is routed to.

Returns ([ GES.Track ]) –

the list of GES.Track-s source is routed to, or null if source is unplaced or not in self. Free with g_list_free_full (list, gst_object_unref).

Since : 1.30


GES.SourceTrackMap.get_tracks

def GES.SourceTrackMap.get_tracks (self, source):
    #python wrapper for 'ges_source_track_map_get_tracks'

Get the GES.Track-s source is routed to.

Returns ([ GES.Track ]) –

the list of GES.Track-s source is routed to, or None if source is unplaced or not in self. Free with g_list_free_full (list, gst_object_unref).

Since : 1.30


ges_source_track_map_ref

GESSourceTrackMap *
ges_source_track_map_ref (GESSourceTrackMap * self)

Parameters:

self –

a GESSourceTrackMap

Returns ( [transfer: full]) –

self

Since : 1.30


GES.SourceTrackMap.prototype.ref

function GES.SourceTrackMap.prototype.ref(): {
    // javascript wrapper for 'ges_source_track_map_ref'
}

Parameters:

Returns (GES.SourceTrackMap) –

self

Since : 1.30


GES.SourceTrackMap.ref

def GES.SourceTrackMap.ref (self):
    #python wrapper for 'ges_source_track_map_ref'

Parameters:

Returns (GES.SourceTrackMap) –

self

Since : 1.30


ges_source_track_map_unref

ges_source_track_map_unref (GESSourceTrackMap * self)

Parameters:

self ( [transfer: full]) –

a GESSourceTrackMap

Since : 1.30


GES.SourceTrackMap.prototype.unref

function GES.SourceTrackMap.prototype.unref(): {
    // javascript wrapper for 'ges_source_track_map_unref'
}

Parameters:

Since : 1.30


GES.SourceTrackMap.unref

def GES.SourceTrackMap.unref (self):
    #python wrapper for 'ges_source_track_map_unref'

Parameters:

Since : 1.30


GESSourceTrackMapBuilder

An incremental builder for an immutable GESSourceTrackMap. Create it with ges_source_track_map_builder_new, add routings with ges_source_track_map_builder_add, then finish with ges_source_track_map_builder_build, which consumes the builder and returns the immutable map.

Since : 1.30


GES.SourceTrackMapBuilder

An incremental builder for an immutable GES.SourceTrackMap. Create it with GES.SourceTrackMapBuilder.prototype.new, add routings with GES.SourceTrackMapBuilder.prototype.add, then finish with GES.SourceTrackMapBuilder.prototype.build, which consumes the builder and returns the immutable map.

Since : 1.30


GES.SourceTrackMapBuilder

An incremental builder for an immutable GES.SourceTrackMap. Create it with GES.SourceTrackMapBuilder.new, add routings with GES.SourceTrackMapBuilder.add, then finish with GES.SourceTrackMapBuilder.build, which consumes the builder and returns the immutable map.

Since : 1.30


Constructors

ges_source_track_map_builder_new

GESSourceTrackMapBuilder *
ges_source_track_map_builder_new ()

Creates a new GESSourceTrackMapBuilder. Add routings with ges_source_track_map_builder_add, then finish with ges_source_track_map_builder_build.

Returns ( [transfer: full]) –

a new GESSourceTrackMapBuilder.

Since : 1.30


GES.SourceTrackMapBuilder.prototype.new

function GES.SourceTrackMapBuilder.prototype.new(): {
    // javascript wrapper for 'ges_source_track_map_builder_new'
}

Creates a new GES.SourceTrackMapBuilder. Add routings with GES.SourceTrackMapBuilder.prototype.add, then finish with GES.SourceTrackMapBuilder.prototype.build.

Since : 1.30


GES.SourceTrackMapBuilder.new

def GES.SourceTrackMapBuilder.new ():
    #python wrapper for 'ges_source_track_map_builder_new'

Creates a new GES.SourceTrackMapBuilder. Add routings with GES.SourceTrackMapBuilder.add, then finish with GES.SourceTrackMapBuilder.build.

Since : 1.30


Methods

ges_source_track_map_builder_add

GESSourceTrackMapBuilder *
ges_source_track_map_builder_add (GESSourceTrackMapBuilder * builder,
                                  GESUriSourceAsset * source,
                                  GESTrack * track)

Routes source to track. Called more than once with the same source and different tracks, source is placed into each of them. Returns builder so calls can be chained.

Parameters:

builder –

a GESSourceTrackMapBuilder

source ( [transfer: none]) –

a GESUriSourceAsset of the clip's URI

track ( [transfer: none][nullable]) –

a GESTrack source should be placed into, or NULL to select source without placing it (unplaced)

Returns ( [transfer: none]) –

builder.

Since : 1.30


GES.SourceTrackMapBuilder.prototype.add

function GES.SourceTrackMapBuilder.prototype.add(source: GES.UriSourceAsset, track: GES.Track): {
    // javascript wrapper for 'ges_source_track_map_builder_add'
}

Routes source to track. Called more than once with the same source and different tracks, source is placed into each of them. Returns builder so calls can be chained.

Parameters:

source (GES.UriSourceAsset) –

a GES.UriSourceAsset of the clip's URI

track (GES.Track) –

a GES.Track source should be placed into, or null to select source without placing it (unplaced)

builder.

Since : 1.30


GES.SourceTrackMapBuilder.add

def GES.SourceTrackMapBuilder.add (self, source, track):
    #python wrapper for 'ges_source_track_map_builder_add'

Routes source to track. Called more than once with the same source and different tracks, source is placed into each of them. Returns builder so calls can be chained.

Parameters:

source (GES.UriSourceAsset) –

a GES.UriSourceAsset of the clip's URI

track (GES.Track) –

a GES.Track source should be placed into, or None to select source without placing it (unplaced)

builder.

Since : 1.30


ges_source_track_map_builder_build

GESSourceTrackMap *
ges_source_track_map_builder_build (GESSourceTrackMapBuilder * builder)

Finishes the builder, returning the immutable GESSourceTrackMap and freeing builder (it must not be used afterwards).

Parameters:

builder ( [transfer: full]) –

a GESSourceTrackMapBuilder

Returns ( [transfer: full]) –

a new GESSourceTrackMap.

Since : 1.30


GES.SourceTrackMapBuilder.prototype.build

function GES.SourceTrackMapBuilder.prototype.build(): {
    // javascript wrapper for 'ges_source_track_map_builder_build'
}

Finishes the builder, returning the immutable GES.SourceTrackMap and freeing builder (it must not be used afterwards).

Returns (GES.SourceTrackMap) –

a new GES.SourceTrackMap.

Since : 1.30


GES.SourceTrackMapBuilder.build

def GES.SourceTrackMapBuilder.build (self):
    #python wrapper for 'ges_source_track_map_builder_build'

Finishes the builder, returning the immutable GES.SourceTrackMap and freeing builder (it must not be used afterwards).

Returns (GES.SourceTrackMap) –

a new GES.SourceTrackMap.

Since : 1.30


ges_source_track_map_builder_copy

GESSourceTrackMapBuilder *
ges_source_track_map_builder_copy (GESSourceTrackMapBuilder * builder)

Copies builder, producing an independent builder in the same building state.

Parameters:

builder –

a GESSourceTrackMapBuilder

Returns ( [transfer: full]) –

a copy of builder.

Since : 1.30


GES.SourceTrackMapBuilder.prototype.copy

function GES.SourceTrackMapBuilder.prototype.copy(): {
    // javascript wrapper for 'ges_source_track_map_builder_copy'
}

Copies builder, producing an independent builder in the same building state.

a copy of builder.

Since : 1.30


GES.SourceTrackMapBuilder.copy

def GES.SourceTrackMapBuilder.copy (self):
    #python wrapper for 'ges_source_track_map_builder_copy'

Copies builder, producing an independent builder in the same building state.

a copy of builder.

Since : 1.30


ges_source_track_map_builder_free

ges_source_track_map_builder_free (GESSourceTrackMapBuilder * builder)

Frees a GESSourceTrackMapBuilder, discarding the routings accumulated in it. Use ges_source_track_map_builder_build to obtain the map instead.

Parameters:

builder ( [transfer: full]) –

a GESSourceTrackMapBuilder

Since : 1.30


GES.SourceTrackMapBuilder.prototype.free

function GES.SourceTrackMapBuilder.prototype.free(): {
    // javascript wrapper for 'ges_source_track_map_builder_free'
}

Frees a GES.SourceTrackMapBuilder, discarding the routings accumulated in it. Use GES.SourceTrackMapBuilder.prototype.build to obtain the map instead.

Since : 1.30


GES.SourceTrackMapBuilder.free

def GES.SourceTrackMapBuilder.free (self):
    #python wrapper for 'ges_source_track_map_builder_free'

Frees a GES.SourceTrackMapBuilder, discarding the routings accumulated in it. Use GES.SourceTrackMapBuilder.build to obtain the map instead.

Since : 1.30


GESSourceTrackMapEntry

A single source-to-track routing, used to build a GESSourceTrackMap through ges_source_track_map_new_full.

Members

source (GESUriSourceAsset *) –

a GESUriSourceAsset describing one source of a URI

track (GESTrack *) –

the GESTrack the source should be placed into, or NULL to select the source without placing it (its core source is created but put in no track)

Since : 1.30


GES.SourceTrackMapEntry

A single source-to-track routing, used to build a GES.SourceTrackMap through GES.SourceTrackMap.prototype.new_full.

Members

source (GES.UriSourceAsset) –

a GES.UriSourceAsset describing one source of a URI

track (GES.Track) –

the GES.Track the source should be placed into, or null to select the source without placing it (its core source is created but put in no track)

Since : 1.30


GES.SourceTrackMapEntry

A single source-to-track routing, used to build a GES.SourceTrackMap through GES.SourceTrackMap.new_full.

Members

source (GES.UriSourceAsset) –

a GES.UriSourceAsset describing one source of a URI

track (GES.Track) –

the GES.Track the source should be placed into, or None to select the source without placing it (its core source is created but put in no track)

Since : 1.30


The results of the search are