simplified old HTML anchors with name= and href= in all *.dox files.

removed "old html link" section from development.dox



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6799 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
engelsman 2009-06-27 20:40:48 +00:00
parent d94e82c6c2
commit 7f18e1002f
12 changed files with 39 additions and 265 deletions

View File

@ -166,7 +166,6 @@ If you change a widget's size or position after it is
displayed you will have to call \p redraw() on the displayed you will have to call \p redraw() on the
widget's parent. widget's parent.
<A NAME="colors"></A> <!-- For old HTML links only ! -->
\section common_colors Colors \section common_colors Colors
FLTK stores the colors of widgets as an 32-bit unsigned FLTK stores the colors of widgets as an 32-bit unsigned
@ -215,7 +214,6 @@ Similarly, the label color is set using the \p labelcolor() method:
button->labelcolor(FL_WHITE); button->labelcolor(FL_WHITE);
\endcode \endcode
<A NAME="boxtypes"></A> <!-- For old HTML links only ! -->
\section common_boxtypes Box Types \section common_boxtypes Box Types
The type Fl_Boxtype stored and returned in Fl_Widget::box() The type Fl_Boxtype stored and returned in Fl_Widget::box()
@ -269,7 +267,6 @@ void xyz_draw(int x, int y, int w, int h, Fl_Color c) {
} }
\endcode \endcode
<A name="fl_down"></A> <!-- For old HTML links only ! -->
\anchor common_fl_down \anchor common_fl_down
Fl_Boxtype fl_down(Fl_Boxtype b) Fl_Boxtype fl_down(Fl_Boxtype b)
@ -279,7 +276,6 @@ If no "down" version of a given box exists, the behavior of this function
is undefined and some random box or frame is returned. is undefined and some random box or frame is returned.
See \ref drawing_fl_frame "Drawing Functions" for more details. See \ref drawing_fl_frame "Drawing Functions" for more details.
<A name="fl_frame"></A> <!-- For old HTML links only ! -->
\anchor common_fl_frame \anchor common_fl_frame
Fl_Boxtype fl_frame(Fl_Boxtype b) Fl_Boxtype fl_frame(Fl_Boxtype b)
@ -289,8 +285,6 @@ If no frame version of a given box exists, the behavior of this function
is undefined and some random box or frame is returned. is undefined and some random box or frame is returned.
See \ref drawing_fl_frame "Drawing Functions" for more details. See \ref drawing_fl_frame "Drawing Functions" for more details.
<A name="fl_box"></A> <!-- For old HTML links only ! -->
\anchor common_fl_box
Fl_Boxtype fl_box(Fl_Boxtype b) Fl_Boxtype fl_box(Fl_Boxtype b)
\par \par
@ -323,7 +317,6 @@ value evenly divideable by two.
\ref common_fl_frame "fl_frame(Fl_Boxtype)" \ref common_fl_frame "fl_frame(Fl_Boxtype)"
expects the \p UP_BOX design at a value divideable by four. expects the \p UP_BOX design at a value divideable by four.
<A NAME="labels"></A> <!-- For old HTML links only ! -->
\section common_labels Labels and Label Types \section common_labels Labels and Label Types
The \p label(), \p align(), \p labelfont(), \p labelsize(), The \p label(), \p align(), \p labelfont(), \p labelsize(),
@ -375,7 +368,6 @@ constants are defined and may be OR'd together as needed:
\li \p FL_TEXT_OVER_IMAGE - show the label text over the image. \li \p FL_TEXT_OVER_IMAGE - show the label text over the image.
\li \p FL_IMAGE_OVER_TEXT - show the label image over the text (default). \li \p FL_IMAGE_OVER_TEXT - show the label image over the text (default).
<A NAME="labeltypes"></A> <!-- For old HTML links only ! -->
\anchor common_labeltype \anchor common_labeltype
\par labeltype() \par labeltype()
@ -389,7 +381,6 @@ following standard label types are included:
\li \p FL_EMBOSSED_LABEL - draws edges as thought the text is raised. \li \p FL_EMBOSSED_LABEL - draws edges as thought the text is raised.
\li \p FL_ICON_LABEL - draws the icon associated with the text. \li \p FL_ICON_LABEL - draws the icon associated with the text.
\anchor common_image_deimage
\par image() and deimage() \par image() and deimage()
The \p image() and \p deimage() methods set an image that The \p image() and \p deimage() methods set an image that
@ -466,7 +457,6 @@ method to select your label type.
The Fl::set_labeltype() method can also be used to overload The Fl::set_labeltype() method can also be used to overload
an existing label type such as \p FL_NORMAL_LABEL. an existing label type such as \p FL_NORMAL_LABEL.
<A NAME="add_symbol"></A> <!-- For old HTML links only ! -->
\par Making your own symbols \par Making your own symbols
It is also possible to define your own drawings and add It is also possible to define your own drawings and add

View File

@ -251,96 +251,36 @@ The following section is
\section development_links Creating Links \section development_links Creating Links
Links to other documents and external links can be embedded with Links to other documents and external links can be embedded with
\li normal HTML links
\li HTML links without markup - doxygen creates "http://..." - doxygen \\ref links to other doxygen \\page, \\section,
links automatically \\subsection and \\anchor locations
\li links to other doxygen chapters with the \\ref statments - HTML links without markup - doxygen creates "http://..."
\li links to named sections within the same or other doxygen chapters, links automatically
if they are defined there with a \\section statement - standard, non-Doxygen, HTML links
\code \code
see chapter \ref unicode creates a link to the named chapter unicode
that has been created with a \subpage statement.
see <a href="drawing.html#character_encoding">chapter 5</a> creates - see chapter \ref unicode creates a link to the named chapter
a link to a named html anchor "character_encoding" within the same file. unicode that has been created with a \page statement.
For further informations about quoting see - For further informations about quoting see
http://www.stack.nl/~dimitri/doxygen/htmlcmds.html http://www.stack.nl/~dimitri/doxygen/htmlcmds.html
Bold link text: you can see the <b>online documentation</b> - see <a href="http://www.nedit.org/">Nedit</a> creates
of FLTK 1.3 at \b http://www.fltk.org/doc-1.3/index.html a standard HTML link
see section \ref development_non-ascii
\endcode \endcode
appears as: appears as:
see chapter \ref unicode creates a link to the named chapter unicode - see chapter \ref unicode creates a link to the named chapter
that has been created with a \\subpage statement. unicode that has been created with a \\page statement.
see <a href="drawing.html#character_encoding">chapter 5</a> creates - For further informations about quoting see
a link to a named html anchor "character_encoding" within the same file.
For further informations about quoting see
http://www.stack.nl/~dimitri/doxygen/htmlcmds.html http://www.stack.nl/~dimitri/doxygen/htmlcmds.html
Bold link text: you can see the <b>online documentation</b> - see <a href="http://www.nedit.org/">Nedit</a> creates
of FLTK 1.3 at \b http://www.fltk.org/doc-1.3/index.html a standard HTML link
see section \ref development_non-ascii
\section development_old-links Changing Old Links
Old HTML links and anchors in text documentation pages should be changed
as follows:
\code
<H2><A name="event_xxx">Fl::event_*() methods</A></H2>
becomes:
<A NAME="event_xxx"></A> <!-- For old HTML links only ! -->
\section events_event_xxx Fl::event_*() methods
\endcode
The additional HTML "<A NAME=...>" statement is temporary needed, until
all links (references) are modified, then:
\code
<H2><A name="event_xxx">Fl::event_*() methods</A></H2>
becomes:
\section events_event_xxx Fl::event_*() methods
\endcode
The "\section" statement can also be a "\subsection" or "\subsubsection"
statement.
The references (in this example from index.dox) are changed as follows:
\code
\subpage events
<B>
<UL>
<LI><A HREF="events.html#event_xxx">Fl::event_*() methods</A></LI>
<LI><A HREF="events.html#propagation">Event Propagation</A></LI>
</UL>
</B>
becomes:
\subpage events
<b>
\li \ref events_event_xxx
\li \ref events_propagation
</b>
\endcode
\section development_paragraphs Paragraph Layout \section development_paragraphs Paragraph Layout
@ -421,18 +361,8 @@ Each introduction (tutorial) page ends with navigation elements. These
elements must only be included in the html documentation, therefore elements must only be included in the html documentation, therefore
they must be separated with \\htmlonly and \\endhtmlonly. they must be separated with \\htmlonly and \\endhtmlonly.
Example navigation links: The following code gives the navigation bar at the bottom of this page:
\verbatim
\htmlonly
<hr>
<a class="el" href="index.html">[Index]</a> &nbsp;&nbsp;
<a class="el" href="migration_1_3.html">[Previous] Migrating Code from FLTK 1.1 to 1.3</a>&nbsp;&nbsp;
<a class="el" href="license.html">[Next] Software License</a>
\endhtmlonly
\endverbatim
Now replaced by:
\verbatim \verbatim
\htmlonly \htmlonly
<hr> <hr>

View File

