mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-08 13:18:52 +00:00
150 lines
No EOL
6.6 KiB
C
150 lines
No EOL
6.6 KiB
C
/* 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 |