macOS: rewrite opengl_plugin_device() to use less memory.

Comments only: correct the header of 2 source files.

Remove unused arguments from the Fl_Device_Plugin::print() member function.

Use the Fl_Gl_Device_Plugin mechanism to simplify the construction of a layer-backed GL window.

Remove unnecessary platform-specific #if / #endif clauses.

Fix FL_PUSH event handling of Fl_Check_Browser (STR #3004).
    
    Test if the FL_PUSH event is inside the widget area and inside
    the scrollbars (if scrollbars are visible).

Create default implementation of Fl_Screen_Driver::get_system_scheme() and use it for macOS and Windows.

Documentation: reveal where the Fl_Preferences text files are located on each platform.

Documentation: replace several instances of "pixels" by "FLTK units" to account for screen rescaling.

Windows: Have Fl::x(), Fl::y(), Fl::w() and Fl::h() change their values when the screen is rescaled.

MacOS: slightly simpler implementation of Fl_Cocoa_Window_Driver::wait_for_expose().

MacOS: further support of scenarios mixing miniaturize/deminiaturize/change screen configurations.
    
    Test scenario:
    - use 2-screen configuration, one retina, one non-retina as main screen
    - put subwindow-containing window on retina
    - miniaturize window
    - close retina screen
    - de-miniaturize window
    The subwindow was wrong without this change.

MacOS: fix redraw of subwindow when display resolutions before miniaturize and after deminiaturize differ.

macOS: remove two useless statements for layer-backed OpenGL windows.

Minor reorder of operations performed when layered window is 1st drawn.

macOS: reorganize the code running when windows are moved between retina and non-retina displays.

MacOS: introduce classes FLViewLayer and FLGLViewLayer to handle layer-backed views.
    
    Both new classes are derived from FLView.

MacOS: simpler implementation of extra code necessary at first display of layer-backed GL windows

Account for property graphicsPort of NSGraphicsContext being deprecated in 10.14

Fix macOS 10.14 Mojave support of the FLTK-cairo interface.
    
    After experimenting with a modified cairo_test program that draws both with
    cairo and with regular FLTK drawing functions to the same window, it seems
    necessary to control for possible changes to the graphics context made by
    cairo in Fl_Cocoa_Window_Driver::make_current() rather than in
    cairo_create_surface().

Add guard against gl_draw(const char*, int) called with null 2nd argument.

Support of macOS 10.14 Mojave: take care of the FLTK-Cairo interface.
    
    Discussion "Screen buffer flipped in OSX Mojave running 1.4.x"
    in fltk.general,
        http://www.fltk.org/newsgroups.php?s36913+gfltk.general+v36915
    describes a Cairo-using FLTK app that runs well after this modification.

Fix comment only (wrong STR number).

Further fix to support gl_start()/gl_finish() under MacOS platform.

MacOS Mojave and gl_start(): fix for 10.14 but not 10.14.1

Add useful cast

MacOS Mojave: restore use of gl_start()/gl_finish()

Remove use of Fl_Gl_Window_Driver.H in file src/Fl_cocoa.mm
    
    Thus, Fl_cocoa.mm is completely independent from code of libfltk_gl.

Remove all dependency to libfltk_gl from Fl_cocoa.mm.

Fix issue when moving window between retina/non-retina screens while window is under progressive redraw.
    
    The problem was visible with test/mandelbrot and with layer-backed views.

Control resizing behavior of UI buttons

Tooltip for browse button, and include a fallback label if icon not found.

Print both returned path and relative path in tty.

Removed temporary comment.

Fixes STR#3500 - "Must type two leading slashes to enter an absolute path"

Fix handling of layer-backed sub GL window moved between retina and non-retina screens.

Fix error in Fl_Cocoa_Gl_Window_Driver::make_current_before()
    
    Fl_Gl_Window_Driver::invalidate() instead of Fl_Gl_Window::invalidate() was called.

Fix handling of GL window moved between retina and non-retina screens.
    
    Part of the fix applies both to layer-backed and non layer-backed windows.

Fix handling of layer-backed GL window moved between retina and non retina screens.

Fixed first drawing of a layer-backed OpenGL window.

MacOS Mojave 10.14 support: fix creation of several OpenGL windows.

Fix suppport of tabbed windows.

Stop using viewFrameDidChangeNotification and implement drawRect:(NSRect) for FLViewGL.

Add missing include file <string.h>.
    
    Preparing for another commit...

Mention added support for MacOS 10.14

Support GL windows on retina display when app does not set Fl::use_high_res_GL(1)

Fix resize of layer-backed, top-level GL windows: no more blank window.

Minor improvement of macOS 10.14 mojave support: draw window views with the displayLayer: method
    
    The doc recommends to draw views with the displayLayer: method when the view manages itself
    completely its own bitmap:
           If your delegate implements the displayLayer: method, that implementation is responsible
           for creating a bitmap and assigning it to the layer’s contents property.

Document that Fl_Widget::GROUP_RELATIVE bit is not used.

Windows/OpenGL: fix pixel format detection (STR #3119).
    
    This patch fixes two aspects described in STR #3119:
     (a) enables detection and prefers pixel formats with composition
     (b) selects no more than 32 bit colors (8 bits per pixel)
    
    (a) was the reason for this STR, (b) was reported repeatedly in
    fltk.general (see STR #3119).

Add support for macOS 10.14 Mojave.
    
    MacOS apps running under 10.14 AND linked with SDK 10.14 use a completely different way
    to draw to the screen in comparison with the same app running under 10.13 or earlier:
    all views are "layer-backed".
    This commit makes FLTK apps running under 10.14 and linked with SDK 10.14 explicitly
    use layers to draw to the screen.
    FLTK apps remain downward compatible with earlier macOS versions.

Remove compilation error when using clang 8:
    
    error: non-constant-expression cannot be narrowed from type 'int' to 'CGFloat'

Update makesrcdist to work with Git. Work in progress.
    
    This is a working version of makesrcdist and "commandline compatible" with the
    previous svn version.
    
    Todo: There will likely be more or other commandline arguments to be more flexible
    when building source tarballs or snapshots.

Prepare for support of MacOS 10.14 Mojave.

Fix Fl_OpenGL_Display_Device::capture_gl_rectangle(Fl_Gl_Window*) by making current the window's GL context.
    
    The problem was visible with test/cube: when the window was minimized, only the left GL subwindow
    was captured in the window icon.

Fluid inlined text data must be 'const'

Avoiding crash when accessing free'd memory.

Update (reformat) README.bundled-libs.txt.
    --This line, and thupose below, will be ignored--
    
    M

MacOS 10.14 Mojave: fix support of window capture  - continued.
    
    Window capture by initWithFocusedViewRect: does not work if the app is linked against 10.14 SDK
    and run under 10.14. In that case, capture is performed instead by CGWindowListCreateImage().
    Detection of whether the app was linked against 10.14 SDK is done by checking whether
    the FLView possesses a CALayer.

Update dependencies.

MacOS 10.14 Mojave: fix support of window capture that 10.14 broke.

Update release date. (Test commit)

macOS: check for non-nil image before using it as miniaturized window icon.

Support for macOS 10.14 Mojave: apps linked with SDK 10.14 did not draw anything in their windows.

MacOS: fix is_bundled() function for case when [NSBundle mainBundle] is nil.

Update README.md for new Git repository on GitHub.

MacOS: fix regression in OS 10.13 where an unbundled app had its system menu bar unresponsive.
    
    The regression was detected by "FLTK 1.4 on macOS: Trouble compiling my Application with Makefile"
    in fltk.general.
    The fix is to have unbundled apps initialize under MacOS 10.13 as under earlier OS,
    thus the new initialization procedure introduced for 10.13 is for bundled apps only.
    Tested OK on 10.13.6 and 10.14 public beta 10.

X11 under Ubuntu: read screen scaling information - continued
    
    the first scaling value set at 2 is retained.

X11 under Ubuntu: read screen scaling information from file $HOME/.config/monitors.xml

Fix (remove) C++11 extension in header file.
    
    Found with clang [-Wc++11-extensions] (example):
    
    Building CXX object src/CMakeFiles/fltk.dir/Fl_x.cxx.o
    In file included from ../../src/Fl_x.cxx:40:
    ../../src/drivers/X11/Fl_X11_Screen_Driver.H:36:10: warning: unelaborated
      friend declaration is a C++11 extension; specify 'class' to befriend
      'Fl_Screen_Driver' [-Wc++11-extensions]
      friend Fl_Screen_Driver;
             ^
             class
    1 warning generated.

MacOS: Fix rounding to nearest int for negative screen coordinates.
    
    The previous method   int(x + 0.5) is incorrect when x < 0

MacOS ≥ 10.10: Fl_Window::fullscreen() and fullscreen_off() no longer call Fl_Window::hide() + Fl_Window::show()
    
    The new procedure essentially resizes the window, as done on the X11+EWMH and Windows platforms.
    This improves in particular the possibility to turn an Fl_Gl_Window fullscreen on and off.
    MacOS ≥ 10.10 is required because the procedure isn't stable (random crashes during fast switches) with 10.9.

X11: simplify the use of member function Fl_X11_Screen_Driver::init_workarea().

MacOS: fix turning GL window to/from fullscreen state.
    
    This fix completes that at r.13039.

X11: fix Fl::w() and Fl::h() when the screen is rescaled.

Less code is enough to start the OpenGL 3 window fullscreen.

MacOS: fix creation of fullscreen GL window

Complete proper initialisation of the unique Fl_Cocoa_Screen_Driver object.

Revert test commit.

Update dependencies and fluid files, fix typos.

Doc only: better doc of recently added events: FL_SCREEN_CONFIGURATION_CHANGED, FL_FULLSCREEN,...

Added example of dynamically setting style buffer with text editor.
    This example greatly simplifies the test/editor example to focus on
    just the mechanics of dynamic style buffer manipulation via the
    add_modify_callback().

MacOS: slightly simplify [FLAppDelegate applicationDidChangeScreenParameters:]

Slightly simpler implementation of Fl_Cocoa_Gl_Window_Driver::alpha_mask_for_string() - continued.

Slightly simpler implementation of Fl_Cocoa_Gl_Window_Driver::alpha_mask_for_string().

Fix typo.

MacOS X: Fixed Fluid CMake to use the included Info.plist instead of the CMake template. This will teach Fluid to accept .fl and .fld files again.

Fixed indenting and some wording in previous changes to Fluid

Beautified some of the code. Removed size calculation error.

Added new functionality to Fluid: the 'binary data' type can now include text files as well as binary files into the source code. There is an additional check box in the dialog. Terminology is now "inlined data" instead of "binary data". Texts were modified to reflect the changes.

Remove the need to call fl_open_display() before using Fl::screen_scale(int, float).

Show also how to create the OpenGL3 GLUT window fullscreen.

Better doc for using OpenGL version 3.

Improved documentation related to access to OpenGL 3 under X11 platform.

Fix creation of OpenGL3+ context under X11 platform
    
    The procedure given in https://www.khronos.org/opengl/wiki/Tutorial:_OpenGL_3.0_Context_Creation_(GLX)
    is now followed. This gives access to contexts for the highest OpenGL version supported by the hardware
    when flag FL_OPENGL3 is used in the call to Fl_Gl_Window::mode(int).

Added comment to Fl_Help_Dialog so users will know to link with fltk_images.

A test commit. Please revert.

Update FLTK 1.4.0 release year.

Remove file with Windows crlf line endings from .gitattributes.
    
    This is preliminary. These files will probably be added again after
    the real migration to Git. Needs more investigation.

Support recent MS Office apps that use \r\n as end of line in pasteboard.
    
    FLTK now transforms that into \n as is expected under MacOS.
    Older MS Office apps used \r as old MacOS software.

Improve the documentation of scaling factor-related operations.

Fix typo in Doxygen doc

Support for GUI scaling: add API to get/set the scaling factor value.
    
    Also, define an FLTK event triggered when the scaling is changed and an option
    to disable the transient window showing the new scaling factor.

Update doxygen files to fix broken PDF generation.
    
    Note: PDF generation "worked" with the previous configuration up to
    doxygen 1.8.6 on my "old" Ubuntu 14.04 system but did no longer work
    with doxygen 1.8.7 - 1.8.13 (the latter on Ubuntu 18.04).
    
    Tests showed that 1.8.14 is seriously broken and git:master (aka 1.8.15,
    but not yet released as of today) is not usable as well. Hopefully there
    will be some doxygen fixes in the future.

Fix for STR #3483: support for tiled images when the display is rescaled.

Fl_Tree documentation fixes for html/pdf, doxygen 1.8.5

Fix crash when a program exits before it opens a window (STR #3484).
    
    This crash and the fix are Windows specific.

Add missing FL_EXPORT statements.
    
    This fixes a regression causing 'fluid-shared' build to fail (only if
    configured with --enable-shared, obviously).

Have the Doxygen doc of fl_draw_pixmap() show the default value of the last argument.

Fix regression seen with test/input under X11: the cursor becomes a grey square instead of FL_CURSOR_NONE

Remove private member variable Fl_X11_Window_Driver::current_cursor_ that's no longer used.

Fix line endings and other (svn) properties of fltk-config.in.
    
    Remove executable property.
    Set line ending to LF.

Move Fl_Window::shape() from file Fl_Window_Driver.cxx to Fl_Window.cxx
    
    Consequently, the Doxygen documentation of Fl_Window::shape() will reappear.

Update GitLab CI configuration (comments only).
    
    Document where the HTML documentation will be installed.

Update gitlab CI configuration (comments only).

Add git attributes file.

Remove no longer needed file from .gitignore

Add missing Fl_Cairo_Window constructors (STR #3160).

Added fallthru indication in Fl_Button::handle()

Make Fl_Graphics_Driver::newMainGraphicsDriver() public rather than private.
    
    An FLTK app may be interested in calling it.

Try dummy commit

Update bundled nanosvg lib to latest upstream version.
    
    $ git log -2 master
    commit 06c1f0f3bb041d69a73bb74067d063a700215b0e
    Merge: 1f17a7e d6eabf2
    Author: Mikko Mononen <memononen@gmail.com>
    Date:   Sat Apr 14 06:50:42 2018 +0300
    
        Merge pull request #116 from porglezomp-misc/master
    
        Parse <svg> percentage width for automatic sizing
    
    commit d6eabf29c9c10038924e823e693dddef281abee5
    Author: Caleb Jones <code@calebjones.net>
    Date:   Fri Apr 13 19:57:06 2018 -0400
    
        Parse <svg> percentage width for automatic sizing
    
        Instead of calculating percentage coordinates relative to 1px, we calculate them
        relative to 0px width, that way an explicit <svg width="100%"> will be converted
        to <svg width="0px"> and trigger the bounding-box sizing calculation.

Avoid giving same name (s) to 2 variables.

Update dependencies.

Update Makefile + ignored files.

Set correct file properties.

Add proper FLTK header and footer to this new source file.

Remove a few useless 'friend' statements.

Remove useless 'friend' statements from declaration of class Fl_Image_Surface

Use #include <FL/platform_types.h> to define type Fl_Offscreen

Add examples/SVG_File_Surface.cxx and refer to it in the doc of class Fl_Surface_Device
    
    This example code shows how to subclass Fl_Surface_Device and Fl_Graphics_Driver to
    endow FLTK with a new kind of graphics output.

Moving headers Fl_XXX_Driver.H from FL/ to src/ --- continued

Move Fl_Gl_Window_Driver.H from FL/ to src/ --- continued

Move Fl_Gl_Window_Driver.H from FL/ to src/

Move Fl_System_Driver.H from FL/ to src/

Move Fl_Screen_Driver.H from FL/ to src/

Move Fl_Window_Driver.H from FL/ to src/

Fix dependencies.
    
    This dependency issue affects only the autotools (configure/make) build
    and shows that (IMHO) CMake is superior, at least for the way FLTK's
    build is configured currently.
    
    Todo: get rid of pre-configured makedepend files and hand-edited
    dependencies in Makefile's. The latter is *really* important in our
    new "driver model" build environment because there is not only one
    possible dependency whatever build options we select...

Move Fl_Sys_Menu_Bar_Driver.H from FL/ to src/

Give private member variable _panel of class Fl_Quartz_Native_File_Chooser_Driver its true type, NSSavePanel*.

Doxygen only: fixed all block comments starting with an asterisk to space-only, fixed doxygen keywords prepended with @ to use a backward slash instead. No code was changed.

Removed macro FL_PORTING, as it has been more confusing than helpful.
    
    The original intention of FL_PORTING was to mark all places in the
    source code where changes are required to port FLTK to a new platform.
    Thanks to the driver system, this approach has become somewhat
    misleading, so I removed all references.

Doxygen: created Group to document drivers, disabled by default
    Uncomment `ENABLED_SECTIONS += DriverDev` in documentation/Doxyfile.in
    to enable driver documentation.

Android: Android Developer Documentation would work but needs some changes in Doxyfile:
    
    - if develoer doc is wantedn, add 'ENABLED_SECTIONS       = AndroidDev'
    - currently, Doxyfile enables everything related to drivers, so remove
      'EXCLUDE  = /Users/matt/dev/fltk-1.4.svn/src/driversxx/'
    
    With this, we get a sparsely filled module named 'Android Developer Documentation'
    and a lot of other driver related classes, which could also be encapsulated
    in doxygen '@if DriverDev'.

Android: added a few more Doxygen comments

Android: fixed fl_beep to plat different sound for differen beep types, testing Doxygen to generate driver developer documentation

Activate GitLab CI and GitLab Pages (HTML docs).
    
    The GitLab CI control file enables continuous builds after every commit
    and generates the (doxygen) HTML documentation.
    
    The documentation is put online on GitLab pages at:
    
    https://fltk.gitlab.io/fltk/

Remove unnecessary inclusion of config_lib.h

Update bundled libraries docs (typos, errors).

Android: listed all remianing issues with all test programs

Android: roughly fixed Fl::grab() to make menus easier to navigate

Android: on-screen keyboard no longer pops up on text output widgets

Android: Windows are now centered on screen if no position is defined, dialogs pop up in a more logical position.

Android: Lazy scroll is working. AT some point we should implement fast scrolling

Android: More tests, must implement scrolling next

Android: Teaching FLTK to beep. test/button works.

Android: Implemented window positioning and sizing

Android: Updated to current Android Studio and NDK, fixed STL to use Google provided ANdroid STL.

Remove obsolete #include statement (finally)

Move platform specific shortcut code to platform drivers.
    
    Tested on Windows and Linux (not tested on MacOS/Android).

Update README.md for Git mirrors.

Android: Clearing the desktop when a window is hidden.

Add missing winsock dll to variables.cmake (fixes fltk-config).

Windows: Disable dynamic linking/loading of winsock dll.
    
    This *preliminary* commit disables dynamic linking/loading of winsock
    (ws2_32.dll) and links it statically to fluid and all FLTK test
    programs. This is done by conditional code (#if 0) that disables the
    old code and #defines some macros. This *must* be removed and replaced
    with the original socket interface once the code has proved to work as
    expected.
    
    Note: example programs in the examples/ folder are not yet modified.
    Todo: check and fix examples/Makefile if necessary.

Recent (circa early 2018) versions of the Mingw32 headers have changed the file header layout, breaking the build of fltk-1.4 for some users.
    These changes should give a working build once more - more complete rework is still needed to fully address the issues raised.

Better handling of very small input file when reading SVG image file.

Add README.md for GitHub and GitLab git repositories.

Turn static function Fl_Graphics_Driver * Fl_Graphics_Driver::newMainGraphicsDriver() private.

Avoid repetitive calls to Fl_Screen_Driver::screen_count()

Repair regression appeared after r.12939 for MSWindows before 8.1

Complete construction of Fl_Image_Surface_Driver with Fl_Offscreen brought by the caller.

Fix for STR#3475: X11 platform, re-use current screen scaling factor when processing a screen reconfiguration event.

MacOS: have Fl_OpenGL_Display_Device::capture_gl_rectangle() capture also the overlay of GL windows.

Replace Fl_Paged_Device::newPrinterDriver() by Fl_Printer::newPrinterDriver().

Rewrite static function Fl_Image_Surface::rescale(Fl_Image_Surface*&) as member function Fl_Image_Surface::rescale().

Added separate diagram for fl_arc(x,y,r,a1,a2) (very different from fl_arc(x,y,w,h,a1,a2))

Extra refs for fl_pie/fl_arc diagrams..

Added a diagram to clarify how fl_pie() and fl_arc() works.

Document the constructor and destructor of class Fl_Copy_Surface.

Slightly improve the doc of Fl::reset_marked_text().

Add documentation for Fl::reset_marked_text() and Fl::insertion_point_location().

MacOS: use direct access to member variable in member function.

Make static member function Fl_Window_Driver* Fl_Window_Driver::driver(const Fl_Window *) inline.

MacOS: account for GUI rescaling in support of text input methods.

Add Fl::screen_scale(int) function to get the scaling factor value of a screen.
    
    This allows to keep class Fl_Screen_Driver away from the public API.

Fl_Tabs: fix allocation of tab_width[] (STR #3472).

Check also proper RGB image deletion after use.

Improve Fl_Screen_Driver::traverse_to_gl_subwindows() so it can be called for a window that is not current.

Remove useless #include directives.

Comments only: update the header part of the file

Fl_Scalable_Graphics_Driver::rect(): don't draw a rectangle if w or h is negative

MacOS: move some code from file Fl_cocoa.mm to file Fl_Darwin_System_Driver.cxx - continued

MacOS: move some code from file Fl_cocoa.mm to file Fl_Darwin_System_Driver.cxx

MacOS: move some code from file Fl_cocoa.mm to file Fl_Cocoa_Window_Driver.cxx

MacOS: move timer-related code from file Fl_cocoa.mm to file Fl_Cocoa_Screen_Driver.cxx

Remove public member function Fl_Window_Driver *Fl_Window::driver() so class Fl_Window_Driver is not in FLTK public API.
    
    This function is replaced by static Fl_Window_Driver* Fl_Window_Driver::(const Fl_Window *win).
    The purpose is to have class Fl_Window_Driver outside from FLTK ABI.

Mention new member functions Fl_Paged_Device::begin_job() and begin_page().

Fix typo.

Comments only: describe the Inheritance diagram for classes Fl_Surface_Device and Fl_Graphics_Driver

Fix fl_overlay_rect() for MacOS platform when GUI is scaled.

Rename Fl_Paged_Device::start_job() to begin_job() and Fl_Paged_Device::start_page() to begin_page().
    
    The new function names begin_job() and begin_page() better match end_job() and end_page() with which
    they must be used by pair.
    The old names start_job() and start_page() are maintained for API compatibility with FLTK 1.3.x

Remove a bunch of useless #include <FL/Fl_Printer.H> statements.

Added convenience method update_menubutton(),
    which tries to keep the menu synchronized with the Fl_Input field,
    assuming there's a match.

New Fl_Image_Surface::rescale() class function and document equivalence between Fl_Offscreen-based and Fl_Image_Surface-based approaches.

Documentation: in the programming manual, mention new class Fl_SVG_Image and member function Fl_Image::scale()?

Deprecate Fl_Image_Surface::highres_image() because Fl_Image_Surface::image() is enough now images are scalable.

Make member function Fl_Image_Surface::get_offscreen_before_delete() be private.

Remove useless #include <FL/Fl_Shared_Image.H> following usage of the new Fl_Image::scale() member function.

Simplify Fl_XXX_Window_Driver::capture_titlebar_and_borders() using Fl_Image::scale().

Improve fl_overlay_rect() when GUI is scaled.

Fix Fl_Screen_Driver::traverse_to_gl_subwindows() to support Fl_Widget_Surface::print_window_part().

Improve Fl_Screen_Driver::traverse_to_gl_subwindows(), still needs to be completed.

Fix Fl_X11_Screen_Driver::read_win_rectangle() when GUI is scaled.

Add checks for NULL pointer, just in case.

Simplify Fl_Gl_Device_Plugin::print() using the Fl_Image::scale() member function.

Documentation: improve doc of Fl_Widget_Surface::print_window_part() and Fl_Widget_Surface::printable_rect().

Shorten the list of virtual member functions used to support Fl_Widget_Surface derived classes.
    
    Change Fl_Cocoa_Screen_Driver::read_win_rectangle() so it captures only
    from the current window and ignores its subwindows, as do other Fl_Screen_Driver derived classes.
    
    Remove Fl_Cocoa_Printer_Driver::print_window_part() that is no longer necessary.
    Remove Fl_Printer::print_widget() and Fl_Printer::print_window_part() that
    are no longer necessary.
    
    Stop Fl_Widget_Surface::print_window_part() from being virtual because its platform-independent
    implementation should suffice.

MacOS: improve fl_overlay_rect() when GUI scale factor = 1.7

Simplify fl_overlay_rect() using the Fl_Image::scale() member function.

Fix fl_overlay_rect() under X11 and Windows when GUI is scaled.

Simplify Fl_Widget_Surface::print_window_part() using the new Fl_Image::scale() member function.

Make virtual void Fl_Surface_Device::end_current_() have no argument because none is used.

fluid: update copyright year.
    
    This is particularly useful for fluid/about_panel.{fl,cxx,h}.

Update fluid (.fl) files.
    
    src/Fl_Help_Dialog.fl: Add one missing declaration.
    
    Other files: update (fluid -u) and update source (fluid -c).

Add missing function fl_define_FL_ICON_LABEL() (STR #3468).

Extend documentation of fl_begin_offscreen()

Fix indentation.

Fl_WinAPI_System_Driver::paste() : fix handling of clipboard containing top-down DIB image.

Fl_WinAPI_System_Driver::paste() : fix indentation only.

Pasting image from clipboard: partial support of top-down DIB image (still needs completion)

Slightly simplify examples/clipboard.cxx using Fl_Image::scale().

Fix Fl_WinAPI_System_Driver::paste() when clipboard contains GIF image

Fix Fl_WinAPI_System_Driver::paste() when the clipboard contains an image as a DIB and for GUI scale support.

Expand the doc of class Fl_Graphics_Driver.

Documentation: complete doc of Fl_Image_Surface::offscreen()

Simplify API for Fl_Image_Surface::Fl_Image_Surface(int w, int h, int high_res, Fl_Offscreen off) with non-null offscreen.
    
    The caller no longer needs to call Fl_Image_Surface::get_offscreen_before_delete() before object deletion,
    because the object destructor knows the offscreen has not been created by the Fl_Image_Surface constructor.

Fix Fl_WinAPI_System_Driver::paste() when clipboard contains an image and the GUI is scaled.

Fix Fl_GDI_Graphics_Driver::copy_offscreen() when the destination surface is an Fl_Copy_Surface object.

class Fl_Xlib_Image_Surface_Driver : Remove unused member variable.

Have Fl_WinAPI_Window_Driver::capture_titlebar_and_borders() restore the window's device context before return

Windows: fix fl_copy_offscreen() when input offscreen is scaled and output surface is printer.

Windows: avoid changing the current Fl_Surface_Device when drawing an Fl_Double_Window.
    
    This change was previously attempted at r.12792 but the test/offscreen demo did not run well with it.
    This commit fixes the problem: the global fl_window should not be changed when drawing to
    an Fl_Double_Window.

Undo change at r12792 (24 march 2018) because test/offscreen does not work with it.

Complete Fl_Android_Graphics_Driver::cache() functions that should assign the image's cache_w_ and cache_h_ member variables.

Fix Fl_GDI_Graphics_Driver::cache(Fl_Pixmap *) where 2 distinct Fl_GDI_Graphics_Driver objects should be used in the right way.

Remove debugging statement

Fix direct use of fl_draw_pixmap() whithout Fl_Pixmap object.

Fix background color when drawing pixmap data both directly or as an Fl_Pixmap object.

Fix handling of bg argument of fl_draw_pixmap(char**, int , int , Fl_Color bg) during direct drawing of pixmap image data.

Reorganise access to the value of the GUI scaling factor with public getter and protected, virtual setter member functions.

Documentation: place Doxygen doc next to function implementation

Documentation: add doc for Fl_Graphics_Driver::cache_size()

Documentation: simplify example code for Fl_Image::scale()

Fix documentation formatting.
    
    Move image out of 'note'.

Clarified the fl_choice ordering in first example with an image and arrows,
    as it's not clear in the text how the code order is reversed on-screen.
    
    Also, the whole 'three musketeers' thing with the case values not matching
    the numeric button names has always been confusing:
    
         case 0: .. // One
         case 1: .. // Two (default)
         case 2: .. // Three
    
    Changed that so it's a Zero/One/Two example instead.
    
         case 0: .. // "Zero"
         case 1: .. // "One" (default)
         case 2: .. // "Two"

Add comments: "Implementation note about how Fl_Pixmap objects get printed under Windows"

Simplify the implementation of printing of Fl_Pixmap images under Windows.

Fix crash in test/device after scale-GUI + Fl_Printer + Fl_Image_Surface

Fix Fl_Text_Editor overstrike mode (STR #3463).

Docs for fl_choice() clarify argument order, added missing image for one of the examples.

Only fix correct indenting of function fl_convert_pixmap()

Comments only: extend "Implementation note about image drawing" to describe the mask_bitmap virtual member function.

Getting rid of warning in Xcode 9.3

Remove virtual member Fl_GraphicsDriver::mask_bitmap(char **) and its re-implementations.

Remove Fl_PostScript_Graphics_Driver::mask_bitmap(char **) that is useless.

Comments only: complete "Implementation note about image drawing" about how to destroy cached images.

Add Fl_Android_Graphics_Driver::delete_bitmask() needed to uncache a cached Fl_Bitmap image.

Remove useless re-implementation of this virtual member function.

Comments only: extend the description of how Fl_Graphics_Driver derived classes support image classes.

Restore building for X11 with HAVE_XRENDER = 0

Remove useless 'friend' statements from class Fl_Graphics_Driver

Comments only: more extensive explanation of how virtual member functions of Fl_Graphics_Driver can support image drawing.

Remove Fl_Pixmap::prepare() and Fl_Bitmap::prepare() that were used only once.

Homogenise and simplify the API of Fl_Graphics_Driver::cache(image-type *) virtual member functions.

Simplify code for image drawing by PostScript graphics driver.

Update 'examples' (test) documentation, add images.
    
    Add missing documentation of demo programs in the 'test' directory.
    Some images were added as well.

SVG support: improve printed SVG images by increasing the resolution when printing.

Image drawing: simplify the code organisation to better support Fl_Image::scale() - continued
    
    This completes changes introduced at r.12828.

Image drawing: simplify the code organisation to better support Fl_Image::scale().
    
    Graphics drivers now use up to 6 virtual member functions to support Fl_Image
    drawing in the context of GUI and image rescaling :
      virtual void draw_pixmap(Fl_Pixmap *pxm, int XP, int YP, int WP, int HP, int cx, int cy)
      virtual void draw_bitmap(Fl_Bitmap *bm, int XP, int YP, int WP, int HP, int cx, int cy)
      virtual void draw_rgb(Fl_RGB_Image *rgb, int XP, int YP, int WP, int HP, int cx, int cy)
    and
      virtual void draw_fixed(Fl_Pixmap *pxm, int XP, int YP, int WP, int HP, int cx, int cy)
      virtual void draw_fixed(Fl_Bitmap *bm, int XP, int YP, int WP, int HP, int cx, int cy)
      virtual void draw_fixed(Fl_RGB_Image *rgb, int XP, int YP, int WP, int HP, int cx, int cy)

Remove unnecessary dependency on FL/Fl_Rect.H.
    
    Fl_Rect.H is no longer included by Fl_Group.H to avoid unnecessary
    dependencies on Fl_Rect.H. Currently it is only needed to access the
    array returned by the protected method bounds().
    
    Also clarified documentation.

Remove unused variable, update dependencies.

Document Fl_Rect::r() and b() to be outside the rectangle.

General description: mention how to move items around

X11: Fix drawing of sliders with gtk+ scheme and GUI scaling >= 2 -- continued
    
    Other places where line_delta_ is to be used.

Added global Fl::visible_focus() checkbox.
    Also fixed tab navigation order of some widgets, and +/1 heights with a few checkboxes.

X11: Fix drawing of sliders with gtk+ scheme and GUI scaling >= 2 that left footprints when moved.
    
    The fix is to use the X11 graphics driver's line_delta_ private member variable also when drawing complex
    shapes with fl_begin_loop(). The gtk+ scheme does use fl_begin_loop() to draw its frames.

Fixes STR #3459.

Android: Drawing RGB and monochrome image data on the fly from a buffer. Untested.

Android: Drawing RGB image data on the fly via callback

Android: Drawing RGB image data (and probaly rgba and grayscale as well). Testing unsing test/color_chooser.cxx

Added mention of the new Fl::menu_linespacing() in the Fl_Menu_ docs.

Added Fl::menu_linespacing() to solve STR# 2927.
    Method name follows Fl_Tree::linespacing().
    Implemented similarly to Fl::scrollbar_size(), since its use crosses Fl_Menu_Item and 'menuwindow' classes.

Minimal code edit, no functional change.

Refactor and simplify Fl_Group::resize().
    
    I renamed variables (more consistent names), fixed code formatting, and
    refactored the code around the resizing of widgets. I put common code
    before and after the conditional '#if 1' that separated old code from
    new "much simpler code from Francois Ostiguy" as a comment in the existing
    code mentioned. Then I deactivated the old code and activated the new
    "much simpler" code. Tested, works well.

Add more display scaling factors for testing.
    
    These scaling factors can be activated by defining the preprocessor
    macro TEST_SCALING.
    
    Note: this feature may be changed or removed in the future.

Image classes: memorise the width and the height of the cached form of the image to support GUI scaling

Android: Implemented Pixmap drawing, also much cleanup in Fl_Android_Graphics_Driver.

Android: Fl_Android_Graphics_Driver now derives from Fl_Graphics_Driver and no longer from the dpi-aware scaling version. I may add this level of complexity later, but for now, unscaled drivers are difficult enough. Also, the new setup lets me easily find unimplemented methods of the driver.

Android: New version of the IDE Android Studio 3.1 . All still working fine.

Android: Draws Fl_Bitmap.

Fix for STR#3457: Fl_SVG_Image handling of invalid width/height

Android: Avoids hiding and showing keyboard when focus changes from text input to text input

Android: Widgets can now request the on-screen keyboard when they get focus. This may fail if visible_focus is disabled.

Android: Keyboard handles modifiers like Shift and Alt... .

Documentation: give more detail for Fl_Image::w(int W) and Fl_Image::h(int H)

Android: Added keycodes to make arrow keys, delete, return, and other non text-keys work. ALso added a Java helper class to make Java call easier. We may need more Java/JNI in the future.

Android: Separating keyboard stuff into a new file

Android: Improved event handling to handle all pending events before redrawing the interface.

Documentation: explain how images are best handled in the context of GUI rescaling.

Android: Tried to fix flaws in the Android Native interface. Only
             solution I found involves Java, so, no.

Remove GUI scale factor values above 300% which were here for development only.
    
    300% is also the max scaling value Firefox allows.

Android: Even rougherer cut to make the keyboard pop up.

Android: Rough, verz rough kezboard handling.

Android: Made popup and menu windows work, fixed Fl::wait() recursion,
             fixed incompatible Fl::wait() behavior.

Windows: avoid changing the current Fl_Surface_Device when drawing an Fl_Double_Window.

Android: Using floating point calls to make thigs look slightly better.

Android: Using xlib shortcut to draw circles and ellipses.

Android: Further testing. Need circle drawing rountines.

Android: Added fl_polygon and fl_loop calls. All boxtypes draw well now.

Android: Posting well behaved pie drawing method. Needs refactoring.

Fix Fl_Image::copy() and its versions for derived image classes following the introduction of Fl_Image::scale()

Android: Posting pretty buggy pie method; must visit later!

Rename Fl_Image::pixel_w() and pixel_h() to Fl_Image::data_w() and data_h().
    
    The docs of class Fl_Image and of Fl_Image::scale() are beefed up.

Android: Implemented vector drawing and polygons.
             Started to implement arc and pie drawing

Fixed title bar

X11: Remove tentative, uncompiled code to cache RGB images with Xrender Picture instead of Pixmap
    
    The speed benefit is not obvious.

Extend the doc of Fl_Image::scale() member function.

Fix, optimize, and comment "gleam" scheme box drawing.
    
    Some border lines were too short or too long, the shading code would draw
    too many shaded lines, and the code was hard to understand.
    
    With this commit all background pixels of the box are drawn exactly once.
    The border lines are consistent, but some pixels of the border are not
    drawn at all so the background shines through. This is intended for
    backwards compatibility.
    
    A minor change is that the drawn background does no longer overlap the
    border lines. Hence undrawn pixels that previously displayed the colored
    box background are now transparent and show the parent's background color.
    
    This commit adds comments and implementation notes to make the code
    easier to understand and better maintainable (hopefully).

Remove compilation warning with gcc-6.3 and -Wreorder

New member function Fl_Image::scale(int width, int height) to set the FLTK size of an image.
    
    Each image has now two sizes implemented as follows:
       - the pixel size is stored in private members pixel_w_ and pixel_h_
        with public accessors pixel_w() and pixel_h()
       - the FLTK size is stored in private members w_ and h_ and read by w() and h()
       - when the image is constructed, the two sizes have the same value
       - the protected w(int) and h(int) member functions set both FLTK and pixel sizes.
       - the public scale(int, int) member function is essentially nothing but
       set the FLTK size and don't change the pixel size.
       - when the image is drawn, its FLTK size determines how big it is drawn, its pixel
       size determines how much data are available to draw it.
    
    FLTK 1.3.4 with FL_ABI_VERSION=10304 contained an equivalent member function
    but only for the Fl_Shared_Image class.

Remove useless member function declaration.

Android: Implemented font changing ( Fl::set_font(ix, name); )
             and other font stuff. Fixed horizontal and vertical line
             drawing to include last pixel. Added stippling to focus rect.
             Added point drawing (slooow).

Fix a doxygen warning, update copyright.

Android: Fixed another bug when deleting complex clipping areas
             Better complex region cleanup - should be compete now...

Android: Fixed bug when deleting complex clipping areas
             Tested FLTK schemes - nice!
             Fixed crashbug in timer
             Fixed crashbug in mouse handler

Android: intersetcing a complex clipping region with a rectangle
    
    However I did disable the complex region optimizer - too tired to get
    the pointers right... .

Android: added text clipping in all its uglyness.
    
    Next: intersetcing a complex clipping region with a rectangle

Android: added fontattributes, so formatting works well now.
    
    Next: add clipping

Android: added font access into Android package via Assets, added font
             fallbacks, added emergency font as an asset, added graceful
             behavior when absolutely no font could be loaded.
    
    Next: add other font related calls, add clipping

Android: added chaching
    
    Next: add other font related calls, add clipping,
          add font paths for package resources

Android: yes, we can unicode; cleanup; documentd
    
    Next: add caching, add other font related calls, add clipping,
          add font paths for package resources

Android: basic font management structure is complete.
    
    Next: cleanup, document, add caching, add other font related calls,
          add clipping, add font paths for package resources

Android: loading and rendering multiple fonts at multiple sizes.
    
    This code is still a total mess and incredibly inefficient.

Android: finally founded font functionality, freakishly fluttered first
             files, further fostering follows.
    
    Or, to put it bluntly, I forgot how the font system works, and now I am
    digging through the implementations of other drivers, carrying bits and
    pieces together. But you know that I will clean my files eventually... .

Android: starting to handle user clipping regions, but first I will
    render better text, so I have something to test this on.

Android: added function to optimize complex regions

CMake/fltk-config: update fltk-config (LDFLAGS) for MacOS.
    
    This is a preliminary patch to enable linking with pango on MacOS
    when fltk-config is used. A better solution is under development.

Android: clipping regions code grew so big, they moved into their own
    header and source file.

Fix whitespace and comments only.

Android: commented the iterator code of the complex clipping area.

Android: clipping code cleanup, xy and yx lines are clipped

Android: window clipping working fl_rectf.
    
    This code is not very beautiful, but the resulting class should be
    easy to use. A range-based loop can be used to find all relevant
    clipping rectangles for a drawing call.

Improve X11 coordinate clipping.
    
    Make clipping methods non-virtual so they can be inlined.

Fix a potential internal stack overflow in Xlib graphics driver.

Remove unused #include files and FL_CFG_* conditional code.

Fixing Tabs, typos, and comments.

Fixing FIXME's and tab characters in fl_shortcut.cxx.
    
    Yes, I am bored otherwise.

Removed warning for Android. Fixed "FIXME" in Fl_Tooltip. Removed tab characters.

Android: implemented good complex clipping, but unoptimized.
    
    fl_rectf is so far the only function that uses the complex clipping
    region successfully. Code is slow, but works.

Android: implemented complex clipping at the first level.
    
    Clipping areas are calculated for overlapping windows, named "Desktop
    Windows". The first level implementation works if the resulting complex
    region is just a rectangle. Higher complexity (sub-rectangles) is next.

Android: adding stress test for complex clipping.
    
    Complex clipping is needed to allow popup dialogs and menu window while
    still correctly rendering windows that are "below" those popups.

Improve and simplify X line and rect 16-bit clipping.
    
    Back to 16-bit coordinate limit clipping (actually +/- (2**15 - 8).
    The clipping range is now constant, symmetrical, and stored in the
    driver object.
    
    Also fixed a bug in Liang-Barsky line clipping algorithm.

Android: fixed Fl_Rect.H commit.
    Cleaned up some driver code.

Android: added support for Fl::add_timeout() and friends.

Android: Reinstated working simple cliping functionality based on an
     improved Fl_Rect_Region class instead of Fl_Rect. Commented out
     complex clipping.
    
     Android lib and apps now use C++11 because they can (and I like it).

Make Fl_Graphics_Driver constructor protected, as it was in FLTK 1.3.x

Android: Made Fl_Rect virtual. Maybe a bad idea?
    Also, added rectangular clipping which works.
    Expanding now to a more complex clipping scheme to make multiple
    windows work.

Document fl_numericsort() and fl_casenumericsort().
    
    Note: These two functions are not yet UTF-8 aware. Results may be unexpected.
    
    Possible test case: run test/file_chooser or any FLTK program with
    Fl_File_Chooser. The default display order is determined by fl_numericsort():
    
      Fl_File_Chooser::sort = fl_numericsort;

Documentation: homogenize to 'scale factor' and 'drawing unit'

Documentation of fl_create_offscreen: give more details useful because the screen scale factor can now vary.

Documentation: homogenize the use of "screen" rather than "display" and "FLTK units".

Documentation: homogenize uses of "FLTK units" and "drawing units".

Remove mention of -DFLTK_HIDPI_SUPPORT which was removed.

Android: finally taught AndroidStudio where the SVN root directory is
    located. No more SVN from the command line.

Documentation: describe the new GUI scaling feature of FLTK 1.4

Android: fixed some variables to avoid crashing.

Android: adding and fixing to the graphics clipping code
    
    Android has no classic window manager, so FLTK has to
    make sure that popup windows, dialog boxes and multi
    window interfaces work as expectd.

Remove useless #include statement.

Fl_Xlib_Graphics_Driver::scale_clip: restrict the computed X11 region to the 16-bit coordinate space.
    
    This member function transforms the current clip region from FLTK units to pixel units
    multiplying FLTK units by the current value of the scale factor to get pixel units.
    The current clip region has been, by construction, restricted to the 16-bit coordinate space.
    But these data can evade this space after multiplication by the scale factor.
    Thus, it's necessary to enforce the 16-bit space here which is done with Fl_Xlib_Graphics_Driver::XRectangleRegion.

Android: crude graphics clipping

Improve X11 (16-bit) clipping of lines and rectangles.
    
    In FLTK 1.3.x only horizontal and vertical long lines with endpoints
    outside the 16-bit coordinate space could be drawn with proper X11
    coordinate clipping. Now arbitrary lines are clipped so they can be
    drawn with X11 functions.
    
    All rectangles are clipped as well (as in 1.3).
    
    Todo: The code needs better documentation and clipping of polygons,
    circles, curves etc. is still missing. The next step should be the
    clipping of polygons...

Android: move Android specific platform events to FL/android.H

Windows: remove necessity to compile with -DFLTK_HIDPI_SUPPORT to make WIN32 FLTK apps DPI-aware.
    
    At this point, Windows FLTK apps detect HighDPI displays and rescale their GUI accordingly. They also
    all reply to ctrl/+/-/0/ keystrokes to enlarge/shrink/reset their windows.

Fix X11 clip region outside 16-bit coordinate space.
    
    This is the first commit of X11 16-bit coordinate space (clipping) fixes.
    More to follow...

Cleaning FLTK namespace

Android: specific event for Android. Use Fl::add_system_handler() and Fl::event(), for example: FL_ANDROID_EVENT_LOW_MEMORY

Android: moved all Android code from the main app into the driver system. All non-driver-FLTK code and main app are now Android-free.

Android: using wait_for_expose to sync screen and windows

Android: improvements to Fl:flush() implementation. Initial draw, no wasted draw cycles.

Comments: update comment of class Fl_Scalable_Graphics_Driver to indicate what platforms use it.

MacOS: add more detail to the doc of global variable fl_mac_os_version

Android: yet another name for the .bat file

Windows: complete support for GUI rescaling.

Android: moved include files as well

Android: moved to IDE directory.

Android: drawing behaves nice enough. Fl::flush seems to bring the expected results, although optimization is required at some point.

Android: more cleanup. Trying to solve the problem of undefined screen buffer content. Moved gradlew.bat into gradlew.zip to make some svn's happy.

Android: beautified the Fl_Android_Application interface.

Android: reorganizing

Android: case of .h and .H

Android: need more source files

Android: removed crud from original sample code

Android: minor simplifications

Set svn properties on new Android source files.
    
    The Android example files in directory Android/... are not touched.

Android: should build and run

Android: added missing file.

More Android changes.

Fixing Android CMake files

Updated Android README

CMake rules to integrate Android drivers.

Adding crude Android native screen driver

Commiting Android sample project structure

Removing obsolete Android stuff

CMake + configure: improve generation of fltk-config.

Update dependencies.

Replace calls to Fl_Surface_Device::set_current() by calls to Fl_Surface_Device::push_current()

Remove obsolete -DUSE_OPENGL32 from configure and fltk-config.
    
    This definition was introduced in svn r6657 (STR #2147) but never used.
    The new driver model in FLTK 1.4 makes it (the intention described in
    STR #2147) even more obsolete.

Documentation: make code examples use Fl_Surface_Device::push_current()/pop_current()
    
    instead of the deprecated Fl_Surface_Device::set_current().

CMake: fix fltk-config generation for MacOS.

CMake: Fix fltk-config for Windows and Unix/Linux.
    
    This update ought to work with
    
      fltk-config [--use-images] [--use-gl] --compile <c source file>
    
    on both Windows and Unix/Linux when built with CMake. It was tested
    under Windows and Linux using fltk-config directly from the build tree,
    but it should work as well after installation.

Document that fl_mac_set_about() is deprecated, MacOS-specific and replaced by cross-platform Fl_Sys_Menu_Bar::about().

Make forms_timer.cxx platform-independent calling virtual function Fl_System_Driver::gettime().

Remove "#ifdef _WIN32" that made this source file break the separation between platform-independent and -dependent files.
    
    Several other platform-independent source files (e.g., Fl_Browser.cxx, Fl_Group.cxx) use malloc/realloc/free without
    including a special header file for the Windows platform. Thus, Fl_Table.cxx can just be likewise.

Remove unnecessary #ifdef _WIN32

MacOS: correct handling of window tabbing/untabbing together with GUI rescaling.

Remove Fl::run_also_windowless() and FL::wait_also_windowless() from planned public FLTK 1.4 API.
    
    These were introduced at r12647, that is, during development of the 1.4 API.
    These functions provided windowless support only on the MacOS platform,
    where this can be obtained without those functions.
    Windowless support on other platforms would require changing the event
    loop. There's no evidence from STR's there's a demand for windowless mode
    on other platforms.

Don't use FLTK's way to support HighDPI screens when the app has set a DPI awareness through a manifest - cont'd.
    
    It's also necessary to prevent FLTK from rescaling windows moved between screens with different DPI's.

Don't use FLTK's way to support HighDPI screens when the app has set a DPI awareness through a manifest.
    
    FLTK reads during fl_open_display() the scaling factor of each screen and uses that to transform
    FLTK units into screen units. This change avoids this reading if the app declared to be DPI-aware
    though a manifest, a symptom that the app supports HighDPI independently from FLTK.

CMake: fix generated fltk-config for Windows (partially).
    
    This makes 'fltk-config --compile' work with simple test applications
    like hello.cxx etc.
    
    It may not yet work with other options though, particularly with
    --use-gl or --use-images, but it's an improvement.

CMake: fix debug macro for CMake versions before 3.4.
    
    Note: string(APPEND ...) was introduced in CMake 3.4.

Fix Fl_Cocoa_Window_Driver::size_range() to make it support GUI rescaling.

Fix 2 typos.

Slight documentation fix for class Fl_Sys_Menu_Bar.

Documentation: fix inconsistency in doc of Fl::wait(double).

Fix Fl_Cocoa_Screen_Driver::screen_work_area() when the GUI is scaled - continued.

Fix Fl_Cocoa_Screen_Driver::screen_work_area() when the GUI is scaled.

Remove Fl_Window_Driver::current_cursor() and its platform-specific forms that are now unused.
    
    This became unused when window scaling no longer involved window destruction/recreation.

OpenGL apps need to use Fl_Gl_Window::pixel_w() and pixel_h() when calling glViewport() to support GUI scaling.

Restore documentation of function Fl_Mac_App_Menu::custom_application_menu_items()

Slight rewording of the documentation of types fl_intptr_t and fl_uintptr_t.

Rewording of the documentation of types fl_intptr_t and fl_uintptr_t.

Document platform-dependent types fl_intptr_t and fl_uintptr_t
    
    Most other platform-dependent types of FL/platform_types.h are also documented.

Documentation: separate the doc of the 2 versions of Fl::add_fd() as Doxygen mandates.

Fix error when running Doxygen (continued).

Documentation: separate docs of Fl::wait() and Fl::wait(double) as Doxygen mandates.
    
    Also, for Fl::run_also_windowless() and Fl::wait_also_windowless(), mention that
    MacOS is a platform supporting the windowless mode and what happens with
    platforms that don't support it.

Fix trivial typo that was upsetting doxygen

CMake: add macro fl_debug_var to debug variables.
    
    Some debug messages are included, but currently disabled.

After r.12653, it is also necessary to remove Fl_Cocoa_Window_Driver::bitmap_from_window_rect()

Windows: fix fl_overlay_rect() when scaling factor value is > 2

Replace "WIN32" with "_WIN32" or "Windows".
    
    Replace compiler/preprocessor/platform macro "WIN32" with "_WIN32".
    Replace "WIN32" in text and documentation with "Windows".
    Replace "MSWindows" with "Windows".
    
    To do: README.Windows.txt (and maybe other documentation as well)
    needs updates.

CMake: More consistent usage of (IDE) source groups.
    
    Also: add generated header files to project fltk's header files.

Fix fl_read_image() under MacOS platform when GUI is rescaled.
    
    This commit also simplifies the platform-dependent support of fl_read_image():
    only Fl_XXX_Screen_Driver::read_win_rectangle() contains platform-specific
    code to capture pixels from the current window or from an offscreen buffer.
    Platform-independent function Fl_Screen_Driver::traverse_to_gl_subwindows()
    captures subwindows that intersect with the area fl_read_image() targets.

Move xxx_also_windowless member functions from Fl_System_Driver to Fl_Screen_Driver.
    
    Because these functions are related to Fl_Screen_Driver::wait(double)

Documentation: add \version info to new member functions.

STR#3450: Draw text with OpenGL using textures on all platforms.

Beef up documentation of how FLTK handles cmd-Q/Quit xxx events under MacOS.

Add support for detection and processing of clean program termination request.
    
    The default handling of cmd-Q/Quit program under MacOS was to terminate the
    program if all its windows are closed without returning from FLTK's event loop.
    This was running against a strong design feature of FLTK that programs
    should always complete their event loop and return from main() when cleanly
    terminating.
    
    In the new code for the MacOS platform, cmd-Q/Quit program no longer terminates
    the program. Instead, the event loop is interrupted and a call to Fl::program_should_quit()
    allows to detect that program termination has been requested, if necessary.

Reorganize nanosvg bundled library.
    
    Rename altsvgrast.h to its original name nanosvg.h and use a new
    GitHub fork of nanosvg to maintain FLTK specific patches.
    
    https://github.com/fltk/nanosvg
    
    The diff files (altsvgrast.diff and nanosvg.diff) are no longer necessary
    and have been removed. For more information see README.bundled-libs.txt.

Update svn properties.

Fix typos.

Fix remaining issue in FL/porting.H.
    
    This file is not used in the normal build process but was intended to
    be used as a template for a platform specific file. This is likely
    obsolete anyway since the new driver approach no longer uses #ifdef's
    to separate platform specific code.

Fix broken Windows and macOS builds.
    
    The check whether mac.H or win32.H were included directly was wrong
    after the recent rename of x.H to platform.H.

Replace FL/x.H with FL/platform.H - step 2 (STR #3435).
    
    This second step replaces FL/x.H with FL/platform.H in all source files.
    Dependencies have been adjusted as well.
    
    This commit completes the replacement of FL/x.H with FL/platform.H.

Replace FL/x.H with FL/platform.H - step 1.
    
    This first step replaces FL/x.H with FL/platform.H but keeps a small
    FL/x.H that #include's FL/platform.H for backwards compatibility.
    Documentation sources in documentation/src/*.dox have been fixed,
    but references in other source files need to be fixed in another step.
    Dependencies have been adjusted.

X11+pango: correct y position of text in line that was bad for some non-latin scripts and some pango versions.

Add missing CMake variable FL_VERSION for doxygen docs generation.
    
    Thanks to Jakub Tata-Tyczyński for finding this and reporting it in
    fltk.coredev.

Remove obsolete replacement of CMAKE_SOURCE_DIR.
    
    The correct fix in the previous commit (svn r12636) would have been to
    replace CMAKE_SOURCE_DIR with FLTK_SOURCE_DIR since CMAKE_SOURCE_DIR is
    no longer used in doxygen docs generation. Sorry for the noise.

Implement Jakub's patch for the missing FLTK_SOURCE_DIR in
    the doxyfile generation of the html docs.

Avoid crash in Fl_Pixmap::copy() when the source Fl_Pixmap contains bad pixmap data.

Fix invalid porsche1.xpm file.
    
    test/pixmaps/porsche1.xpm was likely an experimental version of file
    test/pixmaps/porsche.xpm. I fixed it instead of removing because it
    looks nice as well.

Clarify documentation of Fl_Boxtype.
    
    Fl_Boxtype enum values with leading underscore are reserved and should
    not be used. Use the name w/o leading underscore instead.

configure: add checks to avoid incompatible options --disable-xft and --enable-pango and to detect if pango is found but not Xft.

CMake: test option compatibility: Pango requires Xft.
    
    Abort CMake configuration/generation if Xft is disabled or not found
    but Pango is requested because Pango requires Xft support. A detailed
    warning message is issued before the CMake generation is aborted.

CMake: enable building FLTK in a subdirectory of another project.
    
    Basically replace CMAKE_XXX_DIR with CMAKE_CURRENT_XXX_DIR where
    XXX = SOURCE or BINARY.
    
    Patch proposal by cleanrock, FLTK PR #4:
    https://github.com/fltk/test-only/pull/4
    
    Patch modified to fix target dirs for test programs and doxygen docs.

Fl_Sys_Menu_Bar under MacOS: prevent the FLTK object from receiving events.

Put a default implementation of parse_color() in Fl_Screen_Driver and only Fl_X11_Screen_Driver reimplements it.

MacOS + CMake: restore use of OPTION_APPLE_X11 under MacOS 10.13
    
    It's necessary to compile with -mmacosx-version-min=10.8
    and to link with -lfontconfig when Xft is used

MacOS configure --enable-x11: add needed compilation option under MacOS 10.13

MacOS: More accurate coordinate computation in rect_to_NSBitmapImageRep() when GUI is rescaled.
    
    The modified statement uses the window height in graphics coordinates that has been truncated to
    integer at window creation and resize.

Make Fl_Quartz_Graphics_Driver treat line width similarly with lines and loops

Some cleaning in comments

Add necessary inline implementation of Fl_SVG_Image::copy(void).

Add Doxygen comments explaining the purpose of Fl_Window_Driver::draw_begin()/draw_end().

Restore correct fl_overlay_rect() when GUI is scaled (was broken by commit r.12595)

Fix comment.

Remove the requirement for opengl in fltk-config.
    
    opengl apps were left out of the targets list on purpose
    so that only non-opengl apps would build.
    
    TODO: Determine a way to detect the presence of fltk opengl libs
          from within the Makefile using only fltk-config, so as to
          conditionally build the opengl examples.
    
          Do NOT use fltk's own build system (../makeinclude or cmake)
          to determine this, so the Makefiles will work as user examples.

Remove 'friend class Fl_PicoSDL_Window_Driver' from Fl_Window.H

Definition of class Fl_Window: use 'private:' more accurately

CMake: Fix missing WIN32 definition on Windows platforms.
    
    Although some Windows compilers still #define WIN32, more and more
    standard compliant compilers only #define _WIN32. FLTK *did* #define
    WIN32 for all Windows targets with autoconf/configure, but that bit
    was lost for CMake builds. This is necessary until we replace WIN32
    with _WIN32 throughout the Windows specific code.

GUI rescaling under MacOS: fix Fl_Cocoa_Screen_Driver::read_image() - continued

GUI rescaling under MacOS: fix Fl_Cocoa_Screen_Driver::read_image() when reading from scaled offscreen buffer

Support for GUI rescaling: fix fl_copy_offscreen() to PostScript surface under X11.

Continue support for GUI rescaling under MacOS: fix test/resize() application - continued

Continue support for GUI rescaling under MacOS: fix test/resize() application

Continue support for GUI rescaling under MacOS: fix fl_XXX_offscreen() functions and Fl_Image_Surface class

Continue support for GUI rescaling under MacOS: fix Fl_Cocoa_Window_Driver::capture_titlebar_and_borders()

Continue support for GUI rescaling under MacOS: fix Fl_Overlay_Window.
    
    This patch also improves by simplification the code of class Fl_Quartz_Image_Surface_Driver:
    because, under the driver model, there's a separate graphics content for the display and for
    each offscreen buffer, it's possible to reverse the drawing orientation (draw from top to bottom)
    once at offscreen creation. It's thus no longer necessary to reverse orientation in
    Fl_Quartz_Graphics_Driver::restore_clip() specifically for offscreen buffers.

Scaling capability under MacOS platform: fix capture of scaled window.

Update .clang-format, improve comments.

Fix Fl_GDI_Graphics_Driver::uncache(Fl_RGB_Image*,...) that did not delete correctly the cached offscreen object.
    
    This bug was detected by a test program that rotates an SVG image. But it's not related to SVG,
    and concerns any Fl_RGB_Image on the WIN32 platform. It was introduced when
    image support was modified according to the driver model.

Fix indenting and formatting according to the CMP.
    
    Sorry for the big commit. There were so many indenting and formatting
    issues in src/Fl_win32.cxx that I decided to reformat it with clang-format
    (see previous commit). However, this commit is not the direct result
    of using clang-format - I adjusted some parts of the code manually.
    
    Other manual changes: I ...
    
     - reordered some #define's and added comments
     - added comments to switch/case/break statements and {} for clarity
     - moved a few 'break' statements inside or outside of braces {}
    
    There should not be any code changes though, i.e. the compiled object
    code should be identical.

Add an experimental .clang-format file.
    
    This file can be used with clang-format to format c and c++ source
    files according to the FLTK CMP -- at least "almost" in its current
    version. It should not (yet) be used without further checking of the
    result.
    
    Note: there are some deliberate non-conformant formattings in current
    source files, such as formatting like (better readable?) tables with
    columns etc.. Such special formatting can be preserved with clang-format
    "pragma's" (see documentation in .clang-format), but this needs source
    file changes before formatting.

Fix bug when drawing text with Fl_OpenGL_Graphics_Driver and scaled GUI.
    
    The bug appeared in test/cube where the "Text" string was mispositioned
    when the app was rescaled.

STR#3437 : Support display of windows in tabbed form as in MacOS 10.12 Sierra

STR#3320 continued: make sure there's no undrawn space between nested rectangles and images.

STR#3444: Add MacOS support for application rescaling (not quite complete)
    
    With this, most MacOS FLTK app can be scaled with command/+/-/0/ keystrokes.
    A scaling problem remains, visible in test/cube, where the "Test" string is not positioned correctly.
    
    GLUT apps can also be scaled (across platforms).
    
    SVG images are re-rasterized after app scaling for optimal drawing.

Fl_Window_Driver constructor: initialise wait_for_expose_value to 0.

Initialize all member variables in the Fl_Window_Driver constructor.

Remove VS specific #pragma comment (lib, ...).
    
    This Visual Studio specific pragma hides missing library references
    on Visual Studio builds, but since comctl32 is not the only necessary
    Windows dll and this has never been extended to other libs, this pragma
    is unnecessary and potentially confusing, so I removed it.
    
    Documentation of dependencies mentions comctl32 (and more) and future
    CMake generation of user project VS IDE files can reference the FLTK
    dependencies by internal (CMake) means anyway.

Improve schemes unittest (add selection colors to buttons).
    
    Use check and radio buttons with different selection colors to
    verify selection colors with different schemes.

SVG images: fix image printing under MacOS when not used as a scaled Fl_Shared_Image

Doxygen doc of class Fl_Shared_Image: add that the SVG format is also supported.

Fix spelling and clarify documentation.
    
    Add a hint that localization of shortcut modifiers fl_local_ctrl
    etc. should not be done in static initializers because random static
    initialization order might overwrite strings with internal values.

Further simpler code to initialise the MacOS-specific implementation of Fl_Sys_Menu_Bar_Driver

Simpler code to initialise the MacOS-specific implementation of Fl_Sys_Menu_Bar_Driver

Make sure GUI is updated after activation of a menu item from Fl_Sys_Menu_Bar

MacOS: support running fl_open_display() in static initializer.

Doxygen: remove warning

Some code simplification for class Fl_Sys_Menu_Bar

Set svn properties.

Make Fl_Sys_Menu_Bar class usable in static initializers.

Restore possibility to run fl_open_display() within a static initializer.

Remove Fl_Sys_Menu_Bar.mm from list of input files

Set proper properties

Converted class Fl_Sys_Menu_Bar to the driver model.

MacOS: use rounded bottom corners when drawing windows

Fl_Widget_Surface::draw(Fl_Widget *widget,...): clip drawing to the window bounds when widget is a window.

Top-level menus should not be inactivated. Their items can be.

Fixes issued raised in STR #3422; Fl_Text_Display constructor order issues;
    organize member initialization first, method calls last.
    
    Also:
        Reorg'ed member initialization to match order in .H
        to detect missing member inits.
    
        Noticed member mModifyingTabDistance is unused.
        Tagged with XXX: but left in place, since it's
        a protected member, and might be utilized by user code.
        We should probably remove this member.

MacOS native file chooser: STR#3406 continued - restore broken filename preset in save dialog.

Fixes STR#3428: allows command line to specify alternate html file on Mac platform

Fix illegal memory access after free when closing fluid (STR #3427).

Fix crash when closing fluid with Fl_Table (STR #3427).
    
    Many thanks to Chris for the patch!

Replace remaining calls of getenv() with fl_getenv().
    
    Note: don't use fl_getenv() in Fl_System_Driver and derived classes.

Proper return value from test window::handle() when the event is not processed.

MacOS: Fix STR#3406 where native file chooser does not show preset file

MacOS: complete commit at r.12559 that contained a typo.

MacOS: make -[FLWindowDelegate windowShouldClose:] more robust by testing for NULL pointer.

Replace chdir() with new wrapper fl_chdir().

MacOS: improve drawing of rounded corners of window titlebar

Refactor Fl_WinAPI_System_Driver string conversion and more.
    
    Remove duplicated code by using local (static) string conversion functions.
    This makes the code better maintainable and removes redundancies.
    
    Rename some variables (particularly one-letter names) to more useful
    names, minor code reformatting to be more compatible with the CMP.
    
    To do: check for potential memory leaks, maybe free temporary buffers.

Test commit

Test commit

Test commit

Test commit

Minor reformatting

Make a comment more detailed

Add missing platform wrapper fl_chdir() for chdir().
    
    Tested under Windows and Linux, but not yet used in library code.

MacOS: improve drawing of the rounded corners of window titlebars.

MacOS: fix capture of window titlebar under MacOS 10.13 "High Sierra"

Fix compiler warning [-Wunused-result].
    
    Full warning:
      ignoring return value of ‘size_t fread(void*, size_t, size_t, FILE*)’,
      declared with attribute warn_unused_result [-Wunused-result]
    
    Note: added "FIXME ...": current code ignores file read error.

Fix doxygen docs: missing excludes and CMake paths.
    
    This commit fixes two issues:
    
    Doxygen build with CMake needs paths relative to CMake source dir.
    
    Missing excluded files taken from STR #3320, file #42 (by Manolo):
      http://www.fltk.org/strfiles/3320/scaling_rect_r12544.patch

Fix drawing of tab characters when display is rescaled.
    
    The problem is announced in comment #99 of
    http://www.fltk.org/str.php?L3320

fl_text_extents(): added example, included reference to fl_font() and fl_measure().

Updated scrollbar size's instructions, increased font size.

Remove 1 deprecation warning.

Remove 3 deprecation warnings.

Doxygen doc: minor rewording for the Fl_SVG_Image class.

Addresses STR# 3423; adds missing scrollbar_size() methods and honors global Fl::scrollbar_size().
    Includes mods to unittest's scrollbar size test.

test/valuators demo modified to use Fl_Simple_Terminal.
    
    Also added missing callback to show Fl_Spinner values.
    
    Improved callback messages to indicate which widget's value is being displayed.

Fix for STR#3421: Fl_SVG_Image crashes if passed an svg file that is a static const char* string

Added check if nanosvg is enabled or not.
    The example posts a warning dialog if it's not (vis a vis test/cube demo)

Makefile for new example.

Added a new example to demonstrate using Fl_SVG_Image.

Solves STR# 2682, Albrecht's comment #13. Applied slightly modified version of
    chris's test_02.diff patch (comment #19).

Fixes STR# 3420; fluid crash on certain static functions.

STR #3395: Revisions as per chris's comment #4.

Solves STR#3395.

Removing test line added a while ago.

MacOS: replace deprecated message by its recommended successor.

Fix scrollbar issue of Fl_Text_Display (STR #3412).
    
    This fix disables a part of the optimization introduced in svn r11208
    (STR #3272).
    
    For more information see comments in STR #3412.

Doxygen doc: separate the doc of the getter and the setter member functions.

Refer to the preferred Fl_Surface_Device::push_current()/pop_current() functions.

MacOS: replace [[NSRunningApplication currentApplication] isActive] requiring 10.6 by [NSApp isActive]

MacOS: improve handling of dropped files at launch time for MacOS 10.13
    
     Because opening a file can call the event loop and thus access the list of dropped files,
     it's necessary to remove the object from the list before opening the file.

Small doc tweaks for clarity.

Fl_SVG_Image: remove use of gzdirect() that is absent in some old versions of zlib

Revert accidentally committed part of r12511 (STR #2788).
    
    r12511: "Addresses STR #2788 for cursor positioning with mouse-click ..."
    
    The here reverted part was the proposed patch of STR #3412:
    "Fl_Text_Display scroll bug (style table with font != textsize() + wrap)".
    
    See patch file: http://www.fltk.org/strfiles/3412/quickfix.patch

Add details to the doc of fl_open_callback().

Fixes STR# 3388, format_char(0) can cause array overruns/garbage characters.

Mac OS 10.13 "High Sierra": restore possibility to run app from a command line and find it activated.

MacOS: make sure all files dropped to the app at launch time are open when Fl_Window->wait_for_expose() is used.

Addresses STR #2788 for cursor positioning with mouse-click on different sides of character.
    Applying guyben's patch (with small mods suggested by albrecht & greg in comments 7-11).

MacOS: slightly simpler implementation of Fl_Cocoa_Window_Driver::wait_for_expose().

Mac OS: complete changes needed for 10.13 "High Sierra" regarding how FLTK applications start.
    
    With MacOS 10.13 "High Sierra", it was necessary to change what happens at application start time.
    The new procedure is:
    fl_open_display() calls [NSApp run], and during this call:
         the main event loop is started;
         the app delegate receives an openFile: message for each file dropped on the app icon. Each
               such filename is memorised in an NSMutableArray called dropped_files_list;
         the app delegate receives applicationDidFinishLaunching and stops the main event loop
               (this seems to occur unpredictably after the first openFile: message or after all of them).
    When the FLTK event loop begins, it checks whether dropped_files_list is empty. If it is not,
       the first element of this list is a filename which is opened and is removed from dropped_files_list.
    
    This new setup allows to turn resizable windows fullscreen and back as expected under MacOS,
    and to support launching apps while dropping file(s) on its icon.

Changed Fl_Simple_Terminal::draw() public -> protected

Added Fl_Simple_Terminal widget, and mods to test+example programs (STR #3411).

Fix typo.

MacOS 10.13: fix problem with window made fullscreen by clicking on green window button - continued.

MacOS 10.13: fix problem with window made fullscreen by clicking on green window button.
    
    With MacOS 10.13 "High Sierra", when a window is made fullscreen by clicking on the green window button,
    the window hides the system menubar, but it's not possible to show the menubar by moving the pointer
    to the very top of the window. This new way of starting apps fixes this problem.

Replace remaining calls to getcwd() with fl_getcwd().

Rename fl_open_ext() parameter 'translation' to 'binary'.
    
    The default (0) is 'text' mode, non-zero is 'binary' mode on platforms
    that distinguish text and binary mode.
    
    Currently Windows is the only supported platform that needs this.

Replace remaining calls to access() with fl_access().

Replace inappropriate usage of __WATCOM__ with _MSC_VER.
    
    Note: this is in parts temporary since some of the functions redefined
    for Visual Studio will be replaced with fl_*() functions in later commits.

Fix doxygen and other comments, coding style, and alignment.
    
    Replace QT style doxygen markers "/*!" with Javadoc markers "/**".
    
    This commit does not change executable code.

Replace remaining calls to unlink() with fl_unlink().
    
    Tested under Linux, MinGW, and Visual Studio 2015.

Fix conditional compilation under Windows.
    
    Target of the condition was MS Visual Studio, hence the replacement
    of "ifndef __WATCOMC__" with "#if defined(_MSC_VER)".
    
    Tested under Windows with MinGW and Visual Studio 2015.

Fix confusing (QT style) doxygen comment marker.
    
    Add a space between '/*' and '!'.
    Other changes: comment alignment.

Update dependencies.

Replace remaining calls to getenv() with fl_getenv().
    
    ... except in driver code that uses Fl_System_Driver::getenv().
    
    Todo: Check if all remaining calls of getenv() in driver code are correct
    or might use ::getenv() to avoid one calling level for optimization.

Remove the Fl_SVG_Image::fl_gzopen() member function that is less useful with the new fl_open_ext() function.

Mention new function fl_open_ext().

Add fl_open_ext() to control whether the file is opened in binary/text mode.
    
    This new function allows to write Fl_SVG_Image::fl_gzopen() in a completely platform-independent way.

Remove undesired rounding when Fl_Shared_Image::scale() is called with proportional = 0.

Better implementation of Fl_Cocoa_Window_Driver::wait_for_expose() for Mac OS 10.13 High Sierra.

Small clarification in dev docs.

Added docs for the mLineStarts[] array, and related mNVisibleLines.

Added printf() and vprintf() to Fl_Text_Buffer

Fixed seemingly random whitespace..

Fix compiler warning under Visual Studio.

Fl_SVG_Image::fl_gzopen(): write it more platform-independently (still not completely though)

Fix name clash with zlib gzopen on (64-bit) Linux.
    
    Compilation error message:
    
    src/Fl_SVG_Image.cxx:80:21: error: out-of-line definition of 'gzopen64' does
    not match any declaration in 'Fl_SVG_Image'; did you mean 'gzopen'?
    void* Fl_SVG_Image::gzopen(const char *fname) {
                        ^~~~~~
                        gzopen
    /usr/include/zlib.h:1709:20: note: expanded from macro 'gzopen'
    #    define gzopen gzopen64
                       ^
    
    The culprit was the macro defined in zlib.h (above).

Fl_SVG_Image constructor: handle case where file cannot be opened.

Fl_SVG_Image class: add support for compressed .svgz image files.

Undo commit at r.12475 that is not adequate.

Fl_SVG_Image class: add support for compressed .svgz image files.

Added missing accessor for Fl_Text_Display's cursor_style()

Add public accessor Fl_Shared_Image::original().
    
    This public, inline, and read-only accessor is intended for debugging
    purposes but can be useful for user code as well.

Small doc simplification/shortening

Change copyright year

Update the doc of the Fl_Image_Surface constructor to reflect HiDPI support by the WIN32 and X11 platforms.

Make function gnome_scale_factor() more robust by checking each gnome key exists before asking for its value.

Change copyright year to reflect date of last commit.

Testing svn commits for manolo to see if this triggers website access problems.

Remove obsolete include directive.

X11 platform: Allow running with old (< 2.36) versions of libglib-2.0
    
    These versions require calling g_type_init(). Newer versions don't.

Convert the initialisation of global variables fl_local_shift, fl_local_meta, etc... using the driver approach.
    
    This avoids repeating the default values "Shift", "Meta", etc... for several platforms.

Added control for when() to test browser's callback behavior.

Fl_XXX_System_Driver::clocale_printf() : use thread-specific, locale-setting APIs where possible
    
    This commit uses thread-specific, locale-setting functions under Linux and MSWindows-Visual Studio
    They are already used by the Mac OS system driver, when possible.

SVG support: avoid re-rasterizing an image that was previously rasterized at higher resolution.

Reverting to previous; apparently this was a bug in doxygen 1.7.4's support of header markdown.
    The following is valid, documented, "standard markdown" for headers in doxygen:
    
        This is a level 1 header
        ========================
    
        This is a level 2 header
        ------------------------
    
    Upgrading doxygen from 1.7.4 to 1.8.13 fixed the problem.
    So beware of 1.7.4 wrt to these kinds of header markdown;
    the result in the docs was no header, the header text + underbars
    were appearing inline with the text, crlfs removed.
    
    Not sure exactly what version of doxygen this was fixed in;
    a search in their bugzilla for 'headers' seemed to show no
    directly relevant matches, other than maybe bug #681898.
    https://bugzilla.gnome.org/show_bug.cgi?id=681898

Doxygen fix: The trick of using a line of dashes under a section heading no longer works.
    
    This has been working fine for years, not sure what version of doxygen dropped this.
    I'm running 1.7.4 here, and that trick isn't working for the Fl_Browser_.H docs.
    
    Changed to using <B> and </B> and <BR> which seems to work OK in both HTML and PDF
    generation.

Fixed small doxygen inconsistencies for do_callback value.
    
    Internally Fl_Browser passes the raw value of when() as the
    "do_callbacks" value, so it's important that ALL non-zero values
    mean "do the callback' (and not just 1).

SVG support: draw images at full screen resolution also when there are several pixels per graphical unit, as with Apple retina displays.

Mac OS: use Fl_Graphics_Driver::has_feature(PRINTER) to detect when drawing to a printer.

Mac OS: explain more accurately in comments how the tricky part of printing an Fl_RGB_Image is handled.

Demo image for Fl_Multi_Label docs.

Add reference to image in docs.

Add divider above Quit menu item. (needed for demo screenshot)

Documentation and copyright updates.

Fluid: remove redundant code, fix FL_IMAGE_LABEL labeltype.
    
    Remove leading underscore from _FL_IMAGE_LABEL.
    Remove redundant assignment of image().
    
    Thanks to Greg for finding these issues.

Remove leading underscore from labeltyps as far as possible.
    
    Removed obsolete '\todo' item from docs (done with recent commits).
    
    Removed redundant code from label assignment (e.g. use FL_IMAGE_LABEL
    instead of label type assignment + use of _FL_IMAGE_LABEL).
    
    See recent commits.

Fluid: align internal tables (no code changes).
    
    Note: tab width 8.

Update ignored files: new example howto-menu-with-images.

Doxygen Fl_Multi_Label example code added. (STR #3400)

Remove leading underscore from labeltype(s) in new demo.
    
    Since svn r12443 we can use all labeltypes (including FL_IMAGE_LABEL and
    FL_MULTI_LABEL) w/o leading underscore. We can also use both documented
    variants to assign an FL_MULTI_LABEL to an Fl_Menu_Item.

Add missing Fl_Labeltype and Fl_Boxtype definitions.
    
    Some labeltypes and boxtypes were missing a #define for the enum
    without a leading underscore and the corresponding setup function
    to initialize the internal table of boxtypes and labeltypes, for
    instance _FL_MULTI_LABEL. This is now fixed so (hopefully) all boxtypes
    and labeltypes can and _should_ be used w/o leading underscore.
    
    Note: if there are still boxtypes or labeltypes that can't be used w/o
    leading underscore this should be considered a bug and is to be fixed ASAP.

Simplified the example's menu item callback.

Applied Manolo's recommendation (fltk.coredev), removing unnecessary item->image(*pixmap) call.

Added example code to demonstrate Fl_Multi_Label for STR#3400.

Fix compiler warning and potential error in PNG error handling.
    
    Compilation with gcc -Wall -Wextra displayed the following warning:
    
    Fl_PNG_Image.cxx: In member function ‘void Fl_PNG_Image::load_png_(const char*, const unsigned char*, int)’:
    Fl_PNG_Image.cxx:118:9: warning: variable ‘fp’ might be clobbered by ‘longjmp’ or ‘vfork’ [-Wclobbered]
    
    Making the variable static and initializing it properly avoids this
    potential error in the PNG lib's error handling.

Set svn ps for this new file.

These files are no longer used. They are replaced by nanosvg.h and nanosvg.diff.

Differences between the FLTK-modified and the nanosvg versions of file nanosvg.h

Fix nanosvg implementation of nsvg__atof() to allow compilation with Visual Studio 7.

#include <locale.h> is no longer needed.

Make virtual member function Fl_Image::draw_scaled(int X, int Y, int W, int H) protected rather than private.
    
    Consequently, remove the trailing _ from its name reserved for private class members.

Enhance howto-drag-and-drop example program.
    
    Refer to discussion if fltk.general, thread "Drag and drop issue"
    in August September 2017.

Modify nanosvg.h to support compilation by Visual Studio 7.
    
    This is a new implementation that does not tamper with the program's locale.

Simplify code using plain atof() instead of implementing function nsvg__atof().

Changed AC_CHECK_HEADER -> AC_CHECK_HEADERS, since two files are being tested, e.g.

Small fix to remove an extra paren introduced in r12153

Set svn ps for this new file

Gives differences between FLTK and original versions of file nanosvg.h

Return fl_nanosvg.h close to nanosvg.h, without reformatting.
    
    fl_nanosvg.h had before been reformatted by Xcode.

Set svn ps for this new file

Modify how the nanosvg source code is used to support compilation with Visual Studio 7.
    
    1) The original nanosvg.h file is modified for FLTK in file fl_nanosvg.h. The only change is
    to remove the implementation of function nsvg__atof().
    
    2) FLTK provides an implementation      of nsvg__atof() based on sscanf().
    
    3) FLTK changes the LC_NUMERIC locale to "C" before calling nanosvg
    and resets it to its previous state after.

Added the new OPTION_USE_NANOSVG to the README.CMake.txt file.

Emphasize in the docs that ".." at the end of cmake commands is
    not an elipsis, but is part of the command.

Improve doc of the Fl_SVG_Image public constructor.

Fix typo in documentation of Fl_SVG_Image.

Fix erroneous Doxygen command in doc of Fl_SVG_Image::resize().

Class Fl_SVG_Image: use fl_fopen() to open files with non-ASCII characters in name.
    
    Also, have copy() copy the value of the image's proportional member variable.

Annonce the new Fl_SVG_Image class and related configure/CMake options.

Set svn:keywords

Set eol-style to native.

Add new Fl_SVG_Image class to support scalable vector graphics images using the (modified) nanosvg software.

Add the nanosvg directory to hold source code belonging to the nanosvg software.

Add missing default values for virtual member functions.

Create virtual Fl_Image::draw_scaled_(int X, int Y, int W, int H) and its implementations for image classes.
    
    This allows to use the virtual function mechanism to adapt scaled image drawing both to the
    image type and the graphics driver type.

Modify Fl_Shared_Image::scale(int, int) for the case of an erroneous image object.

Move Fl_Graphics_Driver::draw(Fl_Shared_Image* from Fl_Shared_Image.cxx to Fl_Graphics_Driver.cxx where it belongs.

Improve Doxygen comments related to image drawing

Fix typos (comments and documentation).

Associate gl_font() and gl_draw() calls.

Fix for STR#3397: find adequate X font to use it with GL.

Fl_WinAPI_Window_Driver::capture_titlebar_and_borders(): remove a few unnecessary statements.

WIN32: allow to change the active drawing surface between Fl_Display_Device and Fl_Image_Surface and keep the clipping region correct.

Fl_Scalable_Graphics_Driver::draw(Fl_RGB_Image *,...) : change how the current scaling factor is taken into account.

X11 and WIN32: slightly change Fl_XXX_Graphics_Driver::cache(Fl_Pixmap*) to use the Fl_Image_Surface object.

X11+xft-pango: have Fl::set_fonts() show fonts with black, light, medium, demi bold, oblique styles.

WIN32: have Fl_win32.cxx #include "config_lib.h"

X11 platform: cleaner implementation of changing the active drawing surface and maintaining clip regions.

Simplify using Fl_XXX_Graphics_Driver::copy_offscreen() instead of Fl_Scalable_Graphics_Driver::copy_offscreen_unscaled()

Remove undesirable statement.
    
    A bug was visible in test/unittests when moving between lines and rectangles.

Prevent situation where SetProcessDPIAwareness was called after Fl_WinAPI_Screen_Driver::init().
    
    The effect was that the file_chooser test app did not recognize the window scaling factor.

Remove unnecessary #include files from Fl_Help_View.H

Update dependencies.

Avoid #include's of unrelated system headers in Fl_Table*.H.
    
    Possible side effect: programs that relied upon inclusion of unrelated
    system headers by FL/Fl_Table.H or FL/Fl_Table_Row.H may fail to compile.
    
    Removed include files (some only on certain platforms, list may be incomplete):
    
    #include <FL/Fl.H>             // moved to implementation (.cxx)
    #include <FL/Fl_Box.H>         // moved to implementation (.cxx)
    #include <FL/Fl_Scrollbar.H>   // moved to implementation (.cxx)
    
    #include <sys/types.h>
    #include <string.h>            // memcpy
    #include <malloc.h>            // WINDOWS only: malloc/realloc
    #include <stdlib.h>            // UNIX: malloc/realloc

Documentation: remove unnecessary item from TODO list.

class Fl_GDI_Image_Surface_Driver: remove member variable 'previous' that is useless.

Add missing #include "config_lib.h" in Fl.cxx.

Complete previous commit at r.12385 that was partial.

Update support of rescaling which no longer involves hide/show of the window.

Complete previous commit at r.12383 that was partial.

Fl_XXX_Surface_Driver::set_current() : call Fl_Surface_Device::set_current() first to get fl_window right.

Remove _sgc private member of Fl_GDI_Image_Surface_Driver that is not necessary.

Remove unnecessary #include statements and compilation guards.
    
    Currently src/drivers/OpenGL/Fl_OpenGL_Graphics_Driver.cxx wouldn't
    contribute any code to the lib, but it is kept for future extensions.
    This file is no longer compiled (see src/CMakeLists.txt and src/Makefile).
    
    Tested (only) under Windows and Linux.

Make 'driver' header include guards more standard.

Remove unnecessary #include statement.

Fl_Xlib_Graphics_Driver::set_fonts() with Pango: handle case when 'Regular' is not alone in face name.

Fl_Xlib_Graphics_Driver::set_fonts() with Pango: account better for variety of possible font styles.

Fix error: invalid conversion from ‘const char*’ to ‘char*’ [-fpermissive]

Improve Fl_Xlib_Graphics_Driver::set_fonts() when using Pango to build standard FLTK font names prefixed with I,B, or P.

Add tooltips to new draggable-group example program.
    
    ... as suggested by Greg.

Add draggable-group example program.

Strenghten Fl_WinAPI_System_Driver::paste(): the widget's handle method may change Fl::e_text.
    
    The widget's handle method may change the value of Fl::e_text.
    This occurs for instance if this method calls fl_choice().
    So, memorize the value of Fl::e_text before, to delete the correct array after the call to the handle method.

Fix compiler warning [-Wunused-result].

Fix whitespace and comments.

Improve Fl_Widget_Surface::print_window_part() with better quality when scaling factor > 1.

Improve rescaling when window moved across screens: make sure center stays on new screen.

Fix Fl_Widget_Surface::print_window_part() that was not correct for scaling factor values < 1.

Fix Fl_Screen_Driver::read_image() that was not correct with scaling factor < 1.

Replace static protected bool Fl_Window_Driver::is_a_rescale by a private static variable and a public getter.

Fix Fl_Native_File_Chooser::filter_value()

Rewrite Fl_X11_Window_Driver::resize_after_screen_change() to call Fl_Window_Driver::resize_after_scale_change()

Remove temporary code used for development only.

IsIconic() is the adequate WINAPI function to detect a minimised window.

Simpler initialisation of the 'scale' local variable in WndProc().

Rename Fl_Window_Driver::in_resize_after_scale_change to 'is_a_rescale' which is more expressive.

Fix window iconize/deiconize when multiple screens with distinct scaling factors.

Fix confusing behavior of class Fl_Text_Selection.
    
    Fl_Text_Selection got a new method length() and returns 0 in length()
    and in all offsets (start(), end(), position()) if no text is selected
    (selected() == false).
    
    The behavior in FLTK 1.3 and earlier versions (returning undefined
    values if !selected()) was confusing.

X11 platform, resize window when moved across screens: remove hide()/show() calls.

Fix blocks demo keyboard handling, add new shortcut.
    
    The blocks demo was unintentionally intercepting ctrl/+ which was
    introduced in FLTK 1.4.0 to change scaling for HiDPI screens. Now this
    is separated: use ctrl/+/-/0 to change scaling, use '+' alone to change
    the game level.
    
    The new keyboard shortcut ALT+SHIFT+H allows users to reset their high
    scores without editing the preferences file.

Fix test/blocks "runaway timer" bug.
    
    Bug #1: When entering the next level an _additional_ timeout was started,
    hence multiple timers would run in parallel and increase the game's speed
    more than (supposedly) intended.
    
    Bug #2: When the game was over, these additional timers were not stopped,
    hence level 1 was never again as slow as it should be.
    
    This is fixed in this commit. Additionally the timer values are defined
    as preprocessor macros (constants) for easier fine tuning. To compensate
    for the lower speed in higher levels the LEVEL_FACTOR was reduced from
    0.95 to 0.90 so the higher levels are slightly faster than without this
    fix.
    
    Note: the result of this fix (generally less speed increase per level)
    may result in higher scores.

test/blocks: improve timer test code.
    
    This commit does not change operative code but adds the ability to test
    the timer callback under Windows and improves the timer statistics.
    
    The code has been formatted in some parts, but not "everywhere".

Remove virtual Fl_Window_Driver::reuse_icons() no longer useful after r.12349.

Remove Fl_Window_Driver::reuse_cursor() that is no longer used since commit r12349.

Rewrite Fl_Window_Driver::resize_after_scale_change() removing calls to Fl_Window::hide() and Fl_Window::show().
    
    Windows are now rescaled with a call to Fl_Window::resize() which has been slightly modified.
    Static member variable bool Fl_Window_Driver::in_resize_after_scale_change is created,
    and is true if and only if Fl_Window::resize() is called by Fl_Window_Driver::resize_after_scale_change().
    This new flag allows Fl_Window::resize() to perform correctly the rescaling of the window.
    Fl_Gl_Window::resize() and Fl_Double_Window::resize() also consult the value of
    the Fl_Window_Driver::in_resize_after_scale_change flag.
    The platform-specific Fl_WinAPI_Window_Driver::resize() and Fl_X11_Window_Driver::resize()
    also use  the Fl_Window_Driver::in_resize_after_scale_change flag.

Remove useless statement.

Fix incorrect difference between branches 1.3 and 1.4 in an Fl_Overlay_Window constructor.

Update list of files excluded from documentation.

Improve docs of Fl_Widget::callback() and do_callback().
    
    Clarify that all variants of do_callback() call clear_changed() after
    the callback and that 'long Fl_Widget::argument()' may truncate the
    user_data value on some (particularly Windows 64-bit) platforms.
    
    Some code has been reformatted and refactored with better variable names,
    but there are no effective code changes.
    
    Obsolete, inactive code was removed.

Update Fl_Widget_Tracker docs with better example code.

Make Fl_Widget_Surface::draw(Fl_Widget *wid, int, int) draw also the overlay if 'wid' is an Fl_Overlay_Window.

Remove unnecessary local variable.

Remove Fl_Cocoa_Window_Driver::flush_double() because it is equal to Fl_Window_Driver::flush_double()

Fl_Window_Driver::flush_single() needs not be a virtual member function.
    
    It is really an accessor to protected method Fl_Window::flush().
    Rename it to Fl_Window_Driver::flush_Fl_Window to reflect that.

Remove unwanted difference in one Fl_Double_Window constructor between branches 1.3 and 1.4.

[CMake] Add an option to use High-DPI support (Windows only).
    
    This option can be used with CMake to configure the experimental
    high-DPI support under Windows. The option may be removed once high-DPI
    support under Windows is complete.

Remove documentation of STR #3374 from CHANGES.
    
    We don't need to document STR fixes of bugs that have been introduced
    and fixed in FLTK 1.4.0 svn since this is not a regression since 1.3.x.

Simplify handling of the windowDidMove notification since MacOS 10.10

Added support for MacOS 10.13 "High Sierra".

Add script to update bundled config files, and update files.
    
    The bundled scripts misc/config.guess and misc/config.sub should be
    updated from time to time to get support for new platforms.
    
    The new script 'misc/update_config_scripts' can be used to download
    the latest versions of config.guess and config.sub.

Some compilers probably need string.h for strcmp()..

Added new example program 'nativefilechooser-simple.cxx'
    (Simpler than the application example)

X11 platform: Fix bug in test/overlay where overlay is clipped when using button shortcuts.
    
    In branch 1.3, file src/Fl_Overlay_Window.cxx, function Fl_Overlay_Window::flush(),
    part of line 49 was not reproduced in branch 1.4.
    This fix reproduces in branch 1.4 the equivalent of the code in branch 1.3.

Support of MacOS 10.13 to appear soon: fix handling of window moves in presence of subwindows.

FLDropTarget::DragEnter() replace call to Fl_Screen_Driver::get_mouse(int&, int&) by call to GetCursorPos(POINT*)

Fix for STR#3390 Drop to FLTK widget fails when desktop is scaled - new solution.

Fix Visual Studio shared library build (STR #3389).

Add missing #include in fltk-versions example program.

WIN32 platform: Fix drag-n-drop to FLTK widget when the desktop is scaled and FLTK_HIDPI_SUPPORT is not defined.

Add missing definition of the 'uchar' type in FL/x.H

End of fix for STR#3387 "Bug of timer implementation on macosx"

STR #2823.2/2: Improved Fl_Preferences "dirty" flag handling.

STR #2823.1/2: avoiding setting "dirty" flag in a read operation.

Update dependencies (makedepend).

Introduce Fl_Group::bounds(), deprecate Fl_Group::sizes().
    
    The new method Fl_Group::bounds() replaces Fl_Group::sizes() whose
    internal array structure was not documented.
    
    Fl_Group::bounds() uses the new and documented class Fl_Rect for its
    internal structure.
    
    src/Fl_Tile.cxx now uses bounds() instead of sizes().

Fix some typos.

More logical data path name

STR #2034: Fl_Preferences::getUserdataPath()  is much more careful when creating a pathname based on the preferences filename. Among other things, remove a possible buffer overflow.

Define Fl_WinAPI_Screen_Driver::DWM_scaling_factor() only without FLTK_HIDPI_SUPPORT.

WIN32 HiDPI support: fix copy and paste of image data when rescaling is applied.

Fix Fl_WinAPI_Window_Driver::border_width_title_bar_height() when built without FLTK_HIDPI_SUPPORT

WIN32 HiDPI support: fix scaling support for Fl_Copy_Surface.

Fix Fl_GDI_Graphics_Driver::point_unscaled() so points are also enlarged when scaling increases.

Fix drag-n-drop for WIN32 platform when rescaling is active.

Update several README files, remove obsolete information.
    
    To be continued ...

Added CMake build instructions for MacOS and Xcode

Fix compiler warning [-Wunused-variable].

Remove obsolete comment, fix code formatting.

HiDPI support under WIN32: fix fullscreen when several monitors of distinct resolution.

Slight improvement of Fl_WinAPI_Window_Driver::border_width_title_bar_height()

Fix Fl_WinAPI_Gl_Window_Driver::pixels_per_unit() when on secondary monitor.

HiDPI support under WIN32 platform: completed.

WIN32: fix error when building without FLTK_HIDPI_SUPPORT.

CMake: fix potential compiler warning in test file.
    
    clang reports: control reaches end of non-void function [-Wreturn-type]

Update copyright year(s).

CMake: replace improperly used variables with correct ones.
    
    CMake variables FLTK_SOURCE_DIR and FLTK_BINARY_DIR are only defined
    if the project name is exactly "FLTK" (all uppercase). These variables
    are generated (set) by CMake as <PROJECT_NAME>_SOURCE_DIR etc.
    
    The correct variables are CMAKE_SOURCE_DIR and CMAKE_BINARY_DIR,
    respectively, which are always defined.
    
    This commit enables future changes of the FLTK project name, e.g. to
    "fltk" or "fltk-1.4.0" (a versioned project name), if we like...

HiDPI support for WIN32 platform: begin to support screen-specific scale factor.

Remove unnecessary Fl_Widget_Tracker from Fl_Dial's handle().
    
    handle_push() doesn't call a callback, hence Fl_Widget_Tracker is not
    necessary.
    
    Added FALLTHROUGH and NOTREACHED comments.

Fix code formatting and typos.
    
    Added some braces around the bodies of one-statement for loops for clarity.

Better implementation of Fl_WinAPI_Window_Driver::reuse_cursor() that will also work with custom cursors.

HiDPI support: keep window's icons after rescaling

HiDPI support: keep window's cursor after rescaling.

Fix fluid's widget_panel coordinates and widget order.
    
    Added comments to hidden widgets and (also hidden) resizable box.

WIN32 platform: more progress for full HiDPI support

Exact computation of scaled clipping region for X11 platform.
    
    Each rectangular component of the clipping region is transformed exactly as by Fl_Xlib_Graphics_Driver::rectf_unscaled()

Fix for STR#3387 Bug of timer implementation on macosx

Code formatting only. No significant changes.
    
    In preparation of adding Fl_Scroll_Tabs.

Move line_width_ protected member variable from Fl_Xlib_Graphics_Driver to Fl_Scalable_Graphics_Driver

HiDPI support under WIN32: fix bugs with tile demo and with fullscreen demo.

HiDPI support under WIN32: fix fullscreen mode when scaling factor is > 1.

HiDPI support under WIN32 platform: fix Fl_WinAPI_Window_Driver::capture_titlebar_and_borders() under XP.

Advancing HiDPI support for the WIN32 platform - still incomplete.
    
    It's still necessary to compile with -DFLTK_HIDPI_SUPPORT
    to activate the new HiDPI support.
    Default builds get the same HiDPI support as in FLTK 1.3

Make Fl_Screen_Driver::get_mouse(int&, int&) return the number of the mouse-containing screen.

Allow calling Fl_Window::decorated_w() with const Fl_Window object and also for decorated_h (cont'd)

Allow calling Fl_Window::decorated_w() with const Fl_Window object and also for decorated_h.

Limit initial scaling factor to sensible values.
    
    FLTK_SCALING_FACTOR=0 or negative values would issue unexpected
    X11 warnings or crash immediately.
    
    Also commented out scaling factor output statements (printf).

Remove copy constructor from Fl_Rect.
    
    As suggested by Manolo in STR #3385, comment #7.

Add first version of FL/Fl_Rect.H.
    
    This version is not yet used in existing code. It may be extended with
    more methods if we find we need them.

Scaling for WIN32 platform: avoid undrawn right and bottom window margins when manually resizing windows

Remove temporary code used for development of the scaling support.

Remove warning when compiled with -Wmisleading-indentation

Scaling for X11 platform: avoid undrawn right and bottom window margins when manually resizing windows

X11 platform: Accurate box graphics at wide range of scaling factor values.

MacOS system menus: replace 'rank' by 'index' to denote a number identifying a menu item.

Fix Fl_Browser background and text color parsing (STR #3376).

Fix problem introduced at r.12247

Fix typo.

Document new HiDPI support under the X11 platform.

Make sure the scaling factor has been initialised when setting a font.

Remove the 'defined(WIN32)' and 'defined(__APPLE__)' preprocessor directives introduced at r.12239

Additional check in Fl_Xlib_Graphics_Driver::font_unscaled(Fl_Font, Fl_Fontsize) to recognize if current font is unchanged.

Divide virtual Fl_Screen_Driver::open_display() in a platform-specific part followed by a platform-independent part.

X11 + Pango platform: improve text drawing with angle.
    
    Make sure that text length computed without angle is equal to text length drawn with angle.
    This property is essential so that rotated text appears at controlled location at both ends.

Make some methods of Fl_Tabs protected and/or virtual (STR #3211).
    
    Patch proposed by Teklad (STR #3211, file #7):
      http://www.fltk.org/strfiles/3211/Fl_Tabs.H.patch
    with minor modifications and adjustments for FLTK 1.4.0.
    
    Method which() is now also virtual, as suggested by guyben in comment #24.

Fix warnings: 'Fl_Xlib_Graphics_Driver::scale' hides overloaded virtual function [-Woverloaded-virtual]

Fix Visual Studio build with HiDPI support.

Add void fl_scale_offscreen(Fl_Offscreen &ctx) to support the rescaling of an offscreen buffer.

Introduce HiDPI + rescaling support for the X11 platform (+ partial support for WIN32)
    
    Corresponds to STR #3320
    1) HiDPI support consists in detecting the adequate scaling factor for the screen on which
    FLTK maps a window, and scaling all FLTK units by this factor. FLTK tries to detect the correct
    value of this factor at startup (see more details below). Environment variable
    FLTK_SCALING_FACTOR can also be used to set this value.
    2) Rescaling support consists in changing the scaling factor of all FLTK windows
    in reply to ctrl/+/-/0/ keystrokes.
    
    More details for the various platforms :
    
    - X11: Support is very advanced. Some details need still to be improved.
    Automatic detection of the correct starting value of the scaling factor works well
    with the gnome desktop. The present code contains no support for this on
    other desktops.  FLTK_SCALING_FACTOR provides a workaround.
    
    -WIN32: Support is incomplete at this point, although many test
    applications have partial or complete HiDPI and scaling support.
    The current value of the system's scaling factor is correctly detected
    at application startup. Apps respond to changes of this value in real time.
    Support needs to define the FLTK_HIDPI_SUPPORT preprocessor variable
    at compile time. This way, standard builds produce a code with the
    default WIN32 HiDPI support, that is, where all graphics goes to an internal
    buffer that gets enlarged by the system and then mapped to the HiDPI
    display. To experiment with (or develop) the new HiDPI support requires
    a modified build procedure in which  FLTK_HIDPI_SUPPORT is defined
    at compile time. When the support will be complete, the requirement for the
    definition of this preprocessor variable will be removed. The present commit
    contains support for a single scaling factor. Eventually, per-screen scaling
    factors should be implemented, as done for X11.
    
    - MacOS: this commit does not give new HiDPI for this platform.
    Eventually, window rescaling in reply to command/+/-/0/ is desirable.
    Per-screen scaling factor makes no sense on this platform because
    the OS itself takes care of the difference between the resolutions of
    traditional and retina displays.

Fix typo.

Allow to disable shadows in Fl_Clock and derived widgets.
    
    As discussed on 2017-05-15 in fltk.general, thread "Fl_clock".

Improve and clarify Fl_Clock documentation.

Added some example code to Fl_Gl_Window::draw() docs..

De-duplicate code to load pointer to the TransparentBlt() system function at run-time.

Fix erroneously cased include file names

Added Fl_Table docs for how to deselect.
    Issue raised by Mich Paw today on fltk.general.

Add Doxygen documentation for fl_create_bitmask() and fl_delete_bitmask().

Document Fl_Table's protected member variables.

Small doc clarifications for the Fl_Table::TableContext enum.

Fl_Table was missing doxygen docs for several public + protected members.
    Solves STR# 3381.
    
    Also: standardized doxygen comment style in both files;
          > /** */ doxygen commenting
          > 2 space indent
    
    Removed some confusing non-doxygen comments, and rewrote some confusing ones.
    
    Removed old license info Matt had imported from my original 2002 widget..
    there was no reason for it to be in there; the Fl_Table code inside FLTK
    is licensed under the FLTK GPL license, no need for the extra noise in the docs.

Remove Fl_Translated_GDI_Graphics_Driver and have its functions performed by Fl_GDI_Graphics_Driver.

Add an argument to the private, virtual member function void Fl_Surface_Device::end_current_().
    
    The X11 platform uses this argument to restore the correct clipping state after
    drawing to an Fl_Image_Surface object.

Remove unused variable from class Fl_Xlib_Image_Surface_Driver.

Slight improvement of Fl_Image_Surface::image()

Undo change at r.12221 because it's done at r.12222 in a cross-platform fashion.

Allow the use of  Fl_Image_Surface::image() also when the Fl_Image_Surface object is not the current drawing surface.
    
    This fixes an issue uncovered in a thread of fltk.general entitled
    fl_pop_clip: clip stack underflow! warning on X11

Fix Fl_Image_Surface::image() as discussed in fltk.general
    
    See thread "fl_pop_clip: clip stack underflow! warning on X11"
    started on Thu, 20 Apr 2017.

Fl_Help_View: fix table header in help_dialog.html (STR #3227).
    
    The html code in the example (test/help_dialog.html) was broken.
    Fixing the example html code was enough, no code changes needed.

Mention fix for STR#3374

Fix for STR#3374: Crash with pango enabled when changing default font

Fix Windows CreateDC/DeleteDC mismatch (STR #3373).

Document the new OPTION_USE_PANGO platform-specific option.

Fixed typo in warning message.

Fix doxygen/latex warning.

Suggestion for cmake docs for building FLTK with Visual Studio (e.g. VS7 shown)

Fix dependencies.

Account for translation also in non-Pango code section.

Create Fl_Xlib_Graphics_Driver::scale_and_render_pixmap() to draw depth-4 or scaled RGB images using Xrender.

[CMake] Fix Visual Studio header detection.
    
    This commit fixes a CMake issue if CMake is invoked from a desktop icon
    or the Windows menu, i.e. not within the correct environment to find all
    required header files.
    
    We recommend to run CMake from a "Developer Command Prompt for Visual Studio X",
    but sometimes users click on their desktop icon and run CMake without the
    correct context. In this case some header files in the Windows SDK's are not
    found by CMake.
    
    The solution is to issue a warning and "fix" the header detection by faking
    that the headers were found, because they are always available in Visual
    Studio. The affected headers <locale.h> and <GL/glu.h> were set to "found"
    in the bundles IDE's in FLTK 1.3 as well, so there should be no issue with
    this fix.
    
    It is also recommended by the CMake folks, i.e. they suggest not to search
    for these special header files that are known to exist always.

Revert temporary fix (attempt) introduced in svn r11644.
    
    The fix in src/Fl_Input.cxx in svn r11644 was an attempt to fix the
    Visual Studio (Windows) build because CMake would sometimes not find
    the correct header files, but this attempt opened a path where the
    variable 'legal_fp_chars' was not initialized.
    
    The (hopefully) correct fix will follow in my next commit...

Fix Linux build after removal of Fl_Translated_Xlib_Graphics_Driver.cxx

The new Fl_Xlib_Graphics_Driver::draw_scaled() member function must also account for possible translation.

Remove class Fl_Translated_Xlib_Graphics_Driver and move its processing to Fl_Xlib_Graphics_Driver.

OpenGL documentation fixes (included header files).
    
    Also reformatted very long lines, removed trailing spaces.

[CMake] Remove unused header test HAVE_GL_GL_H (GL/gl.h).
    
    Note: the test for OpenGL works slightly different with CMake vs. configure.
    
    The CMake (cache) variable HAVE_GL_GL_H was never used.

Flush output of examples/fltk-versions for Windows (MinGW).
    
    MinGW wouldn't flush the output before closing the window.

Fix the projective transformation matrix used for Xrender-based scaled image drawing.

Add scaled image drawing to the X11 platform using Xrender.

Make image-related member functions of class Fl_Graphics_Driver protected, as in FLTK 1.3.x
    
    This helps ensure they are not part of the public API.

Give platform-independent default implementation to Fl_System_Driver::gettime()

Fix more svn properties.

Set missing svn properties.

Fix include file case (patch from Haiku port, thanks).
    
    Ref.: https://github.com/mmuman/fltk-test-only.git,
    commit 59c3cfbdf0412fb30f8312ed9ddd96f5affd2f0a by François Revol.

Remove superfluous semicolon.

Fix svn attributes of *.c, *.cxx, *.cmake and others.
    
    - set svn:keywords Id
    - set svn:eol-style native

Separated Fl_Input_Choice.H and Fl_Input_Choice.cxx (STR #2750).
    
    As proposed in STR #2750 and #2752: only status quo, i.e.:
    
      - no new method Fl_Input_Choice::maximum_size(int) (STR #2750 and #2752)
      - no handling of FL_Down key to open menu (STR #2752)

Enable Up/Down keys in Fl_Spinner if input has focus (STR #2989).
    
    Previously Up/Down keys worked only if one of the buttons was pressed
    before so that it had the focus.
    
    test/valuators.fl: The second Fl_Spinner widget (FL_FLOAT_INPUT) now has
    wrap mode disabled whereas the first one (FL_INT_INPUT) uses wrap mode
    (default, compatible with FLTK 1.3.x and older).

New method Fl_Spinner::wrap(int) to set wrap mode at bounds (STR #3365).

Separated Fl_Spinner.H and Fl_Spinner.cxx (STR #2776).
    
    Also removed deprecated (misspelled) method names mininum() and maxinum().

Have all Fl_Clock objects in a single FLTK app tick approximately at the same time.
    
    Before this change, clocks can tick at any point within a second, so 2 clocks
    can appear to disagree on the time they give (by less than a second).
    To see that, run the clock test program, icons one of the clocks,
    and uniconize it just before the other clock will tick.

Add to Fl_System_Driver support for measuring time with split second resolution.

Fix tab alignment.

Fl_Tabs: improve tab label drawing (STR #3075, STR #3076).
    
    New method Fl_Tabs::tab_align() supports icons in tabs (STR #3076).
    This commit also enables drawing labels of Fl_Window children (STR #3075).
    
    Setting tab_align(FL_IMAGE_NEXT_TO_TEXT) draws images (icons) in the tab
    labels if the child has an image(). Currently this draws the image() even
    if the child is deactived (so it should presumably draw the deimage()).
    
    Todo: Label measurement and Fl_Windows as children still need fixups.

Simplify Fl_Tabs label drawing code (remove code duplication).

Fix tab group positions.

Label alignment documentation clarifications.

Improve label alignment docs and border case implementations.
    
    Make clear that some alignment bit combinations are "illegal" and yield
    undefined behavior that can be changed without notice.
    
    Fix label alignment in some border cases where illegal bit combinations like
    FL_ALIGN_LEFT and FL_ALIGN_RIGHT or FL_ALIGN_TOP and FL_ALIGN_BOTTOM are
    both set, respectively.
    
    Todo: There appears to be inconsistent handling WRT these "illegal" cases,
    for instance with inside labels as opposed to outside labels, such that
    the behavior seems to be unpredictable. See test/label.cxx.

Fix typo (case) in include file name.

Avoid potential crash occurring after calling win->show(0,0)
    
    See [fltk.general] Drawing to Fl_Offscreen received signal SIGSEGV, Segmentation fault.
    that is unrelated to Fl_Offscreen but caused by calling win->show(0,0).

Mac OS: remove unused members variables from platform-specific struct Fl_Window_Driver::shape_data_type

Pre-multiply alpha on cursors on X11, as required by XRender.

Fix line wrap at word end when string widths are true double values (non integer).
    Useful for rescaling that creates non-integer string widths.

Reset offscreen surface when the window is hidden.
    This is necessary for compatibility with rescaling, so line widths are also rescaled.

Fix typo

Fluid: Fix platform-specific build system (CMake + configure).
    
    Don't compile "empty" file (avoid warning: empty translation unit).
    Add '-u' (update) command switch to 'make rebuild'.

Add radio buttons to unittests_schemes in 4th tab.

Rename test/help demo program to test/help_dialog.
    
    This change avoids a name conflict with CMake's auto-generated target 'help'
    for "Unix Makefiles", "Ninja", and supposedly other generators as well.

Fix line number alignment in Fl_Text_Display/Editor (STR #3363).

Incorporate the code of function handleUpdateEvent() in the unique code section which calls it.

Fl_Text_Display documentation updates.

Allow ESC to close window and don't transmit CTRL character to fl_draw()

MacOS: reduce the memory size of class gl_texture_fifo managing GL textures to draw strings under GL.

Allow resizable Fl_Gl_Window drawn using the Fl_OpenGL_Graphics_Driver

Remove USE_OksiD_style_GL_font_selection preprocessor variable because it is equivalent to !USE_XFT

Fl_OpenGL_Graphics_Driver : use gl_font()/gl_draw() to draw text in a GL window - continued.

Fl_OpenGL_Graphics_Driver : use gl_font()/gl_draw() to draw text in a GL window.

Match glPushAttrib() with glPopAttrib()

Remove useless #include directives

Correct spelling error: Armeninian --> Armenian

Add "lorem ipsum" text file in different languages and scripts.
    
    This file can be used to test pango integration and potentially later
    also right-to-left text editing which is currently not supported.
    
    The image misc/lorem_ipsum.txt shows lorem_ipsum.txt in test/editor
    built with pango under Linux (Ubuntu 14.04 LTS).

Add implementation explanatory comments about how the screen driver supports public function fl_read_image().

Documentation: drawing a scaled shared image no longer involves resizing the source image under MSWindows.

Fix CMake config.h and compiler warnings.
    
    Fixed warnings: -Wsign-compare, -Wunused-but-set-variable.

Fix inverted configure logic for option --enable-print.

X11 platform: Add optional use of the pango library to draw text, gaining the possibility to draw text in any script supported by Unicode.

Fix Fl_Xlib_Graphics_Driver::delete_bitmask() : the pixmap argument is to be deleted by XFreePixmap().

Fix for Brain Davis' bug report in fltk.general on 12/20/16.
    Subject: Fl_Glut_Window::Fl_Glut_Window(int w, int h, const char *title = 0)... err huh well no, but it should be

When targetting MacOS+X11, fltk-config should not bundle the executable.

Handle non-ASCII characters when selecting a word or moving the cursor by one word.

Improve Fl_Graphics_Driver::copy_offscreen() so it accepts an Fl_Offscreen argument even if not created by fl_create_offscreen().
    
    With this, fl_copy_offscreen() can be used with any drawing surface (e.g., PostScript) and any Fl_Offscreen
    argument (e.g., returned by Fl_image_Surface::offscreen()).

Implement a platform-independent version of Fl_Graphics_Driver::copy_offscreen() usable when drawing to PostScript.

It is better to reset the line width after having finished to draw with a modified width.

Fix compiler warning [-Wsign-compare].
    
    warning: comparison between signed and unsigned integer expressions

The virtual function Fl_Graphics_Driver::copy_offscreen() cannot be implemented in a platform-independent way.

Mention Fl_Surface_Device::push_current(new_surface) and Fl_Surface_Device::pop_current().

Doxygen: more detailed descriptions of Fl_Image_Surface::offscreen() and Fl_Image_Surface::get_offscreen_before_delete().

Simpler code path for a member function calling another member function of same class.

Add static void Fl_Surface_Device::push_current(Fl_Surface_Device *new_current) and pop_current() to set/unset the current drawing surface.

Fixed OS X SDL double buffering issue and mouse dragging.

[CMake] Rewrite pthreads checks for compatibility with configure.
    
    Main point: pthreads must not be checked under Windows (e.g. MinGW)
    since Windows always uses native Windows threads (unless Cygwin is used).

Fix building without threads (pthreads).
    
    Note: 'configure --disable-threads' or 'cmake -DOPTION_USE_THREADS=OFF'.

For consistency, make the pre-processor check for the inclusion of "dlfcn.h" be
     the same as the check which is subsequently used before calling dlsym() and dlopen().
    
    Note that this may also work around an occasional issue observed when building
    for Windows with cmake and mingw-64, which was sometimes erroneously attempting
    to #include "dlfcn.h" - which is not generally appropriate on a Windows host.

Fl_Text_Display documentation clarifications.

Fl_Text_Buffer constructor: fix "requestedSize ignored in mGapEnd".
    
    mGapEnd should reflect the total allocated size after the constructor
    is executed, i.e. the text buffer is empty. This was not the case.
    
    See thread "Fl_Text_Buffer constructor bug" (2016-12-05) in fltk.general.
    The bug was harmless, but the pre-allocation did not work as expected, i.e.
    the pre-allocated buffer size was allocated but effectively ignored later.

Mention new --enable-print configure option.

Undo change at r.12129 that is OK but not really useful.

Add --enable-print option to configure to allow building without print support on X11 platforms.
    
    Also, the NO_PRINT_SUPPORT preprocessor variable is renamed FL_NO_PRINT_SUPPORT.

Rename Fl_Surface_Device::_surface private member variable to surface_ following the CMP.

CMake building with OPTION_PRINT_SUPPORT off: Fl_Posix_Printer_Driver.cxx should be excluded from compilation.

MacOS platform: restore CMake building with OPTION_APPLE_X11 on.

Add missing configure options to configh.in.
    
    Make config.h generated by configure and CMake better comparable.
    
    Note: these options were defined in configh.cmake.in and implemented
    only in CMake. Implementation in configure is still missing though.

Test program "device": add several calls to image destructors to exercise them.

Remove Fl_Image_Surface::end_current() to be called after usage of the drawing surface.
    
    This ensures API compatibility with FLTK 1.3 where Fl_Surface_Device->set_current()
    is used to change the current drawing surface.

X11 platform: fix STR#3353 and correct drawing of depth-2 RGB images when XRender extension is present.
    
    Fl_RGB_Image's of depth-2, that is, monocolor and transparent, were not drawn using the XRender extension,
    when present, as are depth-4 images. With this change they are.
    A by-product of this change is that it fixes an erroneous drawing (STR#3353) that occurred when
    the image expands outside the window.

Fix build with configure --enable-cairo --enable-cairoext.
    
    Add missing #include <config.h>, see this report in fltk.general:
    
      https://groups.google.com/forum/#!topic/fltkgeneral/x80qQ6wt0s4

Remove change at r.12120 because STR#3353 note #6 shows it is not OK.

Finally remove FLTK_ABI_VERSION preprocessor macro from code.
    
    FLTK_ABI_VERSION has been renamed to FL_ABI_VERSION in FLTK 1.4.0.

Fix for STR#3353: bad depth-2 image drawing when the window is resized smaller than the image.
    
    The problem is specific to the X11 platform. The cause is that depth-2 images were not considered
    in a previous change (r.10628) that introduced transparent image drawing with alpha blending.
    Depth-2 images can be processed just as depth-4 images with alpha-blending.

X11 platform: Fl_RGB_Image::mask_ is always 0, so remove code to process mask_ in Fl_Xlib_Graphics_Driver.

Remove commented out code for what used to be : static int start_rgb()

Fix crash when resizing double-buffered window smaller than transparent image (STR#3353).

WIN32 platform: Fix drawing of depth-4 scaled image when can_do_alpha_blending() is false.

Remove file fl_line_style.cxx

Replace global fl_line_width_  used only by X11 platform by Fl_Xlib_Graphics_Driver::line_width_

Fix shared library build.
    
    Missing FL_EXPORT statements (attributes) affected only the configure/make
    build because some compiler and linker options (visibility etc) are not
    yet implemented in the CMake build.

Remove obsolete comments from src/Makefile.

Remove compilation warning apparent with -Wnull-conversion

Avoid "empty translation unit" compiler warning.
    
    gcc "warning: ISO C forbids an empty translation unit [-Wpedantic]"

Rename misspelled files.

Reformat CHANGES and update dependencies (make depend).
    
    Saved a few columns in CHANGES so more text fits in 80 columns.

Fix ignored files, add 'build' directory to ignored files.
    
    The 'build' directory must never be used in the FLTK source.
    It is reserved as the recommended build directory for CMake.

Please ignore the last commit message (svn r12101).
    
    This is branch-1.4, and that commit was not intended to be in branch-1.4.
    
    branch-1.4 is the current active development branch for FLTK 1.4.

Final commit to branch-1.3-porting *after* the release of FLTK 1.3.4.
    
    The new development branch is now branch-1.4.
    
    See important notes below.
    
    ------------------------------------------------------------------------
    
    Note to svn (subversion) users: This branch (branch-1.3-porting)
    is finished since the release of FLTK 1.3.4.
    
    The new development branch is now branch-1.4 -- please checkout a new,
    clean svn working copy if you want to get branch-1.4 (previously
    branch-1.3-porting).
    
    ------------------------------------------------------------------------
    
    Note to Git users: if you used the Git branch 'branch-1.3-porting'
    to get the FLTK 1.4 development branch, then you need to switch to
    branch-1.4 now, which is the official current development branch.
    
    Please checkout branch-1.4 (after git fetch or git pull), and you're
    done.
    
    ------------------------------------------------------------------------

Start branch-1.4 after rename from branch-1.3-porting.
    
    Added FLTK 1.3 CHANGES file as CHANGES_1.3, updated CHANGES to start
    release info (changelog) for FLTK 1.4.
    
    You can update the svn configuration of your working to get this
    branch if you previously used branch-1.3-porting:
    
     $ svn switch http://seriss.com/public/fltk/fltk/branches/branch-1.4
    
    If you used branch-1.3 previously we recommend to checkout the new
    branch-1.4 in a new working copy.

Create branch-1.4 from branch-1.3-porting.

Fl_Quartz_Graphics_Driver::uncache() should also reset mask_.

Fix possible crash when turning fullscreen the scroll test program.

Use Fl_Graphics_Driver::default_driver() when convenient.

Reuse the same "data provider release callback" several times.

MacOS:  use less temporary copies of image data for image printing.

MacOS: fix possible issue with fullscreen windows containing hidden subwindows
    
    An error occurred with the tabs test program
    - activate the last tab (containing 3 subwindows)
    - activate another tab (the subwindows get hidden)
    - set window fullscreen ===> the subwindows are visible and they should not
    - reactivate the last tab ===> the subwindows are not where they should be

MacOS: another way to make sure windowDidResize does not access Fl_Window after [FLWindow close] message was sent

Fix test/native-filechooser help display artefact (STR #3349).

Slightly improve the parameter list of member function int Fl_Graphics_Driver::start_image(...)

Rename Fl_Bitmap::start() to Fl_Bitmap::prepare().

Factorize repeated code across platform-specific graphics drivers and image types

Replace declarations such as "friend class Fl_Xlib_Graphics_Driver;" by platform-independent declarations.

Close small memory leak in Fl_File_Chooser: a bad image file creates an Fl_Shared_Image but never releases it.

Accept empty Fl_Pixmap in Fl_RGB_Image c'tor (STR #3348).

Minor CMake documentation clarification.

MacOS: fix crash when closing a fullscreen window - continued

MacOS: fix crash when closing a fullscreen window

Documentation updates (IDE and CMake support).

Replace erroneous bitwise & by logical &&

Complete introduction of virtual Fl_RGB_Image *Fl_Image::as_rgb_image() begun at r.12061

Add virtual Fl_RGB_Image* Fl_Image::as_rgb_image() to detect whether an Fl_Image is derived from Fl_RGB_Image

Fix string truncation in fluid (STR #2722 continued).
    
    This commit fixes the truncated string drawing that was partly fixed
    in svn r 9112 (FLTK 1.3.1, 2011-10-01).
    
    Combined port of svn r 12057 and 12059. The latter adds sanity checks
    and fixes potential buffer overflows.

MacOS: fix a small problem where command Quit of the application menu may not work if Fl_Native_File_Chooser is used before any window is shown.

WIN platform: implement Fl_GDI_Graphics_Driver::draw_scaled(Fl_Image *img,int,int,int,int) when img is a Fl_RGB_Image
    
    Implementation uses StretchBlt() when img->d() is  1 or 3 and AlphaBlend() when it is 2 or 4.
    This should turn useful to draw images on HighDPI displays using the display's true resolution.

Reorganize and simplify function Fl_Graphics_Driver::draw(Fl_Shared_Image *, int, int)

Remove erroneous uses of sizeof(filename) where filename is a char* and not a char array

Add one more argument to virtual Fl_System_Driver::file_browser_load_filesystem() giving length of the filename argument

Make sure "/" is always in the list of file systems reported by Fl_File_Chooser (Unix/Linux platform)

Bring over combined fix [r12044] from 1.3 current to the porting branch.
    
    Applied patch from STR #3335 to fix simple GUI issues.

Bring over combined fix [r12041/12042] from 1.3 current to the porting branch.
    
    Added line numbers to Edit -> Show Source Code viewer (source + header tabs)
    Fixes Aditya Siram's observation today on fltk.coredev.