@ -44,22 +44,18 @@ header file. FLTK provides the following types of drawing functions:
\li \ref ssect_Fl_Image \li \ref ssect_Fl_Image
\li \ref ssect_Offscreen \li \ref ssect_Offscreen
<A name="boxdraw"></A> <!-- For old HTML links only ! -->
\subsection ssect_Boxes Boxes \subsection ssect_Boxes Boxes
FLTK provides three functions that can be used to draw boxes for buttons FLTK provides three functions that can be used to draw boxes for buttons
and other UI controls. Each function uses the supplied upper-lefthand corner and other UI controls. Each function uses the supplied upper-lefthand corner
and width and height to determine where to draw the box. and width and height to determine where to draw the box.
<A NAME="fl_draw_box"> </A> <!-- For old HTML links only ! -->
void fl_draw_box(Fl_Boxtype b, int x, int y, int w, int h, Fl_Color c); void fl_draw_box(Fl_Boxtype b, int x, int y, int w, int h, Fl_Color c);
\par \par
The \p %fl_draw_box() function draws a standard boxtype \p b The \p %fl_draw_box() function draws a standard boxtype \p b
in the specified color \p c. in the specified color \p c.
<A NAME="fl_frame"></A> <!-- For old HTML links only ! -->
<A NAME="fl_frame2"></A> <!-- For old HTML links only ! -->
\anchor drawing_fl_frame \anchor drawing_fl_frame
void fl_frame(const char *s, int x, int y, int w, int h) <br> void fl_frame(const char *s, int x, int y, int w, int h) <br>
void fl_frame2(const char *s, int x, int y, int w, int h) void fl_frame2(const char *s, int x, int y, int w, int h)
@ -86,7 +82,6 @@ Note that
is described in the \ref common_boxtypes section. is described in the \ref common_boxtypes section.
<A name="clipping"></A> <!-- For old HTML links only ! -->
\subsection ssect_Clipping Clipping \subsection ssect_Clipping Clipping
You can limit all your drawing to a rectangular region by calling You can limit all your drawing to a rectangular region by calling
@ -98,7 +93,6 @@ transformation matrix.
In addition, the system may provide clipping when updating windows In addition, the system may provide clipping when updating windows
which may be more complex than a simple rectangle. which may be more complex than a simple rectangle.
<A name="fl_push_clip"></A> <!-- For old HTML links only ! -->
void fl_push_clip(int x, int y, int w, int h) <br> void fl_push_clip(int x, int y, int w, int h) <br>
void fl_clip(int x, int y, int w, int h) void fl_clip(int x, int y, int w, int h)
@ -110,13 +104,11 @@ region onto the stack.
The \p %fl_clip() version is deprecated and The \p %fl_clip() version is deprecated and
will be removed from future releases. will be removed from future releases.
<A NAME="fl_push_no_clip"></A> <!-- For old HTML links only ! -->
void fl_push_no_clip() void fl_push_no_clip()
\par \par
Pushes an empty clip region on the stack so nothing will be clipped. Pushes an empty clip region on the stack so nothing will be clipped.
<A NAME="fl_pop_clip"></A> <!-- For old HTML links only ! -->
void fl_pop_clip() void fl_pop_clip()
\par \par
@ -129,7 +121,6 @@ You must call \p %fl_pop_clip() once for every time you call
If you return to FLTK with the clip stack not empty unpredictable results If you return to FLTK with the clip stack not empty unpredictable results
occur. occur.
<A NAME="fl_not_clipped"></A> <!-- For old HTML links only ! -->
int fl_not_clipped(int x, int y, int w, int h) int fl_not_clipped(int x, int y, int w, int h)
\par \par
@ -141,7 +132,6 @@ region. If this returns 0 you don't have to draw the object.
Under X this returns 2 if the rectangle is partially clipped, Under X this returns 2 if the rectangle is partially clipped,
and 1 if it is entirely inside the clip region. and 1 if it is entirely inside the clip region.
<A NAME="fl_clip_box"></A> <!-- For old HTML links only ! -->
int fl_clip_box(int x, int y, int w, int h, int &X, int &Y, int &W, int &H) int fl_clip_box(int x, int y, int w, int h, int &X, int &Y, int &W, int &H)
\par \par
@ -152,7 +142,6 @@ different than the original. This can be used to limit the
necessary drawing to a rectangle. \c W and \c H are necessary drawing to a rectangle. \c W and \c H are
set to zero if the rectangle is completely outside the region. set to zero if the rectangle is completely outside the region.
<A NAME="fl_clip_region"></A> <!-- For old HTML links only ! -->
void fl_clip_region(Fl_Region r) <br> void fl_clip_region(Fl_Region r) <br>
Fl_Region fl_clip_region() Fl_Region fl_clip_region()
@ -162,7 +151,6 @@ Fl_Region is an operating system specific type. The second form returns
the current clipping region. the current clipping region.
<A NAME="colors"></A> <!-- For old HTML links only ! -->
\section drawing_colors Colors \section drawing_colors Colors
FLTK manages colors as 32-bit unsigned integers. Values from FLTK manages colors as 32-bit unsigned integers. Values from
@ -182,7 +170,6 @@ fl_rgb_color(uchar r, uchar b, uchar c) and
fl_rgb_color(uchar grayscale) fl_rgb_color(uchar grayscale)
functions. functions.
<A name="fl_color"></A> <!-- For old HTML links only ! -->
void fl_color(Fl_Color c) <br> void fl_color(Fl_Color c) <br>
void fl_color(int c) void fl_color(int c)
@ -211,7 +198,6 @@ closest possible match to the RGB color is used. The RGB color
is used directly on TrueColor displays. For colormap visuals the is used directly on TrueColor displays. For colormap visuals the
nearest index in the gray ramp or color cube is used. nearest index in the gray ramp or color cube is used.
<A name="lines"></A> <!-- For old HTML links only ! -->
\subsection ssect_Lines Line Dashes and Thickness \subsection ssect_Lines Line Dashes and Thickness
FLTK supports drawing of lines with different styles and FLTK supports drawing of lines with different styles and
@ -219,7 +205,6 @@ widths. Full functionality is not available under Windows 95, 98,
and Me due to the reduced drawing functionality these operating and Me due to the reduced drawing functionality these operating
systems provide. systems provide.
<A NAME="fl_line_style"></A> <!-- For old HTML links only ! -->
void fl_line_style(int style, int width, char* dashes) void fl_line_style(int style, int width, char* dashes)
\par \par
@ -272,7 +257,6 @@ The dashes array does not work under Windows 95, 98, or Me, since those
operating systems do not support complex line styles. operating systems do not support complex line styles.
<A name="fast"></A> <!-- For old HTML links only ! -->
\subsection ssect_Fast Drawing Fast Shapes \subsection ssect_Fast Drawing Fast Shapes
These functions are used to draw almost all the FLTK widgets. These functions are used to draw almost all the FLTK widgets.
@ -283,13 +267,11 @@ ported. It is undefined whether these are affected by the
so you should only call these while the matrix is set to the so you should only call these while the matrix is set to the
identity matrix (the default). identity matrix (the default).
<A NAME="fl_point"></A> <!-- For old HTML links only ! -->
void fl_point(int x, int y) void fl_point(int x, int y)
\par \par
Draw a single pixel at the given coordinates. Draw a single pixel at the given coordinates.
<A NAME="fl_rectf"></A> <!-- For old HTML links only ! -->
void fl_rectf(int x, int y, int w, int h) <br> 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)
@ -305,35 +287,30 @@ color this is done by drawing a solid-colored block using
\ref drawing_fl_draw_image "fl_draw_image()" \ref drawing_fl_draw_image "fl_draw_image()"
so that the correct color shade is produced. so that the correct color shade is produced.
<A NAME="fl_rect"></A> <!-- For old HTML links only ! -->
void fl_rect(int x, int y, int w, int h) <br> void fl_rect(int x, int y, int w, int h) <br>
void fl_rect(int x, int y, int w, int h, Fl_Color c) void fl_rect(int x, int y, int w, int h, Fl_Color c)
\par \par
Draw a 1-pixel border \e inside this bounding box. Draw a 1-pixel border \e inside this bounding box.
<A NAME="fl_line"></A> <!-- For old HTML links only ! -->
void fl_line(int x, int y, int x1, int y1) <br> void fl_line(int x, int y, int x1, int y1) <br>
void fl_line(int x, int y, int x1, int y1, int x2, int y2) void fl_line(int x, int y, int x1, int y1, int x2, int y2)
\par \par
Draw one or two lines between the given points. Draw one or two lines between the given points.
<A NAME="fl_loop"></A> <!-- For old HTML links only ! -->
void fl_loop(int x, int y, int x1, int y1, int x2, int y2) <br> void fl_loop(int x, int y, int x1, int y1, int x2, int y2) <br>
void fl_loop(int x, int y, int x1, int y1, int x2, int y2, int x3, int y3) void fl_loop(int x, int y, int x1, int y1, int x2, int y2, int x3, int y3)
\par \par
Outline a 3 or 4-sided polygon with lines. Outline a 3 or 4-sided polygon with lines.
<A NAME="fl_polygon"></A> <!-- For old HTML links only ! -->
void fl_polygon(int x, int y, int x1, int y1, int x2, int y2) <br> void fl_polygon(int x, int y, int x1, int y1, int x2, int y2) <br>
void fl_polygon(int x, int y, int x1, int y1, int x2, int y2, int x3, int y3) void fl_polygon(int x, int y, int x1, int y1, int x2, int y2, int x3, int y3)
\par \par
Fill a 3 or 4-sided polygon. The polygon must be convex. Fill a 3 or 4-sided polygon. The polygon must be convex.
<A NAME="fl_xyline"></A> <!-- For old HTML links only ! -->
void fl_xyline(int x, int y, int x1) <br> void fl_xyline(int x, int y, int x1) <br>
void fl_xyline(int x, int y, int x1, int y2) <br> void fl_xyline(int x, int y, int x1, int y2) <br>
void fl_xyline(int x, int y, int x1, int y2, int x3) void fl_xyline(int x, int y, int x1, int y2, int x3)
@ -342,7 +319,6 @@ void fl_xyline(int x, int y, int x1, int y2, int x3)
Draw horizontal and vertical lines. A horizontal line is Draw horizontal and vertical lines. A horizontal line is
drawn first, then a vertical, then a horizontal. drawn first, then a vertical, then a horizontal.
<A NAME="fl_yxline"></A> <!-- For old HTML links only ! -->
void fl_yxline(int x, int y, int y1) <br> void fl_yxline(int x, int y, int y1) <br>
void fl_yxline(int x, int y, int y1, int x2) <br> void fl_yxline(int x, int y, int y1, int x2) <br>
void fl_yxline(int x, int y, int y1, int x2, int y3) void fl_yxline(int x, int y, int y1, int x2, int y3)
@ -351,7 +327,6 @@ void fl_yxline(int x, int y, int y1, int x2, int y3)
Draw vertical and horizontal lines. A vertical line is drawn Draw vertical and horizontal lines. A vertical line is drawn
first, then a horizontal, then a vertical. first, then a horizontal, then a vertical.
<A NAME="fl_pie"></A> <!-- For old HTML links only ! -->
void fl_arc(int x, int y, int w, int h, double a1, double a2) <br> void fl_arc(int x, int y, int w, int h, double a1, double a2) <br>
void fl_pie(int x, int y, int w, int h, double a1, double a2) void fl_pie(int x, int y, int w, int h, double a1, double a2)
@ -386,7 +361,6 @@ use \p w-1 and \p h-1.
\todo \todo
add an Fl_Draw_Area_Cb typedef to allow fl_scroll(...) to be doxygenated? add an Fl_Draw_Area_Cb typedef to allow fl_scroll(...) to be doxygenated?
<A name="fl_scroll"></A> <!-- For old HTML links only ! -->
void fl_scroll(int X, int Y, int W, int H, int dx, int dy, void (*draw_area)(void*, int,int,int,int), void* data) void fl_scroll(int X, int Y, int W, int H, int dx, int dy, void (*draw_area)(void*, int,int,int,int), void* data)
\par \par
@ -396,7 +370,6 @@ of the rectangular area is first shifted by \p dx and
exposed rectangular area, exposed rectangular area,
<A name="complex"></A> <!-- For old HTML links only ! -->
\subsection ssect_Complex Drawing Complex Shapes \subsection ssect_Complex Drawing Complex Shapes
The complex drawing functions let you draw arbitrary shapes The complex drawing functions let you draw arbitrary shapes
@ -410,7 +383,6 @@ severely limits the accuracy of these functions for complex
graphics, so use OpenGL when greater accuracy and/or performance graphics, so use OpenGL when greater accuracy and/or performance
is required. is required.
<A NAME="fl_push_matrix"></A> <!-- For old HTML links only ! -->
void fl_push_matrix() <br> void fl_push_matrix() <br>
void fl_pop_matrix() void fl_pop_matrix()
@ -418,7 +390,6 @@ void fl_pop_matrix()
Save and restore the current transformation. The maximum Save and restore the current transformation. The maximum
depth of the stack is 4. depth of the stack is 4.
<A NAME="fl_scale"></A> <!-- For old HTML links only ! -->
void fl_scale(double x,double y) <br> void fl_scale(double x,double y) <br>
void fl_scale(double x) <br> void fl_scale(double x) <br>
void fl_translate(double x,double y) <br> void fl_translate(double x,double y) <br>
@ -429,7 +400,6 @@ void fl_mult_matrix(double a,double b,double c,double d,double x,double y)
Concatenate another transformation onto the current one. The rotation Concatenate another transformation onto the current one. The rotation
angle is in degrees (not radians) and is counter-clockwise. angle is in degrees (not radians) and is counter-clockwise.
<A NAME="fl_transform"></A> <!-- For old HTML links only ! -->
double fl_transform_x(double x, double y) <br> double fl_transform_x(double x, double y) <br>
double fl_transform_y(double x, double y) <br> double fl_transform_y(double x, double y) <br>
double fl_transform_dx(double x, double y) <br> double fl_transform_dx(double x, double y) <br>
@ -441,7 +411,6 @@ Transform a coordinate or a distance using the current transformation matrix.
After transforming a coordinate pair, it can be added to the vertex After transforming a coordinate pair, it can be added to the vertex
list without any forther translations using \p %fl_transformed_vertex(). list without any forther translations using \p %fl_transformed_vertex().
<A NAME="fl_begin_points"></A> <!-- For old HTML links only ! -->
void fl_begin_points() <br> void fl_begin_points() <br>
void fl_end_points() void fl_end_points()
@ -449,28 +418,24 @@ void fl_end_points()
Start and end drawing a list of points. Points are added to Start and end drawing a list of points. Points are added to
the list with \p %fl_vertex(). the list with \p %fl_vertex().
<A NAME="fl_begin_line"></A> <!-- For old HTML links only ! -->
void fl_begin_line() <br> void fl_begin_line() <br>
void fl_end_line() void fl_end_line()
\par \par
Start and end drawing lines. Start and end drawing lines.
<A NAME="fl_begin_loop"></A> <!-- For old HTML links only ! -->
void fl_begin_loop() <br> void fl_begin_loop() <br>
void fl_end_loop() void fl_end_loop()
\par \par
Start and end drawing a closed sequence of lines. Start and end drawing a closed sequence of lines.
<A NAME="fl_begin_polygon"></A> <!-- For old HTML links only ! -->
void fl_begin_polygon() <br> void fl_begin_polygon() <br>
void fl_end_polygon() void fl_end_polygon()
\par \par
Start and end drawing a convex filled polygon. Start and end drawing a convex filled polygon.
<A NAME="fl_begin_complex_polygon"></A> <!-- For old HTML links only ! -->
void fl_begin_complex_polygon() <br> void fl_begin_complex_polygon() <br>
void fl_gap() <br> void fl_gap() <br>
void fl_end_complex_polygon() void fl_end_complex_polygon()
@ -498,20 +463,17 @@ For portability, you should only draw polygons that appear the same whether
"even/odd" or "non-zero" winding rules are used to fill them. Holes should "even/odd" or "non-zero" winding rules are used to fill them. Holes should
be drawn in the opposite direction of the outside loop. be drawn in the opposite direction of the outside loop.
<A NAME="fl_vertex"></A> <!-- For old HTML links only ! -->
void fl_vertex(double x,double y) void fl_vertex(double x,double y)
\par \par
Add a single vertex to the current path. Add a single vertex to the current path.
<A NAME="fl_curve"></A> <!-- For old HTML links only ! -->
void fl_curve(double X0, double Y0, double X1, double Y1, double X2, double Y2, double X3, double Y3) void fl_curve(double X0, double Y0, double X1, double Y1, double X2, double Y2, double X3, double Y3)
\par \par
Add a series of points on a Bezier curve to the path. The curve ends 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>. (and two of the points) are at <tt>X0,Y0</tt> and <tt>X3,Y3</tt>.
<A NAME="fl_arc"></A> <!-- For old HTML links only ! -->
\anchor drawing_fl_arc \anchor drawing_fl_arc
void fl_arc(double x, double y, double r, double start, double end) void fl_arc(double x, double y, double r, double start, double end)
@ -527,7 +489,6 @@ in degrees counter-clockwise from 3 o'clock.
If \p end is less than \p start then it draws the arc in a clockwise If \p end is less than \p start then it draws the arc in a clockwise
direction. direction.
<A NAME="fl_circle"></A> <!-- For old HTML links only ! -->
void fl_circle(double x, double y, double r) void fl_circle(double x, double y, double r)
\par \par
@ -540,7 +501,6 @@ a circle as part of a complex polygon you must use \p %fl_arc().
\p %fl_circle() draws incorrectly if the transformation is both rotated and \p %fl_circle() draws incorrectly if the transformation is both rotated and
non-square scaled. non-square scaled.
<A name="text"></A> <!-- For old HTML links only ! -->
\subsection ssect_Text Drawing Text \subsection ssect_Text Drawing Text
All text is drawn in the All text is drawn in the
@ -548,7 +508,6 @@ All text is drawn in the
It is undefined whether this location or the characters are It is undefined whether this location or the characters are
modified by the current transformation. modified by the current transformation.
<A NAME="fl_draw"></A> <!-- For old HTML links only ! -->
void fl_draw(const char *, int x, int y) <br> void fl_draw(const char *, int x, int y) <br>
void fl_draw(const char *, int n, int x, int y) void fl_draw(const char *, int n, int x, int y)
@ -586,7 +545,6 @@ to look for symbol names starting with the "@" character.
\par \par
The text length is limited to 1024 characters per line. The text length is limited to 1024 characters per line.
<A NAME="fl_measure"></A> <!-- For old HTML links only ! -->
void fl_measure(const char *str, int& w, int& h, int draw_symbols) void fl_measure(const char *str, int& w, int& h, int draw_symbols)
\par \par
@ -594,23 +552,19 @@ Measure how wide and tall the string will be when printed by
the \p fl_draw(...align) function. the \p fl_draw(...align) function.
If the incoming \p w is non-zero it will wrap to that width. If the incoming \p w is non-zero it will wrap to that width.
<A NAME="fl_height"></A> <!-- For old HTML links only ! -->
int fl_height() int fl_height()
\par \par
Recommended minimum line spacing for the current font. You Recommended minimum line spacing for the current font. You
can also just use the value of \p size passed to can also just use the value of \p size passed to
\ref drawing_fl_font "fl_font()". \ref drawing_fl_font "fl_font()".
<A href="#fl_font"><tt>fl_font()</tt></A>.
<A NAME="fl_descent"></A> <!-- For old HTML links only ! -->
int fl_descent() int fl_descent()
\par \par
Recommended distance above the bottom of a \p %fl_height() tall box to draw Recommended distance above the bottom of a \p %fl_height() tall box to draw
the text at so it looks centered vertically in that box. the text at so it looks centered vertically in that box.
<A NAME="fl_width"></A> <!-- For old HTML links only ! -->
double fl_width(const char* txt) <br> double fl_width(const char* txt) <br>
double fl_width(const char* txt, int n) <br> double fl_width(const char* txt, int n) <br>
double fl_width(Fl_Unichar) double fl_width(Fl_Unichar)
@ -619,7 +573,6 @@ double fl_width(Fl_Unichar)
Return the pixel width of a nul-terminated string, a sequence of \p n Return the pixel width of a nul-terminated string, a sequence of \p n
characters, or a single character in the current font. characters, or a single character in the current font.
<A NAME="fl_shortcut_label"></A> <!-- For old HTML links only ! -->
const char* fl_shortcut_label(int shortcut) const char* fl_shortcut_label(int shortcut)
\par \par
@ -630,7 +583,6 @@ key. If the shortcut is zero an empty string is returned. The
return value points at a static buffer that is overwritten with return value points at a static buffer that is overwritten with
each call. each call.
<A name="fonts"></A> <!-- For old HTML links only ! -->
\subsection ssect_Fonts Fonts \subsection ssect_Fonts Fonts
FLTK supports a set of standard fonts based on the Times, FLTK supports a set of standard fonts based on the Times,
@ -646,7 +598,6 @@ these, and FL_SYMBOL and FL_ZAPF_DINGBATS.
Faces greater than 255 cannot be used in Fl_Widget Faces greater than 255 cannot be used in Fl_Widget
labels, since Fl_Widget stores the index as a byte. labels, since Fl_Widget stores the index as a byte.
<A name="fl_font"></A> <!-- For old HTML links only ! -->
\anchor drawing_fl_font \anchor drawing_fl_font
void fl_font(int face, int size) void fl_font(int face, int size)
@ -661,7 +612,6 @@ The font is identified by a \p face and a \p size.
The size of the font is measured in \p pixels and not "points". The size of the font is measured in \p pixels and not "points".
Lines should be spaced \p size pixels apart or more. Lines should be spaced \p size pixels apart or more.
<A NAME="fl_size"></A> <!-- For old HTML links only ! -->
int fl_font() <br> int fl_font() <br>
int fl_size() int fl_size()
@ -669,7 +619,6 @@ int fl_size()
Returns the face and size set by the most recent call to Returns the face and size set by the most recent call to
\p fl_font(a,b). This can be used to save/restore the font. \p fl_font(a,b). This can be used to save/restore the font.
<A NAME="character_encoding"></A> <!-- For old HTML links only ! -->
\subsection ssect_CharacterEncoding Character Encoding \subsection ssect_CharacterEncoding Character Encoding
\todo \todo
@ -709,16 +658,15 @@ html "&cedil;").
\todo drawing.dox: I fixed the above encoding problem of these \&cedil; \todo drawing.dox: I fixed the above encoding problem of these \&cedil;
and umlaut characters, but this text is obsoleted by FLTK 1.3 and umlaut characters, but this text is obsoleted by FLTK 1.3
with utf-8 encoding, or must be rewritten accordingly: with UTF-8 encoding, or must be rewritten accordingly:
How to use native (e.g. Windows "ANSI", or ISO-8859-x) How to use native (e.g. Windows "ANSI", or ISO-8859-x)
encoding in embedded strings for labels, error messages encoding in embedded strings for labels, error messages
and more. Please check this (utf-8) encoding on different and more. Please check this (UTF-8) encoding on different
OS'es and with different language and font environments. OS'es and with different language and font environments.
For more information about character encoding, unicode and utf-8 For more information about character encodings, see the chapter on
see chapter \ref unicode. \ref unicode.
<A name="overlay"></A> <!-- For old HTML links only ! -->
\subsection ssect_Overlay Drawing Overlays \subsection ssect_Overlay Drawing Overlays
These functions allow you to draw interactive selection rectangles These functions allow you to draw interactive selection rectangles
@ -744,7 +692,6 @@ should call \p %fl_overlay_clear() after a
FL_RELEASE event. FL_RELEASE event.
<A NAME="images"></A> <!-- For old HTML links only ! -->
\section drawing_images Drawing Images \section drawing_images Drawing Images
To draw images, you can either do it directly from data in To draw images, you can either do it directly from data in
@ -761,7 +708,6 @@ The behavior when drawing images when the current
transformation matrix is not the identity is not defined, so you transformation matrix is not the identity is not defined, so you
should only draw images when the matrix is set to the identity. should only draw images when the matrix is set to the identity.
<A NAME="fl_draw_image"></A> <!-- For old HTML links only ! -->
\anchor drawing_fl_draw_image \anchor drawing_fl_draw_image
void fl_draw_image(const uchar *buf,int X,int Y,int W,int H,int D,int L)<br> void fl_draw_image(const uchar *buf,int X,int Y,int W,int H,int D,int L)<br>
void fl_draw_image_mono(const uchar *buf,int X,int Y,int W,int H,int D,int L) void fl_draw_image_mono(const uchar *buf,int X,int Y,int W,int H,int D,int L)
@ -844,7 +790,6 @@ the first one may be greater than zero.
If \p D is 4 or more, you must fill in the unused bytes If \p D is 4 or more, you must fill in the unused bytes
with zero. with zero.
<A NAME="fl_draw_pixmap"></A> <!-- For old HTML links only ! -->
int fl_draw_pixmap(char* const* data, int x, int y, Fl_Color bg) <br> int fl_draw_pixmap(char* const* data, int x, int y, Fl_Color bg) <br>
int fl_draw_pixmap(const char* const* cdata, int x, int y, Fl_Color bg) int fl_draw_pixmap(const char* const* cdata, int x, int y, Fl_Color bg)
@ -868,7 +813,6 @@ Transparent colors are replaced by the optional
Fl_Color argument. To draw with true transparency you must Fl_Color argument. To draw with true transparency you must
use the Fl_Pixmap class. use the Fl_Pixmap class.
<A NAME="fl_measure_pixmap"></A> <!-- For old HTML links only ! -->
int fl_measure_pixmap(char* const* data, int &w, int &h) <br> int fl_measure_pixmap(char* const* data, int &w, int &h) <br>
int fl_measure_pixmap(const char* const* cdata, int &w, int &h) int fl_measure_pixmap(const char* const* cdata, int &w, int &h)
@ -883,7 +827,6 @@ there was any problem.
FLTK provides a single function for reading from the current FLTK provides a single function for reading from the current
window or off-screen buffer into a RGB(A) image buffer. window or off-screen buffer into a RGB(A) image buffer.
<A NAME="fl_read_image"></A> <!-- For old HTML links only ! -->
uchar* fl_read_image(uchar *p, int X, int Y, int W, int H, int alpha) uchar* fl_read_image(uchar *p, int X, int Y, int W, int H, int alpha)
\par \par
@ -899,7 +842,6 @@ The \p alpha parameter controls whether an alpha
channel is created and the value that is placed in the alpha channel is created and the value that is placed in the alpha
channel. If 0, no alpha channel is generated. channel. If 0, no alpha channel is generated.
<A name="Fl_Image"></A> <!-- For old HTML links only ! -->
\subsection ssect_Fl_Image Image Classes \subsection ssect_Fl_Image Image Classes
FLTK provides a base image class called Fl_Image which supports FLTK provides a base image class called Fl_Image which supports
@ -930,7 +872,6 @@ provided by the draw() method is either a 24-bit
blend against the existing window contents or a "screen door" blend against the existing window contents or a "screen door"
transparency mask, depending on the platform and screen color depth. transparency mask, depending on the platform and screen color depth.
<A NAME="fl_can_do_alpha_blending"></A> <!-- For old HTML links only ! -->
char fl_can_do_alpha_blending() char fl_can_do_alpha_blending()
\par \par
@ -982,7 +923,6 @@ void Fl_Tiled_Image::draw(int x, int y)
Draws the image with the upper-left corner at <tt>x,y</tt>. Draws the image with the upper-left corner at <tt>x,y</tt>.
This is the same as doing \p draw(x,y,img->w(),img->h(),0,0). This is the same as doing \p draw(x,y,img->w(),img->h(),0,0).
<A NAME="offscreen"></A> <!-- For old HTML links only ! -->
\subsection ssect_Offscreen Offscreen Drawing \subsection ssect_Offscreen Offscreen Drawing
\todo \todo
@ -995,19 +935,16 @@ repeated drawing. Fl_Double_Window uses offscreen rendering
to avoid flickering on systems that don't support to avoid flickering on systems that don't support
double-buffering natively. double-buffering natively.
<A NAME="fl_create_offscreen"></A> <!-- For old HTML links only ! -->
Fl_Offscreen fl_create_offscreen(int w, int h) Fl_Offscreen fl_create_offscreen(int w, int h)
\par \par
Create an RGB offscreen buffer with \p w*h pixels. Create an RGB offscreen buffer with \p w*h pixels.
<A NAME="fl_delete_offscreen"></A> <!-- For old HTML links only ! -->
void fl_delete_offscreen(Fl_Offscreen) void fl_delete_offscreen(Fl_Offscreen)
\par \par
Delete a previously created offscreen buffer. All drawings are lost. Delete a previously created offscreen buffer. All drawings are lost.
<A NAME="fl_begin_offscreen"></A> <!-- For old HTML links only ! -->
void fl_begin_offscreen(Fl_Offscreen) void fl_begin_offscreen(Fl_Offscreen)
\par \par
@ -1015,13 +952,11 @@ Send all subsequent drawing commands to this offscreen buffer.
FLTK can draw into a buffer at any time. There is no need to wait for FLTK can draw into a buffer at any time. There is no need to wait for
an Fl_Widget::draw() to occur. an Fl_Widget::draw() to occur.
<A NAME="fl_end_offscreen"></A> <!-- For old HTML links only ! -->
void fl_end_offscreen() void fl_end_offscreen()
\par \par
Quit sending drawing commands to this offscreen buffer. Quit sending drawing commands to this offscreen buffer.
<A NAME="fl_copy_offscreen"></A> <!-- For old HTML links only ! -->
void fl_copy_offscreen(int x, int y, int w, int h, void fl_copy_offscreen(int x, int y, int w, int h,
Fl_Offscreen osrc, int srcx, int srcy) Fl_Offscreen osrc, int srcx, int srcy)

