FLTK
Fl_GIF_Image Class Reference

The Fl_GIF_Image class supports loading, caching, and drawing of Compuserve GIFSM images. More...

#include <Fl_GIF_Image.H>

Inheritance diagram for Fl_GIF_Image:
Fl_Pixmap Fl_Image

Public Member Functions

 Fl_GIF_Image (const char *filename)
 The constructor loads the named GIF image. More...
 
 Fl_GIF_Image (const char *imagename, const unsigned char *data)
 The constructor loads a GIF image from memory. More...
 
- Public Member Functions inherited from Fl_Pixmap
virtual void color_average (Fl_Color c, float i)
 The color_average() method averages the colors in the image with the FLTK color value c. More...
 
virtual Fl_Imagecopy (int W, int H)
 Creates a resized copy of the specified image. More...
 
Fl_Imagecopy ()
 
virtual void desaturate ()
 The desaturate() method converts an image to grayscale. More...
 
virtual void draw (int X, int Y, int W, int H, int cx=0, int cy=0)
 Draws the image to the current drawing surface with a bounding box. More...
 
void draw (int X, int Y)
 
 Fl_Pixmap (char *const *D)
 The constructors create a new pixmap from the specified XPM data. More...
 
 Fl_Pixmap (uchar *const *D)
 The constructors create a new pixmap from the specified XPM data. More...
 
 Fl_Pixmap (const char *const *D)
 The constructors create a new pixmap from the specified XPM data. More...
 
 Fl_Pixmap (const uchar *const *D)
 The constructors create a new pixmap from the specified XPM data. More...
 
virtual void label (Fl_Widget *w)
 The label() methods are an obsolete way to set the image attribute of a widget or menu item. More...
 
virtual void label (Fl_Menu_Item *m)
 The label() methods are an obsolete way to set the image attribute of a widget or menu item. More...
 
virtual void uncache ()
 If the image has been cached for display, delete the cache data. More...
 
virtual ~Fl_Pixmap ()
 The destructor frees all memory and server resources that are used by the pixmap.
 
- Public Member Functions inherited from Fl_Image
virtual class Fl_Shared_Imageas_shared_image ()
 Returns whether an image is an Fl_Shared_Image or not. More...
 
Fl_Imagecopy ()
 Creates a copy of the specified image. More...
 
int count () const
 The count() method returns the number of data values associated with the image. More...
 
int d () const
 Returns the image depth. More...
 
const char *const * data () const
 Returns a pointer to the current image data array. More...
 
int data_h () const
 Returns the height of the image data.
 
int data_w () const
 Returns the width of the image data.
 
void draw (int X, int Y)
 Draws the image to the current drawing surface. More...
 
int fail ()
 Returns a value that is not 0 if there is currently no image available. More...
 
 Fl_Image (int W, int H, int D)
 The constructor creates an empty image with the specified width, height, and depth. More...
 
int h () const
 Returns the current image drawing height in FLTK units. More...
 
void inactive ()
 The inactive() method calls color_average(FL_BACKGROUND_COLOR, 0.33f) to produce an image that appears grayed out. More...
 
int ld () const
 Returns the current line data size in bytes. More...
 
virtual void release ()
 Releases an Fl_Image - the same as 'delete this'. More...
 
virtual void scale (int width, int height, int proportional=1, int can_expand=0)
 Sets the drawing size of the image. More...
 
int w () const
 Returns the current image drawing width in FLTK units. More...
 
virtual ~Fl_Image ()
 The destructor is a virtual method that frees all memory used by the image.
 

Protected Member Functions

void load_gif_ (class Fl_Image_Reader &rdr)
 
- Protected Member Functions inherited from Fl_Pixmap
void measure ()
 
- Protected Member Functions inherited from Fl_Image
void d (int D)
 Sets the current image depth.
 
void data (const char *const *p, int c)
 Sets the current array pointer and count of pointers in the array.
 
void draw_empty (int X, int Y)
 The protected method draw_empty() draws a box with an X in it. More...
 
int draw_scaled (int X, int Y, int W, int H)
 Draw the image to the current drawing surface rescaled to a given width and height. More...
 
void h (int H)
 Sets the height of the image data. More...
 
void ld (int LD)
 Sets the current line data size in bytes. More...
 
void w (int W)
 Sets the width of the image data. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from Fl_Image
static Fl_Labeltype define_FL_IMAGE_LABEL ()
 
static void RGB_scaling (Fl_RGB_Scaling)
 Sets the RGB image scaling method used for copy(int, int). More...
 
static Fl_RGB_Scaling RGB_scaling ()
 Returns the currently used RGB image scaling method. More...
 
static void scaling_algorithm (Fl_RGB_Scaling algorithm)
 Sets what algorithm is used when resizing a source image to draw it. More...
 
static Fl_RGB_Scaling scaling_algorithm ()
 Gets what algorithm is used when resizing a source image to draw it. More...
 
- Public Attributes inherited from Fl_Pixmap
int alloc_data
 
- Static Public Attributes inherited from Fl_Image
static const int ERR_FILE_ACCESS = -2
 
static const int ERR_FORMAT = -3
 
static const int ERR_NO_IMAGE = -1
 
static bool register_images_done = false
 True after fl_register_images() was called, false before.
 
- Static Protected Member Functions inherited from Fl_Image
static void labeltype (const Fl_Label *lo, int lx, int ly, int lw, int lh, Fl_Align la)
 
static void measure (const Fl_Label *lo, int &lw, int &lh)
 

Detailed Description

The Fl_GIF_Image class supports loading, caching, and drawing of Compuserve GIFSM images.

The class loads the first image and supports transparency.

Constructor & Destructor Documentation

◆ Fl_GIF_Image() [1/2]

Fl_GIF_Image::Fl_GIF_Image ( const char *  filename)

The constructor loads the named GIF image.

IF a GIF is animated, Fl_GIF_Image will only read and display the first frame of the animation.

The destructor frees all memory and server resources that are used by the image.

Use Fl_Image::fail() to check if Fl_GIF_Image failed to load. fail() returns ERR_FILE_ACCESS if the file could not be opened or read, ERR_FORMAT if the GIF format could not be decoded, and ERR_NO_IMAGE if the image could not be loaded for another reason.

Parameters
[in]filenamea full path and name pointing to a valid GIF file.
See also
Fl_GIF_Image::Fl_GIF_Image(const char *imagename, const unsigned char *data)

◆ Fl_GIF_Image() [2/2]

Fl_GIF_Image::Fl_GIF_Image ( const char *  imagename,
const unsigned char *  data 
)

The constructor loads a GIF image from memory.

Construct an image from a block of memory inside the application. Fluid offers "binary Data" chunks as a great way to add image data into the C++ source code. imagename can be NULL. If a name is given, the image is added to the list of shared images and will be available by that name.

IF a GIF is animated, Fl_GIF_Image will only read and display the first frame of the animation.

Use Fl_Image::fail() to check if Fl_GIF_Image failed to load. fail() returns ERR_FILE_ACCESS if the file could not be opened or read, ERR_FORMAT if the GIF format could not be decoded, and ERR_NO_IMAGE if the image could not be loaded for another reason.

Parameters
[in]imagenameA name given to this image or NULL
[in]dataPointer to the start of the GIF image in memory. This code will not check for buffer overruns.
See also
Fl_GIF_Image::Fl_GIF_Image(const char *filename)
Fl_Shared_Image

The documentation for this class was generated from the following files: