| 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.
|
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