diff --git a/FL/Fl_Image.H b/FL/Fl_Image.H index 2f33a0792..a991569f5 100644 --- a/FL/Fl_Image.H +++ b/FL/Fl_Image.H @@ -3,7 +3,7 @@ // // Image header file for the Fast Light Tool Kit (FLTK). // -// Copyright 1998-2010 by Bill Spitzak and others. +// Copyright 1998-2011 by Bill Spitzak and others. // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Library General Public @@ -59,33 +59,24 @@ class FL_EXPORT Fl_Image { protected: /** - The first form of the w() method returns the current - image width in pixels.

- -

The second form is a protected method that sets the current - image width. + Sets the current image width in pixels. */ void w(int W) {w_ = W;} /** - The first form of the h() method returns the current - image height in pixels.

- -

The second form is a protected method that sets the current - image height. + Sets the current image height in pixels. */ void h(int H) {h_ = H;} /** - The first form of the d() method returns the current - image depth. The return value will be 0 for bitmaps, 1 for - pixmaps, and 1 to 4 for color images.

- -

The second form is a protected method that sets the current - image depth. + Sets the current image depth. */ void d(int D) {d_ = D;} - /** See int ld() */ + /** + Sets the current line data size in bytes. + */ void ld(int LD) {ld_ = LD;} - /** See const char * const *data() */ + /** + Sets the current array pointer and count of pointers in the array. + */ void data(const char * const *p, int c) {data_ = p; count_ = c;} void draw_empty(int X, int Y); @@ -94,26 +85,23 @@ class FL_EXPORT Fl_Image { public: - /** See void Fl_Image::w(int) */ + /** + Returns the current image width in pixels. + */ int w() const {return w_;} - /** See void Fl_Image::h(int) */ + /** Returns the current image height in pixels. + */ int h() const {return h_;} /** - The first form of the d() method returns the current - image depth. The return value will be 0 for bitmaps, 1 for + Returns the current image depth. + The return value will be 0 for bitmaps, 1 for pixmaps, and 1 to 4 for color images.

- -

The second form is a protected method that sets the current - image depth. */ int d() const {return d_;} /** - The first form of the ld() method returns the current - line data size in bytes. Line data is extra data that is included - after each line of color image data and is normally not present.

- -

The second form is a protected method that sets the current - line data size in bytes. + Returns the current line data size in bytes. + Line data is extra data that is included + after each line of color image data and is normally not present. */ int ld() const {return ld_;} /** @@ -124,12 +112,8 @@ class FL_EXPORT Fl_Image { */ int count() const {return count_;} /** - The first form of the data() method returns a - pointer to the current image data array. Use the - count() method to find the size of the data array.

- -

The second form is a protected method that sets the current - array pointer and count of pointers in the array. + Returns a pointer to the current image data array. + Use the count() method to find the size of the data array. */ const char * const *data() const {return data_;} @@ -162,15 +146,16 @@ class FL_EXPORT Fl_Image { virtual void label(Fl_Widget*w); virtual void label(Fl_Menu_Item*m); /** - The draw() methods draw the image. This form specifies + Draws the image with a bounding box. + This form specifies a bounding box for the image, with the origin (upper-lefthand corner) of the image offset by the cx and cy arguments. */ virtual void draw(int X, int Y, int W, int H, int cx=0, int cy=0); // platform dependent /** - The draw() methods draw the image. This form - specifies the upper-lefthand corner of the image + Draws the image. + This form specifies the upper-lefthand corner of the image. */ void draw(int X, int Y) {draw(X, Y, w(), h(), 0, 0);} // platform dependent virtual void uncache();