ardupilot/libraries/AP_OSD/fonts
Henry Wurzburg b10344bac4 AP_OSD: update font files to remove blank space artifacts 2022-09-27 09:23:59 +10:00
..
HDFonts AP_OSD: update font files to remove blank space artifacts 2022-09-27 09:23:59 +10:00
MAX7456Charwizard.jar AP_OSD: add icon for terrain alt panel and font editor 2021-04-13 14:50:07 +10:00
README.md AP_OSD: add icon for terrain alt panel and font editor 2021-04-13 14:50:07 +10:00
bfstyle.mcm AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
bfstyle.png AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
bold.mcm AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
bold.png AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
clarity.mcm AP_OSD: Add sidebars for MAX7456 2021-09-28 09:04:45 +10:00
clarity.png AP_OSD: Add sidebars for MAX7456 2021-09-28 09:04:45 +10:00
clarity_medium.mcm AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
clarity_medium.png AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
digital.mcm AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
digital.png AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
font0.bin AP_OSD: Add sidebars for MAX7456 2021-09-28 09:04:45 +10:00
font1.bin AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
font2.bin AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
font3.bin AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
font4.bin AP_OSD: sidebar support for remaining 4 fonts 2021-09-28 09:04:45 +10:00
mcm2bin.py
mcm_all.py

README.md

Font styles

There are various font styles available to choose from. Credits to inavosd for providing the basis to develop on.

Font styles can be switched on-the-fly font style by setting parameter OSD_FONT to the desired number. This works for hardware backends as well as for SITL OSD.

Available styles and respective OSD_FONT numbers are:

clarity (OSD_FONT 0, default) a clearly visible large font:

clarity_medium (OSD_FONT 1) good visibility, less dominant than clarity default:

bfstyle (OSD_FONT 2) bf- / inav-osd default style:

bold (OSD_FONT 3) a bolder version of bfstyle:

digital (OSD_FONT 4) 80's clock radio style:

Adding font styles

Charsets can be edited or built form scratch using MAX7456Charwizard.jar included in this directory. Added charsets need to be converted to a binary file named fontN.bin prior to building the code. Files within this namespace will be automatically included in the build, so you can modify and replace existing .bin files or add your individual styles.

To do that, navigate to:

/ardupilot/libraries/AP_OSD/fonts

in your cloned repository and call:

./mcm2bin.py yourfont.mcm fontN.bin

to convert existent or added charsets into a binary. Now navigate back to the directory root, configure and build for your desired board.

SD-card based font handling

Support for SD-card based font handling has been added with firmware version 4.1 and later. This adds the option to choose from up to 10 font files (named "font0.bin" - "font9.bin") placed in the root directory of your SD card. It allows to save memory especially on 1 MB boards by removing font binaries from the main firmware binary. Additionally, this allows the user to easily add individualized and/or customized language charsets for the onboard OSD without the need to compile individual firmware. Runtime font changing using the parameter :ref:OSD_FONT<OSD_FONT> is unaffected. MAVftp might be a convenient option to upload files to your SD card without having to physically remove it from your flight controller.