Unit conversion

Unit conversion — A logical distance unit.

Synopsis




typedef             ClutterUnit;
#define             CLUTTER_UNITS_FROM_DEVICE           (x)
#define             CLUTTER_UNITS_TO_DEVICE             (x)
#define             CLUTTER_UNITS_FROM_FIXED            (x)
#define             CLUTTER_UNITS_TO_FIXED              (x)
#define             CLUTTER_UNITS_FROM_FLOAT            (x)
#define             CLUTTER_UNITS_TO_FLOAT              (x)
#define             CLUTTER_UNITS_FROM_INT              (x)
#define             CLUTTER_UNITS_TO_INT                (x)
#define             CLUTTER_UNITS_FROM_PANGO_UNIT       (x)
#define             CLUTTER_UNITS_TO_PANGO_UNIT         (x)
#define             CLUTTER_UNITS_TMP_FROM_DEVICE       (x)
#define             CLUTTER_UNITS_TMP_TO_DEVICE         (x)
#define             CLUTTER_UNITS_FROM_STAGE_WIDTH_PERCENTAGE(x)
#define             CLUTTER_UNITS_FROM_STAGE_HEIGHT_PERCENTAGE(x)
#define             CLUTTER_UNITS_FROM_PARENT_WIDTH_PERCENTAGE(a, x)
#define             CLUTTER_UNITS_FROM_PARENT_HEIGHT_PERCENTAGE(a, x)
#define             CLUTTER_UNITS_FROM_MM               (x)
#define             CLUTTER_UNITS_FROM_MMX              (x)
#define             CLUTTER_UNITS_FROM_POINTS           (x)
#define             CLUTTER_UNITS_FROM_POINTSX          (x)

Description

Clutter units are logical units with granularity greater than that of the device units; they are used by ClutterActorBox and the _units() family of ClutterActor functions. To convert between clutter units and device units, use CLUTTER_UNITS_FROM_DEVICE and CLUTTER_UNITS_TO_DEVICE macros.

Note: It is expected that as of version 0.6 all dimensions in the public Clutter API will be given in clutter units. In order to ease the transition, two extra macros have been provided, CLUTTER_UNITS_TMP_TO_DEVICE and CLUTTER_UNITS_TMP_FROM_DEVICE. In version 0.4 these are identity macros, but when the API transition happens will map to CLUTTER_UNITS_TO_DEVICE and CLUTTER_UNITS_FROM_DEVICE respectively. You can use these in newly written code as place holders.

Details

ClutterUnit

typedef gint32 ClutterUnit;

Device independent unit used by Clutter. The value held can be transformed into other units, likes pixels.

Since 0.4


CLUTTER_UNITS_FROM_DEVICE()

#define CLUTTER_UNITS_FROM_DEVICE(x)     CLUTTER_UNITS_FROM_INT ((x))

Converts x from pixels to ClutterUnits

x : value in pixels

Since 0.6


CLUTTER_UNITS_TO_DEVICE()

#define CLUTTER_UNITS_TO_DEVICE(x)       CLUTTER_UNITS_TO_INT ((x))

Converts x from ClutterUnits to pixels

x : value in ClutterUnits

Since 0.6


CLUTTER_UNITS_FROM_FIXED()

#define CLUTTER_UNITS_FROM_FIXED(x)      (x)

x :

CLUTTER_UNITS_TO_FIXED()

#define CLUTTER_UNITS_TO_FIXED(x)        (x)

x :

CLUTTER_UNITS_FROM_FLOAT()

#define CLUTTER_UNITS_FROM_FLOAT(x)      CLUTTER_FLOAT_TO_FIXED ((x))

x :

CLUTTER_UNITS_TO_FLOAT()

#define CLUTTER_UNITS_TO_FLOAT(x)        CLUTTER_FIXED_TO_FLOAT ((x))

x :

CLUTTER_UNITS_FROM_INT()

#define CLUTTER_UNITS_FROM_INT(x)        CLUTTER_INT_TO_FIXED ((x))

x :

CLUTTER_UNITS_TO_INT()

#define CLUTTER_UNITS_TO_INT(x)          CLUTTER_FIXED_TO_INT ((x))

x :

CLUTTER_UNITS_FROM_PANGO_UNIT()

#define CLUTTER_UNITS_FROM_PANGO_UNIT(x) ((x) << 6)

Converts a value in Pango units to ClutterUnits

x : value in Pango units

Since 0.6


CLUTTER_UNITS_TO_PANGO_UNIT()

#define CLUTTER_UNITS_TO_PANGO_UNIT(x)   ((x) >> 6)

Converts a value in ClutterUnits to Pango units

x : value in ClutterUnits

Since 0.6


CLUTTER_UNITS_TMP_FROM_DEVICE()

#define CLUTTER_UNITS_TMP_FROM_DEVICE(x) (x)

x :

CLUTTER_UNITS_TMP_TO_DEVICE()

#define CLUTTER_UNITS_TMP_TO_DEVICE(x)   (x)

x :

CLUTTER_UNITS_FROM_STAGE_WIDTH_PERCENTAGE()

#define             CLUTTER_UNITS_FROM_STAGE_WIDTH_PERCENTAGE(x)

x :

CLUTTER_UNITS_FROM_STAGE_HEIGHT_PERCENTAGE()

#define             CLUTTER_UNITS_FROM_STAGE_HEIGHT_PERCENTAGE(x)

x :

CLUTTER_UNITS_FROM_PARENT_WIDTH_PERCENTAGE()

#define             CLUTTER_UNITS_FROM_PARENT_WIDTH_PERCENTAGE(a, x)

a :
x :

CLUTTER_UNITS_FROM_PARENT_HEIGHT_PERCENTAGE()

#define             CLUTTER_UNITS_FROM_PARENT_HEIGHT_PERCENTAGE(a, x)

a :
x :

CLUTTER_UNITS_FROM_MM()

#define             CLUTTER_UNITS_FROM_MM(x)

Converts a value in millimeters into ClutterUnits

x : a value in millimeters

Since 0.6


CLUTTER_UNITS_FROM_MMX()

#define             CLUTTER_UNITS_FROM_MMX(x)

x :

CLUTTER_UNITS_FROM_POINTS()

#define             CLUTTER_UNITS_FROM_POINTS(x)

Converts a value in typographic points into ClutterUnits

x : a value in typographic points

Since 0.6


CLUTTER_UNITS_FROM_POINTSX()

#define             CLUTTER_UNITS_FROM_POINTSX(x)

x :