diff --git a/clutter/clutter-units.c b/clutter/clutter-units.c index 4c8ecdca4..75802b89d 100644 --- a/clutter/clutter-units.c +++ b/clutter/clutter-units.c @@ -132,7 +132,7 @@ units_em_to_pixels (const gchar *font_name, } /** - * clutter_units_mm: + * clutter_units_from_mm: * @units: a #ClutterUnits * @mm: millimeters * @@ -141,8 +141,8 @@ units_em_to_pixels (const gchar *font_name, * Since: 1.0 */ void -clutter_units_mm (ClutterUnits *units, - gfloat mm) +clutter_units_from_mm (ClutterUnits *units, + gfloat mm) { g_return_if_fail (units != NULL); @@ -153,7 +153,7 @@ clutter_units_mm (ClutterUnits *units, } /** - * clutter_units_pt: + * clutter_units_from_pt: * @units: a #ClutterUnits * @pt: typographic points * @@ -162,8 +162,8 @@ clutter_units_mm (ClutterUnits *units, * Since: 1.0 */ void -clutter_units_pt (ClutterUnits *units, - gfloat pt) +clutter_units_from_pt (ClutterUnits *units, + gfloat pt) { g_return_if_fail (units != NULL); @@ -174,7 +174,7 @@ clutter_units_pt (ClutterUnits *units, } /** - * clutter_units_em: + * clutter_units_from_em: * @units: a #ClutterUnits * @em: em * @@ -184,8 +184,8 @@ clutter_units_pt (ClutterUnits *units, * Since: 1.0 */ void -clutter_units_em (ClutterUnits *units, - gfloat em) +clutter_units_from_em (ClutterUnits *units, + gfloat em) { g_return_if_fail (units != NULL); @@ -196,7 +196,7 @@ clutter_units_em (ClutterUnits *units, } /** - * clutter_units_em_for_font: + * clutter_units_from_em_for_font: * @units: a #ClutterUnits * @font_name: the font name and size * @em: em @@ -206,9 +206,9 @@ clutter_units_em (ClutterUnits *units, * Since: 1.0 */ void -clutter_units_em_for_font (ClutterUnits *units, - const gchar *font_name, - gfloat em) +clutter_units_from_em_for_font (ClutterUnits *units, + const gchar *font_name, + gfloat em) { g_return_if_fail (units != NULL); @@ -219,7 +219,7 @@ clutter_units_em_for_font (ClutterUnits *units, } /** - * clutter_units_pixels: + * clutter_units_from_pixels: * @units: a #ClutterUnits * @px: pixels * @@ -228,8 +228,8 @@ clutter_units_em_for_font (ClutterUnits *units, * Since: 1.0 */ void -clutter_units_pixels (ClutterUnits *units, - gint px) +clutter_units_from_pixels (ClutterUnits *units, + gint px) { g_return_if_fail (units != NULL); @@ -550,7 +550,7 @@ static void clutter_value_transform_int_units (const GValue *src, GValue *dest) { - clutter_units_pixels (dest->data[0].v_pointer, src->data[0].v_int); + clutter_units_from_pixels (dest->data[0].v_pointer, src->data[0].v_int); } /* units to float */ @@ -566,7 +566,7 @@ static void clutter_value_transform_float_units (const GValue *src, GValue *dest) { - clutter_units_pixels (dest->data[0].v_pointer, src->data[0].v_float); + clutter_units_from_pixels (dest->data[0].v_pointer, src->data[0].v_float); } /* units to string */ diff --git a/clutter/clutter-units.h b/clutter/clutter-units.h index 81070b0a9..4a407787f 100644 --- a/clutter/clutter-units.h +++ b/clutter/clutter-units.h @@ -83,30 +83,37 @@ struct _ClutterUnits gint64 __padding_2; }; -GType clutter_units_get_type (void) G_GNUC_CONST; -ClutterUnitType clutter_units_get_unit_type (const ClutterUnits *units); -gfloat clutter_units_get_unit_value (const ClutterUnits *units); +GType clutter_units_get_type (void) G_GNUC_CONST; +ClutterUnitType clutter_units_get_unit_type (const ClutterUnits *units); +gfloat clutter_units_get_unit_value (const ClutterUnits *units); -ClutterUnits * clutter_units_copy (const ClutterUnits *units); -void clutter_units_free (ClutterUnits *units); +ClutterUnits * clutter_units_copy (const ClutterUnits *units); +void clutter_units_free (ClutterUnits *units); -void clutter_units_pixels (ClutterUnits *units, - gint px); -void clutter_units_em (ClutterUnits *units, - gfloat em); -void clutter_units_em_for_font (ClutterUnits *units, - const gchar *font_name, - gfloat em); -void clutter_units_mm (ClutterUnits *units, - gfloat mm); -void clutter_units_pt (ClutterUnits *units, - gfloat pt); +void clutter_units_from_pixels (ClutterUnits *units, + gint px); +void clutter_units_from_em (ClutterUnits *units, + gfloat em); +void clutter_units_from_em_for_font (ClutterUnits *units, + const gchar *font_name, + gfloat em); +void clutter_units_from_mm (ClutterUnits *units, + gfloat mm); +void clutter_units_from_pt (ClutterUnits *units, + gfloat pt); -gfloat clutter_units_to_pixels (ClutterUnits *units); +gfloat clutter_units_to_pixels (ClutterUnits *units); -gchar * clutter_units_to_string (const ClutterUnits *units); -gboolean clutter_units_from_string (ClutterUnits *units, - const gchar *str); +gboolean clutter_units_from_string (ClutterUnits *units, + const gchar *str); +gchar * clutter_units_to_string (const ClutterUnits *units); + +/* shorthands for the constructors */ +#define clutter_units_pixels clutter_units_from_pixels +#define clutter_units_em clutter_units_from_em +#define clutter_units_em_for_font clutter_units_from_em_for_font +#define clutter_units_mm clutter_units_from_mm +#define clutter_units_pt clutter_units_from_pt #define CLUTTER_TYPE_UNITS (clutter_units_get_type ()) #define CLUTTER_TYPE_PARAM_UNITS (clutter_param_units_get_type ()) diff --git a/doc/reference/clutter/clutter-sections.txt b/doc/reference/clutter/clutter-sections.txt index 7f2649e4c..a40eca6de 100644 --- a/doc/reference/clutter/clutter-sections.txt +++ b/doc/reference/clutter/clutter-sections.txt @@ -29,11 +29,11 @@ clutter_media_get_type