Author: engelsman Date: 2009-06-27 13:40:48 -0700 (Sat, 27 Jun 2009) New Revision: 6799 Log: simplified old HTML anchors with name= and href= in all *.dox files. removed "old html link" section from development.dox
Modified: branches/branch-1.3/documentation/src/common.dox branches/branch-1.3/documentation/src/development.dox branches/branch-1.3/documentation/src/drawing.dox branches/branch-1.3/documentation/src/editor.dox branches/branch-1.3/documentation/src/enumerations.dox branches/branch-1.3/documentation/src/events.dox branches/branch-1.3/documentation/src/examples.dox branches/branch-1.3/documentation/src/fluid.dox branches/branch-1.3/documentation/src/intro.dox branches/branch-1.3/documentation/src/opengl.dox branches/branch-1.3/documentation/src/preface.dox branches/branch-1.3/documentation/src/subclassing.dox Modified: branches/branch-1.3/documentation/src/common.dox =================================================================== --- branches/branch-1.3/documentation/src/common.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/common.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -166,7 +166,6 @@ displayed you will have to call \p redraw() on the widget's parent. -<A NAME="colors"></A> <!-- For old HTML links only ! --> \section common_colors Colors FLTK stores the colors of widgets as an 32-bit unsigned @@ -215,7 +214,6 @@ button->labelcolor(FL_WHITE); \endcode -<A NAME="boxtypes"></A> <!-- For old HTML links only ! --> \section common_boxtypes Box Types The type Fl_Boxtype stored and returned in Fl_Widget::box() @@ -269,7 +267,6 @@ } \endcode -<A name="fl_down"></A> <!-- For old HTML links only ! --> \anchor common_fl_down Fl_Boxtype fl_down(Fl_Boxtype b) @@ -279,7 +276,6 @@ is undefined and some random box or frame is returned. See \ref drawing_fl_frame "Drawing Functions" for more details. -<A name="fl_frame"></A> <!-- For old HTML links only ! --> \anchor common_fl_frame Fl_Boxtype fl_frame(Fl_Boxtype b) @@ -289,8 +285,6 @@ is undefined and some random box or frame is returned. 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) \par @@ -323,7 +317,6 @@ \ref common_fl_frame "fl_frame(Fl_Boxtype)" 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 The \p label(), \p align(), \p labelfont(), \p labelsize(), @@ -375,7 +368,6 @@ \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). -<A NAME="labeltypes"></A> <!-- For old HTML links only ! --> \anchor common_labeltype \par labeltype() @@ -389,7 +381,6 @@ \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. -\anchor common_image_deimage \par image() and deimage() The \p image() and \p deimage() methods set an image that @@ -466,7 +457,6 @@ The Fl::set_labeltype() method can also be used to overload 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 It is also possible to define your own drawings and add Modified: branches/branch-1.3/documentation/src/development.dox =================================================================== --- branches/branch-1.3/documentation/src/development.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/development.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -251,98 +251,38 @@ \section development_links Creating Links Links to other documents and external links can be embedded with - \li normal HTML links - \li HTML links without markup - doxygen creates "http://..."; - links automatically - \li links to other doxygen chapters with the \\ref statments - \li links to named sections within the same or other doxygen chapters, - if they are defined there with a \\section statement +- doxygen \\ref links to other doxygen \\page, \\section, + \\subsection and \\anchor locations +- HTML links without markup - doxygen creates "http://..."; + links automatically +- standard, non-Doxygen, HTML links + \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 - a link to a named html anchor "character_encoding" within the same file. +- see chapter \ref unicode creates a link to the named chapter + 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 - Bold link text: you can see the <b>online documentation</b> - of FLTK 1.3 at \b http://www.fltk.org/doc-1.3/index.html - - see section \ref development_non-ascii +- see <a href="http://www.nedit.org/";>Nedit</a> creates + a standard HTML link + \endcode appears as: - see chapter \ref unicode creates a link to the named chapter unicode - that has been created with a \\subpage statement. +- see chapter \ref unicode creates a link to the named chapter + unicode that has been created with a \\page statement. - see <a href="drawing.html#character_encoding">chapter 5</a> creates - a link to a named html anchor "character_encoding" within the same file. - - For further informations about quoting see +- For further informations about quoting see http://www.stack.nl/~dimitri/doxygen/htmlcmds.html - Bold link text: you can see the <b>online documentation</b> - of FLTK 1.3 at \b http://www.fltk.org/doc-1.3/index.html - - see section \ref development_non-ascii +- see <a href="http://www.nedit.org/";>Nedit</a> creates + a standard HTML link -\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 There is no real need to use HTML \<P\> and \</P\> tags within the text @@ -421,21 +361,11 @@ elements must only be included in the html documentation, therefore 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> -<a class="el" href="migration_1_3.html">[Previous] Migrating Code from FLTK 1.1 to 1.3</a> -<a class="el" href="license.html">[Next] Software License</a> -\endhtmlonly -\endverbatim - -Now replaced by: -\verbatim -\htmlonly -<hr> <table summary="navigation bar" width="100%" border="0"> <tr> <td width="45%" align="LEFT"> Modified: branches/branch-1.3/documentation/src/drawing.dox =================================================================== --- branches/branch-1.3/documentation/src/drawing.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/drawing.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -44,22 +44,18 @@ \li \ref ssect_Fl_Image \li \ref ssect_Offscreen -<A name="boxdraw"></A> <!-- For old HTML links only ! --> \subsection ssect_Boxes Boxes 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 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); \par The \p %fl_draw_box() function draws a standard boxtype \p b 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 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) @@ -86,7 +82,6 @@ is described in the \ref common_boxtypes section. -<A name="clipping"></A> <!-- For old HTML links only ! --> \subsection ssect_Clipping Clipping You can limit all your drawing to a rectangular region by calling @@ -98,7 +93,6 @@ In addition, the system may provide clipping when updating windows 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_clip(int x, int y, int w, int h) @@ -110,13 +104,11 @@ The \p %fl_clip() version is deprecated and will be removed from future releases. -<A NAME="fl_push_no_clip"></A> <!-- For old HTML links only ! --> void fl_push_no_clip() \par 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() \par @@ -129,7 +121,6 @@ If you return to FLTK with the clip stack not empty unpredictable results occur. -<A NAME="fl_not_clipped"></A> <!-- For old HTML links only ! --> int fl_not_clipped(int x, int y, int w, int h) \par @@ -141,7 +132,6 @@ Under X this returns 2 if the rectangle is partially clipped, 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) \par @@ -152,7 +142,6 @@ necessary drawing to a rectangle. \c W and \c H are 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> Fl_Region fl_clip_region() @@ -162,7 +151,6 @@ the current clipping region. -<A NAME="colors"></A> <!-- For old HTML links only ! --> \section drawing_colors Colors FLTK manages colors as 32-bit unsigned integers. Values from @@ -182,7 +170,6 @@ fl_rgb_color(uchar grayscale) functions. -<A name="fl_color"></A> <!-- For old HTML links only ! --> void fl_color(Fl_Color c) <br> void fl_color(int c) @@ -211,7 +198,6 @@ is used directly on TrueColor displays. For colormap visuals the 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 FLTK supports drawing of lines with different styles and @@ -219,7 +205,6 @@ and Me due to the reduced drawing functionality these operating systems provide. -<A NAME="fl_line_style"></A> <!-- For old HTML links only ! --> void fl_line_style(int style, int width, char* dashes) \par @@ -272,7 +257,6 @@ operating systems do not support complex line styles. -<A name="fast"></A> <!-- For old HTML links only ! --> \subsection ssect_Fast Drawing Fast Shapes These functions are used to draw almost all the FLTK widgets. @@ -283,13 +267,11 @@ so you should only call these while the matrix is set to the identity matrix (the default). -<A NAME="fl_point"></A> <!-- For old HTML links only ! --> void fl_point(int x, int y) \par 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) @@ -305,35 +287,30 @@ \ref drawing_fl_draw_image "fl_draw_image()" 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, Fl_Color c) \par 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, int x2, int y2) \par 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, int x3, int y3) \par 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, int x3, int y3) \par 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, int y2) <br> void fl_xyline(int x, int y, int x1, int y2, int x3) @@ -342,7 +319,6 @@ Draw horizontal and vertical lines. A horizontal line is 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, int x2) <br> void fl_yxline(int x, int y, int y1, int x2, int y3) @@ -351,7 +327,6 @@ Draw vertical and horizontal lines. A vertical line is drawn 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_pie(int x, int y, int w, int h, double a1, double a2) @@ -386,7 +361,6 @@ \todo 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) \par @@ -396,7 +370,6 @@ exposed rectangular area, -<A name="complex"></A> <!-- For old HTML links only ! --> \subsection ssect_Complex Drawing Complex Shapes The complex drawing functions let you draw arbitrary shapes @@ -410,7 +383,6 @@ graphics, so use OpenGL when greater accuracy and/or performance is required. -<A NAME="fl_push_matrix"></A> <!-- For old HTML links only ! --> void fl_push_matrix() <br> void fl_pop_matrix() @@ -418,7 +390,6 @@ Save and restore the current transformation. The maximum 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) <br> void fl_translate(double x,double y) <br> @@ -429,7 +400,6 @@ Concatenate another transformation onto the current one. The rotation 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_y(double x, double y) <br> double fl_transform_dx(double x, double y) <br> @@ -441,7 +411,6 @@ After transforming a coordinate pair, it can be added to the 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_end_points() @@ -449,28 +418,24 @@ Start and end drawing a list of points. Points are added to the list with \p %fl_vertex(). -<A NAME="fl_begin_line"></A> <!-- For old HTML links only ! --> void fl_begin_line() <br> void fl_end_line() \par Start and end drawing lines. -<A NAME="fl_begin_loop"></A> <!-- For old HTML links only ! --> void fl_begin_loop() <br> void fl_end_loop() \par 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_end_polygon() \par 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_gap() <br> void fl_end_complex_polygon() @@ -498,20 +463,17 @@ "even/odd" or "non-zero" winding rules are used to fill them. Holes should 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) \par 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) \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>. -<A NAME="fl_arc"></A> <!-- For old HTML links only ! --> \anchor drawing_fl_arc void fl_arc(double x, double y, double r, double start, double end) @@ -527,7 +489,6 @@ If \p end is less than \p start then it draws the arc in a clockwise direction. -<A NAME="fl_circle"></A> <!-- For old HTML links only ! --> void fl_circle(double x, double y, double r) \par @@ -540,7 +501,6 @@ \p %fl_circle() draws incorrectly if the transformation is both rotated and non-square scaled. -<A name="text"></A> <!-- For old HTML links only ! --> \subsection ssect_Text Drawing Text All text is drawn in the @@ -548,7 +508,6 @@ It is undefined whether this location or the characters are 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 n, int x, int y) @@ -586,7 +545,6 @@ \par 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) \par @@ -594,23 +552,19 @@ the \p fl_draw(...align) function. 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() \par Recommended minimum line spacing for the current font. You can also just use the value of \p size passed to \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() \par 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. -<A NAME="fl_width"></A> <!-- For old HTML links only ! --> double fl_width(const char* txt) <br> double fl_width(const char* txt, int n) <br> double fl_width(Fl_Unichar) @@ -619,7 +573,6 @@ Return the pixel width of a nul-terminated string, a sequence of \p n 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) \par @@ -630,7 +583,6 @@ return value points at a static buffer that is overwritten with each call. -<A name="fonts"></A> <!-- For old HTML links only ! --> \subsection ssect_Fonts Fonts FLTK supports a set of standard fonts based on the Times, @@ -646,7 +598,6 @@ Faces greater than 255 cannot be used in Fl_Widget labels, since Fl_Widget stores the index as a byte. -<A name="fl_font"></A> <!-- For old HTML links only ! --> \anchor drawing_fl_font void fl_font(int face, int size) @@ -661,7 +612,6 @@ The size of the font is measured in \p pixels and not "points". 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_size() @@ -669,7 +619,6 @@ 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. -<A NAME="character_encoding"></A> <!-- For old HTML links only ! --> \subsection ssect_CharacterEncoding Character Encoding \todo @@ -709,16 +658,15 @@ \todo drawing.dox: I fixed the above encoding problem of these \¸ 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) 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. -For more information about character encoding, unicode and utf-8 -see chapter \ref unicode. +For more information about character encodings, see the chapter on +\ref unicode. -<A name="overlay"></A> <!-- For old HTML links only ! --> \subsection ssect_Overlay Drawing Overlays These functions allow you to draw interactive selection rectangles @@ -744,7 +692,6 @@ FL_RELEASE event. -<A NAME="images"></A> <!-- For old HTML links only ! --> \section drawing_images Drawing Images To draw images, you can either do it directly from data in @@ -761,7 +708,6 @@ transformation matrix is not the identity is not defined, so you 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 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) @@ -844,7 +790,6 @@ If \p D is 4 or more, you must fill in the unused bytes 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(const char* const* cdata, int x, int y, Fl_Color bg) @@ -868,7 +813,6 @@ Fl_Color argument. To draw with true transparency you must 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(const char* const* cdata, int &w, int &h) @@ -883,7 +827,6 @@ FLTK provides a single function for reading from the current 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) \par @@ -899,7 +842,6 @@ channel is created and the value that is placed in the alpha channel. If 0, no alpha channel is generated. -<A name="Fl_Image"></A> <!-- For old HTML links only ! --> \subsection ssect_Fl_Image Image Classes FLTK provides a base image class called Fl_Image which supports @@ -930,7 +872,6 @@ blend against the existing window contents or a "screen door" 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() \par @@ -982,7 +923,6 @@ 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). -<A NAME="offscreen"></A> <!-- For old HTML links only ! --> \subsection ssect_Offscreen Offscreen Drawing \todo @@ -995,19 +935,16 @@ to avoid flickering on systems that don't support double-buffering natively. -<A NAME="fl_create_offscreen"></A> <!-- For old HTML links only ! --> Fl_Offscreen fl_create_offscreen(int w, int h) \par 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) \par 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) \par @@ -1015,13 +952,11 @@ FLTK can draw into a buffer at any time. There is no need to wait for an Fl_Widget::draw() to occur. -<A NAME="fl_end_offscreen"></A> <!-- For old HTML links only ! --> void fl_end_offscreen() \par 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, Fl_Offscreen osrc, int srcx, int srcy) Modified: branches/branch-1.3/documentation/src/editor.dox =================================================================== --- branches/branch-1.3/documentation/src/editor.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/editor.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -621,7 +621,7 @@ of text with different fonts, colors, and sizes. The implementation is based on the excellent <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 size of the text that is drawn. Modified: branches/branch-1.3/documentation/src/enumerations.dox =================================================================== --- branches/branch-1.3/documentation/src/enumerations.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/enumerations.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -248,8 +248,7 @@ \ref drawing_colors section of the \ref drawing -chapter, or in the generated -<a href="functions_func.html">Function Reference</A> pages. +chapter. \section enumerations_cursors Cursors @@ -305,7 +304,7 @@ <td width="45%" align="LEFT"> <a class="el" href="unicode.html"> [Prev] - Unicode and utf-8 Support + Unicode and UTF-8 Support </a> </td> <td width="10%" align="CENTER"> Modified: branches/branch-1.3/documentation/src/events.dox =================================================================== --- branches/branch-1.3/documentation/src/events.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/events.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -261,7 +261,6 @@ claimed the selection. Motif programs used this to clear the selection indication. Most modern programs ignore this. -<A NAME="dnd"></A> <!-- For old HTML links only ! --> \section events_dnd Drag and Drop Events FLTK supports drag and drop of text and files from any @@ -303,7 +302,6 @@ <!-- NEED 6in --> -<A NAME="event_xxx"></A> <!-- For old HTML links only ! --> \section events_event_xxx Fl::event_*() methods FLTK keeps the information about the most recent event in @@ -334,7 +332,6 @@ \li Fl::get_mouse() \li Fl::test_shortcut() -<A NAME="event_xxx"></A> <!-- For old HTML links only ! --> \section events_propagation Event Propagation FLTK follows very simple and unchangeable rules for sending @@ -369,7 +366,6 @@ \li Fl::release() \li Fl_Widget::take_focus() -<A name="compose"></A> <!-- For old HTML links only ! --> \section events_compose_characters FLTK Compose-Character Sequences \todo Does Fltk Compose Character Sequences text need updating Modified: branches/branch-1.3/documentation/src/examples.dox =================================================================== --- branches/branch-1.3/documentation/src/examples.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/examples.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -106,14 +106,12 @@ </tr> </table> -<a name="adjuster"></a> <!-- For old HTML links only ! --> \subsection examples_adjuster adjuster \par \c adjuster shows a nifty little widget for quickly setting values in a great range. -<a name="arc"></a> <!-- For old HTML links only ! --> \subsection examples_arc arc \par @@ -121,7 +119,6 @@ generate some custom drawings. The sample drawings use the matrix based arc drawing for some fun effects. -<a name="ask"></a> <!-- For old HTML links only ! --> \subsection examples_ask ask \par @@ -129,7 +126,6 @@ the correct answers or you may end up in a loop, or you may end up in a loop, or you... . -<a name="bitmap"></a> <!-- For old HTML links only ! --> \subsection examples_bitmap bitmap \par @@ -137,7 +133,6 @@ label for a box widget. Bitmaps are stored in the X11 '.bmp' file format and can be part of the source code. -<a name="blocks"></a> <!-- For old HTML links only ! --> \subsection examples_blocks blocks \par @@ -146,7 +141,6 @@ \c blocks is also a good example for the Mac OS X specific bundle format. -<a name="boxtype"></a> <!-- For old HTML links only ! --> \subsection examples_boxtype boxtype \par @@ -155,7 +149,6 @@ When using themes, FLTK shuffles boxtypes around to give your program a new look. -<a name="browser"></a> <!-- For old HTML links only ! --> \subsection examples_browser browser \par @@ -163,19 +156,16 @@ Important features tested are loading of files, line formatting, and correct positioning of the browser data window. -<a name="button"></a> <!-- For old HTML links only ! --> \subsection examples_button button \par 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 \par \c buttons shows a sample of FLTK button types. -<a name="checkers"></a> <!-- For old HTML links only ! --> \subsection examples_checkers checkers \par @@ -185,7 +175,6 @@ pieces, and how the pieces are drawn by layering. Then tell me how to beat the computer at Checkers. -<a name="clock"></a> <!-- For old HTML links only ! --> \subsection examples_clock clock \par @@ -193,7 +182,6 @@ the Fl_Clock widget are pretty interesting, explaining the use of timeouts and matrix based drawing. -<a name="colbrowser"></a> <!-- For old HTML links only ! --> \subsection examples_colbrowser colbrowser \par @@ -202,14 +190,12 @@ of every text entry in the file. This is beautiful, but 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 \par The \c color_chooser gives a short demo of FLTK's palette based color chooser and of the RGB based color wheel. -<a name="cube"></a> <!-- For old HTML links only ! --> \subsection examples_cube cube \par @@ -217,13 +203,11 @@ the ability to render two OpenGL buffers into a single window, and shows OpenGL text. -<a name="CubeView"></a> <!-- For old HTML links only ! --> \subsection examples_CubeView CubeView \par \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 \par @@ -231,14 +215,12 @@ with FLTK. The <i>fgcolor</i> and <i>bgcolor</i> sliders work only on few systems (some version of Irix for example). -<a name="curve"></a> <!-- For old HTML links only ! --> \subsection examples_curve curve \par \c curve draws a nice Bezier curve into a custom widget. The <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 \par @@ -246,7 +228,6 @@ \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>. -<a name="doublebuffer"></a> <!-- For old HTML links only ! --> \subsection examples_doublebuffer doublebuffer \par @@ -257,7 +238,6 @@ to allow transparency and shadows on the desktop. FLTK is smart enough to not tripple buffer a window in that case. -<a name="editor"></a> <!-- For old HTML links only ! --> \subsection examples_editor editor \par @@ -267,14 +247,12 @@ The \c editor test is almost a full application, showing custom syntax highlighting and dialog creation. -<a name="fast_slow"></a> <!-- For old HTML links only ! --> \subsection examples_fast_slow fast_slow \par \c fast_slow shows how an application can use the Fl_Widget::when() setting to receive different kinds of callbacks. -<a name="file_chooser"></a> <!-- For old HTML links only ! --> \subsection examples_file_chooser file_chooser \par @@ -282,7 +260,6 @@ iterations, trying to find a middle ground between a complex browser and a fast light implementation. -<a name="fonts"></a> <!-- For old HTML links only ! --> \subsection examples_fonts fonts \par @@ -291,7 +268,6 @@ sizes will be shown in bold face. Only the first 256 fonts will be listed. -<a name="forms"></a> <!-- For old HTML links only ! --> \subsection examples_forms forms \par @@ -300,7 +276,6 @@ This demo shows the different boxtypes. Note that some boxtypes are not appropriate for some objects. -<a name="fractals"></a> <!-- For old HTML links only ! --> \subsection examples_fractals fractals \par @@ -308,7 +283,6 @@ FLTK supports a rather large subset of Glut, so that many Glut applications compile just fine. -<a name="fullscreen"></a> <!-- For old HTML links only ! --> \subsection examples_fullscreen fullscreen \par @@ -318,7 +292,6 @@ and double-buffered rendering, and take over the entire screen. More information in the source code. -<a name="gl_overlay"></a> <!-- For old HTML links only ! --> \subsection examples_gl_overlay gl_overlay \par @@ -326,14 +299,12 @@ hardware overlay plane is available, FLTK will simulate it for you. -<a name="glpuzzle"></a> <!-- For old HTML links only ! --> \subsection examples_glpuzzle glpuzzle \par The \c glpuzzle test shows how most Glut source code compiles easily under FLTK. -<a name="hello"></a> <!-- For old HTML links only ! --> \subsection examples_hello hello \par @@ -341,7 +312,6 @@ tiny demo shows how little is needed to get a functioning application running with FLTK. Quite impressive, I'd say. -<a name="help"></a> <!-- For old HTML links only ! --> \subsection examples_help help \par @@ -351,14 +321,12 @@ pages to the user without depending on the operating system's html browser. -<a name="iconize"></a> <!-- For old HTML links only ! --> \subsection examples_iconize iconize \par \c iconize demonstrates the effect of the window functions hide(), iconize(), and show(). -<a name="image"></a> <!-- For old HTML links only ! --> \subsection examples_image image \par @@ -367,7 +335,6 @@ lets previous renderings 'shine through', either via true transparency or by using screen door transparency (pixelation). -<a name="inactive"></a> <!-- For old HTML links only ! --> \subsection examples_inactive inactive \par @@ -375,7 +342,6 @@ To see the inactive version of images, you can check out the pixmap or image test. -<a name="input"></a> <!-- For old HTML links only ! --> \subsection examples_input input \par @@ -383,7 +349,6 @@ Fl_Input_. The \c input program also tests various settings of Fl_Input::when(). -<a name="input_choice"></a> <!-- For old HTML links only ! --> \subsection examples_input_choice input_choice \par @@ -392,7 +357,6 @@ similarities to the 'ComboBox'. \c input_choice starts up in 'plastic' scheme, but the traditional scheme is also supported. -<a name="keyboard"></a> <!-- For old HTML links only ! --> \subsection examples_keyboard keyboard \par @@ -402,7 +366,6 @@ buttons and the scroll wheel at work. Quit this application by closing the window. The ESC key will not work. -<a name="label"></a> <!-- For old HTML links only ! --> \subsection examples_label label \par @@ -411,14 +374,12 @@ can contain symbols at the start and end of the text, like <i>\...@fltk</i> or <i>\...@circle uh-huh \...@square</i>. -<a name="line_style"></a> <!-- For old HTML links only ! --> \subsection examples_line_style line_style \par Advanced line drawing can be tested with \c line_style. Not all platforms support all line styles. -<a name="list_visuals"></a> <!-- For old HTML links only ! --> \subsection examples_list_visuals list_visuals \par @@ -426,7 +387,6 @@ screen. But since you are now an FLTK user, you don't have to worry about any of this. -<a name="mandelbrot"></a> <!-- For old HTML links only ! --> \subsection examples_mandelbrot mandelbrot \par @@ -436,7 +396,6 @@ is very useful by giving all available processor time to the application without blocking the UI or other apps. -<a name="menubar"></a> <!-- For old HTML links only ! --> \subsection examples_menubar menubar \par @@ -444,13 +403,11 @@ Among the features are radio buttons, menus taller than the screen, arbitrary sub menu depth, and global shortcuts. -<a name="message"></a> <!-- For old HTML links only ! --> \subsection examples_message message \par \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 \par @@ -459,14 +416,12 @@ be avoided by choosing a smaller label or by setting label clipping differently. -<a name="navigation"></a> <!-- For old HTML links only ! --> \subsection examples_navigation navigation \par \c navigation demonstrates how the text cursor moves from 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 \par @@ -474,7 +429,6 @@ multi line mode of the Fl_Output widget. Fonts can be selected from the FLTK standard list of fonts. -<a name="overlay"></a> <!-- For old HTML links only ! --> \subsection examples_overlay overlay \par @@ -483,7 +437,6 @@ example derives a new class from Fl_Overlay_Window and provides a new function to draw custom overlays. -<a name="pack"></a> <!-- For old HTML links only ! --> \subsection examples_pack pack \par @@ -492,7 +445,6 @@ Putting an Fl_Pack into an Fl_Scroll is 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 \par @@ -500,7 +452,6 @@ the same image multiple times, Fl_Shared_Image will keep it only once in memory. -<a name="pixmap"></a> <!-- For old HTML links only ! --> \subsection examples_pixmap pixmap \par @@ -509,7 +460,6 @@ file format and can be part of the source code. Pixmaps support one transparent color. -<a name="preferences"></a> <!-- For old HTML links only ! --> \subsection examples_preferences preferences \par @@ -517,7 +467,6 @@ just can't remember a thing. This is where the Fl_Preferences 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 \par @@ -525,21 +474,18 @@ shows some of the available button types and tests radio button behavior. -<a name="resizebox"></a> <!-- For old HTML links only ! --> \subsection examples_resizebox resizebox \par \c resizebox shows some possible ways of FLTK's automatic resize bahavior.. -<a name="resize"></a> <!-- For old HTML links only ! --> \subsection examples_resize resize \par The \c resize demo tests size and position functions with the given window manager. -<a name="scroll"></a> <!-- For old HTML links only ! --> \subsection examples_scroll scroll \par @@ -549,7 +495,6 @@ The buttons at the bottom of the window control decoration rendering and updates. -<a name="shape"></a> <!-- For old HTML links only ! --> \subsection examples_shape shape \par @@ -557,7 +502,6 @@ your own OpenGL rendering widget. Now that you know that, go ahead and write that flight simulator you always dreamt of. -<a name="subwindow"></a> <!-- For old HTML links only ! --> \subsection examples_subwindow subwindow \par @@ -567,7 +511,6 @@ top left corner. On Win32 and X11, subwindows have their own operating system specific handle. -<a name="sudoku"></a> <!-- For old HTML links only ! --> \subsection examples_sudoku sudoku \par @@ -575,7 +518,6 @@ The implementation shows how to create application icons, how to deal with OS specifics, and how to generate sound. -<a name="symbols"></a> <!-- For old HTML links only ! --> \subsection examples_symbols symbols \par @@ -585,7 +527,6 @@ number refers to 45 degree rotations if you were looking at a numeric keypad (2 is down, 6 is right, etc.). -<a name="tabs"></a> <!-- For old HTML links only ! --> \subsection examples_tabs tabs \par @@ -598,7 +539,6 @@ on the left and the Fl_Wizard widget on the right side for direct comparison of these two panel management widgets. -<a name="threads"></a> <!-- For old HTML links only ! --> \subsection examples_threads threads \par @@ -609,7 +549,6 @@ to keep FLTK happy. Although locking works on all platforms, this demo is not available on every machine. -<a name="tile"></a> <!-- For old HTML links only ! --> \subsection examples_tile tile \par @@ -617,7 +556,6 @@ To test correct resizing of subwindows, the widget for region 1 is created from an Fl_Window class. -<a name="tiled_image"></a> <!-- For old HTML links only ! --> \subsection examples_tiled_image tiled_image \par @@ -625,14 +563,12 @@ for a window by repeating it over the full size of the widget. The window is resizable and shows how the image gets repeated. -<a name="valuators"></a> <!-- For old HTML links only ! --> \subsection examples_valuators valuators \par \c valuators shows all of FLTK's nifty widgets to change numeric values. -<a name="fluid"></a> <!-- For old HTML links only ! --> \subsection examples_fluid fluid \par Modified: branches/branch-1.3/documentation/src/fluid.dox =================================================================== --- branches/branch-1.3/documentation/src/fluid.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/fluid.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -1470,7 +1470,6 @@ The \b Set: field controls the set number in the catalog file. 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 Declaration Blocks can be used to temporarily block out already Modified: branches/branch-1.3/documentation/src/intro.dox =================================================================== --- branches/branch-1.3/documentation/src/intro.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/intro.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -285,9 +285,7 @@ yet (volunteers are welcome!). The current set of Makefiles/configuration failes assumes that EMX 0.9d -and libExt (from -<A HREF="http://posix2.sourceforge.net";>posix2.sourceforge.net</A>) -is installed. +and libExt (from http://posix2.sourceforge.net) is installed. 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: @@ -302,21 +300,19 @@ FLTK is available on the 'net in a bunch of locations: \par WWW -<A href="http://www.fltk.org/";>http://www.fltk.org/</A> <BR> -<A href="http://www.fltk.org/str.php";>http://www.fltk.org/str.php</A> - [for reporting bugs]<BR> -<A href="http://www.fltk.org/software.php";>http://www.fltk.org/software.php</A> - [source code] +http://www.fltk.org/ <br> +http://www.fltk.org/str.php [for reporting bugs] <br> +http://www.fltk.org/software.php [source code] \par FTP -<A HREF="ftp://ftp.fltk.org/pub/fltk";>California, USA (ftp.fltk.org)</A><BR> -<A HREF="ftp://ftp2.fltk.org/pub/fltk";>Maryland, USA (ftp2.fltk.org)</A><BR> -<A HREF="ftp://ftp.funet.fi/pub/mirrors/ftp.fltk.org/pub/fltk";>Espoo, Finland (ftp.funet.fi)</A><BR> -<A HREF="ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk";>Germany (linux.mathematik.tu-darmstadt.de)</A><BR> -<A HREF="ftp://gd.tuwien.ac.at/hci/fltk";>Austria (gd.tuwien.ac.at)</A> +ftp://ftp.fltk.org/pub/fltk [California, USA] <br> +ftp://ftp2.fltk.org/pub/fltk [Maryland, USA] <br> +ftp://ftp.funet.fi/pub/mirrors/ftp.fltk.org/pub/fltk [Espoo, Finland] <br> +ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk [Germany] <br> +ftp://gd.tuwien.ac.at/hci/fltk [Austria] \par EMail -<A href="mailto:[email protected]";>[email protected]</A> [see instructions below]<BR> +<A href="mailto:[email protected]";>[email protected]</A> [see instructions below]<br> <A href="mailto:[email protected]";>[email protected]</A> [for reporting bugs] \par NNTP Newsgroups Modified: branches/branch-1.3/documentation/src/opengl.dox =================================================================== --- branches/branch-1.3/documentation/src/opengl.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/opengl.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -163,7 +163,6 @@ You can also use your new window class in \ref fluid "FLUID" -<A href="fluid.html#FLUID">FLUID</A> by: -# Putting your class definition in a \p MyWindow.H file. @@ -259,7 +258,7 @@ \par 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_descent() <br> @@ -293,7 +292,7 @@ Draws a string formatted into a box, with newlines and tabs expanded, other control characters changed to ^X, and aligned 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 Modified: branches/branch-1.3/documentation/src/preface.dox =================================================================== --- branches/branch-1.3/documentation/src/preface.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/preface.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -41,8 +41,7 @@ \section preface_conventions Conventions This manual was generated using Doxygen -(see <a href="http://www.stack.nl/~dimitri/doxygen/";> -http://www.stack.nl/~dimitri/doxygen/</a>) +(see http://www.stack.nl/~dimitri/doxygen/) to process the source code itself, special comments in the code, and additional documentation files. In general, Doxygen recognizes and denotes the following entities as shown: @@ -50,10 +49,7 @@ - methods, such as Fl_Widget::callback(Fl_Callback* cb, void* p), - functions, such as fl_draw(const char *str, int x, int y), - internal links, such as \ref preface_conventions, -- external links, such as - <a href="http://www.stack.nl/~dimitri/doxygen/";> - http://www.stack.nl/~dimitri/doxygen/ - </a> +- external links, such as http://www.stack.nl/~dimitri/doxygen/ Other code samples and commands are shown in <tt>regular courier type</tt>. Modified: branches/branch-1.3/documentation/src/subclassing.dox =================================================================== --- branches/branch-1.3/documentation/src/subclassing.dox 2009-06-27 16:39:36 UTC (rev 6798) +++ branches/branch-1.3/documentation/src/subclassing.dox 2009-06-27 20:40:48 UTC (rev 6799) @@ -188,7 +188,6 @@ \ref subclassing_draw_label "draw_label()" so that '\&' characters 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_set_visible void Fl_Widget::set_visible() <br> @@ -304,7 +303,6 @@ uses the event. If you return zero, the parent widget will try sending the event to another widget. -<A NAME="draw"></A> <!-- For old HTML links only ! --> \section subclassing_drawing Drawing the Widget The \p draw() virtual method is called when FLTK wants _______________________________________________ fltk-commit mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-commit
