1
0
mirror of https://github.com/MarlinFirmware/Marlin.git synced 2024-11-24 04:29:34 +00:00
MarlinFirmware/Marlin/fonts
Scott Lahteine 4b40964064 Overridable Options - Part 3 (PR#2555)
Apply `ENABLED` / `DISABLED` macros to language-related files.
2015-07-31 00:19:13 -05:00
..
bdf2u8g.exe
HD44780_C.fon
HD44780_J.fon
HD44780_W.fon
ISO10646_CN.fon Intit. commit for Chinese 2015-04-27 12:15:36 +02:00
ISO10646_Kana.fon
ISO10646-1.fon Add new (cleaner) Marlin font 2015-03-17 10:33:02 +01:00
ISO10646-5_Cyrillic.fon
make_fonts.bat Intit. commit for Chinese 2015-04-27 12:15:36 +02:00
Marlin_symbols.fon Add new (cleaner) Marlin font 2015-03-17 10:33:02 +01:00
README.fonts Overridable Options - Part 3 (PR#2555) 2015-07-31 00:19:13 -05:00

The fonts are created with Fony.exe (http://hukka.ncn.fi/?fony) because Fontforge didn't do what I want (probably lack off experience). 
In Fony export the fonts to bdf-format. Maybe another one can edit them with Fontforge.
Then run make_fonts.bat what calls bdf2u8g.exe with the needed parameters to produce the .h files.
The .h files must be edited to replace '#include "u8g.h"' with '#include <utility/u8g.h>', replace 'U8G_FONT_SECTION' with 'U8G_SECTION', insert '.progmem.' right behind the first '"' and moved to the main directory.

How to integrate a new font:
Currently we are limited to 256 symbols per font. We use a menu system with 5 lines, on a display with 64 pixel height. That means we have 12 pixel for a line. To have some space in between the lines we can't use more then 10 pixel height for the symbols. For up to 11 pixel set TALL_FONT_CORRECTION 1 when loading the font.
To fit 22 Symbols on the 128 pixel wide screen, the symbols can't be wider than 5 pixel, for the first 128 symbols.
For the second half of the font we now support up to 11x11 pixel. 

 * Get 'Fony.exe'
 * Copy one of the existing *.fon files and work with this.
 * Change the pixels. Don't change width or height.
 * Export as *.bdf
 * Use 'bdf2u8g.exe' to produce the *.h file. Examples for the existing fonts are in 'make_fonts.bat'
 * Edit the produced .h file to match our needs. See hints in 'README.fonts' or the other 'dogm_font_data_.h' files.
 * Make a new entry in the font list in 'dogm_lcd_implementation.h' before the '#else // fall back'
    #elif ENABLED(DISPLAY_CHARSET_NEWNAME)
      #include "dogm_font_data_yourfont.h"
      #define FONT_MENU_NAME YOURFONTNAME
    #else // fall-back
 * Add your font to the list of permitted fonts in 'language_en.h'
    ... || ENABLED(DISPLAY_CHARSET_YOUR_NEW_FONT) ... )


Especially the Kana font should be revised by someone who knows what he/she does. I am only a west-European with very little knowledge about this script.