From 3f1f8715853cd855aa66062f50843b21071f288a Mon Sep 17 00:00:00 2001 From: Albrecht Schlosser Date: Wed, 8 Jan 2020 18:41:50 +0100 Subject: Drop 1.0 compatibility; document 1.4 migration The FLTK 1.0 compatibility support by defining macro 'FLTK_1_0_COMPAT' did no longer work since FLTK 1.3.x and nobody complained. Hence we can safely remove this "feature". Documentation changes: - Drop chapter 'Migrating Code from FLTK 1.0 to 1.1' - Drop chapter 'Migrating Code from FLTK 1.1 to 1.3' - Add chapter 'Migrating Code from FLTK 1.3 to 1.4' The removed chapters are still available in FLTK 1.3 docs. --- documentation/src/migration_1_1.dox | 176 ------------------------------------ 1 file changed, 176 deletions(-) delete mode 100644 documentation/src/migration_1_1.dox (limited to 'documentation/src/migration_1_1.dox') diff --git a/documentation/src/migration_1_1.dox b/documentation/src/migration_1_1.dox deleted file mode 100644 index ef5a5d8c8..000000000 --- a/documentation/src/migration_1_1.dox +++ /dev/null @@ -1,176 +0,0 @@ -/** - - \page migration_1_1 Migrating Code from FLTK 1.0 to 1.1 - - -This appendix describes the differences between the FLTK -1.0.x and FLTK 1.1.x functions and classes. - -\section migration_1_1_color Color Values - -Color values are now stored in a 32-bit unsigned integer -instead of the unsigned character in 1.0.x. This allows for the -specification of 24-bit RGB values or 8-bit FLTK color indices. - -\c FL_BLACK and \c FL_WHITE now remain black and white, even if -the base color of the gray ramp is changed using Fl::background(). -\c FL_DARK3 and \c FL_LIGHT3 can be used instead to -draw a very dark or a very bright background hue. - -Widgets use the new color symbols \c FL_FOREGROUND_COLOR, -\c FL_BACKGROUND_COLOR, \c FL_BACKGROUND2_COLOR, -\c FL_INACTIVE_COLOR, and \c FL_SELECTION_COLOR. -More details can be found in the chapter \ref enumerations. - -\section migration_1_1_cutnpaste Cut and Paste Support - -The FLTK clipboard is now broken into two parts - a local -selection value and a cut-and-paste value. This allows FLTK to -support things like highlighting and replacing text that was -previously cut or copied, which makes FLTK applications behave -like traditional GUI applications. - -\section migration_1_1_file_chooser File Chooser - -The file chooser in FLTK 1.1.x is significantly different -than the one supplied with FLTK 1.0.x. Any code that directly -references the old \c FCB class or members will need -to be ported to the new Fl_File_Chooser class. - -\section migration_1_1_functions Function Names - -Some function names have changed from FLTK 1.0.x to 1.1.x in -order to avoid name space collisions. You can still use the old -function names by defining the \c FLTK_1_0_COMPAT symbol on -the command-line when you compile (\c -DFLTK_1_0_COMPAT) or in -your source, e.g.: - -\code -#define FLTK_1_0_COMPAT -#include -#include -#include -\endcode - -The following table shows the old and new function names: - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Old 1.0.x NameNew 1.1.x Name
contrast()fl_contrast()
down()fl_down()
filename_absolute()fl_filename_absolute()
filename_expand()fl_filename_expand()
filename_ext()fl_filename_ext()
filename_isdir()fl_filename_isdir()
filename_list()fl_filename_list()
filename_match()fl_filename_match()
filename_name()fl_filename_name()
filename_relative()fl_filename_relative()
filename_setext()fl_filename_setext()
frame()fl_frame()
inactive()fl_inactive()
numericsort()fl_numericsort()
-
- -\section migration_1_1_images Image Support - -Image support in FLTK has been significantly revamped in 1.1.x. -The Fl_Image class is now a proper base class, with the core -image drawing functionality in the Fl_Bitmap, Fl_Pixmap, and -Fl_RGB_Image classes. - -BMP, GIF, JPEG, PNG, XBM, and XPM image files can now be -loaded using the appropriate image classes, and the -Fl_Shared_Image class can be used to cache images in memory. - -Image labels are no longer provided as an add-on label type. -If you use the old \c label() methods on an image, the -widget's \c image() method is called to set the image -as the label. - -Image labels in menu items must still use the old labeltype -mechanism to preserve source compatibility. - -\section migration_1_1_keyboard Keyboard Navigation - -FLTK 1.1.x now supports keyboard navigation and control with -all widgets. To restore the old FLTK 1.0.x behavior so that only -text widgets get keyboard focus, call the Fl::visible_focus() -method to disable it: - -\code -Fl::visible_focus(0); -\endcode - - -\htmlonly -
- - - - - - -
- - [Prev] - Operating System Issues - - - [Index] - - - Migrating Code from FLTK 1.1 to 1.3 - [Next] - -
-\endhtmlonly - -*/ -- cgit v1.2.3