1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/* GStreamer Editing Services
*
* Copyright (C) 2012 Thibault Saunier <thibault.saunier@collabora.com>
* Copyright (C) 2012 Volodymyr Rudyi <vladimir.rudoy@gmail.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#pragma once
typedef struct _GESExtractable GESExtractable;
#include <glib-object.h>
#include <gio/gio.h>
#include <gst/gst.h>
#include <ges/ges-types.h>
#include <ges/ges-asset.h>
G_BEGIN_DECLS
/* GESExtractable interface declarations */
#define GES_TYPE_EXTRACTABLE (ges_extractable_get_type ())
#define GES_EXTRACTABLE_GET_INTERFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), GES_TYPE_EXTRACTABLE, GESExtractableInterface))
GES_API
G_DECLARE_INTERFACE(GESExtractable, ges_extractable, GES, EXTRACTABLE, GInitiallyUnowned);
/**
* GESExtractableCheckId:
* @type: The #GESExtractable type to check @id for
* @id: The ID to check
* @error: An error that can be set if needed
*
* Method for checking that an ID is valid for the given #GESExtractable
* type. If the given ID is considered valid, it can be adjusted into some
* standard and returned to prevent the creation of separate #GESAsset-s,
* with different #GESAsset:id, that would otherwise act the same.
*
* Returns (transfer full) (nullable): The actual #GESAsset:id to set on
* any corresponding assets, based on @id, or %NULL if @id is not valid.
*/
typedef gchar* (*GESExtractableCheckId) (GType type, const gchar *id,
GError **error);
/**
* GESExtractableInterface:
* @asset_type: The subclass type of #GESAsset that should be created when
* an asset with the corresponding #GESAsset:extractable-type is
* requested.
* @check_id: The method to call to check whether a given ID is valid as
* an asset #GESAsset:id for the given #GESAsset:extractable-type. The
* returned ID is the actual #GESAsset:id that is set on the asset. The
* default implementation will simply always return the type name of the
* #GESAsset:extractable-type, even if the received ID is %NULL. As such,
* any given ID is considered valid (or is ignored), but only one is
* actually ever set on an asset, which means the given
* #GESAsset:extractable-type can only have one associated asset.
* @can_update_asset: Whether an object of this class can have its
* #GESAsset change over its lifetime. This should be set to %TRUE if one
* of the object's parameters that is associated with its ID can change
* after construction, which would require an asset with a new ID. Note
* that the subclass is required to handle the requesting and setting of
* the new asset on the object.
* @set_asset: This method is called after the #GESAsset of an object is
* set. If your class supports the asset of an object changing, then you
* can use this method to change the parameters of the object to match the
* new asset #GESAsset:id. If setting the asset should be able to fail,
* you should implement @set_asset_full instead.
* @set_asset_full: Like @set_asset, but also allows you to return %FALSE
* to indicate a failure to change the object in response to a change in
* its asset.
* @get_parameters_from_id: The method to call to get the object
* properties corresponding to a given asset #GESAsset:id. The default
* implementation will simply return no parameters. The default #GESAsset
* will call this to set the returned properties on the extracted object,
* but other subclasses may ignore this method.
* @get_id: The method to fetch the #GESAsset:id of some associated asset.
* Note that it may be the case that the object does not have its asset
* set, or even that an asset with such an #GESAsset:id does not exist in
* the GES cache. Instead, this should return the #GESAsset:id that is
* _compatible_ with the current state of the object. The default
* implementation simply returns the currently set asset ID, or the type name
* of the object, which is what is used as the #GESAsset:id by default,
* if no asset is set.
* @get_real_extractable_type: The method to call to get the actual
* #GESAsset:extractable-type an asset should have set, given the
* requested #GESAsset:id. The default implementation simply returns the
* same type as given. You can overwrite this if it is more appropriate
* to extract the object from a subclass, depending on the requested
* #GESAsset:id. Note that when an asset is requested, this method will be
* called before the other class methods. In particular, this means that
* the @check_id and @get_parameters_from_id class methods of the returned
* type will be used (instead of our own).
* @register_metas: The method to set metadata on an asset. This is called
* on initiation of the asset, but before it begins to load its state.
*/
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
struct _GESExtractableInterface
{
GTypeInterface parent;
GType asset_type;
GESExtractableCheckId check_id;
gboolean can_update_asset;
void (*set_asset) (GESExtractable *self,
GESAsset *asset);
gboolean (*set_asset_full) (GESExtractable *self,
GESAsset *asset);
GParameter *(*get_parameters_from_id) (const gchar *id,
guint *n_params);
gchar * (*get_id) (GESExtractable *self);
GType (*get_real_extractable_type) (GType wanted_type,
const gchar *id);
gboolean (*register_metas) (GESExtractableInterface *self,
GObjectClass *klass,
GESAsset *asset);
gpointer _ges_reserved[GES_PADDING];
};
G_GNUC_END_IGNORE_DEPRECATIONS
GES_API
GESAsset* ges_extractable_get_asset (GESExtractable *self);
GES_API
gboolean ges_extractable_set_asset (GESExtractable *self,
GESAsset *asset);
GES_API
gchar * ges_extractable_get_id (GESExtractable *self);
G_END_DECLS
|
