#include <glib.h>
Include dependency graph for imgstore.h:
This graph shows which files directly or indirectly include this file:
Go to the source code of this file.
Typedefs | |
typedef _PurpleStoredImage | PurpleStoredImage |
A reference-counted immutable wrapper around an image's data and its filename. | |
Functions | |
PurpleStoredImage * | purple_imgstore_add (gpointer data, size_t size, const char *filename) |
Add an image to the store. | |
PurpleStoredImage * | purple_imgstore_new_from_file (const char *path) |
Create an image and add it to the store. | |
int | purple_imgstore_add_with_id (gpointer data, size_t size, const char *filename) |
Add an image to the store, allocating an ID. | |
PurpleStoredImage * | purple_imgstore_find_by_id (int id) |
Retrieve an image from the store. | |
gconstpointer | purple_imgstore_get_data (PurpleStoredImage *img) |
Retrieves a pointer to the image's data. | |
size_t | purple_imgstore_get_size (PurpleStoredImage *img) |
Retrieves the length of the image's data. | |
const char * | purple_imgstore_get_filename (const PurpleStoredImage *img) |
Retrieves a pointer to the image's filename. | |
const char * | purple_imgstore_get_extension (PurpleStoredImage *img) |
Looks at the magic numbers of the image data (the first few bytes) and returns an extension corresponding to the image's file type. | |
PurpleStoredImage * | purple_imgstore_ref (PurpleStoredImage *img) |
Increment the reference count. | |
PurpleStoredImage * | purple_imgstore_unref (PurpleStoredImage *img) |
Decrement the reference count. | |
void | purple_imgstore_ref_by_id (int id) |
Increment the reference count using an ID. | |
void | purple_imgstore_unref_by_id (int id) |
Decrement the reference count using an ID. | |
void * | purple_imgstore_get_handle (void) |
Returns the image store subsystem handle. | |
void | purple_imgstore_init (void) |
Initializes the image store subsystem. | |
void | purple_imgstore_uninit (void) |
Uninitializes the image store subsystem. |
Definition in file imgstore.h.
|
Add an image to the store. The caller owns a reference to the image in the store, and must dereference the image with purple_imgstore_unref() for it to be freed. No ID is allocated when using this function. If you need to reference the image by an ID, use purple_imgstore_add_with_id() instead.
|
|
Add an image to the store, allocating an ID. The caller owns a reference to the image in the store, and must dereference the image with purple_imgstore_unref_by_id() or purple_imgstore_unref() for it to be freed.
|
|
Retrieve an image from the store. The caller does not own a reference to the image.
|
|
Retrieves a pointer to the image's data.
|
|
Looks at the magic numbers of the image data (the first few bytes) and returns an extension corresponding to the image's file type.
|
|
Retrieves a pointer to the image's filename.
|
|
Returns the image store subsystem handle.
|
|
Retrieves the length of the image's data.
|
|
Create an image and add it to the store.
|
|
Increment the reference count.
|
|
Increment the reference count using an ID. This is a convience wrapper for purple_imgstore_find_by_id() and purple_imgstore_ref(), so if you have a PurpleStoredImage, it'll be more efficient to call purple_imgstore_ref() directly.
|
|
Decrement the reference count. If the reference count reaches zero, the image will be freed.
|
|
Decrement the reference count using an ID. This is a convience wrapper for purple_imgstore_find_by_id() and purple_imgstore_unref(), so if you have a PurpleStoredImage, it'll be more efficient to call purple_imgstore_unref() directly.
|