From 4c53a5d8f4f23358a101ef6bda4b6b8ea4b95274 Mon Sep 17 00:00:00 2001 From: Bill Spitzak Date: Sun, 31 Jan 1999 07:43:16 +0000 Subject: Added optimization for SGI builds (mike: please run autoconf before making a distribution). Documentation fixes. git-svn-id: file:///fltk/svn/fltk/trunk@259 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- documentation/Fl_Browser_.html | 2 ++ documentation/Fl_Float_Input.html | 4 ++-- documentation/Fl_Group.html | 38 +++++++++++++++++---------------- documentation/Fl_Int_Input.html | 4 ++-- documentation/Fl_Slider.html | 2 +- documentation/Fl_Valuator.html | 2 +- documentation/Fl_Value_Input.html | 4 ++-- documentation/Fl_Window.html | 16 +++++++++++++- documentation/basics.html | 44 +++++++++++++++++++++++--------------- documentation/common.html | 6 ++++-- documentation/drawing.html | 45 ++++++--------------------------------- documentation/enumerations.html | 23 +++++++++++--------- documentation/events.html | 1 + documentation/opengl.html | 30 +++++++++++++------------- documentation/subclassing.html | 38 ++++++++++++++++----------------- documentation/widgets.html | 4 ++-- 16 files changed, 133 insertions(+), 130 deletions(-) (limited to 'documentation') diff --git a/documentation/Fl_Browser_.html b/documentation/Fl_Browser_.html index 037fd211f..ad5c4ef1e 100644 --- a/documentation/Fl_Browser_.html +++ b/documentation/Fl_Browser_.html @@ -93,6 +93,7 @@ other slow operation.

+Sorry, documentation is incomplete at this time

Fl_Browser::Fl_Browser(int, int, int, int, const char * = 0)

@@ -131,4 +132,5 @@ browser. The first form gets the default text size for the lines in the browser.

The second form sets the default text size to size

+ \ No newline at end of file diff --git a/documentation/Fl_Float_Input.html b/documentation/Fl_Float_Input.html index fe52eadfe..00c1731f6 100644 --- a/documentation/Fl_Float_Input.html +++ b/documentation/Fl_Float_Input.html @@ -18,8 +18,8 @@

Description

The Fl_Float_Input class is a subclass of Fl_Input - that displays its input in red when the value string is not a legal -floating point value. + that only allows the user to type floating point numbers (sign, + digits, decimal point, more digits, 'E' or 'e', sign, digits).

Methods

Description

The Fl_Int_Input class is a subclass of Fl_Input - that displays its input in red when the value string is not a legal -integer value. + that only allows the user to type decimal digits (or hex numbers of + the form 0xaef).

Methods

 Microsoft Windows developers please note: case *is* significant under other operating systems, and the C standard uses the forward -slash (/) to separate directories. The following #include - directives are *not* recommended for portability reasons: +slash (/) to separate directories. Do not do any of the following:

Compiling Programs with Standard Compilers

