본문으로 건너뛰기
시골프로그래머의 블로그
블로그 메뉴

LCL 없이 Free Pascal로 만든 창 하나짜리 UI 뼈대 — fpc-directui-demo

LCL 없이 Free Pascal과 Win32 API만으로 창 없는 컨트롤, GDI 더블 버퍼, 모니터별 DPI, 한글 출력을 다루는 작은 DirectUI 예제입니다. 직접 그리는 UI 구조를 공부하려는 파스칼 개발자에게 맞습니다.

풀빛컴퓨팅3분 읽기#오픈소스#Free Pascal#Win32#DirectUI

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 저장소에 있습니다.

함께 읽으면 좋은 글