Unit conversion

Unit conversion — A logical distance unit.

Synopsis




typedef             ClutterUnit;
#define             CLUTTER_UNITS_FROM_DEVICE           (x)
#define             CLUTTER_UNITS_FROM_FIXED            (x)
#define             CLUTTER_UNITS_FROM_FLOAT            (x)
#define             CLUTTER_UNITS_FROM_INT              (x)
#define             CLUTTER_UNITS_FROM_PANGO_UNIT       (x)
#define             CLUTTER_UNITS_TMP_FROM_DEVICE       (x)
#define             CLUTTER_UNITS_TMP_TO_DEVICE         (x)
#define             CLUTTER_UNITS_TO_DEVICE             (x)
#define             CLUTTER_UNITS_TO_FIXED              (x)
#define             CLUTTER_UNITS_TO_FLOAT              (x)
#define             CLUTTER_UNITS_TO_INT                (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)

x :

CLUTTER_UNITS_FROM_FIXED()

#define CLUTTER_UNITS_FROM_FIXED(x)      (x)

x :

CLUTTER_UNITS_FROM_FLOAT()

#define CLUTTER_UNITS_FROM_FLOAT(x)      CLUTTER_FLOAT_TO_FIXED (x)

x :

CLUTTER_UNITS_FROM_INT()

#define CLUTTER_UNITS_FROM_INT(x)        CLUTTER_INT_TO_FIXED (x)

x :

CLUTTER_UNITS_FROM_PANGO_UNIT()

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

x :

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_TO_DEVICE()

#define CLUTTER_UNITS_TO_DEVICE(x)       CLUTTER_UNITS_TO_INT (x)

x :

CLUTTER_UNITS_TO_FIXED()

#define CLUTTER_UNITS_TO_FIXED(x)        (x)

x :

CLUTTER_UNITS_TO_FLOAT()

#define CLUTTER_UNITS_TO_FLOAT(x)        CLUTTER_FIXED_TO_FLOAT (x)

x :

CLUTTER_UNITS_TO_INT()

#define CLUTTER_UNITS_TO_INT(x)          CFX_INT (x)

x :