summaryrefslogtreecommitdiff
path: root/documentation/src/migration_1_1.dox
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2020-01-08 18:41:50 +0100
committerAlbrecht Schlosser <albrechts.fltk@online.de>2020-01-08 18:41:50 +0100
commit3f1f8715853cd855aa66062f50843b21071f288a (patch)
treee8e4fa57ae7fdceb4b0704cde07590a42f1c69fb /documentation/src/migration_1_1.dox
parent4197c2616d24b74dd1f48fd18a2145a64a689b35 (diff)
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.
Diffstat (limited to 'documentation/src/migration_1_1.dox')
-rw-r--r--documentation/src/migration_1_1.dox176
1 files changed, 0 insertions, 176 deletions
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 <FL/Fl.H>
-#include <FL/Enumerations.H>
-#include <FL/filename.H>
-\endcode
-
-The following table shows the old and new function names:
-
-<CENTER>
-<TABLE WIDTH="80%" BORDER="1">
-<TR>
- <TH>Old 1.0.x Name</TH>
- <TH>New 1.1.x Name</TH>
-</TR>
-<TR>
- <TD>contrast()</TD>
- <TD>fl_contrast()</TD>
-</TR>
-<TR>
- <TD>down()</TD>
- <TD>fl_down()</TD>
-</TR>
-<TR>
- <TD>filename_absolute()</TD>
- <TD>fl_filename_absolute()</TD>
-</TR>
-<TR>
- <TD>filename_expand()</TD>
- <TD>fl_filename_expand()</TD>
-</TR>
-<TR>
- <TD>filename_ext()</TD>
- <TD>fl_filename_ext()</TD>
-</TR>
-<TR>
- <TD>filename_isdir()</TD>
- <TD>fl_filename_isdir()</TD>
-</TR>
-<TR>
- <TD>filename_list()</TD>
- <TD>fl_filename_list()</TD>
-</TR>
-<TR>
- <TD>filename_match()</TD>
- <TD>fl_filename_match()</TD>
-</TR>
-<TR>
- <TD>filename_name()</TD>
- <TD>fl_filename_name()</TD>
-</TR>
-<TR>
- <TD>filename_relative()</TD>
- <TD>fl_filename_relative()</TD>
-</TR>
-<TR>
- <TD>filename_setext()</TD>
- <TD>fl_filename_setext()</TD>
-</TR>
-<TR>
- <TD>frame()</TD>
- <TD>fl_frame()</TD>
-</TR>
-<TR>
- <TD>inactive()</TD>
- <TD>fl_inactive()</TD>
-</TR>
-<TR>
- <TD>numericsort()</TD>
- <TD>fl_numericsort()</TD>
-</TR>
-</TABLE>
-</CENTER>
-
-\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
-<hr>
-<table summary="navigation bar" width="100%" border="0">
-<tr>
- <td width="45%" align="LEFT">
- <a class="el" href="osissues.html">
- [Prev]
- Operating System Issues
- </a>
- </td>
- <td width="10%" align="CENTER">
- <a class="el" href="index.html">[Index]</a>
- </td>
- <td width="45%" align="RIGHT">
- <a class="el" href="migration_1_3.html">
- Migrating Code from FLTK 1.1 to 1.3
- [Next]
- </a>
- </td>
-</tr>
-</table>
-\endhtmlonly
-
-*/