summaryrefslogtreecommitdiff
path: root/documentation/src/drawing.dox
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/src/drawing.dox')
-rw-r--r--documentation/src/drawing.dox22
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