Top | ![]() |
![]() |
![]() |
![]() |
struct | ClutterPoint |
struct | ClutterSize |
struct | ClutterRect |
struct | ClutterVertex |
struct | ClutterActorBox |
struct | ClutterGeometry |
struct | ClutterKnot |
ClutterPaintVolume | |
typedef | ClutterMatrix |
#define | CLUTTER_POINT_INIT_ZERO |
#define | CLUTTER_SIZE_INIT_ZERO |
#define | CLUTTER_RECT_INIT_ZERO |
#define | CLUTTER_VERTEX_INIT_ZERO |
#define | CLUTTER_ACTOR_BOX_INIT_ZERO |
GBoxed ├── ClutterActorBox ├── ClutterGeometry ├── ClutterKnot ├── ClutterMatrix ├── ClutterPaintVolume ├── ClutterPoint ├── ClutterRect ├── ClutterSize ╰── ClutterVertex
Clutter defines a set of geometric data structures that are commonly used across the whole API.
#define CLUTTER_POINT_INIT(x,y) { (x), (y) }
A simple macro for initializing a ClutterPoint when declaring it, e.g.:
1 |
ClutterPoint p = CLUTTER_POINT_INIT (100, 100); |
Since: 1.12
const ClutterPoint *
clutter_point_zero (void
);
A point centered at (0, 0).
The returned value can be used as a guard.
a point centered in (0, 0); the returned ClutterPoint is owned by Clutter and it should not be modified or freed.
Since: 1.12
ClutterPoint *
clutter_point_alloc (void
);
Allocates a new ClutterPoint.
[constructor]
the newly allocated ClutterPoint.
Use clutter_point_free()
to free its resources.
[transfer full]
Since: 1.12
ClutterPoint * clutter_point_init (ClutterPoint *point
,float x
,float y
);
Initializes point
with the given coordinates.
Since: 1.12
ClutterPoint *
clutter_point_copy (const ClutterPoint *point
);
Creates a new ClutterPoint with the same coordinates of point
.
a newly allocated ClutterPoint.
Use clutter_point_free()
to free its resources.
[transfer full]
Since: 1.12
void
clutter_point_free (ClutterPoint *point
);
Frees the resources allocated for point
.
Since: 1.12
gboolean clutter_point_equals (const ClutterPoint *a
,const ClutterPoint *b
);
Compares two ClutterPoint for equality.
Since: 1.12
float clutter_point_distance (const ClutterPoint *a
,const ClutterPoint *b
,float *x_distance
,float *y_distance
);
Computes the distance between two ClutterPoint.
a |
||
b |
||
x_distance |
return location for the horizontal distance between the points. |
[out][allow-none] |
y_distance |
return location for the vertical distance between the points. |
[out][allow-none] |
Since: 1.12
#define CLUTTER_SIZE_INIT(width,height) { (width), (height) }
A simple macro for initializing a ClutterSize when declaring it, e.g.:
1 |
ClutterSize s = CLUTTER_SIZE_INIT (200, 200); |
Since: 1.12
ClutterSize *
clutter_size_alloc (void
);
Allocates a new ClutterSize.
[constructor]
the newly allocated ClutterSize.
Use clutter_size_free()
to free its resources.
[transfer full]
Since: 1.12
ClutterSize * clutter_size_init (ClutterSize *size
,float width
,float height
);
Initializes a ClutterSize with the given dimensions.
Since: 1.12
ClutterSize *
clutter_size_copy (const ClutterSize *size
);
Creates a new ClutterSize and duplicates size
.
the newly allocated ClutterSize.
Use clutter_size_free()
to free its resources.
[transfer full]
Since: 1.12
void
clutter_size_free (ClutterSize *size
);
Frees the resources allocated for size
.
Since: 1.12
gboolean clutter_size_equals (const ClutterSize *a
,const ClutterSize *b
);
Compares two ClutterSize for equality.
Since: 1.12
#define CLUTTER_RECT_INIT(x,y,width,height) { { (x), (y) }, { (width), (height) } }
A simple macro for initializing a ClutterRect when declaring it, e.g.:
1 |
ClutterRect r = CLUTTER_RECT_INIT (100, 100, 200, 200); |
Since: 1.12
const ClutterRect *
clutter_rect_zero (void
);
A ClutterRect with ClutterRect.origin set at (0, 0) and a size of 0.
The returned value can be used as a guard.
a rectangle with origin in (0, 0) and a size of 0. The returned ClutterRect is owned by Clutter and it should not be modified or freed.
Since: 1.12
ClutterRect *
clutter_rect_alloc (void
);
Creates a new, empty ClutterRect.
You can use clutter_rect_init()
to initialize the returned rectangle,
for instance:
1 |
rect = clutter_rect_init (clutter_rect_alloc (), x, y, width, height); |
[constructor]
the newly allocated ClutterRect.
Use clutter_rect_free()
to free its resources.
[transfer full]
Since: 1.12
ClutterRect * clutter_rect_init (ClutterRect *rect
,float x
,float y
,float width
,float height
);
Initializes a ClutterRect with the given origin and size.
rect |
||
x |
X coordinate of the origin |
|
y |
Y coordinate of the origin |
|
width |
width of the rectangle |
|
height |
height of the rectangle |
Since: 1.12
ClutterRect *
clutter_rect_copy (const ClutterRect *rect
);
Copies rect
into a new ClutterRect instance.
the newly allocate copy of rect
.
Use clutter_rect_free()
to free the associated resources.
[transfer full]
Since: 1.12
void
clutter_rect_free (ClutterRect *rect
);
Frees the resources allocated by rect
.
Since: 1.12
gboolean clutter_rect_equals (ClutterRect *a
,ClutterRect *b
);
Checks whether a
and b
are equals.
This function will normalize both a
and b
before comparing
their origin and size.
Since: 1.12
ClutterRect *
clutter_rect_normalize (ClutterRect *rect
);
Normalizes a ClutterRect.
A ClutterRect is defined by the area covered by its size; this means that a ClutterRect with ClutterRect.origin in [ 0, 0 ] and a ClutterRect.size of [ 10, 10 ] is equivalent to a ClutterRect with ClutterRect.origin in [ 10, 10 ] and a ClutterRect.size of [ -10, -10 ].
This function is useful to ensure that a rectangle has positive width
and height; it will modify the passed rect
and normalize its size.
Since: 1.12
void clutter_rect_get_center (ClutterRect *rect
,ClutterPoint *center
);
Retrieves the center of rect
, after normalizing the rectangle,
and updates center
with the correct coordinates.
Since: 1.12
gboolean clutter_rect_contains_point (ClutterRect *rect
,ClutterPoint *point
);
Checks whether point
is contained by rect
, after normalizing the
rectangle.
Since: 1.12
gboolean clutter_rect_contains_rect (ClutterRect *a
,ClutterRect *b
);
Checks whether a
contains b
.
The first rectangle contains the second if the union of the two ClutterRect is equal to the first rectangle.
Since: 1.12
void clutter_rect_union (ClutterRect *a
,ClutterRect *b
,ClutterRect *res
);
Computes the smallest possible rectangle capable of fully containing
both a
and b
, and places it into res
.
This function will normalize both a
and b
prior to computing their
union.
Since: 1.12
gboolean clutter_rect_intersection (ClutterRect *a
,ClutterRect *b
,ClutterRect *res
);
Computes the intersection of a
and b
, and places it in res
, if res
is not NULL
.
This function will normalize both a
and b
prior to computing their
intersection.
This function can be used to simply check if the intersection of a
and b
is not empty, by using NULL
for res
.
Since: 1.12
void clutter_rect_offset (ClutterRect *rect
,float d_x
,float d_y
);
Offsets the origin of rect
by the given values, after normalizing
the rectangle.
Since: 1.12
void clutter_rect_inset (ClutterRect *rect
,float d_x
,float d_y
);
Normalizes the rect
and offsets its origin by the d_x
and d_y
values;
the size is adjusted by (2 * d_x
, 2 * d_y
).
If d_x
and d_y
are positive the size of the rectangle is decreased; if
the values are negative, the size of the rectangle is increased.
If the resulting rectangle has a negative width or height, the size is set to 0.
rect |
||
d_x |
an horizontal value; a positive |
|
d_y |
a vertical value; a positive |
Since: 1.12
void
clutter_rect_clamp_to_pixel (ClutterRect *rect
);
Rounds the origin of rect
downwards to the nearest integer, and rounds
the size of rect
upwards to the nearest integer, so that rect
is
updated to the smallest rectangle capable of fully containing the
original, fractional rectangle.
Since: 1.12
float
clutter_rect_get_x (ClutterRect *rect
);
Retrieves the X coordinate of the origin of rect
.
Since: 1.12
float
clutter_rect_get_y (ClutterRect *rect
);
Retrieves the Y coordinate of the origin of rect
.
Since: 1.12
float
clutter_rect_get_width (ClutterRect *rect
);
Retrieves the width of rect
.
Since: 1.12
float
clutter_rect_get_height (ClutterRect *rect
);
Retrieves the height of rect
.
Since: 1.12
#define CLUTTER_VERTEX_INIT(x,y,z) { (x), (y), (z) }
A simple macro for initializing a ClutterVertex when declaring it, e.g.:
1 |
ClutterVertex v = CLUTTER_VERTEX_INIT (x, y, z); |
x |
the X coordinate of the vertex |
|
y |
the Y coordinate of the vertex |
|
z |
the Z coordinate of the vertex |
Since: 1.10
ClutterVertex * clutter_vertex_new (gfloat x
,gfloat y
,gfloat z
);
Creates a new ClutterVertex for the point in 3D space
identified by the 3 coordinates x
, y
, z
.
This function is the logical equivalent of:
1 |
clutter_vertex_init (clutter_vertex_alloc (), x, y, z); |
the newly allocated ClutterVertex.
Use clutter_vertex_free()
to free the resources.
[transfer full]
Since: 1.0
ClutterVertex *
clutter_vertex_alloc (void
);
Allocates a new, empty ClutterVertex.
[constructor]
the newly allocated ClutterVertex.
Use clutter_vertex_free()
to free its resources.
[transfer full]
Since: 1.12
ClutterVertex * clutter_vertex_init (ClutterVertex *vertex
,gfloat x
,gfloat y
,gfloat z
);
Initializes vertex
with the given coordinates.
Since: 1.10
ClutterVertex *
clutter_vertex_copy (const ClutterVertex *vertex
);
Copies vertex
a newly allocated copy of ClutterVertex.
Use clutter_vertex_free()
to free the allocated resources.
[transfer full]
Since: 1.0
void
clutter_vertex_free (ClutterVertex *vertex
);
Frees a ClutterVertex allocated using clutter_vertex_alloc()
or
clutter_vertex_copy()
.
Since: 1.0
gboolean clutter_vertex_equal (const ClutterVertex *vertex_a
,const ClutterVertex *vertex_b
);
Compares vertex_a
and vertex_b
for equality
Since: 1.0
#define CLUTTER_ACTOR_BOX_INIT(x_1,y_1,x_2,y_2) { (x_1), (y_1), (x_2), (y_2) }
A simple macro for initializing a ClutterActorBox when declaring it, e.g.:
1 |
ClutterActorBox box = CLUTTER_ACTOR_BOX_INIT (0, 0, 400, 600); |
x_1 |
the X coordinate of the top left corner |
|
y_1 |
the Y coordinate of the top left corner |
|
x_2 |
the X coordinate of the bottom right corner |
|
y_2 |
the Y coordinate of the bottom right corner |
Since: 1.10
ClutterActorBox * clutter_actor_box_new (gfloat x_1
,gfloat y_1
,gfloat x_2
,gfloat y_2
);
Allocates a new ClutterActorBox using the passed coordinates for the top left and bottom right points.
This function is the logical equivalent of:
1 2 3 |
clutter_actor_box_init (clutter_actor_box_alloc (), x_1, y_1, x_2, y_2); |
x_1 |
X coordinate of the top left point |
|
y_1 |
Y coordinate of the top left point |
|
x_2 |
X coordinate of the bottom right point |
|
y_2 |
Y coordinate of the bottom right point |
the newly allocated ClutterActorBox.
Use clutter_actor_box_free()
to free the resources.
[transfer full]
Since: 1.0
ClutterActorBox *
clutter_actor_box_alloc (void
);
Allocates a new ClutterActorBox.
the newly allocated ClutterActorBox.
Use clutter_actor_box_free()
to free its resources.
[transfer full]
Since: 1.12
ClutterActorBox * clutter_actor_box_init (ClutterActorBox *box
,gfloat x_1
,gfloat y_1
,gfloat x_2
,gfloat y_2
);
Initializes box
with the given coordinates.
box |
||
x_1 |
X coordinate of the top left point |
|
y_1 |
Y coordinate of the top left point |
|
x_2 |
X coordinate of the bottom right point |
|
y_2 |
Y coordinate of the bottom right point |
Since: 1.10
void clutter_actor_box_init_rect (ClutterActorBox *box
,gfloat x
,gfloat y
,gfloat width
,gfloat height
);
Initializes box
with the given origin and size.
box |
||
x |
X coordinate of the origin |
|
y |
Y coordinate of the origin |
|
width |
width of the box |
|
height |
height of the box |
Since: 1.10
ClutterActorBox *
clutter_actor_box_copy (const ClutterActorBox *box
);
Copies box
a newly allocated copy of ClutterActorBox. Use
clutter_actor_box_free()
to free the allocated resources
Since: 1.0
void
clutter_actor_box_free (ClutterActorBox *box
);
Frees a ClutterActorBox allocated using clutter_actor_box_new()
or clutter_actor_box_copy()
Since: 1.0
gboolean clutter_actor_box_equal (const ClutterActorBox *box_a
,const ClutterActorBox *box_b
);
Checks box_a
and box_b
for equality
Since: 1.0
gfloat
clutter_actor_box_get_x (const ClutterActorBox *box
);
Retrieves the X coordinate of the origin of box
Since: 1.0
gfloat
clutter_actor_box_get_y (const ClutterActorBox *box
);
Retrieves the Y coordinate of the origin of box
Since: 1.0
gfloat
clutter_actor_box_get_width (const ClutterActorBox *box
);
Retrieves the width of the box
Since: 1.0
gfloat
clutter_actor_box_get_height (const ClutterActorBox *box
);
Retrieves the height of the box
Since: 1.0
void clutter_actor_box_set_origin (ClutterActorBox *box
,gfloat x
,gfloat y
);
Changes the origin of box
, maintaining the size of the ClutterActorBox.
Since: 1.6
void clutter_actor_box_get_origin (const ClutterActorBox *box
,gfloat *x
,gfloat *y
);
Retrieves the origin of box
Since: 1.0
void clutter_actor_box_set_size (ClutterActorBox *box
,gfloat width
,gfloat height
);
Sets the size of box
, maintaining the origin of the ClutterActorBox.
Since: 1.6
void clutter_actor_box_get_size (const ClutterActorBox *box
,gfloat *width
,gfloat *height
);
Retrieves the size of box
Since: 1.0
gfloat
clutter_actor_box_get_area (const ClutterActorBox *box
);
Retrieves the area of box
Since: 1.0
gboolean clutter_actor_box_contains (const ClutterActorBox *box
,gfloat x
,gfloat y
);
Checks whether a point with x
, y
coordinates is contained
withing box
Since: 1.0
void clutter_actor_box_from_vertices (ClutterActorBox *box
,const ClutterVertex verts[]
);
Calculates the bounding box represented by the four vertices; for details
of the vertex array see clutter_actor_get_abs_allocation_vertices()
.
Since: 1.0
void
clutter_actor_box_clamp_to_pixel (ClutterActorBox *box
);
Clamps the components of box
to the nearest integer
Since: 1.2
void clutter_actor_box_interpolate (const ClutterActorBox *initial
,const ClutterActorBox *final
,gdouble progress
,ClutterActorBox *result
);
Interpolates between initial
and final
ClutterActorBoxes
using progress
initial |
the initial ClutterActorBox |
|
final |
the final ClutterActorBox |
|
progress |
the interpolation progress |
|
result |
return location for the interpolation. |
[out] |
Since: 1.2
void clutter_actor_box_union (const ClutterActorBox *a
,const ClutterActorBox *b
,ClutterActorBox *result
);
Unions the two boxes a
and b
and stores the result in result
.
a |
the first ClutterActorBox. |
[in] |
b |
the second ClutterActorBox. |
[in] |
result |
the ClutterActorBox representing a union
of |
[out] |
Since: 1.4
ClutterPaintVolume *
clutter_paint_volume_copy (const ClutterPaintVolume *pv
);
Copies pv
into a new ClutterPaintVolume
Since: 1.6
void
clutter_paint_volume_free (ClutterPaintVolume *pv
);
Frees the resources allocated by pv
Since: 1.6
void clutter_paint_volume_set_origin (ClutterPaintVolume *pv
,const ClutterVertex *origin
);
Sets the origin of the paint volume.
The origin is defined as the X, Y and Z coordinates of the top-left corner of an actor's paint volume, in actor coordinates.
The default is origin is assumed at: (0, 0, 0)
Since: 1.6
void clutter_paint_volume_get_origin (const ClutterPaintVolume *pv
,ClutterVertex *vertex
);
Retrieves the origin of the ClutterPaintVolume.
Since: 1.6
void clutter_paint_volume_set_width (ClutterPaintVolume *pv
,gfloat width
);
Sets the width of the paint volume. The width is measured along
the x axis in the actor coordinates that pv
is associated with.
Since: 1.6
gfloat
clutter_paint_volume_get_width (const ClutterPaintVolume *pv
);
Retrieves the width of the volume's, axis aligned, bounding box.
In other words; this takes into account what actor's coordinate
space pv
belongs too and conceptually fits an axis aligned box
around the volume. It returns the size of that bounding box as
measured along the x-axis.
If, for example, clutter_actor_get_transformed_paint_volume()
is used to transform a 2D child actor that is 100px wide, 100px
high and 0px deep into container coordinates then the width might
not simply be 100px if the child actor has a 3D rotation applied to
it.
Remember: if clutter_actor_get_transformed_paint_volume()
is
used then a transformed child volume will be defined relative to the
ancestor container actor and so a 2D child actor can have a 3D
bounding volume.
There are no accuracy guarantees for the reported width, except that it must always be greater than, or equal to, the actor's width. This is because actors may report simple, loose fitting paint volumes for efficiency.
Since: 1.6
void clutter_paint_volume_set_height (ClutterPaintVolume *pv
,gfloat height
);
Sets the height of the paint volume. The height is measured along
the y axis in the actor coordinates that pv
is associated with.
Since: 1.6
gfloat
clutter_paint_volume_get_height (const ClutterPaintVolume *pv
);
Retrieves the height of the volume's, axis aligned, bounding box.
In other words; this takes into account what actor's coordinate
space pv
belongs too and conceptually fits an axis aligned box
around the volume. It returns the size of that bounding box as
measured along the y-axis.
If, for example, clutter_actor_get_transformed_paint_volume()
is used to transform a 2D child actor that is 100px wide, 100px
high and 0px deep into container coordinates then the height might
not simply be 100px if the child actor has a 3D rotation applied to
it.
Remember: if clutter_actor_get_transformed_paint_volume()
is
used then a transformed child volume will be defined relative to the
ancestor container actor and so a 2D child actor
can have a 3D bounding volume.
There are no accuracy guarantees for the reported height, except that it must always be greater than, or equal to, the actor's height. This is because actors may report simple, loose fitting paint volumes for efficiency.
Since: 1.6
void clutter_paint_volume_set_depth (ClutterPaintVolume *pv
,gfloat depth
);
Sets the depth of the paint volume. The depth is measured along
the z axis in the actor coordinates that pv
is associated with.
Since: 1.6
gfloat
clutter_paint_volume_get_depth (const ClutterPaintVolume *pv
);
Retrieves the depth of the volume's, axis aligned, bounding box.
In other words; this takes into account what actor's coordinate
space pv
belongs too and conceptually fits an axis aligned box
around the volume. It returns the size of that bounding box as
measured along the z-axis.
If, for example, clutter_actor_get_transformed_paint_volume()
is used to transform a 2D child actor that is 100px wide, 100px
high and 0px deep into container coordinates then the depth might
not simply be 0px if the child actor has a 3D rotation applied to
it.
Remember: if clutter_actor_get_transformed_paint_volume()
is
used then the transformed volume will be defined relative to the
container actor and in container coordinates a 2D child actor
can have a 3D bounding volume.
There are no accuracy guarantees for the reported depth, except that it must always be greater than, or equal to, the actor's depth. This is because actors may report simple, loose fitting paint volumes for efficiency.
Since: 1.6
gboolean clutter_paint_volume_set_from_allocation (ClutterPaintVolume *pv
,ClutterActor *actor
);
Sets the ClutterPaintVolume from the allocation of actor
.
This function should be used when overriding the
ClutterActorClass.get_paint_volume()
by ClutterActor sub-classes
that do not paint outside their allocation.
A typical example is:
1 2 3 4 5 6 |
static gboolean my_actor_get_paint_volume (ClutterActor *self, ClutterPaintVolume *volume) { return clutter_paint_volume_set_from_allocation (volume, self); } |
Since: 1.6
void clutter_paint_volume_union (ClutterPaintVolume *pv
,const ClutterPaintVolume *another_pv
);
Updates the geometry of pv
to encompass pv
and another_pv
.
There are no guarantees about how precisely the two volumes will be unioned.
pv |
The first ClutterPaintVolume and destination for resulting union |
|
another_pv |
A second ClutterPaintVolume to union with |
Since: 1.6
void clutter_paint_volume_union_box (ClutterPaintVolume *pv
,const ClutterActorBox *box
);
Unions the 2D region represented by box
to a ClutterPaintVolume.
This function is similar to clutter_paint_volume_union()
, but it is
specific for 2D regions.
Since: 1.10
ClutterMatrix *
clutter_matrix_alloc (void
);
Allocates enough memory to hold a ClutterMatrix.
Since: 1.12
void
clutter_matrix_free (ClutterMatrix *matrix
);
Frees the memory allocated by clutter_matrix_alloc()
.
Since: 1.12
ClutterMatrix * clutter_matrix_init_from_array (ClutterMatrix *matrix
,const float values[16]
);
Initializes matrix
with the contents of a C array of floating point
values.
matrix |
||
values |
a C array of 16 floating point values, representing a 4x4 matrix, with column-major order. |
[array fixed-size=16] |
Since: 1.12
ClutterMatrix * clutter_matrix_init_from_matrix (ClutterMatrix *a
,const ClutterMatrix *b
);
Initializes the ClutterMatrix a
with the contents of the
ClutterMatrix b
.
Since: 1.12
ClutterMatrix *
clutter_matrix_init_identity (ClutterMatrix *matrix
);
Initializes matrix
with the identity matrix, i.e.:
1 2 3 4 |
.xx = 1.0, .xy = 0.0, .xz = 0.0, .xw = 0.0 .yx = 0.0, .yy = 1.0, .yz = 0.0, .yw = 0.0 .zx = 0.0, .zy = 0.0, .zz = 1.0, .zw = 0.0 .wx = 0.0, .wy = 0.0, .wz = 0.0, .ww = 1.0 |
Since: 1.12
ClutterKnot *
clutter_knot_copy (const ClutterKnot *knot
);
Makes an allocated copy of a knot.
Since: 0.2
void
clutter_knot_free (ClutterKnot *knot
);
Frees the memory of an allocated knot.
Since: 0.2
gboolean clutter_knot_equal (const ClutterKnot *knot_a
,const ClutterKnot *knot_b
);
Compares to knot and checks if the point to the same location.
Since: 0.2
void clutter_geometry_union (const ClutterGeometry *geometry_a
,const ClutterGeometry *geometry_b
,ClutterGeometry *result
);
clutter_geometry_union
has been deprecated since version 1.16 and should not be used in newly-written code.
Use ClutterRect and clutter_rect_union()
Find the union of two rectangles represented as ClutterGeometry.
Since: 1.4
gboolean clutter_geometry_intersects (const ClutterGeometry *geometry0
,const ClutterGeometry *geometry1
);
clutter_geometry_intersects
has been deprecated since version 1.16 and should not be used in newly-written code.
Determines if geometry0
and geometry1 intersect returning TRUE
if
they do else FALSE
.
Since: 1.4
struct ClutterSize { float width; float height; };
A size, in 2D space.
Since: 1.12
struct ClutterRect { ClutterPoint origin; ClutterSize size; };
The location and size of a rectangle.
The width and height of a ClutterRect can be negative; Clutter considers a rectangle with an origin of [ 0.0, 0.0 ] and a size of [ 10.0, 10.0 ] to be equivalent to a rectangle with origin of [ 10.0, 10.0 ] and size of [ -10.0, -10.0 ].
Application code can normalize rectangles using clutter_rect_normalize()
:
this function will ensure that the width and height of a ClutterRect are
positive values. All functions taking a ClutterRect as an argument will
implicitly normalize it before computing eventual results. For this reason
it is safer to access the contents of a ClutterRect by using the provided
API at all times, instead of directly accessing the structure members.
ClutterPoint |
the origin of the rectangle |
|
ClutterSize |
the size of the rectangle |
Since: 1.12
struct ClutterVertex { gfloat x; gfloat y; gfloat z; };
A point in 3D space, expressed in pixels
Since: 0.4
struct ClutterActorBox { gfloat x1; gfloat y1; gfloat x2; gfloat y2; };
Bounding box of an actor. The coordinates of the top left and right bottom corners of an actor. The coordinates of the two points are expressed in pixels with sub-pixel precision
struct ClutterGeometry { gint x; gint y; guint width; guint height; };
ClutterGeometry
has been deprecated since version 1.16 and should not be used in newly-written code.
The rectangle containing an actor's bounding box, measured in pixels.
You should not use ClutterGeometry, or operate on its fields directly; you should use cairo_rectangle_int_t or ClutterRect if you need a rectangle type, depending on the precision required.
typedef struct _ClutterPaintVolume ClutterPaintVolume;
ClutterPaintVolume is an opaque structure whose members cannot be directly accessed.
A ClutterPaintVolume represents an a bounding volume whose internal representation isn't defined but can be set and queried in terms of an axis aligned bounding box.
A ClutterPaintVolume for a ClutterActor is defined to be relative from the current actor modelview matrix.
Other internal representation and methods for describing the bounding volume may be added in the future.
Since: 1.4
typedef struct _CoglMatrix ClutterMatrix;
A type representing a 4x4 matrix.
It is identicaly to CoglMatrix.
Since: 1.12
#define CLUTTER_POINT_INIT_ZERO CLUTTER_POINT_INIT (0.f, 0.f)
A simple macro for initializing a ClutterPoint to (0, 0) when declaring it.
Since: 1.12
#define CLUTTER_SIZE_INIT_ZERO CLUTTER_SIZE_INIT (0.f, 0.f)
A simple macro for initializing a ClutterSize to (0, 0) when declaring it.
Since: 1.12
#define CLUTTER_RECT_INIT_ZERO CLUTTER_RECT_INIT (0.f, 0.f, 0.f, 0.f)
A simple macro for initializing a ClutterRect to (0, 0, 0, 0) when declaring it.
Since: 1.12
#define CLUTTER_VERTEX_INIT_ZERO CLUTTER_VERTEX_INIT (0.f, 0.f, 0.f)
A simple macro for initializing a ClutterVertex to (0, 0, 0).
Since: 1.12
#define CLUTTER_ACTOR_BOX_INIT_ZERO CLUTTER_ACTOR_BOX_INIT (0.f, 0.f, 0.f, 0.f)
A simple macro for initializing a ClutterActorBox to 0 when declaring it, e.g.:
1 |
ClutterActorBox box = CLUTTER_ACTOR_BOX_INIT_ZERO; |
Since: 1.12