diff options
| author | Albrecht Schlosser <albrechts.fltk@online.de> | 2025-02-01 20:39:28 +0100 |
|---|---|---|
| committer | Albrecht Schlosser <albrechts.fltk@online.de> | 2025-02-01 20:39:28 +0100 |
| commit | 0c7ed2b44f3a0d87c5871846a7dc65cdefe65b01 (patch) | |
| tree | 2e6185d4c48faf69b4a4f6b6b0c659e0872739be | |
| parent | 77a7752123876800255ee901a692ae0ff400c0cb (diff) | |
Document "New FL_HELVETICA Font on Windows" (#478)
This commit adds only documentation.
| -rw-r--r-- | documentation/src/migration_1_4.dox | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/documentation/src/migration_1_4.dox b/documentation/src/migration_1_4.dox index 51ab17d1b..3455aeb5f 100644 --- a/documentation/src/migration_1_4.dox +++ b/documentation/src/migration_1_4.dox @@ -384,6 +384,35 @@ OPTION_USE_XRENDER | FLTK_USE_XRENDER OPTION_WAYLAND_ONLY | FLTK_BACKEND_X11=OFF +\section migration_1_4_windows_font New FL_HELVETICA Font on Windows + +In FLTK releases before 1.4.2 the Windows font name used for the FLTK font +'FL_HELVETICA' and its variants was named 'Arial'. It turned out that this +was a very old font used in early Windows versions and had been replaced with +the newer font name 'Microsoft Sans Serif'. This font has many more UTF-8 +capable glyphs (characters) and is almost 100% compatible with the previously +used font 'Arial'. It is supported by Microsoft since Windows XP, our oldest +currently (partially) supported Windows platform. + +This new font is used since FLTK 1.4.2. + +We don't expect any issues with this much better font but if you really want +strict backwards compatibility with FLTK 1.3.x or early 1.4.0/1.4.1 versions +you can apply a tiny patch at the beginning of your program. + +This code will load the old font 'Arial' on Windows: + +\code +#ifdef _WIN32 + // reset Windows fonts to pre-1.4.2 state + Fl::set_font(FL_HELVETICA, " Arial"); + Fl::set_font(FL_HELVETICA + 1, "BArial"); + Fl::set_font(FL_HELVETICA + 2, "IArial"); + Fl::set_font(FL_HELVETICA + 3, "PArial"); +#endif +\endcode + + \htmlonly <hr> <table summary="navigation bar" width="100%" border="0"> |