Main Page | Modules | Alphabetical List | Data Structures | File List | Data Fields | Globals | Related Pages

imgstore.h File Reference

IM Image Store API. More...

Go to the source code of this file.

Data Structures

struct  GaimStoredImage
 Stored image. More...


Functions

int gaim_imgstore_add (const void *data, size_t size, const char *filename)
 Add an image to the store.

GaimStoredImagegaim_imgstore_get (int id)
 Retrieve an image from the store.

void gaim_imgstore_ref (int id)
 Increment the reference count for an image in the store.

void gaim_imgstore_unref (int id)
 Decrement the reference count for an image in the store.


Detailed Description

IM Image Store API.

gaim

Gaim is the legal property of its developers, whose names are too numerous to list here. Please refer to the COPYRIGHT file distributed with this source distribution.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


Function Documentation

int gaim_imgstore_add const void *  data,
size_t  size,
const char *  filename
 

Add an image to the store.

The caller owns a reference to the image in the store, and must dereference the image with gaim_imgstore_unref for it to be freed.

Parameters:
data Pointer to the image data.
size Image data's size.
filename Filename associated with image.
Returns:
ID for the image.

GaimStoredImage* gaim_imgstore_get int  id  ) 
 

Retrieve an image from the store.

The caller does not own a reference to the image.

Parameters:
id The ID for the image.
Returns:
A pointer to the requested image, or NULL if it was not found.

void gaim_imgstore_ref int  id  ) 
 

Increment the reference count for an image in the store.

The image will be removed from the store when the reference count is zero.

Parameters:
id The ID for the image.

void gaim_imgstore_unref int  id  ) 
 

Decrement the reference count for an image in the store.

The image will be removed from the store when the reference count is zero.

Parameters:
id The ID for the image.


Generated on Tue Aug 3 17:36:40 2004 for gaim by doxygen 1.3.4