brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

2008-11-07 Emmanuele Bassi <ebassi@linux.intel.com>

Browse Source 
* clutter/clutter-media.c: Improve documentation of the
	ClutterMedia interface.
This commit is contained in:
Emmanuele Bassi 2008-11-07 18:00:59 +00:00
parent 1453d8b44f
commit 7c6ae80bfe
2 changed files with 61 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
ChangeLog
View File

@ -1,21 +1,26 @@
2008-11-07 Emmanuele Bassi <ebassi@linux.intel.com>
* clutter/clutter-media.c: Improve documentation of the
ClutterMedia interface.
2008-11-07 Matthew Allum <mallum@linux.intel.com> 2008-11-07 Matthew Allum <mallum@linux.intel.com>
Bug 1238 - [PATCH] Pack bitfields in ClutterTexturePrivate Bug 1238 - [PATCH] Pack bitfields in ClutterTexturePrivate
* clutter/clutter-texture.c: * clutter/clutter-texture.c:
Using 'guint my_field : 1' for booleans to save space only Using 'guint my_field : 1' for booleans to save space only
makes sense if you group all such fields together. Fix makes sense if you group all such fields together. Fix
grouping for ClutterTexturePrivate. Thanks to Owen Taylor for grouping for ClutterTexturePrivate. Thanks to Owen Taylor for
patch. patch.
2008-11-07 Matthew Allum <mallum@linux.intel.com> 2008-11-07 Matthew Allum <mallum@linux.intel.com>
Bug 1237 - clutter_texture_set_filter_quality calls Bug 1237 - clutter_texture_set_filter_quality calls
clutter_texture_[un]realize clutter_texture_[un]realize
* clutter/clutter-texture.c: (clutter_texture_set_filter_quality): * clutter/clutter-texture.c: (clutter_texture_set_filter_quality):
Call clutter_actor_[un]realize and keep visibility state Call clutter_actor_[un]realize and keep visibility state
2008-11-07 Matthew Allum <mallum@linux.intel.com> 2008-11-07 Matthew Allum <mallum@linux.intel.com>
@ -25,11 +30,11 @@
* clutter/clutter-private.h: * clutter/clutter-private.h:
* clutter/clutter-texture.c: * clutter/clutter-texture.c:
* clutter/x11/clutter-x11-texture-pixmap.c: * clutter/x11/clutter-x11-texture-pixmap.c:
Attempt to lower overhead of updating TFP's (particularly mipmaped). Attempt to lower overhead of updating TFP's (particularly mipmaped).
Compresses mipmap updates only for visible TFPs. Compresses mipmap updates only for visible TFPs.
Avoiding updates for non visible TFP's whilst keeping visible Avoiding updates for non visible TFP's whilst keeping visible
clones working ok. clones working ok.
2008-11-06 Neil Roberts <neil@linux.intel.com> 2008-11-06 Neil Roberts <neil@linux.intel.com>
@ -134,10 +139,10 @@
* clutter/clutter-texture.c: (clutter_texture_set_filter_quality), * clutter/clutter-texture.c: (clutter_texture_set_filter_quality),
(clutter_texture_get_filter_quality): (clutter_texture_get_filter_quality):
Fix up some logic, typos. Fix up some logic, typos.
* clutter/glx/clutter-glx-texture-pixmap.c: * clutter/glx/clutter-glx-texture-pixmap.c:
Improve support for mipmaped TFP textures. Improve support for mipmaped TFP textures.
2008-10-31 Emmanuele Bassi <ebassi@linux.intel.com> 2008-10-31 Emmanuele Bassi <ebassi@linux.intel.com>
@ -1001,7 +1006,7 @@
2008-07-17 Emmanuele Bassi <ebassi@openedhand.com> 2008-07-17 Emmanuele Bassi <ebassi@openedhand.com>
Bug 1047 - API documentation from release tarball is not Bug 1047 - API documentation from release tarball is not
installed by "make install" installed by "make install"
* configure.ac: * configure.ac:
* Makefile.am: Make the recursion into the documentation * Makefile.am: Make the recursion into the documentation
@ -1047,7 +1052,7 @@
2008-07-13 Matthew Allum <mallum@openedhand.com> 2008-07-13 Matthew Allum <mallum@openedhand.com>
* clutter/x11/clutter-x11-texture-pixmap.c: * clutter/x11/clutter-x11-texture-pixmap.c:
Call XSync in unredirect X error trap (Thanks to Andy Wingo) Call XSync in unredirect X error trap (Thanks to Andy Wingo)
2008-07-13 Neil Roberts <neil@o-hand.com> 2008-07-13 Neil Roberts <neil@o-hand.com>
@ -1111,7 +1116,7 @@
2008-07-07 Matthew Allum <mallum@openedhand.com> 2008-07-07 Matthew Allum <mallum@openedhand.com>
Bug 1016 - Changing window-redirect-automatic property after Bug 1016 - Changing window-redirect-automatic property after
creating ClutterX11TexturePixmap doesn't work. creating ClutterX11TexturePixmap doesn't work.
* clutter/x11/clutter-x11-texture-pixmap.c: * clutter/x11/clutter-x11-texture-pixmap.c:
(clutter_x11_texture_pixmap_set_window): (clutter_x11_texture_pixmap_set_window):
@ -1132,7 +1137,7 @@
2008-07-05 Emmanuele Bassi <ebassi@openedhand.com> 2008-07-05 Emmanuele Bassi <ebassi@openedhand.com>
Bug 1033 - Manually parsing command line options prevents Bug 1033 - Manually parsing command line options prevents
initializing clutter (Armin Burgmeier) initializing clutter (Armin Burgmeier)
* clutter/clutter-main.c: * clutter/clutter-main.c:
(post_parse_hook), (clutter_init_real): Set the is_initialized (post_parse_hook), (clutter_init_real): Set the is_initialized
@ -1275,7 +1280,7 @@
2008-07-01 Øyvind Kolås <pippin@o-hand.com> 2008-07-01 Øyvind Kolås <pippin@o-hand.com>
Bug 1013 - Per device grabs are not obeyed in pointer device Bug 1013 - Per device grabs are not obeyed in pointer device
propagation. propagation.
* clutter/clutter-event.c: (clutter_event_get_device_id): swap * clutter/clutter-event.c: (clutter_event_get_device_id): swap
arguments of g_return_val_if_fail around. arguments of g_return_val_if_fail around.
@ -1369,7 +1374,7 @@
2008-06-30 Matthew Allum <mallum@openedhand.com> 2008-06-30 Matthew Allum <mallum@openedhand.com>
Bug 997 - automatic updates not working for named TFP pixmaps, Bug 997 - automatic updates not working for named TFP pixmaps,
at least in x11 at least in x11
* clutter/glx/clutter-glx-texture-pixmap.c: * clutter/glx/clutter-glx-texture-pixmap.c:
* clutter/glx/clutter-glx-texture-pixmap.h: * clutter/glx/clutter-glx-texture-pixmap.h:
@ -1385,7 +1390,7 @@
2008-06-30 Emmanuele Bassi <ebassi@openedhand.com> 2008-06-30 Emmanuele Bassi <ebassi@openedhand.com>
Bug 980 - cogl-bitmap-fallback.c compiler error/warning due to Bug 980 - cogl-bitmap-fallback.c compiler error/warning due to
cast issue (Haakon Sporsheim) cast issue (Haakon Sporsheim)
* clutter/cogl/common/cogl-bitmap-fallback.c: * clutter/cogl/common/cogl-bitmap-fallback.c:
(_cogl_unpremult_alpha_last), (_cogl_unpremult_alpha_last),
@ -1888,7 +1893,7 @@
2008-06-23 Emmanuele Bassi <ebassi@openedhand.com> 2008-06-23 Emmanuele Bassi <ebassi@openedhand.com>
Bug 984 - pango_clutter_render_layout() declared void, but Bug 984 - pango_clutter_render_layout() declared void, but
returns (Haakon Sporsheim) returns (Haakon Sporsheim)
* clutter/pango/pangoclutter-render.c: * clutter/pango/pangoclutter-render.c:
(pango_clutter_render_layout): Do not use a return statement. (pango_clutter_render_layout): Do not use a return statement.
@ -2120,7 +2125,7 @@
2008-06-13 Emmanuele Bassi <ebassi@openedhand.com> 2008-06-13 Emmanuele Bassi <ebassi@openedhand.com>
Bug #953 - Actors are not hidden before unrealized or Bug #953 - Actors are not hidden before unrealized or
disposed (Tommi Komulainen) disposed (Tommi Komulainen)
* clutter/clutter-actor.c: * clutter/clutter-actor.c:
(clutter_actor_unrealize): Hide a visible actor when unrealizing (clutter_actor_unrealize): Hide a visible actor when unrealizing
@ -2842,7 +2847,7 @@
2008-05-31 Emmanuele Bassi <ebassi@openedhand.com> 2008-05-31 Emmanuele Bassi <ebassi@openedhand.com>
Bug #943 - Signals are only emitted within a certain area of Bug #943 - Signals are only emitted within a certain area of
the stage the stage
* clutter/clutter-main.c (clutter_do_event): Use the proper * clutter/clutter-main.c (clutter_do_event): Use the proper
API and not the macros for the default stage, in case we are API and not the macros for the default stage, in case we are