View File

@ -621,7 +621,7 @@ The Fl_Text_Editor widget supports highlighting
of text with different fonts, colors, and sizes. The of text with different fonts, colors, and sizes. The
implementation is based on the excellent implementation is based on the excellent
<A HREF="http://www.nedit.org/">NEdit</A> <A HREF="http://www.nedit.org/">NEdit</A>
text editor core, which text editor core, from http://www.nedit.org/, which
uses a parallel "style" buffer which tracks the font, color, and uses a parallel "style" buffer which tracks the font, color, and
size of the text that is drawn. size of the text that is drawn.

View File

@ -248,8 +248,7 @@ RGB color value are described in the
\ref drawing_colors \ref drawing_colors
section of the section of the
\ref drawing \ref drawing
chapter, or in the generated chapter.
<a href="functions_func.html">Function Reference</A> pages.
\section enumerations_cursors Cursors \section enumerations_cursors Cursors
@ -305,7 +304,7 @@ The following damage mask bits are used by the standard FLTK widgets:
<td width="45%" align="LEFT"> <td width="45%" align="LEFT">
<a class="el" href="unicode.html"> <a class="el" href="unicode.html">
[Prev] [Prev]
Unicode and utf-8 Support Unicode and UTF-8 Support
</a> </a>
</td> </td>
<td width="10%" align="CENTER"> <td width="10%" align="CENTER">

