|  |  |  | Cogl Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
CoglBitmap; CoglBitmap * cogl_bitmap_new_from_file (const char *filename,GError **error); gboolean cogl_bitmap_get_size_from_file (const char *filename,int *width,int *height); gboolean cogl_is_bitmap (CoglHandle handle); enum CoglBitmapError; #define COGL_BITMAP_ERROR
Cogl allows loading image data into memory as CoglBitmaps without loading them immediately into GPU textures.
CoglBitmap is available since Cogl 1.0
CoglBitmap * cogl_bitmap_new_from_file (const char *filename,GError **error);
Loads an image file from disk. This function can be safely called from within a thread.
| 
 | the file to load. | 
| 
 | a GError or NULL. | 
| Returns : | a CoglBitmap to the new loaded image data, or NULLif loading the image failed. | 
Since 1.0
gboolean cogl_bitmap_get_size_from_file (const char *filename,int *width,int *height);
Parses an image file enough to extract the width and height of the bitmap.
| 
 | the file to check | 
| 
 | return location for the bitmap width, or NULL. [out] | 
| 
 | return location for the bitmap height, or NULL. [out] | 
| Returns : | TRUEif the image was successfully parsed | 
Since 1.0
gboolean            cogl_is_bitmap                      (CoglHandle handle);
Checks whether handle is a CoglHandle for a bitmap
| 
 | a CoglHandle for a bitmap | 
| Returns : | TRUEif the passed handle represents a bitmap,
andFALSEotherwise | 
Since 1.0
typedef enum {
  COGL_BITMAP_ERROR_FAILED,
  COGL_BITMAP_ERROR_UNKNOWN_TYPE,
  COGL_BITMAP_ERROR_CORRUPT_IMAGE
} CoglBitmapError;
Error codes that can be thrown when performing bitmap
operations. Note that gdk_pixbuf_new_from_file() can also throw
errors directly from the underlying image loading library. For
example, if GdkPixbuf is used then errors GdkPixbufErrors
will be used directly.
| Generic failure code, something went wrong. | |
| Unknown image type. | |
| An image file was broken somehow. | 
Since 1.4