gstreamer/ges/ges.c

301 lines
8.8 KiB
C
Raw Normal View History

2009-08-06 09:23:01 +00:00
/* GStreamer Editing Services
2009-11-30 14:14:25 +00:00
* Copyright (C) 2009 Edward Hervey <edward.hervey@collabora.co.uk>
* 2009 Nokia Corporation
2009-08-06 09:23:01 +00:00
*
* 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
2012-11-04 00:25:20 +00:00
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
2009-08-06 09:23:01 +00:00
*/
/* TODO
* Add a deinit function
*
* Do not forget to
* + g_ptr_array_unref (new_paths);
* + g_hash_table_unref (tried_uris);
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include <stdlib.h>
2009-08-06 09:23:01 +00:00
#include <ges/ges.h>
#include "ges/gstframepositioner.h"
#include "ges-internal.h"
2009-08-06 09:23:01 +00:00
2014-03-16 11:46:26 +00:00
#define GES_GNONLIN_VERSION_NEEDED_MAJOR 1
#define GES_GNONLIN_VERSION_NEEDED_MINOR 2
2012-05-01 17:48:57 +00:00
#define GES_GNONLIN_VERSION_NEEDED_MICRO 0
GST_DEBUG_CATEGORY (_ges_debug);
2009-08-06 09:23:01 +00:00
2012-11-27 15:53:14 +00:00
static gboolean ges_initialized = FALSE;
static gboolean
ges_init_pre (GOptionContext * context, GOptionGroup * group, gpointer data,
GError ** error)
2009-08-06 09:23:01 +00:00
{
/* initialize debugging category */
GST_DEBUG_CATEGORY_INIT (_ges_debug, "ges", GST_DEBUG_FG_YELLOW,
2009-08-06 09:23:01 +00:00
"GStreamer Editing Services");
return TRUE;
}
static gboolean
ges_init_post (GOptionContext * context, GOptionGroup * group, gpointer data,
GError ** error)
{
GESUriClipAssetClass *uriasset_klass = NULL;
2012-11-27 15:53:14 +00:00
if (ges_initialized) {
GST_DEBUG ("already initialized ges");
return TRUE;
}
uriasset_klass = g_type_class_ref (GES_TYPE_URI_CLIP_ASSET);
if (!uriasset_klass || !uriasset_klass->discoverer)
goto failed;
if (!uriasset_klass->sync_discoverer)
goto failed;
/* register clip classes with the system */
g_type_class_ref (GES_TYPE_TEST_CLIP);
g_type_class_ref (GES_TYPE_URI_CLIP);
g_type_class_ref (GES_TYPE_TITLE_CLIP);
g_type_class_ref (GES_TYPE_TRANSITION_CLIP);
g_type_class_ref (GES_TYPE_OVERLAY_CLIP);
g_type_class_ref (GES_TYPE_OVERLAY_TEXT_CLIP);
g_type_class_ref (GES_TYPE_GROUP);
/* register formatter types with the system */
g_type_class_ref (GES_TYPE_PITIVI_FORMATTER);
g_type_class_ref (GES_TYPE_COMMAND_LINE_FORMATTER);
g_type_class_ref (GES_TYPE_XML_FORMATTER);
/* Register track elements */
g_type_class_ref (GES_TYPE_EFFECT);
ges_asset_cache_init ();
gst_element_register (NULL, "framepositioner", 0, GST_TYPE_FRAME_POSITIONNER);
gst_element_register (NULL, "gespipeline", 0, GES_TYPE_PIPELINE);
/* TODO: user-defined types? */
2012-11-27 15:53:14 +00:00
ges_initialized = TRUE;
g_type_class_unref (uriasset_klass);
GST_DEBUG ("GStreamer Editing Services initialized");
return TRUE;
failed:
if (uriasset_klass)
g_type_class_unref (uriasset_klass);
GST_ERROR ("Could not initialize GES.");
return FALSE;
2009-08-06 09:23:01 +00:00
}
/**
* ges_init:
*
* Initialize the GStreamer Editing Service. Call this before any usage of
* GES. You should take care of initilizing GStreamer before calling this
* function.
*/
gboolean
ges_init (void)
{
ges_init_pre (NULL, NULL, NULL, NULL);
return ges_init_post (NULL, NULL, NULL, NULL);
}
/**
* ges_deinit:
*
* 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.
*
* After this call GES (including this method) should not be used anymore.
*/
void
ges_deinit (void)
{
_ges_uri_asset_cleanup ();
g_type_class_unref (g_type_class_peek (GES_TYPE_TEST_CLIP));
g_type_class_unref (g_type_class_peek (GES_TYPE_URI_CLIP));
g_type_class_unref (g_type_class_peek (GES_TYPE_TITLE_CLIP));
g_type_class_unref (g_type_class_peek (GES_TYPE_TRANSITION_CLIP));
g_type_class_unref (g_type_class_peek (GES_TYPE_OVERLAY_CLIP));
g_type_class_unref (g_type_class_peek (GES_TYPE_OVERLAY_TEXT_CLIP));
g_type_class_unref (g_type_class_peek (GES_TYPE_GROUP));
/* register formatter types with the system */
g_type_class_unref (g_type_class_peek (GES_TYPE_PITIVI_FORMATTER));
g_type_class_unref (g_type_class_peek (GES_TYPE_COMMAND_LINE_FORMATTER));
g_type_class_unref (g_type_class_peek (GES_TYPE_XML_FORMATTER));
/* Register track elements */
g_type_class_unref (g_type_class_peek (GES_TYPE_EFFECT));
}
#ifndef GST_DISABLE_OPTION_PARSING
static gboolean
parse_goption_arg (const gchar * s_opt,
const gchar * arg, gpointer data, GError ** err)
{
if (g_strcmp0 (s_opt, "--ges-version") == 0) {
g_print ("GStreamer Editing Services version %s\n", PACKAGE_VERSION);
exit (0);
} else if (g_strcmp0 (s_opt, "--ges-sample-paths") == 0) {
ges_add_missing_uri_relocation_uri (arg, FALSE);
} else if (g_strcmp0 (s_opt, "--ges-sample-path-recurse") == 0) {
ges_add_missing_uri_relocation_uri (arg, TRUE);
}
return TRUE;
}
#endif
/**
* ges_init_get_option_group: (skip)
*
* Returns a #GOptionGroup with GES's argument specifications. The
* group is set up to use standard GOption callbacks, so when using this
* group in combination with GOption parsing methods, all argument parsing
* and initialization is automated.
*
* This function is useful if you want to integrate GES with other
* libraries that use GOption (see g_option_context_add_group() ).
*
* If you use this function, you should make sure you initialise the GStreamer
* as one of the very first things in your program. That means you need to
* use gst_init_get_option_group() and add it to the option context before
* using the ges_init_get_option_group() result.
*
* Returns: (transfer full): a pointer to GES's option group.
*/
GOptionGroup *
ges_init_get_option_group (void)
{
#ifndef GST_DISABLE_OPTION_PARSING
GOptionGroup *group;
static const GOptionEntry ges_args[] = {
{"ges-version", 0, G_OPTION_FLAG_NO_ARG, G_OPTION_ARG_CALLBACK,
(gpointer) parse_goption_arg,
"Print the GStreamer Editing Services version",
NULL},
{"ges-sample-paths", 0, 0, G_OPTION_ARG_CALLBACK,
(gpointer) parse_goption_arg,
"List of pathes to look assets in if they were moved"},
{"ges-sample-path-recurse", 0, 0, G_OPTION_ARG_CALLBACK,
(gpointer) parse_goption_arg,
"Same as above, but recursing into the folder"},
{NULL}
};
group = g_option_group_new ("GES", "GStreamer Editing Services Options",
"Show GES Options", NULL, NULL);
g_option_group_set_parse_hooks (group, (GOptionParseFunc) ges_init_pre,
(GOptionParseFunc) ges_init_post);
g_option_group_add_entries (group, ges_args);
return group;
#else
return NULL;
#endif
}
/**
* ges_version:
* @major: (out): pointer to a guint to store the major version number
* @minor: (out): pointer to a guint to store the minor version number
* @micro: (out): pointer to a guint to store the micro version number
* @nano: (out): pointer to a guint to store the nano version number
*
* Gets the version number of the GStreamer Editing Services library.
*/
void
ges_version (guint * major, guint * minor, guint * micro, guint * nano)
{
g_return_if_fail (major);
g_return_if_fail (minor);
g_return_if_fail (micro);
g_return_if_fail (nano);
*major = GES_VERSION_MAJOR;
*minor = GES_VERSION_MINOR;
*micro = GES_VERSION_MICRO;
*nano = GES_VERSION_NANO;
}
/**
* ges_init_check:
* @argc: (inout) (allow-none): pointer to application's argc
* @argv: (inout) (array length=argc) (allow-none): pointer to application's argv
* @err: pointer to a #GError to which a message will be posted on error
*
* 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.
*
* Returns: %TRUE if GES could be initialized.
*/
gboolean
ges_init_check (int *argc, char **argv[], GError ** err)
{
#ifndef GST_DISABLE_OPTION_PARSING
GOptionGroup *group;
GOptionContext *ctx;
#endif
gboolean res;
if (ges_initialized) {
GST_DEBUG ("already initialized ges");
return TRUE;
}
#ifndef GST_DISABLE_OPTION_PARSING
ctx = g_option_context_new ("- GStreamer Editing Services initialization");
g_option_context_set_ignore_unknown_options (ctx, TRUE);
g_option_context_set_help_enabled (ctx, FALSE);
group = ges_init_get_option_group ();
g_option_context_add_group (ctx, group);
res = g_option_context_parse (ctx, argc, argv, err);
g_option_context_free (ctx);
#endif
if (!res)
return res;
return ges_init ();
}