AdafruitGFXFontTool
Создатель собственных шрифтов для микроконтроллеров с использованием формата шрифтов Adafruit GFX.
Как установить или собрать и запустить проект
Требования к времени выполнения:
- Любой компьютер с ОС Windows (компьютер/ноутбук)
- .NET Framework 4.8
Требования к сборке:
- Любой компьютер с ОС Windows (компьютер/ноутбук)
- Визуальная Студия 2022
- .NET Framework 4.8
Скачиваем и запускаем проект
- Загрузите предварительно созданный и готовый к запуску проект на AdafruitGFXFontTool -Releases.
- Разархивируйте Release.zip
- Откройте папку Release и запустите AdafruitGFXFont.exe.
Создание и запуск проекта
- Загрузите и извлеките папку с исходным кодом.
- Откройте AdafruitGFXFont/AdafruitGFXFont.csproj в Visual Studio 2022.
- В Visual Studio выберите «Сборка» -> «Построить решение».
- Проект будет построен в AdafruitGFXFontbinDebug или AdafruitGFXFontbinRelease (отладка по умолчанию)
- Созданный исполняемый файл будет называться AdafruitGFXFont.exe.
Использование проекта
У вас есть два варианта начала работы над проектом. Либо создайте свой собственный шрифт с помощью «Установить настройки шрифта» , либо импортируйте шрифт с помощью «Импортировать шрифт».
При импорте пользовательского шрифта все свойства шрифта: диапазон символов, имя и высота также будут импортированы автоматически.
При создании нового шрифта вам нужно будет выбрать эти переменные самостоятельно.
- Имя шрифта может быть любым допустимым именем переменной в Правилах именования переменных C/C++.
- Высота шрифта должна быть числом (0–255), например uint8_t. Примечание. Высота шрифта используется только для определения расстояния до новой строки (также известного как yAdvance).
- Минимальный и максимальный диапазон определяет диапазон символов UTF-8, которые будут включены в шрифт. Диапазон можно ввести как число (0–65535) или шестнадцатеричное число (0x00–0xfFF) как uint16_t.
- Когда все переменные введены по желанию, нажмите «Отправить».
Под меткой «Выбрать символ» находится раскрывающееся меню со всеми доступными символами в диапазоне шрифта, перечисленными в формате (int / hex = char). Выберите один, чтобы начать.
После выбора персонажа вы можете изменить свойства персонажа:
- Ширина: ширина (размер координаты x) вашего персонажа — число (0–255) в виде uint8_t.
- Высота: высота (размер координаты y) вашего персонажа — число (0–255) в виде uint8_t.
- xAdvance: количество пикселей для перемещения курсора (координата x) после рисования символа — число (0–255) в виде uint8_t.
- xOffset: величина перемещения, применяемая к курсору (координата x) перед рисованием символа (не влияет на курсор после рисования) — число (-128-127) в виде int8_t
- yOffset: величина перемещения, применяемая к курсору (координата u) перед рисованием символа (не влияет на курсор после рисования) — число (-128-127) в виде int8_t. После выбора нужных переменных нажмите «Применить новые параметры символа» .
При применении новых свойств персонажа ранее нарисованный персонаж будет затерт, в результате чего в самой правой точке экрана останется массив белых квадратов.
Нажимайте на квадраты, чтобы начать рисовать! при нажатии квадраты меняют цвет с белого на черный, где черный — это пиксели, которые будут нарисованы.
Примечание. Квадраты создаются из массива элементов C# PictureBox, которые крайне неэффективны для этой задачи, но легко отлаживают и разрабатывают. Это означает, что будет задержка в определении того, насколько быстро вы сможете щелкнуть один и тот же квадрат несколько раз.
Когда вы закончите рисовать нужные символы, нажмите «Создать шрифт» и выберите папку.
В результате будет выведен один файл в папке с названием «{fontname}GFXFONT.h».
Когда этот заголовочный файл импортируется в проект, элемент GFXfont можно называть именем шрифта, установленным в начале.
Ресурсы
- Графическая библиотека Adafruit GFX
- Библиотека светодиодной матрицы, которую я использовал для этого шрифта: ESP32-HUB75-MatrixPanel.