annotate libpurple/media-gst.h @ 32806:fed510b05c32

Remove a period from a phrase that appears in the status bar of active calls
author Mark Doliner <mark@kingant.net>
date Mon, 31 Oct 2011 02:29:14 +0000
parents 02a2e8183b1d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
1 /**
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
2 * @file media-gst.h Media API
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
3 * @ingroup core
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
4 */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
5
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
6 /* purple
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
7 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
8 * Purple is the legal property of its developers, whose names are too numerous
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
9 * to list here. Please refer to the COPYRIGHT file distributed with this
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
10 * source distribution.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
11 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
12 * This program is free software; you can redistribute it and/or modify
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
13 * it under the terms of the GNU General Public License as published by
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
14 * the Free Software Foundation; either version 2 of the License, or
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
15 * (at your option) any later version.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
16 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
17 * This program is distributed in the hope that it will be useful,
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
20 * GNU General Public License for more details.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
21 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
22 * You should have received a copy of the GNU General Public License
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
23 * along with this program; if not, write to the Free Software
28397
8c991e09efcb Update various header copyrights thanks to licensecheck.
Paul Aurich <paul@darkrain42.org>
parents: 26520
diff changeset
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
25 */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
26
26520
fd97c0de433d Add PURPLE to the media header sentinels and reorder includes to fix building gf2
Paul Aurich <paul@darkrain42.org>
parents: 26519
diff changeset
27 #ifndef _PURPLE_MEDIA_GST_H_
fd97c0de433d Add PURPLE to the media header sentinels and reorder includes to fix building gf2
Paul Aurich <paul@darkrain42.org>
parents: 26519
diff changeset
28 #define _PURPLE_MEDIA_GST_H_
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
29
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
30 #include "media.h"
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
31 #include "mediamanager.h"
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
32
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
33 #include <gst/gst.h>
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
34
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
35 G_BEGIN_DECLS
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
36
26484
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
37 #define PURPLE_TYPE_MEDIA_ELEMENT_TYPE (purple_media_element_type_get_type())
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
38 #define PURPLE_TYPE_MEDIA_ELEMENT_INFO (purple_media_element_info_get_type())
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
39 #define PURPLE_MEDIA_ELEMENT_INFO(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), PURPLE_TYPE_MEDIA_ELEMENT_INFO, PurpleMediaElementInfo))
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
40 #define PURPLE_MEDIA_ELEMENT_INFO_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), PURPLE_TYPE_MEDIA_ELEMENT_INFO, PurpleMediaElementInfo))
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
41 #define PURPLE_IS_MEDIA_ELEMENT_INFO(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), PURPLE_TYPE_MEDIA_ELEMENT_INFO))
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
42 #define PURPLE_IS_MEDIA_ELEMENT_INFO_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), PURPLE_TYPE_MEDIA_ELEMENT_INFO))
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
43 #define PURPLE_MEDIA_ELEMENT_INFO_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), PURPLE_TYPE_MEDIA_ELEMENT_INFO, PurpleMediaElementInfo))
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
44
28490
713987ae3215 Fix some docs warnings. Thanks to darkrain for pointing them out.
maiku@pidgin.im
parents: 28397
diff changeset
45 /** An opaque structure representing an audio/video source/sink. */
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
46 typedef struct _PurpleMediaElementInfo PurpleMediaElementInfo;
26484
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
47 typedef struct _PurpleMediaElementInfoClass PurpleMediaElementInfoClass;
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
48 typedef GstElement *(*PurpleMediaElementCreateCallback)(PurpleMedia *media,
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
49 const gchar *session_id, const gchar *participant);
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
50
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
51 typedef enum {
26484
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
52 PURPLE_MEDIA_ELEMENT_NONE = 0, /** empty element */
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
53 PURPLE_MEDIA_ELEMENT_AUDIO = 1, /** supports audio */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
54 PURPLE_MEDIA_ELEMENT_VIDEO = 1 << 1, /** supports video */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
55 PURPLE_MEDIA_ELEMENT_AUDIO_VIDEO = PURPLE_MEDIA_ELEMENT_AUDIO
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
56 | PURPLE_MEDIA_ELEMENT_VIDEO, /** supports audio and video */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
57
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
58 PURPLE_MEDIA_ELEMENT_NO_SRCS = 0, /** has no src pads */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
59 PURPLE_MEDIA_ELEMENT_ONE_SRC = 1 << 2, /** has one src pad */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
60 PURPLE_MEDIA_ELEMENT_MULTI_SRC = 1 << 3, /** has multiple src pads */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
61 PURPLE_MEDIA_ELEMENT_REQUEST_SRC = 1 << 4, /** src pads must be requested */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
62
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
63 PURPLE_MEDIA_ELEMENT_NO_SINKS = 0, /** has no sink pads */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
64 PURPLE_MEDIA_ELEMENT_ONE_SINK = 1 << 5, /** has one sink pad */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
65 PURPLE_MEDIA_ELEMENT_MULTI_SINK = 1 << 6, /** has multiple sink pads */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
66 PURPLE_MEDIA_ELEMENT_REQUEST_SINK = 1 << 7, /** sink pads must be requested */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
67
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
68 PURPLE_MEDIA_ELEMENT_UNIQUE = 1 << 8, /** This element is unique and
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
69 only one instance of it should
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
70 be created at a time */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
71
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
72 PURPLE_MEDIA_ELEMENT_SRC = 1 << 9, /** can be set as an active src */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
73 PURPLE_MEDIA_ELEMENT_SINK = 1 << 10, /** can be set as an active sink */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
74 } PurpleMediaElementType;
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
75
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
76 #ifdef __cplusplus
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
77 extern "C" {
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
78 #endif
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
79
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
80 /**
26484
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
81 * Gets the element type's GType.
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
82 *
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
83 * @return The element type's GType.
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
84 */
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
85 GType purple_media_element_type_get_type(void);
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
86
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
87 /**
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
88 * Gets the element info's GType.
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
89 *
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
90 * @return The element info's GType.
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
91 */
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
92 GType purple_media_element_info_get_type(void);
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
93
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
94 /**
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
95 * Gets the source from a session
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
96 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
97 * @param media The media object the session is in.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
98 * @param sess_id The session id of the session to get the source from.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
99 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
100 * @return The source retrieved.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
101 */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
102 GstElement *purple_media_get_src(PurpleMedia *media, const gchar *sess_id);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
103
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
104 /**
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
105 * Gets the tee from a given session/stream.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
106 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
107 * @param media The instance to get the tee from.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
108 * @param session_id The id of the session to get the tee from.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
109 * @param participant Optionally, the participant of the stream to get the tee from.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
110 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
111 * @return The GstTee element from the chosen session/stream.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
112 */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
113 GstElement *purple_media_get_tee(PurpleMedia *media,
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
114 const gchar *session_id, const gchar *participant);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
115
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
116
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
117 /**
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
118 * Gets the pipeline from the media manager.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
119 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
120 * @param manager The media manager to get the pipeline from.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
121 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
122 * @return The pipeline.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
123 */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
124 GstElement *purple_media_manager_get_pipeline(PurpleMediaManager *manager);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
125
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
126 /**
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
127 * Returns a GStreamer source or sink for audio or video.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
128 *
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
129 * @param manager The media manager to use to obtain the source/sink.
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
130 * @param type The type of source/sink to get.
28490
713987ae3215 Fix some docs warnings. Thanks to darkrain for pointing them out.
maiku@pidgin.im
parents: 28397
diff changeset
131 * @param media The media call this element is requested for.
713987ae3215 Fix some docs warnings. Thanks to darkrain for pointing them out.
maiku@pidgin.im
parents: 28397
diff changeset
132 * @param session_id The id of the session this element is requested for or NULL.
713987ae3215 Fix some docs warnings. Thanks to darkrain for pointing them out.
maiku@pidgin.im
parents: 28397
diff changeset
133 * @param participant The remote user this element is requested for or NULL.
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
134 */
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
135 GstElement *purple_media_manager_get_element(PurpleMediaManager *manager,
26474
9c671fc1b351 Give more information to element creation functions.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26432
diff changeset
136 PurpleMediaSessionType type, PurpleMedia *media,
9c671fc1b351 Give more information to element creation functions.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26432
diff changeset
137 const gchar *session_id, const gchar *participant);
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
138
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
139 PurpleMediaElementInfo *purple_media_manager_get_element_info(
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
140 PurpleMediaManager *manager, const gchar *name);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
141 gboolean purple_media_manager_register_element(PurpleMediaManager *manager,
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
142 PurpleMediaElementInfo *info);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
143 gboolean purple_media_manager_unregister_element(PurpleMediaManager *manager,
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
144 const gchar *name);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
145 gboolean purple_media_manager_set_active_element(PurpleMediaManager *manager,
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
146 PurpleMediaElementInfo *info);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
147 PurpleMediaElementInfo *purple_media_manager_get_active_element(
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
148 PurpleMediaManager *manager, PurpleMediaElementType type);
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
149
31814
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
150 /**
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
151 * Reduces media formats supported by the video source to given set.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
152 *
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
153 * Useful to force negotiation of smaller picture resolution more suitable for
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
154 * use with particular codec and communication protocol without rescaling.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
155 *
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
156 * @param manager The media manager to set the media formats.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
157 * @param caps Set of allowed media formats.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
158 */
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
159 void purple_media_manager_set_video_caps(PurpleMediaManager *manager,
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
160 GstCaps *caps);
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
161
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
162 /**
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
163 * Returns current set of media formats limiting the output from video source.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
164 *
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
165 * @param manager The media manager to get the media formats from.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
166 *
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
167 * @return @c GstCaps limiting the video source's formats.
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
168 */
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
169 GstCaps *purple_media_manager_get_video_caps(PurpleMediaManager *manager);
55e30c0eca22 Public API allowing plugins (including prpls) to get/set video capabilities where desired/appropriate. Fixes #13095.
jakub.adam@ktknet.cz
parents: 28490
diff changeset
170
26484
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
171 gchar *purple_media_element_info_get_id(PurpleMediaElementInfo *info);
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
172 gchar *purple_media_element_info_get_name(PurpleMediaElementInfo *info);
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
173 PurpleMediaElementType purple_media_element_info_get_element_type(
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
174 PurpleMediaElementInfo *info);
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
175 GstElement *purple_media_element_info_call_create(
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
176 PurpleMediaElementInfo *info, PurpleMedia *media,
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
177 const gchar *session_id, const gchar *participant);
081a819bc710 Hide and gobjectify PurpleMediaElementInfo.
Mike Ruprecht <maiku@soc.pidgin.im>
parents: 26475
diff changeset
178
26431
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
179 #ifdef __cplusplus
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
180 }
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
181 #endif
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
182
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
183 G_END_DECLS
1ae3af12095a Move GStreamer related media functions into its own header.
Mike Ruprecht <maiku@soc.pidgin.im>
parents:
diff changeset
184
26520
fd97c0de433d Add PURPLE to the media header sentinels and reorder includes to fix building gf2
Paul Aurich <paul@darkrain42.org>
parents: 26519
diff changeset
185 #endif /* _PURPLE_MEDIA_GST_H_ */