View File

@ -261,7 +261,6 @@ widget. This indicates that some other widget or program has
claimed the selection. Motif programs used this to clear the claimed the selection. Motif programs used this to clear the
selection indication. Most modern programs ignore this. selection indication. Most modern programs ignore this.
<A NAME="dnd"></A> <!-- For old HTML links only ! -->
\section events_dnd Drag and Drop Events \section events_dnd Drag and Drop Events
FLTK supports drag and drop of text and files from any FLTK supports drag and drop of text and files from any
@ -303,7 +302,6 @@ the immediatly following \p FL_PASTE event.
<!-- NEED 6in --> <!-- NEED 6in -->
<A NAME="event_xxx"></A> <!-- For old HTML links only ! -->
\section events_event_xxx Fl::event_*() methods \section events_event_xxx Fl::event_*() methods
FLTK keeps the information about the most recent event in FLTK keeps the information about the most recent event in
@ -334,7 +332,6 @@ These are all trivial inline functions and thus very fast and small:
\li Fl::get_mouse() \li Fl::get_mouse()
\li Fl::test_shortcut() \li Fl::test_shortcut()
<A NAME="event_xxx"></A> <!-- For old HTML links only ! -->
\section events_propagation Event Propagation \section events_propagation Event Propagation
FLTK follows very simple and unchangeable rules for sending FLTK follows very simple and unchangeable rules for sending
@ -369,7 +366,6 @@ control those leaf widgets:
\li Fl::release() \li Fl::release()
\li Fl_Widget::take_focus() \li Fl_Widget::take_focus()
<A name="compose"></A> <!-- For old HTML links only ! -->
\section events_compose_characters FLTK Compose-Character Sequences \section events_compose_characters FLTK Compose-Character Sequences
\todo Does Fltk Compose Character Sequences text need updating \todo Does Fltk Compose Character Sequences text need updating

