LCD·OLED 폰트 생성기 (비트맵 → C 배열 변환)

빠른 답변

폰트 비트맵(取模)이란 무엇인가요?

// 中 (16x16), pages of columns, LSB first, lit = 1 — SSD1306 page order
const unsigned char zhong[32] = {
  0x00,0x00,0xF0,0x10,0x10,0x10,0x10,0xFF,0x10,0x10,0x10,0x10,0xF0,0x00,0x00,0x00,
  0x00,0x00,0x0F,0x04,0x04,0x04,0x04,0xFF,0x04,0x04,0x04,0x04,0x0F,0x00,0x00,0x00
};
// First 16 bytes = page 0 (rows 0-7), one byte per column, bit 0 = top row

이 생성기의 기능

변환 예시

中

00 00 F0 10 10 10 10 FF 10 10 10 10 F0 00 00 00 00 00 0F 04 04 04 04 FF 04 04 04 04 0F 00 00 00

中

01 00 01 00 01 00 01 00 3F F8 21 08 21 08 21 08 21 08 21 08 3F F8 21 08 01 00 01 00 01 00 01 00

A

00 00 00 00 18 24 24 42 42 7E 42 42 42 42 00 00

中 (12 × 12, 행 단위, MSB 우선)

00 00 04 00 04 00 FF E0 84 20 84 20 84 20 FF E0 04 00 04 00 04 00 04 00

LCD·OLED용 폰트 데이터 생성 방법

1. 1

   문자 입력 또는 이미지 끌어다 놓기

   텍스트는 실제 도트 폰트로 그립니다. 12 × 12(Fusion Pixel) 또는 16 × 16(GNU Unifont)이며 ASCII는 반각 폭입니다. 로고나 아이콘은 이미지 탭으로 전환해 128 × 64 같은 출력 크기를 지정합니다.

2. 2

   대상 디스플레이·라이브러리 선택

   SSD1306 / SH1106 / ST7565 계열은 페이지 순서의 세로 바이트에 맨 위 픽셀이 bit 0입니다. Adafruit GFX, TFT_eSPI, U8g2 drawBitmap, LVGL 계열은 가로 바이트에 왼쪽 픽셀이 bit 7입니다. XBM / U8g2 drawXBM 계열은 같은 가로 바이트지만 왼쪽 픽셀이 bit 0입니다.

3. 3

   미리보기 확인, 필요하면 픽셀 수정

   미리보기에는 실제로 인코딩되는 비트맵이 그대로 표시됩니다. 픽셀을 클릭하면 켜짐/꺼짐이 전환되고, 이동 입력란으로 글리프 위치를 조금씩 옮길 수 있습니다.

4. 4

   복사 또는 다운로드

   C(PCtoLCD2002 C51 스타일), Arduino PROGMEM, MicroPython bytearray, A51 어셈블리, 일반 16진수 중에서 고릅니다. 출력 첫 줄에 스캔 방향, 비트 순서, 글리프 크기가 기록되므로 배열 자체가 설명서 역할을 합니다.

글자 깨짐: 증상 → 잘못된 설정

U8g2 drawXBM()에 MSB 우선 바이트 전달

drawXBM() → XBM 프리셋 (행 단위, LSB 우선)

페이지별 열 단위, MSB 우선 → SSD1306

페이지별 열 단위, LSB 우선 → SSD1306

열 단위 → SSD1306 페이지 쓰기

페이지별 열 단위 → SSD1306 페이지 쓰기

행 단위 바이트를 SSD1306 페이지로 전송

배열을 디코더 탭에 붙여넣고 제대로 읽히는 미리보기 선택

이럴 때 필요합니다

0.96인치 SSD1306 OLED에 한자 표시

STM32나 8051 계열 보드에서 온도 값, 메뉴, 상태 표시줄을 한자로 띄울 때 씁니다. 16 × 16 폰트와 SSD1306 프리셋을 고르고, 예제 프로젝트에 이미 있는 oled_font.h에 배열을 붙여넣으세요.

Arduino·ESP32 디스플레이의 부팅 로고

PNG 로고를 끌어다 놓고 128 × 64로 설정한 뒤 Adafruit GFX 프리셋을 골라 display.drawBitmap(0, 0, logo, 128, 64, WHITE)를 호출합니다.

LVGL·U8g2 UI용 아이콘과 단위 기호

배터리, Wi-Fi, °C 기호를 1비트 이미지로 변환합니다. 가로 바이트·MSB 우선이 필요하면 Adafruit GFX / LVGL 프리셋을, U8g2 drawXBM()이라면 XBM 프리셋을 사용하세요.

Mac이나 Linux에서 작업할 때

PCtoLCD2002와 고전적인 字模提取 도구는 Windows 프로그램입니다. 이 도구는 최신 브라우저라면 어디서나 동작하며 설치가 필요 없습니다.