@@ -75,7 +74,8 @@ display the window. int main(int argc, char **argv) { Fl_Window *window = new Fl_Window(300,180); - Fl_Box *box = new Fl_Box(FL_UP_BOX,20,40,260,100,"Hello, World!"); + Fl_Box *box = new Fl_Box(20,40,260,100,"Hello, World!"); + box->box(FL_UP_BOX); box->labelsize(36); box->labelfont(FL_BOLD+FL_ITALIC); box->labeltype(FL_SHADOW_LABEL); @@ -95,12 +95,13 @@ Fl_Window *window = new Fl_Window(300,180); and a box with the "Hello, World!" string in it: - Next, we set the size, font, and style of the label: + Next, we set the type of box and the size, font, and style of the label:

FLTK Drawing Functions

To use the drawing functions you must first include the @@ -33,7 +31,6 @@ drawing functions:
  • Complex Shapes
  • Text
  • Images
    • -
  • Cursor
  • Overlay

    • Clipping

    @@ -72,7 +69,7 @@ is completely outside the region. is not the X or WIN32 pixel, it is an index into an internal table! The table provides several general colors, a 24-entry gray ramp, and a 5x8x5 color cube. All of these are named with -symbols in +symbols in <FL/Enumerations.H>.

    For colormapped displays, a color cell will be allocated out of fl_colormap the first time you use a color. If the colormap fills @@ -144,9 +141,9 @@ w - 1 and h - 1.

    transformations. The functionality matches that found in Adobe® PostScriptTM. The exact pixels that are filled is less defined than for the previous calls so that FLTK can take advantage of drawing -hardware. The transformed vertices are rounded to integers before -drawing the line segments. This severely limits the accuracy of these -functions for complex graphics. Use OpenGL when greater accuracy +hardware. On both X and WIN32 the transformed vertices are rounded to integers before +drawing the line segments: this severely limits the accuracy of these +functions for complex graphics, so use OpenGL when greater accuracy and/or performance is required.

    void fl_push_matrix()
    void fl_pop_matrix()

    @@ -249,9 +246,8 @@ value points at a static buffer that is overwritten with each call. above. You may call this outside a draw context if necessary to call fl_width(), but on X this will open the display.

    The font is identified by a face and a size. The -size of the font is measured in pixels (i.e. it is not -"resolution [in]dependent"). Lines should be spaced size - pixels apart (or more).

    +size of the font is measured in pixels (not "points"). Lines + should be spaced size pixels apart (or more).

    The face is an index into an internal table. Initially only the first 16 faces are filled in. There are symbolic names for them: FL_HELVETICA, FL_TIMES, FL_COURIER, @@ -263,33 +259,6 @@ since it stores the index as a byte.


    int fl_size() Returns the face and size set by the most recent call to fl_font(a,b). This can be used to save/restore the font. -

    Cursor

    -

    void fl_cursor(Fl_Cursor, Fl_Color = FL_WHITE, Fl_Color = FL_BLACK)

    - Change the cursor. Depending on the system this may affect the cursor -everywhere, or only when it is pointing at the window that is current -when you call this. For portability you should change the cursor back -to the default in response to FL_LEAVE events. -

    The type Fl_Cursor is an enumeration defined in -<Enumerations.H>. The double-headed arrows are bitmaps -provided by FLTK on X, the others are provided by system-defined -cursors. Under X you can get any XC_cursor value by passing -Fl_Cursor((XC_foo/2)+1).

    -

    The following standard cursors are available:

    -

    Overlays

    void fl_overlay_rect(int x, int y, int w, int h)
    void fl_overlay_clear()

    diff --git a/documentation/enumerations.html b/documentation/enumerations.html index be8d012c7..4fe408d27 100644 --- a/documentation/enumerations.html +++ b/documentation/enumerations.html @@ -1,5 +1,5 @@ -

    C - FLTK Enumerations

    +

    C - FLTK Enumerations

    This appendix lists the enumerations provided in the <FL/Enumerations.H> header file, organized by section. Constants whose value is zero are marked with "(0)", this is often @@ -14,7 +14,7 @@ constants:
  • FL_VERSION - A combined floating-point version number for the major and minor release numbers, currently 1.0.
    • -

    Events

    +

    Events

    Events are identified by an Fl_Event enumeration value. The following events are currently defined: -

    Callback "When" Conditions

    +

    Callback "When" Conditions

    The following constants determine when a callback is performed: -

    Alignment Values

    +

    Alignment Values

    The following constants define bits that can be used with Fl_Widget::align() to control the positioning of the label: @@ -138,7 +138,7 @@ label: label inside the widget. -

    Fonts

    +

    Fonts

    The following constants define the standard FLTK fonts: -

    Colors

    +

    Colors

    The following color constants can be used to access the colors in the FLTK standard color palette: -

    void Fl_Group::draw_child(Fl_Widget&)

    +

    void Fl_Group::draw_child(Fl_Widget&)

    This will force the child's damage() bits all to one and call draw() on it, then clear the damage(). You should call this on all children if a total redraw of your widget is requested, or if you draw something (like a background box) that damages the child. Nothing is done if the child is not visible() or if it is clipped. -

    void -Fl_Group::draw_outside_label(Fl_Widget&) const

    +

    void +Fl_Group::draw_outside_label(Fl_Widget&) const

    Draw the labels that are not drawn by draw_label(). If you want more control over the label positions you might want to call child->draw_label(x,y,w,h,a). -

    void Fl_Group::update_child(Fl_Widget&)

    +

    void Fl_Group::update_child(Fl_Widget&)

    Draws the child only if its damage() is non-zero. You should call this on all the children if your own damage is equal to FL_DAMAGE_CHILD. Nothing is done if the child is not visible() @@ -377,7 +377,7 @@ can be useful if your widget wants to occupy an entire window, and can also be used to take advantage of system-provided clipping, or to work with a library that expects a system window ID to indicate where to draw. -

    Subclassing Fl_Window is almost exactly like subclassing +

    Subclassing Fl_Window is almost exactly like subclassing Fl_Widget, and in fact you can easily switch a subclass back and forth. Watch out for the following differences:

      diff --git a/documentation/widgets.html b/documentation/widgets.html index 78f1c93cc..bb8f825d4 100644 --- a/documentation/widgets.html +++ b/documentation/widgets.html @@ -76,6 +76,7 @@ see Appendix B.