View File

@ -106,14 +106,12 @@ merely a test platform to verify the functionality of the FLTK library.
</tr> </tr>
</table> </table>
<a name="adjuster"></a> <!-- For old HTML links only ! -->
\subsection examples_adjuster adjuster \subsection examples_adjuster adjuster
\par \par
\c adjuster shows a nifty little widget for quickly \c adjuster shows a nifty little widget for quickly
setting values in a great range. setting values in a great range.
<a name="arc"></a> <!-- For old HTML links only ! -->
\subsection examples_arc arc \subsection examples_arc arc
\par \par
@ -121,7 +119,6 @@ The \c arc demo explains how to derive your own widget to
generate some custom drawings. The sample drawings use the matrix generate some custom drawings. The sample drawings use the matrix
based arc drawing for some fun effects. based arc drawing for some fun effects.
<a name="ask"></a> <!-- For old HTML links only ! -->
\subsection examples_ask ask \subsection examples_ask ask
\par \par
@ -129,7 +126,6 @@ based arc drawing for some fun effects.
the correct answers or you may end up in a loop, or you may end the correct answers or you may end up in a loop, or you may end
up in a loop, or you... . up in a loop, or you... .
<a name="bitmap"></a> <!-- For old HTML links only ! -->
\subsection examples_bitmap bitmap \subsection examples_bitmap bitmap
\par \par
@ -137,7 +133,6 @@ This simple test shows the use of a single color bitmap as a
label for a box widget. Bitmaps are stored in the X11 '.bmp' label for a box widget. Bitmaps are stored in the X11 '.bmp'
file format and can be part of the source code. file format and can be part of the source code.
<a name="blocks"></a> <!-- For old HTML links only ! -->
\subsection examples_blocks blocks \subsection examples_blocks blocks
\par \par
@ -146,7 +141,6 @@ timers, graphics, and how to implement sound on all platforms.
\c blocks is also a good example for the Mac OS X specific \c blocks is also a good example for the Mac OS X specific
bundle format. bundle format.
<a name="boxtype"></a> <!-- For old HTML links only ! -->
\subsection examples_boxtype boxtype \subsection examples_boxtype boxtype
\par \par
@ -155,7 +149,6 @@ frames in FLTK. More types can be added by the application programmer.
When using themes, FLTK shuffles boxtypes around to give your program When using themes, FLTK shuffles boxtypes around to give your program
a new look. a new look.
<a name="browser"></a> <!-- For old HTML links only ! -->
\subsection examples_browser browser \subsection examples_browser browser
\par \par
@ -163,19 +156,16 @@ a new look.
Important features tested are loading of files, line formatting, and Important features tested are loading of files, line formatting, and
correct positioning of the browser data window. correct positioning of the browser data window.
<a name="button"></a> <!-- For old HTML links only ! -->
\subsection examples_button button \subsection examples_button button
\par \par
The \c button test is a simple demo of push-buttons and callbacks. The \c button test is a simple demo of push-buttons and callbacks.
<a name="buttons"></a> <!-- For old HTML links only ! -->
\subsection examples_buttons buttons \subsection examples_buttons buttons
\par \par
\c buttons shows a sample of FLTK button types. \c buttons shows a sample of FLTK button types.
<a name="checkers"></a> <!-- For old HTML links only ! -->
\subsection examples_checkers checkers \subsection examples_checkers checkers
\par \par
@ -185,7 +175,6 @@ application with a graphical UI. Check out the code that drags the
pieces, and how the pieces are drawn by layering. Then tell me pieces, and how the pieces are drawn by layering. Then tell me
how to beat the computer at Checkers. how to beat the computer at Checkers.
<a name="clock"></a> <!-- For old HTML links only ! -->
\subsection examples_clock clock \subsection examples_clock clock
\par \par
@ -193,7 +182,6 @@ The \c clock demo shows two analog clocks. The innards of
the Fl_Clock widget are pretty interesting, explaining the Fl_Clock widget are pretty interesting, explaining
the use of timeouts and matrix based drawing. the use of timeouts and matrix based drawing.
<a name="colbrowser"></a> <!-- For old HTML links only ! -->
\subsection examples_colbrowser colbrowser \subsection examples_colbrowser colbrowser
\par \par
@ -202,14 +190,12 @@ the use of timeouts and matrix based drawing.
of every text entry in the file. This is beautiful, but of every text entry in the file. This is beautiful, but
only moderatly useful unless your UI is written in <i>Motif</i>. only moderatly useful unless your UI is written in <i>Motif</i>.
<a name="color_chooser"></a> <!-- For old HTML links only ! -->
\subsection examples_color_chooser color_chooser \subsection examples_color_chooser color_chooser
\par \par
The \c color_chooser gives a short demo of FLTK's palette based The \c color_chooser gives a short demo of FLTK's palette based
color chooser and of the RGB based color wheel. color chooser and of the RGB based color wheel.
<a name="cube"></a> <!-- For old HTML links only ! -->
\subsection examples_cube cube \subsection examples_cube cube
\par \par
@ -217,13 +203,11 @@ The \c cube demo shows the speed of OpenGL. It also tests
the ability to render two OpenGL buffers into a single window, the ability to render two OpenGL buffers into a single window,
and shows OpenGL text. and shows OpenGL text.
<a name="CubeView"></a> <!-- For old HTML links only ! -->
\subsection examples_CubeView CubeView \subsection examples_CubeView CubeView
\par \par
\c CubeView shows how to create a UI containing OpenGL with Fluid. \c CubeView shows how to create a UI containing OpenGL with Fluid.
<a name="cursor"></a> <!-- For old HTML links only ! -->
\subsection examples_cursor cursor \subsection examples_cursor cursor
\par \par
@ -231,14 +215,12 @@ The \c cursor demo shows all mouse cursor shapes that come standard
with FLTK. The <i>fgcolor</i> and <i>bgcolor</i> sliders work only with FLTK. The <i>fgcolor</i> and <i>bgcolor</i> sliders work only
on few systems (some version of Irix for example). on few systems (some version of Irix for example).
<a name="curve"></a> <!-- For old HTML links only ! -->
\subsection examples_curve curve \subsection examples_curve curve
\par \par
\c curve draws a nice Bezier curve into a custom widget. The \c curve draws a nice Bezier curve into a custom widget. The
<i>points</i> option for splines is not supported on all platforms. <i>points</i> option for splines is not supported on all platforms.
<a name="demo"></a> <!-- For old HTML links only ! -->
\subsection examples_demo demo \subsection examples_demo demo
\par \par
@ -246,7 +228,6 @@ This tool allows quick access to all programs in the \c test directory.
\c demo is based on the visuals of the IrixGL demo program. The menu \c demo is based on the visuals of the IrixGL demo program. The menu
tree can be changed by editing <tt>test/demo.menu</tt>. tree can be changed by editing <tt>test/demo.menu</tt>.
<a name="doublebuffer"></a> <!-- For old HTML links only ! -->
\subsection examples_doublebuffer doublebuffer \subsection examples_doublebuffer doublebuffer
\par \par
@ -257,7 +238,6 @@ amount of RAM. Some modern OS's double buffer all windows automatically
to allow transparency and shadows on the desktop. FLTK is smart enough to allow transparency and shadows on the desktop. FLTK is smart enough
to not tripple buffer a window in that case. to not tripple buffer a window in that case.
<a name="editor"></a> <!-- For old HTML links only ! -->
\subsection examples_editor editor \subsection examples_editor editor
\par \par
@ -267,14 +247,12 @@ Fl_Text_Editor is a complete port of <i>nedit</i> (with permission).
The \c editor test is almost a full application, showing custom The \c editor test is almost a full application, showing custom
syntax highlighting and dialog creation. syntax highlighting and dialog creation.
<a name="fast_slow"></a> <!-- For old HTML links only ! -->
\subsection examples_fast_slow fast_slow \subsection examples_fast_slow fast_slow
\par \par
\c fast_slow shows how an application can use the Fl_Widget::when() \c fast_slow shows how an application can use the Fl_Widget::when()
setting to receive different kinds of callbacks. setting to receive different kinds of callbacks.
<a name="file_chooser"></a> <!-- For old HTML links only ! -->
\subsection examples_file_chooser file_chooser \subsection examples_file_chooser file_chooser
\par \par
@ -282,7 +260,6 @@ The standard FLTK \c file_chooser is the result of many
iterations, trying to find a middle ground between a complex iterations, trying to find a middle ground between a complex
browser and a fast light implementation. browser and a fast light implementation.
<a name="fonts"></a> <!-- For old HTML links only ! -->
\subsection examples_fonts fonts \subsection examples_fonts fonts
\par \par
@ -291,7 +268,6 @@ If your machine still has some pixmap based fonts, the supported
sizes will be shown in bold face. Only the first 256 fonts will sizes will be shown in bold face. Only the first 256 fonts will
be listed. be listed.
<a name="forms"></a> <!-- For old HTML links only ! -->
\subsection examples_forms forms \subsection examples_forms forms
\par \par
@ -300,7 +276,6 @@ Search for "fltk" to find all changes necessary to port to fltk.
This demo shows the different boxtypes. Note that some This demo shows the different boxtypes. Note that some
boxtypes are not appropriate for some objects. boxtypes are not appropriate for some objects.
<a name="fractals"></a> <!-- For old HTML links only ! -->
\subsection examples_fractals fractals \subsection examples_fractals fractals
\par \par
@ -308,7 +283,6 @@ boxtypes are not appropriate for some objects.
FLTK supports a rather large subset of Glut, so that many Glut FLTK supports a rather large subset of Glut, so that many Glut
applications compile just fine. applications compile just fine.
<a name="fullscreen"></a> <!-- For old HTML links only ! -->
\subsection examples_fullscreen fullscreen \subsection examples_fullscreen fullscreen
\par \par
@ -318,7 +292,6 @@ You can toggle the border on/off, switch between single-
and double-buffered rendering, and take over the entire and double-buffered rendering, and take over the entire
screen. More information in the source code. screen. More information in the source code.
<a name="gl_overlay"></a> <!-- For old HTML links only ! -->
\subsection examples_gl_overlay gl_overlay \subsection examples_gl_overlay gl_overlay
\par \par
@ -326,14 +299,12 @@ screen. More information in the source code.
hardware overlay plane is available, FLTK will simulate it hardware overlay plane is available, FLTK will simulate it
for you. for you.
<a name="glpuzzle"></a> <!-- For old HTML links only ! -->
\subsection examples_glpuzzle glpuzzle \subsection examples_glpuzzle glpuzzle
\par \par
The \c glpuzzle test shows how most Glut source code compiles The \c glpuzzle test shows how most Glut source code compiles
easily under FLTK. easily under FLTK.
<a name="hello"></a> <!-- For old HTML links only ! -->
\subsection examples_hello hello \subsection examples_hello hello
\par \par
@ -341,7 +312,6 @@ easily under FLTK.
tiny demo shows how little is needed to get a functioning application tiny demo shows how little is needed to get a functioning application
running with FLTK. Quite impressive, I'd say. running with FLTK. Quite impressive, I'd say.
<a name="help"></a> <!-- For old HTML links only ! -->
\subsection examples_help help \subsection examples_help help
\par \par
@ -351,14 +321,12 @@ various image formats. This widget makes it easy to provide help
pages to the user without depending on the operating system's pages to the user without depending on the operating system's
html browser. html browser.
<a name="iconize"></a> <!-- For old HTML links only ! -->
\subsection examples_iconize iconize \subsection examples_iconize iconize
\par \par
\c iconize demonstrates the effect of the window functions \c iconize demonstrates the effect of the window functions
hide(), iconize(), and show(). hide(), iconize(), and show().
<a name="image"></a> <!-- For old HTML links only ! -->
\subsection examples_image image \subsection examples_image image
\par \par
@ -367,7 +335,6 @@ This generated image contains an alpha (transparency) channel which
lets previous renderings 'shine through', either via true lets previous renderings 'shine through', either via true
transparency or by using screen door transparency (pixelation). transparency or by using screen door transparency (pixelation).
<a name="inactive"></a> <!-- For old HTML links only ! -->
\subsection examples_inactive inactive \subsection examples_inactive inactive
\par \par
@ -375,7 +342,6 @@ transparency or by using screen door transparency (pixelation).
To see the inactive version of images, you can check out the pixmap To see the inactive version of images, you can check out the pixmap
or image test. or image test.
<a name="input"></a> <!-- For old HTML links only ! -->
\subsection examples_input input \subsection examples_input input
\par \par
@ -383,7 +349,6 @@ This tool shows and tests different types of text input fields based on
Fl_Input_. The \c input program also tests various Fl_Input_. The \c input program also tests various
settings of Fl_Input::when(). settings of Fl_Input::when().
<a name="input_choice"></a> <!-- For old HTML links only ! -->
\subsection examples_input_choice input_choice \subsection examples_input_choice input_choice
\par \par
@ -392,7 +357,6 @@ field with an attached pulldown menu. Windows users will recognize
similarities to the 'ComboBox'. \c input_choice starts up in similarities to the 'ComboBox'. \c input_choice starts up in
'plastic' scheme, but the traditional scheme is also supported. 'plastic' scheme, but the traditional scheme is also supported.
<a name="keyboard"></a> <!-- For old HTML links only ! -->
\subsection examples_keyboard keyboard \subsection examples_keyboard keyboard
\par \par
@ -402,7 +366,6 @@ and Fl::event_text(). It is also great to see the modifier
buttons and the scroll wheel at work. Quit this application by closing buttons and the scroll wheel at work. Quit this application by closing
the window. The ESC key will not work. the window. The ESC key will not work.
<a name="label"></a> <!-- For old HTML links only ! -->
\subsection examples_label label \subsection examples_label label
\par \par
@ -411,14 +374,12 @@ demo shows alignment, clipping and wrapping of text labels. Labels
can contain symbols at the start and end of the text, like <i>\@FLTK</i> can contain symbols at the start and end of the text, like <i>\@FLTK</i>
or <i>\@circle uh-huh \@square</i>. or <i>\@circle uh-huh \@square</i>.
<a name="line_style"></a> <!-- For old HTML links only ! -->
\subsection examples_line_style line_style \subsection examples_line_style line_style
\par \par
Advanced line drawing can be tested with \c line_style. Advanced line drawing can be tested with \c line_style.
Not all platforms support all line styles. Not all platforms support all line styles.
<a name="list_visuals"></a> <!-- For old HTML links only ! -->
\subsection examples_list_visuals list_visuals \subsection examples_list_visuals list_visuals
\par \par
@ -426,7 +387,6 @@ This little app finds all available pixel formats for the current X11
screen. But since you are now an FLTK user, you don't have to worry screen. But since you are now an FLTK user, you don't have to worry
about any of this. about any of this.
<a name="mandelbrot"></a> <!-- For old HTML links only ! -->
\subsection examples_mandelbrot mandelbrot \subsection examples_mandelbrot mandelbrot
\par \par
@ -436,7 +396,6 @@ system. This is one of the few occasions where the <i>idle</i> callback
is very useful by giving all available processor time to the application is very useful by giving all available processor time to the application
without blocking the UI or other apps. without blocking the UI or other apps.
<a name="menubar"></a> <!-- For old HTML links only ! -->
\subsection examples_menubar menubar \subsection examples_menubar menubar
\par \par
@ -444,13 +403,11 @@ The \c menubar tests many aspects of FLTK's popup menu system.
Among the features are radio buttons, menus taller than the screen, Among the features are radio buttons, menus taller than the screen,
arbitrary sub menu depth, and global shortcuts. arbitrary sub menu depth, and global shortcuts.
<a name="message"></a> <!-- For old HTML links only ! -->
\subsection examples_message message \subsection examples_message message
\par \par
\c message pops up a few of FLTK's standard message boxes. \c message pops up a few of FLTK's standard message boxes.
<a name="minimum"></a> <!-- For old HTML links only ! -->
\subsection examples_minimum minimum \subsection examples_minimum minimum
\par \par
@ -459,14 +416,12 @@ are set correctly. In a real life application, the trail would
be avoided by choosing a smaller label or by setting label clipping be avoided by choosing a smaller label or by setting label clipping
differently. differently.
<a name="navigation"></a> <!-- For old HTML links only ! -->
\subsection examples_navigation navigation \subsection examples_navigation navigation
\par \par
\c navigation demonstrates how the text cursor moves from \c navigation demonstrates how the text cursor moves from
text field to text field when using the arrow keys, tab, and shift-tab. text field to text field when using the arrow keys, tab, and shift-tab.
<a name="output"></a> <!-- For old HTML links only ! -->
\subsection examples_output output \subsection examples_output output
\par \par
@ -474,7 +429,6 @@ text field to text field when using the arrow keys, tab, and shift-tab.
multi line mode of the Fl_Output widget. Fonts can be multi line mode of the Fl_Output widget. Fonts can be
selected from the FLTK standard list of fonts. selected from the FLTK standard list of fonts.
<a name="overlay"></a> <!-- For old HTML links only ! -->
\subsection examples_overlay overlay \subsection examples_overlay overlay
\par \par
@ -483,7 +437,6 @@ be layered to display cursor and manipulator style elements. This
example derives a new class from Fl_Overlay_Window and example derives a new class from Fl_Overlay_Window and
provides a new function to draw custom overlays. provides a new function to draw custom overlays.
<a name="pack"></a> <!-- For old HTML links only ! -->
\subsection examples_pack pack \subsection examples_pack pack
\par \par
@ -492,7 +445,6 @@ and repositioning of children of the Fl_Pack group.
Putting an Fl_Pack into an Fl_Scroll is Putting an Fl_Pack into an Fl_Scroll is
a useful way to create a browser for large sets of data. a useful way to create a browser for large sets of data.
<a name="pixmap_browser"></a> <!-- For old HTML links only ! -->
\subsection examples_pixmap_browser pixmap_browser \subsection examples_pixmap_browser pixmap_browser
\par \par
@ -500,7 +452,6 @@ a useful way to create a browser for large sets of data.
the same image multiple times, Fl_Shared_Image will keep it the same image multiple times, Fl_Shared_Image will keep it
only once in memory. only once in memory.
<a name="pixmap"></a> <!-- For old HTML links only ! -->
\subsection examples_pixmap pixmap \subsection examples_pixmap pixmap
\par \par
@ -509,7 +460,6 @@ label for a box widget. Pixmaps are stored in the X11 '.xpm'
file format and can be part of the source code. Pixmaps support file format and can be part of the source code. Pixmaps support
one transparent color. one transparent color.
<a name="preferences"></a> <!-- For old HTML links only ! -->
\subsection examples_preferences preferences \subsection examples_preferences preferences
\par \par
@ -517,7 +467,6 @@ I do have my \c preferences in the morning, but sometimes I
just can't remember a thing. This is where the Fl_Preferences just can't remember a thing. This is where the Fl_Preferences
come in handy. They remember any kind of data between program launches. come in handy. They remember any kind of data between program launches.
<a name="radio"></a> <!-- For old HTML links only ! -->
\subsection examples_radio radio \subsection examples_radio radio
\par \par
@ -525,21 +474,18 @@ The \c radio tool was created entirely with <i>fluid</i>. It
shows some of the available button types and tests radio shows some of the available button types and tests radio
button behavior. button behavior.
<a name="resizebox"></a> <!-- For old HTML links only ! -->
\subsection examples_resizebox resizebox \subsection examples_resizebox resizebox
\par \par
\c resizebox shows some possible ways of FLTK's automatic \c resizebox shows some possible ways of FLTK's automatic
resize bahavior.. resize bahavior..
<a name="resize"></a> <!-- For old HTML links only ! -->
\subsection examples_resize resize \subsection examples_resize resize
\par \par
The \c resize demo tests size and position functions with The \c resize demo tests size and position functions with
the given window manager. the given window manager.
<a name="scroll"></a> <!-- For old HTML links only ! -->
\subsection examples_scroll scroll \subsection examples_scroll scroll
\par \par
@ -549,7 +495,6 @@ clipping and smart window area copying to improve redraw speed.
The buttons at the bottom of the window control decoration rendering The buttons at the bottom of the window control decoration rendering
and updates. and updates.
<a name="shape"></a> <!-- For old HTML links only ! -->
\subsection examples_shape shape \subsection examples_shape shape
\par \par
@ -557,7 +502,6 @@ and updates.
your own OpenGL rendering widget. Now that you know that, go ahead your own OpenGL rendering widget. Now that you know that, go ahead
and write that flight simulator you always dreamt of. and write that flight simulator you always dreamt of.
<a name="subwindow"></a> <!-- For old HTML links only ! -->
\subsection examples_subwindow subwindow \subsection examples_subwindow subwindow
\par \par
@ -567,7 +511,6 @@ to a group by resetting the FLTK coordinate system to 0, 0 in the
top left corner. On Win32 and X11, subwindows have their own top left corner. On Win32 and X11, subwindows have their own
operating system specific handle. operating system specific handle.
<a name="sudoku"></a> <!-- For old HTML links only ! -->
\subsection examples_sudoku sudoku \subsection examples_sudoku sudoku
\par \par
@ -575,7 +518,6 @@ Another highly addictive game - don't play it, I warned you.
The implementation shows how to create application icons, The implementation shows how to create application icons,
how to deal with OS specifics, and how to generate sound. how to deal with OS specifics, and how to generate sound.
<a name="symbols"></a> <!-- For old HTML links only ! -->
\subsection examples_symbols symbols \subsection examples_symbols symbols
\par \par
@ -585,7 +527,6 @@ and with a little patience, you can define your own. The rotation
number refers to 45 degree rotations if you were looking at a number refers to 45 degree rotations if you were looking at a
numeric keypad (2 is down, 6 is right, etc.). numeric keypad (2 is down, 6 is right, etc.).
<a name="tabs"></a> <!-- For old HTML links only ! -->
\subsection examples_tabs tabs \subsection examples_tabs tabs
\par \par
@ -598,7 +539,6 @@ The \c tabs application shows the Fl_Tabs widget
on the left and the Fl_Wizard widget on the right side on the left and the Fl_Wizard widget on the right side
for direct comparison of these two panel management widgets. for direct comparison of these two panel management widgets.
<a name="threads"></a> <!-- For old HTML links only ! -->
\subsection examples_threads threads \subsection examples_threads threads
\par \par
@ -609,7 +549,6 @@ Fl::unlock(), and Fl::awake() in secondary threads
to keep FLTK happy. Although locking works on all platforms, to keep FLTK happy. Although locking works on all platforms,
this demo is not available on every machine. this demo is not available on every machine.
<a name="tile"></a> <!-- For old HTML links only ! -->
\subsection examples_tile tile \subsection examples_tile tile
\par \par
@ -617,7 +556,6 @@ The \c tile tool shows a nice way of using Fl_Tile.
To test correct resizing of subwindows, the widget for region To test correct resizing of subwindows, the widget for region
1 is created from an Fl_Window class. 1 is created from an Fl_Window class.
<a name="tiled_image"></a> <!-- For old HTML links only ! -->
\subsection examples_tiled_image tiled_image \subsection examples_tiled_image tiled_image
\par \par
@ -625,14 +563,12 @@ The \c tiled_image demo uses an image as the background
for a window by repeating it over the full size of the widget. for a window by repeating it over the full size of the widget.
The window is resizable and shows how the image gets repeated. The window is resizable and shows how the image gets repeated.
<a name="valuators"></a> <!-- For old HTML links only ! -->
\subsection examples_valuators valuators \subsection examples_valuators valuators
\par \par
\c valuators shows all of FLTK's nifty widgets to change \c valuators shows all of FLTK's nifty widgets to change
numeric values. numeric values.
<a name="fluid"></a> <!-- For old HTML links only ! -->
\subsection examples_fluid fluid \subsection examples_fluid fluid
\par \par