인수받은 프로젝트 역분석

이전 개발자가 메모 하나 없이 Hzk[][32] 배열만 남겼다면, 디코더에 붙여넣어 어떤 설정으로 생성했는지 먼저 알아낸 다음 같은 형식으로 새 글자를 추가하면 됩니다.

네 가지 스캔 방향의 동작 원리

행 단위 (가로 바이트)

위쪽 행부터 차례로 읽고, 한 행 안에서는 이웃한 8개 픽셀을 왼쪽부터 한 바이트에 담습니다. 16픽셀 행은 2바이트입니다. Adafruit GFX drawBitmap(), U8g2 drawBitmap(), XBM 파일, ST7920 GDRAM, LVGL 1비트 이미지가 이 배치를 씁니다.

페이지별 열 단위 (세로 바이트) — SSD1306 순서

글리프를 높이 8행짜리 페이지로 나눕니다. 페이지마다 왼쪽부터 열을 읽고, 각 바이트에 그 열의 8개 픽셀을 담습니다. SSD1306, SH1106, ST7565의 GDDRAM과 같은 구조이며, 데이터시트에 데이터 비트 D0이 맨 위 행에 기록된다고 명시되어 있습니다. 따라서 맞는 비트 순서는 LSB 우선입니다.

열 단위, 그리고 띠별 행 단위

열 단위는 한 열을 모든 페이지에 걸쳐 위에서 아래로 읽은 뒤 오른쪽 열로 넘어가며, SSD1306의 수직 어드레싱 모드에 대응합니다. 띠별 행 단위는 폭 8픽셀짜리 띠 하나의 모든 행을 읽고 다음 띠로 넘어갑니다. 주요 라이브러리는 이 방식을 쓰지 않지만 오래된 PCtoLCD2002 프로젝트에는 남아 있습니다. 두 방식 모두 글리프 높이(또는 폭)가 8픽셀 이하일 때만 짝이 되는 방식과 결과가 같기 때문에, 8 × 8로만 테스트하면 혼동을 알아채지 못합니다.

비트 순서와 켜진 픽셀 값

MSB 우선은 처음 읽은 픽셀(가장 왼쪽 또는 가장 위)을 bit 7에, LSB 우선은 bit 0에 둡니다. PCtoLCD2002에서는 이를 顺向(순방향, MSB 우선)과 逆向(역방향, LSB 우선)이라고 표기합니다. 켜진 픽셀 = 1(阴码)은 OLED, TFT drawBitmap(), LVGL A1이 기대하는 값이고, 켜진 픽셀 = 0(阳码)은 0을 켜짐으로 정의하는 드라이버에서만 씁니다.

크기가 8의 배수가 아닐 때의 패딩

각 행(가로 바이트) 또는 각 페이지(세로 바이트)는 따로따로 바이트 경계까지 채워지며, 패딩 비트는 0입니다. 페이지별 열 단위에서 12픽셀 글리프라면 둘째 페이지에 4행 분량의 패딩이 들어갑니다. 페이지 전체를 쓰는 드라이버는 글리프 아래 4행을 지워 버립니다. 이 경우에 해당하면 도구가 경고를 표시합니다.

한 번에 제대로 표시하는 요령

프리셋은 화면이 아니라 그리기 함수 기준으로

Adafruit_SSD1306으로 구동하는 SSD1306은 drawBitmap()을 거치므로, 컨트롤러 자체 메모리가 세로 방향이어도 가로 바이트·MSB 우선 데이터가 필요합니다. 코드가 호출하는 함수에 맞는 프리셋을 고르세요.

12 px와 16 px에는 도트 폰트를

윤곽선 폰트는 약 20 px 미만에서 이진화하면 획이 빠집니다. Fusion Pixel 12와 Unifont 16은 픽셀 격자에 맞춰 그린 폰트이고, 2배 옵션을 쓰면 24 × 24와 32 × 32도 깔끔하게 나옵니다.

헤더 주석은 지우지 마세요

출력 첫 줄에는 스캔 방향, 비트 순서, 크기가 기록됩니다. 여섯 달 뒤에는 그 배열을 어떻게 생성했는지 알려 주는 유일한 기록이 됩니다.

비대칭 글자로 테스트

中, 田, H처럼 대칭인 글리프는 반전 오류를 감춥니다. 먼저 F, 7, 乙로 시험해 보고, 제대로 읽히면 모든 옵션이 맞는 것입니다.

화면 전체 반전은 드라이버에서 해결

폰트뿐 아니라 화면 전체가 좌우 반전되거나 위아래가 뒤집혔다면, 초기화 시퀀스의 세그먼트 리맵(A0h/A1h)과 COM 스캔 방향(C0h/C8h)을 변경하세요. 폰트 설정을 바꾸면 다른 코드만 망가집니다.

자주 묻는 질문