Cogl 2.0 Reference Manual | ||||
---|---|---|---|---|
Top | Description |
CoglObject; void * cogl_object_ref (void *object
); void cogl_object_unref (void *object
); void * cogl_object_get_user_data (CoglObject *object
,CoglUserDataKey *key
); void cogl_object_set_user_data (CoglObject *object
,CoglUserDataKey *key
,void *user_data
,CoglUserDataDestroyCallback destroy
);
void * cogl_object_ref (void *object
);
Increases the reference count of handle
by 1
|
a CoglObject |
Returns : |
the object , with its reference count increased |
void cogl_object_unref (void *object
);
Drecreases the reference count of object
by 1; if the reference
count reaches 0, the resources allocated by object
will be freed
|
a CoglObject |
void * cogl_object_get_user_data (CoglObject *object
,CoglUserDataKey *key
);
Finds the user data previously associated with object
using
the given key
. If no user data has been associated with object
for the given key
this function returns NULL.
|
The object with associated private data to query |
|
The address of a CoglUserDataKey which provides a unique value with which to index the private data. |
Returns : |
The user data previously associated
with object using the given key ; or NULL if no associated
data is found. [transfer none]
|
Since 1.4
void cogl_object_set_user_data (CoglObject *object
,CoglUserDataKey *key
,void *user_data
,CoglUserDataDestroyCallback destroy
);
Associates some private user_data
with a given CoglObject. To
later remove the association call cogl_object_set_user_data()
with
the same key
but NULL for the user_data
.
|
The object to associate private data with |
|
The address of a CoglUserDataKey which provides a unique value with which to index the private data. |
|
The data to associate with the given object,
or NULL to remove a previous association. |
|
A CoglUserDataDestroyCallback to call if the object is
destroyed or if the association is removed by later setting
NULL data for the same key. |
Since 1.4