View File

@ -1470,7 +1470,6 @@ file to be used for all of the windows defined in your
The \b Set: field controls the set number in the catalog file. The \b Set: field controls the set number in the catalog file.
The default set is 1 and rarely needs to be changed. The default set is 1 and rarely needs to be changed.
<A NAME="limitations"> </A> <!-- For old HTML links only ! -->
\section fluid_limitations Known limitations \section fluid_limitations Known limitations
Declaration Blocks can be used to temporarily block out already Declaration Blocks can be used to temporarily block out already

View File

@ -285,9 +285,7 @@ native Presentation Manager version has not been implemented
yet (volunteers are welcome!). yet (volunteers are welcome!).
The current set of Makefiles/configuration failes assumes that EMX 0.9d The current set of Makefiles/configuration failes assumes that EMX 0.9d
and libExt (from and libExt (from http://posix2.sourceforge.net) is installed.
<A HREF="http://posix2.sourceforge.net">posix2.sourceforge.net</A>)
is installed.
To build the XFree86 version of FLTK for OS/2, copy the appropriate To build the XFree86 version of FLTK for OS/2, copy the appropriate
makeinclude and config files to the main directory and do a make: makeinclude and config files to the main directory and do a make:
@ -302,21 +300,19 @@ make
FLTK is available on the 'net in a bunch of locations: FLTK is available on the 'net in a bunch of locations:
\par WWW \par WWW
<A href="http://www.fltk.org/">http://www.fltk.org/</A> <BR> http://www.fltk.org/ <br>
<A href="http://www.fltk.org/str.php">http://www.fltk.org/str.php</A> http://www.fltk.org/str.php [for reporting bugs] <br>
[for reporting bugs]<BR> http://www.fltk.org/software.php [source code]
<A href="http://www.fltk.org/software.php">http://www.fltk.org/software.php</A>
[source code]
\par FTP \par FTP
<A HREF="ftp://ftp.fltk.org/pub/fltk">California, USA (ftp.fltk.org)</A><BR> ftp://ftp.fltk.org/pub/fltk [California, USA] <br>
<A HREF="ftp://ftp2.fltk.org/pub/fltk">Maryland, USA (ftp2.fltk.org)</A><BR> ftp://ftp2.fltk.org/pub/fltk [Maryland, USA] <br>
<A HREF="ftp://ftp.funet.fi/pub/mirrors/ftp.fltk.org/pub/fltk">Espoo, Finland (ftp.funet.fi)</A><BR> ftp://ftp.funet.fi/pub/mirrors/ftp.fltk.org/pub/fltk [Espoo, Finland] <br>
<A HREF="ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk">Germany (linux.mathematik.tu-darmstadt.de)</A><BR> ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk [Germany] <br>
<A HREF="ftp://gd.tuwien.ac.at/hci/fltk">Austria (gd.tuwien.ac.at)</A> ftp://gd.tuwien.ac.at/hci/fltk [Austria]
\par EMail \par EMail
<A href="mailto:fltk@fltk.org">fltk@fltk.org</A> [see instructions below]<BR> <A href="mailto:fltk@fltk.org">fltk@fltk.org</A> [see instructions below]<br>
<A href="mailto:fltk-bugs@fltk.org">fltk-bugs@fltk.org</A> [for reporting bugs] <A href="mailto:fltk-bugs@fltk.org">fltk-bugs@fltk.org</A> [for reporting bugs]
\par NNTP Newsgroups \par NNTP Newsgroups

View File

@ -163,7 +163,6 @@ Your main program can now create one of your windows by doing
You can also use your new window class in You can also use your new window class in
\ref fluid "FLUID" \ref fluid "FLUID"
<A href="fluid.html#FLUID">FLUID</A>
by: by:
-# Putting your class definition in a \p MyWindow.H file. -# Putting your class definition in a \p MyWindow.H file.
@ -259,7 +258,7 @@ void gl_font(Fl_Font fontid, int size)
\par \par
Sets the current OpenGL font to the same font you get by calling Sets the current OpenGL font to the same font you get by calling
<A href="drawing.html#fl_font"><tt>fl_font()</tt></A>. \ref ssect_Fonts "fl_font()".
int gl_height() <br> int gl_height() <br>
int gl_descent() <br> int gl_descent() <br>
@ -293,7 +292,7 @@ void gl_draw(const char *s, int x, int y, int w, int h, Fl_Align)
Draws a string formatted into a box, with newlines and tabs Draws a string formatted into a box, with newlines and tabs
expanded, other control characters changed to ^X, and aligned expanded, other control characters changed to ^X, and aligned
with the edges or center. Exactly the same output as with the edges or center. Exactly the same output as
<A href="drawing.html#text"><tt>fl_draw()</tt></A>. \ref ssect_Text "fl_draw()".
\section opengl_speed Speeding up OpenGL \section opengl_speed Speeding up OpenGL

View File

@ -41,8 +41,7 @@ This manual is organized into the following chapters and appendices:
\section preface_conventions Conventions \section preface_conventions Conventions
This manual was generated using Doxygen This manual was generated using Doxygen
(see <a href="http://www.stack.nl/~dimitri/doxygen/"> (see http://www.stack.nl/~dimitri/doxygen/)
http://www.stack.nl/~dimitri/doxygen/</a>)
to process the source code itself, special comments in the code, to process the source code itself, special comments in the code,
and additional documentation files. and additional documentation files.
In general, Doxygen recognizes and denotes the following entities as shown: In general, Doxygen recognizes and denotes the following entities as shown:
@ -50,10 +49,7 @@ In general, Doxygen recognizes and denotes the following entities as shown:
- methods, such as Fl_Widget::callback(Fl_Callback* cb, void* p), - methods, such as Fl_Widget::callback(Fl_Callback* cb, void* p),
- functions, such as fl_draw(const char *str, int x, int y), - functions, such as fl_draw(const char *str, int x, int y),
- internal links, such as \ref preface_conventions, - internal links, such as \ref preface_conventions,
- external links, such as - external links, such as http://www.stack.nl/~dimitri/doxygen/
<a href="http://www.stack.nl/~dimitri/doxygen/">
http://www.stack.nl/~dimitri/doxygen/
</a>
Other code samples and commands are shown in <tt>regular courier type</tt>. Other code samples and commands are shown in <tt>regular courier type</tt>.

View File

@ -188,7 +188,6 @@ Calling \p set_flag(SHORTCUT_LABEL) modifies the behavior of
\ref subclassing_draw_label "draw_label()" so that '\&' characters \ref subclassing_draw_label "draw_label()" so that '\&' characters
cause an underscore to be printed under the next letter. cause an underscore to be printed under the next letter.
<A name="clear_visible"></A> <!-- For old HTML links only ! -->
\anchor subclassing_clear_visible \anchor subclassing_clear_visible
\anchor subclassing_set_visible \anchor subclassing_set_visible
void Fl_Widget::set_visible() <br> void Fl_Widget::set_visible() <br>
@ -304,7 +303,6 @@ You must return non-zero if your \p handle() method
uses the event. If you return zero, the parent widget will try uses the event. If you return zero, the parent widget will try
sending the event to another widget. sending the event to another widget.
<A NAME="draw"></A> <!-- For old HTML links only ! -->
\section subclassing_drawing Drawing the Widget \section subclassing_drawing Drawing the Widget
The \p draw() virtual method is called when FLTK wants The \p draw() virtual method is called when FLTK wants