LCL 없이 Free Pascal로 만든 창 하나짜리 UI 뼈대 — fpc-directui-demo
LCL 없이 Free Pascal과 Win32 API만으로 창 없는 컨트롤, GDI 더블 버퍼, 모니터별 DPI, 한글 출력을 다루는 작은 DirectUI 예제입니다. 직접 그리는 UI 구조를 공부하려는 파스칼 개발자에게 맞습니다.
LCL이나 VCL로 화면을 만들면 버튼 하나하나가 운영체제의 창(HWND)입니다. 요즘 부드럽게 움직이는 UI들은 반대로 갑니다. 운영체제에는 창을 하나만 맡기고, 그 안의 버튼과 글자는 프로그램이 직접 그리고 마우스 이벤트도 직접 나눠 줍니다. 이런 방식을 DirectUI라고 부릅니다.
fpc-directui-demo는 이 구조를 Windows에서 보여 주는 작은 참조 구현입니다. LCL도 서드파티 위젯셋도 쓰지 않고, FPC의 Windows 유닛만 링크합니다. 한자리에서 다 읽을 수 있을 만큼 작게 만들었습니다.
무엇을 하나
실행하면 창 하나에 라벨 1개와 버튼 2개("증가 (+1)", "초기화")가 뜹니다. 버튼은 마우스를 올리거나 누를 때 모양이 바뀌고, 누르면 클릭 횟수가 바뀝니다. 이 작은 화면 안에 다음 내용이 들어 있습니다.
- 창 하나(HWND 1개) 위의 창 없는 컨트롤 트리와 폼의 hit-test
GWLP_USERDATA를 거쳐 정적 WndProc와 객체 인스턴스를 잇는 방법WM_ERASEBKGND를 가로채고 GDI 더블 버퍼로 그려 깜빡임 없애기- 모니터별 DPI(per-monitor DPI v2) 인식, 오래된 Windows에서는 그에 맞게 물러남
- 처음부터 끝까지 유니코드로 한글 출력
소스 구성
| 유닛 | 하는 일 |
|---|---|
directui_demo.lpr |
진입점. 폼과 컨트롤을 만들고 이벤트를 연결 |
duiapp.pas |
TApplication — DPI 설정, 메시지 루프, 종료 처리 |
duiforms.pas |
TForm — 유일한 HWND, WndProc 연결, 메시지 분배, 더블 버퍼 그리기, 모니터별 DPI |
duicontrols.pas |
창 없는 컨트롤 트리(TControl, 버튼, 라벨) |
duipaint.pas |
그리기 추상화(TPainter, GDI 더블 버퍼) |
그리기는 TPainter의 FillRectangle, FrameRectangle, DrawText 뒤에 모아 두었습니다. 이 메서드 본문만 바꾸면 GDI 대신 Direct2D로 옮길 수 있게 한 구조입니다.
써 보기
FPC 3.2.2가 필요합니다. 빌드 스크립트는 컴파일러를 C:\DEV\lazarus\fpc\3.2.2\bin\x86_64-win64\fpc.exe에서 찾으니, 다른 곳에 설치했다면 build.ps1의 $FpcRoot를 고칩니다.
# 빌드 -> bin\directui_demo.exe
.\build.ps1
# 정리 후 다시 빌드하고 실행
.\build.ps1 -Clean -Run
직접 컴파일할 때는 이렇게 합니다.
fpc -Twin64 -Mdelphiunicode -O2 -FEbin -FUbuild -Fusrc src\directui_demo.lpr
미리 빌드한 directui_demo.exe는 Releases에 있습니다.
Delphi 코드를 FPC로 옮기며 겪은 일
원본은 Delphi(Winapi.*) 기준이라 FPC 3.2.2에 맞추며 손본 곳이 doc/README.md에 정리돼 있습니다.
한글이 깨질 때
모든 유닛에 {$codepage utf8} 지시어가 있어야 합니다. 없으면 FPC 3.2.2가 시스템 코드페이지(949)를 지원하지 않아 latin-1로 처리하고, UTF-8 한글 바이트를 글자 단위로 잘못 읽어 실행 화면에서 한글이 깨집니다. 파일의 BOM이나 명령줄 -Fcutf8만으로는 고쳐지지 않습니다.
그 밖에 이런 차이를 메웠습니다.
CLEARTYPE_QUALITY가 없어 값5로 상수를 직접 정의CREATESTRUCTW대신PCREATESTRUCT사용(FPC 쪽은 이미 wide)SetProcessDPIAware가 선언돼 있지 않아user32.dll에서 직접 가져옴- 블록 주석 안의
{$IFDEF FPC}를 FPC가 지시어로 읽어 주석이 깨지므로, 문서용 표기는 중괄호 없이 씀 GetMessageW의 반환형이BOOL이라Integer(...)로 바꾼 뒤> 0으로 비교
알아 둘 점
- 빌드 스크립트와 설정은 Win64 전용입니다.
소스와 포팅 메모는 GitHub 저장소에 있습니다.