diff options
author | Aaron M. Ucko <ucko@debian.org> | 2015-07-07 01:32:55 -0400 |
---|---|---|
committer | Aaron M. Ucko <ucko@debian.org> | 2015-07-07 01:40:11 -0400 |
commit | 574b357ee8bd5c44a1511a5a29f60b2d659b263f (patch) | |
tree | e7f69d70ef4c9414325db8cca0b4e7b56ee7c81a /documentation/src/drawing.dox | |
parent | 51a046516db7c8e194cc232e4fb18ecb3ffa65dc (diff) | |
parent | a3d0ced57399c9fd8075377b7310d545f968e524 (diff) |
Merge tag 'upstream/1.3.3' (Closes: #791346.)
Upstream version 1.3.3
Diffstat (limited to 'documentation/src/drawing.dox')
-rw-r--r-- | documentation/src/drawing.dox | 22 |
1 files changed, 9 insertions, 13 deletions
diff --git a/documentation/src/drawing.dox b/documentation/src/drawing.dox index 285a61e..f82dc53 100644 --- a/documentation/src/drawing.dox +++ b/documentation/src/drawing.dox @@ -154,11 +154,12 @@ the current clipping region. \section drawing_colors Colors FLTK manages colors as 32-bit unsigned integers, encoded as RGBI. -When the RGB bytes are non-zero, the value is treated as RGB. -If these bytes are zero, the I byte will be used as an index -into the colormap. +When the "RGB" bytes are non-zero, the value is treated as RGB. +If these bytes are zero, the "I" byte will be used as an index +into the colormap. Colors with both "RGB" set and an "I" >0 +are reserved for special use. -Values from 0 to 255, i.e. the I index value, represent +Values from 0 to 255, i.e. the "I" index value, represent colors from the FLTK 1.3.x standard colormap and are allocated as needed on screens without TrueColor support. The \b Fl_Color enumeration type defines the @@ -216,7 +217,6 @@ void Fl::get_color(Fl_Color i, uchar &red, uchar &green, uchar &blue) Generate RGB values from a colormap index value \p i. The first returns the RGB as a 32-bit unsigned integer, and the second decomposes the RGB into three 8-bit values. -\todo work out why Fl::get_color() does not give links! Fl::get_system_colors() <br> Fl::foreground() <br> @@ -236,7 +236,6 @@ Fl::set_color(Fl_Color i, unsigned c) \par \p Fl::free_color() and \p Fl::set_color() are used to remove and replace entries from the colormap. -\todo work out why these do not give links! There are two predefined graphical interfaces for choosing colors. The function fl_show_colormap() shows a table of colors and returns an @@ -354,7 +353,7 @@ void fl_point(int x, int y) Draw a single pixel at the given coordinates. void fl_rectf(int x, int y, int w, int h) <br> -void fl_rectf(int x, int y, int w, int h) +void fl_rectf(int x, int y, int w, int h, Fl_Color c) \par Color a rectangle that exactly fills the given bounding box. @@ -552,8 +551,8 @@ Add a single vertex to the current path. void fl_curve(double X0, double Y0, double X1, double Y1, double X2, double Y2, double X3, double Y3) \par -Add a series of points on a Bezier curve to the path. The curve ends -(and two of the points) are at <tt>X0,Y0</tt> and <tt>X3,Y3</tt>. +Add a series of points on a Bezier curve to the path. The curve ends +(and two of the points are) at <tt>X0,Y0</tt> and <tt>X3,Y3</tt>. \anchor drawing_fl_arc void fl_arc(double x, double y, double r, double start, double end) @@ -623,9 +622,6 @@ image is drawn above or below the text as specified by the The \p draw_symbols argument specifies whether or not to look for symbol names starting with the "@" character. -\par -The text length is limited to 1024 characters per line. - void fl_measure(const char *str, int& w, int& h, int draw_symbols) \par @@ -636,7 +632,7 @@ white space in the string, kerning, etc. If the incoming \p w is non-zero it will wrap to that width. \par Refer to the full documentation for fl_measure() for details -on usage and how to avoide common pitfalls. +on usage and how to avoid common pitfalls. \see fl_text_extents() -- measure the 'inked' area of a string \see fl_width() -- measure the pixel width of a string or single character |