sungmg/mutter-performance-source
1
0
Fork 0
Code Activity

[layout, docs] Clean up BinLayout documentation

Browse source 
Documentation and code style fixes for BinLayout.
This commit is contained in:
Emmanuele Bassi 2009-09-17 11:38:43 +01:00
parent 8b2088a917
commit df6ca3d171
2 changed files with 112 additions and 32 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

120
clutter/clutter-bin-layout.c
View file

@ -29,6 +29,50 @@
* #ClutterBinLayout is a layout manager which implements the following * #ClutterBinLayout is a layout manager which implements the following
* policy: * policy:
* *
* <itemizedlist>
* <listitem><simpara>the preferred size is the maximum preferred size
* between all the children of the container using the
* layout;</simpara></listitem>
* <listitem><simpara>each child is allocated in "layers", on on top
* of the other;</simpara></listitem>
* <listitem><simpara>for each layer there are horizontal and vertical
* alignment policies.</simpara></listitem>
* </itemizedlist>
*
* <example id="example-clutter-bin-layout">
* <title>How to pack actors inside a BinLayout</title>
* <para>The following code shows how to build a composite actor with
* a texture and a background, and add controls overlayed on top. The
* background is set to fill the whole allocation, whilst the texture
* is centered; there is a control in the top right corner and a label
* in the bottom, filling out the whole allocated width.</para>
* <programlisting>
* ClutterLayoutManager *manager;
* ClutterActor *box;
*
* /&ast; create the layout first &ast;/
* layout = clutter_bin_layout_new (CLUTTER_BIN_ALIGNMENT_CENTER,
* CLUTTER_BIN_ALIGNMENT_CENTER);
* box = clutter_box_new (layout); /&ast; then the container &ast;/
*
* /&ast; we can use the layout object to add actors &ast;/
* clutter_bin_layout_add (CLUTTER_BIN_LAYOUT (layout), background,
* CLUTTER_BIN_ALIGNMENT_FILL,
* CLUTTER_BIN_ALIGNMENT_FILL);
* clutter_bin_layout_add (CLUTTER_BIN_LAYOUT (layout), icon,
* CLUTTER_BIN_ALIGNMENT_CENTER,
* CLUTTER_BIN_ALIGNMENT_CENTER);
*
* /&ast; align to the bottom left &ast;/
* clutter_bin_layout_add (CLUTTER_BIN_LAYOUT (layout), label,
* CLUTTER_BIN_ALIGNMENT_START,
* CLUTTER_BIN_ALIGNMENT_END);
* /&ast; align to the top right &ast;/
* clutter_bin_layout_add (CLUTTER_BIN_LAYOUT (layout), button,
* CLUTTER_BIN_ALIGNMENT_END,
* CLUTTER_BIN_ALIGNMENT_START);
* </programlisting>
* </example>
* *
* #ClutterBinLayout is available since Clutter 1.2 * #ClutterBinLayout is available since Clutter 1.2
*/ */
@ -95,7 +139,6 @@ G_DEFINE_TYPE (ClutterBinLayout,
clutter_bin_layout, clutter_bin_layout,
CLUTTER_TYPE_LAYOUT_MANAGER); CLUTTER_TYPE_LAYOUT_MANAGER);
/* /*
* ClutterBinLayer * ClutterBinLayer
*/ */
@ -509,16 +552,16 @@ clutter_bin_layout_set_property (GObject *gobject,
const GValue *value, const GValue *value,
GParamSpec *pspec) GParamSpec *pspec)
{ {
ClutterBinLayout *layout = CLUTTER_BIN_LAYOUT (gobject);
switch (prop_id) switch (prop_id)
{ {
case PROP_X_ALIGN: case PROP_X_ALIGN:
set_x_align (CLUTTER_BIN_LAYOUT (gobject), set_x_align (layout, g_value_get_enum (value));
g_value_get_enum (value));
break; break;
case PROP_Y_ALIGN: case PROP_Y_ALIGN:
set_y_align (CLUTTER_BIN_LAYOUT (gobject), set_y_align (layout, g_value_get_enum (value));
g_value_get_enum (value));
break; break;
default: default:
@ -569,8 +612,8 @@ clutter_bin_layout_class_init (ClutterBinLayoutClass *klass)
/** /**
* ClutterBinLayout:x-align: * ClutterBinLayout:x-align:
* *
* The horizontal alignment policy for actors managed by the * The default horizontal alignment policy for actors managed
* #ClutterBinLayout * by the #ClutterBinLayout
* *
* Since: 1.2 * Since: 1.2
*/ */
@ -586,8 +629,8 @@ clutter_bin_layout_class_init (ClutterBinLayoutClass *klass)
/** /**
* ClutterBinLayout:y-align: * ClutterBinLayout:y-align:
* *
* The vertical alignment policy for actors managed by the * The default vertical alignment policy for actors managed
* #ClutterBinLayout * by the #ClutterBinLayout
* *
* Since: 1.2 * Since: 1.2
*/ */
@ -670,16 +713,24 @@ clutter_bin_layout_set_alignment (ClutterBinLayout *self,
ClutterBinLayoutPrivate *priv; ClutterBinLayoutPrivate *priv;
ClutterLayoutManager *manager; ClutterLayoutManager *manager;
ClutterLayoutMeta *meta; ClutterLayoutMeta *meta;
ClutterBinLayer *layer;
g_return_if_fail (CLUTTER_IS_BIN_LAYOUT (self)); g_return_if_fail (CLUTTER_IS_BIN_LAYOUT (self));
g_return_if_fail (child == NULL || CLUTTER_IS_ACTOR (child));
priv = self->priv; priv = self->priv;
if (child == NULL || priv->container == NULL) if (priv->container == NULL)
{ {
set_x_align (self, x_align); if (child == NULL)
set_y_align (self, y_align); {
set_x_align (self, x_align);
set_y_align (self, y_align);
}
else
g_warning ("The layout of type '%s' must be associated to "
"a ClutterContainer before setting the alignment "
"on its children",
G_OBJECT_TYPE_NAME (self));
return; return;
} }
@ -688,12 +739,10 @@ clutter_bin_layout_set_alignment (ClutterBinLayout *self,
meta = clutter_layout_manager_get_child_meta (manager, meta = clutter_layout_manager_get_child_meta (manager,
priv->container, priv->container,
child); child);
g_return_if_fail (CLUTTER_IS_BIN_LAYER (meta)); g_assert (CLUTTER_IS_BIN_LAYER (meta));
layer = CLUTTER_BIN_LAYER (meta); set_layer_x_align (CLUTTER_BIN_LAYER (meta), x_align);
set_layer_y_align (CLUTTER_BIN_LAYER (meta), y_align);
set_layer_x_align (layer, x_align);
set_layer_y_align (layer, y_align);
} }
/** /**
@ -728,13 +777,21 @@ clutter_bin_layout_get_alignment (ClutterBinLayout *self,
priv = self->priv; priv = self->priv;
if (child == NULL || priv->container == NULL) if (priv->container == NULL)
{ {
if (x_align) if (child == NULL)
*x_align = priv->x_align; {
if (x_align)
*x_align = priv->x_align;
if (y_align) if (y_align)
*y_align = priv->y_align; *y_align = priv->y_align;
}
else
g_warning ("The layout of type '%s' must be associated to "
"a ClutterContainer before getting the alignment "
"of its children",
G_OBJECT_TYPE_NAME (self));
return; return;
} }
@ -743,7 +800,7 @@ clutter_bin_layout_get_alignment (ClutterBinLayout *self,
meta = clutter_layout_manager_get_child_meta (manager, meta = clutter_layout_manager_get_child_meta (manager,
priv->container, priv->container,
child); child);
g_return_if_fail (CLUTTER_IS_BIN_LAYER (meta)); g_assert (CLUTTER_IS_BIN_LAYER (meta));
layer = CLUTTER_BIN_LAYER (meta); layer = CLUTTER_BIN_LAYER (meta);
@ -765,8 +822,9 @@ clutter_bin_layout_get_alignment (ClutterBinLayout *self,
* sets the alignment policies for it * sets the alignment policies for it
* *
* This function is equivalent to clutter_container_add_actor() * This function is equivalent to clutter_container_add_actor()
* and clutter_layout_manager_get_child_meta() but it does not * and clutter_layout_manager_child_set_property() but it does not
* require the #ClutterContainer * require a pointer to the #ClutterContainer associated to the
* #ClutterBinLayout
* *
* Since: 1.2 * Since: 1.2
*/ */
@ -776,10 +834,9 @@ clutter_bin_layout_add (ClutterBinLayout *self,
ClutterBinAlignment x_align, ClutterBinAlignment x_align,
ClutterBinAlignment y_align) ClutterBinAlignment y_align)
{ {
ClutterBinLayer *layer;
ClutterLayoutMeta *meta;
ClutterLayoutManager *manager;
ClutterBinLayoutPrivate *priv; ClutterBinLayoutPrivate *priv;
ClutterLayoutManager *manager;
ClutterLayoutMeta *meta;
g_return_if_fail (CLUTTER_IS_BIN_LAYOUT (self)); g_return_if_fail (CLUTTER_IS_BIN_LAYOUT (self));
g_return_if_fail (CLUTTER_IS_ACTOR (child)); g_return_if_fail (CLUTTER_IS_ACTOR (child));
@ -802,7 +859,6 @@ clutter_bin_layout_add (ClutterBinLayout *self,
child); child);
g_assert (CLUTTER_IS_BIN_LAYER (meta)); g_assert (CLUTTER_IS_BIN_LAYER (meta));
layer = CLUTTER_BIN_LAYER (meta); set_layer_x_align (CLUTTER_BIN_LAYER (meta), x_align);
set_layer_x_align (layer, x_align); set_layer_y_align (CLUTTER_BIN_LAYER (meta), y_align);
set_layer_y_align (layer, y_align);
} }

24
clutter/clutter-bin-layout.h
View file

@ -1,3 +1,27 @@
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
* Copyright (C) 2009 Intel Corporation.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*
* Author:
* Emmanuele Bassi <ebassi@linux.intel.com>
*/
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION) #if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
#error "Only <clutter/clutter.h> can be included directly." #error "Only <clutter/clutter.h> can be included directly."
#endif #endif