From a6163888f3c56123b1db313743c6147ba498732c Mon Sep 17 00:00:00 2001
From: Yuval Adam The Fl class is the FLTK global (static) class containing
+state information and global methods for the current application. FLTK will call this callback just before it flushes the display and
+waits for events. This is different than an idle callback because it
+is only called once, then FLTK calls the system and tells it not to
+return until an event happens.
+
+ This can be used by code that wants to monitor the
+application's state, such as to keep a display up to date. The
+advantage of using a check callback is that it is called only when no
+events are pending. If events are coming in quickly, whole blocks of
+them will be processed before this is called once. This can save
+significant time and avoid the application falling behind the events.
+
+ Sample code:
+
+ Add file descriptor fd to listen to. When the fd
+becomes ready for reading Fl::wait() will call the callback
+and then return. The callback is
+passed the fd and the arbitrary void* argument. The second version takes a when bitfield, with the bits
+FL_READ, FL_WRITE, and FL_EXCEPT defined,
+to indicate when the callback should be done.
+
+ There can only be one callback of each type for a file descriptor.
+Fl::remove_fd() gets rid of all the callbacks for a given
+file descriptor.
+
+ Under UNIX any file descriptor can be monitored (files,
+devices, pipes, sockets, etc.) Due to limitations in Microsoft Windows,
+WIN32 applications can only monitor sockets.
+
+ Install a function to parse unrecognized events. If FLTK cannot
+figure out what to do with an event, it calls each of these functions
+(most recent first) until one of them returns non-zero. If none of
+them returns non zero then the event is ignored. Events that cause
+this to be called are:
+
+ Adds a callback function that is called every time by
+Fl::wait() and also makes it act as though the timeout is
+zero (this makes Fl::wait() return immediately, so if it is
+in a loop it is called repeatedly, and thus the idle fucntion is
+called repeatedly). The idle function can be used to get background
+processing done.
+
+ You can have multiple idle callbacks. To remove an idle callback use Fl::remove_idle().
+
+ Fl::wait() and Fl::check() call idle callbacks,
+but Fl::ready() does not.
+
+ The idle callback can call any FLTK functions, including
+Fl::wait(), Fl::check(), and Fl::ready().
+FLTK will not recursively call the idle callback.
+
+ Add a one-shot timeout callback. The function will be called by
+Fl::wait() at t seconds after this function is called.
+The optional void* argument is passed to the callback.
+
+ You can have multiple timeout callbacks. To remove an timeout
+callback use Fl::remove_timeout().
+
+ If you need more accurate, repeated timeouts, use Fl::repeat_timeout() to
+reschedule the subsequent timeouts. The following code will print "TICK" each second on
+stdout with a fair degree of accuracy: Consume a single switch from argv, starting at word i.
+Returns the number of words eaten (1 or 2, or 0 if it is not
+recognized) and adds the same value to i. You can use this
+function if you prefer to control the incrementing through the
+arguments yourself.
+
+ FLTK provides an entirely optional command-line switch parser.
+You don't have to call it if you don't like them! Everything it can do
+can be done with other calls to FLTK.
+
+ To use the switch parser, call Fl::args(...) near the start
+of your program. This does not open the display, instead
+switches that need the display open are stashed into static variables.
+Then you must display your first window by calling
+window->show(argc,argv), which will do anything stored in the
+static variables.
+
+ callback lets you define your own switches. It is called
+with the same argc and argv, and with i the
+index of each word. The callback should return zero if the switch is
+unrecognized, and not change i. It should return non-zero if
+the switch is recognized, and add at least 1 to i (it can add
+more to consume words after the switch). This function is called
+before any other tests, so you can override any FLTK
+switch (this is why FLTK can use very short switches instead of
+the long ones all other toolkits force you to use).
+
+ On return i is set to the index of the first non-switch.
+This is either:
+
+ The return value is i unless an unrecognized switch is found,
+in which case it is zero. If your program takes no arguments other
+than switches you should produce an error if the return value is less
+than argc.
+
+ All switches except -bg2 may be abbreviated one letter and case is ignored:
+
+ Sets the background color using Fl::background(). Sets the secondary background color using Fl::background2(). Sets the X display to use; this option is silently
+ ignored under WIN32 and MacOS. Enables or disables drag and drop text operations
+ using Fl::dnd_text_ops(). Sets the foreground color using Fl::foreground(). Sets the initial window position and size according
+ the the standard X geometry string. Iconifies the window using Fl_Window::iconize(). Enables or disables visible keyboard focus for
+ non-text widgets using Fl::visible_focus(). Sets the window class using Fl_Window::xclass(). Sets the widget scheme using Fl::scheme(). Sets the window title using Fl_Window::label(). Enables or disables tooltips using Fl_Tooltip::enable(). The second form of Fl::args() is useful if your program does
+not have command line switches of its own. It parses all the switches,
+and if any are not recognized it calls Fl::abort(Fl::help).
+
+ A usage string is displayed if Fl::args() detects an invalid
+argument on the command-line. You can change the message by setting the
+Fl::help pointer.
+
+ The awake() method sends a message pointer to the main thread,
+causing any pending Fl::wait() call to
+terminate so that the main thread can retrieve the message and any pending
+redraws can be processed.
+
+ Multiple calls to Fl::awake() will queue multiple pointers
+for the main thread to process, up to a system-defined (typically several
+thousand) depth. The default message handler saves the last message which
+can be accessed using the
+Fl::thread_message() function.
+
+ The second form of awake() registers a function that will be
+called by the main thread during the next message handling cycle.
+awake() will return 0 if the callback function was registered,
+and -1 if registration failed. Over a thousand awake callbacks can be
+registered simultaneously.
+
+ See also: multithreading.
+
+ Changes the alternative background color. This color is used as a
+background by Fl_Input and other text widgets.
+ This call may change fl_color(FL_FOREGROUND_COLOR) if it
+does not provide sufficient contrast to FL_BACKGROUND2_COLOR.
+
+ Changes fl_color(FL_BACKGROUND_COLOR) to the given color,
+and changes the gray ramp from 32 to 56 to black to white. These are
+the colors used as backgrounds by almost all widgets and used to draw
+the edges of all the boxtypes.
+
+ Get or set the widget that is below the mouse. This is for
+highlighting buttons. It is not used to send FL_PUSH or
+FL_MOVE directly, for several obscure reasons, but those events
+typically go to this widget. This is also the first widget tried for
+FL_SHORTCUT events.
+
+ If you change the belowmouse widget, the previous one and all
+parents (that don't contain the new widget) are sent FL_LEAVE
+events. Changing this does not send FL_ENTER to this
+or any widget, because sending FL_ENTER is supposed to test
+if the widget wants the mouse (by it returning non-zero from
+handle()).
+
+ Returns the height offset for the given boxtype.
+See box_dy.
+
+ Returns the width offset for the given boxtype.
+See box_dy.
+
+ Returns the X offset for the given boxtype.
+See box_dy.
+
+ Returns the Y offset for the given boxtype.
+
+ These functions return the offset values necessary for a given
+boxtype, useful for computing the area inside a box's borders, to
+prevent overdrawing the borders.
+
+ For instance, in the case of a boxtype like FL_DOWN_BOX
+where the border width might be 2 pixels all around, the above
+functions would return 2, 2, 4, and 4 for box_dx,
+box_dy, box_dw, and box_dh
+respectively.
+
+ An example to compute the area inside a widget's box():
+ These functions are mainly useful in the draw() code
+for deriving custom widgets, where one wants to avoid drawing
+over the widget's own border box().
+
+ Same as Fl::wait(0). Calling this during a big calculation
+will keep the screen up to date and the interface responsive:
+
+ The returns non-zero if any windows are displayed, and 0 if no
+windows are displayed (this is likely to change in future versions of
+FLTK).
+
+ Use of this function is very simple. Any text editing widget should
+call this for each FL_KEYBOARD event.
+
+ If true is returned, then it has modified the
+Fl::event_text() and Fl::event_length() to a set of bytes to
+insert (it may be of zero length!). In will also set the "del"
+parameter to the number of bytes to the left of the cursor to
+delete, this is used to delete the results of the previous call to
+Fl::compose().
+
+ If false is returned, the keys should be treated as function
+keys, and del is set to zero. You could insert the text anyways, if
+you don't know what else to do.
+
+ Though the current implementation returns immediately, future
+versions may take quite awhile, as they may pop up a window or do
+other user-interface things to allow characters to be selected.
+
+ If the user moves the cursor, be sure to call Fl::compose_reset().
+The next call to Fl::compose() will start out in an initial state. In
+particular it will not set "del" to non-zero. This call is very fast
+so it is ok to call it many times and in many places.
+
+ Copies the data pointed to by stuff to the selection
+(0) or primary (1) clipboard. The selection clipboard is used
+for middle-mouse pastes and for drag-and-drop selections. The
+primary clipboard is used for traditional copy/cut/paste
+operations.
+
+ If true then flush() will do something.
+
+ This is the default callback for window widgets. It hides the
+window and then calls the default widget callback. Schedules a widget for deletion at the next call to the event loop.
+Use this method to delete a widget inside a callback function. As with
+normal widget deletion it is your responsibility to remove() the widget
+from any parent group or window before calling this. To avoid early deletion of widgets, this function
+should be called toward the end of a callback and only after any call
+to the event loop (Fl::wait(), Fl::flush(),
+Fl::check(), fl_ask(), etc.). When deleting groups or windows, you must only delete the group or
+window widget and not the individual child widgets. Sets the X display to use for all windows. Actually this just sets
+the environment variable $DISPLAY to the passed string, so this only
+works before you show() the first window or otherwise open the display,
+and does nothing useful under WIN32.
+
+ Initiate a Drag And Drop operation. The clipboard should be
+filled with relevant data before calling this method. FLTK will
+then initiate the system wide drag and drop handling. Dropped data
+will be marked as text.
+
+ Gets or sets whether drag and drop text operations are
+supported. This specifically affects whether selected text can
+be dragged from text fields or dragged within a text field as a
+cut/paste shortcut.
+
+ FLTK calls this to print a normal error message. You can
+override the behavior by setting the function pointer to your
+own routine.
+
+ Fl::error means there is a recoverable error such as
+the inability to read an image file. The default implementation
+prints the error message to stderr and returns.
+
+ Returns non-zero if the Alt key is pressed.
+
+ Returns non-zero if button 1 is currently held down.
+For more details, see Fl::event_buttons().
+
+ Returns non-zero if button 2 is currently held down.
+For more details, see Fl::event_buttons().
+
+ Returns non-zero if button 3 is currently held down.
+For more details, see Fl::event_buttons().
+
+ Returns which mouse button caused te current event. This returns garbage if the
+most recent event was not a FL_PUSH or FL_RELEASE
+event.
+
+ Returns the button state bits; if non-zero, then at least one
+button is pressed. This function returns the button state at the
+time of the event. During an FL_RELEASE event, the state
+of the released button will be 0. To find out, which button
+caused an FL_RELEASE event, you can use
+Fl::event_button() instead.
+
+ The first form returns non-zero if the most recent FL_PUSH or
+FL_KEYBOARD was a "double click". Returns N-1 for
+N clicks. A double click is counted if the same button is pressed
+again while event_is_click() is true.
+
+ The second form directly sets the number returned by
+Fl::event_clicks(). This can be used to set it to zero so that
+later code does not think an item was double-clicked.
+
+ Returns non-zero if the Control key is pressed.
+
+ Returns the last event that was processed. This can be used
+to determine if a callback is being done in response to a
+keypress, mouse click, etc.
+
+ Returns non-zero if the current event_x and event_y
+put it inside the widget or inside an arbitrary bounding box. You
+should always call this rather than doing your own comparison so you
+are consistent about edge effects.
+
+ The first form returns non-zero if the mouse has not moved far enough
+and not enough time has passed since the last FL_PUSH or
+FL_KEYBOARD event for it to be considered a "drag" rather than a
+"click". You can test this on FL_DRAG, FL_RELEASE,
+and FL_MOVE events. The second form clears the value returned
+by Fl::event_is_click(). Useful to prevent the next
+click from being counted as a double-click or to make a popup menu
+pick an item with a single click. Don't pass non-zero to this.
+
+ Fl::event_key() returns which key on the keyboard was last
+pushed. It returns zero if the last event was not a key press or release.
+
+ Fl::event_key(int) returns true if the given key was held
+down (or pressed) during the last event. This is constant until
+the next event is read from the server.
+
+ Fl::get_key(int) returns true if the given key is held down
+now. Under X this requires a round-trip to the server and is
+much slower than Fl::event_key(int).
+
+ Keys are identified by the unshifted values. FLTK defines a
+set of symbols that should work on most modern machines for every key
+on the keyboard:
+
+ On X Fl::get_key(FL_Button+n) does not work.
+
+ On WIN32 Fl::get_key(FL_KP_Enter) and
+Fl::event_key(FL_KP_Enter) do not work.
+
+ Returns the length of the text in Fl::event_text(). There
+will always be a nul at this position in the text. However there may
+be a nul before that if the keystroke translates to a nul character or
+you paste a nul character.
+
+ If NumLock is deactivated, FLTK translates events from the
+numeric keypad into the corresponding arrow key events.
+event_key() returns the translated key code, whereas
+event_original_key() returns the keycode before
+NumLock translation.
+
+ Returns non-zero if the Shift key is pressed.
+
+ This is a bitfield of what shift states were on and what mouse buttons
+were held down during the most recent event. The second version
+returns non-zero if any of the passed bits are turned on. The legal
+bits are:
+
+ X servers do not agree on shift states, and FL_NUM_LOCK, FL_META, and
+FL_SCROLL_LOCK may not work. The values were selected to match the
+XFree86 server on Linux. In addition there is a bug in the way X works
+so that the shift state is not correctly reported until the first event
+after the shift key is pressed or released.
+
+ Returns the mouse position of the event relative to the Fl_Window
+it was passed to.
+
+ Returns the mouse position on the screen of the event. To find the
+absolute position of an Fl_Window on the screen, use the
+difference between event_x_root(),event_y_root() and
+event_x(),event_y().
+
+ Returns the mouse position of the event relative to the Fl_Window
+it was passed to.
+
+ Returns the mouse position on the screen of the event. To find the
+absolute position of an Fl_Window on the screen, use the
+difference between event_x_root(),event_y_root() and
+event_x(),event_y().
+
+ FLTK calls this to print a fatal error message. You can
+override the behavior by setting the function pointer to your
+own routine.
+
+ Fl::fatal must not return, as FLTK is in an unusable
+state, however your version may be able to use longjmp
+or an exception to continue, as long as it does not call FLTK
+again. The default implementation prints the error message to
+stderr and exits with status 1.
+
+ Returns the first top-level window in the list of shown() windows. If
+a modal() window is shown this is the top-most modal window, otherwise
+it is the most recent window to get an event.
+
+ The second form sets the window that is returned by
+first_window. The window is removed from wherever it is in the
+list and inserted at the top. This is not done if Fl::modal()
+is on or if the window is not shown(). Because the first window
+is used to set the "parent" of modal windows, this is often
+useful.
+
+ Causes all the windows that need it to be redrawn and graphics forced
+out through the pipes. This is what wait() does before
+looking for events.
+
+ Get or set the widget that will receive FL_KEYBOARD events.
+
+ If you change Fl::focus(), the previous widget and all
+parents (that don't contain the new widget) are sent FL_UNFOCUS
+events. Changing the focus does not send FL_FOCUS to
+this or any widget, because sending FL_FOCUS is supposed to
+test if the widget wants the focus (by it returning non-zero from
+handle()).
+
+ Changes fl_color(FL_FOREGROUND_COLOR).
+
+ Frees the specified color from the colormap, if applicable.
+If overlay is non-zero then the color is freed from the
+overlay colormap.
+
+ Gets the current box drawing function for the specified box type.
+
+
+ Returns the RGB value(s) for the given FLTK color index. The
+first form returns the RGB values packed in a 32-bit unsigned
+integer with the red value in the upper 8 bits, the green value
+in the next 8 bits, and the blue value in bits 8-15. The lower
+8 bits will always be 0.
+
+ The second form returns the red, green, and blue values
+separately in referenced variables.
+
+
+ Get the string for this face. This string is different for each
+face. Under X this value is passed to XListFonts to get all the sizes
+of this face.
+
+ Get a human-readable string describing the family of this face. This
+is useful if you are presenting a choice to the user. There is no
+guarantee that each face has a different name. The return value points
+to a static buffer that is overwritten each call.
+
+ The integer pointed to by attributes (if the pointer is not
+zero) is set to zero, FL_BOLD or FL_ITALIC or
+FL_BOLD | FL_ITALIC. To locate a "family" of fonts, search
+forward and back for a set with non-zero attributes, these faces along
+with the face with a zero attribute before them constitute a family.
+
+ Return an array of sizes in sizep. The return value is the
+length of this array. The sizes are sorted from smallest to largest
+and indicate what sizes can be given to fl_font() that will
+be matched exactly (fl_font() will pick the closest size for
+other sizes). A zero in the first location of the array indicates a
+scalable font, where any size works, although the array may list sizes
+that work "better" than others. Warning: the returned array
+points at a static buffer that is overwritten each call. Under X this
+will open the display.
+
+ Return where the mouse is on the screen by doing a round-trip query to
+the server. You should use Fl::event_x_root() and
+Fl::event_y_root() if possible, but this is necessary if you are
+not sure if a mouse event has been processed recently (such as to
+position your first window). If the display is not open, this will
+open it.
+
+ Read the user preference colors from the system and use them to call
+ Fl::foreground(), Fl::background(), and
+Fl::background2(). This is done by
+Fl_Window::show(argc,argv) before applying the -fg and -bg
+switches.
+
+ On X this reads some common values from the Xdefaults database.
+KDE users can set these values by running the "krdb" program, and
+newer versions of KDE set this automatically if you check the "apply
+style to other X programs" switch in their control panel.
+
+ This does the same thing as
+Fl::visual(int) but also
+requires OpenGL drawing to work. This must be done if
+you want to draw in normal windows with OpenGL with gl_start() and
+gl_end(). It may be useful to call this so your X
+windows use the same visual as an
+Fl_Gl_Window, which on
+some servers will reduce colormap flashing.
+
+ See Fl_Gl_Window
+for a list of additional values for the argument.
+
+ This is used when pop-up menu systems are active. Send all events to
+the passed window no matter where the pointer or focus is (including
+in other programs). The window does not have to be
+shown() , this lets the handle() method of a
+"dummy" window override all event handling and allows you to
+map and unmap a complex set of windows (under both X and WIN32
+some window must be mapped because the system interface needs a
+window id).
+
+ If grab() is on it will also affect show() of windows by
+doing system-specific operations (on X it turns on
+override-redirect). These are designed to make menus popup reliably
+and faster on the system.
+
+ To turn off grabbing do Fl::grab(0).
+
+ Be careful that your program does not enter an infinite loop
+while grab() is on. On X this will lock up your screen!
+To avoid this potential lockup, all newer operating systems seem to
+limit mouse pointer grabbing to the time during which a mouse button
+is held down. Some OS's may not support grabbing at all.
+
+ Returns the height of the screen in pixels.
+
+ Sends the event to a window for processing. Returns non-zero if any
+widget uses the event.
+
+ Returns true if the check exists and has not been called yet.
+
+ Returns true if the specified idle callback is currently installed.
+
+ Returns true if the timeout exists and has not been called yet.
+
+ The lock() method blocks the current thread until it
+can safely access FLTK widgets and data. Child threads should
+call this method prior to updating any widgets or accessing
+data. The main thread must call lock() to initialize
+the threading support in FLTK.
+
+ Child threads must call unlock() when they are done
+accessing FLTK.
+
+ When the wait() method is waiting
+for input or timeouts, child threads are given access to FLTK.
+Similarly, when the main thread needs to do processing, it will
+wait until all child threads have called unlock() before processing
+additional data.
+
+ See also: multithreading
+
+ Returns the top-most modal() window currently shown.
+This is the most recently
+shown() window with
+modal() true, or NULL if there are no modal()
+windows shown().
+The modal() window has its handle() method called
+for all events, and no other windows will have handle()
+called (grab() overrides this).
+
+ Returns the next top-level window in the list of shown() windows. You can
+use this call to iterate through all the windows that are shown().
+
+ Makes FLTK use its own colormap. This may make FLTK display better
+and will reduce conflicts with other programs that want lots of colors.
+However the colors may flash as you move the cursor between windows.
+
+ This does nothing if the current visual is not colormapped.
+
+ Set things up so the receiver widget will be called with an FL_PASTE event some
+time in the future for the specified clipboard. The reciever
+should be prepared to be called directly by this, or for
+it to happen later, or possibly not at all. This
+allows the window system to take as long as necessary to retrieve
+the paste buffer (or even to screw up completely) without complex
+and error-prone synchronization code in FLTK.
+
+ Get or set the widget that is being pushed. FL_DRAG or
+FL_RELEASE (and any more FL_PUSH) events will be sent to
+this widget.
+
+ If you change the pushed widget, the previous one and all parents
+(that don't contain the new widget) are sent FL_RELEASE
+events. Changing this does not send FL_PUSH to this
+or any widget, because sending FL_PUSH is supposed to test
+if the widget wants the mouse (by it returning non-zero from
+handle()).
+
+ All Fl_Widgets that don't have a callback defined use a
+default callback that puts a pointer to the widget in this queue, and
+this method reads the oldest widget out of this queue.
+
+ This is similar to Fl::check() except this does not
+call Fl::flush() or any callbacks, which is useful if your
+program is in a state where such callbacks are illegal. This returns
+true if Fl::check() would do anything (it will continue to
+return true until you call Fl::check() or Fl::wait()).
+
+ Redraws all widgets.
+
+ Removes a check callback. It is harmless to remove a check
+callback that no longer exists.
+
+ Removes a file descriptor handler.
+
+ Removes a previously added event handler.
+
+ Removes the specified idle callback, if it is installed.
+
+ Removes a timeout callback. It is harmless to remove a timeout
+callback that no longer exists.
+
+ This method repeats a timeout callback from the expiration of the
+previous timeout, allowing for more accurate timing. You may only call
+this method inside a timeout callback.
+
+ The following code will print "TICK" each second on
+stdout with a fair degree of accuracy: As long as any windows are displayed this calls Fl::wait()
+repeatedly. When all the windows are closed it returns zero
+(supposedly it would return non-zero on any errors, but FLTK calls
+exit directly for these). A normal program will end main()
+with return Fl::run();.
+
+ Gets or sets the current widget scheme. NULL will use
+the scheme defined in the FLTK_SCHEME environment
+variable or the scheme resource under X11. Otherwise,
+any of the following schemes can be used: Gets the number of available screens. Gets the bounding box of a screen. The first form gets the
+bounding box for the screen the mouse pointer is in. The second
+form gets the bounding box for the screen that contains the
+specified coordinates. The last form gets the bounding box for
+the numbered screen, where n is a number from 0 to the
+number of screens less 1. Sets or gets the default scrollbar size that is used by the
+Fl_Browser_,
+Fl_Help_View,
+Fl_Scroll, and
+Fl_Text_Display widgets. Changes the current selection. The block of text is
+copied to an internal buffer by FLTK (be careful if doing this in
+response to an FL_PASTE as this may be the same buffer
+returned by event_text()). The selection_owner()
+widget is set to the passed owner.
+
+ The single-argument selection_owner(x) call can be used to
+move the selection to another widget or to set the owner to
+NULL, without changing the actual text of the
+selection. FL_SELECTIONCLEAR is sent to the previous
+selection owner, if any.
+
+ Copying the buffer every time the selection is changed is
+obviously wasteful, especially for large selections. An interface will
+probably be added in a future version to allow the selection to be made
+by a callback function. The current interface will be emulated on top
+of this.
+
+ The first form sets the function to call to draw a specific boxtype.
+
+ The second form copies the from boxtype.
+
+ Sets an entry in the fl_color index table. You can set it to
+any 8-bit RGB color. The color is not allocated until fl_color(i)
+is used.
+
+ The first form changes a face. The string pointer is simply stored,
+the string is not copied, so the string must be in static memory.
+
+ The second form copies one face to another.
+
+ FLTK will open the display, and add every font on the server to the
+face table. It will attempt to put "families" of faces together, so
+that the normal one is first, followed by bold, italic, and bold
+italic.
+
+ The optional argument is a string to describe the set of fonts to
+add. Passing NULL will select only fonts that have the
+ISO8859-1 character set (and are thus usable by normal text). Passing
+"-*" will select all fonts with any encoding as long as they have
+normal X font names with dashes in them. Passing "*" will list every
+font that exists (on X this may produce some strange output). Other
+values may be useful but are system dependent. With WIN32 NULL
+selects fonts with ISO8859-1 encoding and non-NULL selects
+all fonts.
+
+ The return value is how many faces are in the table after this is
+done.
+
+ Sets an idle callback.
+
+ This method is obsolete - use the add_idle() method instead.
+
+ Sets the functions to call to draw and measure a specific labeltype.
+
+ Test the current event, which must be an FL_KEYBOARD or
+FL_SHORTCUT, against a shortcut value (described in
+Fl_Button). Returns non-zero if there is a match. Not to
+be confused with
+Fl_Widget::test_shortcut().
+
+ The thread_message() method returns the last message
+that was sent from a child by the awake() method.
+
+ See also: multithreading
+
+ The unlock() method releases the lock that was set
+using the lock() method. Child
+threads should call this method as soon as they are finished
+accessing FLTK.
+
+ See also: multithreading
+
+ Returns the compiled-in value of the FL_VERSION constant. This
+is useful for checking the version of a shared library.
+
+ Gets or sets the visible keyboard focus on buttons and other
+non-text widgets. The default mode is to enable keyboard focus
+for all widgets.
+
+ Selects a visual so that your graphics are drawn correctly. This is
+only allowed before you call show() on any windows. This does nothing
+if the default visual satisfies the capabilities, or if no visual
+satisfies the capabilities, or on systems that don't have such
+brain-dead notions.
+
+ Only the following combinations do anything useful:
+
+ This returns true if the system has the capabilities by default or
+FLTK suceeded in turing them on. Your program will still work even if
+this returns false (it just won't look as good).
+
+ Returns the width of the screen in pixels.
+
+ Waits until "something happens" and then returns. Call this
+repeatedly to "run" your program. You can also check what happened
+each time after this returns, which is quite useful for managing
+program state.
+
+ What this really does is call all idle callbacks, all elapsed
+timeouts, call Fl::flush() to get the screen to update, and
+then wait some time (zero if there are idle callbacks, the shortest of
+all pending timeouts, or infinity), for any events from the user or
+any Fl::add_fd() callbacks. It then handles the events and
+calls the callbacks and then returns.
+
+ The return value of the first form is non-zero if there are
+any visible windows - this may change in future versions of
+FLTK.
+
+ The second form waits a maximum of time
+seconds. It can return much sooner if something happens.
+
+ The return value is positive if an event or fd happens before the
+time elapsed. It is zero if nothing happens (on Win32 this will only
+return zero if time is zero). It is negative if an error
+occurs (this will happen on UNIX if a signal happens).
+
+ FLTK calls this to print a warning message. You can
+override the behavior by setting the function pointer to your
+own routine.
+
+ Fl::warning means that there was a recoverable
+problem, the display may be messed up but the user can probably
+keep working - all X protocol errors call this, for example.
+
+ Returns the origin of the current screen, where 0 indicates
+the left side of the screen.
+
+ Returns the origin of the current screen, where 0 indicates
+the top edge of the screen.
+
+ When you press a button and drag to the right the value increases.
+When you drag to the left it decreases. The largest button adjusts by
+100 * step(), the next by 10 * step() and that
+smallest button by step(). Clicking on the buttons
+increments by 10 times the amount dragging by a pixel does. Shift +
+click decrements by 10 times the amount.
+ The Fl_BMP_Image class supports loading, caching,
+and drawing of Windows Bitmap (BMP) image files. The constructor loads the named BMP image. The destructor free all memory and server resources that are used by
+the image. The Fl_Bitmap class supports caching and drawing of mono-color
+(bitmap) images. Images are drawn using the current color. The constructors create a new bitmap from the specified bitmap data. The destructor free all memory and server resources that are used by
+the bitmap. The second form of the constructor sets the box to the specified box
+type. Each line in the browser is identified by number. The numbers
+start at one (this is so that zero can be reserved for "no line" in
+the selective browsers). Unless otherwise noted, the methods do not
+check to see if the passed line number is in range and legal. It must
+always be greater than zero and <= size(). Each line contains a null-terminated string of text and a void *
+ data pointer. The text string is displayed, the void *
+ pointer can be used by the callbacks to reference the object the text
+describes. The base class does nothing when the user clicks on it. The
+subclasses
+Fl_Select_Browser,
+Fl_Hold_Browser, and
+Fl_Multi_Browser react to user clicks to select lines in
+the browser and do callbacks. The base class called
+Fl_Browser_ provides the scrolling and selection mechanisms of
+this and all the subclasses, but the dimensions and appearance of each
+item are determined by the subclass. You can use Fl_Browser_
+ to display information other than text, or text that is dynamically
+produced from your own data structures. If you find that loading the
+browser is a lot of work or is inefficient, you may want to make a
+subclass of Fl_Browser_. The second form sets the column separator to c. This will
+only have an effect if you also set column_widths(). The second form sets the current array to w. Make sure the
+last entry is zero. The second form sets the data for line n. The second form sets the current prefix to c. Set the
+prefix to 0 to disable formatting. The second form sets the vertical scrollbar position to p. The second form sets the text for line n. The second form scrolls the browser so the top line in the browser is n. This has been designed so that the subclass has complete control
+over the storage of the data, although because next() and
+prev() functions are used to index, it works best as a linked list
+or as a large block of characters in which the line breaks must be
+searched for. A great deal of work has been done so that the "height" of a data
+object does not need to be determined until it is drawn. This is
+useful if actually figuring out the size of an object requires
+accessing image data or doing stat() on a file or doing some
+other slow operation. The constructor makes an empty browser.
+
+
+ The destructor deletes all list items and destroys the browser.
+
+
+ [protected] This method returns the bounding box for the interior of the list, inside
+the scrollbars.
+
+
+ [protected] This method should be used when an item is deleted from the list.
+It allows the Fl_Browser_ to discard any cached data it has
+on the item.
+
+
+ Deselects all items in the list and returns 1 if the state changed
+or 0 if it did not.
+
+ If docb is non-zero, deselect tries to call the
+callback function for the widget.
+
+
+ Displays item p, scrolling the list as necessary.
+
+
+ [protected] This method returns non-zero if item p is currently visible in
+the list.
+
+
+ [protected] The first form draws the list within the normal widget bounding box.
+
+ [protected] The second form draws the contents of the browser within the
+specified bounding box.
+
+
+ This method returns the item under mouse at my. If no item is
+displayed at that position then NULL is returned.
+
+
+ [protected] This method may be provided by the subclass to indicate the full height
+of the item list in pixels. The default implementation computes the full
+height from the item heights.
+
+
+ [protected] This method may be provided by the subclass to indicate the full width
+of the item list in pixels. The default implementation computes the full
+width from the item widths.
+
+
+ The first form handles an event within the normal widget bounding box.
+
+ [protected] The second form handles an event within the specified bounding box.
+
+
+ By default you can scroll in both directions, and the scrollbars
+disappear if the data will fit in the widget. has_scrollbar() changes
+this based on the value of h:
+
+ Gets or sets the horizontal scrolling position of the list,
+which is the pixel offset of the list items within the list
+area.
+
+
+ [protected] This method may be provided to return the average height of all items, to
+be used for scrolling. The default implementation uses the height of the first
+item.
+
+
+ [protected] This method should be used when an item is added to the list.
+It allows the Fl_Browser_ to update its cache data as needed.
+
+
+ [protected] This method must be provided by the subclass to draw the item
+p in the area indicated by x, y, w,
+and h.
+
+
+ [protected] This method must be provided by the subclass to return the first item in
+the list.
+
+
+ [protected] This method must be provided by the subclass to return the height of the
+item p in pixels. Allow for two additional pixels for the list
+selection box.
+
+
+ [protected] This method must be provided by the subclass to return the item in
+the list after p.
+
+
+ [protected] This method must be provided by the subclass to return the item in
+the list before p.
+
+
+ [protected] This method may be provided by the subclass to return the height of the
+item p in pixels. Allow for two additional pixels for the list
+selection box. This method differs from
+item_height in that it is only
+called for selection and scrolling operations. The default implementation
+calls item_height.
+
+
+ [protected] This method must be implemented by the subclass if it supports
+multiple selections in the browser. The s argument specifies the
+selection state for item p: 0 = off, 1 = on.
+
+
+ [protected] This method must be implemented by the subclass if it supports
+multiple selections in the browser. The method should return 1 if p
+is selected and 0 otherwise.
+
+
+ [protected] This method must be provided by the subclass to return the width of the
+item p in pixels. Allow for two additional pixels for the list
+selection box.
+
+
+ [protected] This method returns the X position of the left edge of the list area
+after adjusting for the scrollbar and border, if any.
+
+
+ [protected] This method should be called when the list data is completely replaced
+or cleared. It informs the Fl_Browser_ widget that any cached
+information it has concerning the items is invalid.
+
+
+ Gets or sets the vertical scrolling position of the list,
+which is the pixel offset of the list items within the list
+area.
+
+
+ [protected] This method should be called when the contents of an item have changed
+but not changed the height of the item.
+
+
+ [protected] This method will cause the entire list to be redrawn.
+
+
+ [protected] This method should be used when an item is replaced in the list.
+It allows the Fl_Browser_ to update its cache data as needed.
+
+
+ Repositions and/or resizes the browser.
+
+
+ This method moves the vertical scrollbar to the lefthand side of the list.
+
+
+ This method moves the vertical scrollbar to the righthand side of the list.
+
+
+ Sets or gets the width of any scrollbars that are used.
+
+
+ Sets the selection state of item p to s and
+returns 1 if the state changed or 0 if it did not.
+
+ If docb is non-zero, select tries to call the callback
+function for the widget.
+
+
+ Selects item p and returns 1 if the state changed or 0 if it did
+not. Any other items in the list are deselected.
+
+ If docb is non-zero, select_only tries to call the
+callback function for the widget.
+
+
+ [protected] Returns the item currently selected, or NULL if there is no selection.
+
+ For multiple selection browsers this call returns the currently focused item,
+even if it is not selected. To find all selected items, call
+
+Fl_Multi_Browser::selected() for every item in question.
+
+
+ The first form gets the default text color for the lines in the
+browser.
+
+ The second form sets the default text color to color The first form gets the default text font for the lines in the
+browser.
+
+ The second form sets the default text font to font The first form gets the default text size for the lines in the
+browser.
+
+ The second form sets the default text size to size [protected] Returns the item the appears at the top of the list.
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Button.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Button.html
new file mode 100644
index 0000000..aa52836
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Button.html
@@ -0,0 +1,134 @@
+
+ Buttons generate callbacks when they are clicked by the user. You
+control exactly when and how by changing the values for type()
+ and when(). Buttons can also generate callbacks in response to FL_SHORTCUT
+ events. The button can either have an explicit
+shortcut() value or a letter shortcut can be indicated in
+the label() with an '&' character before it. For the label
+shortcut it does not matter if Alt is held down, but if you have
+an input field in the same window, the user will have to hold down the
+Alt key so that the input field does not eat the event first as an
+FL_KEYBOARD event. The second form sets the down box type. The default value of 0
+causes FLTK to figure out the correct matching down version of box()
+. The second form sets the shortcut key to key. Setting this
+overrides the use of '&' in the label(). The value is a bitwise
+OR of a key and a set of shift flags, for example The key can be any value returned by
+Fl::event_key(), but will usually be an ASCII letter. Use
+a lower-case letter unless you require the shift key to be held down. The shift flags can be any set of values accepted by
+Fl::event_state(). If the bit is on that shift key must
+be pushed. Meta, Alt, Ctrl, and Shift must be off if they are not in
+the shift flags (zero for the other bits indicates a "don't care"
+setting). The second form of autosize sets the auto-sizing property
+to onoff. The Fl_Check_Button subclass display the "on" state by
+turning on a light, rather than drawing pushed in. The shape of the
+"light" is initially set to FL_DIAMOND_DOWN_BOX. The color of the
+light when on is controlled with selection_color(), which
+defaults to FL_RED. The only difference between this and a
+Fl_Menu_Button is that the name of the most recent chosen
+menu item is displayed inside the box, while the label is displayed
+outside the box. However, since the use of this is most often to
+control a single variable rather than do individual callbacks, some of
+the Fl_Menu_Button methods are redescribed here in those
+terms. When the user picks an item off the menu the value()
+is set to that item and then the item's callback is done with
+the menu_button as the Fl_Widget* argument. If the
+item does not have a callback the menu_button's callback is done
+instead. All three mouse buttons pop up the menu. The Forms behavior of the
+first two buttons to increment/decrement the choice is not implemented.
+ This could be added with a subclass, however. The menu will also pop up in response to shortcuts indicated by
+putting a '&' character in the label(). See
+Fl_Button for a description of this. Typing the shortcut() of any of the items will do exactly
+the same as when you pick the item with the mouse. The '&' character in
+item names are only looked at when the menu is popped up, however. The constructor sets menu() to NULL. See
+Fl_Menu_ for the methods to set or change the menu. This widget can be used to display a program-supplied time.
+The time shown on the clock is not updated.
+To display the current time, use Fl_Clock
+instead.
+
+ The third form of value returns the displayed time in
+seconds since the UNIX epoch (January 1, 1970). It is highly recommended that you put the following code before the
+first show() of any window in your program: Creates a new Fl_Double_Window widget using the given
+position, size, and label (title) string. The The constructor creates the The destructor destroys the widget and frees all memory that has been
+allocated.
+
+ Sets or gets the size of the icons. The default size is 20 pixels.
+
+ Sets or gets the filename filter. The pattern matching uses
+the Sets or gets the file browser type, Loads the specified directory into the browser. If icons have been
+loaded then the correct icon is associated with each file in the list.
+
+ The sort argument specifies a sort function to be used with
+fl_filename_list().
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_File_Chooser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Chooser.html
new file mode 100644
index 0000000..7bee2d1
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Chooser.html
@@ -0,0 +1,295 @@
+
+ The The The sort member specifies the sort function that is
+used when loading the contents of a directory.
+
+ The The constructor creates the The The file chooser will automatically add the "All Files (*)"
+pattern to the end of the string you pass if you do not provide
+one. The first filter in the string is the default filter.
+
+ See the FLTK documentation on The The Destroys the widget and frees all memory used by it.
+
+ Sets or gets the background color of the Returns the number of selected files.
+
+ Sets or gets the current directory.
+
+ Sets or gets the current filename filter patterns. The filter
+patterns use fl_filename_match().
+Multiple patterns can be used by separating them with tabs, like
+"*.jpg\t*.png\t*.gif\t*". In addition, you can provide
+human-readable labels with the patterns inside parenthesis, like
+"JPEG Files (*.jpg)\tPNG Files (*.png)\tGIF Files (*.gif)\tAll Files (*)".
+Use filter(NULL) to show all files. Sets or gets the current filename filter selection.
+
+ Hides the Sets or gets the size of the icons in the Sets or gets the title bar text for the Sets or gets the label for the "ok" button in the
+ The first form enables or disables the preview box in the file chooser.
+The second form returns the current state of the preview box.
+
+ Reloads the current directory in the Shows the Sets or gets the current Sets or gets the current Sets or gets the current Sets or gets the current type of Sets or gets the current value of the selected file.
+
+ In the second form, file is a 1-based index into a list of
+file names. The number of selected files is returned by
+ This sample code loops through all selected files:
+ Returns 1 if the The The constructor creates a new The destructor destroys the icon and frees all memory that has been
+allocated for it.
+
+ Adds a keyword value to the icon array, returning a pointer to it.
+
+ Adds a color value to the icon array, returning a pointer to it.
+
+ Adds a vertex value to the icon array, returning a pointer to it.
+The integer version accepts coordinates from 0 to 10000, while the
+floating point version goes from 0.0 to 1.0. The origin (0.0) is in
+the lower-lefthand corner of the icon.
+
+ Clears all icon data from the icon.
+
+ Draws the icon in the indicated area.
+
+ Finds an icon that matches the given filename and file type.
+
+ Returns a pointer to the first icon in the list.
+
+ Applies the icon to the widget, registering the The labeltype function for icons.
+
+ Loads the specified icon image. The format is deduced from the filename.
+
+ Loads an SGI icon file.
+
+ Loads all system-defined icons. This call is useful when using the
+ Loads an XPM icon file.
+
+ Returns the filename matching pattern for the icon.
+
+ Returns the number of words of data used by the icon.
+
+ Returns the filetype associated with the icon, which can be one of the
+following:
+
+ Returns the data array for the icon.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_File_Input.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Input.gif
new file mode 100644
index 0000000..4a1f31d
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Input.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_File_Input.html b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Input.html
new file mode 100644
index 0000000..3dc24dc
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Input.html
@@ -0,0 +1,60 @@
+
+ This widget displays a pathname in a text input field. A navigation bar
+located above the input field allows the user to navigate upward in the
+directory tree.
+
+ Creates a new Fl_File_Input widget using the given position,
+size, and label string. The default boxtype is FL_DOWN_BOX.
+
+ Destroys the widget and any value associated with it.
+
+ Gets or sets the box type to use for the navigation bar.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Float_Input.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Float_Input.html
new file mode 100644
index 0000000..8ca60f1
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Float_Input.html
@@ -0,0 +1,39 @@
+
+ There are five types of free, which determine when the handle
+function is called: An FL_INPUT_FREE accepts FL_FOCUS events. A FL_CONTINUOUS_FREE sets
+a timeout callback 100 times a second and provides a FL_STEP event,
+this has obvious detrimental effects on machine performance.
+FL_ALL_FREE does both. FL_SLEEPING_FREE are deactivated. The Fl_GIF_Image class supports loading, caching,
+and drawing of Compuserve GIFSM images. The class
+loads the first image and supports transparency. The constructor loads the named GIF image. The destructor free all memory and server resources that are used by
+the image. OpenGL hardware typically provides some overlay bit planes, which
+are very useful for drawing UI controls atop your 3D graphics. If the
+overlay hardware is not provided, FLTK tries to simulate the overlay,
+This works pretty well if your graphics are double buffered, but not
+very well for single-buffered. Please note that the FLTK drawing and clipping functions
+will not work inside an Fl_Gl_Window. All drawing
+should be done using OpenGL calls exclusively.
+Even though Fl_Gl_Window is derived from Fl_Group,
+it is not useful to add other FLTK Widgets as children,
+unless those Widgets are modified to draw using OpenGL calls. The draw() method can only use OpenGL calls. Do not
+attempt to call X, any of the functions in <FL/fl_draw.H>, or glX
+ directly. Do not call gl_start() or gl_finish(). If double-buffering is enabled in the window, the back and front
+buffers are swapped after this function is completed. If the desired combination cannot be done, FLTK will try turning off
+FL_MULTISAMPLE. If this also fails the show() will call
+Fl::error() and not show the window. You can change the mode while the window is displayed. This is most
+useful for turning double-buffering on and off. Under X this will
+cause the old X window to be destroyed and a new one to be created. If
+this is a top-level window this will unfortunately also cause the
+window to blink, raise to the top, and be de-iconized, and the xid()
+ will change, possibly breaking other code. It is best to make the GL
+window a child of another window if you wish to do this! mode() must not be called within draw() since it
+changes the current context. If destroy_flag is true the context will be destroyed by
+fltk when the window is destroyed, or when the mode() is changed, or the next time
+context(x) is called.
+
+ Both this function and Fl_Gl_Window::draw() should check
+Fl_Gl_Window::valid() and set the same transformation. If you
+don't your code may not work on other systems. Depending on the OS,
+and on whether overlays are real or simulated, the OpenGL context may
+be the same or different between the overlay and main window. The clear() method deletes all child widgets from
+memory recursively. This method differs from the remove() method in that it
+affects all child widgets and deletes them from memory. The second method returns the current clipping mode.
+
+ The default is to not clip (0) the drawing of child widgets.
+
+ Removes a widget from the group but does not delete it. This
+method does nothing if the widget is not a child of the
+group. This method differs from the clear() method in that it
+only affects a single widget and does not delete it from
+memory. Don't forget to end() the group or window! In these examples the gray area is the resizable:
+ The resizable may be set to the group itself (this is the default
+value for an Fl_Group, although NULL is the default
+for Fl_Window and Fl_Pack), in which case all the
+contents are resized.
+If the resizable is NULL then all widgets remain a fixed size
+and distance from the top-left corner. It is possible to achieve any type of resize behavior by using an
+invisible Fl_Box as the resizable and/or by using a hierarchy
+of child Fl_Group's. The The constructor creates the dialog pictured above.
+
+ The destructor destroys the widget and frees all memory that has been
+allocated for the current file.
+
+ Hides the Loads the specified HTML file into the Set the screen position of the dialog.
+
+ Change the position and size of the dialog.
+
+ Shows the Sets or gets the default text size for the help view.
+
+ Sets the top line in the The first form sets the current buffer to the string provided and
+reformats the text. It also clears the history of the "back" and
+"forward" buttons. The second form returns the current buffer contents.
+
+ Returns 1 if the Returns the position and size of the help dialog.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Help_View.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Help_View.html
new file mode 100644
index 0000000..b324af5
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Help_View.html
@@ -0,0 +1,141 @@
+
+ The The constructor creates the The destructor destroys the widget and frees all memory that has been
+allocated for the current file.
+
+ This method returns the current directory (base) path for the file
+in the buffer.
+
+ This method returns the current filename for the text in the buffer.
+
+ This method assigns a callback function to use when a link is
+followed or a file is loaded (via
+ The link function can be used to retrieve remote or virtual
+documents, returning a temporary file that contains the actual
+data. If the link function returns NULL, the value of
+the Fl_Help_View widget will remain unchanged. If the link callback cannot handle the URI scheme, it should
+return the uri value unchanged or set the value() of the widget
+before returning NULL. This method loads the specified file or URL.
+
+ This method returns the length of the buffer text in pixels.
+
+ The first form sets the default text color. The second returns
+the current default text color.
+
+ The first form sets the default text font. The second returns
+the current default text font.
+
+ The first form sets the default text size. The second returns
+the current default text size.
+
+ This method returns the current document title, or NULL if there
+is no title.
+
+ The first two forms scroll the text to the indicated position, either
+with a named destination or by pixel line.
+
+ The second form returns the current top line in pixels.
+
+ The first form sets the current buffer to the string provided and
+reformats the text. The second form returns the current buffer contents.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Hold_Browser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Hold_Browser.html
new file mode 100644
index 0000000..cf54916
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Hold_Browser.html
@@ -0,0 +1,59 @@
+
+ See Fl_Browser for
+methods to add and remove lines from the browser. Deselects any selected item.
+ Fl_Image is the base class used for caching and
+drawing all kinds of images in FLTK. This class keeps track of
+common image data such as the pixels, colormap, width, height,
+and depth. Virtual methods are used to provide type-specific
+image handling. Since the Fl_Image class does not support image
+drawing by itself, calling the draw() method results in
+a box with an X in it being drawn instead. The constructor creates an empty image with the specified
+width, height, and depth. The width and height are in pixels.
+The depth is 0 for bitmaps, 1 for pixmap (colormap) images, and
+1 to 4 for color images. The destructor is a virtual method that frees all memory used
+by the image. The color_average() method averages the colors in
+the image with the FLTK color value c. The i
+argument specifies the amount of the original image to combine
+with the color, so a value of 1.0 results in no color blend, and
+a value of 0.0 results in a constant image of the specified
+color. The original image data is not altered by this
+method. The copy() method creates a copy of the specified
+image. If the width and height are provided, the image is
+resized to the specified size. The image should be deleted (or in
+the case of Fl_Shared_Image, released) when you are done
+with it. The count() method returns the number of data values
+associated with the image. The value will be 0 for images with
+no associated data, 1 for bitmap and color images, and greater
+than 2 for pixmap images. The first form of the d() method returns the current
+image depth. The return value will be 0 for bitmaps, 1 for
+pixmaps, and 1 to 4 for color images. The second form is a protected method that sets the current
+image depth. The first form of the data() method returns a
+pointer to the current image data array. Use the
+count() method to find the size of the data array. The second form is a protected method that sets the current
+array pointer and count of pointers in the array. The desaturate() method converts an image to
+grayscale. If the image contains an alpha channel (depth = 4),
+the alpha channel is preserved. This method does not alter
+the original image data. The draw() methods draw the image. The first form
+specifies the upper-lefthand corner of the image. The second
+form specifies a bounding box for the image, with the origin
+(upper-lefthand corner) of the image offset by the cx
+and cy arguments. The protected method draw_empty() draws a box with
+an X in it. It can be used to draw any image that lacks image
+data. The first form of the h() method returns the current
+image height in pixels. The second form is a protected method that sets the current
+image height. The inactive() method calls
+color_average(FL_BACKGROUND_COLOR, 0.33f) to produce
+an image that appears grayed out. This method does not
+alter the original image data. The label() methods are an obsolete way to set the
+image attribute of a widget or menu item. Use the
+image() or deimage() methods of the
+Fl_Widget and Fl_Menu_Item classes
+instead. The first form of the ld() method returns the current
+line data size in bytes. Line data is extra data that is included
+after each line of color image data and is normally not present. The second form is a protected method that sets the current
+line data size in bytes. If the image has been cached for display, delete the cache
+data. This allows you to change the data used for the image and
+then redraw it without recreating an image object.
+
+ The first form of the w() method returns the current
+image width in pixels. The second form is a protected method that sets the current
+image width. This is the FLTK text input widget. It displays a single line
+of text and lets the user edit it. Normally it is drawn with an
+inset box and a white background. The text may contain any
+characters (even 0), and will correctly display anything, using
+^X notation for unprintable control characters and \nnn notation
+for unprintable characters with the high bit set. It assumes the
+font can draw any characters in the ISO-8859-1 character set. For instance, to type "á" type [compose][a]['] or [compose]['][a].
+
+ The character "nbsp" (non-breaking space) is typed by using
+[compose][space].
+
+ The single-character sequences may be followed by a space if
+necessary to remove ambiguity. For instance, if you really want to
+type "ª~" rather than "ã" you must type [compose][a][space][~].
+
+ The same key may be used to "quote" control characters into the
+text. If you need a ^Q character you can get one by typing
+[compose][Control+Q].
+
+ X may have a key on the keyboard
+defined as XK_Multi_key. If so this key may be used as well
+as the right-hand control key. You can set this up with the program
+xmodmap.
+
+ If your keyboard is set to support a foreign language you should
+also be able to type "dead key" prefix characters. On X you will
+actually be able to see what dead key you typed, and if you then move
+the cursor without completing the sequence the accent will remain
+inserted. Creates a new Fl_Input widget using the given position, size,
+and label string. The default boxtype is FL_DOWN_BOX.
+
+ Destroys the widget and any value associated with it.
+
+ The first form returns the current value, which is a pointer
+to the internal buffer and is valid only until the next event is
+handled.
+
+ The second two forms change the text and set the mark and the
+point to the end of it. The string is copied to the internal
+buffer. Passing NULL is the same as "".
+This returns non-zero if the new value is different than the
+current one. You can use the second version to directly set the
+length if you know it already or want to put nul's in the
+text. Change the text and set the mark and the point to the end of
+it. The string is not copied. If the user edits the
+string it is copied to the internal buffer then. This can save a
+great deal of time and memory if your program is rapidly
+changing the values of text fields, but this will only work if
+the passed string remains unchanged until either the
+Fl_Input is destroyed or value() is called
+again.
+
+ Returns the number of characters in value(). This
+may be greater than strlen(value()) if there are nul
+characters in it.
+
+ Same as value()[n], but may be faster in plausible
+implementations. No bounds checking is done.
+
+ Controls when callbacks are done. The following values are useful,
+the default value is FL_WHEN_RELEASE:
+
+ Gets or sets the color of the text in the input field.
+
+ Gets or sets the font of the text in the input field.
+
+ Gets or sets the size of the text in the input field.
+
+ Get or set the color of the cursor. This is black by default.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Input_.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Input_.html
new file mode 100644
index 0000000..8434f08
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Input_.html
@@ -0,0 +1,265 @@
+
+ This is a virtual base class below Fl_Input. It has all
+the same interfaces, but lacks the handle() and
+draw() method. You may want to subclass it if you are
+one of those people who likes to change how the editing keys
+work.
+
+ This can act like any of the subclasses of Fl_Input, by
+setting type() to one of the following values: Creates a new Fl_Input_ widget using the given
+position, size, and label string. The default boxtype is
+FL_DOWN_BOX.
+
+ The destructor removes the widget and any value associated with it.
+
+ Returns true if position i is at the start or end of a word.
+
+ Returns true if position i is at the start or end of a line.
+
+ Draw the text in the passed bounding box. If damage()
+& FL_DAMAGE_ALL is true, this assumes the area has
+already been erased to color(). Otherwise it does
+minimal update and erases the area itself.
+
+ Default handler for all event types. Your handle()
+method should call this for all events that it does not handle
+completely. You must pass it the same bounding box as you do
+when calling drawtext() from your draw()
+method. Handles FL_PUSH, FL_DRAG,
+FL_RELEASE to select text, handles FL_FOCUS
+and FL_UNFOCUS to show and hide the cursor.
+
+ Do the correct thing for arrow keys. Sets the position (and
+mark if keepmark is zero) to somewhere in the same line
+as i, such that pressing the arrows repeatedly will cause
+the point to move up and down.
+
+ Does the callback if changed() is true or if
+when() & FL_WHEN_NOT_CHANGED is non-zero. You
+should call this at any point you think you should generate a
+callback.
+
+ Sets or returns the maximum length of the input field.
+
+ The input widget maintains two pointers into the string. The
+"position" is where the cursor is. The
+"mark" is the other end of the selected text. If they
+are equal then there is no selection. Changing this does not
+affect the clipboard (use copy() to do that).
+
+ Changing these values causes a redraw(). The new
+values are bounds checked. The return value is non-zero if the
+new position is different than the old one. position(n)
+is the same as position(n,n). mark(n) is the
+same as position(position(),n). Gets or sets the current selection mark. mark(n) is
+the same as position(position(),n).
+
+ This call does all editing of the text. It deletes the region
+between a and b (either one may be less or
+equal to the other), and then inserts the string insert
+at that point and leaves the mark() and
+position() after the insertion. Does the callback if
+when() & FL_WHEN_CHANGED and there is a change.
+
+ Set start and end equal to not delete
+anything. Set insert to NULL to not insert
+anything. length must be zero or strlen(insert), this
+saves a tiny bit of time if you happen to already know the
+length of the insertion, or can be used to insert a portion of a
+string or a string containing nul's. a and b are clamped to the
+0..size() range, so it is safe to pass any values. cut() and insert() are just inline
+functions that call replace(). Fl_Input_::cut() deletes the current selection.
+cut(n) deletes n characters after the
+position(). cut(-n) deletes n
+characters before the position(). cut(a,b)
+deletes the characters between offsets a and
+b. A, b, and n are all
+clamped to the size of the string. The mark and point are left
+where the deleted text was.
+
+ If you want the data to go into the clipboard, do
+Fl_Input_::copy() before calling
+Fl_Input_::cut(), or do Fl_Input_::copy_cuts()
+afterwards. Insert the string t at the current position, and
+leave the mark and position after it. If l is not zero
+then it is assumed to be strlen(t).
+
+ Put the current selection between mark() and
+position() into the specified clipboard. Does not
+replace the old clipboard contents if position() and
+mark() are equal. Clipboard 0 maps to the current text
+selection and clipboard 1 maps to the cut/paste clipboard.
+
+ Does undo of several previous calls to replace().
+Returns non-zero if any change was made.
+
+ Copy all the previous contiguous cuts from the undo
+information to the clipboard. This is used to make ^K work.
+
+ Gets or sets the input field type.
+
+ Gets or sets the read-only state of the input field.
+
+ Gets or sets the word wrapping state of the input field. Word
+wrap is only functional with multi-line input fields.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Input_Choice.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Input_Choice.html
new file mode 100644
index 0000000..6003646
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Input_Choice.html
@@ -0,0 +1,100 @@
+
+
+ A combination of the input widget and a menu button.
+The user can either type into the input area, or use the
+menu button chooser on the right, which loads the input area
+with predefined text. Normally it is drawn with an inset box
+and a white background.
+
+The application can directly access both the input and menu
+widgets directly, using the menubutton()
+and input() accessor methods.
+
+ Creates a new Fl_Input_Choice widget using the given position, size,
+and label string.
+
+ Destroys the widget and any value associated with it.
+
+ Adds an item to the menu. Removes all items from the menu. Returns a reference to the internal Fl_Input widget. Gets or sets the Fl_Menu_Item array used for the menu. Returns a reference to the internal Fl_Menu_Button widget.
+
+ Sets or returns the input widget's current contents. The
+second form sets the contents using the index into the menu
+which you can set as an integer. Setting the value effectively
+'chooses' this menu item, and sets it as the new input text,
+deleting the previous text. The Fl_JPEG_Image class supports loading, caching,
+and drawing of Joint Photographic Experts Group (JPEG) File
+Interchange Format (JFIF) images. The class supports grayscale
+and color (RGB) JPEG image files. The constructor loads the named JPEG image. The destructor free all memory and server resources that are used by
+the image. The Fl_Light_Button subclass display the "on" state by
+turning on a light, rather than drawing pushed in. The shape of the
+"light" is initially set to FL_DOWN_BOX. The color of the light when
+on is controlled with selection_color(), which defaults to
+FL_YELLOW. The class contains a pointer to an array of structures of type Fl_Menu_Item. The
+array may either be supplied directly by the user program, or it may
+be "private": a dynamically allocated array managed by the Fl_Menu_.
+
+ Adds a new menu item, with a title string,
+shortcut string, callback, argument to the
+callback, and flags. If the menu array was directly set with
+menu(x) then copy() is done to make a private
+array.
+
+ The characters "&", "/", "\", and "_" are treated as
+special characters in the label string. The "&" character
+specifies that the following character is an accelerator and
+will be underlined. The "\" character is used to escape the next
+character in the string. Labels starting with the "_" character
+cause a divider to be placed after that menu item. A label of the form "foo/bar/baz" will create a
+submenus called "foo" and "bar" with an
+entry called "baz". The "/" character is ignored if it
+appears as the first character of the label string, e.g.
+"/foo/bar/baz". The label string is copied to new memory and can be freed.
+The other arguments (including the shortcut) are copied into the
+menu item unchanged. If an item exists already with that name then it is replaced with
+this new one. Otherwise this new one is added to the end of the
+correct menu or submenu. The return value is the offset into the array
+that the new entry was placed at. Shortcut can be 0L, or either a modifier/key combination (for example
+FL_CTRL+'A') or a string describing the shortcut in one of two ways: The return value is the index into the array that the entry was put. No items must be added to a menu during a callback to the same menu. The passed string is split at any '|' characters and then
+add(s,0,0,0,0) is done with each section. This is
+often useful if you are just using the value, and is compatible
+with Forms and other GL programs. The section strings use the
+same special characters as described for the long version of add() No items must be added to a menu during a callback to the same menu. Menus must no be cleared during a callback to the same menu. The menu is set to a private copy of the passed Fl_Menu_Item
+array. This is useful if you want to modify the flags of the
+menu items. If the user_data argument is non-NULL, then
+the user_data members of the menu items are set to the
+given value.
+
+
+ Returns a pointer to the menu item with the given (full)
+pathname. If no matching menu item can be found, a NULL pointer
+is returned. This function does not search submenus that are linked
+via FL_SUBMENU_POINTER. Returns the 'menu pathname' (eg. "File/Quit") for the recently picked item in user supplied string 'name'. Useful in the callback function for a menu item, to determine the last picked item's 'menu pathname' string.
+
+ If finditem is specified, name will contain the 'menu pathname' for that item.
+
+ Returns:
+
+ In the case of errors (-1 or -2), 'name' will be an empty string.
+
+
+ Returns a pointer to the last menu item that was picked.
+
+
+ No items must be removed from a menu during a callback to the same menu. Currently there can be only one global()menu. Setting a new
+one will replace the old one. There is no way to remove the
+global() setting (so don't destroy the widget!) The items on the bar and the menus they bring up are defined by a
+single Fl_Menu_Item
+ array. Because a Fl_Menu_Item array defines a hierarchy, the
+top level menu defines the items in the menubar, while the submenus
+define the pull-down menus. Sub-sub menus and lower pop up to the right
+of the submenus. If there is an item in the top menu that is not a title of a
+submenu, then it acts like a "button" in the menubar. Clicking on it
+will pick it. When the user picks an item off the menu, the item's callback is
+done with the menubar as the Fl_Widget* argument. If the item
+does not have a callback the menubar's callback is done instead. Submenus will also pop up in response to shortcuts indicated by
+putting a '&' character in the name field of the menu item. If you put a
+'&' character in a top-level "button" then the shortcut picks it. The
+'&' character in submenus is ignored until the menu is popped up. Typing the shortcut() of any of the menu items will cause
+callbacks exactly the same as when you pick the item with the mouse. The constructor sets menu() to NULL. See
+Fl_Menu_ for the methods to set or change the menu. labelsize(), labelfont(), and labelcolor()
+ are used to control how the menubar items are drawn. They are
+initialized from the Fl_Menu static variables, but you can
+change them if desired. label() is ignored unless you change align() to
+put it outside the menubar. Normally any mouse button will pop up a menu and it is lined up
+below the button as shown in the picture. However an Fl_Menu_Button
+ may also control a pop-up menu. This is done by setting the type()
+, see below. The menu will also pop up in response to shortcuts indicated by
+putting a '&' character in the label(). Typing the shortcut() of any of the menu items will cause
+callbacks exactly the same as when you pick the item with the mouse.
+ The '&' character in menu item names are only looked at when the menu is
+popped up, however. When the user picks an item off the menu, the item's callback is
+done with the menu_button as the Fl_Widget* argument. If the
+item does not have a callback the menu_button's callback is done
+instead. The constructor sets menu() to NULL. See
+Fl_Menu_ for the methods to set or change the menu. A popup menu button is invisible and does not interfere with any
+events other than the mouse button specified (and any shortcuts). The
+widget can be stretched to cover all your other widgets by putting it
+last in the hierarchy so it is "on top". You can also make several
+widgets covering different areas for context-sensitive popup menus. The popup menus appear with the cursor pointing at the previously
+selected item. This is a feature. If you don't like it, do
+value(0) after the menu items are picked to forget the current
+item. You should use the method functions to access structure members and
+not access them directly to avoid compatibility problems with future
+releases of FLTK. The key can be any value returned by
+Fl::event_key(), but will usually be an ASCII letter. Use
+a lower-case letter unless you require the shift key to be held down. The shift flags can be any set of values accepted by
+Fl::event_state(). If the bit is on that shift key must
+be pushed. Meta, Alt, Ctrl, and Shift must be off if they are not in
+the shift flags (zero for the other bits indicates a "don't care"
+setting). X,Y is the position of the mouse cursor, relative to the
+window that got the most recent event (usually you can pass
+Fl::event_x() and Fl::event_y() unchanged here). title is a character string title for the menu. If
+non-zero a small box appears above the menu with the title in it. The menu is positioned so the cursor is centered over the item
+picked. This will work even if picked is in a submenu.
+If picked is zero or not in the menu item table the menu is
+positioned with the cursor in the top-left corner. button is a pointer to an
+Fl_Menu_ from which the color and boxtypes for the menu are
+pulled. If NULL then defaults are used. The title and menubar arguments are used
+internally by the Fl_Menu_Bar widget. See Fl_Browser for
+methods to add and remove lines from the browser. This is far from the nirvana of text editors, and is probably only
+good for small bits of text, 10 lines at most. I think FLTK can be
+used to write a powerful text editor, but it is not going to be a
+built-in feature. Powerful text editors in a toolkit are a big source
+of bloat. There is a single subclass,
+Fl_Multiline_Output, which allows you to display multiple lines of
+text. The text may contain any characters except \0, and will correctly
+display anything, using ^X notation for unprintable control characters
+and \nnn notation for unprintable characters with the high bit set. It
+assumes the font can draw any characters in the ISO-Latin1 character
+set. The second two forms change the text and set the mark and the point
+to the end of it. The string is copied to the internal buffer. Passing
+NULL is the same as "". This returns non-zero if the new value is
+different than the current one. You can use the second version to
+directly set the length if you know it already or want to put nul's in
+the text. If no hardware support is found the overlay is simulated by drawing
+directly into the on-screen copy of the double-buffered window, and
+"erased" by copying the backbuffer over it again. This means the
+overlay will blink if you change the image in the window. The Fl_PNG_Image class supports loading, caching,
+and drawing of Portable Network Graphics (PNG) image files. The
+class loads colormapped and full-color images and handles color-
+and alpha-based transparency. The constructor loads the named PNG image. The destructor free all memory and server resources that are used by
+the image. The Fl_PNM_Image class supports loading, caching,
+and drawing of Portable Anymap (PNM, PBM, PGM, PPM) image files. The class
+loads bitmap, grayscale, and full-color images in both ASCII and
+binary formats. The constructor loads the named PNM image. The destructor free all memory and server resources that are used by
+the image. If type() is Fl_Pack::HORIZONTAL all the children are
+resized to the height of the Fl_Pack, and are moved next to
+each other horizontally. If type() is not Fl_Pack::HORIZONTAL
+ then the children are resized to the width and are stacked below each
+other. Then the Fl_Pack resizes itself to surround the child
+widgets. This widget is needed for the Fl_Tabs.
+ In addition you may want to put the Fl_Pack inside an
+Fl_Scroll. Gets or sets the box type for the widget, which identifies a
+routine that draws the background of the widget. Only frame
+box types may be used with the Fl_Pack widget. The resizable for Fl_Pack is set to NULL by
+default. See also: Fl_Group::resizable() The Fl_Pixmap class supports caching and drawing of colormap
+(pixmap) images, including transparency. The constructors create a new pixmap from the specified XPM data. The destructor free all memory and server resources that are used by
+the pixmap. Fl_Preferences provides methods to store user
+setting between application starts. It is similar to the
+Registry on WIN32 and Preferences on MacOS, and provides a
+simple configuration mechanism for UNIX.
+
+ Fl_Preferences uses a hierarchy to store data. It
+bundles similar data into groups and manages entries into those
+groups as name/value pairs.
+
+ Preferences are stored in text files that can be edited
+manually. The file format is easy to read and relatively
+forgiving. Preferences files are the same on all platforms. User
+comments in preference files are preserved. Filenames are unique
+for each application by using a vendor/application naming
+scheme. The user must provide default values for all entries to
+ensure proper operation should preferences be corrupted or not
+yet exist.
+
+ Entries can be of any length. However, the size of each
+preferences file should be kept under 100k for performance
+reasons. One application can have multiple preferences files.
+Extensive binary data however should be stored in separate
+files; see the getUserdataPath()
+method.
+
+ The constructor creates a group that manages name/value pairs and
+child groups. Groups are ready for reading and writing at any time.
+The root argument is either Fl_Preferences::USER
+or Fl_Preferences::SYSTEM.
+
+ The first format creates the base instance for all
+following entries and reads existing databases into memory. The
+vendor argument is a unique text string identifying the
+development team or vendor of an application. A domain name or
+an EMail address are great unique names, e.g.
+"researchATmatthiasm.com" or "fltk.org". The
+application argument can be the working title or final
+name of your application. Both vendor and
+application must be valid relative UNIX pathnames and
+may contain '/'s to create deeper file structures.
+
+ The second format is used to create a preferences file at an
+arbitrary position in the file system. The file name is generated
+as path/application.prefs. If application
+is 0, path must contain the full file name.
+
+ The third format generates a new group of preference entries
+inside the group or file p. The groupname argument
+identifies a group of entries. It can contain '/'s to get quick
+access to individual elements inside the hierarchy.
+
+ The destructor removes allocated resources. When used on the
+base preferences group, the destructor flushes all
+changes to the preferences file and deletes all internal
+databases.
+
+ Removes a single entry (name/value pair).
+
+ Deletes a group.
+
+ Returns the number of entries (name/value) pairs in a group.
+
+ Returns the name of an entry. There is no guaranteed order of
+entry names. The index must be within the range given by
+entries().
+
+ Returns non-zero if an entry with this name exists.
+
+ Write all preferences to disk. This function works only with
+the base preference group. This function is rarely used as
+deleting the base preferences flushes automatically.
+
+ Creates a path that is related to the preferences file and
+that is usable for application data beyond what is covered by
+Fl_Preferences.
+
+ Reads an entry from the group. A default value must be
+supplied. The return value indicates if the value was available
+(non-zero) or the default was used (0). If the 'char
+*&text' or 'void *&data' form is used,
+the resulting data must be freed with 'free(value)'.
+ 'maxLength' is the maximum length of text that will be read. The text buffer must allow for one additional byte for a trailling zero.
+
+ Returns the name of the Nth group. There is no guaranteed
+order of group names. The index must be within the range given
+by groups().
+
+ Returns non-zero if a group with this name exists.
+Groupnames are relative to the Preferences node and can contain a path.
+"." describes the current node, "./" describes the topmost node.
+By preceding a groupname with a "./", its path becomes relative to the topmost node.
+
+ Returns the number of groups that are contained within a
+group.
+
+ Sets an entry (name/value pair). The return value indicates if there
+was a problem storing the data in memory. However it does not
+reflect if the value was actually stored in the preferences
+file.
+
+ Returns the size of the value part of an entry.
+
+ 'Name' provides a simple method to create numerical or more complex
+procedural names for entries and groups on the fly,
+i.e. prefs.set(Fl_Preferences::Name("File%d",i),file[i]);.
+See test/preferences.cxx as a sample for writing arrays into preferences.
+'Name' is actually implemented as a class inside Fl_Preferences. It casts
+into const char* and gets automatically destroyed after the enclosing call.
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Progress.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Progress.html
new file mode 100644
index 0000000..f6005c3
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Progress.html
@@ -0,0 +1,73 @@
+
+ The Fl_Progress widget displays a progress bar for the
+user.
+
+ The constructor creates the progress bar using the position,
+size, and label.
+
+ You can set the background color with color() and the progress bar color with
+selection_color(), or you can set both colors together with color(unsigned bg, unsigned sel).
+
+ The default colors are FL_BACKGROUND2_COLOR and FL_YELLOW, resp.
+
+ The destructor removes the progress bar.
+
+ Gets or sets the maximum value in the progress widget.
+
+ Gets or sets the minimum value in the progress widget.
+
+ Gets or sets the current value in the progress widget.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_RGB_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_RGB_Image.html
new file mode 100644
index 0000000..d67f48b
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_RGB_Image.html
@@ -0,0 +1,64 @@
+
+ The Fl_RGB_Image class supports caching and drawing
+of full-color images with 1 to 4 channels of color information.
+Images with an even number of channels are assumed to contain
+alpha information, which is used to blend the image with the
+contents of the screen. Fl_RGB_Image is defined in
+<FL/Fl_Image.H>, however for compatibility reasons
+<FL/Fl_RGB_Image.H> should be included. The constructor creates a new image from the specified data. The destructor free all memory and server resources that are used by
+the image. The Fl_Round_Button subclass display the "on" state by
+turning on a light, rather than drawing pushed in. The shape of the
+"light" is initially set to FL_ROUND_DOWN_BOX. The color of the light
+when on is controlled with selection_color(), which defaults to
+FL_RED. If all of the child widgets are packed together into a solid
+rectangle then you want to set box() to FL_NO_BOX or
+one of the _FRAME types. This will result in the best output.
+ However, if the child widgets are a sparse arrangment you must set
+box() to a real _BOX type. This can result in some
+blinking during redrawing, but that can be solved by using a
+Fl_Double_Window. This widget can also be used to pan around a single child widget
+"canvas". This child widget should be of your own class, with a
+draw() method that draws the contents. The scrolling is done by
+changing the x() and y() of the widget, so this child
+must use the x() and y() to position it's drawing.
+ To speed up drawing it should test fl_push_clip()
+. Another very useful child is a single
+Fl_Pack, which is itself a group that packs it's children
+together and changes size to surround them. Filling the Fl_Pack
+ with Fl_Tabs groups (and then putting
+normal widgets inside those) gives you a very powerful scrolling list
+of individually-openable panels. Fluid lets you create these, but you can only lay out objects that
+fit inside the Fl_Scroll without scrolling. Be sure to leave
+space for the scrollbars, as Fluid won't show these either. You cannot use Fl_Window as a child of this since the
+clipping is not conveyed to it when drawn, and it will draw over the
+scrollbars and neighboring objects. Fl_Scroll widgets should not be nested. Having an Fl_Scroll
+inside another Fl_Scroll may result in drawing errors when resizing. [protected] This method returns the bounding box for the interior of the scrolling
+area, inside the scrollbars.
+
+ Scrollbars have step(1) preset (they always return
+integers). If desired you can set the step() to non-integer
+values. You will then have to use casts to get at the floating-point
+versions of value() from Fl_Slider. See Fl_Browser for
+methods to add and remove lines from the browser. Deselects any selected item.
+ The Fl_Shared_Image class supports caching, loading,
+and drawing of image files. Most applications will also want to
+link against the The constructors create a new shared image record in the
+image cache.
+
+ The constructors are protected and cannot be used directly
+from a program. Use the get() method instead.
+
+ The destructor free all memory and server resources that are
+used by the image. The destructor is protected and cannot be
+used directly from a program. Use the release() method
+instead.
+
+ For the "fill" sliders this is the size of the area around the end
+that causes a drag effect rather than causing the slider to jump to the
+mouse. The Fl_Spinner widget is a combination of the input
+widget and repeat buttons. The user can either type into the
+input area or use the buttons to change the value.
+
+ Creates a new Fl_Spinner widget using the given position, size,
+and label string.
+
+ Destroys the widget and any value associated with it.
+
+ Sets or returns the format string for the value. Sets or returns the maximum value of the widget. Sets or returns the minimum value of the widget. Sets the minimum and maximum values for the widget. Sets or returns the amount to change the value when the user
+clicks a button.
+Before setting step to a non-integer value, the spinner
+type() should be changed
+to floating point. Sets or returns the color of the text in the input field. Sets or returns the font of the text in the input field. Sets or returns the size of the text in the input field. Sets or returns the numeric representation in the input field.
+Valid values are FL_INT_INPUT and FL_FLOAT_INPUT.
+The first form also changes the format() template.
+Please note that type is not a virtual function.
+Setting a new spinner type via a superclass pointer will not work. Sets or returns the current value of the widget.
+Before setting value to a non-integer value, the spinner
+type() should be changed
+to floating point. The Fl_Tabs widget is the "file card tabs"
+interface that allows you to put lots and lots of buttons and
+switches in a panel, as popularized by many toolkits.
+
+ Clicking the tab makes a child visible() by calling
+show() on it, and all other children are made invisible
+by calling hide() on them. Usually the children are Fl_Group widgets
+containing several widgets themselves.
+
+ Each child makes a card, and it's label() is printed
+on the card tab, including the label font and style. The
+selection color of that child is used to color the tab, while
+the color of the child determines the background color of the
+pane.
+
+ The size of the tabs is controlled by the bounding box of the
+children (there should be some space between the children and
+the edge of the Fl_Tabs), and the tabs may be placed
+"inverted" on the bottom, this is determined by which
+gap is larger. It is easiest to lay this out in fluid, using the
+fluid browser to select each child group and resize them until
+the tabs look the way you want them to.
+
+ Creates a new Fl_Tabs widget using the given position, size,
+and label string. The default boxtype is FL_THIN_UP_BOX.
+
+ Use add(Fl_Widget
+*) to add each child, which are usually
+Fl_Group widgets. The children should be sized to stay
+away from the top or bottom edge of the Fl_Tabs widget,
+which is where the tabs will be drawn.
+
+ The destructor also deletes all the children. This
+allows a whole tree to be deleted at once, without having to
+keep a pointer to all the children in the user code. A kludge
+has been done so the Fl_Tabs and all of it's children
+can be automatic (local) variables, but you must declare the
+Fl_Tabs widget first so that it is destroyed
+last.
+
+ Gets or sets the currently visible widget/tab.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Buffer.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Buffer.html
new file mode 100644
index 0000000..c17f8bc
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Buffer.html
@@ -0,0 +1,465 @@
+
+ The Fl_Text_Buffer class is used by the
+Fl_Text_Display
+and
+Fl_Text_Editor
+to manage complex text data and is based upon the
+excellent NEdit text editor engine - see
+http://www.nedit.org/. Creates a new text buffer of the specified initial size.
+
+ Destroys a text buffer.
+
+ Adds a callback function that is called whenever the text buffer is
+modified. The callback function is declared as follows:
+
+ Appends the text string to the end of the buffer.
+
+ Appends the named file to the end of the buffer. Returns 0 on
+success, non-zero on error (strerror() contains reason). 1 indicates
+open for read failed (no data loaded). 2 indicates error occurred
+while reading data (data was partially loaded).
+
+ Calls all modify callbacks that have been registered using
+the add_modify_callback()
+method.
+
+ Returns the character at the specified position in the buffer.
+
+ Returns the column width of the specified character. The
+indent argument specifies the current column position,
+and tabDist specifies the number of columns to use for
+each tab.
+
+ The nullSubsChar argument specifies the current
+nul character.
+
+ Clears text in the specified area.
+
+ Copies text from one buffer to this one; fromBuf may
+be the same as this.
+
+ Determines the number of characters that will be displayed
+between lineStartPos and targetPos.
+
+ Determines the number of lines between startPos and
+endPos.
+
+ Expands the given character to a displayable format. Tabs and
+other control characters are given special treatment.
+
+ Finds the previous occurrence of the specified character.
+
+ Finds the next occurrence of the specified character.
+
+ Finds the previous occurrence of the specified characters.
+
+ Finds the next occurrence of the specified characters.
+Search forwards in buffer for characters in searchChars, starting
+with the character startPos, and returning the result in foundPos
+returns 1 if found, 0 if not.
+
+ Highlights the specified text within the buffer.
+
+ Returns the current highlight positions.
+
+ Highlights the specified rectangle of text within the buffer.
+
+ Returns the current highlight selection.
+
+ Returns the highlighted text. When you are done with the
+text, free it using the free() function.
+
+ Inserts a column of text without calling the modify callbacks.
+
+ Inserts a file at the specified position. Returns 0 on success,
+non-zero on error (strerror() contains reason). 1 indicates open
+for read failed (no data loaded). 2 indicates error occurred
+while reading data (data was partially loaded).
+
+ Inserts text at the specified position.
+
+ Returns the number of characters in the buffer.
+
+ Returns the end position of the line.
+
+ Returns the start position of the line.
+
+ Returns the text for the line containing the specified
+character position. When you are done with the text, free it
+using the free() function.
+
+ Replaces the current buffer with the contents of a file. Returns 0
+on success, non-zero on error (strerror() contains reason). 1 indicates
+open for read failed (no data loaded). 2 indicates error occurred
+while reading data (data was partially loaded).
+
+ Returns the current nul substitution character.
+
+ Writes the specified portions of the file to a file. Returns 0 on success, non-zero
+on error (strerror() contains reason). 1 indicates open for write failed
+(no data saved). 2 indicates error occurred while writing data
+(data was partially saved).
+
+ Replaces a rectangular region of text with the given text.
+
+ Returns the primary selection.
+
+ Removes a modify callback.
+
+ Deletes a rectangular area of text in the buffer.
+
+ Deletes a range of characters in the buffer.
+
+ Removes the text in the secondary selection.
+
+ Removes the text in the primary selection.
+
+ Replaces the text in a rectangular area.
+
+ Replaces the text in the specified range of characters in the buffer.
+
+ Replaces the text in the secondary selection.
+
+ Replaces the text in the primary selection.
+
+ Returns the buffer position for the Nth previous line.
+
+ Saves the entire buffer to a file. Returns 0 on success, non-zero
+on error (strerror() contains reason). 1 indicates open for write failed
+(no data saved). 2 indicates error occurred while writing data
+(data was partially saved).
+
+ Searches backwards for the specified string.
+
+ Searches forwards for the specified string.
+
+ Returns the secondary selection.
+
+ Returns the text in the secondary selection. When you are
+done with the text, free it using the free() function.
+
+ Selects a rectangle of characters in the secondary selection.
+
+ Selects a range of characters in the secondary selection.
+
+ Turns the secondary selection off.
+
+ Returns a non-zero number if any text has been selected, or 0
+if no text is selected.
+
+ Returns the current selection.
+
+ Returns the currently selected text. When you are done with
+the text, free it using the free() function.
+
+ Selects a rectangle of characters in the buffer.
+
+ Selects a range of characters in the buffer.
+
+ Skips forward the indicated number of characters in the
+buffer from the start position.
+
+ Returns the buffer position for the Nth line after the start
+position.
+
+ Replaces nul characters in the given string with the
+nul substitution character.
+
+ Gets or sets the tab width.
+
+ Returns the text from the given rectangle. When you are done
+with the text, free it using the free() function.
+
+ Returns the text from the range of characters. When you are
+done with the text, free it using the free() function.
+
+ Gets or sets the text in the buffer. The first form
+returns a copy of the text in the buffer which you must
+later free() when done using it. The second form sets the text in
+the buffer, making an internal copy of the string that is automatically managed.
+
+ Unhighlights text in the buffer.
+
+ Unselects text in the buffer.
+
+ Replaces the nul substitution characters in the
+provided string with the nul character.
+
+ Returns the position for the end of the word.
+
+ Returns the position for the start of the word.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Display.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Display.html
new file mode 100644
index 0000000..cc9e9d4
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Display.html
@@ -0,0 +1,246 @@
+
+ This is the FLTK text display widget. It allows the user to
+view multiple lines of text and supports highlighting and
+scrolling. The buffer that is displayed in the widget is managed
+by the Fl_Text_Buffer
+class.
+
+
+ Creates a new text display widget.
+
+ Destroys a text display widget.
+
+ Sets or gets the current text buffer associated with the text widget.
+Multiple text widgets can be associated with the same text buffer.
+
+ Sets or gets the text cursor color.
+
+ Sets the text cursor style to one of the following:
+
+ Hides the text cursor.
+
+ Sets the text buffer, text styles, and callbacks to use when
+displaying text in the widget. Style buffers cannot be shared
+between widgets and are often used to do syntax highlighting.
+The editor example from Chapter 4
+shows how to use the Returns non-zero if the specified mouse position is inside the current
+selection.
+
+ Inserts text at the current insert position.
+
+ Sets or gets the current insert position.
+
+ Moves the current insert position down one line.
+
+ Moves the current insert position left one character.
+
+ Moves the current insert position right one character.
+
+ Moves the current insert position up one line.
+
+ Moves the current insert position right one word.
+
+ Replaces text at the current insert position.
+
+ Returns the style associated with the character at position
+ Moves the current insert position left one word.
+
+ Marks text from Sets or gets where scrollbars are attached to the widget -
+ Sets or gets the width/height of the scrollbars.
+
+ Scrolls the current buffer to start at the specified line and column.
+
+ Shows or hides the text cursor.
+
+ Scrolls the text buffer to show the current insert position.
+
+ Sets or gets the default color of text in the widget.
+
+ Sets or gets the default font used when drawing text in the widget.
+
+ Sets or gets the default size of text in the widget.
+
+ Moves the insert position to the end of the current word.
+
+ Moves the insert position to the beginning of the current word.
+
+ If mode is not zero, this call enables automatic word wrapping at column pos.
+Word-wrapping does not change the text buffer itself, only the way that the text is displayed.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Editor.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Editor.html
new file mode 100644
index 0000000..2701647
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Text_Editor.html
@@ -0,0 +1,221 @@
+
+ This is the FLTK text editor widget. It allows the user to
+edit multiple lines of text and supports highlighting and
+scrolling. The buffer that is displayed in the widget is managed
+by the Fl_Text_Buffer
+class.
+
+ The constructor creates a new text editor widget.
+
+ The destructor frees all memory used by the text editor widget.
+
+ Adds all of the default editor key bindings to the specified key binding list.
+
+ Adds a single key binding to the specified or current key binding list.
+
+ Returns the function associated with a key binding.
+
+ Sets the default key function for unassigned keys.
+
+ Sets or gets the current insert mode; if non-zero, new text
+is inserted before the current cursor position. Otherwise, new
+text replaces text at the current cursor position.
+
+ Does a backspace in the current buffer.
+
+ Does a copy of selected text in the current buffer.
+
+ Extends the current selection in the direction indicated by
+control key Moves the current text cursor in the direction indicated by
+control key Does a cut of selected text in the current buffer.
+
+ Inserts the text associated with the key Does a delete of selected text or the current character in
+the current buffer.
+
+ Moves the text cursor down one line.
+
+ Moves the text cursor to the end of the current line.
+
+ Inserts a newline at the current cursor position.
+
+ Moves the text cursor to the beginning of the current line.
+
+ Ignores the keypress.
+
+ Toggles the insert mode in the text editor.
+
+ Moves the text cursor to the left in the buffer.
+
+ Moves the text cursor in the direction indicated by key
+ Moves the text cursor down one page.
+
+ Moves the text cursor up one page.
+
+ Pastes the contents of the clipboard at the current text cursor position.
+
+ Moves the text cursor one character to the right.
+
+ Selects all text in the buffer.
+
+ Extends the current selection in the direction of key Moves the text cursor up one line.
+
+ Removes all of the key bindings associated with the text editor or list.
+
+ Removes a single key binding from the text editor or list.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Tile.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Tile.gif
new file mode 100644
index 0000000..f14f0b4
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Tile.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Tile.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Tile.html
new file mode 100644
index 0000000..73df45f
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Tile.html
@@ -0,0 +1,91 @@
+
+ The Fl_Tile class lets you resize the children by dragging
+the border between them:
+
+ For the tiling to work correctly, the children of an
+Fl_Tile must cover the entire area of the widget, but not
+overlap. This means that all children must touch each
+other at their edges, and no gaps can't be left inside the
+Fl_Tile.
+
+ Fl_Tile does not normailly draw any graphics of its own.
+The "borders" which can be seen in the snapshot above
+are actually part of the children. Their boxtypes have been set
+to FL_DOWN_BOX creating the impression of
+"ridges" where the boxes touch. What you see are
+actually two adjacent FL_DOWN_BOX's drawn next to each
+other. All neighboring widgets share the same edge - the widget's
+thick borders make it appear as though the widgets aren't actually
+touching, but they are. If the edges of adjacent widgets do not
+touch, then it will be impossible to drag the corresponding
+edges. Fl_Tile allows objects to be resized to zero dimensions.
+To prevent this you can use the resizable() to limit where
+corners can be dragged to. Even though objects can be resized to zero sizes, they must
+initially have non-zero sizes so the Fl_Tile can figure out
+their layout. If desired, call position() after creating the
+children but before displaying the window to set the borders where you
+want. The Fl_Tiled_Image class supports tiling of images
+over a specified area. The source (tile) image is not
+copied unless you call the color_average(),
+desaturate(),
+or inactive()
+methods. The constructors create a new tiled image containing the specified image. The destructor frees all memory and server resources that are used by
+the tiled image. Returns the image that will be tiled. The toggle button is a push button that needs to be clicked once
+to toggle on, and one more time to toggle off.
+The Fl_Toggle_Button subclass displays the "on" state by
+drawing a pushed-in button. Buttons generate callbacks when they are clicked by the user. You
+control exactly when and how by changing the values for type()
+and when().
+ The Fl_Tooltip class provides tooltip support for
+all FLTK widgets. Gets or sets the tooltip delay. The default delay is 1.0 seconds.
+
+ Returns non-zero if tooltips are enabled.
+
+ Enables tooltips on all widgets (or disables if b is false).
+
+ Same as enable(0), disables tooltips on all widgets.
+
+ This method is called when the mouse pointer enters a
+widget.
+
+ You may be able to use this to provide tooltips for internal pieces
+of your widget. Call this after setting Fl::belowmouse() to
+your widget (because that calls the above enter() method). Then figure
+out what thing the mouse is pointing at, and call this with the widget
+(this pointer is used to remove the tooltip if the widget is deleted
+or hidden, and to locate the tooltip), the rectangle surrounding the
+area, relative to the top-left corner of the widget (used to calculate
+where to put the tooltip), and the text of the tooltip (which must be
+a pointer to static data as it is not copied).
+
+ This method is called when the mouse pointer leaves a
+widget.
+
+ Gets or sets the background color for tooltips. The default
+background color is a pale yellow.
+
+ Gets or sets the typeface for the tooltip text.
+
+ Gets or sets the tooltip hover delay, the delay between tooltips.
+The default delay is 0.2 seconds.
+
+ Gets or sets the size of the tooltip text.
+
+ Gets or sets the color of the text in the tooltip. The default is
+black.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Valuator.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Valuator.html
new file mode 100644
index 0000000..7e90d96
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Valuator.html
@@ -0,0 +1,199 @@
+
+ There are probably more of these classes in FLTK than any others: In the above diagram each box surrounds an actual subclass. These
+are further differentiated by setting the
+type() of the widget to the symbolic value labeling the
+widget. The ones labelled "0" are the default versions with a
+type(0). For consistency the symbol FL_VERTICAL is
+defined as zero. Creates a new Fl_Valuator widget using the given position,
+size, and label string. The default boxtype is FL_NO_BOX.
+
+ Destroys the valuator.
+
+ Sets the minimum (a) and maximum (b) values for
+the valuator widget.
+
+ This value is true if the user has moved the slider. It is
+turned off by value(x) and just before doing a callback
+(the callback can turn it back on if desired).
+
+ Clamps the passed value to the valuator range.
+
+ Clears the changed() flag.
+
+ Uses internal rules to format the fields numerical value into
+the character array pointed to by the passed parameter. The actual format used depends on the current step value. If
+the step value has been set to zero then a %g format is used.
+If the step value is non-zero, then a %.*f format is used,
+where the precision is calculated to show sufficient digits
+for the current step value. An integer step value, such as 1
+or 1.0, gives a precision of 0, so the formatted value will
+appear as an integer. This method is used by the Fl_Value_... group of widgets to
+format the current value into a text string.
+The return value is the length of the formatted text.
+The formatted value is written into in buffer.
+buffer should have space for at least 128 bytes. You may override this function to create your own text formatting. Adds n times the step value to the passed value. If
+step was set to zero it uses fabs(maximum() - minimum()) /
+100.
+
+ Gets or sets the maximum value for the valuator.
+
+ Gets or sets the minimum value for the valuator.
+
+ Sets the step value to 1/10digits.
+
+ Sets the minimum and maximum values for the valuator. When
+the user manipulates the widget, the value is limited to this
+range. This clamping is done after rounding to the step
+value (this makes a difference if the range is not a multiple of
+the step).
+
+ The minimum may be greater than the maximum. This has the
+effect of "reversing" the object so the larger values
+are in the opposite direction. This also switches which end of
+the filled sliders is filled. Some widgets consider this a "soft" range. This
+means they will stop at the range, but if the user releases and
+grabs the control again and tries to move it further, it is
+allowed. The range may affect the display. You must redraw()
+the widget after changing the range. Round the passed value to the nearest step increment. Does
+nothing if step is zero.
+
+ Sets the changed() flag.
+
+ Gets or sets the step value. As the user moves the mouse the
+value is rounded to the nearest multiple of the step value. This
+is done before clamping it to the range. For most widgets
+the default step is zero.
+
+ For precision the step is stored as the ratio of two
+integers, A/B. You can set these integers directly. Currently
+setting a floating point value sets the nearest A/1 or 1/B value
+possible. Gets or sets the current value. The new value is not
+clamped or otherwise changed before storing it. Use
+clamp() or round() to modify the value before
+calling value(). The widget is redrawn if the new value
+is different than the current one. The initial value is zero.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Input.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Input.gif
new file mode 100644
index 0000000..feabbff
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Input.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Input.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Input.html
new file mode 100644
index 0000000..2e776ba
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Input.html
@@ -0,0 +1,115 @@
+
+ The Fl_Value_Input widget displays a numeric value.
+The user can click in the text field and edit it - there is in
+fact a hidden Fl_Input widget with
+type(FL_FLOAT_INPUT) or type(FL_INT_INPUT) in
+there - and when they hit return or tab the value updates to
+what they typed and the callback is done.
+
+ If step() is non-zero and integral, then the range of numbers
+is limited to integers instead of floating point numbers. As
+well as displaying the value as an integer, typed input is also
+limited to integer values, even if the hidden Fl_Input widget
+is of type(FL_FLOAT_INPUT). If step() is non-zero, the user can also drag the
+mouse across the object and thus slide the value. The left
+button moves one step() per pixel, the middle by 10
+* step(), and the right button by 100 * step(). It
+is therefore impossible to select text by dragging across it,
+although clicking can still move the insertion cursor. If step() is non-zero and integral, then the range
+of numbers are limited to integers instead of floating point
+values.
+
+ Creates a new Fl_Value_Input widget using the given
+position, size, and label string. The default boxtype is
+FL_DOWN_BOX.
+
+ Destroys the valuator.
+
+ Get or set the color of the text cursor. The text cursor is
+black by default.
+
+ If "soft" is turned on, the user is allowed to drag
+the value outside the range. If they drag the value to one of
+the ends, let go, then grab again and continue to drag, they can
+get to any value. The default is true.
+
+ Gets or sets the color of the text in the value box.
+
+ Gets or sets the typeface of the text in the value box.
+
+ Gets or sets the size of the text in the value box.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Output.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Output.gif
new file mode 100644
index 0000000..18cf45a
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Output.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Output.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Output.html
new file mode 100644
index 0000000..234d27d
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Output.html
@@ -0,0 +1,69 @@
+
+ This is much lighter-weight than
+Fl_Value_Input because it contains no text editing code or
+character buffer. All "property" accessing methods, such as color(),
+parent(), or argument() are implemented as trivial inline
+functions and thus are as fast and small as accessing fields in a
+structure. Unless otherwise noted, the property setting methods such as
+color(n) or label(s) are also trivial inline functions,
+even if they change the widget's appearance. It is up to the user code
+to call redraw() after these. Creates a widget at the given position and size. The
+Fl_Widget is a protected constructor, but all derived
+widgets have a matching public constructor. It takes a value for
+x(), y(), w(), h(), and an
+optional value for label().
+
+
+ Destroys the widget. Destroying single widgets is not very
+common, and it is your responsibility to either
+remove() them from any enclosing group or destroy that
+group immediately after destroying the children. You
+almost always want to destroy the parent group instead which
+will destroy all of the child widgets and groups in that group.
+
+
+ Fl_Widget::active() returns whether the widget is
+active. Fl_Widget::active_r() returns whether the
+widget and all of its parents are active. Inactive widgets
+will be drawn "grayed out", e.g. with less contrast than the
+active widget. Inactive widgets will not receive any keyboard or
+mouse button events. Other events (including FL_ENTER,
+FL_MOVE, FL_LEAVE, FL_SHORTCUT, and
+others) will still be sent. A widget is only active if
+active() is true on it and all of its parents.
+
+ Changing this value will send FL_ACTIVATE or
+FL_DEACTIVATE to the widget if active_r() is true.
+ Currently you cannot deactivate Fl_Window widgets. Gets or sets the label alignment, which controls how the
+label is displayed next to or inside the widget. The default
+value is FL_ALIGN_CENTER, which centers the label
+inside the widget. The value can be any of these constants
+bitwise-OR'd together:
+
+ Gets or sets the current user data (long) argument
+that is passed to the callback function.
+
+ This is implemented by casting the long
+ value to a void * and may not be portable on
+ some machines.
+
+ Gets or sets the box type for the widget, which identifies a
+routine that draws the background of the widget. See Box Types for the available
+types. The default depends on the widget, but is usually
+FL_NO_BOX or FL_UP_BOX.
+
+
+ Gets or sets the current callback function for the widget.
+Each widget has a single callback.
+
+
+ Fl_Widget::changed() is a flag that is turned on
+when the user changes the value stored in the widget. This is
+only used by subclasses of Fl_Widget that store values,
+but is in the base class so it is easier to scan all the widgets
+in a panel and do_callback() on the changed ones in
+response to an "OK" button.
+
+ Most widgets turn this flag off when they do the callback, and when
+the program sets the stored value. Hides the widget; you must still redraw the parent to see a
+change in the window. Normally you want to use the Disables keyboard focus navigation with this widget;
+normally, all widgets participate in keyboard focus navigation.
+
+
+ Gets or sets the background color of the widget. The color is
+passed to the box routine. The color is either an index into an
+internal table of RGB colors or an RGB color value generated
+using fl_rgb_color(). The default for most widgets is
+FL_BACKGROUND_COLOR. See the enumeration list for
+predefined colors. Use Fl::set_color() to
+redefine colors.
+
+ The two color form sets both the background and selection
+colors. See the description of the selection_color()
+method for more information.
+
+
+ Returns 1 if b is a child of this widget, or is
+equal to this widget. Returns 0 if b is NULL.
+
+
+ Sets the current label. Unlike label(), this method
+allocates a copy of the label string instead of using the
+original string pointer. The first version returns non-zero if draw() needs to be
+called. The damage value is actually a bit field that the widget
+subclass can use to figure out what parts to draw.
+
+ The last two forms set the damage bits for the widget; the
+last form damages the widget within the specified bounding box.
+
+ The default callback, which puts a pointer to the widget on
+the queue returned by Fl::readqueue(). You
+may want to call this from your own callback.
+
+
+ Gets or sets the image to use as part of the widget label.
+This image is used when drawing the widget in the inactive
+state.
+
+
+ Causes a widget to invoke its callback function, optionally
+with arbitrary arguments.
+
+
+ Handles the specified event. You normally don't call this
+method directly, but instead let FLTK do it when the user
+interacts with the widget. When implemented in a new widget, this function must return 0
+if the widget does not use the event or 1 if it uses the
+event. Gets or sets the image to use as part of the widget label.
+This image is used when drawing the widget in the active state.
+
+
+ Returns 1 if this widget is a child of a, or is
+equal to a. Returns 0 if a is NULL.
+
+
+ Get or set the current label pointer. The label is shown
+somewhere on or next to the widget. The passed pointer is stored
+unchanged in the widget (the string is not copied), so if
+you need to set the label to a formatted value, make sure the
+buffer is static, global, or allocated. The copy_label() method
+can be used to make a copy of the label string
+automatically. Gets or sets the label color. The default color is FL_FOREGROUND_COLOR.
+
+
+ Gets or sets the font to use. Fonts are identified by small
+8-bit indexes into a table. See the enumeration list for
+predefined typefaces. The default value uses a Helvetica
+typeface (Arial for Microsoft® Windows®). The function
+Fl::set_font() can
+define new typefaces.
+
+
+ Gets or sets the font size in pixels. The default size is 14
+pixels.
+
+
+ Gets or sets the labeltype which
+identifies the function that draws the label of the widget. This
+is generally used for special effects such as embossing or for
+using the label() pointer as another form of data such
+as an icon. The value FL_NORMAL_LABEL prints the label
+as plain text.
+
+
+ output() means the same as !active() except
+it does not change how the widget is drawn. The widget will not
+receive any events. This is useful for making scrollbars or
+buttons that work as displays rather than input devices.
+
+
+ Returns a pointer to the parent widget. Usually this is a Fl_Group or Fl_Window. Returns
+NULL if the widget has no parent.
+
+
+ Marks the widget as needing its draw() routine called.
+
+
+ Marks the widget or the parent as needing a redraw for the
+label area of a widget.
+
+
+ Change the size or position of the widget. This is a virtual
+function so that the widget may implement its own handling of
+resizing. The default version does not call the
+redraw() method, but instead relies on the parent
+widget to do so because the parent may know a faster way to
+update the display, such as scrolling from the old position.
+
+ Some window managers under X11 call resize a lot more
+often than needed. Please verify that the position or size of
+a widget did actually change before doing any extensiive calculations.
+
+ position(x,y) is a shortcut for resize(x,y,w(),h()),
+and size(w,h) is a shortcut for resize(x(),y(),w,h). Gets or sets the selection color, which is defined for Forms
+compatibility and is usually used to color the widget when it is
+selected, although some widgets use this color for other
+purposes. You can set both colors at once with
+color(a,b).
+
+
+ This is the same as (active() && !output()
+&& visible()) but is faster.
+
+
+ Gets or sets a string of text to display in a popup tooltip
+window when the user hovers the mouse over the widget. The
+string is not copied, so make sure any formatted string
+is stored in a static, global, or allocated buffer.
+
+ If no tooltip is set, the tooltip of the parent is inherited.
+Setting a tooltip for a group and setting no tooltip for a child
+will show the group's tooltip instead. To avoid this behavior,
+you can set the child's tooltip to an empty string
+("").
+
+ Returns the widget type value, which is used for Forms
+compatability and to simulate RTTI.
+
+ Returns the position of the upper-left corner of the widget
+in its enclosing Fl_Window (not its parent if that is not
+an Fl_Window), and its width and height.
+
+
+ Gets or sets the current user data (void *) argument
+that is passed to the callback function.
+
+
+ Returns a pointer to the primary Fl_Window widget.
+Returns NULL if no window is associated with this
+widget. Note: for an Fl_Window widget, this returns
+its parent window (if any), not this window.
+
+
+ Makes the widget visible; you must still redraw the parent
+widget to see a change in the window. Normally you want to use
+the Enables keyboard focus navigation with this widget; note,
+however, that this will not necessarily mean that the widget
+will accept focus, but for widgets that can accept focus, this
+method enables it if it has been disabled.
+
+
+ An invisible widget never gets redrawn and does not get
+events. The visible() method returns true if the
+widget is set to be visible.The visible_r() method
+returns true if the widget and all of its parents are visible. A
+widget is only visible if visible() is true on it
+and all of its parents.
+
+ Changing it will send FL_SHOW or FL_HIDE
+events to the widget. Do not change it if the parent is not
+visible, as this will send false FL_SHOW or FL_HIDE
+ events to the widget. redraw() is called if necessary on
+this or the parent.
+
+ Modifies keyboard focus navigation.
+See Fl_Widget::when() is a set of bitflags used by
+subclasses of Fl_Widget to decide when to do the
+callback. If the value is zero then the callback is never
+done. Other values are described in the individual widgets.
+This field is in the base class so that you can scan a panel and
+do_callback() on all the ones that don't do their own
+callbacks in response to an "OK" button.
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Window.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Window.html
new file mode 100644
index 0000000..d8d2198
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Window.html
@@ -0,0 +1,290 @@
+
+ Once you create a window, you usually add children Fl_Widget
+'s to it by using window->add(child) for each new widget. See Fl_Group for more information
+on how to add and remove children. There are several subclasses of Fl_Window that provide
+double-buffering, overlay, menu, and OpenGL support. The window's callback is done if the user tries to close a window
+using the window manager and
+Fl::modal() is zero or equal to the window. Fl_Window
+ has a default callback that calls Fl_Window::hide(). Creates a new window. If Fl_Group::current()
+is not NULL, the window is created as a subwindow of
+the parent window. The first form of the constructor creates a top-level window
+and asks the window manager to position the window. The second
+form of the constructor either creates a subwindow or a
+top-level window at the specified location, subject to window
+manager configuration. If you do not specify the position of the
+window, the window manager will pick a place to show the window
+or allow the user to pick a location. Use position(x,y)
+or hotspot() before calling show() to request a
+position on the screen. See
+Fl_Window::resize() for some more details on positioning
+windows. Top-level windows initially have visible() set to 0
+and parent() set to NULL. Subwindows initially
+have visible() set to 1 and parent() set to
+the parent window pointer. Fl_Widget::box() defaults to FL_FLAT_BOX. If you
+plan to completely fill the window with children widgets you should
+change this to FL_NO_BOX. If you turn the window border off
+you may want to change this to FL_UP_BOX. If the window is already shown then it is restored and raised to the
+top. This is really convenient because your program can call show()
+ at any time, even if the window is already up. It also means that
+show() serves the purpose of raise() in other toolkits. Call show() to restore the window. When a window is iconified/restored (either by these calls or by the
+user) the handle() method is called with FL_HIDE and
+FL_SHOW events and visible() is turned on and off. There is no way to control what is drawn in the icon except with the
+string passed to Fl_Window::xclass(). You should not rely on
+window managers displaying the icons. You can also call the Fl_Widget methods size(x,y)
+ and position(w,h), which are inline wrappers for this virtual
+function. A top-level window can not force, but merely suggest a position and
+size to the operating system. The window manager may not be willing or
+able to display a window at the desired position or with the given
+dimensions. It is up to the application developer to verify window
+parameters after the resize request.
+ Under Microsoft Windows this string is used as the name of the
+WNDCLASS structure, though it is not clear if this can have any
+visible effect. The passed pointer is stored unchanged. The string
+is not copied. This method only works for the Fl_Window and
+Fl_Gl_Window classes. The type Fl_Cursor is an enumeration defined in <FL/Enumerations.H>.
+(Under X you can get any XC_cursor value by passing
+Fl_Cursor((XC_foo/2)+1)). The colors only work on X, they are
+not implemented on WIN32.
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Wizard.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Wizard.html
new file mode 100644
index 0000000..4cb7c9c
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Wizard.html
@@ -0,0 +1,73 @@
+
+ The As with The constructor creates the The destructor destroys the widget and its children.
+
+ This method shows the next child of the wizard. If the last child
+is already visible, this function does nothing.
+
+ This method shows the previous child of the wizard. If the first child
+is already visible, this function does nothing.
+
+ Sets or gets the child widget that is visible.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_XBM_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_XBM_Image.html
new file mode 100644
index 0000000..fa0e2fb
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_XBM_Image.html
@@ -0,0 +1,57 @@
+
+ The Fl_XBM_Image class supports loading, caching,
+and drawing of X Bitmap (XBM) bitmap files. The constructor loads the named XBM file. The destructor free all memory and server resources that are used by
+the image. The Fl_XPM_Image class supports loading, caching,
+and drawing of X Pixmap (XPM) images, including transparency. The constructor loads the named XPM image. The destructor free all memory and server resources that are used by
+the image. This chapter explains advanced programming and design topics
+that will help you to get the most out of FLTK. FLTK supports multithreaded application using a locking mechanism based on "pthreads". We do not provide a threading interface as part of the library. However a simple example how threads can be implemented for all supported platforms can be found in test/threads.h and test/threads.cxx.
+
+ To use the locking mechanism, FLTK must be compiled with --enable-threads set during the configure process. IDE-based versions of FLTK are automatically compiled with locking enabled if possible.
+
+ In main(), call Fl::lock() before Fl::run() or Fl::wait() to start the runtime multithreading support for your program. All callbacks and derived functions like handle() and draw() will now be properly locked: You can now start as many threads as you like. From within
+a thread (other than the main thread) FLTK calls must be wrapped
+with calls to Fl::lock()
+and Fl::unlock():
+
+ You can send messages from child threads to the main thread
+using Fl::awake(msg): You can also tell the main thread to call a function for you
+as soon as possible by using
+Fl::awake(callback, userdata): FLTK supports multiple platforms, some of them which do not
+allow any other but the main thread to handle system events and
+open or close windows. The safe thing to do is to adhere to the
+following rules for threads on all operating systems:
+
+ See also:
+void awake(void *message),
+void lock(),
+void *thread_message(),
+void unlock().
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/basics.html b/third_party/windows/fltk-1.1.10/documentation/basics.html
new file mode 100644
index 0000000..e596fb9
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/basics.html
@@ -0,0 +1,368 @@
+
+ This chapter teaches you the basics of compiling programs
+that use FLTK. All programs must include the file <FL/Fl.H>.
+In addition the program must include a header file for each
+FLTK class it uses. Listing 1 shows a simple "Hello,
+World!" program that uses FLTK to display the window. Listing 1 - "hello.cxx"
+ After including the required header files, the program then creates a
+window. All following widgets will automatically be children of this window. Then we create a box with the "Hello, World!" string in it. FLTK automatically adds
+the new box to window, the current grouping widget. Next, we set the type of box and the size, font, and style of the label: We tell FLTK that we will not add any more widgets to window. Finally, we show the window and enter the FLTK event loop: The resulting program will display the window in Figure 2-1.
+You can quit the program by closing the window or pressing the
+ESCape key. The widgets are created using the C++ new operator. For
+most widgets the arguments to the constructor are: The x and y parameters determine where the
+widget or window is placed on the screen. In FLTK the top left
+corner of the window or screen is the origin (i.e. x = 0, y =
+0) and the units are in pixels. The width and height parameters determine
+the size of the widget or window in pixels. The maximum widget
+size is typically governed by the underlying window system or
+hardware. label is a pointer to a character string to label
+the widget with or NULL. If not specified the label
+defaults to NULL. The label string must be in static
+storage such as a string constant because FLTK does not make a
+copy of it - it just uses the pointer. Widgets are commonly ordered into functional groups, which
+in turn may be grouped again, creating a hierarchy of widgets.
+FLTK makes it easy to fill groups by automatically adding all widgets
+that are created between a myGroup->begin() and
+myGroup->end(). In this example, myGroup
+would be the current group. Newly created groups and their derived widgets implicitly call
+begin() in the constructor, effectively adding all
+subsequently created widgets to itself until end()
+is called. Setting the current group to NULL will stop automatic
+hierarchies. New widgets can now be added manually using
+Fl_Group::add(...) and Fl_Group::insert(...). box->box(FL_UP_BOX) sets the type of box the
+Fl_Box draws, changing it from the default of
+FL_NO_BOX, which means that no box is drawn. In our
+"Hello, World!" example we use FL_UP_BOX,
+which means that a raised button border will be drawn around
+the widget. You can learn more about boxtypes in
+Chapter 3. You could examine the boxtype in by doing
+box->box(). FLTK uses method name overloading to make
+short names for get/set methods. A "set" method is always of
+the form "void name(type)", and a "get" method is always
+of the form "type name() const". Almost all of the set/get pairs are very fast, short inline
+functions and thus very efficient. However, the "set" methods
+do not call redraw() - you have to call it
+yourself. This greatly reduces code size and execution time. The
+only common exceptions are value() which calls
+redraw() and label() which calls
+redraw_label() if necessary. All widgets support labels. In the case of window widgets,
+the label is used for the label in the title bar. Our example
+program calls the
+labelfont,
+ labelsize,
+and labeltype
+methods. The labelfont method sets the typeface and style
+that is used for the label, which for this example we are using
+FL_BOLD and FL_ITALIC. You can also specify
+typefaces directly. The labelsize method sets
+the height of the font in pixels. The labeltype
+method sets the type of label. FLTK supports normal, embossed,
+and shadowed labels internally, and more types can be added as
+desired. A complete list of all label options can be found in
+Chapter 3. The show() method shows the widget or window. For windows
+you can also provide the command-line arguments to allow users to
+customize the appearance, size, and position of your windows. All FLTK applications (and most GUI applications in general)
+are based on a simple event processing model. User actions such
+as mouse movement, button clicks, and keyboard activity generate
+events that are sent to an application. The application may then
+ignore the events or respond to the user, typically by redrawing
+a button in the "down" position, adding the text to an input
+field, and so forth. FLTK also supports idle, timer, and file pseudo-events that
+cause a function to be called when they occur. Idle functions
+are called when no user input is present and no timers or files
+need to be handled - in short, when the application is not doing
+anything. Idle callbacks are often used to update a 3D display
+or do other background processing. Timer functions are called after a specific amount of time
+has expired. They can be used to pop up a progress dialog after
+a certain amount of time or do other things that need to happen
+at more-or-less regular intervals. FLTK timers are not 100%
+accurate, so they should not be used to measure time intervals,
+for example. File functions are called when data is ready to read or
+write, or when an error condition occurs on a file. They are
+most often used to monitor network connections (sockets) for
+data-driven displays. FLTK applications must periodically check
+(Fl::check()) or wait (Fl::wait()) for events
+or use the Fl::run()
+method to enter a standard event processing loop. Calling
+Fl::run() is equivalent to the following code: Fl::run() does not return until all of the windows
+under FLTK control are closed by the user or your program. Under UNIX (and under Microsoft Windows when using the GNU development
+tools) you will probably need to tell the compiler where to find the
+header files. This is usually done using the -I option: The fltk-config script included with FLTK can be
+used to get the options that are required by your compiler: Similarly, when linking your application you will need to tell the
+compiler to use the FLTK library: Aside from the "fltk" library, there is also a "fltk_forms"
+library for the XForms compatibility classes, "fltk_gl" for the
+OpenGL and GLUT classes, and "fltk_images" for the image file
+classes, The libraries are named "fltk.lib", "fltkgl.lib", "fltkforms.lib",
+ and "fltkimages.lib", respectively under Windows.
+ As before, the fltk-config script included with FLTK can be
+used to get the options that are required by your linker: The forms, GL, and images libraries are included with the "--use-foo"
+options, as follows:
+
+ Finally, you can use the fltk-config script to
+compile a single source file as a FLTK program:
+
+ Any of these will create an executable named filename.
+
+ In Visual C++ you will need to tell the compiler where to
+find the FLTK header files. This can be done by selecting
+"Settings" from the "Project" menu and then
+changing the "Preprocessor" settings under the
+"C/C++" tab. You will also need to add the FLTK (FLTK.LIB
+or FLTKD.LIB), the Windows Common Controls (COMCTRL32.LIB), and
+WinSock (WSOCK32.LIB) libraries to the "Link"
+settings. You can build your Microsoft Windows applications as Console or
+WIN32 applications. If you want to use the standard C main()
+function as the entry point, FLTK includes a WinMain()
+function that will call your main() function for you. Note: The Visual C++ 5.0 optimizer is known to cause problems with
+many programs. We only recommend using the "Favor Small Code"
+optimization setting. The Visual C++ 6.0 optimizer seems to be much
+better and can be used with the "optimized for speed" setting. All public symbols in FLTK start with the characters 'F' and 'L': The proper way to include FLTK header files is: Case is significant on many operating systems,
+ and the C standard uses the forward slash (/) to
+ separate directories. Do not use any of the following
+ include lines: This chapter describes many of the widgets that are provided
+with FLTK and covers how to query and set the standard
+attributes. FLTK provides many types of buttons: All of these buttons just need the corresponding
+<FL/Fl_xyz_Button.H> header file. The constructor
+takes the bounding box of the button and optionally a label
+string: Each button has an associated
+type()
+which allows it to behave as a push button, toggle button, or
+radio button: For toggle and radio buttons, the
+value()
+method returns the current button state (0 = off, 1 = on). The
+set() and
+clear()
+methods can be used on toggle buttons to turn a toggle button
+on or off, respectively. Radio buttons can be turned on with
+the
+setonly()
+method; this will also turn off other radio buttons in the same
+group. FLTK provides several text widgets for displaying and receiving text: The Fl_Output and Fl_Multiline_Output
+widgets allow the user to copy text from the output field but
+not change it. The value()
+method is used to get or set the string that is displayed: The string is copied to the widget's own storage when you set
+the value() of the widget. The Fl_Text_Display and Fl_Text_Editor
+widgets use an associated Fl_Text_Buffer class for the
+value, instead of a simple string. Unlike text widgets, valuators keep track of numbers instead of
+strings. FLTK provides the following valuators: The value()
+method gets and sets the current value of the widget. The
+minimum()
+and maximum()
+methods set the range of values that are reported by the
+widget. The Fl_Group widget class is used as a general
+purpose "container" widget. Besides grouping radio
+buttons, the groups are used to encapsulate windows, tabs, and
+scrolled windows. The following group classes are available
+with FLTK: The size and position of widgets is usually set when you
+create them. You can access them with the x(),
+y(), w(), and h() methods. You can change the size and position by using the
+position(), resize(), and size()
+methods: If you change a widget's size or position after it is
+displayed you will have to call redraw() on the
+widget's parent. FLTK stores the colors of widgets as an 32-bit unsigned
+number that is either an index into a color palette of 256
+colors or a 24-bit RGB color. The color palette is not
+the X or WIN32 colormap, but instead is an internal table with
+fixed contents. There are symbols for naming some of the more common colors: These symbols are the default colors for all FLTK widgets. They are
+explained in more detail in the chapter
+Enumerations RGB colors can be set using the fl_rgb_color()
+function: The widget color is set using the color() method: Similarly, the label color is set using the labelcolor()
+method: The type Fl_Boxtype stored and returned in
+Fl_Widget::box()
+is an enumeration defined in <Enumerations.H>.
+Figure 3-3 shows the standard box types included with FLTK. FL_NO_BOX means nothing is drawn at all, so whatever is
+already on the screen remains. The FL_..._FRAME types only
+draw their edges, leaving the interior unchanged. The blue color in
+Figure 3-3 is the area that is not drawn by the frame types. You can define your own boxtypes by making a small function that draws
+the box and adding it to the table of boxtypes. This interface has changed in FLTK 2.0! The drawing function is passed the bounding box and background color
+for the widget: A simple drawing function might fill a rectangle with the
+given color and then draw a black outline: fl_down returns the "pressed" or "down" version of a box.
+If no "down" version of a given box exists, the behavior of this function
+is undefined and some random box or frame is returned.
+See also: fl_frame drawing.
+
+ fl_frame returns the unfilled, frame-only version of a box.
+If no frame version of a given box exists, the behavior of this function
+is undefined and some random box or frame is returned.
+See also: fl_frame drawing.
+
+ fl_box returns the filled version of a frame.
+If no filled version of a given frame exists, the behavior of this function
+is undefined and some random box or frame is returned.
+See also: fl_frame.
+
+ The Fl::set_boxtype() method adds or replaces the
+specified box type: The last 4 arguments to Fl::set_boxtype() are the
+offsets for the x, y, width, and height values that should be
+subtracted when drawing the label inside the box. A complete box design contains four box types in this order:
+a filled, neutral box (UP_BOX), a filled, depressed box
+(DOWN_BOX), and the same as outlines only (UP_FRAME
+and DOWN_FRAME). The function
+fl_down(Fl_Boxtype)
+expects the neutral design on a boxtype with a numerical
+value evenly dividable by two.
+fl_frame(Fl_Boxtype)
+expects the UP_BOX design at a value dividable by four. The label(), align(), labelfont(),
+labelsize(), labeltype(), image(), and
+deimage() methods control the labeling of widgets. The label() method sets the string that is displayed
+for the label. Symbols can be included with the label string by
+escaping them using the "@" symbol - "@@" displays a single at
+sign. Figure 3-4 shows the available symbols. The @ sign may also be followed by the following optional
+"formatting" characters, in this order: Thus, to show a very large arrow pointing downward you would use the
+label string "@+92->".
+
+ The align() method positions the label. The following
+constants are defined and may be OR'd together as needed: The labeltype() method sets the type of the label. The
+following standard label types are included: The image() and deimage() methods set an image that
+will be displayed with the widget. The deimage() method sets the
+image that is shown when the widget is inactive, while the image()
+method sets the image that is shown when the widget is active. To make an image you use a subclass of
+Fl_Image. Label types are actually indexes into a table of functions
+that draw them. The primary purpose of this is to use this to
+draw the labels in ways inaccessible through the
+fl_font mechanism (e.g. FL_ENGRAVED_LABEL) or
+with program-generated letters or symbology. This interface has changed in FLTK 2.0! To setup your own label type you will need to write two
+functions: one to draw and one to measure the label. The draw
+function is called with a pointer to a Fl_Label
+structure containing the label information, the bounding box for
+the label, and the label alignment: The label should be drawn inside this bounding box,
+even if FL_ALIGN_INSIDE is not enabled. The function
+is not called if the label value is NULL. The measure function is called with a pointer to a
+Fl_Label structure and references to the width and
+height: The function should measure the size of the label and set
+w and h to the size it will occupy. The Fl::set_labeltype method creates a label type
+using your draw and measure functions: The label type number n can be any integer value
+starting at the constant FL_FREE_LABELTYPE. Once you
+have added the label type you can use the labeltype()
+method to select your label type. The Fl::set_labeltype method can also be used to overload
+an existing label type such as FL_NORMAL_LABEL. It is also possible to define your own drawings and add
+them to the symbol list, so they can be rendered as part of
+any label. To create a new symbol, you implement a drawing function
+void drawit(Fl_Color c) which typically uses the
+complex drawing functions
+to generate a vector shape inside a two-by-two units sized box
+around the origin. This function is then linked into the symbols
+table using fl_add_symbol: name is the name of the symbol without the "@"; scalable
+must be set to 1 if the symbol is generated using scalable vector drawing
+functions. This function draw a named symbol fitting the given rectangle.
+
+ Callbacks are functions that are called when the value of a
+widget changes. A callback function is sent a Fl_Widget
+pointer of the widget that changed and a pointer to data that
+you provide: The callback() method sets the callback function for a
+widget. You can optionally pass a pointer to some data needed for the
+callback: Normally callbacks are performed only when the value of the
+widget changes. You can change this using the
+when()
+method: You cannot delete a widget inside a callback, as the
+ widget may still be accessed by FLTK after your callback
+ is completed. Instead, use the Fl::delete_widget()
+ method to mark your widget for deletion when it is safe
+ to do so. Hint:
+
+ Many programmers new to FLTK or C++ try to use a
+ non-static class method instead of a static class method
+ or function for their callback. Since callbacks are done
+ outside a C++ class, the this pointer is not
+ initialized for class methods. To work around this problem, define a static method
+ in your class that accepts a pointer to the class, and
+ then have the static method call the class method(s) as
+ needed. The data pointer you provide to the
+ callback() method of the widget can be a
+ pointer to the instance of your class. Shortcuts are key sequences that activate widgets such as
+buttons or menu items. The shortcut() method sets the
+shortcut for a widget: The shortcut value is the key event value - the ASCII value
+or one of the special keys like
+FL_Enter -
+combined with any modifiers like Shift,
+Alt, and Control. This chapter covers the drawing functions that are provided with FLTK.
+
+ There are only certain places you can execute drawing code in FLTK.
+Calling these functions at other places will result in undefined
+behavior!
+
+ To use the drawing functions you must first include the
+<FL/fl_draw.H> header file. FLTK provides the
+following types of drawing functions:
+
+ 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.
+
+ The first box drawing function is The The only difference between this function and
+ See also: fl_frame boxtype.
+
+ The The only difference between this function and
+ You can limit all your drawing to a rectangular region by calling
+fl_push_clip, and put the drawings back by using fl_pop_clip.
+This rectangle is measured in pixels and is unaffected by the current
+transformation matrix.
+
+ In addition, the system may provide clipping when updating windows
+which may be more complex than a simple rectangle. Intersect the current clip region with a rectangle and push this new
+region onto the stack. The Pushes an empty clip region on the stack so nothing will be clipped.
+
+ Restore the previous clip region.
+
+ You must call fl_pop_clip() once for every
+ time you call fl_push_clip(). If you return to FLTK
+ with the clip stack not empty unpredictable results
+ occur.
+
+ Returns non-zero if any of the rectangle intersects the current clip
+region. If this returns 0 you don't have to draw the object.
+
+ Under X this returns 2 if the rectangle is partially
+ clipped, and 1 if it is entirely inside the clip region.
+
+ Intersect the rectangle x,y,w,h with the current
+clip region and returns the bounding box of the result in
+X,Y,W,H. Returns non-zero if the resulting rectangle is
+different than the original. This can be used to limit the
+necessary drawing to a rectangle. W and H are
+set to zero if the rectangle is completely outside the region.
+
+ Replace the top of the clip stack with a clipping region of any shape.
+Fl_Region is an operating system specific type. The second form returns
+the current clipping region.
+
+ FLTK manages colors as 32-bit unsigned integers. Values from
+0 to 255 represent colors from the FLTK 1.0.x standard colormap
+and are allocated as needed on screens without TrueColor
+support. The Fl_Color enumeration type defines the
+standard colors and color cube for the first 256 colors. All of
+these are named with symbols in <FL/Enumerations.H>.
+
+ Color values greater than 255 are treated as 24-bit RGB
+values. These are mapped to the closest color supported by the
+screen, either from one of the 256 colors in the FLTK 1.0.x
+colormap or a direct RGB value on TrueColor screens. You can
+generate 24-bit RGB color values using the fl_rgb_color()
+function.
+
+ Sets the color for all subsequent drawing operations.
+
+ For colormapped displays, a color cell will be allocated out
+of fl_colormap the first time you use a color. If the
+colormap fills up then a least-squares algorithm is used to find
+the closest color. Returns the last fl_color() that was set. This can
+be used for state save/restore.
+
+ Set the color for all subsequent drawing operations. The
+closest possible match to the RGB color is used. The RGB color
+is used directly on TrueColor displays. For colormap visuals the
+nearest index in the gray ramp or color cube is used.
+
+ FLTK supports drawing of lines with different styles and
+widths. Full functionality is not available under Windows 95, 98,
+and Me due to the reduced drawing functionality these operating
+systems provide.
+
+ Set how to draw lines (the "pen"). If you change this it is your
+responsibility to set it back to the default with
+fl_line_style(0).
+
+ Because of how line styles are implemented on WIN32
+ systems, you must set the line style after
+ setting the drawing color. If you set the color after
+ the line style you will lose the line style settings!
+
+ style is a bitmask which is a bitwise-OR of the following
+values. If you don't specify a dash type you will get a solid
+line. If you don't specify a cap or join type you will get a
+system-defined default of whatever value is fastest.
+
+ width is the number of pixels thick to draw the lines.
+Zero results in the system-defined default, which on both X and
+Windows is somewhat different and nicer than 1.
+
+
+
+ dashes is a pointer to an array of dash lengths, measured in
+pixels. The first location is how long to draw a solid portion, the
+next is how long to draw the gap, then the solid, etc. It is
+terminated with a zero-length entry. A NULL pointer or a zero-length
+array results in a solid line. Odd array sizes are not supported and
+result in undefined behavior.
+
+ The dashes array does not work under Windows 95, 98,
+ or Me, since those operating systems do not support
+ complex line styles.
+
+ These functions are used to draw almost all the FLTK widgets.
+They draw on exact pixel boundaries and are as fast as possible.
+Their behavior is duplicated exactly on all platforms FLTK is
+ported. It is undefined whether these are affected by the transformation matrix, so you should only
+call these while the matrix is set to the identity matrix (the
+default).
+
+ Draw a single pixel at the given coordinates.
+
+ Color a rectangle that exactly fills the given bounding box.
+
+ Color a rectangle with "exactly" the passed
+r,g,b color. On screens with less than 24 bits of
+color this is done by drawing a solid-colored block using fl_draw_image() so that
+the correct color shade is produced.
+
+ Draw a 1-pixel border inside this bounding box.
+
+ Draw one or two lines between the given points.
+
+ Outline a 3 or 4-sided polygon with lines.
+
+ Fill a 3 or 4-sided polygon. The polygon must be convex.
+
+ Draw horizontal and vertical lines. A horizontal line is
+drawn first, then a vertical, then a horizontal.
+
+ Draw vertical and horizontal lines. A vertical line is drawn
+first, then a horizontal, then a vertical.
+
+ Draw ellipse sections using integer coordinates. These
+functions match the rather limited circle drawing code provided
+by X and WIN32. The advantage over using fl_arc with floating point
+coordinates is that they are faster because they often use the
+hardware, and they draw much nicer small circles, since the
+small sizes are often hard-coded bitmaps.
+
+ If a complete circle is drawn it will fit inside the passed bounding
+box. The two angles are measured in degrees counterclockwise from
+3'oclock and are the starting and ending angle of the arc, a2
+must be greater or equal to a1. fl_arc() draws a series of lines to approximate the arc.
+Notice that the integer version of fl_arc() has a different
+number of arguments than the fl_arc()
+function described later in this chapter. fl_pie() draws a filled-in pie slice. This slice may
+extend outside the line drawn by fl_arc; to avoid this
+use w - 1 and h - 1. Scroll a rectangle and draw the newly exposed portions. The contents
+of the rectangular area is first shifted by dx and
+dy pixels. The callback is then called for every newly
+exposed rectangular area,
+
+ The complex drawing functions let you draw arbitrary shapes
+with 2-D linear transformations. The functionality matches that
+found in the Adobe® PostScriptTM language. The
+exact pixels that are filled are less defined than for the fast
+drawing functions so that FLTK can take advantage of drawing
+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.
+
+ Save and restore the current transformation. The maximum
+depth of the stack is 4.
+
+ Concatenate another transformation onto the current one. The rotation
+angle is in degrees (not radians) and is counter-clockwise.
+
+ Transform a coordinate or a distance trough the current transformation matrix.
+After transforming a coordinate pair, it can be added to the vertex
+list without any further translations using fl_transformed_vertex.
+
+ Start and end drawing a list of points. Points are added to
+the list with fl_vertex.
+
+ Start and end drawing lines.
+
+ Start and end drawing a closed sequence of lines.
+
+ Start and end drawing a convex filled polygon.
+
+ Start and end drawing a complex filled polygon. This polygon
+may be concave, may have holes in it, or may be several
+disconnected pieces. Call fl_gap() to separate loops of
+the path. It is unnecessary but harmless to call
+fl_gap() before the first vertex, after the last one,
+or several times in a row.
+
+ 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 be drawn in the opposite direction of
+ the outside loop.
+
+ fl_gap() should only be called between
+fl_begin_complex_polygon() and
+fl_end_complex_polygon(). To outline the polygon, use
+fl_begin_loop() and replace each fl_gap() with
+fl_end_loop();fl_begin_loop(). Add a series of points on a Bezier curve to the path. The curve ends
+(and two of the points) are at x,y and x3,y3.
+
+ Add a series of points to the current path on the arc of a
+circle; you can get elliptical paths by using scale and rotate
+before calling fl_arc(). x,y are the center of
+the circle, and r is its radius. fl_arc()
+takes start and end angles that are measured
+in degrees counter-clockwise from 3 o'clock. If end is
+less than start then it draws the arc in a clockwise
+direction.
+
+ fl_circle() is equivalent to fl_arc(...,0,360) but
+may be faster. It must be the only thing in the path: if you
+want a circle as part of a complex polygon you must use fl_arc().
+
+ fl_circle() draws incorrectly if the
+ transformation is both rotated and non-square scaled.
+
+ All text is drawn in the current font.
+It is undefined whether this location or the characters are
+modified by the current transformation.
+
+ Draw a nul-terminated string or an array of n characters
+starting at the given location. Text is aligned to the left and to
+the baseline of the font. To align to the bottom, subtract fl_descent() from
+y. To align to the top, subtract fl_descent() and add fl_height().
+This version of fl_draw provides direct access to
+the text drawing function of the underlying OS. It does not apply any
+special handling to control characters.
+
+ Fancy string drawing function which is used to draw all the
+labels. The string is formatted and aligned inside the passed
+box. Handles '\t' and '\n', expands all other control
+characters to ^X, and aligns inside or against the edges of the
+box described by x, y, w and h. See Fl_Widget::align()
+for values for align. The value
+FL_ALIGN_INSIDE is ignored, as this function always
+prints inside the box.
+
+ If img is provided and is not NULL, the
+image is drawn above or below the text as specified by the
+align value.
+
+ The draw_symbols argument specifies whether or not
+to look for symbol names starting with the "@" character.
+
+ The text length is limited to 1024 caracters per line.
+
+ Measure how wide and tall the string will be when printed by
+the fl_draw(...align) function. If the incoming
+w is non-zero it will wrap to that width.
+
+ Recommended minimum line spacing for the current font. You
+can also just use the value of size passed to fl_font().
+
+ Recommended distance above the bottom of a
+fl_height() tall box to draw the text at so it looks
+centered vertically in that box.
+
+ Return the pixel width of a nul-terminated string, a sequence of n
+characters, or a single character in the current font.
+
+ Unparse a shortcut value as used by Fl_Button
+or Fl_Menu_Item
+into a human-readable string like "Alt+N". This only
+works if the shortcut is a character key or a numbered function
+key. If the shortcut is zero an empty string is returned. The
+return value points at a static buffer that is overwritten with
+each call.
+
+ FLTK supports a set of standard fonts based on the Times,
+Helvetica/Arial, Courier, and Symbol typefaces, as well as
+custom fonts that your application may load. Each font is
+accessed by an index into a font table.
+
+ Initially only the first 16 faces are filled in. There are
+symbolic names for them: FL_HELVETICA,
+FL_TIMES, FL_COURIER, and modifier values
+FL_BOLD and FL_ITALIC which can be added to
+these, and FL_SYMBOL and FL_ZAPF_DINGBATS.
+Faces greater than 255 cannot be used in Fl_Widget
+labels, since Fl_Widget stores the index as a byte. Set the current font, which is then used by the routines
+described 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 and not "points". Lines should be spaced
+size pixels apart or more. 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.
+
+ FLTK 1 supports western character sets using the eight bit encoding
+of the user-selected global code page. For MS Windows and X11, the code
+page is assumed to be Windows-1252/Latin1, a superset to ISO 8859-1.
+On Mac OS X, we assume MacRoman.
+
+ FLTK provides the functions fl_latin1_to_local,
+fl_local_to_latin1, fl_mac_roman_to_local, and
+fl_local_to_mac_roman to convert strings between both
+encodings. These functions are only required if your source
+code contains "C"-strings with international characters and
+if this source will be compiled on multiple platforms.
+
+ Assuming that the following source code was written on MS Windows,
+this example will output the correct label on OS X and X11 as well.
+Without the conversion call, the label on OS X would read
+Fahrvergn¸gen with a deformed umlaut u.
+ If your application uses characters that are not part of both
+encodings, or it will be used in areas that commonly use different
+code pages, yoou might consider upgrading to FLTK 2 which supports
+UTF-8 encoding.
+
+ These functions allow you to draw interactive selection rectangles
+without using the overlay hardware. FLTK will XOR a single rectangle
+outline over a window.
+
+ fl_overlay_rect() draws a selection rectangle, erasing any
+previous rectangle by XOR'ing it first. fl_overlay_clear()
+will erase the rectangle without drawing a new one.
+
+ Using these functions is tricky. You should make a widget
+with both a handle() and draw() method.
+draw() should call fl_overlay_clear() before
+doing anything else. Your handle() method should call
+window()->make_current() and then
+fl_overlay_rect() after FL_DRAG events, and
+should call fl_overlay_clear() after a
+FL_RELEASE event. To draw images, you can either do it directly from data in
+your memory, or you can create a Fl_Image object. The advantage of
+drawing directly is that it is more intuitive, and it is faster
+if the image data changes more often than it is redrawn. The
+advantage of using the object is that FLTK will cache translated
+forms of the image (on X it uses a server pixmap) and thus
+redrawing is much faster.
+
+ The behavior when drawing images when the current
+transformation matrix is not the identity is not defined, so you
+should only draw images when the matrix is set to the identity.
+
+ Draw an 8-bit per color RGB or luminance image. The pointer
+points at the "r" data of the top-left pixel. Color
+data must be in r,g,b order. X,Y are where to
+put the top-left corner. W and H define the
+size of the image. D is the delta to add to the pointer
+between pixels, it may be any value greater or equal to
+3, or it can be negative to flip the image
+horizontally. LD is the delta to add to the pointer
+between lines (if 0 is passed it uses W * D), and may
+be larger than W * D to crop data, or negative to flip
+the image vertically.
+
+ It is highly recommended that you put the following code before the
+first show() of any window in your program to get rid
+of the dithering if possible: Gray scale (1-channel) images may be drawn. This is done if
+abs(D) is less than 3, or by calling
+fl_draw_image_mono(). Only one 8-bit sample is used for
+each pixel, and on screens with different numbers of bits for
+red, green, and blue only gray colors are used. Setting
+D greater than 1 will let you display one channel of a
+color image.
+
+ The X version does not support all possible visuals.
+ If FLTK cannot draw the image in the current visual it
+ will abort. FLTK supports any visual of 8 bits or less,
+ and all common TrueColor visuals up to 32 bits. Call the passed function to provide each scan line of the
+image. This lets you generate the image as it is being drawn,
+or do arbitrary decompression of stored data, provided it can be
+decompressed to individual scan lines easily.
+
+ The callback is called with the void * user data
+pointer which can be used to point at a structure of information
+about the image, and the x, y, and w
+of the scan line desired from the image. 0,0 is the upper-left
+corner of the image, not X,Y. A pointer to a
+buffer to put the data into is passed. You must copy w
+pixels from scanline y, starting at pixel x,
+to this buffer. Due to cropping, less than the whole image may be requested.
+So x may be greater than zero, the first y may
+be greater than zero, and w may be less than
+W. The buffer is long enough to store the entire W
+* D pixels, this is for convenience with some decompression
+schemes where you must decompress the entire line at once:
+decompress it into the buffer, and then if x is not
+zero, copy the data over so the x'th pixel is at the
+start of the buffer. You can assume the y's will be consecutive, except
+the first one may be greater than zero. If D is 4 or more, you must fill in the unused bytes
+with zero. Draws XPM image data, with the top-left corner at the given position.
+The image is dithered on 8-bit displays so you won't lose color space
+for programs displaying both images and pixmaps. This function returns
+zero if there was any error decoding the XPM data.
+
+ To use an XPM, do: Transparent colors are replaced by the optional
+Fl_Color argument. To draw with true transparency you must
+use the Fl_Pixmap class.
+
+ An XPM image contains the dimensions in its data. This
+function finds and returns the width and height. The return
+value is non-zero if the dimensions were parsed ok and zero if
+there was any problem.
+
+ FLTK provides a single function for reading from the current
+window or off-screen buffer into a RGB(A) image buffer. Read a RGB(A) image from the current window or off-screen
+buffer. The p argument points to a buffer that can hold
+the image and must be at least W*H*3 bytes when reading
+RGB images and W*H*4 bytes when reading RGBA images. If
+NULL, fl_read_image() will create an array of
+the proper size which can be freed using delete[]. The alpha parameter controls whether an alpha
+channel is created and the value that is placed in the alpha
+channel. If 0, no alpha channel is generated. FLTK provides a base image class called Fl_Image which supports
+creating, copying, and drawing images of various kinds, along
+with some basic color operations. Images can be used as labels
+for widgets using the image() and
+deimage()
+methods or drawn directly.
+
+ The Fl_Image class
+does almost nothing by itself, but is instead supported by three
+basic image types:
+
+ The Fl_Bitmap class encapsulates a mono-color bitmap image.
+The draw() method draws the image using the current drawing
+color.
+
+ The Fl_Pixmap class encapsulates a colormapped image.
+The draw() method draws the image using the colors in the
+file, and masks off any transparent colors automatically.
+
+ The Fl_RGB_Image class encapsulates a full-color
+(or grayscale) image with 1 to 4 color components. Images with
+an even number of components are assumed to contain an
+alpha channel that is used for transparency. The transparency
+provided by the draw() method is either a 24-bit
+blend against the existing window contents or a "screen door"
+transparency mask, depending on the platform and screen color depth.
+
+ fl_can_do_alpha_blending() will return 1, if your
+platform supports true alpha blending for RGBA images, or 0,
+if FLTK will use screen door transparency.
+
+ FLTK also provides several image classes based on the three
+standard image types for common file formats:
+
+ Each of these image classes load a named file of the
+corresponding format. The Fl_Shared_Image class
+can be used to load any type of image file - the class examines
+the file and constructs an image of the appropriate type.
+
+ Finally, FLTK provides a special image class called Fl_Tiled_Image to tile
+another image object in the specified area. This class can be
+used to tile a background image in a Fl_Group widget,
+for example.
+
+ The copy() method creates a copy of the image. The second form
+specifies the new size of the image - the image is resized using the
+nearest-neighbor algorithm.
+
+ The draw() method draws the image object.
+x,y,w,h indicates a destination rectangle.
+ox,oy,w,h is a source rectangle. This source rectangle
+is copied to the destination. The source rectangle may extend
+outside the image, i.e. ox and oy may be
+negative and w and h may be bigger than the
+image, and this area is left unchanged.
+
+ Draws the image with the upper-left corner at x,y.
+This is the same as doing draw(x,y,img->w(),img->h(),0,0).
+
+ Create an RGB offscreen buffer with w*h pixels.
+
+ Delete a previously created offscreen buffer. All drawings are lost.
+
+ 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
+an Fl_Widget::draw() to occur.
+
+ Quit sending drawing commands to this offscreen buffer.
+
+ Copy a rectangular area of the size w*h from srcx, srcy in the offscreen
+buffer into the current buffer at x, y.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/editor-replace.gif b/third_party/windows/fltk-1.1.10/documentation/editor-replace.gif
new file mode 100644
index 0000000..73c2856
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/editor-replace.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/editor.gif b/third_party/windows/fltk-1.1.10/documentation/editor.gif
new file mode 100644
index 0000000..8fce896
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/editor.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/editor.html b/third_party/windows/fltk-1.1.10/documentation/editor.html
new file mode 100644
index 0000000..eebe86a
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/editor.html
@@ -0,0 +1,911 @@
+
+ This chapter takes you through the design of a simple
+FLTK-based text editor.
+
+ Since this will be the first big project you'll be doing with FLTK,
+lets define what we want our text editor to do:
+
+ Now that we've outlined the goals for our editor, we can begin with
+the design of our GUI. Obviously the first thing that we need is a
+window, which we'll place inside a class called EditorWindow:
+
+ Our text editor will need some global variables to keep track of
+things:
+
+ The textbuf variable is the text editor buffer for
+our window class described previously. We'll cover the other
+variables as we build the application. The first goal requires us to use a menubar and menus that
+define each function the editor needs to perform. The Fl_Menu_Item structure is
+used to define the menus and items in a menubar: Once we have the menus defined we can create the
+Fl_Menu_Bar widget and assign the menus to it with: We'll define the callback functions later.
+
+ To keep things simple our text editor will use the
+Fl_Text_Editor
+widget to edit the text:
+
+ So that we can keep track of changes to the file, we also want to add
+a "modify" callback: Finally, we want to use a mono-spaced font like FL_COURIER:
+
+ We can use the FLTK convenience functions for many of the
+editor's dialogs, however the replace dialog needs its own
+custom window. To keep things simple we will have a
+"find" string, a "replace" string, and
+"replace all", "replace next", and
+"cancel" buttons. The strings are just
+Fl_Input widgets, the "replace all" and
+"cancel" buttons are Fl_Button widgets, and
+the "replace next " button is a
+Fl_Return_Button widget: Now that we've defined the GUI components of our editor, we
+need to define our callback functions. This function will be called whenever the user changes any text in the
+editor widget:
+
+ The set_title() function is one that we will write to set
+the changed status on the current file. We're doing it this way
+because we want to show the changed status in the window's
+title bar.
+
+ This callback function will call kf_copy()
+to copy the currently selected text to the clipboard: This callback function will call kf_cut()
+to cut the currently selected text to the clipboard: This callback function will call remove_selection()
+to delete the currently selected text to the clipboard: This callback function asks for a search string using the fl_input()
+convenience function and then calls the find2_cb()
+function to find the string:
+
+ This function will find the next occurrence of the search
+string. If the search string is blank then we want to pop up the
+search dialog:
+
+ If the search string cannot be found we use the fl_alert()
+convenience function to display a message to that effect.
+
+ This callback function will clear the editor widget and current
+filename. It also calls the check_save() function to give the
+user the opportunity to save the current file first as needed:
+
+ This callback function will ask the user for a filename and then load
+the specified file into the input widget and current filename. It also
+calls the check_save() function to give the user the
+opportunity to save the current file first as needed:
+
+ We call the load_file() function to actually load the file.
+
+ This callback function will call kf_paste()
+to paste the clipboard at the current position: The quit callback will first see if the current file has been
+modified, and if so give the user a chance to save it. It then exits
+from the program:
+
+ The replace callback just shows the replace dialog:
+
+ This callback will replace the next occurence of the replacement
+string. If nothing has been entered for the replacement string, then
+the replace dialog is displayed instead:
+
+ This callback will replace all occurences of the search
+string in the file:
+
+ This callback just hides the replace dialog:
+
+ This callback saves the current file. If the current filename is
+blank it calls the "save as" callback:
+
+ The save_file() function saves the current file to the
+specified filename.
+
+ This callback asks the user for a filename and saves the current file:
+
+ The save_file() function saves the current file to the
+specified filename.
+
+ Now that we've defined the callback functions, we need our support
+functions to make it all work:
+
+ This function checks to see if the current file needs to be saved. If
+so, it asks the user if they want to save it:
+
+ This function loads the specified file into the textbuf class:
+
+ When loading the file we use the loadfile()
+method to "replace" the text in the buffer, or the insertfile()
+method to insert text in the buffer from the named file.
+
+ This function saves the current buffer to the specified file:
+
+ This function checks the changed variable and updates the
+window label accordingly:
+ Once we've created all of the support functions, the only thing left
+is to tie them all together with the main() function.
+The main() function creates a new text buffer, creates a
+new view (window) for the text, shows the window, loads the file on
+the command-line (if any), and then enters the FLTK event loop:
+
+ The complete source for our text editor can be found in the test/editor.cxx source file. Both the Makefile and Visual C++
+workspace include the necessary rules to build the editor. You can
+also compile it using a standard compiler with:
+
+ or by using the fltk-config script with:
+
+ As noted in Chapter 1, you may need to
+include compiler and linker options to tell them where to find the FLTK
+library. Also, the CC command may also be called gcc
+or c++ on your system.
+
+ Congratulations, you've just built your own text editor! Now that we've implemented the basic functionality, it is
+time to show off some of the advanced features of the
+ The Styles are defined using the
+ The For our text editor we'll define 7 styles for plain code,
+comments, keywords, and preprocessor directives:
+
+ You'll notice that the comments show a letter next to each
+style - each style in the style buffer is referenced using a
+character starting with the letter 'A'.
+
+ You call the Finally, you need to add a callback to the main text buffer so
+that changes to the text buffer are mirrored in the style buffer:
+
+ The The 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 useful to know when programming.
+
+ The following constants define the button numbers for FL_PUSH and
+FL_RELEASE events:
+
+ The Fl_Color enumeration type holds a FLTK color value.
+Colors are either 8-bit indexes into a virtual colormap or 24-bit RGB
+color values. Color indices occupy the lower 8 bits of the value, while
+RGB colors occupy the upper 24 bits, for a byte organization of RGBI.
+
+ Constants are defined for the user-defined foreground and background
+colors, as well as specific colors and the start of the grayscale ramp
+and color cube in the virtual colormap. Inline functions are provided to
+retrieve specific grayscale, color cube, or RGB color values.
+
+ The following color constants can be used to access the user-defined
+colors:
+
+ The following color constants can be used to access the colors from the
+FLTK standard color cube:
+
+ The inline methods for getting a grayscale, color cube, or
+RGB color value are described in Appendix B - Function
+Reference.
+
+ The following constants define the mouse cursors that are available in
+FLTK. The double-headed arrows are bitmaps
+provided by FLTK on X, the others are provided by system-defined
+cursors. This chapter discusses the FLTK event model and how to handle
+events in your program or widget.
+
+ Every time a user moves the mouse pointer, clicks a button,
+or presses a key, an event is generated and sent to your
+application. Events can also come from other programs like the
+window manager.
+
+ Events are identified by the integer argument passed to the
+Fl_Widget::handle() virtual
+method. Other information about the most recent event is stored in
+static locations and acquired by calling the Fl::event_*() methods. This static
+information remains valid until the next event is read from the window
+system, so it is ok to look at it outside of the handle()
+method.
+
+ A mouse button has gone down with the mouse pointing at this
+widget. You can find out what button by calling
+Fl::event_button(). You find out the mouse position by
+calling Fl::event_x() and Fl::event_y().
+
+ A widget indicates that it "wants" the mouse click
+by returning non-zero from its handle() method. It
+will then become the
+Fl::pushed() widget and will get FL_DRAG and
+the matching FL_RELEASE events. If handle()
+returns zero then FLTK will try sending the FL_PUSH to
+another widget. The mouse has moved with a button held down. The current
+button state is in Fl::event_state().
+The mouse position is in Fl::event_x() and Fl::event_y().
+
+ In order to receive FL_DRAG events, the widget must
+return non-zero when handling FL_PUSH. A mouse button has been released. You can find out what
+button by calling Fl::event_button().
+
+ In order to receive the FL_RELEASE event, the widget must
+return non-zero when handling FL_PUSH. The mouse has moved without any mouse buttons held down.
+This event is sent to the Fl::belowmouse()
+widget. In order to receive FL_MOVE events, the widget must
+return non-zero when handling FL_ENTER. The user has moved the mouse wheel. The Fl::event_dx() and Fl::event_dy() methods
+can be used to find the amount to scroll horizontally and
+vertically.
+
+ The mouse has been moved to point at this widget. This can
+be used for highlighting feedback. If a widget wants to
+highlight or otherwise track the mouse, it indicates this by
+returning non-zero from its handle() method. It then
+becomes the Fl::belowmouse()
+widget and will receive FL_MOVE and FL_LEAVE
+events.
+
+ The mouse has moved out of the widget.
+
+ In order to receive the FL_LEAVE event, the widget must
+return non-zero when handling FL_ENTER. This indicates an attempt to give a widget the
+keyboard focus.
+
+ If a widget wants the focus, it should change itself to
+display the fact that it has the focus, and return non-zero from
+its handle()
+method. It then becomes the Fl::focus() widget and gets
+FL_KEYDOWN, FL_KEYUP, and FL_UNFOCUS
+events.
+
+ The focus will change either because the window manager
+changed which window gets the focus, or because the user tried
+to navigate using tab, arrows, or other keys. You can check Fl::event_key() to
+figure out why it moved. For navigation it will be the key
+pressed and interaction with the window manager it will be
+zero.
+
+ This event is sent to the previous Fl::focus() widget when
+another widget gets the focus or the window loses focus.
+
+ A key was pressed or released. The key can be found in Fl::event_key(). The
+text that the key should insert can be found with Fl::event_text() and
+its length is in Fl::event_length().
+If you use the key handle() should return 1. If you
+return zero then FLTK assumes you ignored the key and will
+then attempt to send it to a parent widget. If none of them want
+it, it will change the event into a FL_SHORTCUT event.
+
+ To receive If you are writing a text-editing widget you may also want to
+call the Fl::compose()
+function to translate individual keystrokes into foreign
+characters.
+
+ If the Fl::focus()
+widget is zero or ignores an FL_KEYBOARD event then
+FLTK tries sending this event to every widget it can, until one
+of them returns non-zero. FL_SHORTCUT is first sent to
+the Fl::belowmouse() widget, then its parents and
+siblings, and eventually to every widget in the window, trying
+to find an object that returns non-zero. FLTK tries really hard
+to not to ignore any keystrokes!
+
+ You can also make "global" shortcuts by using Fl::add_handler(). A
+global shortcut will work no matter what windows are displayed
+or which one has the focus. This widget is no longer active, due to deactivate()
+being called on it or one of its parents. active() may
+still be true after this, the widget is only active if
+active() is true on it and all its parents (use active_r() to check this).
+
+ This widget is now active, due to activate()
+being called on it or one of its parents.
+
+ This widget is no longer visible, due to hide() being
+called on it or one of its parents, or due to a parent window
+being minimized. visible() may still be true after
+this, but the widget is visible only if visible() is
+true for it and all its parents (use visible_r() to
+check this).
+
+ This widget is visible again, due to show() being
+called on it or one of its parents, or due to a parent window
+being restored. Child Fl_Windows respond to this by
+actually creating the window if not done already, so if you
+subclass a window, be sure to pass FL_SHOW to the base
+class handle() method!
+
+ You should get this event some time after you call Fl::paste(). The contents
+of Fl::event_text()
+is the text to insert and the number of characters is in Fl::event_length().
+
+ The Fl::selection_owner()
+will get this event before the selection is moved to another
+widget. This indicates that some other widget or program has
+claimed the selection. Motif programs used this to clear the
+selection indication. Most modern programs ignore this.
+
+ FLTK supports drag and drop of text and files from any
+application on the desktop. Text is transfered using
+the current code page. Files are received as a list of full path
+and file names, separated by newline. On some platforms, path
+names are prepended with file://.
+
+ The drag and drop data is available in Fl::event_text()
+at the concluding FL_PASTE. On some platforms, the
+event text is also available for the FL_DND_* events,
+however application must not depend on that behavior because it
+depends on the protocol used on each platform.
+
+ FL_DND_* events cannot be used in widgets derived
+from Fl_Group or Fl_Window.
+
+ The mouse has been moved to point at this widget. A widget
+that is interested in receiving drag'n'drop data must return 1
+to receive FL_DND_DRAG, FL_DND_LEAVE and FL_DND_RELEASE events.
+
+ The mouse has been moved inside a widget while dragging data.
+A widget that is interested in receiving drag'n'drop data should
+indicate the possible drop position.
+
+ The mouse has moved out of the widget.
+
+ The user has released the mouse button dropping data into
+the widget. If the widget returns 1, it will receive the data in
+the immediately following FL_PASTE event.
+
+
+
+ FLTK keeps the information about the most recent event in
+static storage. This information is good until the next event is
+processed. Thus it is valid inside handle() and
+callback() methods.
+
+ These are all trivial inline functions and thus very fast and small: FLTK follows very simple and unchangeable rules for sending
+events. The major innovation is that widgets can indicate (by
+returning 0 from the handle() method) that they are not
+interested in an event, and FLTK can then send that event
+elsewhere. This eliminates the need for "interests"
+(event masks or tables), and this is probably the main reason
+FLTK is much smaller than other toolkits.
+
+ Most events are sent directly to the handle() method
+of the Fl_Window that the window system says they
+belong to. The window (actually the Fl_Group that
+Fl_Window is a subclass of) is responsible for sending
+the events on to any child widgets. To make the
+Fl_Group code somewhat easier, FLTK sends some events
+(FL_DRAG, FL_RELEASE, FL_KEYBOARD,
+FL_SHORTCUT, FL_UNFOCUS, and
+FL_LEAVE) directly to leaf widgets. These procedures
+control those leaf widgets:
+
+ The foreign-letter compose processing done by the Fl_Input widget is provided in
+a function that you can call if you are writing your own text editor
+widget.
+
+ FLTK uses its own compose processing to allow "preview" of
+the partially composed sequence, which is impossible with the
+usual "dead key" processing.
+
+ Although currently only characters in the ISO-8859-1
+character set are handled, you should call this in case any
+enhancements to the processing are done in the future. The
+interface has been designed to handle arbitrary UTF-8 encoded
+text.
+
+ The following methods are provided for character composition:
+
+ March 19, 2005 The FLTK distribution contains over 60 sample applications written
+in, or ported to, FLTK. If the FLTK archive you received does not
+contain a 'test' directory, you can download the complete FLTK
+distribution from
+http://fltk.org/software.php. Most of the example programs were created while testing a group of widgets.
+They are not meant to be great achievements in clean C++ programming, but merely
+a test platform to verify the functionality of the FLTK library. The tabs application shows the Fl_Tabs widget
+on the left and the Fl_Wizard widget on the right side
+for direct comparison of these two panel management widgets.
+
+ This chapter shows how to use the Fast Light User-Interface Designer
+("FLUID") to create your GUIs. Subchapters:
+class Fl
+
+
+Class Hierarchy
+
+
+Fl
+
+
+Include Files
+
+
+#include <FL/Fl.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+void add_check(Fl_Timeout_Handler, void* = 0);
+
+
+bool state_changed; // anything that changes the display turns this on
+
+void callback(void*) {
+ if (!state_changed) return;
+ state_changed = false;
+ do_expensive_calculation();
+ widget->redraw();
+}
+
+main() {
+ Fl::add_check(callback);
+ return Fl::run();
+}
+
+
+void add_fd(int fd, void (*cb)(int,void*),void* =0);
+
+
+void add_fd(int fd, int when, void (*cb)(int, void*), void* = 0);void add_handler(int (*h)(int));
+
+
+
+
+void add_idle(void (*cb)(void*), void* = 0);
+
+void add_timeout(double t, Fl_Timeout_Handler,void* = 0);
+
+
+ void callback(void*) {
+ puts("TICK");
+ Fl::repeat_timeout(1.0, callback);
+ }
+
+ int main() {
+ Fl::add_timeout(1.0, callback);
+ return Fl::run();
+ }
+
+
+int arg(int, char**, int&);
+
+int args(int, char**, int&, int (*)(int,char**,int&) = 0);
+
+
+
+
+
+
+
+
+void (*atclose)(Fl_Window*,void*);
+
+void awake(void *p);
+
+int awake(void (*callback)(void*), void *userdata);
+
+void background2(uchar, uchar, uchar);
+
+void background(uchar, uchar, uchar);
+
+Fl_Widget* belowmouse();
+
+
+void belowmouse(Fl_Widget*);int box_dh(Fl_Boxtype);
+
+int box_dw(Fl_Boxtype);
+
+int box_dx(Fl_Boxtype);
+
+int box_dy(Fl_Boxtype);
+
+
+ int X = yourwidget->x() + Fl::box_dx(yourwidget->box());
+ int Y = yourwidget->y() + Fl::box_dy(yourwidget->box());
+ int W = yourwidget->w() - Fl::box_dw(yourwidget->box());
+ int H = yourwidget->h() - Fl::box_dh(yourwidget->box());
+
+int check();
+
+
+while (!calculation_done()) {
+ calculate();
+ Fl::check();
+ if (user_hit_abort_button()) break;
+}
+
+
+int compose(int &del);
+
+void compose_reset();
+
+void copy(const char *stuff, int len, int clipboard);
+
+int damage();
+
+
+void damage(int x);void default_atclose(Fl_Window*,void*);
+
+void delete_widget(Fl_Widget*);
+
+void display(const char*);
+
+int dnd();
+
+void dnd_text_ops(int d);
+
+
+int dnd_text_ops();void (*error)(const char*, ...);
+
+int event_alt();
+
+int event_button1();
+
+int event_button2();
+
+int event_button3();
+
+int event_button();
+
+int event_buttons();
+
+int event_clicks();
+
+
+void event_clicks(int i);int event_ctrl();
+
+int event();
+
+int event_inside(int,int,int,int);
+
+
+int event_inside(const Fl_Widget*);int event_is_click();
+
+
+void event_is_click(0);int event_key();
+
+
+int event_key(int s);
+
+
+int event_length();
+
+int event_original_key();
+
+int event_shift();
+
+int event_state();
+
+
+int event_state(int i);
+
+
+int event_x();
+
+int event_x_root();
+
+int event_y();
+
+int event_y_root();
+
+void (*fatal)(const char*, ...);
+
+Fl_Window* first_window();
+
+
+void first_window(Fl_Window*);void flush();
+
+Fl_Widget* focus();
+
+
+void focus(Fl_Widget*);void foreground(uchar, uchar, uchar);
+
+void free_color(Fl_Color c, int overlay = 0);
+
+Fl_Box_Draw_F *get_boxtype(Fl_Boxtype);
+
+unsigned get_color(Fl_Color c);
+
+
+void get_color(Fl_Color c, uchar&r, uchar&g, uchar&b);const char* get_font(Fl_Font);
+
+const char* get_font_name(Fl_Font, int* attributes = 0);
+
+int get_font_sizes(Fl_Font, int*& sizep);
+
+int get_key(int);
+
+void get_mouse(int &x,int &y);
+
+void get_system_colors();
+
+int gl_visual(int, int *alist=0);
+
+Fl_Window* grab();
+
+
+void grab(Fl_Window&w) {grab(&w);}int h();
+
+int handle(int, Fl_Window*);
+
+int has_check(Fl_Timeout_Handler, void* = 0);
+
+int has_idle(void (*cb)(void*), void* = 0);
+
+int has_timeout(Fl_Timeout_Handler, void* = 0);
+
+void lock();
+
+Fl_Window* modal();
+
+Fl_Window* next_window(const Fl_Window*);
+
+void own_colormap();
+
+void paste(Fl_Widget &receiver, int clipboard=0);
+
+Fl_Widget* pushed();
+
+
+void pushed(Fl_Widget*);Fl_Widget* readqueue();
+
+int ready();
+
+
+while (!calculation_done()) {
+ calculate();
+ if (Fl::ready()) {
+ do_expensive_cleanup();
+ Fl::check();
+ if (user_hit_abort_button()) break;
+ }
+}
+
+
+void redraw();
+
+void release();
+
+void remove_check(Fl_Timeout_Handler, void* = 0);
+
+void remove_fd(int, int when);
+
+
+void remove_fd(int);void remove_handler(int (*h)(int));
+
+void remove_idle(void (*cb)(void*), void* = 0);
+
+void remove_timeout(Fl_Timeout_Handler, void* = 0);
+
+void repeat_timeout(double t, Fl_Timeout_Handler,void* = 0);
+
+
+ void callback(void*) {
+ puts("TICK");
+ Fl::repeat_timeout(1.0, callback);
+ }
+
+ int main() {
+ Fl::add_timeout(1.0, callback);
+ return Fl::run();
+ }
+
+
+int run();
+
+void scheme(const char *name);
+
+
+
const char *scheme();
+
+
+
+int screen_count();
+
+void screen_xywh(int &x, int &y, int &w, int &h);
+
+
+void screen_xywh(int &x, int &y, int &w, int &h, int mx, int my);
+void screen_xywh(int &x, int &y, int &w, int &h, int n);void scrollbar_size(int W);
+
+
+int scrollbar_size();void selection(Fl_Widget &owner, const char* stuff, int len);
+
+Fl_Widget* selection_owner();
+
+
+void selection_owner(Fl_Widget*);void set_abort(void (*f)(const char*,...));
+
+void set_atclose(void (*f)(Fl_Window*,void*));
+
+void set_boxtype(Fl_Boxtype, Fl_Box_Draw_F*,uchar,uchar,uchar,uchar);
+
+
+void set_boxtype(Fl_Boxtype, Fl_Boxtype from);void set_color(Fl_Color, uchar, uchar, uchar);
+
+
+void set_color(Fl_Color, unsigned);void set_font(Fl_Font, const char*);
+
+
+void set_font(Fl_Font, Fl_Font);Fl_Font set_fonts(const char* = 0);
+
+void set_idle(void (*cb)());
+
+void set_labeltype(Fl_Labeltype,Fl_Label_Draw_F*,Fl_Label_Measure_F*);
+
+int test_shortcut(int);
+
+void *thread_message();
+
+void unlock();
+
+double version();
+
+void visible_focus(int v);
+
+
+int visible_focus();int visual(int);
+
+
+
+
+
Full/true color (if there are several depths FLTK chooses the
+largest). Do this if you use fl_draw_image
+ for much better (non-dithered) output.
+
Full color with at least 24 bits of color. FL_RGB will
+always pick this if available, but if not it will happily return a
+less-than-24 bit deep visual. This call fails if 24 bits are not
+available.
+
Hardware double buffering. Call this if you are going to use
+Fl_Double_Window.
+
Hardware double buffering and full color.
+int w();
+
+int wait();
+
+
+double wait(double time);void (*warning)(const char*, ...);
+
+int x();
+
+int y();
+
+int event_dx();
+
+Returns the current horizontal mouse scrolling associated with the
+FL_MOUSEWHEEL event. Right is positive.
+
+int event_dy();
+
+Returns the current vertical mouse scrolling assoaciated with the
+FL_MOUSEWHEEL event. Down is positive.
+
+const char* event_text();
+
+Returns the text associated with the current FL_PASTE or
+FL_DND_RELEASE event.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Adjuster.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Adjuster.html
new file mode 100644
index 0000000..5fe8a2d
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Adjuster.html
@@ -0,0 +1,53 @@
+
+
+ class Fl_Adjuster
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Adjuster
+
+
+Include Files
+
+
+#include <FL/Fl_Adjuster.H>
+
+
+Description
+The Fl_Adjuster widget was stolen from Prisms, and has proven
+to be very useful for values that need a large dynamic range.
+
Methods
+
+
+Fl_Adjuster::Fl_Adjuster(int x, int
+y, int w, int h, const char *label = 0)
+ Creates a new Fl_Adjuster widget using the given position,
+size, and label string. It looks best if one of the dimensions is 3
+times the other.
+virtual Fl_Adjuster::~Fl_Adjuster()
+
+ Destroys the valuator.
+uchar Fl_Adjuster::soft() const
+
+ If "soft" is turned on, the user is allowed to drag the value outside
+the range. If they drag the value to one of the ends, let go, then
+grab again and continue to drag, they can get to any value. Default is
+one.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_BMP_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_BMP_Image.html
new file mode 100644
index 0000000..7b96a48
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_BMP_Image.html
@@ -0,0 +1,57 @@
+
+
+
void Fl_Adjuster::soft(uchar)class Fl_BMP_Image
+
+
+Class Hierarchy
+
+
+Fl_RGB_Image
+ |
+ +----Fl_BMP_Image
+
+
+Include Files
+
+
+#include <FL/Fl_BMP_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_BMP_Image::Fl_BMP_Image(const char *filename);
+
+Fl_BMP_Image::~Fl_BMP_Image();
+
+class Fl_Bitmap
+
+
+Class Hierarchy
+
+
+Fl_Image
+ |
+ +----Fl_Bitmap
+ |
+ +----Fl_XBM_Image
+
+
+Include Files
+
+
+#include <FL/Fl_Bitmap.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_Bitmap::Fl_Bitmap(const char *array, int W, int H);
+
+
+Fl_Bitmap::Fl_Bitmap(const unsigned char *array, int W, int H);Fl_Bitmap::~Fl_Bitmap();
+
+class Fl_Box
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Box
+
+
+Include Files
+
+
+#include <FL/Fl_Box.H>
+
+
+Description
+ This widget simply draws its box, and possibly it's label. Putting it
+before some other widgets and making it big enough to surround them
+will let you draw a frame around them.
+Methods
+
+Fl_Box::Fl_Box(int x, int y, int w, int h,
+const char * = 0)
+
+ The first constructor sets box() to FL_NO_BOX, which
+means it is invisible. However such widgets are useful as placeholders
+or Fl_Group::resizable()
+ values. To change the box to something visible, use box(n).
+
Fl_Box::Fl_Box(Fl_Boxtype b, int x, int y, int w, int h, const
+char *)Fl_Box::~Fl_Box(void)
+The destructor removes the box.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Browser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Browser.html
new file mode 100644
index 0000000..5fb2c72
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Browser.html
@@ -0,0 +1,220 @@
+
+
+ class Fl_Browser
+
+Class Hierarchy
+
+
+Fl_Browser_
+ |
+ +----Fl_Browser
+ |
+ +----Fl_File_Browser, Fl_Hold_Browser, Fl_Multi_Browser, Fl_Select_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_Browser.H>
+
+
+Description
+ The Fl_Browser widget displays a scrolling list of text
+lines, and manages all the storage for the text. This is not a text
+editor or spreadsheet! But it is useful for showing a vertical list of
+named objects to the user.
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Browser::Fl_Browser(int, int, int,
+int, const char * = 0)
+ The constructor makes an empty browser.
+Fl_Browser::~Fl_Browser(void)
+ The destructor deletes all list items and destroys the browser.
+void Fl_Browser::add(const char *, void * =
+0)
+ Add a new line to the end of the browser. The text is copied using
+the strdup() function. It may also be NULL to make a
+blank line. The void * argument is returned as the data()
+ of the new item.
+void Fl_Browser::bottomline(int n)
+Scrolls the browser so the bottom line in the browser is n.
+void Fl_Browser::clear()
+ Remove all the lines in the browser.
+uchar Fl_Browser::column_char() const
+
+ The first form gets the current column separator character. By default
+this is '\t' (tab).
+
void Fl_Browser::column_char(char c)const int
+*Fl_Browser::column_widths() const
+
+ The first form gets the current column width array. This array is
+zero-terminated and specifies the widths in pixels of each column. The
+text is split at each column_char() and each part is formatted
+into it's own column. After the last column any remaining text is
+formatted into the space between the last column and the right edge of
+the browser, even if the text contains instances of column_char()
+. The default value is a one-element array of just a zero, which makes
+there are no columns.
+
void Fl_Browser::column_widths(const int *w)void *Fl_Browser::data(int n) const
+
+ The first form returns the data for line n. If n is
+out of range this returns NULL.
+
void Fl_Browser::data(int n, void *)uchar Fl_Browser::format_char() const
+
+ The first form gets the current format code prefix character, which by
+default is @. A string of formatting codes at the start of
+each column are stripped off and used to modify how the rest of the
+line is printed:
+
void Fl_Browser::format_char(char c)
+
+ Notice that the @. Print rest of line, don't look for more '@' signs @@ Print rest of line starting with '@' @l Use a large (24 point) font @m Use a medium large (18 point) font @s Use a small (11 point) font @b Use a bold font (adds FL_BOLD to font) @i Use an italic font (adds FL_ITALIC to font) @f or @t Use a fixed-pitch
+ font (sets font to FL_COURIER) @c Center the line horizontally @r Right-justify the text @B0, @B1, ... @B255 Fill the backgound with
+fl_color(n) @C0, @C1, ... @C255 Use fl_color(n) to draw the text @F0, @F1, ... Use fl_font(n) to draw the text @S1, @S2, ... Use point size n to draw the text @u or @_ Underline the text. @- draw an engraved line through the middle. @. command can be used to reliably
+terminate the parsing. To print a random string in a random color, use
+sprintf("@C%d@.%s", color, string) and it will work even if the
+string starts with a digit or has the format character in it.
+void Fl_Browser::hide(int n)
+ Makes line n invisible, preventing selection by the user.
+ The line can still be selected under program control.
+void Fl_Browser::insert(int n, const char
+*, void * = 0)
+ Insert a new line before line n. If n >
+size() then the line is added to the end.
+int Fl_Browser::load(const char *filename)
+
+ Clears the browser and reads the file, adding each line from the file
+to the browser. If the filename is NULL or a zero-length
+string then this just clears the browser. This returns zero if there
+was any error in opening or reading the file, in which case errno
+ is set to the system error. The data() of each line is set
+to NULL.
+void Fl_Browser::middleline(int n)
+Scrolls the browser so the middle line in the browser is n.
+void Fl_Browser::move(int to, int from)
+ Line from is removed and reinserted at to; to
+ is calculated after the line is removed.
+int Fl_Browser::position() const
+
+ The first form returns the current vertical scrollbar position, where
+0 corresponds to the top. If there is not vertical scrollbar then this
+will always return 0.
+
void Fl_Browser::position(int p)void Fl_Browser::remove(int n)
+ Remove line n and make the browser one line shorter.
+int Fl_Browser::selected(int n) const
+ Return 1 if line n is selected, 0 if it not selected.
+void Fl_Browser::show(int n)
+ Makes line n visible for selection.
+int Fl_Browser::size() const
+ Returns how many lines are in the browser. The last line number is
+equal to this.
+void Fl_Browser::swap(int a, int b)
+Swaps two lines in the browser.
+const char *Fl_Browser::text(int n) const
+
+ The first form returns the text for line n. If n is
+out of range it returns NULL.
+
void Fl_Browser::text(int n, const char *)int Fl_Browser::topline() const
+
+The first form returns the current top line in the browser. If there
+is no vertical scrollbar then this will always return 1.
+
void Fl_Browser::topline(int n)int Fl_Browser::visible(int n) const
+ Returns a non-zero value if line n is visible.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Browser_.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Browser_.html
new file mode 100644
index 0000000..c7b855d
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Browser_.html
@@ -0,0 +1,419 @@
+
+
+ class Fl_Browser_
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Browser_
+ |
+ +----Fl_Browser, Fl_Check_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_Browser_.H>
+
+
+Description
+ This is the base class for browsers. To be useful it must be
+subclassed and several virtual functions defined. The Forms-compatible
+browser and the file chooser's browser are subclassed off of this.
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Browser::Fl_Browser(int, int,
+int, int, const char * = 0)
+
+Fl_Browser::~Fl_Browser(void)
+
+Fl_Browser_::bbox(int &x, int &y, int &w, int &h) const
+
+Fl_Browser_::deleting(void *a)
+
+int Fl_Browser_::deselect(int docb=0)
+
+Fl_Browser_::display(void *p)
+
+int Fl_Browser_::displayed(void *p) const
+
+Fl_Browser_::draw()
+
+
+
Fl_Browser_::draw(int x, int y, int w, int h)void *Fl_Browser_::find_item(int my)
+
+virtual int Fl_Browser_::full_height() const
+
+Fl_Browser_::full_width() const
+
+Fl_Browser_::handle(int event)
+
+
+
Fl_Browser_::handle(int event, int x, int y, int w, int h)void
+Fl_Browser_::has_scrollbar(int h)
+
+
+
+
+
+
+0 - No scrollbars.
+
+ Fl_Browser_::HORIZONTAL - Only a horizontal
+ scrollbar.
+
+ Fl_Browser_::VERTICAL - Only a vertical
+ scrollbar.
+
+ Fl_Browser_::BOTH - The default is both
+ scrollbars.
+
+ Fl_Browser_::HORIZONTAL_ALWAYS - Horizontal
+ scrollbar always on, vertical always off.
+
+ Fl_Browser_::VERTICAL_ALWAYS - Vertical
+ scrollbar always on, horizontal always off.
+
+ Fl_Browser_::BOTH_ALWAYS - Both always on.
+
+int Fl_Browser_::hposition() const
+
+
+
Fl_Browser_::hposition(int h)virtual int Fl_Browser_::incr_height() const
+
+Fl_Browser_::inserting(void *a, void *b)
+
+virtual void Fl_Browser_::item_draw(void *p, int x, int y, int w, int h)
+
+virtual void *Fl_Browser_::item_first() const
+
+virtual int Fl_Browser_::item_height(void *p) const
+
+virtual void *Fl_Browser_::item_next(void *p) const
+
+virtual void *Fl_Browser_::item_prev(void *p) const
+
+virtual int Fl_Browser_::item_quick_height(void *p) const
+
+virtual void Fl_Browser_::item_select(void *p, int s=1)
+
+virtual int Fl_Browser_::item_selected(void *p) const
+
+virtual int Fl_Browser_::item_width(void *p) const
+
+int Fl_Browser_::leftedge() const
+
+Fl_Browser_::new_list()
+
+int Fl_Browser_::position() const
+
+
+
Fl_Browser_::position(int v) constFl_Browser_::redraw_line(void *p)
+
+Fl_Browser_::redraw_lines()
+
+Fl_Browser_::replacing(void *a, void *b)
+
+Fl_Browser_::resize(int x, int y, int w, int h)
+
+Fl_Browser_::scrollbar_left()
+
+Fl_Browser_::scrollbar_right()
+
+static void Fl_Browser_::scrollbar_width(int sw);
+
+
+static int Fl_Browser_::scrollbar_width() const;int Fl_Browser_::select(void *p, int s=1, int docb=0)
+
+Fl_Browser_::select_only(void *p, int docb=0)
+
+void *Fl_Browser_::selection() const
+
+Fl_Color Fl_Browser_::textcolor() const
+
+
+
void Fl_Browser_::textcolor(Fl_Color color)Fl_Font Fl_Browser_::textfont() const
+
+
+
void Fl_Browser_::textfont(Fl_Font font)uchar Fl_Browser_::textsize() const
+
+
+
void Fl_Browser_::textsize(uchar size)void *Fl_Browser_::top() const
+
+class Fl_Button
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Button
+ |
+ +----Fl_Check_Button, Fl_Light_Button, Fl_Repeat_Button,
+ Fl_Return_Button, Fl_Round_Button, Fl_Toggle_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Button.H>
+
+
+Description
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Button::Fl_Button(int x, int y, int
+w, int h, const char *label = 0)
+ The constructor creates the button using the position, size, and
+label.
+Fl_Button::~Fl_Button(void)
+ The destructor removes the button.
+int Fl_Button::clear()
+ Same as value(0).
+Fl_Boxtype Fl_Button::down_box() const
+
+ The first form returns the current down box type, which is drawn when
+value() is non-zero.
+
void Fl_Button::down_box(Fl_Boxtype bt)int Fl_Button::set()
+ Same as value(1).
+void Fl_Button::setonly()
+ Turns on this button and turns off all other radio buttons in the
+group (calling value(1) or set() does not do this).
+ulong Fl_Button::shortcut() const
+
+ The first form returns the current shortcut key for the button.
+
void Fl_Button::shortcut(ulong key)FL_ALT | 'a'
+, FL_ALT | (FL_F + 10), or just 'a'. A value
+of 0 disables the shortcut. uchar Fl_Button::type() const
+
+ The first form of type() returns the current button type,
+which can be one of:
+
void Fl_Button::type(uchar t)
+
+ The second form sets the button type to t.
+0: The value is unchanged. FL_TOGGLE_BUTTON: The value is inverted. FL_RADIO_BUTTON: The value is set to 1, and all other
+buttons in the current group with type() == FL_RADIO_BUTTON
+ are set to zero. char Fl_Button::value() const
+
+ The first form returns the current value (0 or 1). The second form
+sets the current value.
+
int Fl_Button::value(int)Fl_When Fl_Widget::when() const
+
+ Controls when callbacks are done. The following values are useful,
+the default value is
void Fl_Widget::when(Fl_When w)FL_WHEN_RELEASE:
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Chart.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Chart.html
new file mode 100644
index 0000000..57708be
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Chart.html
@@ -0,0 +1,123 @@
+
+
+ 0: The callback is not done, instead changed() is
+ turned on. FL_WHEN_RELEASE: The callback is done after the user
+ successfully clicks the button, or when a shortcut is typed. FL_WHEN_CHANGED : The callback is done each time the
+ value() changes (when the user pushes and releases the button, and as
+ the mouse is dragged around in and out of the button). class Fl_Chart
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Chart
+
+
+Include Files
+
+
+#include <FL/Fl_Chart.H>
+
+
+Description
+This widget displays simple charts and is provided for Forms compatibility.
+
Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Chart::Fl_Chart(int x, int y, int w,
+int h, const char *label = 0)
+ Creates a new Fl_Chart widget using the given position, size,
+and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Chart::~Fl_Chart()
+ Destroys the Fl_Chart widget and all of its data.
+void add(double value, const char *label =
+NULL, uchar color = 0)
+ The add method adds the value and optionally
+label and color to the chart.
+uchar autosize(void) const
+
+ The autosize method controls whether or not the chart will
+automatically adjust the bounds of the chart. The first form returns a
+boolean value that is non-zero if auto-sizing is enabled and zero is
+auto-sizing is disabled.
+
void autosize(uchar onoff)void bounds(double *a, double *b)
+
+ The bounds method gets or sets the lower and upper bounds of
+the chart values to a and b respectively.
+
void bounds(double a, double b)void clear(void)
+ The clear method removes all values from the chart.
+void insert(int pos, double value, const
+char *label = NULL, uchar color = 0)
+ The insert method inserts a data value at the given position
+pos. Position 1 is the first data value.
+int maxsize(void) const
+
+The maxsize method gets or sets the maximum number of data
+values for a chart. If you do not call this method then the chart will
+be allowed to grow to any size depending on available memory.
+
void maxsize(int n)void replace(int pos, double value, const
+char *label = NULL, uchar color = 0)
+ The replace method replaces data value pos with
+value, label, and color. Position 1 is the
+first data value.
+int size(void) const
+ The size method returns the number of data values in the
+chart.
+uchar type() const
+
+ The first form of type() returns the current chart type. The
+chart type can be one of the following:
+
void type(uchar t)
+
+ The second form of type() sets the chart type to t.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Browser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Browser.html
new file mode 100644
index 0000000..e0b69a0
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Browser.html
@@ -0,0 +1,104 @@
+
+
+ class Fl_Check_Browser
+
+Class Hierarchy
+
+
+Fl_Browser_
+ |
+ +----Fl_Check_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_Check_Browser.H>
+
+
+Description
+
+The Fl_Check_Browser widget displays a scrolling list of text
+lines that may be selected and/or checked by the user.
+
+Methods
+
+
+
+
+
+
+
+
+
+
+
+Fl_Check_Browser::Fl_Check_Browser(int, int, int, int, const char * = 0)
+The constructor makes an empty browser.
+
+int Fl_Check_Browser::add(const char *)
+Add a new unchecked line to the end of the browser. The text is copied
+using the strdup() function. It may also be NULL to make
+a blank line. The second form can set the item checked.
+
+
+int Fl_Check_Browser::add(const char *, int)void Fl_Check_Browser::check_all()
+Sets all the items checked.
+
+void Fl_Check_Browser::check_none()
+Sets all the items unchecked.
+
+int Fl_Check_Browser::checked(int item) const
+The first form gets the current status of item item. The second form
+sets the check status of item item to b.
+
+
+void Fl_Check_Browser::checked(int item, int b)void Fl_Check_Browser::clear()
+Remove every item from the browser.
+
+int Fl_Check_Browser::nchecked() const
+Returns how many items are currently checked.
+
+int Fl_Check_Browser::nitems() const
+Returns how many lines are in the browser. The last line number is equal to
+this.
+
+int Fl_Check_Browser::remove(int n)
+Remove line n and make the browser one line shorter. Returns the
+number of lines left in the browser.
+
+void Fl_Check_Browser::set_checked(int item)
+Equivalent to Fl_Check_Browser::checked(item, 1).
+
+char *Fl_Check_Browser::text(int item) const
+Return a pointer to an internal buffer holding item item's text.
+
+int Fl_Check_Browser::value() const
+Returns the index of the currently selected item.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Button.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Button.gif
new file mode 100644
index 0000000..bbd6f4e
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Button.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Button.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Button.html
new file mode 100644
index 0000000..ae4c8df
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Check_Button.html
@@ -0,0 +1,45 @@
+
+
+ class Fl_Check_Button
+
+Class Hierarchy
+
+
+Fl_Button
+ |
+ +----Fl_Check_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Check_Button.H>
+
+
+Description
+Buttons generate callbacks when they are clicked by the user. You
+control exactly when and how by changing the values for type()
+and when().
+
Methods
+
+
+Fl_Check_Button::Fl_Check_Button(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Check_Button widget using the given
+position, size, and label string.
+
+Fl_Check_Button::~Fl_Check_Button()
+ The destructor deletes the check button.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Choice.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Choice.html
new file mode 100644
index 0000000..fbe040f
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Choice.html
@@ -0,0 +1,88 @@
+
+
+ class Fl_Choice
+
+Class Hierarchy
+
+
+Fl_Menu_
+ |
+ +----Fl_Choice
+
+
+Include Files
+
+
+#include <FL/Fl_Choice.H>
+
+
+Description
+ This is a button that when pushed pops up a menu (or hierarchy of
+menus) defined by an array of
+Fl_Menu_Item objects. Motif calls this an OptionButton.
+
Methods
+
+Fl_Choice::Fl_Choice(int x, int y, int
+w, int h, const char *label = 0)
+ Creates a new Fl_Choice widget using the given position,
+size, and label string. The default boxtype is FL_UP_BOX.
+virtual Fl_Choice::~Fl_Choice()
+ The destructor removes the Fl_Choice widget and all of its
+menu items.
+int Fl_Choice::value() const
+
+ The value is the index into the Fl_Menu array of the last
+item chosen by the user. It is zero initially. You can set it as an
+integer, or set it with a pointer to a menu item. The set routines
+return non-zero if the new value is different than the old one.
+ Changing it causes a redraw().
+
int Fl_Choice::value(int)
+
int Fl_Choice::value(const Fl_Menu *)int Fl_Widget::changed() const
+ This value is true if the user picks a different value. It is
+turned off by value() and just before doing a callback (the
+callback can turn it back on if desired).
+void Fl_Widget::set_changed()
+ This method sets the changed() flag.
+void Fl_Widget::clear_changed()
+ This method clears the changed() flag.
+Fl_Boxtype Fl_Choice::down_box() const
+
+ The first form gets the current down box, which is used when the menu
+is popped up. The default down box type is FL_DOWN_BOX The
+second form sets the current down box type to b.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Clock.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Clock.html
new file mode 100644
index 0000000..768c6bb
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Clock.html
@@ -0,0 +1,52 @@
+
+
+
void Fl_Choice::down_box(Fl_Boxtype b)class Fl_Clock
+
+Class Hierarchy
+
+
+Fl_Clock_Output
+ |
+ +----Fl_Clock
+
+
+Include Files
+
+
+#include <FL/Fl_Clock.H>
+
+
+Description
+ This widget provides a round analog clock display and is provided for
+Forms compatibility. It installs a 1-second timeout callback using
+Fl::add_timeout().
+

Methods
+
+Fl_Clock::Fl_Clock(int x, int y, int w,
+int h, const char *label = 0)
+ Creates a new Fl_Clock widget using the given position, size,
+and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Clock::~Fl_Clock()
+ The destructor removes the clock.
+int Fl_Clock_Output::hour() const
+ Returns the current hour (0 to 23).
+int Fl_Clock_Output::minute() const
+ Returns the current minute (0 to 59).
+int Fl_Clock_Output::second() const
+ Returns the current second (0 to 60, 60 = leap second).
+ulong Fl_Clock::value(void)
+ Returns the displayed time in seconds since the UNIX epoch (January 1, 1970).
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Clock_Output.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Clock_Output.html
new file mode 100644
index 0000000..dea326a
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Clock_Output.html
@@ -0,0 +1,62 @@
+
+
+ class Fl_Clock_Output
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Clock_Output
+ |
+ +----Fl_Clock
+
+
+Include Files
+
+
+#include <FL/Fl_Clock.H>
+
+
+Description
+
+Methods
+
+
+Fl_Clock_Output::Fl_Clock_Output(int x, int y, int w,
+int h, const char *label = 0)
+ Creates a new Fl_Clock_Output widget using the given position, size,
+and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Clock_Output::~Fl_Clock_Output()
+ The destructor removes the clock.
+int Fl_Clock_Output::hour() const
+ Returns the current hour (0 to 23).
+int Fl_Clock_Output::minute() const
+ Returns the current minute (0 to 59).
+int Fl_Clock_Output::second() const
+ Returns the current second (0 to 60, 60 = leap second).
+void Fl_Clock_Output::value(ulong v)
+
+ The first two forms of value set the displayed time to the
+given UNIX time value or specific hours, minutes, and seconds.
+
void Fl_Clock_Output::value(int h, int m, int s)
+
ulong Fl_Clock_Output::value(void)class Fl_Color_Chooser
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Color_Chooser
+
+
+Include Files
+
+
+#include <FL/Fl_Color_Chooser.H>
+
+
+Description
+ The Fl_Color_Chooser widget provides a standard RGB color
+chooser. You can place any number of these into a panel of your own
+design. This widget contains the hue box, value slider, and rgb input
+fields from the above diagram (it does not have the color chips or the
+Cancel or OK buttons). The callback is done every time the user
+changes the rgb value. It is not done if they move the hue control in
+a way that produces the same rgb value, such as when saturation
+or value is zero.
+Methods
+
+
+
+Fl_Color_Chooser::Fl_Color_Chooser(int x, int y, int w, int h, const
+char *label = 0)
+ Creates a new Fl_Color_Chooser widget using the given
+position, size, and label string. The recommended dimensions are
+200x95. The color is initialized to black.
+virtual
+Fl_Color_Chooser::~Fl_Color_Chooser()
+ The destructor removes the color chooser and all of its controls.
+double Fl_Color_Chooser::hue() const
+
+ Return the current hue. 0 <= hue < 6. Zero is red, one is yellow,
+two is green, etc. This value is convienent for the internal
+calculations - some other systems consider hue to run from zero to one,
+or from 0 to 360.
+double
+Fl_Color_Chooser::saturation() const
+ Returns the saturation. 0 <= saturation <= 1.
+double Fl_Color_Chooser::value()
+const
+ Returns the value/brightness. 0 <= value <= 1.
+double Fl_Color_Chooser::r() const
+ Returns the current red value. 0 <= r <= 1.
+double Fl_Color_Chooser::g() const
+ Returns the current green value. 0 <= g <= 1.
+double Fl_Color_Chooser::b() const
+ Returns the current blue value. 0 <= b <= 1.
+int Fl_Color_Chooser::rgb(double,
+double, double)
+ Sets the current rgb color values. Does not do the callback. Does
+not clamp (but out of range values will produce psychedelic effects in
+the hue selector).
+int
+Fl_Color_Chooser::hsv(double,double,double)
+ Set the hsv values. The passed values are clamped (or for hue,
+modulus 6 is used) to get legal values. Does not do the callback.
+static void
+Fl_Color_Chooser::hsv2rgb(double, double, double, double&, double&,
+double&)
+ This static method converts HSV colors to RGB colorspace.
+static void
+Fl_Color_Chooser::rgb2hsv(double, double, double, double&, double&,
+double&)
+ This static method converts RGB colors to HSV colorspace.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Counter.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Counter.html
new file mode 100644
index 0000000..d8aff39
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Counter.html
@@ -0,0 +1,51 @@
+
+
+ class Fl_Counter
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Counter
+
+
+Include Files
+
+
+#include <FL/Fl_Counter.H>
+
+
+Description
+ The Fl_Counter widget is provided for forms compatibility.
+ It controls a single floating point value.
+
Methods
+
+
+Fl_Counter::Fl_Counter(int x, int y,
+int w, int h, const char *label = 0)
+ Creates a new Fl_Counter widget using the given position,
+size, and label string. The default type is FL_NORMAL_COUNTER.
+virtual Fl_Counter::~Fl_Counter()
+Destroys the valuator.
+double Fl_Counter::lstep() const
+Set the increment for the double-arrow buttons. The default
+value is 1.0.
+type(uchar)
+ Sets the type of counter:
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Dial.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Dial.html
new file mode 100644
index 0000000..bcf1abb
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Dial.html
@@ -0,0 +1,65 @@
+
+
+ class Fl_Dial
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Dial
+
+
+Include Files
+
+
+#include <FL/Fl_Dial.H>
+
+
+Description
+ The Fl_Dial widget provides a circular dial to control a
+single floating point value.
+
Methods
+
+Fl_Dial::Fl_Dial(int x, int y, int w, int
+h, const char *label = 0)
+ Creates a new Fl_Dial widget using the given position, size,
+and label string. The default type is FL_NORMAL_DIAL.
+virtual Fl_Dial::~Fl_Dial()
+ Destroys the valuator.
+
+
+
+short Fl_Dial::angle1() const;
+
+Sets the angles used for the minimum and maximum values. The default
+values are 45 and 315 (0 degrees is straight down and the angles
+progress clockwise). Normally angle1 is less than angle2, but if you
+reverse them the dial moves counter-clockwise.
+
+
+void Fl_Dial::angle1(short);
+short Fl_Dial::angle2() const;
+void Fl_Dial::angle2(short);
+void Fl_Dial::angles(short a, short b);
+
+type(uchar)
+ Sets the type of the dial to:
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Double_Window.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Double_Window.html
new file mode 100644
index 0000000..88441d2
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Double_Window.html
@@ -0,0 +1,54 @@
+
+
+ class Fl_Double_Window
+
+Class Hierarchy
+
+
+Fl_Window
+ |
+ +----Fl_Double_Window
+
+
+Include Files
+
+
+#include <FL/Fl_Double_Window.H>
+
+
+Description
+ The Fl_Double_Window class provides a double-buffered window.
+ If possible this will use the X double buffering extension (Xdbe). If
+not, it will draw the window data into an off-screen pixmap, and then
+copy it to the on-screen window.
+
+
+Fl::visual(FL_DOUBLE|FL_INDEX)
+
+
+ This makes sure you can use Xdbe on servers where double buffering
+does not exist for every visual.
+Methods
+
+
+Fl_Double_Window::Fl_Double_Window(int w, int h, const
+char *label = 0)
+
+Fl_Double_Window::Fl_Double_Window(int x, int y, int w, int h, const
+char *label = 0)virtual
+Fl_Double_Window::~Fl_Double_Window()
+ The destructor also deletes all the children. This allows a
+whole tree to be deleted at once, without having to keep a pointer to
+all the children in the user code.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_End.html b/third_party/windows/fltk-1.1.10/documentation/Fl_End.html
new file mode 100644
index 0000000..faea027
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_End.html
@@ -0,0 +1,45 @@
+
+
+ class Fl_End
+
+Class Hierarchy
+
+
+Fl_End
+
+
+Include Files
+
+
+#include <FL/Fl_Group.H>
+
+
+Description
+This is a dummy class that allows you to end a Fl_Group in a constructor list of a
+class:
+
+
class MyClass {
+ Fl_Group group;
+ Fl_Button button_in_group;
+ Fl_End end;
+ Fl_Button button_outside_group;
+ MyClass();
+};
+MyClass::MyClass() :
+ group(10,10,100,100),
+ button_in_group(20,20,60,30),
+ end(),
+ button_outside_group(10,120,60,30)
+{}
+
+Methods
+
+
+Fl_End::Fl_End
+ The constructor does Fl_Group::current()->end().
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_File_Browser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Browser.html
new file mode 100644
index 0000000..d516033
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Browser.html
@@ -0,0 +1,84 @@
+
+
+ class Fl_File_Browser
+
+
+
+Class Hierarchy
+
+
+Fl_Browser
+ |
+ +----Fl_File_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_File_Browser.H>
+
+
+Description
+
+Fl_File_Browser widget displays a list of filenames,
+optionally with file-specific icons.
+
+Methods
+
+
+
+
+
+Fl_File_Browser(int xx, int yy, int ww, int hh, const char *l = 0)
+
+Fl_File_Browser widget at the specified
+position and size.
+
+~Fl_File_Browser()
+
+void iconsize(uchar s)
+
+
+uchar iconsize() constvoid filter(const char *pattern)
+
+
+const char *filter() constfl_filename_match()
+function in FLTK.
+
+void filetype(int type)
+
+
+int filetype() constFILES or
+DIRECTORIES. When set to FILES, both
+files and directories are shown. Otherwise only directories are
+shown.
+
+int load(const char *directory, Fl_File_Sort_F *sort = fl_numeric_sort)
+
+class Fl_File_Chooser
+
+
+
+Class Hierarchy
+
+
+Fl_File_Chooser
+
+
+Include Files
+
+
+#include <FL/Fl_File_Chooser.H>
+
+
+Description
+
+Fl_File_Chooser widget displays a standard file selection
+dialog that supports various selection modes.
+
+
Fl_File_Chooser class also exports several static values
+that may be used to localize or customize the appearance of all file chooser
+dialogs:
+
+
+
+
+Member
+ Default value
+
+
+add_favorites_label
+ "Add to Favorites"
+
+
+all_files_label
+ "All Files (*)"
+
+
+custom_filter_label
+ "Custom Filter"
+
+
+existing_file_label
+ "Please choose an existing file!"
+
+
+favorites_label
+ "Favorites"
+
+
+filename_label
+ "Filename:"
+
+
+filesystems_label
+ "My Computer" (WIN32)
+
+ "File Systems" (all others)
+
+manage_favorites_label
+ "Manage Favorites"
+
+
+new_directory_label
+ "New Directory?"
+
+
+new_directory_tooltip
+ "Create a new directory."
+
+
+preview_label
+ "Preview"
+
+
+save_label
+ "Save"
+
+
+show_label
+ "Show:"
+
+
+sort
+ fl_numericsort
+Public Members
+
+Fl_File_Chooser class exports the "new
+directory" (newButton) and "preview"
+(previewButton) widgets so that application
+developers can control their appearance and use. For more
+complex customization, consider copying the FLTK file chooser
+code and changing it accordingly.
+
+Methods
+
+
+
+
+
+Fl_File_Chooser(const char *pathname, const char *pattern,
+int type, const char *title)
+
+Fl_File_Chooser dialog pictured
+above. The pathname argument can be a directory name or a
+complete file name (in which case the corresponding file is highlighted
+in the list and in the filename input field.)
+
+pattern argument can be a NULL
+string or "*" to list all files, or it can be a
+series of descriptions and filter strings separated by tab
+characters (\t). The format of filters is either
+"Description text (patterns)" or just "patterns". A file chooser
+that provides filters for HTML and image files might look like:
+
+
+"HTML Files (*.html)\tImage Files (*.{bmp,gif,jpg,png})"
+
+
+fl_filename_match()
+for the kinds of pattern strings that are supported.
+
+type argument can be one of the following:
+
+
+
+
+SINGLE - allows the user to select a
+ single, existing file.
+ MULTI - allows the user to select one
+ or more existing files.
+ CREATE - allows the user to select a
+ single, existing file or specify a new filename.
+ DIRECTORY - allows the user to select a
+ single, existing directory.
+title argument is used to set the title bar text for the
+Fl_File_Chooser window.
+
+~Fl_File_Chooser()
+
+void color(Fl_Color c)
+
+
+Fl_Color color()Fl_File_Browser list.
+
+int count()
+
+void directory(const char *pathname)
+
+
+const char *directory()void filter(const char *pattern)
+
+
+const char *filter()void filter_value(int f)
+
+
+int filter_value()void hide()
+
+Fl_File_Chooser window.
+
+void iconsize(uchar s)
+
+
+uchar iconsize()Fl_File_Browser. By
+default the icon size is set to 1.5 times the textsize().
+
+void label(const char *l)
+
+
+const char *label()Fl_File_Chooser.
+
+void ok_label(const char *l)
+
+
+const char *ok_label()Fl_File_Chooser.
+
+void preview(int e)
+
+
+int preview()void rescan()
+
+Fl_File_Browser.
+
+void show()
+
+Fl_File_Chooser window.
+
+void textcolor(Fl_Color c)
+
+
+Fl_Color textcolor()Fl_File_Browser text color.
+
+void textfont(uchar f)
+
+
+uchar textfont()Fl_File_Browser text font.
+
+void textsize(uchar s)
+
+
+uchar textsize()Fl_File_Browser text size.
+
+void type(int t)
+
+
+int type()Fl_File_Chooser.
+
+const char *value(const char *pathname)
+
+
+const char *value(int file)
+const char *value()Fl_File_Chooser::count().
+
+
+// Get list of filenames user selected from a MULTI chooser
+for ( int t=1; t<=chooser->count(); t++ ) {
+ const char *filename = chooser->value(t);
+ ..
+}
+
+
+int visible()
+
+Fl_File_Chooser window is visible.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_File_Chooser.jpg b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Chooser.jpg
new file mode 100644
index 0000000..050227d
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Chooser.jpg differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_File_Icon.html b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Icon.html
new file mode 100644
index 0000000..4cef8af
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_File_Icon.html
@@ -0,0 +1,156 @@
+
+class Fl_File_Icon
+
+
+
+Class Hierarchy
+
+
+Fl_File_Icon
+
+
+Include Files
+
+
+#include <FL/Fl_File_Icon.H>
+
+
+Description
+
+Fl_File_Icon class manages icon images that can be
+used as labels in other widgets and as icons in the FileBrowser
+widget.
+
+Methods
+
+
+
+
+
+Fl_File_Icon()
+
+Fl_File_Icon with the specified
+information.
+
+~Fl_File_Icon()
+
+short *add(short d)
+
+short *add_color(short c)
+
+short *add_vertex(int x, int y)
+
+
+short *add_vertex(float x, float y)void clear()
+
+void draw(int x, int y, int w, int h, Fl_Color ic, int active = 1)
+
+static Fl_File_Icon *find(const char *filename, int filetype = ANY);
+
+static Fl_File_Icon *first()
+
+void label(Fl_Widget *w)
+
+Fl_File_Icon
+label type as needed.
+
+static void labeltype(const Fl_Label *o, int x, int y, int w, int h, Fl_Align a)
+
+void load(const char *f)
+
+void load_fti(const char *fti)
+
+static void load_system_icons(void)
+
+FileChooser widget and should be used when the application
+starts:
+
+
+Fl_File_Icon::load_system_icons();
+
+
+void load_xpm(const char *xpm)
+
+const char *pattern()
+
+int size()
+
+int type()
+
+
+
+
+Fl_File_Icon::ANY, any kind of file.
+ Fl_File_Icon::PLAIN, plain files.
+ Fl_File_Icon::FIFO, named pipes.
+ Fl_File_Icon::DEVICE, character and block devices.
+ Fl_File_Icon::LINK, symbolic links.
+ Fl_File_Icon::DIRECTORY, directories.
+short *value()
+
+class Fl_File_Input
+
+
+
+Class Hierarchy
+
+
+Fl_Input
+ |
+ +----Fl_File_Input
+
+
+Include Files
+
+
+#include <FL/Fl_File_Input.H>
+
+
+Description
+
+
Methods
+
+
+
+
+
+Fl_File_Input::Fl_File_Input(int x, int y, int
+w, int h, const char *label = 0)
+
+virtual Fl_File_Input::~Fl_File_Input()
+
+Fl_Boxtype Fl_File_Input::down_box() const
+
+
+
void Fl_File_Input::down_box(Fl_Boxtype b)class Fl_Float_Input
+
+Class Hierarchy
+
+
+Fl_Input
+ |
+ +----Fl_Float_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Float_Input.H>
+
+
+Description
+ The Fl_Float_Input class is a subclass of Fl_Input
+ that only allows the user to type floating point numbers (sign,
+ digits, decimal point, more digits, 'E' or 'e', sign, digits).
+Methods
+
+
+Fl_Float_Input::Fl_Float_Input(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Float_Input widget using the given position,
+size, and label string. The default boxtype is FL_DOWN_BOX.
+virtual
+Fl_Float_Input::~Fl_Float_Input()
+ Destroys the widget and any value associated with it.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Free.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Free.html
new file mode 100644
index 0000000..11585a3
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Free.html
@@ -0,0 +1,78 @@
+
+
+ class Fl_Free
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Free
+
+
+Include Files
+
+
+#include <FL/Fl_Free.H>
+
+
+Description
+ Emulation of the Forms "free" widget. This emulation allows the free
+demo to run, and appears to be useful for porting programs written in
+Forms which use the free widget or make subclasses of the Forms
+widgets.
+
+
+#define FL_NORMAL_FREE 1
+#define FL_SLEEPING_FREE 2
+#define FL_INPUT_FREE 3
+#define FL_CONTINUOUS_FREE 4
+#define FL_ALL_FREE 5
+
+
+Methods
+
+Fl_Free(uchar type, int, int, int, int,
+const char*l, FL_HANDLEPTR hdl)
+ The constructor takes both the type and the handle
+ function. The handle function should be declared as follows:
+
+
+int
+handle_function(Fl_Widget *w,
+ int event,
+ float event_x,
+ float event_y,
+ char key)
+
+
+ This function is called from the the handle() method in
+response to most events, and is called by the draw() method.
+The event argument contains the event type:
+
+
+// old event names for compatability:
+#define FL_MOUSE FL_DRAG
+#define FL_DRAW 0
+#define FL_STEP 9
+#define FL_FREEMEM 12
+#define FL_FREEZE FL_UNMAP
+#define FL_THAW FL_MAP
+
+
+virtual Fl_Free::~Fl_Free()
+ The destructor will call the handle function with the event
+FL_FREE_MEM.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_GIF_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_GIF_Image.html
new file mode 100644
index 0000000..a9a4854
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_GIF_Image.html
@@ -0,0 +1,58 @@
+
+
+ class Fl_GIF_Image
+
+
+Class Hierarchy
+
+
+Fl_Pixmap
+ |
+ +----Fl_GIF_Image
+
+
+Include Files
+
+
+#include <FL/Fl_GIF_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_GIF_Image::Fl_GIF_Image(const char *filename);
+
+Fl_GIF_Image::~Fl_GIF_Image();
+
+class Fl_Gl_Window
+
+
+
+Class Hierarchy
+
+
+Fl_Window
+ |
+ +----Fl_Gl_Window
+
+
+Include Files
+
+
+#include <FL/Fl_Gl_Window.H>
+
+
+Additional Libraries
+
+
+-lfltk_gl / fltkgl.lib
+
+
+Description
+ The Fl_Gl_Window widget sets things up so OpenGL works, and
+also keeps an OpenGL "context" for that window, so that changes to the
+lighting and projection may be reused between redraws. Fl_Gl_Window
+ also flushes the OpenGL streams and swaps buffers after draw()
+ returns.
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Gl_Window::Fl_Gl_Window(int x,
+int y, int w, int h, const char *label = 0)
+ Creates a new Fl_Gl_Window widget using the given position,
+size, and label string. The default boxtype is FL_NO_BOX. The
+default mode is FL_RGB|FL_DOUBLE|FL_DEPTH.
+virtual
+Fl_Gl_Window::~Fl_Gl_Window()
+ The destructor removes the widget and destroys the OpenGL context
+associated with it.
+virtual void Fl_Gl_Window::draw(void)
+Fl_Gl_Window::draw() is a pure virtual method. You must
+subclass Fl_Gl_Window and provide an implementation for
+draw(). You may also provide an implementation of draw_overlay()
+if you want to draw into the overlay planes. You can avoid
+reinitializing the viewport and lights and other things by checking
+valid() at the start of draw() and only doing the
+initialization if it is false.
+const int Fl_Gl_Window::mode() const
+
+ Set or change the OpenGL capabilites of the window. The value can be
+any of the following OR'd together:
+
int Fl_Gl_Window::mode(int m)
+
+FL_RGB and FL_SINGLE have a value of zero, so they
+are "on" unless you give FL_INDEX or FL_DOUBLE.
+static int Fl_Gl_Window::can_do(int)
+
+ Returns non-zero if the hardware supports the given or current OpenGL
+mode.
+
+
int Fl_Gl_Window::can_do() constvoid* Fl_Gl_Window::context() const;
+
+
+Return or set a pointer to the GLContext that this window is
+using. This is a system-dependent structure, but it is portable to copy
+the context from one window to another. You can also set it to NULL,
+which will force FLTK to recreate the context the next time make_current() is called, this is
+useful for getting around bugs in OpenGL implementations.
+
+
void Fl_Gl_Window::context(void*, int destroy_flag = false);char Fl_Gl_Window::valid() const
+
+Fl_Gl_Window::valid() is turned off when FLTK creates a new
+context for this window or when the window resizes, and is turned on
+after draw() is called. You can use this inside your
+draw() method to avoid unneccessarily initializing the OpenGL
+context. Just do this:
+
void Fl_Gl_Window::valid(char i)
+void mywindow::draw() {
+ if (!valid()) {
+ glViewport(0,0,w(),h());
+ glFrustum(...);
+ ...other initialization...
+ }
+ if (!context_valid()) {
+ ...load textures, etc. ...
+ }
+ ... draw your geometry here ...
+}
+
+
+You can turn valid() on by calling valid(1). You
+should only do this after fixing the transformation inside a draw()
+or after make_current(). This is done automatically after
+draw() returns.
+void Fl_Gl_Window::invalidate()
+ The invalidate() method turns off valid() and is
+equivalent to calling value(0).
+
+char Fl_Gl_Window::context_valid() const
+
+Fl_Gl_Window::context_valid() will only be set if the
+OpenGL context is created or recreated. It differs from
+Fl_Gl_Window::valid() which is also set whenever the context
+changes size.
+
+
void Fl_Gl_Window::context_valid(char i)void Fl_Gl_Window::ortho()
+ Set the projection so 0,0 is in the lower left of the window and each
+pixel is 1 unit wide/tall. If you are drawing 2D images, your
+draw() method may want to call this if valid() is false.
+void Fl_Gl_Window::make_current()
+
+ The make_current() method selects the OpenGL context for the
+widget. It is called automatically prior to the draw() method
+being called and can also be used to implement feedback and/or
+selection within the handle() method.
+void
+Fl_Gl_Window::make_overlay_current()
+ The make_overlay_current() method selects the OpenGL context
+for the widget's overlay. It is called automatically prior to the
+draw_overlay() method being called and can also be used to
+implement feedback and/or selection within the handle()
+ method.
+void Fl_Gl_Window::swap_buffers()
+
+ The swap_buffers() method swaps the back and front buffers.
+It is called automatically after the draw() method is called.
+void Fl_Gl_Window::hide()
+ Hides the window and destroys the OpenGL context.
+int
+Fl_Gl_Window::can_do_overlay()
+ Returns true if the hardware overlay is possible. If this is false,
+FLTK will try to simulate the overlay, with significant loss of update
+speed. Calling this will cause FLTK to open the display.
+void
+Fl_Gl_Window::redraw_overlay()
+ This method causes draw_overlay to be called at a later time.
+ Initially the overlay is clear, if you want the window to display
+something in the overlay when it first appears, you must call this
+immediately after you show() your window.
+virtual void
+Fl_Gl_Window::draw_overlay()
+ You must implement this virtual function if you want to draw into the
+overlay. The overlay is cleared before this is called. You should
+draw anything that is not clear using OpenGL. You must use
+gl_color(i) to choose colors (it allocates them from the colormap
+using system-specific calls), and remember that you are in an indexed
+OpenGL mode and drawing anything other than flat-shaded will probably
+not work.
+class Fl_Group
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Group
+ |
+ +----Fl_Browser_, Fl_Color_Chooser, Fl_Help_View, Fl_Input_Choice, Fl_Pack,
+ Fl_Scroll, Fl_Tabs, Fl_Spinner, Fl_Tabs, Fl_Text_Display, Fl_Tile,
+ Fl_Window, Fl_Wizard
+
+
+Include Files
+
+
+#include <FL/Fl_Group.H>
+
+
+Description
+ The Fl_Group class is the FLTK container widget. It maintains
+an array of child widgets. These children can themselves be any widget
+including Fl_Group. The most important subclass of Fl_Group
+ is Fl_Window, however
+groups can also be used to control radio buttons or to enforce resize
+behavior.
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Group::Fl_Group(int x, int y, int w,
+int h, const char *label = 0)
+ Creates a new Fl_Group widget using the given position, size,
+and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Group::~Fl_Group()
+ The destructor also deletes all the children. This allows a
+whole tree to be deleted at once, without having to keep a pointer to
+all the children in the user code. A kludge has been done so the
+Fl_Group and all of it's children can be automatic (local)
+variables, but you must declare the Fl_Group first, so
+that it is destroyed last.
+void Fl_Group::add(Fl_Widget &w)
+
+
+The widget is removed from it's current group (if any) and then added
+to the end of this group.
+
+
void Fl_Group::add(Fl_Widget *w)void Fl_Group::clear()
+
+void Fl_Group::clip_children(int c);
+
+The first method controls whether the group widget clips the drawing of
+child widgets to its bounding box.
+
+
+int Fl_Group::clip_children();void Fl_Group::init_sizes()
+
+The Fl_Group widget keeps track of the original widget sizes and
+positions when resizing occurs so that if you resize a window back to its
+original size the widgets will be in the correct places. If you rearrange
+the widgets in your group, call this method to register the new arrangement
+with the Fl_Group that contains them.
+
+void Fl_Group::insert(Fl_Widget &w, int n)
+
+The widget is removed from it's current group (if any) and then
+inserted into this group. It is put at index n (or at the end
+if n >= children(). This can also be used to rearrange
+the widgets inside a group.
+
+void Fl_Group::insert(Fl_Widget &w, Fl_Widget* beforethis)
+
+This does insert(w, find(beforethis)). This will append the
+widget if beforethis is not in the group.
+
+void Fl_Group::remove(Fl_Widget &w)
+
+static Fl_Group *Fl_Group::current()
+
+current() returns the currently active group. The Fl_Widget
+ constructor automatically does current()->add(widget) if this is not null.
+ To prevent new widgets from being added to a group, call Fl_Group::current(0).
+
static void Fl_Group::current(Fl_Group *w)void Fl_Group::begin()
+begin() sets the current group so you can build the widget
+tree by just constructing the widgets. begin() is
+automatically called by the constructor for Fl_Group (and thus for
+Fl_Window as well). begin() is exactly the same as current(this).
+void Fl_Group::end()
+end() is exactly the same as current(this->parent()). Any new widgets
+added to the widget tree will be added to the parent of the group.
+const Fl_Widget **Fl_Group::array() const
+ Returns a pointer to the array of children. This pointer is only
+ valid until the next time a child is added or removed.
+Fl_Widget *Fl_Group::child(int n) const
+ Returns array()[n]. No range checking is done!
+int Fl_Group::children() const
+ Returns how many child widgets the group has.
+int Fl_Group::find(const Fl_Widget *w) const
+
+ Searches the child array for the widget and returns the index. Returns children() if the widget is
+NULL or not found.
+
int Fl_Group::find(const Fl_Widget &w) constvoid Fl_Group::resizable(Fl_Widget *box)
+
+ The resizable widget defines the resizing box for the group. When the
+group is resized it calculates a new size and position for all of its
+children. Widgets that are horizontally or vertically inside the
+dimensions of the box are scaled to the new size. Widgets outside the
+box are moved.
+
void Fl_Group::resizable(Fl_Widget &box)
+
Fl_Widget *Fl_Group::resizable() const
+
Fl_Group
+&Fl_Group::add_resizable(Fl_Widget &box)
+ Adds a widget to the group and makes it the resizable widget.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Help_Dialog.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Help_Dialog.gif
new file mode 100644
index 0000000..92b0840
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Help_Dialog.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Help_Dialog.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Help_Dialog.html
new file mode 100644
index 0000000..8b74a64
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Help_Dialog.html
@@ -0,0 +1,120 @@
+
+
+ class Fl_Help_Dialog
+
+
+
+Class Hierarchy
+
+
+Fl_Help_Dialog
+
+
+Include Files
+
+
+#include "Fl_Help_Dialog.h"
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Fl_Help_Dialog widget displays a standard help dialog window
+using the Fl_Help_View widget.
+
+
Methods
+
+
+
+
+
+Fl_Help_Dialog()
+
+~Fl_Help_Dialog()
+
+void hide()
+
+Fl_Help_Dialog window.
+
+void load(const char *f)
+
+Fl_Help_View widget.
+The filename can also contain a target name ("filename.html#target").
+
+void position(int x, int y)
+
+void resize(int xx, int yy, int ww, int hh)
+
+void show()
+
+Fl_Help_Dialog window.
+
+void textsize(uchar s)
+
+
+uchar textsize()void topline(const char *n)
+
+
+void topline(int n)Fl_Help_View widget to the named or
+numbered line.
+
+void value(const char *v)
+
+
+const char *value() constint visible()
+
+Fl_Help_Dialog window is visible.
+
+int x()
+
+
+int y()
+int w()
+int h()
+class Fl_Help_View
+
+
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Help_View
+
+
+Include Files
+
+
+#include "Fl_Help_View.h"
+
+
+Description
+
+Fl_Help_View widget displays HTML text. Most HTML 2.0
+elements are supported, as well as a primitive implementation of tables.
+GIF, JPEG, and PNG images are displayed inline.
+
+Methods
+
+
+
+
+
+Fl_Help_View(int xx, int yy, int ww, int hh, const char *l = 0)
+
+Fl_Help_View widget at the specified
+position and size.
+
+~Fl_Help_View()
+
+const char *directory() const
+
+const char *filename() const
+
+void link(Fl_Help_Func *fn)
+
+Fl_Help_View::load()) that requires a different
+file or path. The callback function receives a pointer to the
+Fl_Help_View widget and the URI or full pathname
+for the file in question. It must return a pathname that can be
+opened as a local file or NULL:
+const char *fn(Fl_Widget *w, const char *uri);
+
+
+int load(const char *f)
+
+int size() const
+
+void textcolor(Fl_Color c)
+
+
+Fl_Color textcolor() constvoid textfont(uchar f)
+
+
+uchar textfont() constvoid textsize(uchar s)
+
+
+uchar textsize() constconst char *title()
+
+void topline(const char *n)
+
+
+void topline(int)
+int topline() constvoid value(const char *v)
+
+
+const char *value() constclass Fl_Hold_Browser
+
+Class Hierarchy
+
+
+Fl_Browser
+ |
+ +----Fl_Hold_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_Hold_Browser.H>
+
+
+Description
+ The Fl_Hold_Browser class is a subclass of Fl_Browser
+ which lets the user select a single item, or no items by clicking on
+the empty space. As long as the mouse button is held down the item
+pointed to by it is highlighted, and this highlighting remains on when
+the mouse button is released. Normally the callback is done when the
+user releases the mouse, but you can change this with when().
+Methods
+
+
+Fl_Hold_Browser::Fl_Hold_Browser(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Hold_Browser widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+virtual
+Fl_Hold_Browser::~Fl_Hold_Browser()
+ The destructor also deletes all the items in the list.
+int Fl_Browser::deselect()
+int Fl_Browser::select(int,int=1)
+
+ You can use these for compatibility with
+Fl_Multi_Browser. If you turn on the selection of more
+than one line the results are unpredictable.
+
int Fl_Browser::selected(int) constint Fl_Browser::value() const
+
+ Set or get which line is selected. This returns zero if no line is
+selected, so be aware that this can happen in a callback.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Image.html
new file mode 100644
index 0000000..95706c7
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Image.html
@@ -0,0 +1,212 @@
+
+
+
void Fl_Browser::value(int)class Fl_Image
+
+
+
+Class Hierarchy
+
+
+Fl_Image
+ |
+ +----Fl_Bitmap,
+ Fl_Pixmap,
+ Fl_RGB_Image,
+ Fl_Shared_Image,
+ Fl_Tiled_Image
+
+
+Include Files
+
+
+#include <FL/Fl_Image.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_Image(int W, int H, int D);
+
+virtual ~Fl_Image();
+
+virtual void color_average(Fl_Color c, float i);
+
+virtual Fl_Image *copy(int W, int H);
+
+
+copy();int count();
+
+int d();
+
+
+protected void d(int D);const char * const *data();
+
+
+protected void data(const char * const *data, int count);virtual void desaturate()
+
+void draw(int X, int Y);
+
+
+virtual void draw(int X, int Y, int W, int H, int cx, int cy);protected void draw_empty(int X, int Y);
+
+int h();
+
+
+protected void h(int H);void inactive();
+
+virtual void label(Fl_Widget *w);
+virtual void label(Fl_Menu_Item *m);
+
+int ld();
+
+
+protected void ld(int LD);void uncache();
+
+int w();
+
+
+protected void w(int W);class Fl_Input
+
+
+
+Class Hierarchy
+
+
+Fl_Input_
+ |
+ +----Fl_Input
+ |
+ +----Fl_File_Input, Fl_Float_Input,
+ Fl_Int_Input, Fl_Multiline_Input,
+ Fl_Output, Fl_Secret_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Input.H>
+
+
+Description
+
+
+
+
+
+Mouse button 1 Moves the cursor to
+ this point. Drag selects characters. Double click selects words.
+ Triple click selects all text. Shift+click extends the selection.
+ When you select text it is automatically copied to the clipboard.
+
+
+Mouse button 2 Insert the clipboard at
+the point clicked. You can also select a region and replace it with the
+clipboard by selecting the region with mouse button 2.
+
+
+Mouse button 3 Currently acts like button 1.
+Backspace Deletes one character to the left, or
+deletes the selected region.
+Enter May cause the callback, see when().
+^A or Home Go to start of line.
+^B or Left Move left
+^C Copy the selection to the clipboard
+^D or Delete Deletes one character to the right
+or deletes the selected region.
+^E or End Go to the end of line.
+^F or Right Move right
+^K Delete to the end of line (next \n character)
+or deletes a single \n character. These deletions are all concatenated
+into the clipboard.
+^N or Down Move down (for Fl_Multiline_Input
+only, otherwise it moves to the next input field).
+^P or Up Move up (for Fl_Multiline_Input only,
+otherwise it moves to the previous input field).
+^U Delete everything.
+^V or ^Y Paste the clipboard
+^X or ^W Copy the region to the clipboard and
+delete it.
+^Z or ^_ Undo. This is a single-level undo
+mechanism, but all adjacent deletions and insertions are concatenated
+into a single "undo". Often this will undo a lot more than you
+expected.
+
+Shift+move Move the cursor but also extend the
+selection.
+RightCtrl or
+
ComposeStart
+a compose-character
+sequence. The next one or two keys typed define the character to
+insert (see table that follows.)
+
+
+
+ Keys Char
+ Keys Char
+ Keys Char
+ Keys Char
+ Keys Char
+ Keys Char
+
+
+ sp nbsp
+ * °
+ ` A À
+ D - Ð
+ ` a à
+ d - ð
+
+ ! ¡
+ + - ±
+ ' A Á
+ ~ N Ñ
+ ' a á
+ ~ n ñ
+
+ % ¢
+ 2 ²
+ A ^ Â
+ ` O Ò
+ ^ a â
+ ` o ò
+
+ # £
+ 3 ³
+ ~ A Ã
+ ' O Ó
+ ~ a ã
+ ' o ó
+
+ $ ¤
+ ' ´
+ : A Ä
+ ^ O Ô
+ : a ä
+ ^ o ô
+
+ y = ¥
+ u µ
+ * A Å
+ ~ O Õ
+ * a å
+ ~ o õ
+
+ | ¦
+ p ¶
+ A E Æ
+ : O Ö
+ a e æ
+ : o ö
+
+ & §
+ . ·
+ , C Ç
+ x ×
+ , c ç
+ - : ÷
+
+ : ¨
+ , ¸
+ E ` È
+ O / Ø
+ ` e è
+ o / ø
+
+ c ©
+ 1 ¹
+ ' E É
+ ` U Ù
+ ' e é
+ ` u ù
+
+ a ª
+ o º
+ ^ E Ê
+ ' U Ú
+ ^ e ê
+ ' u ú
+
+ < < «
+ > > »
+ : E Ë
+ ^ U Û
+ : e ë
+ ^ u û
+
+ ~ ¬
+ 1 4 ¼
+ ` I Ì
+ : U Ü
+ ` i ì
+ : u ü
+
+ -
+ 1 2 ½
+ ' I Í
+ ' Y Ý
+ ' i í
+ ' y ý
+
+ r ®
+ 3 4 ¾
+ ^ I Î
+ T H Þ
+ ^ i î
+ t h þ
+
+
+_ ¯
+ ? ¿
+ : I Ï
+ s s ß
+ : i ï
+ : y ÿ
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Input::Fl_Input(int x, int y, int w,
+int h, const char *label = 0)
+
+virtual Fl_Input::~Fl_Input()
+
+const char *Fl_Input::value() const
+
+
+
int Fl_Input::value(const char*)
+
int Fl_Input::value(const char*, int)int Fl_Input::static_value(const
+char*)
+
+
+
int Fl_Input::static_value(const char*, int)int Fl_Input::size() const
+
+char Fl_Input::index(int) const
+
+Fl_When Fl_Widget::when() const
+
+
+
void Fl_Widget::when(Fl_When)
+
+
+
+Fl_Color Fl_Input::textcolor() const
+
+
+
void Fl_Input::textcolor(Fl_Color)Fl_Font Fl_Input::textfont() const
+
+
+
void Fl_Input::textfont(Fl_Font)uchar Fl_Input::textsize() const
+
+
+
void Fl_Input::textsize(uchar)Fl_Color Fl_Input::cursor_color()
+const
+
+
+
void Fl_Input::cursor_color(Fl_Color)class Fl_Input_
+
+
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Input_
+ |
+ +----Fl_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Input_.H>
+
+
+Description
+
+
+#define FL_NORMAL_INPUT 0
+#define FL_FLOAT_INPUT 1
+#define FL_INT_INPUT 2
+#define FL_MULTILINE_INPUT 4
+#define FL_SECRET_INPUT 5
+#define FL_INPUT_TYPE 7
+#define FL_INPUT_READONLY 8
+#define FL_NORMAL_OUTPUT (FL_NORMAL_INPUT | FL_INPUT_READONLY)
+#define FL_MULTILINE_OUTPUT (FL_MULTILINE_INPUT | FL_INPUT_READONLY)
+#define FL_INPUT_WRAP 16
+#define FL_MULTILINE_INPUT_WRAP (FL_MULTILINE_INPUT | FL_INPUT_WRAP)
+#define FL_MULTILINE_OUTPUT_WRAP (FL_MULTILINE_INPUT | FL_INPUT_READONLY | FL_INPUT_WRAP)
+
+
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Fl_Input_::Fl_Input_(int x, int y, int
+w, int h, const char *label = 0)
+
+virtual Fl_Input_::~Fl_Input_()
+
+int Fl_Input_::wordboundary(int i)
+const
+
+int Fl_Input_::lineboundary(int i)
+const
+
+void Fl_Input_::drawtext(int,int,int,int)
+
+int Fl_Input_::handletext(int
+e,int,int,int,int)
+
+int
+Fl_Input_::up_down_position(int i, int keepmark=0)
+
+void
+Fl_Input_::maybe_do_callback()
+
+void Fl_Input_::maximum_size(int m)
+
+
+int Fl_Input_::maximum_size() constint Fl_Input_::position() const
+
+
+
int Fl_Input_::position(int new_position, int new_mark)
+
int Fl_Input_::position(int new_position_and_new_mark)int Fl_Input_::mark() const
+
+
+
int Fl_Input_::mark(int new_mark)int Fl_Input_::replace(int a, int b,
+const char *insert, int length=0)
+
+int Fl_Input_::cut()
+
+
+
int Fl_Input_::cut(int n)
+
int Fl_Input_::cut(int a, int b);int Fl_Input_::insert(const char *t,int
+l=0)
+
+int Fl_Input_::copy(int clipboard)
+
+int Fl_Input_::undo()
+
+int Fl_Input_::copy_cuts()
+
+int Fl_Input_::input_type() const
+
+
+
void Fl_Input_::input_type(int)int Fl_Input_::readonly() const
+
+
+
void Fl_Input_::readonly(int)int Fl_Input_::wrap() const
+
+
+
void Fl_Input_::wrap(int)class Fl_Input_Choice
+
+
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Input_Choice
+
+
+Include Files
+
+
+#include <FL/Fl_Input_Choice.H>
+
+
+
+Plastic and normal Fl::scheme()s.
+Description
+Methods
+
+
+
+
Fl_Input_Choice::Fl_Input_Choice(int x, int y, int w,
+int h, const char *label = 0)
+
+virtual Fl_Input_Choice::~Fl_Input_Choice()
+
+void Fl_Input_Choice::add(const char *s)
+
+void Fl_Input_Choice::clear()
+
+Fl_Input *Fl_Input_Choice::input()
+
+void Fl_Input_Choice::menu(const Fl_Menu_Item *m)
+
+
+const Fl_Menu_Item *menu()Fl_Menu_Button *Fl_Input_Choice::menubutton()
+
+void Fl_Input_Choice::value(const char *s)
+
+
+void Fl_Input_Choice::value(int v)
+const char *Fl_Input_Choice::value() constclass Fl_Int_Input
+
+Class Hierarchy
+
+
+Fl_Input
+ |
+ +----Fl_Int_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Int_Input.H>
+
+
+Description
+ The Fl_Int_Input class is a subclass of Fl_Input
+ that only allows the user to type decimal digits (or hex numbers of
+ the form 0xaef).
+Methods
+
+Fl_Int_Input::Fl_Int_Input(int x,
+int y, int w, int h, const char *label = 0)
+ Creates a new Fl_Int_Input widget using the given position,
+size, and label string. The default boxtype is FL_DOWN_BOX.
+virtual
+Fl_Int_Input::~Fl_Int_Input()
+ Destroys the widget and any value associated with it.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_JPEG_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_JPEG_Image.html
new file mode 100644
index 0000000..a5cfd05
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_JPEG_Image.html
@@ -0,0 +1,59 @@
+
+
+ class Fl_JPEG_Image
+
+
+Class Hierarchy
+
+
+Fl_RGB_Image
+ |
+ +----Fl_JPEG_Image
+
+
+Include Files
+
+
+#include <FL/Fl_JPEG_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_JPEG_Image::Fl_JPEG_Image(const char *filename);
+
+Fl_JPEG_Image::~Fl_JPEG_Image();
+
+class Fl_Light_Button
+
+Class Hierarchy
+
+
+Fl_Button
+ |
+ +----Fl_Light_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Light_Button.H>
+
+
+Description
+Buttons generate callbacks when they are clicked by the user. You
+control exactly when and how by changing the values for type()
+and when().
+
Methods
+
+
+Fl_Light_Button::Fl_Light_Button(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Light_Button widget using the given
+position, size, and label string.
+
+Fl_Light_Button::~Fl_Light_Button()
+ The destructor deletes the check button.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_.html
new file mode 100644
index 0000000..ec807a9
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_.html
@@ -0,0 +1,316 @@
+
+
+ class Fl_Menu_
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Menu_----Fl_Menu_Item
+ |
+ +----Fl_Choice, Fl_Menu_Bar, Fl_Menu_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Menu_.H>
+
+
+Description
+All widgets that have a menu in FLTK are subclassed off of this class.
+Currently FLTK provides you with
+Fl_Menu_Button,
+Fl_Menu_Bar, and Fl_Choice
+.
+
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fl_Menu_::Fl_Menu_(int x, int y, int w,
+int h, const char *label = 0)
+
+Creates a new Fl_Menu_ widget using the given position, size,
+and label string. menu() is initialized to null.
+
+
+virtual Fl_Menu_::~Fl_Menu_()
+
+If the menu array is private the memory it uses is freed.
+
+
+int Fl_Menu_::add(const char* label, const
+char* shortcut, Fl_Callback*, void *user_data=0, int flags=0)
+
+
+int Fl_Menu_::add(const char* label, int shortcut, Fl_Callback*,
+void *user_data=0, int flags=0)
+ [#+^]<ascii_value> eg. "97", "^97", "+97", "#97"
+ [#+^]<ascii_char> eg. "a", "^a", "+a", "#a"
+
+..where <ascii_value> is a decimal value representing an
+ascii character (eg. 97 is the ascii for 'a'), and the optional
+prefixes enhance the value that follows. Multiple prefixes must
+appear in the above order.
+
+ # - Alt
+ + - Shift
+ ^ - Control
+
+Text shortcuts are converted to integer shortcut by calling
+int fl_old_shortcut(const char*).
+
+int Fl_Menu_::add(const char *)
+
+void Fl_Menu_::clear()
+Same as menu(NULL), set the array pointer to null, indicating
+a zero-length menu.
+
+void Fl_Menu_::copy(const
+Fl_Menu_Item*, void* user_data = 0)
+
+Fl_Boxtype Fl_Menu_::down_box() const
+
+ This box type is used to surround the currently-selected items in the
+menus. If this is FL_NO_BOX then it acts like
+FL_THIN_UP_BOX and selection_color() acts like
+FL_WHITE, for back compatability.
+
+
+
void Fl_Menu_::down_box(Fl_Boxtype)const Fl_Menu_Item *Fl_Menu_::find_item(const char *name);
+
+int Fl_Menu_::item_pathname(char *name, int namelen ) const;
+
+
+int Fl_Menu_::item_pathname(char *name, int namelen, const Fl_Menu_Item *finditem) const;
+
+
+const Fl_Menu_Item* Fl_Menu_::menu()
+const
+
+Returns a pointer to the array of Fl_Menu_Items. This will either be
+the value passed to menu(value) or the private copy.
+
+void Fl_Menu_::menu(const Fl_Menu_Item*)
+Set the menu array pointer directly. If the old menu is private it is
+deleted. NULL is allowed and acts the same as a zero-length
+menu. If you try to modify the array (with add(), replace(), or
+delete()) a private copy is automatically done.
+
+
+void Fl_Menu_::mode(int i, int x);
+
+Changes the flags of item i. For a list of the flags, see Fl_Menu_Item.
+
+
+const Fl_Menu_Item* Fl_Menu_::mvalue()
+const
+
+void Fl_Menu_::remove(int n)
+
+Deletes item n from the menu. If the menu array was directly
+set with menu(x) then copy() is done to make a private array.
+
+void Fl_Menu_::replace(int n, const char *)
+
+
+Changes the text of item n. This is the only way to get
+slash into an add()'ed menu item. If the menu array was directly set
+with menu(x) then copy() is done to make a private array.
+
+
+void Fl_Menu_::shortcut(int i, int n);
+
+Changes the shortcut of item i to n.
+
+
+int Fl_Menu_::size() const
+
+This returns the number of Fl_Menu_Item structures that make up the
+menu, correctly counting submenus. This includes the "terminator"
+item at the end. To copy a menu array you need to copy
+size()*sizeof(Fl_Menu_Item) bytes. If the menu is
+NULL this returns zero (an empty menu will return 1).
+
+
+const Fl_Menu_Item*
+Fl_Menu_::test_shortcut()
+ Only call this in response to FL_SHORTCUT events. If the
+event matches an entry in the menu that entry is selected and the
+callback will be done (or changed() will be set). This allows
+shortcuts directed at one window to call menus in another.
+void Fl_Menu_::global()
+ Make the shortcuts for this menu work no matter what window has the
+focus when you type it. This is done by using
+Fl::add_handler(). This Fl_Menu_ widget does not
+have to be visible (ie the window it is in can be hidden, or it does
+not have to be put in a window at all).
+const char* Fl_Menu_::text() const
+
+ Returns the title of the last item chosen, or of item i.
+
+
+
const char* Fl_Menu_::text(int i) constFl_Color Fl_Menu_::textcolor() const
+
+ Get or set the current color of menu item labels.
+
+
+
void Fl_Menu_::textcolor(Fl_Color)Fl_Font Fl_Menu_::textfont() const
+
+ Get or set the current font of menu item labels.
+
+
+
void Fl_Menu_::textfont(Fl_Font)uchar Fl_Menu_::textsize() const
+
+ Get or set the font size of menu item labels.
+
+
+
void Fl_Menu_::textsize(uchar)int Fl_Menu_::value() const
+
+ The value is the index into menu() of the last item chosen by
+the user. It is zero initially. You can set it as an integer, or set
+it with a pointer to a menu item. The set routines return non-zero if
+the new value is different than the old one.
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Bar.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Bar.html
new file mode 100644
index 0000000..8e2c8ae
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Bar.html
@@ -0,0 +1,67 @@
+
+
+
int Fl_Menu_::value(int)
+
const Fl_Menu_Item* mvalue() const
+
int Fl_Menu_::value(const Fl_Menu_Item*)class Fl_Menu_Bar
+
+Class Hierarchy
+
+
+Fl_Menu_
+ |
+ +----Fl_Menu_Bar
+
+
+Include Files
+
+
+#include <FL/Fl_Menu_Bar.H>
+
+
+Description
+ This widget provides a standard menubar interface. Usually you will
+put this widget along the top edge of your window. The height of the
+widget should be 30 for the menu titles to draw correctly with the
+default font.
+
Methods
+
+Fl_Menu_Bar::Fl_Menu_Bar(int x, int
+y, int w, int h, const char *label = 0)
+ Creates a new Fl_Menu_Bar widget using the given position,
+size, and label string. The default boxtype is FL_UP_BOX.
+virtual Fl_Menu_Bar::~Fl_Menu_Bar()
+
+ The destructor removes the Fl_Menu_Bar widget and all of its
+menu items.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Button.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Button.html
new file mode 100644
index 0000000..eb585c7
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Button.html
@@ -0,0 +1,83 @@
+
+
+ class Fl_Menu_Button
+
+Class Hierarchy
+
+
+Fl_Menu_
+ |
+ +----Fl_Menu_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Menu_Button.H>
+
+
+Description
+ This is a button that when pushed pops up a menu (or hierarchy of
+menus) defined by an array of
+Fl_Menu_Item objects.
+
Methods
+
+
+Fl_Menu_Button::Fl_Menu_Button(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Menu_Button widget using the given position,
+size, and label string. The default boxtype is FL_UP_BOX.
+virtual
+Fl_Menu_Button::~Fl_Menu_Button()
+ The destructor removes the Fl_Menu_Button widget and all of
+its menu items.
+const Fl_Menu* Fl_Menu_Button::popup()
+
+ Act exactly as though the user clicked the button or typed the
+shortcut key. The menu appears, it waits for the user to pick an item,
+and if they pick one it sets value() and does the callback or
+sets changed() as described above. The menu item is returned
+or NULL if the user dismisses the menu.
+void Fl_Menu_Button::type(uchar)
+ If type() is zero a normal menu button is produced. If it is
+nonzero then this is a pop-up menu. The bits in type()
+ indicate what mouse buttons pop up the menu. For convienece the
+constants Fl_Menu_Button::POPUP1, POPUP2, POPUP3, POPUP12, POPUP13,
+POPUP23, and POPUP123 are defined.
+Fl_Menu_Button::POPUP3 is usually what you want.
+struct Fl_Menu_Item
+
+Class Hierarchy
+
+
+struct Fl_Menu_Item
+
+
+Include Files
+
+
+#include <FL/Fl_Menu_Item.H>
+
+
+Description
+
+The Fl_Menu_Item structure defines a single menu item that
+is used by the Fl_Menu_ class. This
+structure is defined in <FL/Fl_Menu_Item.H>
+
+
+
+struct Fl_Menu_Item {
+ const char* text; // label()
+ ulong shortcut_;
+ Fl_Callback* callback_;
+ void* user_data_;
+ int flags;
+ uchar labeltype_;
+ uchar labelfont_;
+ uchar labelsize_;
+ uchar labelcolor_;
+};
+
+enum { // values for flags:
+ FL_MENU_INACTIVE = 1,
+ FL_MENU_TOGGLE = 2,
+ FL_MENU_VALUE = 4,
+ FL_MENU_RADIO = 8,
+ FL_MENU_INVISIBLE = 0x10,
+ FL_SUBMENU_POINTER = 0x20,
+ FL_SUBMENU = 0x40,
+ FL_MENU_DIVIDER = 0x80,
+ FL_MENU_HORIZONTAL = 0x100
+};
+
+
+Typically menu items are statically defined; for example:
+
+Fl_Menu_Item popup[] = {
+ {"&alpha", FL_ALT+'a', the_cb, (void*)1},
+ {"&beta", FL_ALT+'b', the_cb, (void*)2},
+ {"gamma", FL_ALT+'c', the_cb, (void*)3, FL_MENU_DIVIDER},
+ {"&strange", 0, strange_cb},
+ {"&charm", 0, charm_cb},
+ {"&truth", 0, truth_cb},
+ {"b&eauty", 0, beauty_cb},
+ {"sub&menu", 0, 0, 0, FL_SUBMENU},
+ {"one"},
+ {"two"},
+ {"three"},
+ {0},
+ {"inactive", FL_ALT+'i', 0, 0, FL_MENU_INACTIVE|FL_MENU_DIVIDER},
+ {"invisible",FL_ALT+'i', 0, 0, FL_MENU_INVISIBLE},
+ {"check", FL_ALT+'i', 0, 0, FL_MENU_TOGGLE|FL_MENU_VALUE},
+ {"box", FL_ALT+'i', 0, 0, FL_MENU_TOGGLE},
+{0}};
+
+produces:
+
Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+const char* Fl_Menu_Item::label() const
+
+ This is the title of the item. A NULL here indicates the end
+of the menu (or of a submenu). A '&' in the item will print an
+underscore under the next letter, and if the menu is popped up that
+letter will be a "shortcut" to pick that item. To get a
+real '&' put two
+in a row.
+
void Fl_Menu_Item::label(const char*)
+
void Fl_Menu_Item::label(Fl_Labeltype, const char*)Fl_Labeltype
+Fl_Menu_Item::labeltype() const
+
+ A labeltype identifies a routine that draws the label of the
+widget. This can be used for special effects such as emboss, or to use
+the label() pointer as another form of data such as a bitmap.
+ The value FL_NORMAL_LABEL prints the label as text.
+
void Fl_Menu_Item::labeltype(Fl_Labeltype)Fl_Color Fl_Menu_Item::labelcolor()
+const
+
+ This color is passed to the labeltype routine, and is typically the
+color of the label text. This defaults to FL_BLACK. If this
+color is not black fltk will not use overlay bitplanes to draw
+the menu - this is so that images put in the menu draw correctly.
+
void Fl_Menu_Item::labelcolor(Fl_Color)Fl_Font Fl_Menu_Item::labelfont()
+const
+
+ Fonts are identified by small 8-bit indexes into a table. See the
+enumeration list for predefined fonts. The default value is a
+Helvetica font. The function
+Fl::set_font() can define new fonts.
+
void Fl_Menu_Item::labelfont(Fl_Font)uchar Fl_Menu_Item::labelsize() const
+
+ Gets or sets the label font pixel size/height.
+
void Fl_Menu_Item::labelsize(uchar)typedef void
+(Fl_Callback)(Fl_Widget*, void*)
+
+ Each item has space for a callback function and an argument for that
+function. Due to back compatability, the Fl_Menu_Item itself
+is not passed to the callback, instead you have to get it by calling
+((Fl_Menu_*)w)->mvalue() where w is the widget argument.
+
Fl_Callback* Fl_Menu_Item::callback() const
+
void Fl_Menu_Item::callback(Fl_Callback*, void* = 0)
+
void Fl_Menu_Item::callback(void (*)(Fl_Widget*))void* Fl_Menu_Item::user_data() const
+
+ Get or set the user_data argument that is sent to the
+callback function.
+
void Fl_Menu_Item::user_data(void*)void Fl_Menu_Item::callback(void
+(*)(Fl_Widget*, long), long = 0)
+
+ For convenience you can also define the callback as taking a long
+ argument. This is implemented by casting this to a Fl_Callback
+ and casting the long to a void* and may not be
+portable to some machines.
+
long Fl_Menu_Item::argument() const
+
void Fl_Menu_Item::argument(long)void
+Fl_Menu_Item::do_callback(Fl_Widget*)
+
+ Call the Fl_Menu_Item item's callback, and provide the
+Fl_Widget argument (and optionally override the user_data()
+argument). You must first check that callback() is non-zero
+before calling this.
+
void Fl_Menu_Item::do_callback(Fl_Widget*, void*)
+
void Fl_Menu_Item::do_callback(Fl_Widget*, long)ulong Fl_Menu_Item::shortcut() const
+
+ Sets exactly what key combination will trigger the menu item. The
+value is a logical 'or' of a key and a set of shift flags, for instance
+FL_ALT+'a' or FL_ALT+FL_F+10 or just 'a'. A value of
+zero disables the shortcut.
+
void Fl_Menu_Item::shortcut(ulong)int Fl_Menu_Item::submenu() const
+ Returns true if either FL_SUBMENU or FL_SUBMENU_POINTER
+ is on in the flags. FL_SUBMENU indicates an embedded submenu
+that goes from the next item through the next one with a NULL
+label(). FL_SUBMENU_POINTER indicates that user_data()
+ is a pointer to another menu array.
+int Fl_Menu_Item::checkbox() const
+ Returns true if a checkbox will be drawn next to this item. This is
+true if FL_MENU_TOGGLE or FL_MENU_RADIO is set in the
+flags.
+int Fl_Menu_Item::radio() const
+ Returns true if this item is a radio item. When a radio button is
+selected all "adjacent" radio buttons are turned off. A set of radio
+items is delimited by an item that has radio() false, or by an
+item with FL_MENU_DIVIDER turned on.
+int Fl_Menu_Item::value() const
+ Returns the current value of the check or radio item.
+void Fl_Menu_Item::set()
+ Turns the check or radio item "on" for the menu item. Note that this
+does not turn off any adjacent radio items like set_only()
+ does.
+void Fl_Menu_Item::setonly()
+ Turns the radio item "on" for the menu item and turns off adjacent
+radio item.
+void Fl_Menu_Item::clear()
+ Turns the check or radio item "off" for the menu item.
+int Fl_Menu_Item::visible() const
+ Gets the visibility of an item.
+void Fl_Menu_Item::show()
+ Makes an item visible in the menu.
+void Fl_Menu_Item::hide()
+ Hides an item in the menu.
+int Fl_Menu_Item::active() const
+ Get whether or not the item can be picked.
+void Fl_Menu_Item::activate()
+ Allows a menu item to be picked.
+void Fl_Menu_Item::deactivate()
+ Prevents a menu item from being picked. Note that this will also cause
+the menu item to appear grayed-out.
+const Fl_Menu_Item
+*Fl_Menu_Item::popup(int X, int Y, const char* title = 0, const
+Fl_Menu_Item* picked = 0, const Fl_Menu_* button = 0) const
+ This method is called by widgets that want to display menus. The menu
+stays up until the user picks an item or dismisses it. The selected
+item (or NULL if none) is returned. This does not do the
+callbacks or change the state of check or radio items.
+const Fl_Menu_Item
+*Fl_Menu_Item::pulldown(int X, int Y, int W, int H, const Fl_Menu_Item*
+picked = 0, const Fl_Menu_* button = 0, const Fl_Menu_Item* title = 0,
+int menubar=0) const
+pulldown() is similar to popup(), but a rectangle is
+provided to position the menu. The menu is made at least W
+ wide, and the picked item is centered over the rectangle
+(like Fl_Choice uses). If picked is zero or not
+found, the menu is aligned just below the rectangle (like a pulldown
+menu).
+const Fl_Menu_Item*
+Fl_Menu_Item::test_shortcut() const
+ This is designed to be called by a widgets handle() method in
+response to a FL_SHORTCUT event. If the current event matches
+one of the items shortcut, that item is returned. If the keystroke
+does not match any shortcuts then NULL is returned. This only
+matches the shortcut() fields, not the letters in the title
+preceeded by '
+int Fl_Menu_Item::size()
+ Returns the number of Fl_Menu_Item structures that make up this menu,
+correctly counting submenus. This includes the "terminator" item at
+the end. So to copy a menu you need to copy
+size()*sizeof(Fl_Menu_Item) bytes.
+const Fl_Menu_Item*
+Fl_Menu_Item::next(int n=1) const
+
+ Advance a pointer by n items through a menu array, skipping
+the contents of submenus and invisible items. There are two calls so
+that you can advance through const and non-const data.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Window.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Window.html
new file mode 100644
index 0000000..57f0e41
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Menu_Window.html
@@ -0,0 +1,49 @@
+
+
+
Fl_Menu_Item* Fl_Menu_Item::next(int n=1);class Fl_Menu_Window
+
+Class Hierarchy
+
+
+Fl_Single_Window
+ |
+ +----Fl_Menu_Window
+
+
+Include Files
+
+
+#include <FL/Fl_Menu_Window.H>
+
+
+Description
+ The Fl_Menu_Window widget is a window type used for menus. By
+default the window is drawn in the hardware overlay planes if they are
+available so that the menu don't force the rest of the window to
+redraw.
+Methods
+
+
+Fl_Menu_Window::Fl_Menu_Window(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Menu_Window widget using the given position,
+size, and label string.
+virtual
+Fl_Menu_Window::~Fl_Menu_Window()
+ Destroys the window and all of its children.
+
+Fl_Menu_Window::clear_overlay();
+ Tells FLTK to use normal drawing planes instead of overlay planes.
+This is usually necessary if your menu contains multi-color pixmaps.
+Fl_Menu_Window::set_overlay()
+ Tells FLTK to use hardware overlay planes if they are available.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Multi_Browser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Multi_Browser.html
new file mode 100644
index 0000000..3c3f0b6
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Multi_Browser.html
@@ -0,0 +1,79 @@
+
+
+ class Fl_Multi_Browser
+
+Class Hierarchy
+
+
+Fl_Browser
+ |
+ +----Fl_Multi_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_Multi_Browser.H>
+
+
+Description
+ The Fl_Multi_Browser class is a subclass of Fl_Browser
+ which lets the user select any set of the lines. The user interface
+is Macintosh style: clicking an item turns off all the others and
+selects that one, dragging selects all the items the mouse moves over,
+and shift + click toggles the items. This is different then how forms
+did it. Normally the callback is done when the user releases the
+mouse, but you can change this with when().
+Methods
+
+
+
+Fl_Multi_Browser::Fl_Multi_Browser(int x, int y, int w, int h, const
+char *label = 0)
+
+Creates a new Fl_Multi_Browser widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+
+
+virtual
+Fl_Multi_Browser::~Fl_Multi_Browser()
+
+The destructor also deletes all the items in the list.
+
+
+int Fl_Browser::deselect()
+
+Deselects all lines.
+
+
+int Fl_Browser::select(int line_no,int v=1)
+
+
+The first version of this call selects (v=1) or deselects (v=0)
+a line in the browser. The second call returns the current selection
+state of a line.
+
+
+
int Fl_Browser::selected(int line_no) constvoid Fl_Browser::value(int)
+
+
+The first version of this call selects a single line. The second version returns
+the currently focused item, even if it is not selected. To find all
+selected items, call
+
+Fl_Multi_Browser::selected() for every item in question.
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Multiline_Input.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Multiline_Input.html
new file mode 100644
index 0000000..463577b
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Multiline_Input.html
@@ -0,0 +1,47 @@
+
+
+
int Fl_Browser::value() constclass Fl_Multiline_Input
+
+Class Hierarchy
+
+
+Fl_Input
+ |
+ +----Fl_Multiline_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Multiline_Input.H>
+
+
+Description
+ This input field displays '\n' characters as new lines rather than ^J,
+and accepts the Return, Tab, and up and down arrow keys. This is for
+editing multiline text.
+Methods
+
+
+Fl_Multiline_Input::Fl_Multiline_Input(int x, int y, int w, int h,
+const char *label = 0)
+ Creates a new Fl_Multiline_Input widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+virtual
+Fl_Multiline_Input::~Fl_Multiline_Input()
+ Destroys the widget and any value associated with it.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Multiline_Output.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Multiline_Output.html
new file mode 100644
index 0000000..58dc940
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Multiline_Output.html
@@ -0,0 +1,42 @@
+
+
+ class Fl_Multiline_Output
+
+Class Hierarchy
+
+
+Fl_Output
+ |
+ +----Fl_Multiline_Output
+
+
+Include Files
+
+
+#include <FL/Fl_Multiline_Output.H>
+
+
+Description
+ This widget is a subclass of Fl_Output that displays multiple
+lines of text. It also displays tab characters as whitespace to the
+next column.
+Methods
+
+
+Fl_Multiline_Output::Fl_Multiline_Output(int x, int y, int w, int h,
+const char *label = 0)
+ Creates a new Fl_Multiline_Output widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+virtual
+Fl_Multiline_Output::~Fl_Multiline_Output()
+ Destroys the widget and any value associated with it.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Output.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Output.html
new file mode 100644
index 0000000..1ddc84b
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Output.html
@@ -0,0 +1,83 @@
+
+
+ class Fl_Output
+
+Class Hierarchy
+
+
+Fl_Input
+ |
+ +----Fl_Output
+ |
+ +----Fl_Multiline_Output
+
+
+Include Files
+
+
+#include <FL/Fl_Output.H>
+
+
+Description
+ This widget displays a piece of text. When you set the value()
+, Fl_Output does a strcpy() to it's own storage,
+which is useful for program-generated values. The user may select
+portions of the text using the mouse and paste the contents into other
+fields or programs.
+
Methods
+
+Fl_Output::Fl_Output(int x, int y, int
+w, int h, const char *label = 0)
+ Creates a new Fl_Output widget using the given position,
+size, and label string. The default boxtype is FL_DOWN_BOX.
+virtual Fl_Output::~Fl_Output()
+ Destroys the widget and any value associated with it.
+const char *Fl_Output::value() const
+
+ The first form returns the current value, which is a pointer to the
+internal buffer and is valid only until the value is changed.
+
int Fl_Output::value(const char*)
+
int Fl_Output::value(const char*, int)int Fl_Output::size() const
+ Returns the number of characters in value(). This may be
+greater than strlen(value()) if there are nul characters in
+it.
+char Fl_Output::index(int) const
+ Same as value()[n], but may be faster in plausible
+implementations. No bounds checking is done.
+Fl_Color Fl_Output::textcolor() const
+
+ Gets or sets the color of the text in the input field.
+
void Fl_Output::textcolor(Fl_Color)Fl_Font Fl_Output::textfont() const
+
+ Gets or sets the font of the text in the input field.
+
void Fl_Output::textfont(Fl_Font)uchar Fl_Output::textsize() const
+
+ Gets or sets the size of the text in the input field.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Overlay_Window.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Overlay_Window.html
new file mode 100644
index 0000000..cd3b486
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Overlay_Window.html
@@ -0,0 +1,59 @@
+
+
+
void Fl_Output::textsize(uchar)class Fl_Overlay_Window
+
+Class Hierarchy
+
+
+Fl_Double_Window
+ |
+ +----Fl_Overlay_Window
+
+
+Include Files
+
+
+#include <FL/Fl_Overlay_Window.H>
+
+
+Description
+ This window provides double buffering and also the ability to draw the
+"overlay" which is another picture placed on top of the main image. The
+overlay is designed to be a rapidly-changing but simple graphic such as
+a mouse selection box. Fl_Overlay_Window uses the overlay
+planes provided by your graphics hardware if they are available.
+Methods
+
+
+Fl_Overlay_Window::Fl_Overlay_Window(int x, int y, int w, int h, const
+char *label = 0)
+ Creates a new Fl_Overlay_Window widget using the given
+position, size, and label (title) string.
+virtual
+Fl_Overlay_Window::~Fl_Overlay_Window()
+ Destroys the window and all child widgets.
+virtual void
+Fl_Overlay_Window::draw_overlay() = 0
+ You must subclass Fl_Overlay_Window and provide this method.
+ It is just like a draw() method, except it draws the overlay.
+ The overlay will have already been "cleared" when this is called. You
+can use any of the routines described in <FL/fl_draw.H>.
+void Fl_Overlay_Window::redraw_overlay()
+
+ Call this to indicate that the overlay data has changed and needs to
+be redrawn. The overlay will be clear until the first time this is
+called, so if you want an initial display you must call this after
+calling show().
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_PNG_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_PNG_Image.html
new file mode 100644
index 0000000..0fd6200
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_PNG_Image.html
@@ -0,0 +1,59 @@
+
+
+ class Fl_PNG_Image
+
+
+Class Hierarchy
+
+
+Fl_RGB_Image
+ |
+ +----Fl_PNG_Image
+
+
+Include Files
+
+
+#include <FL/Fl_PNG_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_PNG_Image::Fl_PNG_Image(const char *filename);
+
+Fl_PNG_Image::~Fl_PNG_Image();
+
+class Fl_PNM_Image
+
+
+Class Hierarchy
+
+
+Fl_RGB_Image
+ |
+ +----Fl_PNM_Image
+
+
+Include Files
+
+
+#include <FL/Fl_PNM_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_PNM_Image::Fl_PNM_Image(const char *filename);
+
+Fl_PNM_Image::~Fl_PNM_Image();
+
+class Fl_Pack
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Pack
+
+
+Include Files
+
+
+#include <FL/Fl_Pack.H>
+
+
+Description
+ This widget was designed to add the functionality of compressing and
+aligning widgets.
+Methods
+
+Fl_Pack::Fl_Pack(int x, int y, int w, int
+h, const char *label = 0)
+ Creates a new Fl_Pack widget using the given position, size,
+and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Pack::~Fl_Pack()
+ The destructor also deletes all the children. This allows a
+whole tree to be deleted at once, without having to keep a pointer to
+all the children in the user code. A kludge has been done so the
+Fl_Pack and all of it's children can be automatic (local)
+variables, but you must declare the Fl_Packfirst, so
+that it is destroyed last.
+
+Fl_Boxtype Fl_Pack::box() const
+
+
+
void Fl_Pack::box(Fl_Boxtype)void Fl_Pack::resizable(Fl_Widget *box)
+
+
void Fl_Pack::resizable(Fl_Widget &box)
+
Fl_Widget *Fl_Pack::resizable() constint Fl_Pack::spacing() const
+
+ Gets or sets the number of extra pixels of blank space that are added
+between the children.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Pixmap.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Pixmap.html
new file mode 100644
index 0000000..8c2af04
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Pixmap.html
@@ -0,0 +1,57 @@
+
+
+
void Fl_Pack::spacing(int)class Fl_Pixmap
+
+
+Class Hierarchy
+
+
+Fl_Image
+ |
+ +----Fl_Pixmap
+ |
+ +----Fl_GIF_Image,
+ Fl_XPM_Image
+
+
+Include Files
+
+
+#include <FL/Fl_Pixmap.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_Pixmap::Fl_Pixmap(const char * const *data);
+
+
+Fl_Pixmap::Fl_Pixmap(const char **data);
+Fl_Pixmap::Fl_Pixmap(const unsigned char * const *data);
+Fl_Pixmap::Fl_Pixmap(const unsigned char **data);Fl_Pixmap::~Fl_Pixmap();
+
+class Fl_Positioner
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Positioner
+
+
+Include Files
+
+
+#include <FL/Fl_Positioner.H>
+
+
+Description
+ This class is provided for Forms compatibility. It provides 2D input.
+It would be useful if this could be put atop another widget so that the
+crosshairs are on top, but this is not implemented. The color of the
+crosshairs is selection_color().
+
Methods
+
+
+
+
+
+
+
+Fl_Positioner::Fl_Positioner(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Positioner widget using the given position,
+size, and label string. The default boxtype is FL_NO_BOX.
+virtual
+Fl_Positioner::~Fl_Positioner()
+ Deletes the widget.
+void Fl_Positioner::value(float *x,
+float *y) const
+ Returns the current position in x and y.
+void xbounds(float *xmin, float *xmax)
+
+ Gets or sets the X axis bounds.
+
void xbounds(float xmin, float xmax)void xstep(float x)
+ Sets the stepping value for the X axis.
+float Fl_Positioner::xvalue(void) const
+
+ Gets or sets the X axis coordinate.
+
void Fl_Positioner::xvalue(float x)void ybounds(float *ymin, float *ymay)
+
+ Gets or sets the Y axis bounds.
+
void ybounds(float ymin, float ymay)void ystep(float y)
+ Sets the stepping value for the Y axis.
+float Fl_Positioner::yvalue(void) const
+
+ Gets or sets the Y axis coordinate.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Preferences.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Preferences.html
new file mode 100644
index 0000000..c1a7e31
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Preferences.html
@@ -0,0 +1,216 @@
+
+
+
void Fl_Positioner::yvalue(float y)class Fl_Preferences
+
+
+
+Class Hierarchy
+
+
+Fl_Preferences
+
+
+Include Files
+
+
+#include <FL/Fl_Preferences.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+
+Fl_Preferences(enum Root root, const char *vendor, const char *application)
+
+
+Fl_Preferences(const char *path, const char *vendor, const char *application)
+Fl_Preferences(Fl_Preferences &p, const char *groupname)
+~Fl_Preferences()
+
+int Fl_Preferences::deleteEntry(const char *entry)
+
+int Fl_Preferences::deleteGroup(const char *groupname)
+
+int Fl_Preferences::entries()
+
+const char *Fl_Preferences::entry(int ix)
+
+int Fl_Preferences::entryExists(const char *entry)
+
+void Fl_Preferences::flush()
+
+int Fl_Preferences::getUserdataPath(char *path, int path_size)
+
+int get(const char *entry, int &value, int defaultValue)
+
+
+int get(const char *entry, int &value, int defaultValue)
+int get(const char *entry, float &value, float defaultValue)
+int get(const char *entry, double &value, double defaultValue )
+int get(const char *entry, char *&text, const char *defaultValue)
+int get(const char *entry, char *text, const char *defaultValue, int maxLength)
+int get(const char *entry, void *&data, const void *defaultValue, int defaultSize)
+int get(const char *entry, void *data, const void *defaultValue, int defaultSize,
+int maxSize)const char
+*Fl_Preferences::group(int ix)
+
+int Fl_Preferences::groupExists(const char *groupname)
+
+int Fl_Preferences::groups()
+
+int set(const char *entry, int value)
+
+
+int set(const char *entry, int value)
+int set(const char *entry, float value)
+int set(const char *entry, float value, int precision)
+int set(const char *entry, double value)
+int set(const char *entry, double value, int precision)
+int set(const char *entry, const char *text)
+int set(const char *entry, const void *data, int size)int Fl_Preferences::size(const char *key)
+
+
+Fl_Preferences::Name( unsigned int numericName )
+
+
+Fl_Preferences::Name( const char *format, ... )
+class Fl_Progress
+
+
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Progress
+
+
+Include Files
+
+
+#include <FL/Fl_Progress.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_Progress::Fl_Progress(int x, int y, int w, int h, const char *label = 0)
+
+Fl_Progress::~Fl_Progress(void)
+
+void maximum(float v);
+
+
+
float maximum() const;void minimum(float v);
+
+
+
float minimum() const;void value(float v);
+
+
+
float value() const;class Fl_RGB_Image
+
+
+Class Hierarchy
+
+
+Fl_Image
+ |
+ +----Fl_RGB_Image
+ |
+ +----Fl_JPEG_Image,
+ Fl_PNG_Image,
+ Fl_PNM_Image,
+ Fl_BMP_Image
+
+
+
+Include Files
+
+
+#include <FL/Fl_RGB_Image.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_RGB_Image::Fl_RGB_Image(const unsigned char *array, int W, int H, int D = 3, int LD = 0);
+
+Fl_RGB_Image::~Fl_RGB_Image();
+
+class Fl_Repeat_Button
+
+Class Hierarchy
+
+
Fl_Button
+ |
+ +----Fl_Repeat_Button
+
+
+Include Files
+
+
#include <FL/Fl_Repeat_Button.H>
+
+Description
+ The Fl_Repeat_Button is a subclass of Fl_Button that
+generates a callback when it is pressed and then repeatedly generates
+callbacks as long as it is held down. The speed of the repeat is fixed
+and depends on the implementation.
+Methods
+
+
+Fl_Repeat_Button::Fl_Repeat_Button(int x, int y, int w, int h, const
+char *label = 0)
+ Creates a new Fl_Repeat_Button widget using the given
+position, size, and label string. The default boxtype is FL_UP_BOX
+.
+virtual
+Fl_Repeat_Button::~Fl_Repeat_Button()
+ Deletes the button.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Return_Button.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Return_Button.gif
new file mode 100644
index 0000000..349163c
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Return_Button.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Return_Button.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Return_Button.html
new file mode 100644
index 0000000..e1e68ee
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Return_Button.html
@@ -0,0 +1,38 @@
+
+
+ class Fl_Return_Button
+
+Class Hierarchy
+
+
Fl_Button
+ |
+ +----Fl_Return_Button
+
+
+Include Files
+
+
#include <FL/Fl_Return_Button.H>
+
+Description
+The Fl_Return_Button is a subclass of Fl_Button that
+generates a callback when it is pressed or when the user presses the
+Enter key. A carriage-return symbol is drawn next to the button label.
+
Methods
+
+
+Fl_Return_Button::Fl_Return_Button(int x, int y, int w, int h, const
+char *label = 0)
+ Creates a new Fl_Return_Button widget using the given
+position, size, and label string. The default boxtype is FL_UP_BOX
+.
+virtual
+Fl_Return_Button::~Fl_Return_Button()
+ Deletes the button.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Roller.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Roller.gif
new file mode 100644
index 0000000..48cd5b1
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Roller.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Roller.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Roller.html
new file mode 100644
index 0000000..9738395
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Roller.html
@@ -0,0 +1,37 @@
+
+
+ class Fl_Roller
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Roller
+
+
+Include Files
+
+
+#include <FL/Fl_Roller.H>
+
+
+Description
+ The Fl_Roller widget is a "dolly" control commonly used to
+move 3D objects.
+
Methods
+
+
+Fl_Roller::Fl_Roller(int x, int y, int
+w, int h, const char *label = 0)
+ Creates a new Fl_Roller widget using the given position,
+size, and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Roller::~Fl_Roller()
+ Destroys the valuator.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Round_Button.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Round_Button.gif
new file mode 100644
index 0000000..3acb888
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Round_Button.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Round_Button.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Round_Button.html
new file mode 100644
index 0000000..a2397aa
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Round_Button.html
@@ -0,0 +1,45 @@
+
+
+ class Fl_Round_Button
+
+Class Hierarchy
+
+
+Fl_Button
+ |
+ +----Fl_Round_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Round_Button.H>
+
+
+Description
+Buttons generate callbacks when they are clicked by the user. You
+control exactly when and how by changing the values for type()
+and when().
+
Methods
+
+
+Fl_Round_Button::Fl_Round_Button(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Round_Button widget using the given
+position, size, and label string.
+
+Fl_Round_Button::~Fl_Round_Button()
+ The destructor deletes the check button.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Scroll.gif b/third_party/windows/fltk-1.1.10/documentation/Fl_Scroll.gif
new file mode 100644
index 0000000..3055429
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/Fl_Scroll.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Scroll.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Scroll.html
new file mode 100644
index 0000000..d8810c8
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Scroll.html
@@ -0,0 +1,117 @@
+
+
+ class Fl_Scroll
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Scroll
+
+
+Include Files
+
+
+#include <FL/Fl_Scroll.H>
+
+
+Description
+ This container widget lets you maneuver around a set of widgets much
+larger than your window. If the child widgets are larger than the size
+of this object then scrollbars will appear so that you can scroll over
+to them:
+
Methods
+
+Fl_Scroll::Fl_Scroll(int x, int y, int
+w, int h, const char *label = 0)
+ Creates a new Fl_Scroll widget using the given position,
+size, and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Scroll::~Fl_Scroll()
+ The destructor also deletes all the children. This allows a
+whole tree to be deleted at once, without having to keep a pointer to
+all the children in the user code. A kludge has been done so the
+Fl_Scroll and all of it's children can be automatic (local)
+variables, but you must declare the Fl_Scrollfirst, so
+that it is destroyed last.
+void Fl_Widget::type(int)
+ By default you can scroll in both directions, and the scrollbars
+disappear if the data will fit in the area of the scroll. type()
+ can change this:
+
+
+
+void Fl_Scroll::scrollbar.align(int)
+ This is used to change what side the scrollbars are drawn on. If the
+FL_ALIGN_LEFT bit is on, the vertical scrollbar is on the left.
+ If the FL_ALIGN_TOP bit is on, the horizontal scrollbar is on
+the top. Note that only the alignment flags in scrollbar are
+considered. The flags in hscrollbar however are ignored.
+
+Fl_Scroll::bbox(int &x, int &y, int &w, int &h)
+
+int Fl_Scroll::xposition() const
+ Gets the current horizontal scrolling position.
+
+int Fl_Scroll::yposition() const
+ Gets the current vertical scrolling position.
+
+void Fl_Scroll::position(int w, int h)
+
+ Sets the upper-lefthand corner of the scrolling region.
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Scrollbar.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Scrollbar.html
new file mode 100644
index 0000000..b16a4a6
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Scrollbar.html
@@ -0,0 +1,64 @@
+
+
+ class Fl_Scrollbar
+
+Class Hierarchy
+
+
+Fl_Slider
+ |
+ +----Fl_Scrollbar
+
+
+Include Files
+
+
+#include <FL/Fl_Scrollbar.H>
+
+
+Description
+ The Fl_Scrollbar widget displays a slider with arrow buttons
+at the ends of the scrollbar. Clicking on the arrows move up/left and
+down/right by linesize(). Scrollbars also accept
+FL_SHORTCUT events: the arrows move by linesize(), and
+vertical scrollbars take Page Up/Down (they move by the page size minus
+linesize()) and Home/End (they jump to the top or bottom).
+
Methods
+
+Fl_Scrollbar::Fl_Scrollbar(int x,
+int y, int w, int h, const char *label = 0)
+ Creates a new Fl_Scrollbar widget using the given position,
+size, and label string. You need to do type(FL_HORIZONTAL) if
+you want a horizontal scrollbar.
+virtual
+Fl_Scrollbar::~Fl_Scrollbar()
+ Destroys the valuator.
+int Fl_Scrollbar::linesize() const
+
+ This number controls how big the steps are that the arrow keys do. In
+addition page up/down move by the size last sent to value()
+ minus one linesize(). The default is 16.
+
void Fl_Scrollbar::linesize(int i)int Fl_Scrollbar::value()
+
+ The first form returns the integer value of the scrollbar. You can get
+the floating point value with Fl_Slider::value(). The second
+form sets value(), range(), and slider_size()
+ to make a variable-sized scrollbar. You should call this every time
+your window changes size, your data changes size, or your scroll
+position changes (even if in response to a callback from this
+scrollbar). All necessary calls to redraw() are done.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Secret_Input.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Secret_Input.html
new file mode 100644
index 0000000..2269a54
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Secret_Input.html
@@ -0,0 +1,40 @@
+
+
+
int Fl_Scrollbar::value(int position, int size, int top, int total)
+class Fl_Secret_Input
+
+Class Hierarchy
+
+
+Fl_Input
+ |
+ +----Fl_Secret_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Secret_Input.H>
+
+
+Description
+ The Fl_Secret_Input class is a subclass of Fl_Input
+ that displays its input as a string of asterisks. This subclass is
+usually used to receive passwords and other "secret" information.
+Methods
+
+
+Fl_Secret_Input::Fl_Secret_Input(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Secret_Input widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+virtual
+Fl_Secret_Input::~Fl_Secret_Input()
+ Destroys the widget and any value associated with it.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Select_Browser.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Select_Browser.html
new file mode 100644
index 0000000..134bb2f
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Select_Browser.html
@@ -0,0 +1,57 @@
+
+
+ class Fl_Select_Browser
+
+Class Hierarchy
+
+
+Fl_Browser
+ |
+ +----Fl_Select_Browser
+
+
+Include Files
+
+
+#include <FL/Fl_Select_Browser.H>
+
+
+Description
+The Fl_Select_Browser class is a subclass of Fl_Browser
+which lets the user select a single item, or no items by clicking on
+the empty space. As long as the mouse button is held down on an
+unselected item it is highlighted. Normally the callback is done when the
+user presses the mouse, but you can change this with when().
+Methods
+
+
+Fl_Select_Browser::Fl_Select_Browser(int x, int y, int w, int h, const
+char *label = 0)
+ Creates a new Fl_Select_Browser widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+virtual
+Fl_Select_Browser::~Fl_Select_Browser()
+ The destructor also deletes all the items in the list.
+int Fl_Browser::deselect()
+int Fl_Browser::select(int,int=1)
+
+ You can use these for compatibility with
+Fl_Multi_Browser. If you turn on the selection of more
+than one line the results are unpredictable.
+
int Fl_Browser::selected(int) constint Fl_Browser::value() const
+ Returns the number of the highlighted item, or zero if none. Notice
+that this is going to be zero except during a callback!
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Shared_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Shared_Image.html
new file mode 100644
index 0000000..2f45b77
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Shared_Image.html
@@ -0,0 +1,96 @@
+
+
+ class Fl_Shared_Image
+
+
+Class Hierarchy
+
+
+Fl_Image
+ |
+ +----Fl_Shared_Image
+
+
+Include Files
+
+
+#include <FL/Fl_Shared_Image.H>
+
+
+Description
+
+fltk_images library and call the
+fl_register_images()
+function to support standard image formats such as BMP, GIF, JPEG, and PNG.Methods
+
+
+
+
+
+protected Fl_Shared_Image::Fl_Shared_Image();
+
+
+protected Fl_Shared_Image::Fl_Shared_Image(const char *name, Fl_Image *img);protected Fl_Shared_Image::~Fl_Shared_Image();
+
+static Fl_Shared_Image *find(const char *n, int W = 0, int H = 0);
+
+static Fl_Shared_Image *get(const char *n, int W = 0, int H = 0);
+
+static Fl_Shared_Image **images();
+
+const char *name();
+
+static int num_images();
+
+int refcount();
+
+void release();
+
+void reload();
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Single_Window.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Single_Window.html
new file mode 100644
index 0000000..b54cc3b
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Single_Window.html
@@ -0,0 +1,42 @@
+
+
+ class Fl_Single_Window
+
+Class Hierarchy
+
+
+Fl_Window
+ |
+ +----Fl_Single_Window
+
+
+Include Files
+
+
+#include <FL/Fl_Single_Window.H>
+
+
+Description
+ This is the same as Fl_Window. However, it is possible that
+some implementations will provide double-buffered windows by default.
+This subclass can be used to force single-buffering. This may be
+useful for modifying existing programs that use incremental update, or
+for some types of image data, such as a movie flipbook.
+Methods
+
+
+Fl_Single_Window::Fl_Single_Window(int x, int y, int w, int h, const
+char *label = 0)
+ Creates a new Fl_Single_Window widget using the given
+position, size, and label (title) string.
+virtual
+Fl_Single_Window::~Fl_Single_Window()
+ Destroys the window and all child widgets.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Slider.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Slider.html
new file mode 100644
index 0000000..5c5b770
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Slider.html
@@ -0,0 +1,82 @@
+
+
+ class Fl_Slider
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Slider
+ |
+ +----Fl_Scrollbar, Fl_Value_Slider
+
+
+Include Files
+
+
+#include <FL/Fl_Slider.H>
+
+
+Description
+ The Fl_Slider widget contains a sliding knob inside a box. It
+if often used as a scrollbar. Moving the box all the way to the
+top/left sets it to the minimum(), and to the bottom/right to
+the maximum(). The minimum() may be greater than the
+maximum() to reverse the slider direction.
+
Methods
+
+
+Fl_Slider::Fl_Slider(int x, int y, int
+w, int h, const char *label = 0)
+ Creates a new Fl_Slider widget using the given position,
+size, and label string. The default boxtype is FL_DOWN_BOX.
+virtual Fl_Slider::~Fl_Slider()
+ Destroys the valuator.
+int Fl_Slider::scrollvalue(int
+windowtop, int windowsize, int first, int totalsize)
+ Returns
+Fl_Scrollbar::value().
+Fl_Boxtype Fl_Slider::slider() const
+
+ Set the type of box to draw for the moving part of the slider. The
+color of the moving part (or of the notch in it for the nice sliders)
+is controlled by selection_color(). The default value of zero
+causes the slider to figure out what to draw from box().
+
void Fl_Slider::slider(Fl_Boxtype)float Fl_Slider::slider_size() const
+
+ Get or set the dimensions of the moving piece of slider. This is the
+fraction of the size of the entire widget. If you set this to 1 then
+the slider cannot move. The default value is .08.
+
void Fl_Slider::slider_size(float)uchar Fl_Widget::type() const
+
+ Setting this changes how the slider is drawn, which can be one of the
+following:
+
void Fl_Widget::type(uchar t)
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Spinner.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Spinner.html
new file mode 100644
index 0000000..0345164
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Spinner.html
@@ -0,0 +1,123 @@
+
+
+ class Fl_Spinner
+
+
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Spinner
+
+
+Include Files
+
+
+#include <FL/Fl_Spinner.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_Spinner::Fl_Spinner(int x, int y, int w,
+int h, const char *label = 0)
+
+virtual Fl_Spinner::~Fl_Spinner()
+
+void format(const char *f)
+
+
+const char *format()void maximum(double m)
+
+
+double maximum() constvoid minimum(double m)
+
+
+double minimum() constvoid range(double minval, double maxval)
+
+void step(double s)
+
+
+double step() constvoid textcolor(Fl_Color c)
+
+
+Fl_Color textcolor() constvoid textfont(uchar f)
+
+
+uchar textfont() constvoid textsize(uchar s)
+
+
+uchar textsize() constvoid type(uchar s)
+
+
+uchar type() constvoid Fl_Spinner::value(double v)
+
+
+double Fl_Spinner::value() constclass Fl_Tabs
+
+
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Tabs
+
+
+Include Files
+
+
+#include <FL/Fl_Tabs.H>
+
+
+Description
+
+
Methods
+
+
+
+Fl_Tabs::Fl_Tabs(int x, int y, int w, int h,
+const char *label = 0)
+
+virtual Fl_Tabs::~Fl_Tabs()
+
+Fl_Widget* Fl_Tabs::value()
+
+
+
int Fl_Tabs::value(Fl_Widget*)class Fl_Text_Buffer
+
+
+
+Class Hierarchy
+
+
+Fl_Text_Buffer
+
+
+Include Files
+
+
+#include <FL/Fl_Text_Buffer.H>
+
+
+Description
+
+Methods
+
+Fl_Text_Buffer(int requestedSize = 0);
+
+~Fl_Text_Buffer();
+
+void add_modify_callback(Fl_Text_Modify_Cb bufModifiedCB, void* cbArg);
+
+
+typedef void (*Fl_Text_Modify_Cb)(int pos, int nInserted, int nDeleted,
+ int nRestyled, const char* deletedText,
+ void* cbArg);
+
+
+void append(const char* text);
+
+int appendfile(const char *file, int buflen = 128*1024);
+
+void call_modify_callbacks();
+
+char character(int pos);
+
+static int character_width(char c, int indent, int tabDist, char nullSubsChar);
+
+void clear_rectangular(int start, int end, int rectStart, int rectEnd);
+
+void copy(Fl_Text_Buffer* fromBuf, int fromStart, int fromEnd, int toPos);
+
+int count_displayed_characters(int lineStartPos, int targetPos);
+
+int count_lines(int startPos, int endPos);
+
+int expand_character(int pos, int indent, char *outStr);
+
+
+static int expand_character(char c, int indent, char* outStr, int tabDist,
+char nullSubsChar);int findchar_backward(int startPos, char searchChar, int* foundPos);
+
+int findchar_forward(int startPos, char searchChar, int* foundPos);
+
+int findchars_backward(int startPos, const char* searchChars, int* foundPos);
+
+int findchars_forward(int startPos, const char* searchChars, int* foundPos);
+
+void highlight(int start, int end);
+
+int highlight_position(int* start, int* end, int* isRect, int* rectStart,
+int* rectEnd);
+
+void highlight_rectangular(int start, int end, int rectStart, int rectEnd);
+
+Fl_Text_Selection* highlight_selection();
+
+const char* highlight_text();
+
+void insert_column(int column, int startPos, const char* text,
+int* charsInserted, int* charsDeleted);
+
+int insertfile(const char *file, int pos, int buflen = 128*1024);
+
+void insert(int pos, const char* text);
+
+int length();
+
+int line_end(int pos);
+
+int line_start(int pos);
+
+const char* line_text(int pos);
+
+int loadfile(const char *file, int buflen = 128*1024);
+
+char null_substitution_character();
+
+int outputfile(const char *file, int start, int end, int buflen = 128*1024);
+
+void overlay_rectangular(int startPos, int rectStart, int rectEnd,
+const char* text, int* charsInserted, int* charsDeleted);
+
+Fl_Text_Selection* primary_selection();
+
+void remove_modify_callback(Fl_Text_Modify_Cb bufModifiedCB, void* cbArg);
+
+void remove_rectangular(int start, int end, int rectStart, int rectEnd);
+
+void remove(int start, int end);
+
+void remove_secondary_selection();
+
+void remove_selection();
+
+void replace_rectangular(int start, int end, int rectStart, int rectEnd,
+const char* text);
+
+void replace(int start, int end, const char *text);
+
+void replace_secondary_selection(const char* text);
+
+void replace_selection(const char* text);
+
+int rewind_lines(int startPos, int nLines);
+
+int savefile(const char *file, int buflen = 128*1024);
+
+int search_backward(int startPos, const char* searchString, int* foundPos,
+int matchCase = 0);
+
+int search_forward(int startPos, const char* searchString, int* foundPos,
+int matchCase = 0);
+
+int secondary_selection_position(int* start, int* end, int* isRect,
+int* rectStart, int* rectEnd);
+
+Fl_Text_Selection* secondary_selection();
+
+const char* secondary_selection_text();
+
+void secondary_select_rectangular(int start, int end, int rectStart,
+int rectEnd);
+
+void secondary_select(int start, int end);
+
+void secondary_unselect();
+
+int selected();
+
+int selection_position(int* start, int* end);
+
+
+int selection_position(int* start, int* end, int* isRect, int* rectStart, int* rectEnd);const char* selection_text();
+
+void select_rectangular(int start, int end, int rectStart, int rectEnd);
+
+void select(int start, int end);
+
+int skip_displayed_characters(int lineStartPos, int nChars);
+
+int skip_lines(int startPos, int nLines);
+
+int substitute_null_characters(char* string, int length);
+
+int tab_distance();
+
+
+void tab_distance(int tabDist);const char* text_in_rectangle(int start, int end, int rectStart, int rectEnd);
+
+const char* text_range(int start, int end);
+
+const char* text();
+
+
+void text(const char* text);void unhighlight();
+
+void unselect();
+
+void unsubstitute_null_characters(char* string);
+
+int word_end(int pos);
+
+int word_start(int pos);
+
+class Fl_Text_Display
+
+
+
+Class Hierarchy
+
+
+
+Fl_Group
+ |
+ +----Fl_Text_Display----Fl_Text_Buffer
+ |
+ +----Fl_Text_Editor
+
+
+Include Files
+
+
+
+#include <FL/Fl_Text_Display.H>
+
+
+
+Description
+
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
Fl_Text_Display(int X, int Y, int W, int H, const char *l = 0);
+
+~Fl_Text_Display();
+
+void buffer(Fl_Text_Buffer* buf);
+
+
+void buffer(Fl_Text_Buffer& buf);
+Fl_Text_Buffer* buffer();void cursor_color(Fl_Color c);
+
+
+Fl_Color cursor_color();void cursor_style(int style);
+
+
+
+
+
+Fl_Text_Display::NORMAL_CURSOR - Shows an I beam.
+
+ Fl_Text_Display::CARET_CURSOR - Shows a caret under the text.
+
+ Fl_Text_Display::DIM_CURSOR - Shows a dimmed I beam.
+
+ Fl_Text_Display::BLOCK_CURSOR - Shows an unfilled box around the current
+ character.
+
+ Fl_Text_Display::HEAVY_CURSOR - Shows a thick I beam.
+
+void hide_cursor();
+
+void highlight_data(Fl_Text_Buffer *styleBuffer,
+Style_Table_Entry *styleTable, int nStyles, char
+unfinishedStyle, Unfinished_Style_Cb unfinishedHighlightCB, void
+*cbArg);
+
+highlight_data() method.
+
+int in_selection(int x, int y);
+
+void insert(const char* text);
+
+void insert_position(int newPos);
+
+
+int insert_position()int move_down();
+
+int move_left();
+
+int move_right();
+
+int move_up();
+
+void next_word(void);
+
+void overstrike(const char* text);
+
+int position_style(int lineStartPos, int lineLen, int lineIndex,
+int dispIndex);
+
+lineStartPos + lineIndex.
+
+void previous_word(void);
+
+void redisplay_range(int start, int end);
+
+start to end as needing a redraw.
+
+void scrollbar_align(Fl_Align a);
+
+
+Fl_Align scrollbar_align();FL_ALIGN_LEFT and FL_ALIGN_RIGHT for
+the vertical scrollbar and FL_ALIGN_TOP and
+FL_ALIGN_BOTTOM for the horizontal scrollbar.
+
+void scrollbar_width(int w);
+
+
+int scrollbar_width();void scroll(int topLineNum, int horizOffset);
+
+void show_cursor(int b = 1);
+
+void show_insert_position();
+
+void textcolor(unsigned n);
+
+
+Fl_Color textcolor() const;void textfont(uchar s);
+
+
+Fl_Font textfont() const;void textsize(uchar s);
+
+
+uchar textsize() const;int word_end(int pos);
+
+int word_start(int pos);
+
+void wrap_mode(int mode, int pos);
+
+class Fl_Text_Editor
+
+
+
+Class Hierarchy
+
+
+
+Fl_Text_Display
+ |
+ +----Fl_Text_Editor
+
+
+
+Include Files
+
+
+
+#include <FL/Fl_Text_Editor.H>
+
+
+
+Description
+
+Methods
+
+
+
+
+
+
+
+
Fl_Text_Editor(int X, int Y, int W, int H, const char* l = 0);
+
+~Fl_Text_Editor();
+
+void add_default_key_bindings(Key_Binding** list);
+
+void add_key_binding(int key, int state, Key_Func f, Key_Binding** list);
+
+
+void add_key_binding(int key, int state, Key_Func f);Key_Func bound_key_function(int key, int state, Key_Binding* list);
+
+
+Key_Func bound_key_function(int key, int state);void default_key_function(Key_Func f);
+
+void insert_mode(int b);
+
+
+int insert_mode();int kf_backspace(int c, Fl_Text_Editor* e);
+
+int kf_copy(int c, Fl_Text_Editor* e);
+
+int kf_c_s_move(int c, Fl_Text_Editor* e);
+
+c.
+
+int kf_ctrl_move(int c, Fl_Text_Editor* e);
+
+c.
+
+int kf_cut(int c, Fl_Text_Editor* e);
+
+int kf_default(int c, Fl_Text_Editor* e);
+
+c.
+
+int kf_delete(int c, Fl_Text_Editor* e);
+
+int kf_down(int c, Fl_Text_Editor* e);
+
+int kf_end(int c, Fl_Text_Editor* e);
+
+int kf_enter(int c, Fl_Text_Editor* e);
+
+int kf_home(int c, Fl_Text_Editor* e);
+
+int kf_ignore(int c, Fl_Text_Editor* e);
+
+int kf_insert(int c, Fl_Text_Editor* e);
+
+int kf_left(int c, Fl_Text_Editor* e);
+
+int kf_move(int c, Fl_Text_Editor* e);
+
+c.
+
+int kf_page_down(int c, Fl_Text_Editor* e);
+
+int kf_page_up(int c, Fl_Text_Editor* e);
+
+int kf_paste(int c, Fl_Text_Editor* e);
+
+int kf_right(int c, Fl_Text_Editor* e);
+
+int kf_select_all(int c, Fl_Text_Editor* e);
+
+int kf_shift_move(int c, Fl_Text_Editor* e);
+
+c.
+
+int kf_up(int c, Fl_Text_Editor* e);
+
+void remove_all_key_bindings(Key_Binding** list);
+
+
+void remove_all_key_bindings();void remove_key_binding(int key, int state, Key_Binding** list);
+
+
+void remove_key_binding(int key, int state);class Fl_Tile
+
+
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Tile
+
+
+Include Files
+
+
+#include <FL/Fl_Tile.H>
+
+
+Description
+
+
Methods
+
+
+Fl_Tile::Fl_Tile(int x, int y, int w, int
+h, const char *label = 0)
+ Creates a new Fl_Tile widget using the given position, size,
+and label string. The default boxtype is FL_NO_BOX.
+virtual Fl_Tile::~Fl_Tile()
+ The destructor also deletes all the children. This allows a
+whole tree to be deleted at once, without having to keep a pointer to
+all the children in the user code. A kludge has been done so the
+Fl_Tile and all of it's children can be automatic (local)
+variables, but you must declare the Fl_Tile first, so
+that it is destroyed last.
+void Fl_Tile::position(from_x, from_y,
+to_x, to_y)
+ Drag the intersection at from_x,from_y to to_x,to_y.
+ This redraws all the necessary children.
+void Fl_Tile::resizable(Fl_Widget &w)
+The "resizable" child widget (which should be invisible) limits where the
+border can be dragged to. If you don't set it, it will be possible to
+drag the borders right to the edge, and thus resize objects on the edge
+to zero width or height. The resizable() widget is not
+resized by dragging any borders.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Tiled_Image.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Tiled_Image.html
new file mode 100644
index 0000000..ad8c137
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Tiled_Image.html
@@ -0,0 +1,64 @@
+
+
+
+void Fl_Tile::resizable(Fl_Widget *w)class Fl_Tiled_Image
+
+
+Class Hierarchy
+
+
+Fl_Image
+ |
+ +----Fl_Tiled_Image
+
+
+Include Files
+
+
+#include <FL/Fl_Tiled_Image.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_Tiled_Image::Fl_Tiled_Image(Fl_Image *img, int W, int H);
+
+Fl_Tiled_Image::~Fl_Tiled_Image();
+
+Fl_Image *Fl_Tiled_Image::image();
+
+class Fl_Timer
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Timer
+
+
+Include Files
+
+
+#include <FL/Fl_Timer.H>
+
+
+Description
+ This is provided only to emulate the Forms Timer widget. It works by
+making a timeout callback every 1/5 second. This is wasteful and
+inaccurate if you just want something to happen a fixed time in the
+future. You should directly call
+Fl::add_timeout() instead.
+Methods
+
+Fl_Timer::Fl_Timer(uchar type, int x, int
+y, int w, int h, const char *label = 0)
+ Creates a new Fl_Timer widget using the given type, position,
+size, and label string. The type parameter can be any of the
+following symbolic constants:
+
+
+virtual Fl_Timer::~Fl_Timer()
+ Destroys the timer and removes the timeout.
+char direction() const
+
+ Gets or sets the direction of the timer. If the direction is zero
+then the timer will count up, otherwise it will count down from the
+initial value().
+
void direction(char d)char suspended() const
+
+ Gets or sets whether the timer is suspended.
+
void suspended(char d)float value() const
+
+ Gets or sets the current timer value.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Toggle_Button.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Toggle_Button.html
new file mode 100644
index 0000000..d65c136
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Toggle_Button.html
@@ -0,0 +1,43 @@
+
+
+
void value(float)class Fl_Toggle_Button
+
+Class Hierarchy
+
+
+Fl_Button
+ |
+ +----Fl_Toggle_Button
+
+
+Include Files
+
+
+#include <FL/Fl_Toggle_Button.H>
+
+
+Description
+Methods
+
+
+Fl_Toggle_Button::Fl_Toggle_Button(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Toggle_Button widget using the given
+position, size, and label string.
+
+Fl_Toggle_Button::~Fl_Toggle_Button()
+ The destructor deletes the toggle button.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Tooltip.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Tooltip.html
new file mode 100644
index 0000000..c671e7e
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Tooltip.html
@@ -0,0 +1,116 @@
+
+
+ class Fl_Tooltip
+
+
+Class Hierarchy
+
+
+Fl_Tooltip
+
+
+Include Files
+
+
+#include <FL/Fl_Tooltip.H>
+
+
+Description
+
+Methods
+
+
+
+
+
+void delay(float f);
+
+
+float delay();int enabled();
+
+void enable(int b = 1);
+
+void disable();
+
+void enter(Fl_Widget *w);
+
+void enter_area(Fl_Widget* widget, int x,int y,int w,int h, const char* tip)
+
+void exit(Fl_Widget *w);
+
+void color(unsigned c);
+
+
+Fl_Color color();void font(int i);
+
+
+int font();void hoverdelay(float f);
+
+
+float hoverdelay();void size(int s);
+
+
+int size();void textcolor(unsigned c);
+
+
+Fl_Color textcolor();class Fl_Valuator
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Valuator
+ |
+ +----Fl_Adjuster, Fl_Counter, Fl_Dial, Fl_Roller,
+ Fl_Slider, Fl_Value_Input, Fl_Value_Output,
+
+
+Include Files
+
+
+#include <FL/Fl_Valuator.H>
+
+
+Description
+ The Fl_Valuator class controls a single floating-point value
+and provides a consistent interface to set the value, range, and step,
+and insures that callbacks are done the same for every object.
+
Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Fl_Valuator::Fl_Valuator(int x, int
+y, int w, int h, const char *label = 0)
+
+virtual Fl_Valuator::~Fl_Valuator()
+
+void Fl_Valuator::bounds(double a, double b);
+
+int Fl_Valuator::changed() const
+
+double Fl_Valuator::clamp(double)
+
+void Fl_Valuator::clear_changed()
+
+int Fl_Valuator::format(char *buffer)
+
+double
+Fl_Valuator::increment(double,int n)
+
+double Fl_Valuator::maximum() const
+
+
+
void Fl_Valuator::maximum(double)double Fl_Valuator::minimum() const
+
+
+
void Fl_Valuator::minimum(double)void Fl_Valuator::precision(int digits);
+
+void Fl_Valuator::range(double min,
+double max);
+
+double Fl_Valuator::round(double)
+
+void Fl_Valuator::set_changed()
+
+double Fl_Valuator::step() const
+
+
+
void Fl_Valuator::step(double)
+
void Fl_Valuator::step(int A, int B)double Fl_Valuator::value() const
+
+
+
int Fl_Valuator::value(double)class Fl_Value_Input
+
+
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Value_Input
+
+
+Include Files
+
+
+#include <FL/Fl_Value_Input.H>
+
+
+Description
+
+
Methods
+
+
+
+Fl_Value_Input::Fl_Value_Input(int
+x, int y, int w, int h, const char *label = 0)
+
+virtual
+Fl_Value_Input::~Fl_Value_Input()
+
+Fl_Color
+Fl_Value_Input::cursor_color() const
+
+
+void Fl_Value_Input::cursor_color(Fl_Color)uchar Fl_Value_Input::soft() const
+
+
+void Fl_Value_Input::soft(uchar)Fl_Color
+Fl_Value_Input::textcolor() const
+
+
+void Fl_Value_Input::textcolor(Fl_Color)Fl_Font
+Fl_Value_Input::textfont() const
+
+
+void Fl_Value_Input::textfont(Fl_Font)uchar
+Fl_Value_Input::textsize() const
+
+
+void Fl_Value_Input::textsize(uchar)class Fl_Value_Output
+
+Class Hierarchy
+
+
+Fl_Valuator
+ |
+ +----Fl_Value_Output
+
+
+Include Files
+
+
+#include <FL/Fl_Value_Output.H>
+
+
+Description
+ The Fl_Value_Output widget displays a floating point value.
+If step() is not zero, the user can adjust the value by
+dragging the mouse left and right. The left button moves one step()
+ per pixel, the middle by 10 * step(), and the right button by
+100 * step().
+
Methods
+
+
+Fl_Value_Output::Fl_Value_Output(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Value_Output widget using the given
+position, size, and label string. The default boxtype is FL_NO_BOX
+.
+virtual
+Fl_Value_Output::~Fl_Value_Output()
+ Destroys the valuator.
+uchar Fl_Value_Output::soft() const
+
+ If "soft" is turned on, the user is allowed to drag the value outside
+the range. If they drag the value to one of the ends, let go, then
+grab again and continue to drag, they can get to any value. Default is
+one.
+
void Fl_Value_Output::soft(uchar)Fl_Color
+Fl_Value_Output::textcolor() const
+
+ Gets or sets the color of the text in the value box.
+
void Fl_Value_Output::textcolor(Fl_Color)Fl_Font
+Fl_Value_Output::textfont() const
+
+ Gets or sets the typeface of the text in the value box.
+
+
void Fl_Value_Output::textfont(Fl_Font)uchar Fl_Value_Output::textsize()
+const
+
+ Gets or sets the size of the text in the value box.
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Slider.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Slider.html
new file mode 100644
index 0000000..a0aff36
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Value_Slider.html
@@ -0,0 +1,57 @@
+
+
+
void Fl_Value_Output::textsize(uchar)class Fl_Value_Slider
+
+Class Hierarchy
+
+
+Fl_Slider
+ |
+ +----Fl_Value_Slider
+
+
+Include Files
+
+
+#include <FL/Fl_Value_Slider.H>
+
+
+Description
+ The Fl_Value_Slider widget is a Fl_Slider widget
+with a box displaying the current value.
+
Methods
+
+
+Fl_Value_Slider::Fl_Value_Slider(int x, int y, int w, int h, const char
+*label = 0)
+ Creates a new Fl_Value_Slider widget using the given
+position, size, and label string. The default boxtype is FL_DOWN_BOX
+.
+virtual
+Fl_Value_Slider::~Fl_Value_Slider()
+ Destroys the valuator.
+Fl_Color
+Fl_Value_Slider::textcolor() const
+
+ Gets or sets the color of the text in the value box.
+
void Fl_Value_Slider::textcolor(Fl_Color)Fl_Font
+Fl_Value_Slider::textfont() const
+
+ Gets or sets the typeface of the text in the value box.
+
+
void Fl_Value_Slider::textfont(Fl_Font)uchar Fl_Value_Slider::textsize()
+const
+
+Gets or sets the size of the text in the value box.
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/Fl_Widget.html b/third_party/windows/fltk-1.1.10/documentation/Fl_Widget.html
new file mode 100644
index 0000000..28ffc2f
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/Fl_Widget.html
@@ -0,0 +1,568 @@
+
+
+
void Fl_Value_Slider::textsize(uchar)class Fl_Widget
+
+Class Hierarchy
+
+
+Fl_Widget
+ |
+ +----Fl_Box, Fl_Browser_, Fl_Button, Fl_Chart, Fl_Clock_Output,
+ Fl_Free, Fl_Group, Fl_Input_, Fl_Menu_, Fl_Positioner,
+ Fl_Progress, Fl_Timer, Fl_Valuator
+
+
+Include Files
+
+
+#include <FL/Fl_Widget.H>
+
+
+Description
+Fl_Widget is the base class for all widgets in FLTK. You can't
+create one of these because the constructor is not public. However you
+can subclass it.
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+protected Fl_Widget::Fl_Widget(int x, int y, int w, int h, const char*
+label=0);
+
+virtual Fl_Widget::~Fl_Widget();
+
+int Fl_Widget::active() const
+
+
+int Fl_Widget::active_r() const
+void Fl_Widget::activate()
+void Fl_Widget::deactivate()Fl_Align Fl_Widget::align() const
+
+
+
void Fl_Widget::align(Fl_Align)
+
+
+
+long Fl_Widget::argument() const
+
+
+
void Fl_Widget::argument(long)
+
+
+Note:
+
+
+Fl_Boxtype Fl_Widget::box() const
+
+
+
void Fl_Widget::box(Fl_Boxtype)typedef void (Fl_Callback)(Fl_Widget*, void*)
+
+
+
Fl_Callback* Fl_Widget::callback() const
+
void Fl_Widget::callback(Fl_Callback*, void* = 0)
+
void Fl_Widget::callback(void (*)(Fl_Widget*, long), long = 0)
+
void Fl_Widget::callback(void (*)(Fl_Widget*))int Fl_Widget::changed() const
+
+
+
void Fl_Widget::clear_changed()
+
void Fl_Widget::set_changed()void Fl_Widget::clear_visible();
+
+hide() method instead.
+
+
+void Fl_Window::clear_visible_focus();
+
+Fl_Color Fl_Widget::color() const
+
+
+
void Fl_Widget::color(Fl_Color)
+
void Fl_Widget::color(Fl_Color, Fl_Color)int Fl_Widget::contains(Fl_Widget* b) const
+
+void Fl_Widget::copy_label(const char*)
+
+uchar Fl_Widget::damage() const
+
+
+void damage(uchar c);
+void damage(uchar c, int X, int Y, int W, int H);static void
+Fl_Widget::default_callback(Fl_Widget*, void*)
+
+Fl_Image* Fl_Widget::deimage()
+
+
+void Fl_Widget::deimage(Fl_Image* a)
+void Fl_Widget::deimage(Fl_Image& a)void Fl_Widget::do_callback()
+
+
+
void Fl_Widget::do_callback(Fl_Widget*, void* = 0)
+
void Fl_Widget::do_callback(Fl_Widget*, long)virtual int Fl_Widget::handle(int event)
+
+Fl_Image* Fl_Widget::image()
+
+
+void Fl_Widget::image(Fl_Image* a)
+void Fl_Widget::image(Fl_Image& a)int Fl_Widget::inside(const Fl_Widget* a)
+const
+
+const char* Fl_Widget::label() const
+
+
+
void Fl_Widget::label(const char*)Fl_Color Fl_Widget::labelcolor() const
+
+
+
void Fl_Widget::labelcolor(Fl_Color)Fl_Font Fl_Widget::labelfont() const
+
+
+
void Fl_Widget::labelfont(Fl_Font)uchar Fl_Widget::labelsize() const
+
+
+
void Fl_Widget::labelsize(uchar)void Fl_Widget::label(Fl_Labeltype,
+const char*)
+
+
+
uchar Fl_Widget::labeltype() const
+
void Fl_Widget::labeltype(Fl_Labeltype)int Fl_Widget::output() const
+
+
+
void Fl_Widget::clear_output()
+
void Fl_Widget::set_output()Fl_Group *Fl_Widget::parent() const
+
+void Fl_Widget::redraw()
+
+void Fl_Widget::redraw_label()
+
+virtual void
+Fl_Widget::resize(int x, int y, int w, int h)
+
+
+
void Fl_Widget::position(short x, short y)
+
void Fl_Widget::size(short w, short h)Fl_Color
+Fl_Widget::selection_color() const
+
+
+
void Fl_Widget::selection_color(Fl_Color)int Fl_Widget::takesevents() const
+
+int Fl_Widget::take_focus()
+ Tries to make this widget be the Fl::focus() widget, by first
+sending it an FL_FOCUS event, and if it returns non-zero,
+setting Fl::focus() to this widget. You should use this
+method to assign the focus to an widget. Returns true if the widget
+accepted the focus.
+
+
+const char *Fl_Widget::tooltip()
+
+
+void Fl_Widget::tooltip(const char *t)uchar Fl_Widget::type() const;
+
+short Fl_Widget::x() const
+
+
+
short Fl_Widget::y() const
+
short Fl_Widget::w() const
+
short Fl_Widget::h() constvoid* Fl_Widget::user_data() const
+
+
+
void Fl_Widget::user_data(void*)Fl_Window* Fl_Widget::window() const;
+
+void Fl_Widget::set_visible();
+
+show() method
+instead.
+
+
+void Fl_Widget::set_visible_focus();
+
+int Fl_Widget::visible() const
+
+
+int Fl_Widget::visible_r() const
+void Fl_Widget::show()
+void Fl_Widget::hide()void Fl_Widget::visible_focus(int);
+
+
+int Fl_Widget::visible_focus();set_visible_focus() and
+clear_visible_focus().
+The second form returns non-zero if this widget will participate in keyboard focus navigation.
+
+Fl_When Fl_Widget::when() const
+
+
+
void Fl_Widget::when(Fl_When)class Fl_Window
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Window
+ |
+ +----Fl_Double_Window, Fl_Gl_Window,
+ Fl_Overlay_Window, Fl_Single_Window
+
+
+Include Files
+
+
+#include <FL/Fl_Window.H>
+
+
+Description
+ This widget produces an actual window. This can either be a main
+window, with a border and title and all the window management controls,
+or a "subwindow" inside a window. This is controlled by whether or not
+the window has a parent().
+Methods
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Fl_Window::Fl_Window(int w, int h, const char *title = 0)
+
+
+Fl_Window::Fl_Window(int x, int y, int w, int h, const char *title = 0)virtual Fl_Window::~Fl_Window()
+ The destructor also deletes all the children. This allows a
+whole tree to be deleted at once, without having to keep a pointer to
+all the children in the user code. A kludge has been done so the
+Fl_Window and all of its children can be automatic (local)
+variables, but you must declare the Fl_Window first so
+that it is destroyed last.
+void Fl_Window::size_range(int minw,
+int minh, int maxw=0, int maxh=0, int dw=0, int dh=0, int aspect=0)
+ Set the allowable range the user can resize this window to. This only
+works for top-level windows.
+
+
+ If this function is not called, FLTK tries to figure out the range
+from the setting of resizable():
+
+
+ It is undefined what happens if the current size does not fit in the
+constraints passed to size_range().
+virtual void Fl_Window::show()
+
+Put the window on the screen. Usually this has the side effect of
+opening the display. The second form is used for top-level
+windows and allows standard arguments to be parsed from the
+command-line.
+
void Fl_Window::show(int argc, char **argv)virtual void Fl_Window::hide()
+ Remove the window from the screen. If the window is already hidden or
+has not been shown then this does nothing and is harmless.
+int Fl_Window::shown() const
+ Returns non-zero if show() has been called (but not hide()
+). You can tell if a window is iconified with (w->shown()
+&& !w->visible()).
+void Fl_Window::iconize()
+ Iconifies the window. If you call this when shown() is false
+it will show() it as an icon. If the window is already
+iconified this does nothing.
+void Fl_Window::resize(int,int,int,int)
+ Change the size and position of the window. If shown() is
+true, these changes are communicated to the window server (which may
+refuse that size and cause a further resize). If shown() is
+false, the size and position are used when show() is called.
+See Fl_Group for the effect
+of resizing on the child widgets.
+void Fl_Window::free_position()
+ Undoes the effect of a previous resize() or show()
+ so that the next time show() is called the window manager is
+free to position the window.
+void Fl_Window::hotspot(int x, int y, int
+offscreen = 0)
+
+position() the window so that the mouse is pointing at the
+given position, or at the center of the given widget, which may be the
+window itself. If the optional offscreen parameter is
+non-zero, then the window is allowed to extend off the screen (this
+does not work with some X window managers).
+
void Fl_Window::hotspot(const Fl_Widget*, int offscreen = 0)
+
void Fl_Window::hotspot(const Fl_Widget&, int offscreen = 0)void Fl_Window::fullscreen()
+ Makes the window completely fill the screen, without any window
+manager border visible. You must use fullscreen_off() to undo
+this. This may not work with all window managers.
+int Fl_Window::fullscreen_off(int
+x, int y, int w, int h)
+ Turns off any side effects of fullscreen() and does
+resize(x,y,w,h).
+int Fl_Window::border(int)
+
+ Gets or sets whether or not the window manager border is around the
+window. The default value is true. border(n) can be used to
+turn the border on and off, and returns non-zero if the value has been
+changed. Under most X window managers this does not work after
+show() has been called, although SGI's 4DWM does work.
+
uchar Fl_Window::border() constvoid Fl_Window::clear_border()
+clear_border() is a fast inline function to turn the border
+off. It only works before show() is called.
+void Fl_Window::set_modal()
+ A "modal" window, when shown(), will prevent any events from
+being delivered to other windows in the same program, and will also
+remain on top of the other windows (if the X window manager supports
+the "transient for" property). Several modal windows may be shown at
+once, in which case only the last one shown gets events. You can see
+which window (if any) is modal by calling
+Fl::modal().
+uchar Fl_Window::modal() const
+ Returns true if this window is modal.
+void Fl_Window::set_non_modal()
+ A "non-modal" window (terminology borrowed from Microsoft Windows)
+acts like a modal() one in that it remains on top, but it has
+no effect on event delivery. There are three states for a
+window: modal, non-modal, and normal.
+uchar Fl_Window::non_modal() const
+ Returns true if this window is modal or non-modal.
+void Fl_Window::label(const char*)
+
+ Gets or sets the window title bar label.
+
const char* Fl_Window::label() constvoid Fl_Window::iconlabel(const char*)
+
+ Gets or sets the icon label.
+
const char* Fl_Window::iconlabel() constvoid Fl_Window::xclass(const char*)
+
+ A string used to tell the system what type of window this is. Mostly
+this identifies the picture to draw in the icon. Under X, this is
+turned into a XA_WM_CLASS pair by truncating at the first
+non-alphanumeric character and capitalizing the first character, and
+the second one if the first is 'x'. Thus "foo" turns into "foo, Foo",
+and "xprog.1" turns into "xprog, XProg". This only works if called
+before calling show().
+
const char* Fl_Window::xclass() constvoid Fl_Window::make_current()
+make_current() sets things up so that the drawing functions in <FL/fl_draw.H> will go into this
+window. This is useful for incremental update of windows, such as in an
+idle callback, which will make your program behave much better if it
+draws a slow graphic. Danger: incremental update is very hard to
+debug and maintain!
+static Fl_Window* Fl_Window::current()
+ Returns the last window that was made current.
+void Fl_Window::cursor(Fl_Cursor, Fl_Color = FL_WHITE, Fl_Color = FL_BLACK)
+Change the cursor for this window. This always calls the system, if
+you are changing the cursor a lot you may want to keep track of how
+you set it in a static variable and call this only if the new cursor
+is different.
+
+class Fl_Wizard
+
+
+
+Class Hierarchy
+
+
+Fl_Group
+ |
+ +----Fl_Wizard
+
+
+Include Files
+
+
+#include "Fl_Wizard.h"
+
+
+Description
+
+Fl_Wizard widget is based off the Fl_Tabs
+widget, but instead of displaying tabs it only changes "tabs" under
+program control. Its primary purpose is to support "wizards" that
+step a user through configuration or troubleshooting tasks.
+
+Fl_Tabs, wizard panes are composed of child (usually
+Fl_Group) widgets. Navigation buttons must be added separately.
+
+Methods
+
+
+
+
+
+Fl_Wizard(int xx, int yy, int ww, int hh, const char *l = 0)
+
+Fl_Wizard widget at the specified
+position and size.
+
+~Fl_Wizard()
+
+void next()
+
+void prev()
+
+void value(Fl_Widget *w)
+
+
+Fl_Widget *value()class Fl_XBM_Image
+
+
+Class Hierarchy
+
+
+Fl_Bitmap
+ |
+ +----Fl_XBM_Image
+
+
+Include Files
+
+
+#include <FL/Fl_XBM_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_XBM_Image::Fl_XBM_Image(const char *filename);
+
+Fl_XBM_Image::~Fl_XBM_Image();
+
+class Fl_XPM_Image
+
+
+Class Hierarchy
+
+
+Fl_Pixmap
+ |
+ +----Fl_XPM_Image
+
+
+Include Files
+
+
+#include <FL/Fl_XPM_Image.H>
+
+
+Additional Libraries
+
+
+-lfltk_images / fltkimages.lib
+
+
+Description
+
+Methods
+
+
+
+
+
+Fl_XPM_Image::Fl_XPM_Image(const char *filename);
+
+Fl_XPM_Image::~Fl_XPM_Image();
+
+10 - Advanced FLTK
+
+Multithreading
+
+
+ int main() {
+ Fl::lock();
+ /* run thread */
+ while (Fl::wait() > 0) {
+ if (Fl::thread_message()) {
+ /* process your data */
+ }
+ }
+ }
+
+
+
+ Fl::lock(); // avoid conflicting calls
+ ... // your code here
+ Fl::unlock(); // allow other threads to access FLTK again
+
+
+
+ void *msg; // "msg" is a pointer to your message
+ Fl::awake(msg); // send "msg" to main thread
+
+
+
+ void do_something(void *userdata) {
+ // running with the main thread
+ }
+
+ // running in another thread
+ void *data; // "data" is a pointer to your user data
+ Fl::awake(do_something, data); // call something in main thread
+
+
+
+
+
+
+
+2 - FLTK Basics
+
+Writing Your First FLTK Program
+
+
+
+#include <FL/Fl.H>
+#include <FL/Fl_Window.H>
+#include <FL/Fl_Box.H>
+
+int main(int argc, char **argv) {
+ Fl_Window *window = new Fl_Window(300,180);
+ 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);
+ window->end();
+ window->show(argc, argv);
+ return Fl::run();
+}
+
+
+
+
+
+Fl_Window *window = new Fl_Window(300,180);
+
+
+
+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);
+
+
+
+window->end();
+
+
+
+window->show(argc, argv);
+return Fl::run();
+
+
+
+Figure 2-1: The Hello, World! WindowCreating the Widgets
+
+
+Fl_Widget(x, y, width, height, label)
+
+
+Creating Widget hierarchies
+
+Get/Set Methods
+
+Redrawing After Changing Attributes
+
+Labels
+
+Showing the Window
+
+The Main Event Loop
+
+
+while (Fl::wait());
+
+
+Compiling Programs with Standard Compilers
+
+
+CC -I/usr/local/include ...
+gcc -I/usr/local/include ...
+
+
+
+CC `fltk-config --cxxflags` ...
+
+
+
+CC ... -L/usr/local/lib -lfltk -lXext -lX11 -lm
+gcc ... -L/usr/local/lib -lfltk -lXext -lX11 -lm
+
+
+Fl_Help_Dialog
+widget, and system icon support.
+
+
+
+
+Note:
+
+
+CC ... `fltk-config --ldflags`
+
+
+
+
+
+CC ... `fltk-config --use-forms --ldflags`
+CC ... `fltk-config --use-gl --ldflags`
+CC ... `fltk-config --use-images --ldflags`
+CC ... `fltk-config --use-forms --use-gl --use-images --ldflags`
+
+
+
+fltk-config --compile filename.cpp
+fltk-config --use-forms --compile filename.cpp
+fltk-config --use-gl --compile filename.cpp
+fltk-config --use-images --compile filename.cpp
+fltk-config --use-forms --use-gl --use-images --compile filename.cpp
+
+
+Compiling Programs with Microsoft Visual C++
+
+Naming
+
+
+
+
+
+
+
+Header Files
+
+
+#include <FL/Fl_xyz.H>
+
+
+
+
+
+Note:
+
+
+
+ #include <FL\Fl_xyz.H>
+ #include <fl/fl_xyz.h>
+ #include <Fl/fl_xyz.h>
+
+
+ 3 - Common Widgets and Attributes
+
+Buttons
+
+
+
+
+
+
+Figure 3-1: FLTK Button Widgets
+Fl_Button *button = new Fl_Button(x, y, width, height, "label");
+Fl_Light_Button *lbutton = new Fl_Light_Button(x, y, width, height);
+Fl_Round_Button *rbutton = new Fl_Round_Button(x, y, width, height, "label");
+
+
+
+button->type(FL_NORMAL_BUTTON);
+lbutton->type(FL_TOGGLE_BUTTON);
+rbutton->type(FL_RADIO_BUTTON);
+
+
+Text
+
+
+
+
+
+
+Fl_Input *input = new Fl_Input(x, y, width, height, "label");
+input->value("Now is the time for all good men...");
+
+
+Valuators
+
+
+
+
+
+
+Figure 3-2: FLTK valuator widgetsGroups
+
+
+
+
+
+Setting the Size and Position of Widgets
+
+
+button->position(x, y);
+group->resize(x, y, width, height);
+window->size(width, height);
+
+
+Colors
+
+
+
+
+
+
+
+
+Fl_Color c = fl_rgb_color(85, 170, 255);
+
+
+
+button->color(FL_RED);
+
+
+
+button->labelcolor(FL_WHITE);
+
+
+Box Types
+
+
+Figure 3-3: FLTK box typesMaking Your Own Boxtypes
+
+
+
+
+Note:
+
+The Drawing Function
+
+
+void xyz_draw(int x, int y, int w, int h, Fl_Color c) {
+...
+}
+
+
+
+
+
+void xyz_draw(int x, int y, int w, int h, Fl_Color c) {
+ fl_color(c);
+ fl_rectf(x, y, w, h);
+ fl_color(FL_BLACK);
+ fl_rect(x, y, w, h);
+}
+
+
+Fl_Boxtype fl_down(Fl_Boxtype)
+
+Fl_Boxtype fl_frame(Fl_Boxtype)
+
+Fl_Boxtype fl_box(Fl_Boxtype)
+
+Adding Your Box Type
+
+
+#define XYZ_BOX FL_FREE_BOXTYPE
+
+Fl::set_boxtype(XYZ_BOX, xyz_draw, 1, 1, 2, 2);
+
+
+Labels and Label Types
+
+label()
+
+
+Figure 3-4: FLTK label symbols
+
+
+
+align()
+
+
+
+
+
+labeltype()
+
+
+
+
+
+image() and deimage()
+
+Making Your Own Label Types
+
+
+
+
+Note:
+
+Label Type Functions
+
+
+void xyz_draw(const Fl_Label *label, int x, int y, int w, int h, Fl_Align align) {
+...
+}
+
+
+
+void xyz_measure(const Fl_Label *label, int &w, int &h) {
+...
+}
+
+
+Adding Your Label Type
+
+
+#define XYZ_LABEL FL_FREE_LABELTYPE
+
+Fl::set_labeltype(XYZ_LABEL, xyz_draw, xyz_measure);
+
+
+Making your own symbols
+
+
+int fl_add_symbol(const char *name, void (*drawit)(Fl_Color), int scalable)
+
+
+
+int fl_draw_symbol(const char *name,int x,int y,int w,int h,Fl_Color col)
+
+
+Callbacks
+
+
+void xyz_callback(Fl_Widget *w, void *data) {
+...
+}
+
+
+
+int xyz_data;
+
+button->callback(xyz_callback, &xyz_data);
+
+
+
+button->when(FL_WHEN_NEVER);
+button->when(FL_WHEN_CHANGED);
+button->when(FL_WHEN_RELEASE);
+button->when(FL_WHEN_RELEASE_ALWAYS);
+button->when(FL_WHEN_ENTER_KEY);
+button->when(FL_WHEN_ENTER_KEY_ALWAYS);
+button->when(FL_WHEN_CHANGED | FL_WHEN_NOT_CHANGED);
+
+
+
+
+
+Note:
+
+
+
+class Foo {
+ void my_callback(Fl_Widget *w);
+ static void my_static_callback(Fl_Widget *w, void *f) { ((Foo *)f)->my_callback(w); }
+ ...
+}
+
+...
+
+w->callback(my_static_callback, (void *)this);
+
+ Shortcuts
+
+
+button->shortcut(FL_Enter);
+button->shortcut(FL_SHIFT + 'b');
+button->shortcut(FL_CTRL + 'b');
+button->shortcut(FL_ALT + 'b');
+button->shortcut(FL_CTRL + FL_ALT + 'b');
+button->shortcut(0); // no shortcut
+
+
+5 - Drawing Things in FLTK
+
+When Can You Draw Things in FLTK?
+
+
+
+
+
+FLTK Drawing Functions
+
+
+
+
+
+Boxes
+
+void fl_draw_box(Fl_Boxtype b, int x, int y, int w, int h, Fl_Color c);
+
+fl_draw_box()
+which draws a standard boxtype c in the specified
+color c.
+
+void fl_frame(const char *s, int x, int y, int w, int h);
+
+fl_frame() function draws a series of line
+segments around the given box. The string s must
+contain groups of 4 letters which specify one of 24 standard
+grayscale values, where 'A' is black and 'X' is white. The order
+of each set of 4 characters is: top, left, bottom, right. The
+results of calling fl_frame() with a string that is
+not a multiple of 4 characters in length are undefined.
+
+fl_frame2() is the order of the line segments.
+
+void fl_frame2(const char *s, int x, int y, int w, int h);
+
+fl_frame2() function draws a series of line
+segments around the given box. The string s must
+contain groups of 4 letters which specify one of 24 standard
+grayscale values, where 'A' is black and 'X' is white. The order
+of each set of 4 characters is: bottom, right, top, left. The
+results of calling fl_frame2() with a string that is
+not a multiple of 4 characters in length are undefined.
+
+fl_frame() is the order of the line segments.
+
+Clipping
+
+void fl_clip(int x, int y, int w, int h)
+
+
+void fl_push_clip(int x, int y, int w, int h)fl_clip() name is deprecated and
+will be removed from future releases.
+
+void fl_push_no_clip()
+
+void fl_pop_clip()
+
+
+
+
+Note:
+
+
+int fl_not_clipped(int x, int y, int w, int h)
+
+
+
+
+Note:
+
+
+int fl_clip_box(int x, int y, int w, int h, int &X, int &Y, int &W,
+int &H)
+
+void fl_clip_region(Fl_Region r)
+
+
+
Fl_Region fl_clip_region()Colors
+
+void fl_color(Fl_Color)
+
+Fl_Color fl_color()
+
+void fl_color(uchar r, uchar g, uchar b)
+
+Line Dashes and Thickness
+
+void fl_line_style(int style, int width=0, char* dashes=0)
+
+
+
+
+Note:
+
+
+
+
+
+
+
+
+
+Note:
+
+
+Drawing Fast Shapes
+
+void fl_point(int x, int y)
+
+void fl_rectf(int x, int y, int w, int h)
+
+
+
void fl_rectf(int x, int y, int w, int h)void fl_rectf(int x, int y, int w, int h, uchar r, uchar g, uchar b)
+
+void fl_rect(int x, int y, int w, int h)
+
+
+
void fl_rect(int x, int y, int w, int h, Fl_Color c)void fl_line(int x, int y, int x1, int y1)
+
+
+
void fl_line(int x, int y, int x1, int y1, int x2, int y2)void fl_loop(int x, int y, int x1, int y1, int x2, int y2)
+
+
+
void fl_loop(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)
+
+
+
void fl_polygon(int x, int y, int x1, int y1, int x2, int y2, int
+x3, int y3)void fl_xyline(int x, int y, int x1)
+
+
+
void fl_xyline(int x, int y, int x1, int y2)
+
void fl_xyline(int x, int y, int x1, int y2, int x3)void fl_yxline(int x, int y, int y1)
+
+
+
void fl_yxline(int x, int y, int y1, int x2)
+
void fl_yxline(int x, int y, int y1, int x2, int y3)void fl_arc(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)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)
+
+Drawing Complex Shapes
+
+void fl_push_matrix()
+
+
+
void fl_pop_matrix()void fl_scale(float x, float y)
+
+
+
void fl_scale(float x)
+
void fl_translate(float x, float y)
+
void fl_rotate(float d)
+
void fl_mult_matrix(float a, float b, float c, float d, float
+x, float y)double fl_transform_x(double x, double y)
+
+
+
double fl_transform_y(double x, double y)
+
double fl_transform_dx(double x, double y)
+
double fl_transform_dy(double x, double y)
+
void fl_transformed_vertex(double xf, double yf)void fl_begin_points()
+
+
+
void fl_end_points()void fl_begin_line()
+
+
+
void fl_end_line()void fl_begin_loop()
+
+
+
void fl_end_loop()void fl_begin_polygon()
+
+
+
void fl_end_polygon()void fl_begin_complex_polygon()
+
+
+
void fl_gap()
+
void fl_end_complex_polygon()
+
+
+Note:
+
+
+void fl_vertex(float x, float y)
+Add a single vertex to the current path.
+
+void fl_curve(float x, float y, float x1, float y1, float x2, float
+y2, float x3, float y3)
+
+void fl_arc(float x, float y, float r, float start, float end)
+
+void fl_circle(float x, float y, float r)
+
+
+
+
+Note:
+
+
+Drawing Text
+
+void fl_draw(const char *, int x, int y)
+
+
+
void fl_draw(const char *, int n, int x, int y)void fl_draw(const char *, int x, int y, int w, int h,
+Fl_Align align, Fl_Image *img = 0, int draw_symbols = 1)
+
+void fl_measure(const char *, int &w,
+int &h, int draw_symbols = 1)
+
+int fl_height()
+
+int fl_descent()
+
+float fl_width(const char*)
+
+
+
float fl_width(const char*, int n)
+
float fl_width(uchar)const char *fl_shortcut_label(ulong)
+
+Fonts
+
+void fl_font(int face, int size)
+
+int fl_font()
+
+
+
int fl_size()Character Encoding
+
+
+ btn = new Fl_Button(10, 10, 300, 25);
+ btn->copy_label(fl_latin1_to_local("Fahrvergnügen"));
+
+
+Drawing Overlays
+
+void fl_overlay_rect(int x, int y, int w, int h);
+
+
+
void fl_overlay_clear();Drawing Images
+
+Direct Image Drawing
+
+void fl_draw_image(const uchar *, int X, int Y, int W, int H, int D
+= 3, int LD = 0)
+
+
+
void fl_draw_image_mono(const uchar *, int X, int Y, int W, int H,
+int D = 1, int LD = 0)
+Fl::visual(FL_RGB);
+
+
+
+
+
+Note:
+
+
+typedef void (*fl_draw_image_cb)(void *, int x, int y, int w, uchar
+*)
+
+
+
void fl_draw_image(fl_draw_image_cb, void *, int X, int Y, int W,
+int H, int D = 3)
+
void fl_draw_image_mono(fl_draw_image_cb, void *, int X, int Y,
+int W, int H, int D = 1)int fl_draw_pixmap(char **data, int X, int Y, Fl_Color = FL_GRAY)
+
+
+#include "foo.xpm"
+...
+fl_draw_pixmap(foo, X, Y);
+
+
+int fl_measure_pixmap(char **data, int &w, int &h)
+
+Direct Image Reading
+
+uchar *fl_read_image(uchar *p, int
+X, int Y, int W, int H, int alpha = 0);
+
+Image Classes
+
+
+
+
+
+char fl_can_do_alpha_blending()
+
+
+
+
+
+virtual void copy();
+
+
+virtual void copy(int w, int h);void draw(int x, int y, int w, int h, int ox = 0, int oy = 0);
+
+void draw(int x, int y)
+
+Offscreen Drawing
+
+Sometimes it can be very useful to generate a complex drawing
+in memory first and copy it to the screen at a later point in
+time. This technique can significantly reduce the amount of
+repeated drawing. Fl_Double_Window uses offscreen rendering
+to avoid flickering on systems that don't support
+double-buffering natively.
+
+Fl_Offscreen fl_create_offscreen(int w, int h)
+
+void fl_delete_offscreen(Fl_Offscreen)
+
+void fl_begin_offscreen(Fl_Offscreen)
+
+void fl_end_offscreen()
+
+void fl_copy_offscreen(int x, int y,
+int w, int h, Fl_Offscreen osrc, int srcx, int srcy)
+
+4 - Designing a Simple Text Editor
+
+Determining the Goals of the Text Editor
+
+
+
+
+
+
+
+Designing the Main Window
+
+
+class EditorWindow : public Fl_Double_Window {
+ public:
+ EditorWindow(int w, int h, const char* t);
+ ~EditorWindow();
+
+ Fl_Window *replace_dlg;
+ Fl_Input *replace_find;
+ Fl_Input *replace_with;
+ Fl_Button *replace_all;
+ Fl_Return_Button *replace_next;
+ Fl_Button *replace_cancel;
+
+ Fl_Text_Editor *editor;
+ char search[256];
+};
+
+
+Variables
+
+
+int changed = 0;
+char filename[256] = "";
+Fl_Text_Buffer *textbuf;
+
+
+Menubars and Menus
+
+
+Fl_Menu_Item menuitems[] = {
+ { "&File", 0, 0, 0, FL_SUBMENU },
+ { "&New File", 0, (Fl_Callback *)new_cb },
+ { "&Open File...", FL_CTRL + 'o', (Fl_Callback *)open_cb },
+ { "&Insert File...", FL_CTRL + 'i', (Fl_Callback *)insert_cb, 0, FL_MENU_DIVIDER },
+ { "&Save File", FL_CTRL + 's', (Fl_Callback *)save_cb },
+ { "Save File &As...", FL_CTRL + FL_SHIFT + 's', (Fl_Callback *)saveas_cb, 0, FL_MENU_DIVIDER },
+ { "New &View", FL_ALT + 'v', (Fl_Callback *)view_cb, 0 },
+ { "&Close View", FL_CTRL + 'w', (Fl_Callback *)close_cb, 0, FL_MENU_DIVIDER },
+ { "E&xit", FL_CTRL + 'q', (Fl_Callback *)quit_cb, 0 },
+ { 0 },
+
+ { "&Edit", 0, 0, 0, FL_SUBMENU },
+ { "&Undo", FL_CTRL + 'z', (Fl_Callback *)undo_cb, 0, FL_MENU_DIVIDER },
+ { "Cu&t", FL_CTRL + 'x', (Fl_Callback *)cut_cb },
+ { "&Copy", FL_CTRL + 'c', (Fl_Callback *)copy_cb },
+ { "&Paste", FL_CTRL + 'v', (Fl_Callback *)paste_cb },
+ { "&Delete", 0, (Fl_Callback *)delete_cb },
+ { 0 },
+
+ { "&Search", 0, 0, 0, FL_SUBMENU },
+ { "&Find...", FL_CTRL + 'f', (Fl_Callback *)find_cb },
+ { "F&ind Again", FL_CTRL + 'g', find2_cb },
+ { "&Replace...", FL_CTRL + 'r', replace_cb },
+ { "Re&place Again", FL_CTRL + 't', replace2_cb },
+ { 0 },
+
+ { 0 }
+};
+
+
+
+Fl_Menu_Bar *m = new Fl_Menu_Bar(0, 0, 640, 30);
+m->copy(menuitems);
+
+
+Editing the Text
+
+
+w->editor = new Fl_Text_Editor(0, 30, 640, 370);
+w->editor->buffer(textbuf);
+
+
+
+textbuf->add_modify_callback(changed_cb, w);
+textbuf->call_modify_callbacks();
+
+
+
+w->editor->textfont(FL_COURIER);
+
+
+The Replace Dialog
+
+
+Figure 4-1: The search and replace dialog.
+Fl_Window *replace_dlg = new Fl_Window(300, 105, "Replace");
+Fl_Input *replace_find = new Fl_Input(70, 10, 200, 25, "Find:");
+Fl_Input *replace_with = new Fl_Input(70, 40, 200, 25, "Replace:");
+Fl_Button *replace_all = new Fl_Button(10, 70, 90, 25, "Replace All");
+Fl_Button *replace_next = new Fl_Button(105, 70, 120, 25, "Replace Next");
+Fl_Button *replace_cancel = new Fl_Button(230, 70, 60, 25, "Cancel");
+
+
+Callbacks
+
+changed_cb()
+
+
+void changed_cb(int, int nInserted, int nDeleted,int, const char*, void* v) {
+ if ((nInserted || nDeleted) && !loading) changed = 1;
+ EditorWindow *w = (EditorWindow *)v;
+ set_title(w);
+ if (loading) w->editor->show_insert_position();
+}
+
+
+copy_cb()
+
+
+void copy_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ Fl_Text_Editor::kf_copy(0, e->editor);
+}
+
+
+cut_cb()
+
+
+void cut_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ Fl_Text_Editor::kf_cut(0, e->editor);
+}
+
+
+delete_cb()
+
+
+void delete_cb(Fl_Widget*, void* v) {
+ textbuf->remove_selection();
+}
+
+
+find_cb()
+
+
+void find_cb(Fl_Widget* w, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ const char *val;
+
+ val = fl_input("Search String:", e->search);
+ if (val != NULL) {
+ // User entered a string - go find it!
+ strcpy(e->search, val);
+ find2_cb(w, v);
+ }
+
+
+find2_cb()
+
+
+void find2_cb(Fl_Widget* w, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ if (e->search[0] == '\0') {
+ // Search string is blank; get a new one...
+ find_cb(w, v);
+ return;
+ }
+
+ int pos = e->editor->insert_position();
+ int found = textbuf->search_forward(pos, e->search, &pos);
+ if (found) {
+ // Found a match; select and update the position...
+ textbuf->select(pos, pos+strlen(e->search));
+ e->editor->insert_position(pos+strlen(e->search));
+ e->editor->show_insert_position();
+ }
+ else fl_alert("No occurrences of \'%s\' found!", e->search);
+}
+
+
+new_cb()
+
+void new_cb(Fl_Widget*, void*) {
+ if (!check_save()) return;
+
+ filename[0] = '\0';
+ textbuf->select(0, textbuf->length());
+ textbuf->remove_selection();
+ changed = 0;
+ textbuf->call_modify_callbacks();
+}
+
+
+open_cb()
+
+
+void open_cb(Fl_Widget*, void*) {
+ if (!check_save()) return;
+
+ char *newfile = fl_file_chooser("Open File?", "*", filename);
+ if (newfile != NULL) load_file(newfile, -1);
+}
+
+
+paste_cb()
+
+
+void paste_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ Fl_Text_Editor::kf_paste(0, e->editor);
+}
+
+
+quit_cb()
+
+
+void quit_cb(Fl_Widget*, void*) {
+ if (changed && !check_save())
+ return;
+
+ exit(0);
+}
+
+
+replace_cb()
+
+
+void replace_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ e->replace_dlg->show();
+}
+
+
+replace2_cb()
+
+
+void replace2_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ const char *find = e->replace_find->value();
+ const char *replace = e->replace_with->value();
+
+ if (find[0] == '\0') {
+ // Search string is blank; get a new one...
+ e->replace_dlg->show();
+ return;
+ }
+
+ e->replace_dlg->hide();
+
+ int pos = e->editor->insert_position();
+ int found = textbuf->search_forward(pos, find, &pos);
+
+ if (found) {
+ // Found a match; update the position and replace text...
+ textbuf->select(pos, pos+strlen(find));
+ textbuf->remove_selection();
+ textbuf->insert(pos, replace);
+ textbuf->select(pos, pos+strlen(replace));
+ e->editor->insert_position(pos+strlen(replace));
+ e->editor->show_insert_position();
+ }
+ else fl_alert("No occurrences of \'%s\' found!", find);
+}
+
+
+replall_cb()
+
+
+void replall_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ const char *find = e->replace_find->value();
+ const char *replace = e->replace_with->value();
+
+ find = e->replace_find->value();
+ if (find[0] == '\0') {
+ // Search string is blank; get a new one...
+ e->replace_dlg->show();
+ return;
+ }
+
+ e->replace_dlg->hide();
+
+ e->editor->insert_position(0);
+ int times = 0;
+
+ // Loop through the whole string
+ for (int found = 1; found;) {
+ int pos = e->editor->insert_position();
+ found = textbuf->search_forward(pos, find, &pos);
+
+ if (found) {
+ // Found a match; update the position and replace text...
+ textbuf->select(pos, pos+strlen(find));
+ textbuf->remove_selection();
+ textbuf->insert(pos, replace);
+ e->editor->insert_position(pos+strlen(replace));
+ e->editor->show_insert_position();
+ times++;
+ }
+ }
+
+ if (times) fl_message("Replaced %d occurrences.", times);
+ else fl_alert("No occurrences of \'%s\' found!", find);
+}
+
+
+replcan_cb()
+
+
+void replcan_cb(Fl_Widget*, void* v) {
+ EditorWindow* e = (EditorWindow*)v;
+ e->replace_dlg->hide();
+}
+
+
+save_cb()
+
+
+void save_cb(void) {
+ if (filename[0] == '\0') {
+ // No filename - get one!
+ saveas_cb();
+ return;
+ }
+ else save_file(filename);
+}
+
+
+saveas_cb()
+
+
+void saveas_cb(void) {
+ char *newfile;
+
+ newfile = fl_file_chooser("Save File As?", "*", filename);
+ if (newfile != NULL) save_file(newfile);
+}
+
+
+Other Functions
+
+check_save()
+
+
+int check_save(void) {
+ if (!changed) return 1;
+
+ int r = fl_choice("The current file has not been saved.\n"
+ "Would you like to save it now?",
+ "Cancel", "Save", "Discard");
+
+ if (r == 1) {
+ save_cb(); // Save the file...
+ return !changed;
+ }
+
+ return (r == 2) ? 1 : 0;
+}
+
+
+load_file()
+
+
+int loading = 0;
+void load_file(char *newfile, int ipos) {
+ loading = 1;
+ int insert = (ipos != -1);
+ changed = insert;
+ if (!insert) strcpy(filename, "");
+ int r;
+ if (!insert) r = textbuf->loadfile(newfile);
+ else r = textbuf->insertfile(newfile, ipos);
+ if (r)
+ fl_alert("Error reading from file \'%s\':\n%s.", newfile, strerror(errno));
+ else
+ if (!insert) strcpy(filename, newfile);
+ loading = 0;
+ textbuf->call_modify_callbacks();
+}
+
+
+save_file()
+
+
+void save_file(char *newfile) {
+ if (textbuf->savefile(newfile))
+ fl_alert("Error writing to file \'%s\':\n%s.", newfile, strerror(errno));
+ else
+ strcpy(filename, newfile);
+ changed = 0;
+ textbuf->call_modify_callbacks();
+}
+
+
+set_title()
+
+
+void set_title(Fl_Window* w) {
+ if (filename[0] == '\0') strcpy(title, "Untitled");
+ else {
+ char *slash;
+ slash = strrchr(filename, '/');
+#ifdef WIN32
+ if (slash == NULL) slash = strrchr(filename, '\\');
+#endif
+ if (slash != NULL) strcpy(title, slash + 1);
+ else strcpy(title, filename);
+ }
+
+ if (changed) strcat(title, " (modified)");
+
+ w->label(title);
+}
+
+
+The main() Function
+
+
+int main(int argc, char **argv) {
+ textbuf = new Fl_Text_Buffer;
+
+ Fl_Window* window = new_view();
+
+ window->show(1, argv);
+
+ if (argc > 1) load_file(argv[1], -1);
+
+ return Fl::run();
+}
+
+
+Compiling the Editor
+
+
+CC -o editor editor.cxx -lfltk -lXext -lX11 -lm
+
+
+
+fltk-config --compile editor.cxx
+
+
+The Final Product
+
+The final editor window should look like the image in Figure 4-2.
+
+
+Figure 4-2: The completed editor windowAdvanced Features
+
+Fl_Text_Editor widget.
+
+Syntax Highlighting
+
+Fl_Text_Editor widget supports highlighting
+of text with different fonts, colors, and sizes. The
+implementation is based on the excellent NEdit text editor core, which
+uses a parallel "style" buffer which tracks the font, color, and
+size of the text that is drawn.
+
+Fl_Text_Display::Style_Table_Entry structure
+defined in <FL/Fl_Text_Display.H>:
+
+
+struct Style_Table_Entry {
+ Fl_Color color;
+ Fl_Font font;
+ int size;
+ unsigned attr;
+};
+
+
+color member sets the color for the text,
+the font member sets the FLTK font index to use,
+and the size member sets the pixel size of the
+text. The attr member is currently not used.
+
+
+Fl_Text_Display::Style_Table_Entry styletable[] = { // Style table
+ { FL_BLACK, FL_COURIER, FL_NORMAL_SIZE }, // A - Plain
+ { FL_DARK_GREEN, FL_COURIER_ITALIC, FL_NORMAL_SIZE }, // B - Line comments
+ { FL_DARK_GREEN, FL_COURIER_ITALIC, FL_NORMAL_SIZE }, // C - Block comments
+ { FL_BLUE, FL_COURIER, FL_NORMAL_SIZE }, // D - Strings
+ { FL_DARK_RED, FL_COURIER, FL_NORMAL_SIZE }, // E - Directives
+ { FL_DARK_RED, FL_COURIER_BOLD, FL_NORMAL_SIZE }, // F - Types
+ { FL_BLUE, FL_COURIER_BOLD, FL_NORMAL_SIZE } // G - Keywords
+};
+
+
+highlight_data() method to associate the
+style data and buffer with the text editor widget:
+
+
+Fl_Text_Buffer *stylebuf;
+
+w->editor->highlight_data(stylebuf, styletable,
+ sizeof(styletable) / sizeof(styletable[0]),
+ 'A', style_unfinished_cb, 0);
+
+
+
+textbuf->add_modify_callback(style_update, w->editor);
+
+
+style_update() function, like the change_cb()
+function described earlier, is called whenever text is added or removed from
+the text buffer. It mirrors the changes in the style buffer and then updates
+the style data as necessary:
+
+
+//
+// 'style_update()' - Update the style buffer...
+//
+
+void
+style_update(int pos, // I - Position of update
+ int nInserted, // I - Number of inserted chars
+ int nDeleted, // I - Number of deleted chars
+ int nRestyled, // I - Number of restyled chars
+ const char *deletedText, // I - Text that was deleted
+ void *cbArg) { // I - Callback data
+ int start, // Start of text
+ end; // End of text
+ char last, // Last style on line
+ *style, // Style data
+ *text; // Text data
+
+
+ // If this is just a selection change, just unselect the style buffer...
+ if (nInserted == 0 && nDeleted == 0) {
+ stylebuf->unselect();
+ return;
+ }
+
+ // Track changes in the text buffer...
+ if (nInserted > 0) {
+ // Insert characters into the style buffer...
+ style = new char[nInserted + 1];
+ memset(style, 'A', nInserted);
+ style[nInserted] = '\0';
+
+ stylebuf->replace(pos, pos + nDeleted, style);
+ delete[] style;
+ } else {
+ // Just delete characters in the style buffer...
+ stylebuf->remove(pos, pos + nDeleted);
+ }
+
+ // Select the area that was just updated to avoid unnecessary
+ // callbacks...
+ stylebuf->select(pos, pos + nInserted - nDeleted);
+
+ // Re-parse the changed region; we do this by parsing from the
+ // beginning of the line of the changed region to the end of
+ // the line of the changed region... Then we check the last
+ // style character and keep updating if we have a multi-line
+ // comment character...
+ start = textbuf->line_start(pos);
+ end = textbuf->line_end(pos + nInserted - nDeleted);
+ text = textbuf->text_range(start, end);
+ style = stylebuf->text_range(start, end);
+ last = style[end - start - 1];
+
+ style_parse(text, style, end - start);
+
+ stylebuf->replace(start, end, style);
+ ((Fl_Text_Editor *)cbArg)->redisplay_range(start, end);
+
+ if (last != style[end - start - 1]) {
+ // The last character on the line changed styles, so reparse the
+ // remainder of the buffer...
+ free(text);
+ free(style);
+
+ end = textbuf->length();
+ text = textbuf->text_range(start, end);
+ style = stylebuf->text_range(start, end);
+
+ style_parse(text, style, end - start);
+
+ stylebuf->replace(start, end, style);
+ ((Fl_Text_Editor *)cbArg)->redisplay_range(start, end);
+ }
+
+ free(text);
+ free(style);
+}
+
+
+style_parse() function scans a copy of the
+text in the buffer and generates the necessary style characters
+for display. It assumes that parsing begins at the start of a line:
+
+
+//
+// 'style_parse()' - Parse text and produce style data.
+//
+
+void
+style_parse(const char *text,
+ char *style,
+ int length) {
+ char current;
+ int col;
+ int last;
+ char buf[255],
+ *bufptr;
+ const char *temp;
+
+ for (current = *style, col = 0, last = 0; length > 0; length --, text ++) {
+ if (current == 'A') {
+ // Check for directives, comments, strings, and keywords...
+ if (col == 0 && *text == '#') {
+ // Set style to directive
+ current = 'E';
+ } else if (strncmp(text, "//", 2) == 0) {
+ current = 'B';
+ } else if (strncmp(text, "/*", 2) == 0) {
+ current = 'C';
+ } else if (strncmp(text, "\\\"", 2) == 0) {
+ // Quoted quote...
+ *style++ = current;
+ *style++ = current;
+ text ++;
+ length --;
+ col += 2;
+ continue;
+ } else if (*text == '\"') {
+ current = 'D';
+ } else if (!last && islower(*text)) {
+ // Might be a keyword...
+ for (temp = text, bufptr = buf;
+ islower(*temp) && bufptr < (buf + sizeof(buf) - 1);
+ *bufptr++ = *temp++);
+
+ if (!islower(*temp)) {
+ *bufptr = '\0';
+
+ bufptr = buf;
+
+ if (bsearch(&bufptr, code_types,
+ sizeof(code_types) / sizeof(code_types[0]),
+ sizeof(code_types[0]), compare_keywords)) {
+ while (text < temp) {
+ *style++ = 'F';
+ text ++;
+ length --;
+ col ++;
+ }
+
+ text --;
+ length ++;
+ last = 1;
+ continue;
+ } else if (bsearch(&bufptr, code_keywords,
+ sizeof(code_keywords) / sizeof(code_keywords[0]),
+ sizeof(code_keywords[0]), compare_keywords)) {
+ while (text < temp) {
+ *style++ = 'G';
+ text ++;
+ length --;
+ col ++;
+ }
+
+ text --;
+ length ++;
+ last = 1;
+ continue;
+ }
+ }
+ }
+ } else if (current == 'C' && strncmp(text, "*/", 2) == 0) {
+ // Close a C comment...
+ *style++ = current;
+ *style++ = current;
+ text ++;
+ length --;
+ current = 'A';
+ col += 2;
+ continue;
+ } else if (current == 'D') {
+ // Continuing in string...
+ if (strncmp(text, "\\\"", 2) == 0) {
+ // Quoted end quote...
+ *style++ = current;
+ *style++ = current;
+ text ++;
+ length --;
+ col += 2;
+ continue;
+ } else if (*text == '\"') {
+ // End quote...
+ *style++ = current;
+ col ++;
+ current = 'A';
+ continue;
+ }
+ }
+
+ // Copy style info...
+ if (current == 'A' && (*text == '{' || *text == '}')) *style++ = 'G';
+ else *style++ = current;
+ col ++;
+
+ last = isalnum(*text) || *text == '.';
+
+ if (*text == '\n') {
+ // Reset column and possibly reset the style
+ col = 0;
+ if (current == 'B' || current == 'E') current = 'A';
+ }
+ }
+}
+
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/enumerations.html b/third_party/windows/fltk-1.1.10/documentation/enumerations.html
new file mode 100644
index 0000000..f84230f
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/enumerations.html
@@ -0,0 +1,306 @@
+
+
+ C - FLTK Enumerations
+
+Version Numbers
+ The FLTK version number is stored in a number of compile-time
+constants:
+
+
+Events
+ Events are identified by an Fl_Event enumeration value. The
+following events are currently defined:
+
+
+Callback "When" Conditions
+ The following constants determine when a callback is performed:
+
+
+Fl::event_button() Values
+
+
+
+
+Fl::event_key() Values
+ The following constants define the non-ASCII keys on the keyboard for
+FL_KEYBOARD and FL_SHORTCUT events:
+
+
+Fl::event_state() Values
+ The following constants define bits in the Fl::event_state()
+ value:
+
+
+
+Alignment Values
+ The following constants define bits that can be used with
+Fl_Widget::align() to control the positioning of the
+label:
+
+
+Fonts
+ The following constants define the standard FLTK fonts:
+
+
+
+Colors
+
+Color Constants
+
+
+
+
+
+
+
+
+
+Cursors
+
+
+
+
+
+FD "When" Conditions
+
+
+
+
+
+Damage Masks
+ The following damage mask bits are used by the standard FLTK widgets:
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/events.html b/third_party/windows/fltk-1.1.10/documentation/events.html
new file mode 100644
index 0000000..5fac10b
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/events.html
@@ -0,0 +1,394 @@
+
+
+ 6 - Handling Events
+
+The FLTK Event Model
+
+Mouse Events
+
+FL_PUSH
+
+FL_DRAG
+
+FL_RELEASE
+
+FL_MOVE
+
+FL_MOUSEWHEEL
+
+Focus Events
+
+FL_ENTER
+
+FL_LEAVE
+
+FL_FOCUS
+
+FL_UNFOCUS
+
+Keyboard Events
+
+FL_KEYDOWN, FL_KEYUP
+
+FL_KEYBOARD events you must also
+respond to the FL_FOCUS and FL_UNFOCUS
+events.
+
+FL_KEYUP events are sent to the widget that
+currently has focus. This is not necessarily the same widget
+that received the corresponding FL_KEYDOWN event
+because focus may have changed between events.
+
+FL_SHORTCUT
+
+Widget Events
+
+FL_DEACTIVATE
+
+FL_ACTIVATE
+
+FL_HIDE
+
+FL_SHOW
+
+Clipboard Events
+
+FL_PASTE
+
+FL_SELECTIONCLEAR
+
+Drag And Drop Events
+
+FL_DND_ENTER
+
+FL_DND_DRAG
+
+FL_DND_LEAVE
+
+FL_DND_RELEASE
+
+Fl::event_*() methods
+
+
+
+
+
+Event Propagation
+
+
+
+
+
+FLTK Compose-Character Sequences
+
+
+
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/examples.html b/third_party/windows/fltk-1.1.10/documentation/examples.html
new file mode 100644
index 0000000..a748a4c
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/examples.html
@@ -0,0 +1,453 @@
+
+
+ I - Tests and Demo Source Code
+
+
+
+
+Example Applications
+
+
+adjuster
+arc
+ask
+bitmap
+blocks
+boxtype
+
+
+browser
+button
+buttons
+checkers
+clock
+colbrowser
+
+
+color_chooser
+cube
+CubeView
+cursor
+curve
+demo
+
+
+doublebuffer
+editor
+fast_slow
+file_chooser
+fluid
+fonts
+
+
+forms
+fractals
+fullscreen
+gl_overlay
+glpuzzle
+hello
+
+
+help
+iconize
+image
+inactive
+input
+input_choice
+
+
+keyboard
+label
+line_style
+list_visuals
+mandelbrot
+menubar
+
+
+message
+minimum
+navigation
+output
+overlay
+pack
+
+
+pixmap_browser
+pixmap
+preferences
+radio
+resizebox
+resize
+
+
+scroll
+shape
+subwindow
+sudoku
+symbols
+tabs
+
+
+threads
+tile
+tiled_image
+valuators
+adjuster
+adjuster shows a nifty little widget for quickly
+setting values in a great range.
+
+arc
+The arc demo explains how to derive your own widget to
+generate some custom drawings. The sample drawings use the matrix
+based arc drawing for some fun effects.
+
+ask
+ask shows some of FLTK's standard dialog boxes. Click
+the correct answers or you may end up in a loop, or you may end
+up in a loop, or you... .
+
+bitmap
+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'
+file format and can be part of the source code.
+
+blocks
+A wonderful and addictive game that shows the usage of FLTK
+timers, graphics, and how to implement sound on all platforms.
+blocks is also a good example for the Mac OS X specific
+bundle format.
+
+boxtype
+boxtype gives an overview of readily available boxes and
+frames in FLTK. More types can be added by the application programmer.
+When using themes, FLTK shuffles boxtypes around to give your program
+a new look.
+
+browser
+browser shows the capabilities of the Fl_Browser widget.
+Important features tested are loading of files, line formatting, and
+correct positioning of the browser data window.
+
+button
+The button test is a simple demo of push-buttons and callbacks.
+
+buttons
+buttons shows a sample of FLTK button types.
+
+checkers
+Written by Steve Poulsen in early 1979, checkers shows
+how to convert a VT100 text-terminal based program into a neat
+application with a graphical UI. Check out the code that drags the
+pieces, and how the pieces are drawn by layering. Then tell me
+how to beat the computer at Checkers.
+
+clock
+The clock demo shows two analog clocks. The innards of
+the Fl_Clock widget are pretty interesting, explaining
+the use of timeouts and matrix based drawing.
+
+colbrowser
+colbrowser runs only on X11 systems. It reads
+/usr/lib/X11/rgb.txt to show the color representation
+of every text entry in the file. This is beautiful, but
+only moderately useful unless your UI is written in Motif.
+
+color_chooser
+The color_chooser gives a short demo of FLTK's palette based
+color chooser and of the RGB based color wheel.
+
+cube
+The cube demo shows the speed of OpenGL. It also tests
+the ability to render two OpenGL buffers into a single window,
+and shows OpenGL text.
+
+CubeView
+CubeView shows how to create a UI containing OpenGL with Fluid.
+
+cursor
+The cursor demo shows all mouse cursor shapes that come standard
+with FLTK. The fgcolor and bgcolor sliders work only
+on few systems (some version of Irix for example).
+
+curve
+curve draws a nice Bezier curve into a custom widget. The
+points option for splines is not supported on all platforms.
+
+demo
+This tool allows quick access to all programs in the test directory.
+demo is based on the visuals of the IrixGL demo program. The menu
+tree can be changed by editing test/demo.menu.
+
+doublebuffer
+The doublebuffer demo shows the difference between a single
+buffered window, which may flicker during a slow redraw, and a
+double buffered window, which never flickers, but uses twice the
+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 not tripple buffer a window in that case.
+
+editor
+FLTK has two very different text input widgets. Fl_Input
+and derived classes are rather leight weight, however
+Fl_Text_Editor is a complete port of nedit (with permission).
+The editor test is almost a full application, showing custom
+syntax highlighting and dialog creation.
+
+fast_slow
+fast_slow shows how an application can use the when()
+setting to receive different kinds of callbacks.
+
+file_chooser
+The standard FLTK file_chooser is the result of many
+iterations, trying to find a middle ground between a complex
+browser and a fast light implementation.
+
+fonts
+fonts shows all available text fonts on the host system.
+If your machine still has some pixmap based fonts, the supported
+sizes will be shown in bold face. Only the first 256 fonts will
+be listed.
+
+forms
+forms is an XForms program with very few changes.
+Search for "fltk" to find all changes necessary to port to fltk.
+This demo shows the different boxtypes. Note that some
+boxtypes are not appropriate for some objects.
+
+fractals
+fractals shows how to mix OpenGL, Glut and FLTK code.
+FLTK supports a rather large subset of Glut, so that many Glut
+applications compile just fine.
+
+fullscreen
+This demo shows how to do many of the window manipulations that
+are popular for games.
+You can toggle the border on/off, switch between single-
+and double-buffered rendering, and take over the entire
+screen. More information in the source code.
+
+gl_overlay
+gl_overlay shows OpenGL overlay plane rendering. If no
+hardware overlay plane is available, FLTK will simulate it
+for you.
+
+glpuzzle
+The glpuzzle test shows how most Glut source code compiles
+easily under FLTK.
+
+hello
+hello: Hello, World. Need I say more? Well, maybe. This
+tiny demo shows how little is needed to get a functioning application
+running with FLTK. Quite impressive, I'd say.
+
+help
+help displays the built-in FLTK help browser. The
+Fl_Help_Dialog understands a subset of html and renders
+various image formats. This widget makes it easy to provide help
+pages to the user without depending on the operating system's
+html browser.
+
+iconize
+iconize demonstrates the effect of the window functions
+hide(), iconize(), and show().
+
+image
+The image demo shows how an image can be created on the fly.
+This generated image contains an alpha (transparency) channel which
+lets previous renderings 'shine through', either via true
+transparency or by using screen door transparency (pixelation).
+
+inactive
+inactive tests the correct rendering of inactive widgets.
+To see the inactive version of images, you can check out the pixmap
+or image test.
+
+input
+This tool shows and tests different types of text input fields based on
+Fl_Input_. The input program also tests various
+settings of Fl_Input::when().
+
+input_choice
+input_choice tests the latest addition to FLTK1, a text input
+field with an attached pulldown menu. Windows users will recognize
+similarities to the 'ComboBox'. input_choice starts up in
+'plastic' scheme, but the traditional scheme is also supported.
+
+keyboard
+FLTK unifies keyboard events for all platforms. The keyboard
+test can be used to check the return values of Fl::event_key()
+and Fl::event_text(). It is also great to see the modifier
+buttons and the scroll wheel at work. Quit this application by closing
+the window. The ESC key will not work.
+
+label
+Every FLTK widget can have a label attached to it. The label
+demo shows alignment, clipping, and wrapping of text labels. Labels
+can contain symbols at the start and end of the text, like @FLTK
+or @circle uh-huh @square.
+
+line_style
+Advanced line drawing can be tested with line_style.
+Not all platforms support all line styles.
+
+list_visuals
+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
+about any of this.
+
+mandelbrot
+mandelbrot shows two advanced topics in one test. It creates
+grayscale images on the fly, updating them via the idle callback
+system. This is one of the few occasions where the idle callback
+is very useful by giving all available processor time to the application
+without blocking the UI or other apps.
+
+menubar
+The menubar tests many aspects of FLTK's popup menu system.
+Among the features are radio buttons, menus taller than the screen,
+arbitrary sub menu depth, and global shortcuts.
+
+message
+message pops up a few of FLTK's standard message boxes.
+
+minimum
+The minimum test program verifies that the update regions
+are set correctly. In a real life application, the trail would
+be avoided by choosing a smaller label or by setting label clipping
+differently.
+
+navigation
+navigation demonstrates how the text cursor moves from
+text field to text field when using the arrow keys, tab, and shift-tab.
+
+output
+output shows the difference between the single line and
+multi line mode of the Fl_Output widget. Fonts can be
+selected from the FLTK standard list of fonts.
+
+overlay
+The overlay test app shows how easy an FLTK window can
+be layered to display cursor and manipulator style elements. This
+example derives a new class from Fl_Overlay_Window and
+provides a new function to draw custom overlays.
+
+pack
+The pack test program demonstrates the resizing
+and repositioning of children of the Fl_Pack group.
+Putting an Fl_Pack into an Fl_Scroll is
+a useful way to create a browser for large sets of data.
+
+pixmap_browser
+pixmap_browser tests the shared-image interface. When using
+the same image multiple times, Fl_Shared_Image will keep it
+only once in memory.
+
+pixmap
+This simple test shows the use of a LUT based pixmap as a
+label for a box widget. Pixmaps are stored in the X11 '.xpm'
+file format and can be part of the source code. Pixmaps support
+one transparent color.
+
+preferences
+I do have my preferences in the morning, but sometimes I
+just can't remember a thing. This is where the Fl_Preferences
+come in handy. They remember any kind of data between program launches.
+
+radio
+The radio tool was created entirely with fluid. It
+shows some of the available button types and tests radio
+button behavior.
+
+resizebox
+resizebox shows some possible ways of FLTK's automatic
+resize behavior.
+
+resize
+The resize demo tests size and position functions with
+the given window manager.
+
+scroll
+scroll shows how to scroll an area of widgets, one of
+them being a slow custom drawing. Fl_Scroll uses
+clipping and smart window area copying to improve redraw speed.
+The buttons at the bottom of the window control decoration rendering
+and updates.
+
+shape
+shape is a very minimal demo that shows how to create
+your own OpenGL rendering widget. Now that you know that, go ahead
+and write that flight simulator you always dreamt of.
+
+subwindow
+The subwindow demo tests messaging and drawing between
+the main window and 'true' sub windows. A sub window is different
+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
+operating system specific handle.
+
+sudoku
+Another highly addictive game - don't play it, I warned you.
+The implementation shows how to create application icons,
+how to deal with OS specifics, and how to generate sound.
+
+symbols
+symbols are a speciality of FLTK. These little vector
+drawings can be integrated into labels. They scale and rotate,
+and with a little patience, you can define your own. The rotation
+number refers to 45 degree rotations if you were looking at a
+numeric keypad (2 is down, 6 is right, etc.).
+
+tabs
+The tabs tool was created with fluid. It tests
+correct hiding and redisplaying of tabs, navigation across tabs,
+resize behavior, and no unneeded redrawing of invisible widgets.
+
+threads
+FLTK can be used in a multithreading environment. There are some
+limitations, mostly due to the underlying operating system.
+threads shows how to use Fl::lock(),
+Fl::unlock(), and Fl::awake() in secondary threads
+to keep FLTK happy. Although locking works on all platforms,
+this demo is not available on every machine.
+
+tile
+The tile tool shows a nice way of using Fl_Tile.
+To test correct resizing of subwindows, the widget for region
+1 is created from an Fl_Window class.
+
+tiled_image
+The tiled_image demo uses an image as the background
+for a window by repeating it over the full size of the widget.
+The window is resizable and shows how the image gets repeated.
+
+valuators
+valuators shows all of FLTK's nifty widgets to change
+numeric values.
+
+fluid
+fluid is not only a big test program, but also a very
+useful visual UI designer. Many parts of fluid were
+created using fluid.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_alert.gif b/third_party/windows/fltk-1.1.10/documentation/fl_alert.gif
new file mode 100644
index 0000000..be008e3
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_alert.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_ask.gif b/third_party/windows/fltk-1.1.10/documentation/fl_ask.gif
new file mode 100644
index 0000000..00a9fbb
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_ask.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_choice.gif b/third_party/windows/fltk-1.1.10/documentation/fl_choice.gif
new file mode 100644
index 0000000..940b22c
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_choice.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_color_chooser.jpg b/third_party/windows/fltk-1.1.10/documentation/fl_color_chooser.jpg
new file mode 100644
index 0000000..55dd82f
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_color_chooser.jpg differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_input.gif b/third_party/windows/fltk-1.1.10/documentation/fl_input.gif
new file mode 100644
index 0000000..63dc51c
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_input.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_message.gif b/third_party/windows/fltk-1.1.10/documentation/fl_message.gif
new file mode 100644
index 0000000..7780206
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_message.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_password.gif b/third_party/windows/fltk-1.1.10/documentation/fl_password.gif
new file mode 100644
index 0000000..0523b57
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_password.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fl_show_colormap.gif b/third_party/windows/fltk-1.1.10/documentation/fl_show_colormap.gif
new file mode 100644
index 0000000..5c3b351
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fl_show_colormap.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fltk-config.man b/third_party/windows/fltk-1.1.10/documentation/fltk-config.man
new file mode 100644
index 0000000..168cb5e
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/fltk-config.man
@@ -0,0 +1,90 @@
+.TH fltk\-config 1 "Fast Light Tool Kit" "6 February 2007"
+.SH NAME
+fltk\-config \- script to get information about the installed version of fltk.
+.sp
+.SH SYNOPSIS
+fltk\-config [ \-\-prefix
+.I [=DIR]
+] [ \-\-exec\-prefix
+.I [=DIR]
+] [ \-\-version ] [ \-\-api\-version ] [ \-\-use\-gl ] [ \-\-use\-images ]
+[ \-\-use\-glut ]
+[ \-\-cc ] [ \-\-cxx ]
+[ \-\-cflags ] [ \-\-cxxflags ] [ \-\-ldflags ] [ \-\-ldstaticflags ]
+[ \-\-libs ]
+[ \-D\fIname[=value]\fR ] [ \-g ] [ \-\-compile
+.I program.cxx
+]
+.SH DESCRIPTION
+\fIfltk\-config\fR is a utility script that can be used to get information
+about the current version of FLTK that is installed on the system, what
+compiler and linker options to use when building FLTK-based applications,
+and to build simple FLTK applications.
+.LP
+The following options are supported:
+.TP 5
+\-\-api\-version
+.br
+Displays the current FLTK API version number, e.g. "1.1".
+.TP 5
+\-\-cc
+.TP 5
+\-\-cxx
+.br
+Displays the C/C++ compiler that was used to compile FLTK.
+.TP 5
+\-\-cflags
+.TP 5
+\-\-cxxflags
+.br
+Displays the C/C++ compiler options to use when compiling source
+files that use FLTK.
+.TP 5
+\-\-compile \fIprogram.cxx\fR
+.br
+Compiles the source file \fIprogram.cxx\fR into \fIprogram\fR.
+This option implies "\-\-post \fIprogram\fR".
+.TP 5
+\-g
+.br
+Enables debugging information when compiling with the \fI\-\-compile\fR
+option.
+.TP 5
+\-\-ldflags
+.br
+Displays the linker options to use when linking a FLTK
+application.
+.TP 5
+\-\-ldstaticflags
+.br
+Displays the linker options to use when linking a FLTK
+application to the static FLTK libraries.
+.TP 5
+\-\-libs
+.br
+Displays the full path to the FLTK library files, to be used for
+dependency checking.
+.TP 5
+\-\-use\-gl
+.br
+Enables OpenGL support.
+.TP 5
+\-\-use\-glut
+.br
+Enables GLUT support.
+.TP 5
+\-\-use\-images
+.br
+Enables image file support.
+.TP 5
+\-\-version
+.br
+Displays the current FLTK version number, e.g. "1.1.0".
+.SH SEE ALSO
+fluid(1), fltk(3)
+.br
+FLTK Programming Manual
+.br
+FLTK Web Site, http://www.fltk.org/
+.SH AUTHORS
+Bill Spitzak and others.
diff --git a/third_party/windows/fltk-1.1.10/documentation/fltk.book b/third_party/windows/fltk-1.1.10/documentation/fltk.book
new file mode 100644
index 0000000..2a46680
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/fltk.book
@@ -0,0 +1,108 @@
+#HTMLDOC 1.8.27.1
+-t pdf13 -f "fltk.pdf" --book --toclevels 2 --no-numbered --toctitle "Table of Contents" --title --titleimage "FL.gif" --linkstyle underline --size Universal --left 1.00in --right 0.50in --top 0.50in --bottom 0.50in --header .t. --header1 ... --footer h.1 --nup 1 --tocheader .t. --tocfooter ..i --duplex --portrait --color --no-pscommands --no-xrxcomments --compression=9 --jpeg=50 --fontsize 11.0 --fontspacing 1.2 --headingfont Helvetica --bodyfont Times --headfootsize 11.0 --headfootfont Helvetica --charset iso-8859-1 --links --no-embedfonts --pagemode outline --pagelayout single --firstpage c1 --pageeffect none --pageduration 10 --effectduration 1.0 --no-encryption --permissions all --owner-password "" --user-password "" --browserwidth 680 --strict --no-overflow
+preface.html
+intro.html
+basics.html
+common.html
+editor.html
+drawing.html
+events.html
+subclassing.html
+opengl.html
+fluid.html
+widgets.html
+advanced.html
+Fl.html
+Fl_Adjuster.html
+Fl_Bitmap.html
+Fl_BMP_Image.html
+Fl_Box.html
+Fl_Browser_.html
+Fl_Browser.html
+Fl_Button.html
+Fl_Chart.html
+Fl_Check_Browser.html
+Fl_Check_Button.html
+Fl_Choice.html
+Fl_Clock.html
+Fl_Clock_Output.html
+Fl_Color_Chooser.html
+Fl_Counter.html
+Fl_Dial.html
+Fl_Double_Window.html
+Fl_End.html
+Fl_File_Browser.html
+Fl_File_Chooser.html
+Fl_File_Icon.html
+Fl_File_Input.html
+Fl_Float_Input.html
+Fl_Free.html
+Fl_GIF_Image.html
+Fl_Gl_Window.html
+Fl_Group.html
+Fl_Help_Dialog.html
+Fl_Help_View.html
+Fl_Hold_Browser.html
+Fl_Image.html
+Fl_Input.html
+Fl_Input_.html
+Fl_Input_Choice.html
+Fl_Int_Input.html
+Fl_JPEG_Image.html
+Fl_Light_Button.html
+Fl_Menu_.html
+Fl_Menu_Bar.html
+Fl_Menu_Button.html
+Fl_Menu_Item.html
+Fl_Menu_Window.html
+Fl_Multi_Browser.html
+Fl_Multiline_Input.html
+Fl_Multiline_Output.html
+Fl_Output.html
+Fl_Overlay_Window.html
+Fl_Pack.html
+Fl_Pixmap.html
+Fl_PNG_Image.html
+Fl_PNM_Image.html
+Fl_Positioner.html
+Fl_Preferences.html
+Fl_Progress.html
+Fl_Repeat_Button.html
+Fl_RGB_Image.html
+Fl_Return_Button.html
+Fl_Roller.html
+Fl_Round_Button.html
+Fl_Scroll.html
+Fl_Scrollbar.html
+Fl_Secret_Input.html
+Fl_Select_Browser.html
+Fl_Shared_Image.html
+Fl_Single_Window.html
+Fl_Slider.html
+Fl_Spinner.html
+Fl_Tabs.html
+Fl_Text_Buffer.html
+Fl_Text_Display.html
+Fl_Text_Editor.html
+Fl_Tile.html
+Fl_Tiled_Image.html
+Fl_Timer.html
+Fl_Toggle_Button.html
+Fl_Tooltip.html
+Fl_Valuator.html
+Fl_Value_Input.html
+Fl_Value_Output.html
+Fl_Value_Slider.html
+Fl_Widget.html
+Fl_Window.html
+Fl_Wizard.html
+Fl_XBM_Image.html
+Fl_XPM_Image.html
+functions.html
+enumerations.html
+glut.html
+forms.html
+osissues.html
+migration.html
+license.html
+examples.html
diff --git a/third_party/windows/fltk-1.1.10/documentation/fltk.man b/third_party/windows/fltk-1.1.10/documentation/fltk.man
new file mode 100644
index 0000000..c7c8846
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/fltk.man
@@ -0,0 +1,55 @@
+.TH fltk 3 "Fast Light Tool Kit" "6 January 2002"
+.SH NAME
+fltk \- the fast light tool kit
+.sp
+.SH SYNOPSIS
+The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a
+C++ graphical user interface toolkit for the X Window
+System, MacOS(r), and Microsoft Windows(r) that supports OpenGL(r).
+It was originally developed by Mr. Bill Spitzak and is currently
+maintained by a small group of developers across the world with
+a central repository in the US.
+.LP
+FLTK is provides under the terms of the GNU Library General Public License,
+with the following exceptions:
+.IP
+1. Modifications to the FLTK configure script, config header
+file, and makefiles by themselves to support a specific platform
+do not constitute a modified or derivative work.
+.IP
+The authors do request that such modifications be
+contributed to the FLTK project - send all
+contributions to "fltk\-bugs@fltk.org".
+.IP
+2. Widgets that are subclassed from FLTK widgets do not
+constitute a derivative work.
+.IP
+3. Static linking of applications and widgets to the FLTK
+library does not constitute a derivative work and does not
+require the author to provide source code for the application or
+widget, use the shared FLTK libraries, or link their
+applications or widgets against a user-supplied version of FLTK.
+.IP
+If you link the application or widget to a modified version of
+FLTK, then the changes to FLTK must be provided under the terms
+of the LGPL in sections 1, 2, and 4.
+.IP
+4. You do not have to provide a copy of the FLTK license with
+programs that are linked to the FLTK library, nor do you have to
+identify the FLTK license in your program or documentation as
+required by section 6 of the LGPL.
+.IP
+However, programs must still identify their use of FLTK. The
+following example statement can be included in user
+documentation to satisfy this requirement:
+.IP
+[program/widget] is based in part on the work of the FLTK
+project (http://www.fltk.org).
+.SH SEE ALSO
+fltk\-config(1), fluid(1)
+.br
+FLTK Programming Manual
+.br
+FLTK Web Site, http://www.fltk.org/
+.SH AUTHORS
+Bill Spitzak and others.
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid-catgets.gif b/third_party/windows/fltk-1.1.10/documentation/fluid-catgets.gif
new file mode 100644
index 0000000..d81b200
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid-catgets.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid-gettext.gif b/third_party/windows/fltk-1.1.10/documentation/fluid-gettext.gif
new file mode 100644
index 0000000..db16081
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid-gettext.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid-org.gif b/third_party/windows/fltk-1.1.10/documentation/fluid-org.gif
new file mode 100644
index 0000000..e6e2ff6
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid-org.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid.html b/third_party/windows/fltk-1.1.10/documentation/fluid.html
new file mode 100644
index 0000000..5d891a5
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/fluid.html
@@ -0,0 +1,1363 @@
+
+
+ 9 - Programming with FLUID
+
+
The Fast Light User Interface Designer, or FLUID, is a +graphical editor that is used to produce FLTK source code. FLUID +edits and saves its state in .fl files. These files +are text, and you can (with care) edit them in a text editor, +perhaps to get some special effects.
+ +FLUID can "compile" the .fl file into a +.cxx and a .h file. The .cxx file +defines all the objects from the .fl file and the +.h file declares all the global ones. FLUID also +supports localization (Internationalization) +of label strings using message files and the GNU gettext or +POSIX catgets interfaces. + +
A simple program can be made by putting all your code (including a +main() function) into the .fl file and thus making the .cxx file a +single source file to compile. Most programs are more complex than +this, so you write other .cxx files that call the FLUID functions. +These .cxx files must #include the .h file or they can +#include the .cxx file so it still appears to be a single source +file. + +

+Figure 9-1: FLUID organization.
Normally the FLUID file defines one or more functions or classes which +output C++ code. Each function defines a one or more FLTK +windows, and all the widgets that go inside those windows.
+Widgets created by FLUID are either "named", "complex named" or +"unnamed". A named widget has a legal C++ variable identifier as its +name (i.e. only alphanumeric and underscore). In this case FLUID +defines a global variable or class member that will point at the widget +after the function defining it is called. A complex named object has +punctuation such as '.' or '->' or any other symbols in its name. In +this case FLUID assigns a pointer to the widget to the name, but does +not attempt to declare it. This can be used to get the widgets into +structures. An unnamed widget has a blank name and no pointer is stored.
+Widgets may either call a named callback function that you write in +another source file, or you can supply a small piece of C++ source and +FLUID will write a private callback function into the .cxx file.
++fluid filename.fl &+ +to edit the .fl file filename.fl. If the file does not exist +you will get an error pop-up, but if you dismiss it you will be editing +a blank file of that name. You can run FLUID without any name, in +which case you will be editing an unnamed blank setup (but you can use +save-as to write it to a file). +
You can provide any of the standard FLTK switches before the filename:
++-display host:n.n +-geometry WxH+X+Y +-title windowtitle +-name classname +-iconic +-fg color +-bg color +-bg2 color +-scheme schemename ++ + +
Changing the colors may be useful to see what your interface +will look at if the user calls it with the same switches. +Similarly, using "-scheme plastic" will show how the interface +will look using the "plastic" scheme. + +
In the current version, if you don't put FLUID into the +background with '&' then you will be able to abort FLUID by +typing CTRL-C on the terminal. It will exit +immediately, losing any changes.
+ +To run FLUID under WIN32, double-click on the FLUID.exe +file. You can also run FLUID from the Command Prompt window. +FLUID always runs in the background under WIN32. + +
FLUID can also be called as a command-line +"compiler" to create the .cxx and .h +file from a .fl file. To do this type: + +
+fluid -c filename.fl ++ +
This will read the filename.fl file and write +filename.cxx and filename.h. Any leading +directory on filename.fl will be stripped, so they are +always written to the current directory. If there are any errors +reading or writing the files, FLUID will print the error and +exit with a non-zero code. You can use the following lines in a +makefile to automate the creation of the source and header +files: + +
+my_panels.h my_panels.cxx: my_panels.fl + fluid -c my_panels.fl ++ +
Most versions of make support rules that cause .fl +files to be compiled: + +
+.SUFFIXES: .fl .cxx .h +.fl.h .fl.cxx: + fluid -c $< ++ +
FLUID is an amazingly powerful little program. However, this +power comes at a price as it is not always obvious how to +accomplish seemingly simple tasks with it. This tutorial will +show you how to generate a complete user interface class with +FLUID that is used for the CubeView program provided with FLTK. + +

+Figure 9-2: CubeView demo.
The window is of class CubeViewUI, and is completely generated by FLUID, including +class member functions. The central display of the cube is a separate +subclass of Fl_Gl_Window called CubeView. CubeViewUI manages CubeView +using callbacks from the various sliders and rollers to manipulate the +viewing angle and zoom of CubeView. +
At the completion of this tutorial you will (hopefully) understand +how to: +
You can safely skip this section as long as you realize the CubeView +is a sublass of Fl_Gl_Window and will respond to calls from +CubeViewUI, generated by FLUID. +
+class CubeView : public Fl_Gl_Window {
+ public:
+ CubeView(int x,int y,int w,int h,const char *l=0);
+ // this value determines the scaling factor used to draw the cube.
+ double size;
+ /* Set the rotation about the vertical (y ) axis.
+ *
+ * This function is called by the horizontal roller in CubeViewUI
+ * and the initialize button in CubeViewUI.
+ */
+ void v_angle(float angle){vAng=angle;};
+ // Return the rotation about the vertical (y ) axis.
+ float v_angle(){return vAng;};
+ /* Set the rotation about the horizontal (x ) axis.
+ *
+ * This function is called by the vertical roller in CubeViewUI
+ and the
+ * initialize button in CubeViewUI.
+ */
+ void h_angle(float angle){hAng=angle;};
+ // the rotation about the horizontal (x ) axis.
+ float h_angle(){return hAng;};
+ /* Sets the x shift of the cube view camera.
+ *
+ * This function is called by the slider in CubeViewUI and the
+ * initialize button in CubeViewUI.
+ */
+ void panx(float x){xshift=x;};
+ /* Sets the y shift of the cube view camera.
+ *
+ * This function is called by the slider in CubeViewUI and the
+ * initialize button in CubeViewUI.
+ */
+ void pany(float y){yshift=y;};
+ /* The widget class draw() override.
+ * The draw() function initialize Gl for another round of
+ * drawing then calls specialized functions for drawing each
+ * of the entities displayed in the cube view.
+ */
+ void draw();
+
+ private:
+ /* Draw the cube boundaries
+ * Draw the faces of the cube using the boxv[] vertices, using
+ * GL_LINE_LOOP for the faces. The color is #defined by
+ * CUBECOLOR.
+ */
+ void drawCube();
+
+ float vAng,hAng; float xshift,yshift;
+
+ float boxv0[3];float boxv1[3]; float boxv2[3];float boxv3[3];
+ float boxv4[3];float boxv5[3]; float boxv6[3];float boxv7[3];
+};
+
+
+Here is the CubeView implementation. It is very similar to the +"cube" demo included with FLTK. + +
+#include "CubeView.h"
+#include <math.h>
+
+CubeView::CubeView(int x,int y,int w,int h,const char *l)
+ : Fl_Gl_Window(x,y,w,h,l)
+{
+ vAng = 0.0; hAng=0.0; size=10.0;
+ /* The cube definition. These are the vertices of a unit cube
+ * centered on the origin.*/
+ boxv0[0] = -0.5; boxv0[1] = -0.5; boxv0[2] = -0.5; boxv1[0] = 0.5;
+ boxv1[1] = -0.5; boxv1[2] = -0.5; boxv2[0] = 0.5; boxv2[1] = 0.5;
+ boxv2[2] = -0.5; boxv3[0] = -0.5; boxv3[1] = 0.5; boxv3[2] = -0.5;
+ boxv4[0] = -0.5; boxv4[1] = -0.5; boxv4[2] = 0.5; boxv5[0] = 0.5;
+ boxv5[1] = -0.5; boxv5[2] = 0.5; boxv6[0] = 0.5; boxv6[1] = 0.5;
+ boxv6[2] = 0.5; boxv7[0] = -0.5; boxv7[1] = 0.5; boxv7[2] = 0.5;
+};
+
+// The color used for the edges of the bounding cube.
+#define CUBECOLOR 255,255,255,255
+
+void CubeView::drawCube() {
+/* Draw a colored cube */
+#define ALPHA 0.5
+ glShadeModel(GL_FLAT);
+
+ glBegin(GL_QUADS);
+ glColor4f(0.0, 0.0, 1.0, ALPHA);
+ glVertex3fv(boxv0);
+ glVertex3fv(boxv1);
+ glVertex3fv(boxv2);
+ glVertex3fv(boxv3);
+
+ glColor4f(1.0, 1.0, 0.0, ALPHA);
+ glVertex3fv(boxv0);
+ glVertex3fv(boxv4);
+ glVertex3fv(boxv5);
+ glVertex3fv(boxv1);
+
+ glColor4f(0.0, 1.0, 1.0, ALPHA);
+ glVertex3fv(boxv2);
+ glVertex3fv(boxv6);
+ glVertex3fv(boxv7);
+ glVertex3fv(boxv3);
+
+ glColor4f(1.0, 0.0, 0.0, ALPHA);
+ glVertex3fv(boxv4);
+ glVertex3fv(boxv5);
+ glVertex3fv(boxv6);
+ glVertex3fv(boxv7);
+
+ glColor4f(1.0, 0.0, 1.0, ALPHA);
+ glVertex3fv(boxv0);
+ glVertex3fv(boxv3);
+ glVertex3fv(boxv7);
+ glVertex3fv(boxv4);
+
+ glColor4f(0.0, 1.0, 0.0, ALPHA);
+ glVertex3fv(boxv1);
+ glVertex3fv(boxv5);
+ glVertex3fv(boxv6);
+ glVertex3fv(boxv2);
+ glEnd();
+
+ glColor3f(1.0, 1.0, 1.0);
+ glBegin(GL_LINES);
+ glVertex3fv(boxv0);
+ glVertex3fv(boxv1);
+
+ glVertex3fv(boxv1);
+ glVertex3fv(boxv2);
+
+ glVertex3fv(boxv2);
+ glVertex3fv(boxv3);
+
+ glVertex3fv(boxv3);
+ glVertex3fv(boxv0);
+
+ glVertex3fv(boxv4);
+ glVertex3fv(boxv5);
+
+ glVertex3fv(boxv5);
+ glVertex3fv(boxv6);
+
+ glVertex3fv(boxv6);
+ glVertex3fv(boxv7);
+
+ glVertex3fv(boxv7);
+ glVertex3fv(boxv4);
+
+ glVertex3fv(boxv0);
+ glVertex3fv(boxv4);
+
+ glVertex3fv(boxv1);
+ glVertex3fv(boxv5);
+
+ glVertex3fv(boxv2);
+ glVertex3fv(boxv6);
+
+ glVertex3fv(boxv3);
+ glVertex3fv(boxv7);
+ glEnd();
+};//drawCube
+
+void CubeView::draw() {
+ if (!valid()) {
+ glLoadIdentity(); glViewport(0,0,w(),h());
+ glOrtho(-10,10,-10,10,-20000,10000); glEnable(GL_BLEND);
+ glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
+ }
+
+ glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
+ glPushMatrix(); glTranslatef(xshift, yshift, 0);
+ glRotatef(hAng,0,1,0); glRotatef(vAng,1,0,0);
+ glScalef(float(size),float(size),float(size)); drawCube();
+ glPopMatrix();
+};
+
+
+We will completely construct a window to display and control the +CubeView defined in the previous section using FLUID. + +
Once you have started FLUID, the first step in defining a class is to +create a new class within FLUID using the New->Code->Class +menu item. Name the class "CubeViewUI" and leave the +subclass blank. We do not need any inheritance for this +window. You should see the new class declaration in the FLUID +browser window. + +

+Figure 9-3: FLUID file for CubeView.
Click on the CubeViewUI class in the FLUID window and add a new method +by selecting New->Code->Function/Method. The name of the +function will also be CubeViewUI. FLUID will understands that this will +be the constructor for the class and will generate the appropriate +code. Make sure you declare the constructor public. + +
Then add a window to the CubeViewUI class. Highlight the name of +the constructor in the FLUID browser window and click on +New->Group->Window. In a similar manner add the +following to the CubeViewUI constructor: + +
None of these additions need be public. And they shouldn't be +unless you plan to expose them as part of the interface for +CubeViewUI. + +
When you are finished you should have something like this: + +

+Figure 9-4: FLUID window containing CubeView demo.
We will talk about the show() method that is highlighted +shortly. + +
What we have is nice, but does little to show our cube. We have already +defined the CubeView class and we would like to show it within the +CubeViewUI. + +
The CubeView class inherits the Fl_Gl_Window class, which +is created in the same way as a Fl_Box widget. Use +New->Other->Box to add a square box to the main window. +This will be no ordinary box, however. + +
The Box properties window will appear. The key to letting CubeViewUI +display CubeView is to enter CubeView in the "Class:" text +entry box. This tells FLUID that it is not an Fl_Box, but a +similar widget with the same constructor. In the "Extra +Code:" field enter #include "CubeView.h" + +
This #include is important, as we have just included +CubeView as a member of CubeViewUI, so any public CubeView methods are +now available to CubeViewUI. + +

+Figure 9-5: CubeView methods.
Each of the widgets we defined before adding CubeView can have +callbacks that call CubeView methods. You can call an external +function or put in a short amount of code in the "Callback" +field of the widget panel. For example, the callback for the +ypan slider is: + +
+cube->pany(((Fl_Slider *)o)->value()); +cube->redraw(); ++ +
We call cube->redraw() after changing the value to update +the CubeView window. CubeView could easily be modified to do this, but +it is nice to keep this exposed in the case where you may want to do +more than one view change only redrawing once saves a lot of time. + +
There is no reason no wait until after you have added CubeView to +enter these callbacks. FLUID assumes you are smart enough not to refer +to members or functions that don't exist. + +
You can add class methods within FLUID that have nothing to do with the +GUI. An an example add a show function so that CubeViewUI can actually +appear on the screen. + +
Make sure the top level CubeViewUI is selected and select +New->Code->Function/Method. Just use the name +show(). We don't need a return value here, and since we will +not be adding any widgets to this method FLUID will assign it a return +type of void. + +

+Figure 9-6: CubeView constructor.
Once the new method has been added, highlight its name and select +New->Code->Code. Enter the method's code in the code window. + +
If you need to add code to initialize class, for example setting +initial values of the horizontal and vertical angles in the +CubeView, you can simply highlight the Constructor and select +New->Code->Code. Add any required code. + +
Now that we have completely defined the CubeViewUI, we have to generate +the code. There is one last trick to ensure this all works. Open the +preferences dialog from Edit->Preferences. + +
At the bottom of the preferences dialog box is the key: "Include +Header from Code". Select that option and set your desired file +extensions and you are in business. You can include the CubeViewUI.h +(or whatever extension you prefer) as you would any other C++ class. + + + +
The following sections describe each of the windows in FLUID. + +
The main window shows a menu bar and a scrolling browser of +all the defined widgets. The name of the .fl file being +edited is shown in the window title. + +
The widgets are stored in a hierarchy. You can open and close a +level by clicking the "triangle" at the left of a widget. +The leftmost widgets are the parents, and all the widgets +listed below them are their children. Parents don't have to have +any children.
+ +The top level of the hierarchy is composed of functions and +classes. Each of these will produce a single C++ public +function or class in the output .cxx file. Calling the function or +instantiating the class will create all of the child widgets.
+ +The second level of the hierarchy contains the windows. Each of these +produces an instance of class Fl_Window.
+ +Below that are either widgets (subclasses of Fl_Widget) or +groups of widgets (including other groups). Plain groups are for +layout, navigation, and resize purposes. Tab groups provide the +well-known file-card tab interface.
+ +Widgets are shown in the browser by either their name (such +as "main_panel" in the example), or by their type +and label (such as "Button "the green"").
+ +You select widgets by clicking on their names, which highlights +them (you can also select widgets from any displayed window). You can +select many widgets by dragging the mouse across them, or by using +Shift+Click to toggle them on and off. To select no widgets, click in +the blank area under the last widget. Note that hidden children may +be selected even when there is no visual indication of this. + +
You open widgets by double-clicking on them, or (to open several +widgets you have picked) by typing the F1 key. A control panel will appear +so you can change the widget(s).
+ +The menu bar at the top is duplicated as a pop-up menu on any +displayed window. The shortcuts for all the menu items work in any +window. The menu items are:
+ +Discards the current editing session and reads in a different +.fl file. You are asked for confirmation if you have +changed the current file. + +
FLUID can also read .fd files produced by the Forms +and XForms "fdesign" programs. It is best to +File/Merge them instead of opening them. FLUID does not +understand everything in a .fd file, and will print a +warning message on the controlling terminal for all data it does +not understand. You will probably need to edit the resulting +setup to fix these errors. Be careful not to save the file +without changing the name, as FLUID will write over the +.fd file with its own format, which fdesign cannot +read!
+ +Inserts the contents of another .fl file, without +changing the name of the current .fl file. All the +functions (even if they have the same names as the current ones) +are added, and you will have to use cut/paste to put the widgets +where you want. + +
Writes the current data to the .fl file. If the +file is unnamed then FLUID will ask for a filename. + +
Asks for a new filename and saves the file. + +
"Compiles" the data into a .cxx and .h +file. These are exactly the same as the files you get when you run +FLUID with the -c switch. + +
The output file names are the same as the .fl file, with +the leading directory and trailing ".fl" stripped, and +".h" or ".cxx" appended.
+ +Writes a message file for all of the text labels defined in +the current file. + +
The output file name is the same as the .fl file, +with the leading directory and trailing ".fl" +stripped, and ".txt", ".po", or +".msg" appended depending on the Internationalization Mode.
+ +Exits FLUID. You are asked for confirmation if you have +changed the current file. + +
This isn't implemented yet. You should do save often so you can +recover from any mistakes you make. + +
Deletes the selected widgets and all of their children. +These are saved to a "clipboard" file and can be +pasted back into any FLUID window. + +
Copies the selected widgets and all of their children to the +"clipboard" file. + +
Pastes the widgets from the clipboard file. + +
If the widget is a window, it is added to whatever function +is selected, or contained in the current selection.
+ +If the widget is a normal widget, it is added to whatever +window or group is selected. If none is, it is added to the +window or group that is the parent of the current selection.
+ +To avoid confusion, it is best to select exactly one widget +before doing a paste.
+ +Cut/paste is the only way to change the parent of a +widget.
+ +Selects all widgets in the same group as the current +selection. + +
If they are all selected already then this selects all +widgets in that group's parent. Repeatedly typing Ctrl+a will +select larger and larger groups of widgets until everything is +selected.
+ +Displays the current widget in the attributes panel. If the +widget is a window and it is not visible then the window is +shown instead. + +
Sorts the selected widgets into left to right, top to bottom +order. You need to do this to make navigation keys in FLTK work +correctly. You may then fine-tune the sorting with +"Earlier" and "Later". This does not affect +the positions of windows or functions. + +
Moves all of the selected widgets one earlier in order among +the children of their parent (if possible). This will affect +navigation order, and if the widgets overlap it will affect how +they draw, as the later widget is drawn on top of the earlier +one. You can also use this to reorder functions, classes, and +windows within functions. + +
Moves all of the selected widgets one later in order among +the children of their parent (if possible). + +
Creates a new Fl_Group and make all the currently +selected widgets children of it. + +
Deletes the parent group if all the children of a group are +selected. + +
Toggles the display of the red overlays off, without changing +the selection. This makes it easier to see box borders and how +the layout looks. The overlays will be forced back on if you +change the selection. + +
Displays the project settings panel. +The output filenames control the extensions or names of the +files the are generated by FLUID. If you check the "Include .h +from .cxx" button the code file will include the header file +automatically. + +
The internationalization options are described later in this chapter. + +

+Figure 9-7: FLUID Preferences Window.
Displays the GUI settings panel. This panel is used +to control the user interface settings. + +
Creates a new C function. You will be asked for a name for +the function. This name should be a legal C++ function +template, without the return type. You can pass arguments which +can be referred to by code you type into the individual widgets. + +
If the function contains any unnamed windows, it will be +declared as returning a Fl_Window pointer. The unnamed window +will be returned from it (more than one unnamed window is +useless). If the function contains only named windows, it will +be declared as returning nothing (void).
+ +It is possible to make the .cxx output be a +self-contained program that can be compiled and executed. This +is done by deleting the function name so +main(argc,argv) is used. The function will call +show() on all the windows it creates and then call +Fl::run(). This can also be used to test resize +behavior or other parts of the user interface.
+ +You can change the function name by double-clicking on the +function.
+ +Creates a new Fl_Window widget. The window is added +to the currently selected function, or to the function +containing the currently selected item. The window will appear, +sized to 100x100. You can resize it to whatever size you +require. + +
The widget panel will also appear and is described later in +this chapter.
+ +All other items on the New menu are subclasses of +Fl_Widget. Creating them will add them to the +currently selected group or window, or the group or window +containing the currently selected widget. The initial +dimensions and position are chosen by copying the current +widget, if possible. + +
When you create the widget you will get the widget's control +panel, which is described later in this chapter.
+ + +Align all selected widgets to the first widget in the selection. + +
Space all selected widgets evenly inside the selected space. +Widgets will be sorted from first to last. + +
Make all selected widgets the same size as the first selected widget. + +
Center all selected widgets relative to their parent widget + +
Displays the grid settings panel. +This panel +controls the grid that all widgets snap to when you move and +resize them, and for the "snap" which is how far a widget has to +be dragged from its original position to actually change. + + +
Displays the shell command panel. The shell command +is commonly used to run a 'make' script to compile the FLTK output. + +
Run the shell command again. + +
Pops up a panel showing the version of FLUID. + +
Shows this chapter of the manual. + +
Shows the contents page of the manual + +
When you double-click on a widget or a set of widgets you +will get the "widget attribute panel". + +
When you change attributes using this panel, the changes are +reflected immediately in the window. It is useful to hit the +"no overlay" button (or type Ctrl+Shift+O) to hide the +red overlay so you can see the widgets more accurately, +especially when setting the box type. + +
If you have several widgets selected, they may have different +values for the fields. In this case the value for one of +the widgets is shown. But if you change this value, all +of the selected widgets are changed to the new value. + +
Hitting "OK" makes the changes permanent. +Selecting a different widget also makes the changes permanent. +FLUID checks for simple syntax errors such as mismatched +parenthesis in any code before saving any text. + +
"Revert" or "Cancel" put everything back +to when you last brought up the panel or hit OK. However in the +current version of FLUID, changes to "visible" +attributes (such as the color, label, box) are not undone by +revert or cancel. Changes to code like the callbacks are +undone, however. + + +

+Figure 9-8: The FLUID widget GUI attributes.
String to print next to or inside the button. You can put +newlines into the string to make multiple lines. The easiest way +is by typing Ctrl+j.
+ +Symbols can be added to the +label using the at sign ("@"). + +
How to draw the label. Normal, shadowed, engraved, and +embossed change the appearance of the text. + +
The active image for the widget. Click on the +Browse... button to pick an image file using the file +chooser. + +
The inactive image for the widget. Click on the +Browse... button to pick an image file using the file +chooser. + +
Where to draw the label. The arrows put it on that side of +the widget, you can combine the to put it in the corner. The +"box" button puts the label inside the widget, rather +than outside. + +
The clip button clips the label to the widget box, the +wrap button wraps any text in the label, and the text +image button puts the text over the image instead of under +the image. + +
The position fields show the current position and size of the +widget box. Enter new values to move and/or resize a widget. + +
The values and limits of the current widget. Depending on the +type of widget, some or all of these fields may be inactive. + +
The shortcut key to activate the widget. Click on the +shortcut button and press any key sequence to set the shortcut. + +
The Visible button controls whether the widget is +visible (on) or hidden (off) initially. Don't change this for +windows or for the immediate children of a Tabs group. + +
The Active button controls whether the widget is +activated (on) or deactivated (off) initially. Most widgets +appear greyed out when deactivated. + +
The Resizable button controls whether the window is +resizeable. In addition all the size changes of a window or +group will go "into" the resizable child. If you have +a large data display surrounded by buttons, you probably want +that data area to be resizable. You can get more complex +behavior by making invisible boxes the resizable widget, or by +using hierarchies of groups. Unfortunately the only way to test +it is to compile the program. Resizing the FLUID window is +not the same as what will happen in the user program.
+ +The Hotspot button causes the parent window to be +positioned with that widget centered on the mouse. This +position is determined when the FLUID function is called, +so you should call it immediately before showing the window. If +you want the window to hide and then reappear at a new position, +you should have your program set the hotspot itself just before +show(). + +
The Border button turns the window manager border on +or off. On most window managers you will have to close the +window and reopen it to see the effect. + +
The string typed into here is passed to the X window manager +as the class. This can change the icon or window decorations. +On most (all?) window managers you will have to close the window +and reopen it to see the effect. + + +

+Figure 9-9: The FLUID widget Style attributes.
Font to draw the label in. Ignored by symbols, bitmaps, and +pixmaps. Your program can change the actual font used by these +"slots" in case you want some font other than the 16 +provided. + +
Pixel size (height) for the font to draw the label in. +Ignored by symbols, bitmaps, and pixmaps. To see the result +without dismissing the panel, type the new number and then Tab. + +
Color to draw the label. Ignored by pixmaps (bitmaps, +however, do use this color as the foreground color). + +
The boxtype to draw as a background for the widget. + +
Many widgets will work, and draw faster, with a +"frame" instead of a "box". A frame does +not draw the colored interior, leaving whatever was already +there visible. Be careful, as FLUID may draw this ok but the +real program may leave unwanted stuff inside the widget.
+ +If a window is filled with child widgets, you can speed up +redrawing by changing the window's box type to +"NO_BOX". FLUID will display a checkerboard for any +areas that are not colored in by boxes. Note that this +checkerboard is not drawn by the resulting program. Instead +random garbage will be displayed.
+ +The boxtype to draw when a button is pressed or for some +parts of other widgets like scrollbars and valuators. + +
The color to draw the box with.
+ +Some widgets will use this color for certain parts. FLUID +does not always show the result of this: this is the color +buttons draw in when pushed down, and the color of input fields +when they have the focus.
+ +Some widgets display text, such as input fields, pull-down +menus, and browsers. + + +

+Figure 9-10: The FLUID widget C++ attributes.
This is how you use your own subclasses of +Fl_Widget. Whatever identifier you type in here will +be the class that is instantiated. + +
In addition, no #include header file is put in the +.h file. You must provide a #include line as +the first line of the "Extra Code" which declares your +subclass.
+ +The class must be similar to the class you are spoofing. It +does not have to be a subclass. It is sometimes useful to +change this to another FLTK class. Currently the only way to get +a double-buffered window is to change this field for the window +to "Fl_Double_Window" and to add "#include +<FL/Fl_Double_Window.h>" to the extra code.
+ +Some classes have subtypes that modify their appearance or behavior. +You pick the subtype off of this menu. + +
Name of a variable to declare, and to store a pointer to this +widget into. This variable will be of type "<class>*". If the name is +blank then no variable is created. + +
You can name several widgets with "name[0]", "name[1]", "name[2]", +etc. This will cause FLUID to declare an array of pointers. The array +is big enough that the highest number found can be stored. All widgets +that in the array must be the same type.
+ +Controls whether the widget is publicly accessible. When +embedding widgets in a C++ class, this controls whether the +widget is public or private in the class. +Otherwise is controls whether the widget is declared +static or global (extern). + +
These four fields let you type in literal lines of code to +dump into the .h or .cxx files. + +
If the text starts with a # or the word +extern then FLUID thinks this is an "include" +line, and it is written to the .h file. If the same +include line occurs several times then only one copy is +written.
+ +All other lines are "code" lines. The current +widget is pointed to by the local variable o. The +window being constructed is pointed to by the local variable +w. You can also access any arguments passed to the +function here, and any named widgets that are before this +one.
+ +FLUID will check for matching parenthesis, braces, and +quotes, but does not do much other error checking. Be careful +here, as it may be hard to figure out what widget is producing +an error in the compiler. If you need more than four lines you +probably should call a function in your own .cxx +code.
+ +This can either be the name of a function, or a small snippet +of code. If you enter anything but letters, numbers, and the +underscore then FLUID treats it as code. + +
A name names a function in your own code. It must be +declared as void name(<class>*,void*).
+ +A code snippet is inserted into a static function in the +.cxx output file. The function prototype is void +name(class *o, void *v) so that you can refer to the +widget as o and the user_data() as +v. FLUID will check for matching parenthesis, braces, +and quotes, but does not do much other error checking. Be +careful here, as it may be hard to figure out what widget is +producing an error in the compiler.
+ +If the callback is blank then no callback is set.
+ +This is a value for the user_data() of the widget. +If blank the default value of zero is used. This can be any +piece of C code that can be cast to a void pointer. + +
The void * in the callback function prototypes is +replaced with this. You may want to use long for old +XForms code. Be warned that anything other than void * +is not guaranteed to work! However on most architectures other +pointer types are ok, and long is usually ok, too. + +
When to do the callback. This can be Never, +Changed, Release, or Enter Key. The value of +Enter Key is only useful for text input fields. + +
There are other rare but useful values for the +when() field that are not in the menu. You should use +the extra code fields to put these values in.
+ +The No Change button means the callback is done on the +matching event even if the data is not changed. + +
Double-clicking a window name in the browser will display it, +if not displayed yet. From this display you can select widgets, +sets of widgets, and move or resize them. To close a window +either double-click it or type ESC. + +
To select a widget, click it. To select several widgets drag +a rectangle around them. Holding down shift will toggle the +selection of the widgets instead.
+ +You cannot pick hidden widgets. You also cannot choose some +widgets if they are completely overlapped by later widgets. Use +the browser to select these widgets.
+ +The selected widgets are shown with a red "overlay" +line around them. You can move the widgets by dragging this +box. Or you can resize them by dragging the outer edges and +corners. Hold down the Alt key while dragging the mouse to +defeat the snap-to-grid effect for fine positioning.
+ +If there is a tab box displayed you can change which child is +visible by clicking on the file tabs. The child you pick is +selected.
+ +The arrow, tab, and shift+tab keys "navigate" the +selection. Left, right, tab, or shift+tab move to the next or +previous widgets in the hierarchy. Hit the right arrow enough +and you will select every widget in the window. Up/down widgets +move to the previous/next widgets that overlap horizontally. If +the navigation does not seem to work you probably need to +"Sort" the widgets. This is important if you have +input fields, as FLTK uses the same rules when using arrow keys +to move between input fields.
+ +To "open" a widget, double click it. To open +several widgets select them and then type F1 or pick +"Edit/Open" off the pop-up menu.
+ +Type Ctrl+o to temporarily toggle the overlay off without +changing the selection, so you can see the widget borders.
+ +You can resize the window by using the window manager border +controls. FLTK will attempt to round the window size to the +nearest multiple of the grid size and makes it big enough to +contain all the widgets (it does this using illegal X methods, +so it is possible it will barf with some window managers!). +Notice that the actual window in your program may not be +resizable, and if it is, the effect on child widgets may be +different.
+ +The panel for the window (which you get by double-clicking +it) is almost identical to the panel for any other Fl_Widget. +There are three extra items:
+ +The contents of the image files in the Image +and Inactive text fields are written to the .cxx +file. If many widgets share the same image then only one copy is +written. Since the image data is embedded in the generated +source code, you need only distribute the C++ code and not the +image files themselves.
+ +However, the filenames are stored in the .fl +file so you will need the image files as well to read the +.fl file. Filenames are relative to the location of the +.fl file and not necessarily the current directory. We +recommend you either put the images in the same directory as the +.fl file, or use absolute path names.
+ +FLUID runs using the default visual of your X server. This +may be 8 bits, which will give you dithered images. You may get +better results in your actual program by adding the code +"Fl::visual(FL_RGB)" to your code right before the +first window is displayed. + +
All widgets with the same image on them share the same code +and source X pixmap. Thus once you have put an image on a +widget, it is nearly free to put the same image on many other +widgets.
+ +If you edit an image at the same time you are using it in FLUID, +the only way to convince FLUID to read the image file again is to +remove the image from all widgets that are using it or re-load the +.fl file.
+ +Don't rely on how FLTK crops images that are outside the +widget, as this may change in future versions! The cropping of +inside labels will probably be unchanged.
+ +To more accurately place images, make a new "box" +widget and put the image in that as the label.
+ +FLUID reads X bitmap files which use C source code to define +a bitmap. Sometimes they are stored with the ".h" or +".bm" extension rather than the standard +".xbm" extension. + +
FLUID writes code to construct an Fl_Bitmap image and use it +to label the widget. The '1' bits in the bitmap are drawn using +the label color of the widget. You can change this color in the +FLUID widget attributes panel. The '0' bits are transparent.
+ +The program "bitmap" on the X distribution does an +adequate job of editing bitmaps.
+ +FLUID reads X pixmap files as used by the libxpm +library. These files use C source code to define a pixmap. The +filenames usually have the ".xpm" extension. + +
FLUID writes code to construct an Fl_Pixmap image and use it +to label the widget. The label color of the widget is ignored, +even for 2-color images that could be a bitmap. XPM files can +mark a single color as being transparent, and FLTK uses this +information to generate a transparency mask for the image.
+ +We have not found any good editors for small iconic pictures. +For pixmaps we have used XPaint +and the KDE icon editor.
+ +FLUID reads Windows BMP image files which are often used in +WIN32 applications for icons. FLUID converts BMP files into +(modified) XPM format and uses a Fl_BMP_Image image to label the +widget. Transparency is handled the same as for XPM files. All +image data is uncompressed when written to the source file, so +the code may be much bigger than the .bmp file.
+ +FLUID reads GIF image files which are often used in HTML +documents to make icons. FLUID converts GIF files into +(modified) XPM format and uses a Fl_GIF_Image image to label the +widget. Transparency is handled the same as for XPM files. All +image data is uncompressed when written to the source file, so +the code may be much bigger than the .gif file. Only +the first image of an animated GIF file is used.
+ +If FLTK is compiled with JPEG support, FLUID can read JPEG +image files which are often used for digital photos. FLUID uses +a Fl_JPEG_Image image to label the widget, and writes +uncompressed RGB or grayscale data to the source file. + +
If FLTK is compiled with PNG support, FLUID can read PNG +image files which are often used in HTML documents. FLUID uses a +Fl_PNG_Image image to label the widget, and writes uncompressed +RGB or grayscale data to the source file. PNG images can provide +a full alpha channel for partial transparency, and FLTK supports +this as best as possible on each platform. + +
FLUID supports internationalization (I18N for short) of label +strings used by widgets. The preferences window +(Ctrl+p) provides access to the I18N options. + +
FLUID supports three methods of I18N: use none, use GNU +gettext, and use POSIX catgets. The "use none" method is the +default and just passes the label strings as-is to the widget +constructors. + +
The "GNU gettext" method uses GNU gettext (or a similar +text-based I18N library) to retrieve a localized string before +calling the widget constructor. + +
The "POSIX catgets" method uses the POSIX catgets function to +retrieve a numbered message from a message catalog before +calling the widget constructor. + +
FLUID's code support for GNU gettext is limited to calling a +function or macro to retrieve the localized label; you still +need to call setlocale() and textdomain() or +bindtextdomain() to select the appropriate language and +message file. + +
To use GNU gettext for I18N, open the preferences window and +choose "GNU gettext" from the "Use" chooser. Two new input +fields will then appear to control the include file and +function/macro name to use when retrieving the localized label +strings. + +

+Figure 9-11: Internationalization using GNU gettext.
The "#include" field controls the header file to include for +I18N; by default this is <libintl.h>, the +standard I18N file for GNU gettext. + +
The "Function" field controls the function (or macro) that +will retrieve the localized message; by default the +gettext function will be called. + +
FLUID's code support for POSIX catgets allows you to use a +global message file for all interfaces or a file specific to +each .fl file; you still need to call +setlocale() to select the appropriate language. + +
To use POSIX catgets for I18N, open the preferences window +and choose "POSIX catgets" from the "Use" chooser. Three new +input fields will then appear to control the include file, +catalog file, and set number for retrieving the localized label +strings. + +

+Figure 9-12: Internationalization using POSIX catgets.
The "#include" field controls the header file to include for +I18N; by default this is <nl_types.h>, the +standard I18N file for POSIX catgets. + +
The "File" field controls the name of the catalog file +variable to use when retrieving localized messages; by default +the file field is empty which forces a local (static) catalog +file to be used for all of the windows defined in your +.fl file. + +
The "Set" field controls the set number in the catalog file. +The default set is 1 and rarely needs to be changed. + +
#if 0 and #endif
+type construction. This will effectively avoid compilation of
+blocks of code. However, static code and data generated by this
+segment (menu items, images, include statements, etc.) will still
+be generated and likely cause compile-time warnings.
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid.man b/third_party/windows/fltk-1.1.10/documentation/fluid.man
new file mode 100644
index 0000000..924f440
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/fluid.man
@@ -0,0 +1,32 @@
+.TH fluid 1 "Fast Light Tool Kit" "6 January 2002"
+.SH NAME
+fluid \- the fast light user-interface designer
+.sp
+.SH SYNOPSIS
+fluid [ \-c [ \-o
+.I code-filename
+\-h
+.I header-filename
+] ] [
+.I filename.fl
+]
+.fi
+.SH DESCRIPTION
+\fIfluid\fR is an interactive GUI designer for FLTK. When run
+with no arguments or with a filename, \fIfluid\fR will display
+the GUI hierarchy and any windows defined in the file.
+Functions, classes, windows, and GUI components can be
+manipulated as needed.
+.LP
+When used with the \fI\-c\fR option, \fIfluid\fR will create the
+necessary C++ header and code files in the current directory.
+You can override the default extensions, filenames, and
+directories using the \fI\-o\fR and \fI\-h\fR options.
+.SH SEE ALSO
+fltk\-config(1), fltk(3)
+.br
+FLTK Programming Manual, Chapter 9
+.br
+FLTK Web Site, http://www.fltk.org/
+.SH AUTHORS
+Bill Spitzak and others.
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid1.gif b/third_party/windows/fltk-1.1.10/documentation/fluid1.gif
new file mode 100644
index 0000000..cfdefd7
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid1.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid2.gif b/third_party/windows/fltk-1.1.10/documentation/fluid2.gif
new file mode 100644
index 0000000..e551e84
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid2.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid3-cxx.gif b/third_party/windows/fltk-1.1.10/documentation/fluid3-cxx.gif
new file mode 100644
index 0000000..420ccaf
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid3-cxx.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid3-gui.gif b/third_party/windows/fltk-1.1.10/documentation/fluid3-gui.gif
new file mode 100644
index 0000000..5f75726
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid3-gui.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid3-style.gif b/third_party/windows/fltk-1.1.10/documentation/fluid3-style.gif
new file mode 100644
index 0000000..ecb55b4
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid3-style.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid4.gif b/third_party/windows/fltk-1.1.10/documentation/fluid4.gif
new file mode 100644
index 0000000..d9e0292
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid4.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid_prefs.gif b/third_party/windows/fltk-1.1.10/documentation/fluid_prefs.gif
new file mode 100644
index 0000000..0bc7d8d
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid_prefs.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid_widget_cxx.gif b/third_party/windows/fltk-1.1.10/documentation/fluid_widget_cxx.gif
new file mode 100644
index 0000000..cb12e76
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid_widget_cxx.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid_widget_gui.gif b/third_party/windows/fltk-1.1.10/documentation/fluid_widget_gui.gif
new file mode 100644
index 0000000..d5ac3c6
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid_widget_gui.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/fluid_widget_style.gif b/third_party/windows/fltk-1.1.10/documentation/fluid_widget_style.gif
new file mode 100644
index 0000000..f5bf9b1
Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/fluid_widget_style.gif differ
diff --git a/third_party/windows/fltk-1.1.10/documentation/forms.html b/third_party/windows/fltk-1.1.10/documentation/forms.html
new file mode 100644
index 0000000..1e3af43
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/forms.html
@@ -0,0 +1,203 @@
+
+
+ You will need to edit your main code considerably to get it to link +with the output from FLUID. If you are not interested in this you may +have more immediate luck with the forms compatibility header, +<FL/forms.H>.
+You will also have to compile your Forms or XForms program using a +C++ compiler. The FLTK library does not provide C bindings or header +files.
+Although FLTK was designed to be compatible with the GL Forms +library (version 0.3 or so), XForms has bloated severely and it's +interface is X-specific. Therefore, XForms compatibility is no longer +a goal of FLTK. Compatibility was limited to things that were free, or +that would add code that would not be linked in if the feature is +unused, or that was not X-specific.
+To use any new features of FLTK, you should rewrite your code to not +use the inline functions and instead use "pure" FLTK. This will make +it a lot cleaner and make it easier to figure out how to call the FLTK +functions. Unfortunately this conversion is harder than expected and +even Digital Domain's inhouse code still uses forms.H a lot.
+Many parts of XForms use X-specific structures like XEvent + in their interface. I did not emulate these! Unfortunately these +features (such as the "canvas" widget) are needed by most large +programs. You will need to rewrite these to use FLTK subclasses.
+Fl_Free widgets emulate +the old Forms "free" widget. It may be useful for porting +programs that change the handle() function on widgets, but you +will still need to rewrite things.
+Fl_Timer widgets are +provided to emulate the XForms timer. These work, but are quite +inefficient and inaccurate compared to using +Fl::add_timeout().
+All instance variables are hidden. If you directly refer to +the x, y, w, h, label, or other fields of your Forms widgets you will +have to add empty parenthesis after each reference. The easiest way to +do this is to globally replace "->x" with "->x()", etc. Replace +"boxtype" with "box()".
+const char * arguments to most FLTK methods are simply +stored, while Forms would strdup() the passed string. This is +most noticable with the label of widgets. Your program must always +pass static data such as a string constant or malloc'd buffer to +label(). If you are using labels to display program output you +may want to try the Fl_Output + widget.
+The default fonts and sizes are matched to the older GL version of +Forms, so all labels will draw somewhat larger than an XForms program +does.
+fdesign outputs a setting of a "fdui" instance variable to the main +window. I did not emulate this because I wanted all instance variables +to be hidden. You can store the same information in the user_data() + field of a window. To do this, search through the fdesign output for +all occurances of "->fdui" and edit to use "->user_data()" instead. + This will require casts and is not trivial.
+The prototype for the functions passed to fl_add_timeout() + and fl_set_idle_callback() callback are different.
+All the following XForms calls are missing:
+None of this works with FLTK. Nor will it compile, the necessary +calls are not in the interface.
+You have to make a subclass of +Fl_Gl_Window and write a draw() method and +handle() method. This may require anywhere from a trivial to a +major rewrite.
+If you draw into the overlay planes you will have to also write a +draw_overlay() method and call redraw_overlay() on the +OpenGL window.
+One easy way to hack your program so it works is to make the +draw() and handle() methods on your window set some +static variables, storing what event happened. Then in the main loop +of your program, call Fl::wait() and then check these +variables, acting on them as though they are events read from +fl_queue.
+The file <FL/gl.h> defines replacements for a lot of IRISGL +calls, translating them to OpenGL. There are much better translators +available that you might want to investigate.
+An attempt has been made to emulate the "free" widget. This appears +to work quite well. It may be quicker to modify your subclass into a +"free" widget, since the "handle" functions match.
+If your subclass draws into the overlay you are in trouble and will +have to rewrite things a lot.
+| Forms | FLTK |
|---|---|
| MOUSE_X | Fl::event_x_root() |
| MOUSE_Y | Fl::event_y_root() |
| LEFTSHIFTKEY,RIGHTSHIFTKEY | Fl::event_shift() |
| CAPSLOCKKEY | Fl::event_capslock() |
| LEFTCTRLKEY,RIGHTCTRLKEY | Fl::event_ctrl() |
| LEFTALTKEY,RIGHTALTKEY | Fl::event_alt() |
| MOUSE1,RIGHTMOUSE | Fl::event_state() |
| MOUSE2,MIDDLEMOUSE | Fl::event_state() |
| MOUSE3,LEFTMOUSE | Fl::event_state() |
+fl_font_name(3,"*courier-medium-r-no*"); +fl_font_name(4,"*courier-bold-r-no*"); +fl_font_name(5,"*courier-medium-o-no*"); +fl_font_name(6,"*times-medium-r-no*"); +fl_font_name(7,"*times-bold-r-no*"); +fl_font_name(8,"*times-medium-i-no*"); +fl_font_name(9,"*bookman-light-r-no*"); +fl_font_name(10,"*bookman-demi-r-no*"); +fl_font_name(11,"*bookman-light-i-no*"); ++ + diff --git a/third_party/windows/fltk-1.1.10/documentation/functions.html b/third_party/windows/fltk-1.1.10/documentation/functions.html new file mode 100644 index 0000000..2e9d2b5 --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/functions.html @@ -0,0 +1,1483 @@ + + +
This appendix describes all of the fl_ functions. For a +description of the FLTK classes, see Appendix +A. + +
+#include <FL/fl_ask.H> ++ +
+void fl_alert(const char *, ...); ++ +
Same as fl_message() except for the "!" symbol. + +
Note: Common dialog boxes are application modal. +No more than one common dialog box can be open at any time. +Requests for additional dialog boxes are ignored.
+ +
+
+
+
+
+#include <FL/fl_ask.H> ++ +
+int fl_ask(const char *, ...); ++ +
Displays a printf-style message in a pop-up box with an +"Yes" and "No" button and waits for the user +to hit a button. The return value is 1 if the user hits Yes, +0 if they pick No or another dialog box is still open. + +The enter key is a shortcut for Yes and ESC is a shortcut for No. + +
Note: Common dialog boxes are application modal. +No more than one common dialog box can be open at any time. +Requests for additional dialog boxes are ignored.
+ + +
+
+
Note: Use of this function is strongly +discouraged, and it will be removed in a later FLTK release. +Instead, use fl_choice() and +provide unambiguous verbs in place of "Yes" and "No".
+ + ++#include <FL/fl_ask.H> ++ +
+void fl_beep(int type = FL_BEEP_DEFAULT) ++ +
Sounds an audible notification; the default type argument
+sounds a simple "beep" sound. Other values for type may use
+a system or user-defined sound file:
+
+
+#include <FL/fl_ask.H> ++ +
+int fl_choice(const char *q, const char *b0, const char *b1, const char *b2, ...); ++ +
Shows the message with three buttons below it marked with the +strings b0, b1, and b2. Returns 0, +if button 0 is hit or another dialog box is still open. Returns +1 or 2 for buttons 1 or 2, respectively. ESC is a shortcut for +button 0 and the enter key is a shortcut for button 1. Notice +the buttons are positioned "backwards". You can hide +buttons by passing NULL as their labels. + +
Note: Common dialog boxes are application modal. +No more than one common dialog box can be open at any time. +Requests for additional dialog boxes are ignored.
+ +
+
+
+
+
+#include <FL/Enumerations.H> ++ +
+Fl_Color fl_color_average(Fl_Color c1, Fl_Color c2, float weight); ++ +
Returns the weighted average color between the two colors. +The red, green, and blue values are averaged using the following +formula: + +
+color = c1 * weight + c2 * (1 - weight) ++ +
Thus, a weight value of 1.0 will return the
+first color, while a value of 0.0 will return the second color.
+
+
+
+
+#include <FL/Fl_Color_Chooser.H> ++ +
+int fl_color_chooser(const char *title, double &r, double &g, double &b); +int fl_color_chooser(const char *title, uchar &r, uchar &g, uchar &b); ++ +
The double version takes RGB values in the range
+0.0 to 1.0. The uchar version takes RGB values in
+the range 0 to 255. The title argument specifies the
+label (title) for the window.
+
+

fl_color_chooser() pops up a window to let the user +pick an arbitrary RGB color. They can pick the hue and +saturation in the "hue box" on the left (hold down +CTRL to just change the saturation), and the brighness using the +vertical slider. Or they can type the 8-bit numbers into the +RGB +Fl_Value_Input fields, or drag the mouse across them to +adjust them. The pull-down menu lets the user set the input +fields to show RGB, HSV, or 8-bit RGB (0 to 255). + +
This returns non-zero if the user picks ok, and updates the +RGB values. If the user picks cancel or closes the window this +returns zero and leaves RGB unchanged. + +
If you use the color chooser on an 8-bit screen, it will +allocate all the available colors, leaving you no space to +exactly represent the color the user picks! You can however use + fl_rectf() to fill a +region with a simulated color using dithering. + + + +
+#include <FL/fl_draw.H> ++ +
+Fl_Color fl_color_cube(int r, int g, int b); ++ +
Returns a color out of the color cube. r must be in +the range 0 to FL_NUM_RED (5) minus 1. g must be in the +range 0 to FL_NUM_GREEN (8) minus 1. b must be in the +range 0 to FL_NUM_BLUE (5) minus 1. + +
To get the closest color to a 8-bit set of R,G,B values use: + +
+fl_color_cube(R * (FL_NUM_RED - 1) / 255, + G * (FL_NUM_GREEN - 1) / 255, + B * (FL_NUM_BLUE - 1) / 255); ++ + + +
+#include <FL/Enumerations.H> ++ +
+Fl_Color fl_contrast(Fl_Color fg, Fl_Color bg); ++ +
Returns the foreground color if it contrasts sufficiently
+with the background color. Otherwise, returns
+FL_WHITE or FL_BLACK depending on
+which color provides the best contrast.
+
+
+
+
+#include <FL/fl_draw.H> ++ +
+void fl_cursor(Fl_Cursor cursor, Fl_Color fg, Fl_Color bg); ++ +
Sets the cursor for the current window to the specified shape
+and colors. The cursors are defined in the <FL/Enumerations.H>
+header file.
+
+
+
+
+#include <FL/Enumerations.H> ++ +
+Fl_Color fl_darker(Fl_Color c); ++ +
Returns a darker version of the specified color. + + + +
+#include <FL/Fl_File_Chooser.H> ++ +
+char *fl_dir_chooser(const char * message, const char *fname, int relative = 0); ++ +
The fl_dir_chooser() function displays a Fl_File_Chooser dialog +so that the user can choose a directory. + +
message is a string used to title the window. + +
fname is a default filename to fill in the chooser +with. If this is NULL then the last filename that was +choosen is used. The first time the file chooser is called this +defaults to a blank string. + +
relative specifies whether the returned filename +should be relative (any non-zero value) or absolute (0). The +default is to return absolute paths. + +
The returned value points at a static buffer that is only +good until the next time fl_dir_chooser() is called. + + + +
+#include <FL/Fl_File_Chooser.H> ++ +
+char *fl_file_chooser(const char * message, const char *pattern, const char *fname, int relative = 0); ++ +
FLTK provides a "tab completion" file chooser that +makes it easy to choose files from large directories. This file +chooser has several unique features, the major one being that +the Tab key completes filenames like it does in Emacs or tcsh, +and the list always shows all possible completions. + +
+
+
fl_file_chooser() pops up the file chooser, waits +for the user to pick a file or Cancel, and then returns a +pointer to that filename or NULL if Cancel is chosen. + +
message is a string used to title the window. + +
pattern is used to limit the files listed in a +directory to those matching the pattern. This matching is done by +fl_filename_match(). +Multiple patterns can be used by separating them with tabs, like +"*.jpg\t*.png\t*.gif\t*". In addition, you can provide +human-readable labels with the patterns inside parenthesis, like +"JPEG Files (*.jpg)\tPNG Files (*.png)\tGIF Files (*.gif)\tAll Files (*)". +Pass NULL to show all files.
+ +fname is a default filename to fill in the chooser +with. If this is NULL then the last filename that was +choosen is used (unless that had a different pattern, in which +case just the last directory with no name is used). The first +time the file chooser is called this defaults to a blank string. + +
relative specifies whether the returned filename +should be relative (any non-zero value) or absolute (0). The +default is to return absolute paths. + +
The returned value points at a static buffer that is only +good until the next time fl_file_chooser() is called. + + + +
+#include <FL/Fl_File_Chooser.H> ++ +
+void fl_file_chooser_callback(void (*cb)(const char *)); ++ +
Sets a function that is called every time the user clicks a +file in the currently popped-up file chooser. This could be used +to preview the contents of the file. It has to be reasonably +fast, and cannot create FLTK windows. + + + +
+#include <FL/Fl_File_Chooser.H> ++ +
+void fl_file_chooser_ok_label(const char *l); ++ +
Sets the label that is shown on the "OK" button in the file +chooser. The default label (fl_ok) can be restored by +passing a NULL pointer for the label string.
+ + + ++#include <FL/filename.H> ++ +
+int fl_filename_absolute(char *to, int tolen, const char *from); +int fl_filename_absolute(char *to, const char *from); ++ +
Converts a relative pathname to an absolute pathname. If +from does not start with a slash, the current working +directory is prepended to from with any occurances of +. and x/.. deleted from the result. The +absolute pathname is copied to to; from and +to may point to the same buffer. +fl_filename_absolute returns non-zero if any changes +were made. + +
The first form accepts a maximum length (tolen) for +the destination buffer, while the second form assumes that the +destination buffer is at least FL_PATH_MAX characters +in length. + + + +
+#include <FL/filename.H> ++ +
+int fl_filename_expand(char *to, int tolen, const char *from); +int fl_filename_expand(char *to, const char *from); ++ +
This function replaces environment variables and home +directories with the corresponding strings. Any occurrence of +$X is replaced by getenv("X"); if +$X is not defined in the environment, the occurrence is +not replaced. Any occurence of ~X is replaced by user +X's home directory; if user X does not exist, +the occurrence is not replaced. Any resulting double slashes +cause everything before the second slash to be deleted. + +
The result is copied to to, and from and +to may point to the same buffer. +fl_filename_expand() returns non-zero if any changes +were made. + +
The first form accepts a maximum length (tolen) for +the destination buffer, while the second form assumes that the +destination buffer is at least FL_PATH_MAX characters +in length. + + + +
+#include <FL/filename.H> ++ +
+const char *fl_filename_ext(const char *f); ++ +
Returns a pointer to the last period in +fl_filename_name(f), or a pointer to the trailing +nul if none is found. + + + +
+#include <FL/filename.H> ++ +
+int fl_filename_isdir(const char *f); ++ +
Returns non-zero if the file exists and is a directory. + + + +
+#include <FL/filename.H> ++ +
+int fl_filename_list(const char *d, dirent ***list, Fl_File_Sort_F *sort = fl_numericsort); ++ +
This is a portable and const-correct wrapper for the +scandir() function. d is the name of a +directory; it does not matter if it has a trailing slash or not. +For each file in that directory a "dirent" structure +is created. The only portable thing about a dirent is that +dirent.d_name is the nul-terminated file name. +An array of pointers to these dirent's is created and a +pointer to the array is returned in *list. The number +of entries is given as a return value. If there is an error +reading the directory a number less than zero is returned, and +errno has the reason; errno does not work +under WIN32. + +
The name of directory always ends in a forward slash '/'. + +
The sort argument specifies a sort function to be used +when on the array of filenames. The following standard sort functions +are provided with FLTK: + +
You can free the returned list of files with the following +code: + +
+for (int i = return_value; i > 0;) {
+ free((void*)(list[--i]));
+}
+
+free((void*)list);
+
+
+
+
++#include <FL/filename.H> ++ +
+int fl_filename_match(const char *f, const char *pattern); ++ +
Returns non-zero if f matches pattern. The +following syntax is used by pattern: + +
+#include <FL/filename.H> ++ +
+const char *fl_filename_name(const char *f); ++ +
Returns a pointer to the character after the last slash, or +to the start of the filename if there is none. + + + +
+#include <FL/filename.H> ++ +
+int fl_filename_relative(char *to, int tolen, const char *from); +int fl_filename_relative(char *to, const char *from); ++ +
Converts an absolute pathname to an relative pathname. The +relative pathname is copied to to; from and +to may point to the same buffer. +fl_filename_relative returns non-zero if any changes +were made. + +
The first form accepts a maximum length (tolen) for +the destination buffer, while the second form assumes that the +destination buffer is at least FL_PATH_MAX characters +in length. + + + +
+#include <FL/filename.H> ++ +
+char *fl_filename_setext(char *to, int tolen, const char *ext); +char *fl_filename_setext(char *to, const char *ext); ++ +
Replaces the extension in to with the extension in +ext. Returns a pointer to to. + +
The first form accepts a maximum length (tolen) for +the destination buffer, while the second form assumes that the +destination buffer is at least FL_PATH_MAX characters +in length. + + + +
+#include <FL/fl_draw.H> ++ +
+Fl_Color fl_gray_ramp(int i); ++ +
Returns a gray color value from black (i == 0) to +white (i == FL_NUM_GRAY - 1). FL_NUM_GRAY is +defined to be 24 in the current FLTK release. To get the closest +FLTK gray value to an 8-bit grayscale color 'I' use: + +
+fl_gray_ramp(I * (FL_NUM_GRAY - 1) / 255) ++ + + +
+#include <FL/Enumerations.H> ++ +
+Fl_Color fl_inactive(Fl_Color c); ++ +
Returns the inactive, dimmed version of the give color + + + +
+#include <FL/fl_ask.H> ++ +
+const char *fl_input(const char *label, const char *deflt = 0, ...); ++ +
Pops up a window displaying a string, lets the user edit it, and +returns the new value. The function returns NULL if the +Cancel button is hit or another dialog box is still open. +The returned pointer is only valid until the +next time fl_input() is called. +Due to back-compatibility, the arguments to any printf commands +in the label are after the default value. + +
Note: Common dialog boxes are application modal. +No more than one common dialog box can be open at any time. +Requests for additional dialog boxes are ignored.
+ +
+
+
+
+
+#include <FL/Enumerations.H> ++ +
+Fl_Color fl_lighter(Fl_Color c); ++ +
Returns a lighter version of the specified color. + + + +
+#include <FL/fl_ask.H> ++ +
+void fl_message(const char *, ...); ++ +
Displays a printf-style message in a pop-up box with an +"OK" button, waits for the user to hit the button. +The message will wrap to fit the window, or may be many lines by +putting \n characters into it. The enter key is a +shortcut for the OK button. + +
The message text is limited to 1024 characters. + +
Note: Common dialog boxes are application modal. +No more than one common dialog box can be open at any time. +Requests for additional dialog boxes are ignored.
+ +
+
+
+
+
+#include <FL/fl_ask.H> ++ +
+void fl_message_font(Fl_Font fontid, uchar size); ++ +
Changes the font and font size used for the messages in all +the popups. + + + +
+#include <FL/fl_ask.H> ++ +
+Fl_Widget *fl_message_icon(); ++ +
Returns a pointer to the box at the left edge of all the +popups. You can alter the font, color, label, or image before +calling the functions. + + + +
+#include <FL/filename.H> ++ +
+void fl_open_uri(const char *uri, char *msg = (char *)0, int msglen = 0); ++ +
fl_open_uri() opens the specified Uniform Resource Identifier (URI) using an operating-system dependent program or interface. For URIs using the "ftp", "http", or "https" schemes, the system default web browser is used to open the URI, while "mailto" and "news" URIs are typically opened using the system default mail reader and "file" URIs are opened using the file system navigator.
+ +On success, the (optional) msg buffer is filled with the command that was run to open the URI; on Windows, this will always be "open uri".
+ +On failure, the msg buffer is filled with an English error message.
+ + + ++#include <FL/fl_ask.H> ++ +
+const char *fl_password(const char *label, const char *deflt = 0, ...); ++ +
Same as fl_input(), except an +Fl_Secret_Input +field is used. + +
Note: Common dialog boxes are application modal. +No more than one common dialog box can be open at any time. +Requests for additional dialog boxes are ignored.
+ + + ++#include <FL/Fl_Shared_Image.H> ++ +
+void fl_register_images(); ++ +
Registers the extra image file formats that are not provided
+as part of the core FLTK library for use with the Fl_Shared_Image
+class.
+
+
This function is provided in the fltk_images
+library.
+
+
+
+
+#include <FL/fl_draw.H> ++ +
+Fl_Color fl_rgb_color(uchar r, uchar g, uchar b); +Fl_Color fl_rgb_color(uchar g); ++ +
Returns the 24-bit RGB color value for the specified 8-bit +RGB or grayscale values. + + + +
+#include <FL/fl_show_colormap.H> ++ +
+Fl_Color fl_show_colormap(Fl_Color oldcol) ++ +
fl_show_colormap() pops up a panel of the 256 colors +you can access with fl_color() and lets +the user pick one of them. It returns the new color index, or +the old one if the user types ESC or clicks outside the window. + +
+
+
+
+
diff --git a/third_party/windows/fltk-1.1.10/documentation/glut.html b/third_party/windows/fltk-1.1.10/documentation/glut.html
new file mode 100644
index 0000000..1669abb
--- /dev/null
+++ b/third_party/windows/fltk-1.1.10/documentation/glut.html
@@ -0,0 +1,196 @@
+
+
This appendix describes the GLUT compatibility header file supplied with FLTK. FLTK's GLUT compatibility is based on the original GLUT 3.7 and the follow-on FreeGLUT 2.4.0 libraries.
+You should be able to compile existing GLUT source code by including <FL/glut.H> instead of <GL/glut.h>. This can be done by editing the source, by changing the -I switches to the compiler, or by providing a symbolic link from GL/glut.h to FL/glut.H.
+All files calling GLUT procedures must be compiled with C++. You may have to alter them slightly to get them to compile without warnings, and you may have to rename them to get make to use the C++ compiler.
+You must link with the FLTK library. Most of FL/glut.H is inline functions. You should take a look at it (and maybe at test/glpuzzle.cxx in the FLTK source) if you are having trouble porting your GLUT program.
+This has been tested with most of the demo programs that come with the GLUT and FreeGLUT distributions.
+The following functions and/or arguments to functions are missing, and +you will have to replace them or comment them out for your code to +compile: +
The strings passed as menu labels are not copied.
+glutPostRedisplay() does not work if called from inside a +display function. You must use glutIdleFunc() if you want +your display to update continuously.
+glutSwapBuffers() does not work from inside a display +function. This is on purpose, because FLTK swaps the buffers for you.
+glutUseLayer() does not work well, and should only be used +to initialize transformations inside a resize callback. You should +redraw overlays by using glutOverlayDisplayFunc().
+Overlays are cleared before the overlay display function is called. +glutLayerGet(GLUT_OVERLAY_DAMAGED) always returns true for +compatibility with some GLUT overlay programs. You must rewrite your +code so that gl_color() is used to choose colors in an +overlay, or you will get random overlay colors.
+glutSetCursor(GLUT_CURSOR_FULL_CROSSHAIR) just results in a +small crosshair.
+The fonts used by glutBitmapCharacter() and glutBitmapWidth() + may be different.
+glutInit(argc,argv) will consume different switches than +GLUT does. It accepts the switches recognized by +Fl::args(), and will accept any abbreviation of these +switches (such as "-di" for "-display").
++Fl_Gl_Window + | + +----Fl_Glut_Window ++ +
+#include <FL/glut.H> ++ +
The current GLUT window is available in the global variable +glut_window.
+new Fl_Glut_Window(...) is the same as +glutCreateWindow() except it does not show() the window +or make the window current.
+window->make_current() is the same as +glutSetWindow(number). If the window has not had show() + called on it yet, some functions that assumme an OpenGL context will +not work. If you do show() the window, call make_current() + again to set the context.
+~Fl_Glut_Window() is the same as glutDestroyWindow() +.
+| member | +description | +
|---|---|
| display | +A pointer to the function to call to draw the normal planes. | +
| entry | +A pointer to the function to call when the mouse moves into + or out of the window. | +
| keyboard | +A pointer to the function to call when a regular key is pressed. | +
| menu[3] | +The menu to post when one of the mouse buttons is pressed. | +
| mouse | +A pointer to the function to call when a button is pressed or + released. | +
| motion | +A pointer to the function to call when the mouse is moved with + a button down. | +
| overlaydisplay | +A pointer to the function to call to draw the overlay planes. | +
| passivemotion | +A pointer to the function to call when the mouse is moved with + no buttons down. | +
| reshape | +A pointer to the function to call when the window is resized. | +
| special | +A pointer to the function to call when a special key is pressed. | +
| visibility | +A pointer to the function to call when the window is iconified + or restored (made visible.) | +
+ ![]() |
+
+ FLTK 1.1.10 Programming Manual+Revision 10 by Michael Sweet, Craig P. Earls, |
+
| This software and manual are provided under the terms of the GNU Library General Public License. Permission is granted to reproduce this manual or any portion for any purpose, provided this copyright and permission notice are preserved. | +|
|---|---|
| Preface
+ + + 1 - Introduction to FLTK + + + 2 - FLTK Basics + + + 3 - Common Widgets and Attributes +
+ + 5 - Drawing Things in FLTK + + + 6 - Handling Events + + 7 - Adding and Extending + Widgets + + + 8 - Using OpenGL + |
+
+ 9 - Programming with FLUID
+
+ 10 - Advanced FLTK
+ + + A - Class Reference + + + B - Function Reference + + + C - FLTK Enumerations.H + + + + D - GLUT Compatibility + + E - Forms Compatibility + + + F - Operating System Issues + + + G - Migrating Code from FLTK 1.0.x + + + H - Software License + + + I - Example Source Code + |
+
The Fast Light Tool Kit ("FLTK", pronounced +"fulltick") is a cross-platform C++ GUI toolkit for +UNIX®/Linux® (X11), Microsoft® Windows®, and +MacOS® X. FLTK provides modern GUI functionality without the +bloat and supports 3D graphics via OpenGL® and its built-in +GLUT emulation. It was originally developed by Mr. Bill Spitzak +and is currently maintained by a small group of developers +across the world with a central repository in the US.
+ +It has always been Bill's belief that the GUI API of all +modern systems is much too high level. Toolkits (even FLTK) are +not what should be provided and documented as part of an +operating system. The system only has to provide arbitrary +shaped but featureless windows, a powerful set of graphics +drawing calls, and a simple unalterable method of +delivering events to the owners of the windows. NeXT (if you +ignored NextStep) provided this, but they chose to hide it and +tried to push their own baroque toolkit instead.
+ +Many of the ideas in FLTK were developed on a NeXT (but +not using NextStep) in 1987 in a C toolkit Bill called +"views". Here he came up with passing events downward +in the tree and having the handle routine return a value +indicating whether it used the event, and the table-driven menus. In +general he was trying to prove that complex UI ideas could be +entirely implemented in a user space toolkit, with no knowledge +or support by the system.
+ +After going to film school for a few years, Bill worked at +Sun Microsystems on the (doomed) NeWS project. Here he found an +even better and cleaner windowing system, and he reimplemented +"views" atop that. NeWS did have an unnecessarily +complex method of delivering events which hurt it. But the +designers did admit that perhaps the user could write just as +good of a button as they could, and officially exposed the lower +level interface.
+ +With the death of NeWS Bill realized that he would have to +live with X. The biggest problem with X is the "window +manager", which means that the toolkit can no longer +control the window borders or drag the window around.
+ +At Digital Domain Bill discovered another toolkit, +"Forms". Forms was similar to his work, but provided +many more widgets, since it was used in many real applications, +rather then as theoretical work. He decided to use Forms, except +he integrated his table-driven menus into it. Several very large +programs were created using this version of Forms.
+ +The need to switch to OpenGL and GLX, portability, and a +desire to use C++ subclassing required a rewrite of Forms. +This produced the first version of FLTK. The conversion to C++ +required so many changes it made it impossible to recompile any +Forms objects. Since it was incompatible anyway, Bill decided +to incorporate his older ideas as much as possible by +simplifying the lower level interface and the event passing +mechanism.
+ +Bill received permission to release it for free on the +Internet, with the GNU general public license. Response from +Internet users indicated that the Linux market dwarfed the SGI +and high-speed GL market, so he rewrote it to use X for all +drawing, greatly speeding it up on these machines. That is the +version you have now.
+ +Digital Domain has since withdrawn support for FLTK. While +Bill is no longer able to actively develop it, he still +contributes to FLTK in his free time and is a part of the FLTK +development team.
+ +FLTK was designed to be statically linked. This was done by +splitting it into many small objects and designing it so that +functions that are not used do not have pointers to them in the +parts that are used, and thus do not get linked in. This allows +you to make an easy-to-install program or to modify FLTK to +the exact requirements of your application without worrying +about bloat. FLTK works fine as a shared library, though, and +is now included with several Linux distributions.
+ +Here are some of the core features unique to FLTK:
+ +FLTK comes with complete free source code. FLTK is available +under the terms of the GNU Library +General Public License with exceptions that allow for static +linking. Contrary to popular belief, it can be used in +commercial software - even Bill Gates could use it!
+ +FLTK was originally designed to be compatible with the Forms +Library written for SGI machines. In that library all the +functions and structures started with "fl_". This +naming was extended to all new methods and widgets in the C++ +library, and this prefix was taken as the name of the library. +It is almost impossible to search for "FL" on the +Internet, due to the fact that it is also the abbreviation for +Florida. After much debating and searching for a new name for +the toolkit, which was already in use by several people, Bill +came up with "FLTK", including a bogus excuse that it +stands for "The Fast Light Toolkit".
+ +In most cases you can just type "make". This will +run configure with the default of no options and then compile +everything.
+ +FLTK uses GNU autoconf to configure itself for your UNIX +platform. The main things that the configure script will look +for are the X11 and OpenGL (or Mesa) header and library files. +If these cannot be found in the standard include/library +locations you'll need to define the CFLAGS, +CXXFLAGS, and LDFLAGS environment variables. +For the Bourne and Korn shells you'd use:
+ ++CFLAGS=-Iincludedir; export CFLAGS +CXXFLAGS=-Iincludedir; export CXXFLAGS +LDFLAGS=-Llibdir; export LDFLAGS ++ +
For C shell and tcsh, use:
+ ++setenv CFLAGS "-Iincludedir" +setenv CXXFLAGS "-Iincludedir" +setenv LDFLAGS "-Llibdir" ++ +
By default configure will look for a C++ compiler named +CC, c++, g++, or gcc in that +order. To use another compiler you need to set the CXX +environment variable:
+ ++CXX=xlC; export CXX +setenv CXX "xlC" ++ +
The CC environment variable can also be used to +override the default C compiler (cc or gcc), +which is used for a few FLTK source files.
+ +You can run configure yourself to get the exact setup you +need. Type "./configure <options>", where +options are:
+ +When the configure script is done you can just run the +"make" command. This will build the library, FLUID +tool, and all of the test programs.
+ +To install the library, become root and type "make +install". This will copy the "fluid" executable +to "bindir", the header files to +"includedir", and the library files to +"libdir".
+ +There are three ways to build FLTK under Microsoft Windows. +The first is to use the Visual C++ 5.0 project files under the +"visualc" directory. Just open (or double-click on) +the "fltk.dsw" file to get the whole shebang.
+ +The second method is to use the configure script +included with the FLTK software; this has only been tested with +the CygWin tools:
+ ++sh configure --prefix=C:/FLTK +make ++ +
The final method is to use a GNU-based development tool with +the files in the "makefiles" directory. To build +using one of these tools simply copy the appropriate +makeinclude and config files to the main directory and do a +make:
+ ++copy makefiles\Makefile.<env> Makefile +make ++ +
The "fltkdll.dsp" project file builds a DLL-version +of the FLTK library. Because of name mangling differences +between PC compilers (even between different versions of Visual +C++!) you can only use the DLL that is generated with the same +version compiler that you built it with.
+ +When compiling an application or DLL that uses the FLTK DLL, +you will need to define the FL_DLL preprocessor symbol +to get the correct linkage commands embedded within the FLTK +header files.
+ +The current OS/2 build requires XFree86 for OS/2 to work. A +native Presentation Manager version has not been implemented +yet (volunteers are welcome!).
+ +The current set of Makefiles/configuration failes assumes that +EMX 0.9d and libExt +(from 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:
+ ++copy makefiles\Makefile.os2x Makefile +make ++ +
FLTK is available on the 'net in a bunch of locations:
+ +To send a message to the FLTK mailing list +("fltk@fltk.org") you must first join the list. +Non-member submissions are blocked to avoid problems with +unsolicited email.
+ +To join the FLTK mailing list, send a message to +"majordomo@fltk.org" with "subscribe fltk" +in the message body. A digest of this list is available by +subscribing to the "fltk-digest" mailing list.
+ +To report a bug in FLTK, send an email to +"fltk-bugs@fltk.org". Please include the FLTK version, +operating system & version, and compiler that you are using +when describing the bug or problem. We will be unable to provide +any kind of help without that basic information.
+ +Bugs can also be reported to the "fltk.bugs" newsgroup or on the +SourceForge bug tracker pages.
+ +For general support and questions, please use the FLTK mailing list +at "fltk@fltk.org" or one of the newsgroups.
+ + + diff --git a/third_party/windows/fltk-1.1.10/documentation/license.html b/third_party/windows/fltk-1.1.10/documentation/license.html new file mode 100644 index 0000000..558b9a0 --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/license.html @@ -0,0 +1,442 @@ + + +December 11, 2001
+ +The FLTK library and included programs are provided under the terms +of the GNU Library General Public License (LGPL) with the following +exceptions:
+ +GNU LIBRARY GENERAL PUBLIC LICENSE
+Version 2, June 1991
+
Copyright (C) 1991 Free Software Foundation, Inc.
+
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+
Everyone is permitted to copy and distribute verbatim copies of
+this license document, but changing it is not allowed.
+
[This is the first released version of the library GPL. It is
+numbered 2 because it goes with version 2 of the ordinary GPL.]
Preamble
+ The licenses for most software are designed to take away your freedom +to share and change it. By contrast, the GNU General Public Licenses +are intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. +This license, the Library General Public License, applies to some +specially designated Free Software Foundation software, and to any +other libraries whose authors decide to use it. You can use it for +your libraries, too.
+When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it in +new free programs; and that you know you can do these things.
+To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the library, or if you modify it.
+For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link a program with the library, you must provide +complete object files to the recipients so that they can relink them +with the library, after making changes to the library and recompiling +it. And you must show them these terms so they know their rights.
+Our method of protecting your rights has two steps: (1) copyright +the library, and (2) offer you this license which gives you legal +permission to copy, distribute and/or modify the library.
+Also, for each distributor's protection, we want to make certain +that everyone understands that there is no warranty for this free +library. If the library is modified by someone else and passed on, we +want its recipients to know that what they have is not the original +version, so that any problems introduced by others will not reflect on +the original authors' reputations.
+Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that companies distributing free +software will individually obtain patent licenses, thus in effect +transforming the program into proprietary software. To prevent this, +we have made it clear that any patent must be licensed for everyone's +free use or not licensed at all.
+Most GNU software, including some libraries, is covered by the +ordinary GNU General Public License, which was designed for utility +programs. This license, the GNU Library General Public License, +applies to certain designated libraries. This license is quite +different from the ordinary one; be sure to read it in full, and don't +assume that anything in it is the same as in the ordinary license.
+The reason we have a separate public license for some libraries is +that they blur the distinction we usually make between modifying or +adding to a program and simply using it. Linking a program with a +library, without changing the library, is in some sense simply using +the library, and is analogous to running a utility program or +application program. However, in a textual and legal sense, the linked +executable is a combined work, a derivative of the original library, +and the ordinary General Public License treats it as such.
+Because of this blurred distinction, using the ordinary General +Public License for libraries did not effectively promote software +sharing, because most developers did not use the libraries. We +concluded that weaker conditions might promote sharing better.
+However, unrestricted linking of non-free programs would deprive the +users of those programs of all benefit from the free status of the +libraries themselves. This Library General Public License is intended +to permit developers of non-free programs to use free libraries, while +preserving your freedom as a user of such programs to change the free +libraries that are incorporated in them. (We have not seen how to +achieve this as regards changes in header files, but we have achieved +it as regards changes in the actual functions of the Library.) The +hope is that this will lead to faster development of free libraries.
+The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the libary" and a "work that uses the library". The +former contains code derived from the library, while the latter only +works together with the library.
+Note that it is possible for a library to be covered by the ordinary +General Public License rather than by this special one.
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND +MODIFICATION
+0. This License Agreement applies to any software +library which contains a notice placed by the copyright holder or other +authorized party saying it may be distributed under the terms of this +Library General Public License (also called "this License"). Each +licensee is addressed as "you". +A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables.
+The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".)
+"Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control +compilation and installation of the library.
+Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does and +what the program that uses the Library does.
+1. You may copy and distribute verbatim copies of +the Library's complete source code as you receive it, in any medium, +provided that you conspicuously and appropriately publish on each copy +an appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the Library.
+You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee.
+2. You may modify your copy or copies of the +Library or any portion of it, thus forming a work based on the Library, +and copy and distribute such modifications or work under the terms of +Section 1 above, provided that you also meet all of these conditions:
+a) The modified work must itself be a software +library. ++b) You must cause the files modified to carry +prominent notices stating that you changed the files and the date of +any change.
+c) You must cause the whole of the work to be +licensed at no charge to all third parties under the terms of this +License.
+d) If a facility in the modified Library refers to +a function or a table of data to be supplied by an application program +that uses the facility, other than as an argument passed when the +facility is invoked, then you must make a good faith effort to ensure +that, in the event an application does not supply such function or +table, the facility still operates, and performs whatever part of its +purpose remains meaningful.
+(For example, a function in a library to compute square roots has a +purpose that is entirely well-defined independent of the application. + Therefore, Subsection 2d requires that any application-supplied +function or table used by this function must be optional: if the +application does not supply it, the square root function must still +compute square roots.)
+
These requirements apply to the modified work as a whole. +If identifiable sections of that work are not derived from the +Library, and can be reasonably considered independent and separate +works in themselves, then this License, and its terms, do not apply to +those sections when you distribute them as separate works. But when +you distribute the same sections as part of a whole which is a work +based on the Library, the distribution of the whole must be on the +terms of this License, whose permissions for other licensees extend to +the entire whole, and thus to each and every part regardless of who +wrote it.
+Thus, it is not the intent of this section to claim rights or +contest your rights to work written entirely by you; rather, the intent +is to exercise the right to control the distribution of derivative or +collective works based on the Library.
+In addition, mere aggregation of another work not based on the +Library with the Library (or with a work based on the Library) on a +volume of a storage or distribution medium does not bring the other +work under the scope of this License.
+3. You may opt to apply the terms of the ordinary +GNU General Public License instead of this License to a given copy of +the Library. To do this, you must alter all the notices that refer to +this License, so that they refer to the ordinary GNU General Public +License, version 2, instead of to this License. (If a newer version +than version 2 of the ordinary GNU General Public License has appeared, +then you can specify that version instead if you wish.) Do not make +any other change in these notices.
+Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy.
+This option is useful when you wish to copy part of the code of the +Library into a program that is not a library.
+4. You may copy and distribute the Library (or a +portion or derivative of it, under Section 2) in object code or +executable form under the terms of Sections 1 and 2 above provided that +you accompany it with the complete corresponding machine-readable +source code, which must be distributed under the terms of Sections 1 +and 2 above on a medium customarily used for software interchange.
+If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to distribute +the source code, even though third parties are not compelled to copy +the source along with the object code.
+5. A program that contains no derivative of any +portion of the Library, but is designed to work with the Library by +being compiled or linked with it, is called a "work that uses the +Library". Such a work, in isolation, is not a derivative work of the +Library, and therefore falls outside the scope of this License.
+However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. Section +6 states terms for distribution of such executables.
+When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law.
+If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.)
+Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, whether +or not they are linked directly with the Library itself.
+6. As an exception to the Sections above, you may +also compile or link a "work that uses the Library" with the Library to +produce a work containing portions of the Library, and distribute that +work under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications.
+You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things:
a) Accompany the work +with the complete corresponding machine-readable source code for the +Library including whatever changes were used in the work (which must +be distributed under Sections 1 and 2 above); and, if the work is an +executable linked with the Library, with the complete machine-readable +"work that uses the Library", as object code and/or source code, so +that the user can modify the Library and then relink to produce a +modified executable containing the modified Library. (It is +understood that the user who changes the contents of definitions files +in the Library will not necessarily be able to recompile the +application to use the modified definitions.) ++b) Accompany the work with a written offer, valid +for at least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more than the cost +of performing this distribution.
+c) If distribution of the work is made by offering +access to copy from a designated place, offer equivalent access to +copy the above specified materials from the same place.
+d) Verify that the user has already received a copy +of these materials or that you have already sent this user a copy.
+
For an executable, the required form of the "work that +uses the Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the source code distributed need not include anything that is normally +distributed (in either source or binary form) with the major components +(compiler, kernel, and so on) of the operating system on which the +executable runs, unless that component itself accompanies the +executable.
+It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute.
+7. You may place library facilities that are a work +based on the Library side-by-side in a single library together with +other library facilities not covered by this License, and distribute +such a combined library, provided that the separate distribution of the +work based on the Library and of the other library facilities is +otherwise permitted, and provided that you do these two things:
+a) Accompany the combined library with a copy of the +same work based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the Sections +above. ++b) Give prominent notice with the combined library +of the fact that part of it is a work based on the Library, and +explaining where to find the accompanying uncombined form of the same +work.
+
8. You may not copy, modify, sublicense, +link with, or distribute the Library except as expressly provided under +this License. Any attempt otherwise to copy, modify, sublicense, link +with, or distribute the Library is void, and will automatically +terminate your rights under this License. However, parties who have +received copies, or rights, from you under this License will not have +their licenses terminated so long as such parties remain in full +compliance.
+9. You are not required to accept this License, +since you have not signed it. However, nothing else grants you +permission to modify or distribute the Library or its derivative works. + These actions are prohibited by law if you do not accept this License. + Therefore, by modifying or distributing the Library (or any work based +on the Library), you indicate your acceptance of this License to do so, +and all its terms and conditions for copying, distributing or modifying +the Library or works based on it.
+10. Each time you redistribute the Library (or any +work based on the Library), the recipient automatically receives a +license from the original licensor to copy, distribute, link with or +modify the Library subject to these terms and conditions. You may not +impose any further restrictions on the recipients' exercise of the +rights granted herein. You are not responsible for enforcing compliance +by third parties to this License.
+11. If, as a consequence of a court judgment or +allegation of patent infringement or for any other reason (not limited +to patent issues), conditions are imposed on you (whether by court +order, agreement or otherwise) that contradict the conditions of this +License, they do not excuse you from the conditions of this License. + If you cannot distribute so as to satisfy simultaneously your +obligations under this License and any other pertinent obligations, +then as a consequence you may not distribute the Library at all. For +example, if a patent license would not permit royalty-free +redistribution of the Library by all those who receive copies directly +or indirectly through you, then the only way you could satisfy both it +and this License would be to refrain entirely from distribution of the +Library.
+If any portion of this section is held invalid or unenforceable +under any particular circumstance, the balance of the section is +intended to apply, and the section as a whole is intended to apply in +other circumstances.
+It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is implemented +by public license practices. Many people have made generous +contributions to the wide range of software distributed through that +system in reliance on consistent application of that system; it is up +to the author/donor to decide if he or she is willing to distribute +software through any other system and a licensee cannot impose that +choice.
+This section is intended to make thoroughly clear what is believed +to be a consequence of the rest of this License.
+12. If the distribution and/or use of the Library +is restricted in certain countries either by patents or by copyrighted +interfaces, the original copyright holder who places the Library under +this License may add an explicit geographical distribution limitation +excluding those countries, so that distribution is permitted only in or +among countries not thus excluded. In such case, this License +incorporates the limitation as if written in the body of this License.
+13. The Free Software Foundation may publish +revised and/or new versions of the Library General Public License from +time to time. Such new versions will be similar in spirit to the +present version, but may differ in detail to address new problems or +concerns.
+Each version is given a distinguishing version number. If the +Library specifies a version number of this License which applies to it +and "any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation.
+14. If you wish to incorporate parts of the Library +into other free programs whose distribution conditions are incompatible +with these, write to the author to ask for permission. For software +which is copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally.
+NO WARRANTY
+15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, +THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT +WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE +OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU +ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW +OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY +WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE +LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL +OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES.
+END OF TERMS AND CONDITIONS
+ + + diff --git a/third_party/windows/fltk-1.1.10/documentation/menu.gif b/third_party/windows/fltk-1.1.10/documentation/menu.gif new file mode 100644 index 0000000..6ed0f6d Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/menu.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/menu_button.gif b/third_party/windows/fltk-1.1.10/documentation/menu_button.gif new file mode 100644 index 0000000..9fc5df0 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/menu_button.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/menubar.gif b/third_party/windows/fltk-1.1.10/documentation/menubar.gif new file mode 100644 index 0000000..5c6c944 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/menubar.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/migration.html b/third_party/windows/fltk-1.1.10/documentation/migration.html new file mode 100644 index 0000000..df13fa2 --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/migration.html @@ -0,0 +1,163 @@ + + +This appendix describes the differences between the FLTK +1.0.x and FLTK 1.1.x functions and classes.
+ +Color values are now stored in a 32-bit unsigned integer +instead of the unsigned character in 1.0.x. This allows for the +specification of 24-bit RGB values or 8-bit FLTK color indices. + +
FL_BLACK and FL_WHITE now remain black and +white, even if the base color of the gray ramp is changed using +Fl::background(). +FL_DARK3 and FL_LIGHT3 can be used instead to +draw a very dark or a very bright background hue.
+ +Widgets use the new color symbols FL_FORGROUND_COLOR, +FL_BACKGROUND_COLOR, FL_BACKGROUND2_COLOR, +FL_INACTIVE_COLOR, and FL_SELECTION_COLOR. +More details can be found in the chapter +Enumerations.
+ +The FLTK clipboard is now broken into two parts - a local +selection value and a cut-and-paste value. This allows FLTK to +support things like highlighting and replacing text that was +previously cut or copied, which makes FLTK applications behave +like traditional GUI applications. + +
The file chooser in FLTK 1.1.x is significantly different +than the one supplied with FLTK 1.0.x. Any code that directly +references the old FCB class or members will need +to be ported to the new Fl_File_Chooser +class.
+ +Some function names have changed from FLTK 1.0.x to 1.1.x in
+order to avoid name space collisions. You can still use the old
+function names by defining the FLTK_1_0_COMPAT
+symbol on the command-line when you compile
+(-DFLTK_1_0_COMPAT) or in your source, e.g.:
+
+
+#define FLTK_1_0_COMPAT +#include <FL/Fl.H> +#include <FL/Enumerations.H> +#include <FL/filename.H> ++ +
The following table shows the old and new function names:
+ +| Old 1.0.x Name | +New 1.1.x Name | +
|---|---|
| contrast() | +fl_contrast() | +
| down() | +fl_down() | +
| filename_absolute() | +fl_filename_absolute() | +
| filename_expand() | +fl_filename_expand() | +
| filename_ext() | +fl_filename_ext() | +
| filename_isdir() | +fl_filename_isdir() | +
| filename_list() | +fl_filename_list() | +
| filename_match() | +fl_filename_match() | +
| filename_name() | +fl_filename_name() | +
| filename_relative() | +fl_filename_relative() | +
| filename_setext() | +fl_filename_setext() | +
| frame() | +fl_frame() | +
| inactive() | +fl_inactive() | +
| numericsort() | +fl_numericsort() | +
Image support in FLTK has been significantly revamped in +1.1.x. The Fl_Image class +is now a proper base class, with the core image drawing +functionality in the Fl_Bitmap, Fl_Pixmap, and Fl_RGB_Image classes. + +
BMP, GIF, JPEG, PNG, XBM, and XPM image files can now be +loaded using the appropriate image classes, and the Fl_Shared_Image class +can be used to cache images in memory. + +
Image labels are no longer provided as an add-on label type. +If you use the old label() methods on an image, the +widget's image() method is called to set the image +as the label. + +
Image labels in menu items must still use the old labeltype +mechanism to preserve source compatibility. + +
FLTK 1.1.x now supports keyboard navigation and control with
+all widgets. To restore the old FLTK 1.0.x behavior so that only
+text widgets get keyboard focus, call the Fl::visible_focus()
+method to disable it:
+
+
+Fl::visible_focus(0); ++ + + diff --git a/third_party/windows/fltk-1.1.10/documentation/opengl.html b/third_party/windows/fltk-1.1.10/documentation/opengl.html new file mode 100644 index 0000000..fa5975c --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/opengl.html @@ -0,0 +1,467 @@ + + +
This chapter discusses using FLTK for your OpenGL applications. + +
The easiest way to make an OpenGL display is to subclass Fl_Gl_Window. +Your subclass must implement a draw() method which uses +OpenGL calls to draw the display. Your main program should call +redraw() when the display needs to change, and +(somewhat later) FLTK will call draw(). + +
With a bit of care you can also use OpenGL to draw into +normal FLTK windows. This allows you to use Gouraud shading for +drawing your widgets. To do this you use the gl_start() and gl_finish() functions around your +OpenGL code.
+ +You must include FLTK's <FL/gl.h> header +file. It will include the file <GL/gl.h>, define +some extra drawing functions provided by FLTK, and include the +<windows.h> header file needed by WIN32 +applications.
+ +To make a subclass of Fl_Gl_Window, you must provide: + +
If your subclass provides static controls in the window, they +must be redrawn whenever the FL_DAMAGE_ALL bit is set +in the value returned by damage(). For double-buffered +windows you will need to surround the drawing code with the +following code to make sure that both buffers are redrawn: + +
+#ifndef MESA +glDrawBuffer(GL_FRONT_AND_BACK); +#endif // !MESA +... draw stuff here ... +#ifndef MESA +glDrawBuffer(GL_BACK); +#endif // !MESA ++ +
| Note:
+
+ If you are using the Mesa graphics library, the call + to glDrawBuffer() is not required and will slow + down drawing considerably. The preprocessor instructions + shown above will optimize your code based upon the + graphics library used. + + |
+
+
To define the subclass you just subclass the +Fl_Gl_Window class: + +
+class MyWindow : public Fl_Gl_Window {
+ void draw();
+ int handle(int);
+
+public:
+ MyWindow(int X, int Y, int W, int H, const char *L)
+ : Fl_Gl_Window(X, Y, W, H, L) {}
+};
+
+
+The draw() and handle() methods are +described below. Like any widget, you can include additional +private and public data in your class (such as scene graph +information, etc.) + +
The draw() method is where you actually do your +OpenGL drawing: + +
+void MyWindow::draw() {
+ if (!valid()) {
+ ... set up projection, viewport, etc ...
+ ... window size is in w() and h().
+ ... valid() is turned on by FLTK after draw() returns
+ }
+ ... draw ...
+}
+
+
+The handle() method handles mouse and keyboard +events for the window: + +
+int MyWindow::handle(int event) {
+ switch(event) {
+ case FL_PUSH:
+ ... mouse down event ...
+ ... position in Fl::event_x() and Fl::event_y()
+ return 1;
+ case FL_DRAG:
+ ... mouse moved while down event ...
+ return 1;
+ case FL_RELEASE:
+ ... mouse up event ...
+ return 1;
+ case FL_FOCUS :
+ case FL_UNFOCUS :
+ ... Return 1 if you want keyboard events, 0 otherwise
+ return 1;
+ case FL_KEYBOARD:
+ ... keypress, key is in Fl::event_key(), ascii in Fl::event_text()
+ ... Return 1 if you understand/use the keyboard event, 0 otherwise...
+ return 1;
+ case FL_SHORTCUT:
+ ... shortcut, key is in Fl::event_key(), ascii in Fl::event_text()
+ ... Return 1 if you understand/use the shortcut event, 0 otherwise...
+ return 1;
+ default:
+ // pass other events to the base class...
+ return Fl_Gl_Window::handle(event);
+ }
+}
+
+
+When handle() is called, the OpenGL context is not +set up! If your display changes, you should call +redraw() and let draw() do the work. Don't +call any OpenGL drawing functions from inside handle()! + +
You can call some OpenGL stuff like hit detection and texture +loading functions by doing:
+ +
+ case FL_PUSH:
+ make_current(); // make OpenGL context current
+ if (!valid()) {
+ ... set up projection exactly the same as draw ...
+ valid(1); // stop it from doing this next time
+ }
+ ... ok to call NON-DRAWING OpenGL code here, such as hit
+ detection, loading textures, etc...
+
+
+Your main program can now create one of your windows by doing +new MyWindow(...). You can also use FLUID by: + +
You must put glwindow->show() in your main code +after calling show() on the window containing the +OpenGL window. + +
You can put OpenGL code into an Fl_Widget::draw() +method or into the code for a boxtype or other places with some +care. + +
Most importantly, before you show any windows, +including those that don't have OpenGL drawing, you must +initialize FLTK so that it knows it is going to use OpenGL. You +may use any of the symbols described for Fl_Gl_Window::mode() +to describe how you intend to use OpenGL:
+ ++Fl::gl_visual(FL_RGB); ++ +
You can then put OpenGL drawing code anywhere you can draw +normally by surrounding it with: + +
+gl_start(); +... put your OpenGL code here ... +gl_finish(); ++ +
gl_start() and gl_finish() set up an OpenGL +context with an orthographic projection so that 0,0 is the +lower-left corner of the window and each pixel is one unit. The +current clipping is reproduced with OpenGL glScissor() +commands. These functions also synchronize the OpenGL graphics stream +with the drawing done by other X, WIN32, or FLTK functions. + +
The same context is reused each time. If your code changes +the projection transformation or anything else you should use +glPushMatrix() and glPopMatrix() functions to +put the state back before calling gl_finish().
+ +You may want to use Fl_Window::current()->h() to +get the drawable height so that you can flip the Y +coordinates.
+ +Unfortunately, there are a bunch of limitations you must +adhere to for maximum portability:
+ +Do not call gl_start() or +gl_finish() when drawing into an Fl_Gl_Window! + +
FLTK provides some useful OpenGL drawing functions. They can +be freely mixed with any OpenGL calls, and are defined by +including <FL/gl.H> which you should include +instead of the OpenGL header <GL/gl.h>. + +
Sets the current OpenGL color to a FLTK color. For +color-index modes it will use fl_xpixel(c), which is +only right if this window uses the default colormap! + +
Outlines or fills a rectangle with the current color. If Fl_Gl_Window::ortho() +has been called, then the rectangle will exactly fill the pixel +rectangle passed. + +
Sets the current OpenGL font to the same font you get by +calling fl_font(). + +
Returns information about the current OpenGL font. + +
Draws a nul-terminated string or an array of n +characters in the current OpenGL font at the current raster +position. + +
Draws a nul-terminated string or an array of n +characters in the current OpenGL font at the given position. + +
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 fl_draw(). + +
Performance of Fl_Gl_Window may be improved on some types of +OpenGL implementations, in particular MESA and other software +emulators, by setting the GL_SWAP_TYPE environment +variable. This variable declares what is in the backbuffer after +you do a swapbuffers. + +
This indicates that the back buffer is copied to the + front buffer, and still contains it's old data. This is + true of many hardware implementations. Setting this + will speed up emulation of overlays, and widgets that + can do partial update can take advantage of this as + damage() will not be cleared to -1.
+ +
This indicates that nothing changes the back buffer + except drawing into it. This is true of MESA and Win32 + software emulation and perhaps some hardware emulation + on systems with lots of memory.
+ +
This is easily tested by running the gl_overlay demo +program and seeing if the display is correct when you drag +another window over it or if you drag the window off the screen +and back on. You have to exit and run the program again for it +to see any changes to the environment variable. + +
OpenGL +Optimizer is a scene graph toolkit for OpenGL available from +Silicon Graphics for IRIX and Microsoft Windows. It allows you +to view large scenes without writing a lot of OpenGL code. + +
To use OpenGL Optimizer with FLTK you'll need to create a +subclass of Fl_Gl_Widget that includes several state +variables: + +
+class OptimizerWindow : public Fl_Gl_Window {
+ csContext *context_; // Initialized to 0 and set by draw()...
+ csDrawAction *draw_action_; // Draw action...
+ csGroup *scene_; // Scene to draw...
+ csCamara *camera_; // Viewport for scene...
+
+ void draw();
+
+public:
+ OptimizerWindow(int X, int Y, int W, int H, const char *L)
+ : Fl_Gl_Window(X, Y, W, H, L) {
+ context_ = (csContext *)0;
+ draw_action_ = (csDrawAction *)0;
+ scene_ = (csGroup *)0;
+ camera_ = (csCamera *)0;
+ }
+
+ void scene(csGroup *g) { scene_ = g; redraw(); }
+
+ void camera(csCamera *c) {
+ camera_ = c;
+ if (context_) {
+ draw_action_->setCamera(camera_);
+ camera_->draw(draw_action_);
+ redraw();
+ }
+ }
+};
+
+
+The camera() method sets the camera (projection and +viewpoint) to use when drawing the scene. The scene is redrawn after +this call. + +
The draw() method performs the needed initialization and does +the actual drawing: + +
+void OptimizerWindow::draw() {
+ if (!context_) {
+ // This is the first time we've been asked to draw; create the
+ // Optimizer context for the scene...
+
+#ifdef WIN32
+ context_ = new csContext((HDC)fl_getHDC());
+ context_->ref();
+ context_->makeCurrent((HDC)fl_getHDC());
+#else
+ context_ = new csContext(fl_display, fl_visual);
+ context_->ref();
+ context_->makeCurrent(fl_display, fl_window);
+#endif // WIN32
+
+ ... perform other context setup as desired ...
+
+ // Then create the draw action to handle drawing things...
+
+ draw_action_ = new csDrawAction;
+ if (camera_) {
+ draw_action_->setCamera(camera_);
+ camera_->draw(draw_action_);
+ }
+ } else {
+#ifdef WIN32
+ context_->makeCurrent((HDC)fl_getHDC());
+#else
+ context_->makeCurrent(fl_display, fl_window);
+#endif // WIN32
+ }
+
+ if (!valid()) {
+ // Update the viewport for this context...
+ context_->setViewport(0, 0, w(), h());
+ }
+
+ // Clear the window...
+ context_->clear(csContext::COLOR_CLEAR | csContext::DEPTH_CLEAR,
+ 0.0f, // Red
+ 0.0f, // Green
+ 0.0f, // Blue
+ 1.0f); // Alpha
+
+ // Then draw the scene (if any)...
+ if (scene_)
+ draw_action_->apply(scene_);
+}
+
+
+The scene() method sets the scene to be drawn. The scene is +a collection of 3D objects in a csGroup. The scene is redrawn +after this call. + + + diff --git a/third_party/windows/fltk-1.1.10/documentation/osissues.html b/third_party/windows/fltk-1.1.10/documentation/osissues.html new file mode 100644 index 0000000..54e6884 --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/osissues.html @@ -0,0 +1,745 @@ + +
+This appendix describes the operating system specific interfaces in FLTK. + +
All programs that need to access the operating system +specific interfaces must include the following header file: + +
+#include <FL/x.H> ++ +
Despite the name, this header file will define the +appropriate interface for your environment. The pages that +follow describe the functionality that is provided for each +operating system. + +
| WARNING:
+
+ The interfaces provided by this header file may + change radically in new FLTK releases. Use them only + when an existing generic FLTK interface is not + sufficient. + + |
+
The UNIX interface provides access to the X Window System +state information and data structures. + +
Installs a function to parse unrecognized events. If FLTK +cannot figure out what to do with an event, it calls each of +these functions (most recent first) until one of them returns +non-zero. If none of them returns non-zero then the event is +ignored. + +
FLTK calls this for any X events it does not recognize, or X +events with a window ID that FLTK does not recognize. You can +look at the X event in the fl_xevent variable.
+ +The argument is the FLTK event type that was not handled, or +zero for unrecognized X events. These handlers are also called +for global shortcuts and some other events that the widget they +were passed to did not handle, for example +FL_SHORTCUT.
+ +This variable contains the most recent X event. + +
This variable contains the time stamp from the most recent X +event that reported it; not all events do. Many X calls like cut +and paste need this value. + +
Returns the XID for a window, or zero if not shown(). + +
Returns the Fl_Window that corresponds to the given +XID, or NULL if not found. This function uses a cache +so it is slightly faster than iterating through the windows +yourself.
+ +This call allows you to supply the X events to FLTK, which +may allow FLTK to cooperate with another toolkit or library. The +return value is non-zero if FLTK understood the event. If the +window does not belong to FLTK and the add_handler() +functions all return 0, this function will return false. + +
Besides feeding events your code should call Fl::flush() +periodically so that FLTK redraws its windows.
+ +This function will call the callback functions. It will not +return until they complete. In particular, if a callback pops up +a modal window by calling fl_ask(), for +instance, it will not return until the modal function +returns.
+ +The following global variables are set before Fl_Widget::draw() is +called, or by Fl_Window::make_current(): + +
+extern Display *fl_display; +extern Window fl_window; +extern GC fl_gc; +extern int fl_screen; +extern XVisualInfo *fl_visual; +extern Colormap fl_colormap; ++ +
You must use them to produce Xlib calls. Don't attempt to change +them. A typical X drawing call is written like this: + +
+XDrawSomething(fl_display, fl_window, fl_gc, ...); ++ +
Other information such as the position or size of the X +window can be found by looking at Fl_Window::current(), +which returns a pointer to the Fl_Window being drawn. + +
Returns the X pixel number used to draw the given FLTK color +index or RGB color. This is the X pixel that fl_color() would use. + +
Convert a name into the red, green, and blue values of a color +by parsing the X11 color names. On other systems, fl_parse_color +can only convert names in hexadecimal encoding, for example #ff8083. + +
Points to the font selected by the most recent fl_font(). This is not +necessarily the current font of fl_gc, which is not set +until fl_draw() is +called. If FLTK was compiled with Xft support, fl_xfont +will usually be 0 and fl_xftfont will contain a pointer +to the XftFont structure instead. + +
If FLTK was compiled with Xft support enabled, fl_xftfont +Points to the xft font selected by the most recent fl_font(). Otherwise +it will be 0. fl_xftfont should be cast to +XftFont*. + +
FLTK uses only a single display, screen, X visual, and X +colormap. This greatly simplifies its internal structure and +makes it much smaller and faster. You can change which it uses +by setting global variables before the first +Fl_Window::show() is called. You may also want to +call Fl::visual(), which is +a portable interface to get a full color and/or double buffered +visual. + +
Set which X display to use. This actually does +putenv("DISPLAY=...") so that child programs +will display on the same screen if called with exec(). +This must be done before the display is opened. This call is +provided under MacOS and WIN32 but it has no effect. + +
The open X display. This is needed as an argument to most +Xlib calls. Don't attempt to change it! This is NULL +before the display is opened. + +
Opens the display. Does nothing if it is already open. This +will make sure fl_display is non-zero. You should call +this if you wish to do X calls and there is a chance that your +code will be called before the first show() of a +window. + +
This may call Fl::abort() if there is an error +opening the display.
+ +This closes the X connection. You do not need to call +this to exit, and in fact it is faster to not do so! It may be +useful to call this if you want your program to continue without +the X connection. You cannot open the display again, and +probably cannot call any FLTK functions. + +
Which screen number to use. This is set by +fl_open_display() to the default screen. You can change +it by setting this to a different value immediately afterwards. +It can also be set by changing the last number in the +Fl::display() string to "host:0.#". + +
The visual and colormap that FLTK will use for all windows. +These are set by fl_open_display() to the default +visual and colormap. You can change them before calling +show() on the first window. Typical code for changing +the default visual is: + +
+Fl::args(argc, argv); // do this first so $DISPLAY is set
+fl_open_display();
+fl_visual = find_a_good_visual(fl_display, fl_screen);
+if (!fl_visual) Fl::abort("No good visual");
+fl_colormap = make_a_colormap(fl_display, fl_visual->visual, fl_visual->depth);
+// it is now ok to show() windows:
+window->show(argc, argv);
+
+
+FLTK can manage an X window on a different screen, visual +and/or colormap, you just can't use FLTK's drawing routines to +draw into it. But you can write your own draw() method +that uses Xlib (and/or OpenGL) calls only. + +
FLTK can also manage XID's provided by other libraries or +programs, and call those libraries when the window needs to be +redrawn.
+ +To do this, you need to make a subclass of Fl_Window and +override some of these virtual functions:
+ +If the window is already shown() this must cause it +to be raised, this can usually be done by calling +Fl_Window::show(). If not shown() your +implementation must call either Fl_X::set_xid() or +Fl_X::make_xid(). + +
An example:
+ +
+void MyWindow::show() {
+ if (shown()) {Fl_Window::show(); return;} // you must do this!
+ fl_open_display(); // necessary if this is first window
+ // we only calcualte the necessary visual colormap once:
+ static XVisualInfo *visual;
+ static Colormap colormap;
+ if (!visual) {
+ visual = figure_out_visual();
+ colormap = XCreateColormap(fl_display, RootWindow(fl_display,fl_screen),
+ vis->visual, AllocNone);
+ }
+ Fl_X::make_xid(this, visual, colormap);
+}
+
+
+Allocate a hidden structure called an Fl_X, put the +XID into it, and set a pointer to it from the +Fl_Window. This causes Fl_Window::shown() to +return true. + +
This static method does the most onerous parts of creating an +X window, including setting the label, resize limitations, etc. +It then does Fl_X::set_xid() with this new window and +maps the window. + +
This virtual function is called by Fl::flush() to +update the window. For FLTK's own windows it does this by +setting the global variables fl_window and +fl_gc and then calling the draw() method. For +your own windows you might just want to put all the drawing code +in here. + +
The X region that is a combination of all damage() +calls done so far is in Fl_X::i(this)->region. If +NULL then you should redraw the entire window. The +undocumented function fl_clip_region(XRegion) will +initialize the FLTK clip stack with a region or NULL +for no clipping. You must set region to NULL afterwards +as fl_clip_region() will own and delete it when +done.
+ +If damage() & FL_DAMAGE_EXPOSE then only X +expose events have happened. This may be useful if you have an +undamaged image (such as a backing buffer) around.
+ +Here is a sample where an undamaged image is kept somewhere:
+ +
+void MyWindow::flush() {
+ fl_clip_region(Fl_X::i(this)->region);
+ Fl_X::i(this)->region = 0;
+ if (damage() != 2) {... draw things into backing store ...}
+ ... copy backing store to window ...
+}
+
+
+Destroy the window server copy of the window. Usually you +will destroy contexts, pixmaps, or other resources used by the +window, and then call Fl_Window::hide() to get rid of +the main window identified by xid(). If you override +this, you must also override the destructor as shown: + +
+void MyWindow::hide() {
+ if (mypixmap) {
+ XFreePixmap(fl_display,mypixmap);
+ mypixmap = 0;
+ }
+ Fl_Window::hide(); // you must call this
+}
+
+
+Because of the way C++ works, if you override hide() +you must override the destructor as well (otherwise only +the base class hide() is called): + +
+MyWindow::~MyWindow() {
+ hide();
+}
+
+
+FLTK currently supports setting a window's icon before it +is shown using the Fl_Window::icon() method. + +
Sets the icon for the window to the passed pointer. You will +need to cast the icon Pixmap to a char * when +calling this method. To set a monochrome icon using a bitmap compiled +with your application use: + +
+#include "icon.xbm" + +fl_open_display(); // needed if display has not been previously opened + +Pixmap p = XCreateBitmapFromData(fl_display, DefaultRootWindow(fl_display), + icon_bits, icon_width, icon_height); + +window->icon((char *)p); ++ +
To use a multi-colored icon, the XPM format and library +should be used as follows: + +
+#include <X11/xpm.h> +#include "icon.xpm" + +fl_open_display(); // needed if display has not been previously opened + +Pixmap p, mask; + +XpmCreatePixmapFromData(fl_display, DefaultRootWindow(fl_display), + icon_xpm, &p, &mask, NULL); + +window->icon((char *)p); ++ +
When using the Xpm library, be sure to include it in the list +of libraries that are used to link the application (usually +"-lXpm").
+ +| NOTE:
+
+ You must call Fl_Window::show(argc, + argv) for the icon to be used. The + Fl_Window::show() method does not bind the icon + to the window. + + |
+
When the Fl_Window::show(argc, +argv) method is called, FLTK looks for the following X +resources: + +
Resources associated with the first window's Fl_Window::xclass() +string are queried first, or if no class has been specified then +the class "fltk" is used (e.g. fltk.background). If no +match is found, a global search is done (e.g. +*background). + +
The Windows interface provides access to the WIN32 GDI +state information and data structures. + +
By default a single WNDCLASSEX called "FLTK" is +created. All Fl_Window's are of this class unless you +use Fl_Window::xclass(). The window class is created +the first time Fl_Window::show() is called. + +
You can probably combine FLTK with other libraries that make +their own WIN32 window classes. The easiest way is to call +Fl::wait(), as it will call DispatchMessage +for all messages to the other windows. If necessary you can let +the other library take over as long as it calls +DispatchMessage(), but you will have to arrange for the +function Fl::flush() to be called regularly so that +widgets are updated, timeouts are handled, and the idle +functions are called.
+ +This variable contains the most recent message read by +GetMessage, which is called by Fl::wait(). This may not be the +most recent message sent to an FLTK window, because silly WIN32 +calls the handle procedures directly for some events (sigh). + +
Installs a function to parse unrecognized messages sent to +FLTK windows. If FLTK cannot figure out what to do with a +message, it calls each of these functions (most recent first) +until one of them returns non-zero. The argument passed to the +functions is the FLTK event that was not handled or zero for +unknown messages. If all the handlers return zero then FLTK +calls DefWindowProc(). + +
Returns the window handle for a Fl_Window, or zero +if not shown(). + +
Returns the Fl_Window that corresponds to the given +window handle, or NULL if not found. This function uses +a cache so it is slightly faster than iterating through the +windows yourself. + +
When the virtual function Fl_Widget::draw() is +called, FLTK stores all the silly extra arguments you need to +make a proper GDI call in some global variables: + +
+extern HINSTANCE fl_display; +extern HWND fl_window; +extern HDC fl_gc; +COLORREF fl_RGB(); +HPEN fl_pen(); +HBRUSH fl_brush(); ++ +
These global variables are set before draw() is +called, or by Fl_Window::make_current(). +You can refer to them when needed to produce GDI calls, but don't +attempt to change them. The functions return GDI objects for +the current color set by fl_color() and are created as +needed and cached. A typical GDI drawing call is written like +this: + +
+DrawSomething(fl_gc, ..., fl_brush()); ++ +
It may also be useful to refer to Fl_Window::current() +to get the window's size or position. + +
FLTK currently supports setting a window's icon *before* it +is shown using the Fl_Window::icon() method. + +
Sets the icon for the window to the passed pointer. You will +need to cast the HICON handle to a char * when +calling this method. To set the icon using an icon resource +compiled with your application use: + +
+window->icon((char *)LoadIcon(fl_display, MAKEINTRESOURCE(IDI_ICON))); ++ +
You can also use the LoadImage() and related +functions to load specific resolutions or create the icon from +bitmap data. + +
| NOTE:
+
+ You must call Fl_Window::show(argc, + argv) for the icon to be used. The + Fl_Window::show() method does not bind the icon + to the window. + + |
+
WIN32 has a really stupid mode switch stored in the +executables that controls whether or not to make a console +window. + +
To always get a console window you simply create a console +application (the "/SUBSYSTEM:CONSOLE" option for the +linker). For a GUI-only application create a WIN32 application +(the "/SUBSYSTEM:WINDOWS" option for the linker).
+ +FLTK includes a WinMain() function that calls the +ANSI standard main() entry point for you. This +function creates a console window when you use the debug version +of the library.
+ +WIN32 applications without a console cannot write to +stdout or stderr, even if they are run from a +console window. Any output is silently thrown away. +Additionally, WIN32 applications are run in the background by +the console, although you can use "start /wait program" to run +them in the foreground.
+ +The following is a list of known bugs and problems in the WIN32 +version of FLTK: + +
FLTK supports MacOS X using the Apple Carbon library. Older +versions of MacOS are not supported. + +
FLTK maps the Mac 'control' key to FL_CTRL, the +'option' key to FL_ALT and the 'Apple' key to +FL_META. Keyboard events return the key name in +Fl::event_key() and the keystroke translation in +Fl::event_text(). For example, typing Option-Y on a Mac +keyboard will set FL_ALT in Fl::event_state(), +set Fl::event_key() to 'y' and return the Yen symbol in +Fl::event_text(). + +
Returns the window reference for an Fl_Window, or +NULL if the window has not been shown. + +
Returns the Fl_Window that corresponds to the give +window handle, or NULL if not found. FLTK windows that +are children of top-level windows share the WindowRef of the +top-level window. + +
When the user press Cmd-Q or requests a termination of the +application, OS X will send a "Quit" Apple Event. FLTK handles +this event by sending an FL_CLOSE event to all open +windows. If all windows close, the application will terminate. + +
When the virtual function Fl_Widget::draw() is +called, FLTK has prepared the Window and CGrafPort for drawing. +Clipping and offsets are prepared to allow correct subwindow +drawing. + +
If the FLTK library was compiled using the configuration +flag --enable-quartz, all code inside Fl_Widget::draw() +is expected to call Quartz drawing functions instead of +QuickDraw. The Quartz coordinate system is flipped to match +FLTK's coordinate system. The origin for all drawing is in the top +left corner of the enclosing Fl_Window. + +
OS X double-buffers all windows automatically. On OS X, +Fl_Window and Fl_Double_Window are handled +internally in the same way. + +
FLTK does not access the resource fork of an application. +However, a minimal resource fork must be created for OS X +applications + +
| Caution:
+
+ When using UNIX commands to copy or move executables, OS X +will NOT copy any resource forks! For copying and moving use +CpMac and MvMac respectively. For creating a tar archive, all +executables need to be stripped from their Resource Fork before +packing, e.g. "DeRez fluid > fluid.r". After unpacking the +Resource Fork needs to be reattached, e.g. "Rez fluid.r -o +fluid". + |
It is advisable to use the Finder for moving and copying and +Mac archiving tools like Sit for distribution as they will +handle the Resource Fork correctly. + +
FLTK uses UNIX-style filenames and paths. + +
The following is a list of known bugs and problems in the +MacOS version of FLTK: + +
This manual describes the Fast Light Tool Kit ("FLTK") +version 1.1.10, a C++ Graphical User Interface +("GUI") toolkit for UNIX, Microsoft Windows and MacOS. Each +of the chapters in this manual is designed as a tutorial for +using FLTK, while the appendices provide a convenient reference +for all FLTK widgets, functions, and operating system +interfaces.
+ +This manual may be printed, modified, and/or used under +the terms of the FLTK license provided in Appendix A. + +
This manual is organized into the following chapters and appendices:
+ +The following typeface conventions are used in this manual:
+ +The following abbreviations are used in this manual:
+ +FLTK is Copyright 1998-2009 by Bill Spitzak and others. Use and +distribution of FLTK is governed by the GNU Library General Public +License, located in Appendix H.
+ +UNIX is a registered trademark of the X Open Group, Inc. +Microsoft and Windows are registered trademarks of Microsoft +Corporation. OpenGL is a registered trademark of Silicon +Graphics, Inc. Apple, Macintosh, MacOS, and Mac OS X are +registered trademarks of Apple Computer, Inc.
+ + + diff --git a/third_party/windows/fltk-1.1.10/documentation/resizebox1.gif b/third_party/windows/fltk-1.1.10/documentation/resizebox1.gif new file mode 100644 index 0000000..c5e8c30 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/resizebox1.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/resizebox2.gif b/third_party/windows/fltk-1.1.10/documentation/resizebox2.gif new file mode 100644 index 0000000..2083afd Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/resizebox2.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/round_clock.gif b/third_party/windows/fltk-1.1.10/documentation/round_clock.gif new file mode 100644 index 0000000..939457a Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/round_clock.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/scrollbar.gif b/third_party/windows/fltk-1.1.10/documentation/scrollbar.gif new file mode 100644 index 0000000..96d0358 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/scrollbar.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/slider.gif b/third_party/windows/fltk-1.1.10/documentation/slider.gif new file mode 100644 index 0000000..923e257 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/slider.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/subclassing.html b/third_party/windows/fltk-1.1.10/documentation/subclassing.html new file mode 100644 index 0000000..93bc892 --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/subclassing.html @@ -0,0 +1,434 @@ + + +A control widget typically interacts with the user to receive and/or +display a value of some sort.
+A composite widget widget holds a list of child widgets and handles moving, +sizing, showing, or hiding them as needed. Fl_Group is the +main composite widget widget class in FLTK, and all of the other composite widgets ( +Fl_Pack, Fl_Scroll, Fl_Tabs, Fl_Tile, +and Fl_Window) are subclasses of it.
+You can also subclass other existing widgets to provide a different +look or user-interface. For example, the button widgets are all +subclasses of Fl_Button since they all interact with the user +via a mouse button click. The only difference is the code that draws +the face of the button.
++MyClass(int x, int y, int w, int h, const char *label = 0); ++ This will allow the class to be used in FLUID + without problems. +
The constructor must call the constructor for the base class and +pass the same arguments:
+
+MyClass::MyClass(int x, int y, int w, int h, const char *label)
+: Fl_Widget(x, y, w, h, label) {
+// do initialization stuff...
+}
+
+Fl_Widget's protected constructor sets x(), y(),
+w(), h(), and label() to the passed values
+and initializes the other instance variables to:
++type(0); +box(FL_NO_BOX); +color(FL_BACKGROUND_COLOR); +selection_color(FL_BACKGROUND_COLOR); +labeltype(FL_NORMAL_LABEL); +labelstyle(FL_NORMAL_STYLE); +labelsize(FL_NORMAL_SIZE); +labelcolor(FL_FOREGROUND_COLOR); +align(FL_ALIGN_CENTER); +callback(default_callback,0); +flags(ACTIVE|VISIBLE); +image(0); +deimage(0); ++
The second form indicates that a region is damaged. If only these +calls are done in a window (no calls to damage(n)) then FLTK +will clip to the union of all these calls before drawing anything. + This can greatly speed up incremental displays. The mask bits are +OR'd into damage() unless this is a Fl_Window widget.
+The third form returns the bitwise-OR of all damage(n) +calls done since the last draw().
+When redrawing your widgets you should look at the damage bits to +see what parts of your widget need redrawing. The handle() +method can then set individual damage bits to limit the amount of drawing +that needs to be done: +
+MyClass::handle(int event) {
+ ...
+ if (change_to_part1) damage(1);
+ if (change_to_part2) damage(2);
+ if (change_to_part3) damage(4);
+}
+
+MyClass::draw() {
+ if (damage() & FL_DAMAGE_ALL) {
+ ... draw frame/box and other static stuff ...
+ }
+
+ if (damage() & (FL_DAMAGE_ALL | 1)) draw_part1();
+ if (damage() & (FL_DAMAGE_ALL | 2)) draw_part2();
+ if (damage() & (FL_DAMAGE_ALL | 4)) draw_part3();
+}
+
+Draws a focus box inside the widgets bounding box. The second +form allows you to specify a different bounding box. + +
The second form uses the passed bounding box instead of the widget's +bounding box. This is useful so "centered" labels are aligned with some +feature, like a moving slider.
+The third form draws the label anywhere. It acts as though +FL_ALIGN_INSIDE has been forced on so the label will appear inside +the passed bounding box. This is designed for parent groups to draw +labels with.
+The second version lets you do this test against an arbitrary +string.
+FLTK does not use RTTI (Run Time Typing Information), to enhance +portability. But this may change in the near future if RTTI becomes +standard everywhere.
+If you don't have RTTI you can use the clumsy FLTK mechanism, by +having type() use a unique value. These unique values must +be greater than the symbol FL_RESERVED_TYPE (which is 100). +Look through the header files for FL_RESERVED_TYPE to find an +unused number. If you make a subclass of Fl_Window +you must use FL_WINDOW + n (n must be in the +range 1 to 7).
+Here is a sample handle() method for a widget that acts as +a pushbutton and also accepts the keystroke 'x' to cause the callback:
+
+int MyClass::handle(int event) {
+ switch(event) {
+ case FL_PUSH:
+ highlight = 1;
+ redraw();
+ return 1;
+ case FL_DRAG: {
+ int t = Fl::event_inside(this);
+ if (t != highlight) {
+ highlight = t;
+ redraw();
+ }
+ }
+ return 1;
+ case FL_RELEASE:
+ if (highlight) {
+ highlight = 0;
+ redraw();
+ do_callback();
+ // never do anything after a callback, as the callback
+ // may delete the widget!
+ }
+ return 1;
+ case FL_SHORTCUT:
+ if (Fl::event_key() == 'x') {
+ do_callback();
+ return 1;
+ }
+ return 0;
+ default:
+ return Fl_Widget::handle(event);
+ }
+}
+
+
+You must return non-zero if your handle() method +uses the event. If you return zero, the parent widget will try +sending the event to another widget. + +
The draw() virtual method is called when FLTK wants +you to redraw your widget. It will be called if and only if +damage() is non-zero, and damage() will be +cleared to zero after it returns. The draw() method +should be declared protected so that it can't be called from +non-drawing code. + +
The damage() value contains the bitwise-OR of all +the damage(n) calls to this widget since it was last +drawn. This can be used for minimal update, by only redrawing +the parts whose bits are set. FLTK will turn on the +FL_DAMAGE_ALL bit if it thinks the entire widget must +be redrawn, e.g. for an expose event.
+ +Expose events (and the above damage(b,x,y,w,h)) will cause +draw() to be called with FLTK's +clipping turned on. You can greatly speed up redrawing in some +cases by testing fl_not_clipped(x,y,w,h) or fl_clip_box(...) and +skipping invisible parts.
+Besides the protected methods described above, FLTK provides a large +number of basic drawing functions, which are described +below.
+This should not call redraw(), at least if only the +x() and y() change. This is because composite widgets like +Fl_Scroll may have a more efficient way of drawing the new +position.
+Instances of the child widgets may be included in the parent:
+
+class MyClass : public Fl_Group {
+ Fl_Button the_button;
+ Fl_Slider the_slider;
+ ...
+};
+
+ The constructor has to initialize these instances. They are
+automatically add()ed to the group, since the Fl_Group
+ constructor does begin(). Don't forget to call end()
+ or use the Fl_End pseudo-class:
+
+MyClass::MyClass(int x, int y, int w, int h) :
+ Fl_Group(x, y, w, h),
+ the_button(x + 5, y + 5, 100, 20),
+ the_slider(x, y + 50, w, 20)
+{
+ ...(you could add dynamically created child widgets here)...
+ end(); // don't forget to do this!
+}
+
+ The child widgets need callbacks. These will be called with a pointer
+to the children, but the widget itself may be found in the parent()
+ pointer of the child. Usually these callbacks can be static private
+methods, with a matching private method:
+
+void MyClass::static_slider_cb(Fl_Widget* v, void *) { // static method
+ ((MyClass*)(v->parent())->slider_cb();
+}
+void MyClass::slider_cb() { // normal method
+ use(the_slider->value());
+}
+
+ If you make the handle() method, you can quickly pass all the
+events to the children using the Fl_Group::handle() method.
+You don't need to override handle() if your composite widget
+does nothing other than pass events to the children:
+
+int MyClass::handle(int event) {
+ if (Fl_Group::handle(event)) return 1;
+ ... handle events that children don't want ...
+}
+
+
+If you override draw() you need to draw all the +children. If redraw() or damage() is called +on a child, damage(FL_DAMAGE_CHILD) is done to the +group, so this bit of damage() can be used to indicate +that a child needs to be drawn. It is fastest if you avoid +drawing anything else in this case: + +
+int MyClass::draw() {
+ Fl_Widget *const*a = array();
+ if (damage() == FL_DAMAGE_CHILD) { // only redraw some children
+ for (int i = children(); i --; a ++) update_child(**a);
+ } else { // total redraw
+ ... draw background graphics ...
+ // now draw all the children atop the background:
+ for (int i = children_; i --; a ++) {
+ draw_child(**a);
+ draw_outside_label(**a); // you may not need to do this
+ }
+ }
+}
+
+Fl_Group provides some protected methods to make drawing
+easier:
+
+Drag'n'drop operations are are initiated by copying data to the +clipboard and calling the function +Fl::dnd(). + +
Drop attempts are handled via events: +
You may want your widget to be a subclass of +Fl_Window, Fl_Double_Window, or +FL_Gl_Window. This 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_Windowis almost exactly like +subclassing Fl_Group, and in fact you can easily +switch a subclass back and forth. Watch out for the following +differences:
+ +You may also want to subclass Fl_Window in order to +get access to different visuals or to change other attributes of +the windows. See "Appendix F - Operating +System Issues" for more information. + + + diff --git a/third_party/windows/fltk-1.1.10/documentation/sudoku.man b/third_party/windows/fltk-1.1.10/documentation/sudoku.man new file mode 100644 index 0000000..6c35f7a --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/sudoku.man @@ -0,0 +1,33 @@ +.TH sudoku 6 "FLTK Sudoku" "15 January 2006" +.SH NAME +sudoku \- the fltk sudoku game +.sp +.SH SYNOPSIS +\fISudoku\fR is a FLTK-based version of the game of Sudoku. +Sudoku (pronounced soo-dough-coo with the emphasis on the first +syllable) is a simple number-based puzzle/game played on a 9x9 +grid that is divided into 3x3 subgrids. The goal is to enter a +number from 1 to 9 in each cell so that each number appears only +once in each column and row. +.LP +At the start of a new game, Sudoku fills in a random selection of +cells for you - the number of cells depends on the difficulty +level you use. Click in any of the empty cells or use the arrow +keys to highlight individual cells and press a number from 1 to 9 +to fill in the cell. To clear a cell, press 0, Delete, or +Backspace. As you complete each subgrid, correct subgrids are +highlighted in green. When you have successfully completed all +subgrids, the entire puzzle is highlighted until you start a new +game. +.LP +As you work to complete the puzzle, you can display possible +solutions inside each cell by holding the Shift key and pressing +each number in turn. Repeat the process to remove individual +numbers, or press a number without the Shift key to replace them +with the actual number to use. +.SH SEE ALSO +fltk(3) +.br +FLTK Web Site, http://www.fltk.org/ +.SH AUTHOR +Michael R Sweet. diff --git a/third_party/windows/fltk-1.1.10/documentation/symbols.gif b/third_party/windows/fltk-1.1.10/documentation/symbols.gif new file mode 100644 index 0000000..54bda5b Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/symbols.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/tabs.gif b/third_party/windows/fltk-1.1.10/documentation/tabs.gif new file mode 100644 index 0000000..c347cba Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/tabs.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/text.gif b/third_party/windows/fltk-1.1.10/documentation/text.gif new file mode 100644 index 0000000..65a56da Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/text.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/valuators.gif b/third_party/windows/fltk-1.1.10/documentation/valuators.gif new file mode 100644 index 0000000..a2de738 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/valuators.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/value_slider.gif b/third_party/windows/fltk-1.1.10/documentation/value_slider.gif new file mode 100644 index 0000000..13fec43 Binary files /dev/null and b/third_party/windows/fltk-1.1.10/documentation/value_slider.gif differ diff --git a/third_party/windows/fltk-1.1.10/documentation/widgets.html b/third_party/windows/fltk-1.1.10/documentation/widgets.html new file mode 100644 index 0000000..188a347 --- /dev/null +++ b/third_party/windows/fltk-1.1.10/documentation/widgets.html @@ -0,0 +1,907 @@ + +
+