36
clutter/clutter-media.c
View File

@ -27,7 +27,13 @@
* SECTION:clutter-media * SECTION:clutter-media
* @short_description: An interface for controlling playback of media data. * @short_description: An interface for controlling playback of media data.
* *
* #ClutterMedia is an interface for controlling playback of media data. * #ClutterMedia is an interface for controlling playback of media sources.
*
* It is not implemented inside Clutter, but other integration libraries
* like Clutter-GStreamer, implement it to offer a uniform API for
* applications.
*
* ClutterMedia is available since Clutter 0.2
*/ */
#ifdef HAVE_CONFIG_H #ifdef HAVE_CONFIG_H
@ -203,6 +209,8 @@ clutter_media_base_init (gpointer g_iface)
* @uri: URI * @uri: URI
* *
* Sets the URI of @media to @uri. * Sets the URI of @media to @uri.
*
* Since: 0.2
*/ */
void void
clutter_media_set_uri (ClutterMedia *media, clutter_media_set_uri (ClutterMedia *media,
@ -220,6 +228,8 @@ clutter_media_set_uri (ClutterMedia *media,
* Retrieves the URI from @media. * Retrieves the URI from @media.
* *
* Return value: The URI as a string. * Return value: The URI as a string.
*
* Since: 0.2
*/ */
const char* const char*
clutter_media_get_uri (ClutterMedia *media) clutter_media_get_uri (ClutterMedia *media)
@ -235,6 +245,8 @@ clutter_media_get_uri (ClutterMedia *media)
* @playing: TRUE to start playing, FALSE to stop. * @playing: TRUE to start playing, FALSE to stop.
* *
* Starts or stops @media playing. * Starts or stops @media playing.
*
* Since: 0.2
*/ */
void void
clutter_media_set_playing (ClutterMedia *media, clutter_media_set_playing (ClutterMedia *media,
@ -252,6 +264,8 @@ clutter_media_set_playing (ClutterMedia *media,
* Retrieves the playing status of @media. * Retrieves the playing status of @media.
* *
* Return value: %TRUE if playing, %FALSE if stopped. * Return value: %TRUE if playing, %FALSE if stopped.
*
* Since: 0.2
*/ */
gboolean gboolean
clutter_media_get_playing (ClutterMedia *media) clutter_media_get_playing (ClutterMedia *media)
@ -267,6 +281,8 @@ clutter_media_get_playing (ClutterMedia *media)
* @position: The desired position. * @position: The desired position.
* *
* Sets the playback position of @media to @position. * Sets the playback position of @media to @position.
*
* Since: 0.2
*/ */
void void
clutter_media_set_position (ClutterMedia *media, clutter_media_set_position (ClutterMedia *media,
@ -284,6 +300,8 @@ clutter_media_set_position (ClutterMedia *media,
* Retrieves the position of @media. * Retrieves the position of @media.
* *
* Return value: The playback position. * Return value: The playback position.
*
* Since: 0.2
*/ */
int int
clutter_media_get_position (ClutterMedia *media) clutter_media_get_position (ClutterMedia *media)
@ -299,6 +317,8 @@ clutter_media_get_position (ClutterMedia *media)
* @volume: The volume as a double between 0.0 and 1.0 * @volume: The volume as a double between 0.0 and 1.0
* *
* Sets the playback volume of @media to @volume. * Sets the playback volume of @media to @volume.
*
* Since: 0.2
*/ */
void void
clutter_media_set_volume (ClutterMedia *media, clutter_media_set_volume (ClutterMedia *media,
@ -316,6 +336,8 @@ clutter_media_set_volume (ClutterMedia *media,
* Retrieves the playback volume of @media. * Retrieves the playback volume of @media.
* *
* Return value: The playback volume between 0.0 and 1.0 * Return value: The playback volume between 0.0 and 1.0
*
* Since: 0.2
*/ */
double double
clutter_media_get_volume (ClutterMedia *media) clutter_media_get_volume (ClutterMedia *media)
@ -332,6 +354,8 @@ clutter_media_get_volume (ClutterMedia *media)
* Retrieves whether @media is seekable or not. * Retrieves whether @media is seekable or not.
* *
* Return value: %TRUE if @media can seek, %FALSE otherwise. * Return value: %TRUE if @media can seek, %FALSE otherwise.
*
* Since: 0.2
*/ */
gboolean gboolean
clutter_media_get_can_seek (ClutterMedia *media) clutter_media_get_can_seek (ClutterMedia *media)
@ -348,6 +372,8 @@ clutter_media_get_can_seek (ClutterMedia *media)
* Retrieves the amount of the stream that is buffered. * Retrieves the amount of the stream that is buffered.
* *
* Return value: percentage value * Return value: percentage value
*
* Since: 0.2
*/ */
int int
clutter_media_get_buffer_percent (ClutterMedia *media) clutter_media_get_buffer_percent (ClutterMedia *media)
@ -364,6 +390,8 @@ clutter_media_get_buffer_percent (ClutterMedia *media)
* Retrieves the duration of the media stream that @media represents. * Retrieves the duration of the media stream that @media represents.
* *
* Return value: The length of the media stream. * Return value: The length of the media stream.
*
* Since: 0.2
*/ */
int int
clutter_media_get_duration (ClutterMedia *media) clutter_media_get_duration (ClutterMedia *media)
@ -381,6 +409,8 @@ clutter_media_get_duration (ClutterMedia *media)
* @filename: A filename to media file. * @filename: A filename to media file.
* *
* Sets the filename of the media source. * Sets the filename of the media source.
*
* Since: 0.2
*/ */
void void
clutter_media_set_filename (ClutterMedia *media, clutter_media_set_filename (ClutterMedia *media,
@ -398,9 +428,7 @@ clutter_media_set_filename (ClutterMedia *media,
g_free (abs_path); g_free (abs_path);
} }
else else
{ uri = g_filename_to_uri (filename, NULL, &uri_error);
uri = g_filename_to_uri (filename, NULL, &uri_error);
}
if (uri_error) if (uri_error)
{ {