gstreamer/ges/ges-extractable.c
Tim-Philipp Müller a7347ca8f7 WIP: ges: fix API export/import and 'inconsistent linkage' on MSVC
Export GES library API in headers when we're building the
library itself, otherwise import the API from the headers.

This fixes linker warnings on Windows when building with MSVC.

Fix up some missing config.h includes when building the lib which
is needed to get the export api define from config.h

Fixes https://gitlab.freedesktop.org/gstreamer/gst-editing-services/issues/42
2018-12-15 00:14:51 +00:00

302 lines
8.3 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.
*/
/**
* SECTION: gesextractable
* @title: GESExtractable Interface
* @short_description: An interface for objects which can be extracted from a GESAsset
*
* FIXME: Long description needed
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "ges-asset.h"
#include "ges-internal.h"
#include "ges-extractable.h"
#include "ges-uri-clip.h"
static GQuark ges_asset_key;
G_DEFINE_INTERFACE_WITH_CODE (GESExtractable, ges_extractable,
G_TYPE_INITIALLY_UNOWNED,
ges_asset_key = g_quark_from_static_string ("ges-extractable-data"));
static gchar *
ges_extractable_check_id_default (GType type, const gchar * id, GError ** error)
{
return g_strdup (g_type_name (type));
}
static GType
ges_extractable_get_real_extractable_type_default (GType type, const gchar * id)
{
return type;
}
static GParameter *
extractable_get_parameters_from_id (const gchar * id, guint * n_params)
{
*n_params = 0;
return NULL;
}
static gchar *
extractable_get_id (GESExtractable * self)
{
return g_strdup (g_type_name (G_OBJECT_TYPE (self)));
}
static void
ges_extractable_default_init (GESExtractableInterface * iface)
{
iface->asset_type = GES_TYPE_ASSET;
iface->check_id = ges_extractable_check_id_default;
iface->get_real_extractable_type =
ges_extractable_get_real_extractable_type_default;
iface->get_parameters_from_id = extractable_get_parameters_from_id;
iface->set_asset = NULL;
iface->set_asset_full = NULL;
iface->get_id = extractable_get_id;
iface->register_metas = NULL;
iface->can_update_asset = FALSE;
}
/**
* ges_extractable_get_asset:
* @self: The #GESExtractable from which to retrieve a #GESAsset
*
* Method for getting an asset from a #GESExtractable
*
* Returns: (transfer none) (nullable): The #GESAsset or %NULL if none has
* been set
*/
GESAsset *
ges_extractable_get_asset (GESExtractable * self)
{
g_return_val_if_fail (GES_IS_EXTRACTABLE (self), NULL);
return g_object_get_qdata (G_OBJECT (self), ges_asset_key);;
}
/**
* ges_extractable_set_asset:
* @self: Target object
* @asset: (transfer none): The #GESAsset to set
*
* Method to set the asset which instantiated the specified object
*
* Return: %TRUE if @asset could be set %FALSE otherwize
*/
gboolean
ges_extractable_set_asset (GESExtractable * self, GESAsset * asset)
{
GESExtractableInterface *iface;
g_return_val_if_fail (GES_IS_EXTRACTABLE (self), FALSE);
iface = GES_EXTRACTABLE_GET_INTERFACE (self);
GST_DEBUG_OBJECT (self, "Setting asset to %" GST_PTR_FORMAT, asset);
if (iface->can_update_asset == FALSE &&
g_object_get_qdata (G_OBJECT (self), ges_asset_key)) {
GST_WARNING_OBJECT (self, "Can not reset asset on object");
return FALSE;
}
g_object_set_qdata_full (G_OBJECT (self), ges_asset_key,
gst_object_ref (asset), gst_object_unref);
/* Let classes that implement the interface know that a asset has been set */
if (iface->set_asset_full)
return iface->set_asset_full (self, asset);
if (iface->set_asset)
iface->set_asset (self, asset);
return TRUE;
}
/**
* ges_extractable_get_id:
* @self: The #GESExtractable
*
* Returns: (transfer full): The #id of the associated #GESAsset, free with #g_free
*/
gchar *
ges_extractable_get_id (GESExtractable * self)
{
g_return_val_if_fail (GES_IS_EXTRACTABLE (self), NULL);
return GES_EXTRACTABLE_GET_INTERFACE (self)->get_id (self);
}
/**
* ges_extractable_type_get_parameters_for_id:
* @type: The #GType implementing #GESExtractable
* @id: The ID of the Extractable
* @n_params: (out): Return location for the returned array
*
* Returns: (transfer full) (array length=n_params): an array of #GParameter
* needed to extract the #GESExtractable from a #GESAsset of @id
*/
GParameter *
ges_extractable_type_get_parameters_from_id (GType type, const gchar * id,
guint * n_params)
{
GObjectClass *klass;
GESExtractableInterface *iface;
GParameter *ret = NULL;
g_return_val_if_fail (g_type_is_a (type, G_TYPE_OBJECT), NULL);
g_return_val_if_fail (g_type_is_a (type, GES_TYPE_EXTRACTABLE), NULL);
klass = g_type_class_ref (type);
iface = g_type_interface_peek (klass, GES_TYPE_EXTRACTABLE);
ret = iface->get_parameters_from_id (id, n_params);
g_type_class_unref (klass);
return ret;
}
/**
* ges_extractable_type_get_asset_type:
* @type: The #GType implementing #GESExtractable
*
* Get the #GType, subclass of #GES_TYPE_ASSET to instanciate
* to be able to extract a @type
*
* Returns: the #GType to use to create a asset to extract @type
*/
GType
ges_extractable_type_get_asset_type (GType type)
{
GObjectClass *klass;
GESExtractableInterface *iface;
g_return_val_if_fail (g_type_is_a (type, G_TYPE_OBJECT), G_TYPE_INVALID);
g_return_val_if_fail (g_type_is_a (type, GES_TYPE_EXTRACTABLE),
G_TYPE_INVALID);
klass = g_type_class_ref (type);
iface = g_type_interface_peek (klass, GES_TYPE_EXTRACTABLE);
g_type_class_unref (klass);
return iface->asset_type;
}
/**
* ges_extractable_type_check_id:
* @type: The #GType implementing #GESExtractable
* @id: The ID to check
*
* Check if @id is valid for @type
*
* Returns: (transfer full) (nullable): A newly allocated string containing
* the actual ID (after some processing) or %NULL if the ID is wrong.
*/
gchar *
ges_extractable_type_check_id (GType type, const gchar * id, GError ** error)
{
GObjectClass *klass;
GESExtractableInterface *iface;
g_return_val_if_fail (error == NULL || *error == NULL, NULL);
g_return_val_if_fail (g_type_is_a (type, G_TYPE_OBJECT), NULL);
g_return_val_if_fail (g_type_is_a (type, GES_TYPE_EXTRACTABLE), NULL);
klass = g_type_class_ref (type);
iface = g_type_interface_peek (klass, GES_TYPE_EXTRACTABLE);
g_type_class_unref (klass);
return iface->check_id (type, id, error);
}
/**
* ges_extractable_get_real_extractable_type:
* @type: The #GType implementing #GESExtractable
* @id: The ID to check
*
* Get the #GType that should be used as extractable_type for @type and
* @id. Usually this will be the same as @type but in some cases they can
* be some subclasses of @type. For example, in the case of #GESFormatter,
* the returned #GType will be a subclass of #GESFormatter that can be used
* to load the file pointed by @id.
*
* Returns: Return the #GESExtractable type that should be used for @id
*/
GType
ges_extractable_get_real_extractable_type_for_id (GType type, const gchar * id)
{
GType ret;
GObjectClass *klass;
GESExtractableInterface *iface;
klass = g_type_class_ref (type);
iface = g_type_interface_peek (klass, GES_TYPE_EXTRACTABLE);
g_type_class_unref (klass);
ret = iface->get_real_extractable_type (type, id);
GST_DEBUG ("Extractable type for id %s and wanted type %s is: %s",
id, g_type_name (type), g_type_name (ret));
return ret;
}
/**
* ges_extractable_register_metas:
* @self: A #GESExtractable
* @asset: The #GESAsset on which metadatas should be registered
*
* Lets you register standard method for @extractable_type on @asset
*
* Returns: %TRUE if metas could be register %FALSE otherwize
*/
gboolean
ges_extractable_register_metas (GType extractable_type, GESAsset * asset)
{
GObjectClass *klass;
gboolean ret = FALSE;
GESExtractableInterface *iface;
g_return_val_if_fail (g_type_is_a (extractable_type, GES_TYPE_EXTRACTABLE),
FALSE);
klass = g_type_class_ref (extractable_type);
iface = g_type_interface_peek (klass, GES_TYPE_EXTRACTABLE);
if (iface->register_metas)
ret = iface->register_metas (iface, klass, asset);
g_type_class_unref (klass);
return ret;
}