Top |
Description
ClutterContent is an interface to implement types responsible for painting the content of a ClutterActor.
Multiple actors can use the same ClutterContent instance, in order to share the resources associated with painting the same content.
ClutterContent is available since Clutter 1.10.
Functions
clutter_content_get_preferred_size ()
gboolean clutter_content_get_preferred_size (ClutterContent *content
,gfloat *width
,gfloat *height
);
Retrieves the natural size of the content
, if any.
The natural size of a ClutterContent is defined as the size the content would have regardless of the allocation of the actor that is painting it, for instance the size of an image data.
Parameters
content |
||
width |
return location for the natural width of the content. |
[out] |
height |
return location for the natural height of the content. |
[out] |
Since: 1.10
clutter_content_invalidate ()
void
clutter_content_invalidate (ClutterContent *content
);
Invalidates a ClutterContent.
This function should be called by ClutterContent implementations when they change the way a the content should be painted regardless of the actor state.
Since: 1.10
Types and Values
ClutterContent
typedef struct _ClutterContent ClutterContent;
The ClutterContent structure is an opaque type whose members cannot be acccessed directly.
Since: 1.10
struct ClutterContentIface
struct ClutterContentIface { gboolean (* get_preferred_size) (ClutterContent *content, gfloat *width, gfloat *height); void (* paint_content) (ClutterContent *content, ClutterActor *actor, ClutterPaintNode *node); void (* attached) (ClutterContent *content, ClutterActor *actor); void (* detached) (ClutterContent *content, ClutterActor *actor); void (* invalidate) (ClutterContent *content); };
The ClutterContentIface structure contains only private data.
Members
virtual function; should be overridden by subclasses of ClutterContent that have a natural size |
||
virtual function; called each time the content needs to paint itself |
||
virtual function; called each time a ClutterContent is attached to a ClutterActor. |
||
virtual function; called each time a ClutterContent is detached from a ClutterActor. |
||
virtual function; called each time a ClutterContent state is changed. |
Since: 1.10
Signal Details
The “attached”
signal
void user_function (ClutterContent *content, ClutterActor *actor, gpointer user_data)
This signal is emitted each time a ClutterContent implementation is assigned to a ClutterActor.
Parameters
content |
the object that emitted the signal |
|
actor |
||
user_data |
user data set when the signal handler was connected. |
Flags: Run First
Since: 1.10
The “detached”
signal
void user_function (ClutterContent *content, ClutterActor *actor, gpointer user_data)
This signal is emitted each time a ClutterContent implementation is removed from a ClutterActor.
Parameters
content |
the object that emitted the signal |
|
actor |
||
user_data |
user data set when the signal handler was connected. |
Flags: Run First
Since: 1.10