🖨️ Zebra ZPL 기본 명령어와 출력 예제 정리
Zebra 프린터를 처음 접하면 “ZPL이 뭐지?”라는 생각이 들기 마련입니다.
ZPL(Zebra Programming Language)은 Zebra 라벨 프린터가 텍스트, 바코드, 이미지, 선, 박스 등을 출력하기 위해 사용하는 전용 프로그래밍 언어입니다.
즉, 엑셀이나 워드처럼 GUI를 통해 인쇄하는 것이 아니라, 명령어를 직접 전달해 프린터가 그대로 그리도록 하는 방식입니다.
📘 ZPL의 기본 구조
ZPL은 ^XA 로 시작하고 ^XZ 로 끝납니다.
이 사이에 다양한 명령어를 넣어 하나의 라벨을 구성합니다.
^XA
... 출력할 내용 ...
^XZ
예를 들어, 아래처럼 간단한 텍스트를 출력할 수 있습니다.
^XA
^FO50,50^A0N,50,50^FDHello, ZEBRA!^FS
^XZ
^FO50,50: 출력 위치 X=50, Y=50^A0N,50,50: 폰트 종류(A0), 방향(Normal), 크기(50×50)^FD...^FS: 출력할 데이터(Field Data, Field Separator)
이 명령어를 프린터로 전송하면, “Hello, ZEBRA!” 라는 글자가 라벨 위에 깔끔히 인쇄됩니다.
📦 바코드 출력 (Code128)
Zebra 프린터의 강점은 바코드 출력입니다.
대표적인 Code128 형식은 아래처럼 간단히 출력할 수 있습니다.
^XA
^FO50,100^BCN,100,Y,N,N
^FD1234567890^FS
^XZ
명령어 설명
^BCN,100,Y,N,NBC: Code128 바코드N: Normal 방향100: 높이Y: 숫자 표시N,N: 체크 디지트/해석선 관련 설정
^FD1234567890^FS: 바코드에 인코딩할 실제 데이터
📱 QR코드 출력
최근에는 제품 포장이나 라벨에 QR코드를 함께 출력하는 경우가 많습니다.
ZPL에서도 QR코드를 아주 쉽게 표현할 수 있습니다.
^XA
^FO100,100
^BQN,2,10
^FDLA,https://5047878.net^FS
^XZ
^BQN,2,10: QR코드 생성 (모델 2, 크기 10)^FDLA,https://5047878.net^FS- “L”은 오류복원율(Low)
- “A”는 알파뉴메릭 데이터 시작
- 뒤는 실제 링크 또는 데이터
출력하면 깔끔한 QR코드가 생성되어 스마트폰으로 바로 스캔할 수 있습니다.
🔲 박스(라인) 출력
라벨 디자인에 테두리를 넣고 싶을 때는 ^GB 명령을 사용합니다.
^XA
^FO30,30
^GB300,200,4,B,0^FS
^XZ
^GB300,200,4,B,0- 가로 300, 세로 200
- 선 두께 4
B: 박스(Box)0: 모서리 반경 (0=직각)
이 명령으로 라벨에 네모난 박스를 쉽게 그릴 수 있습니다.
🧩 복합 예제 (텍스트 + 바코드 + QR)
아래는 실제로 제품 라벨에서 자주 사용하는 구성 예제입니다.
^XA
^FO50,30^A0N,40,40^FD제품명: Zebra Demo^FS
^FO50,80^A0N,30,30^FD코드: 1234567890^FS
^FO50,130^BCN,100,Y,N,N^FD1234567890^FS
^FO350,130^BQN,2,6^FDLA,https://5047878.net^FS
^FO30,250^GB500,3,3^FS
^FO50,270^A0N,25,25^FDPrinted by ZPL Example^FS
^XZ
이 스크립트를 실행하면,
- 상단에 텍스트 2줄
- 중간에 바코드와 QR코드
- 하단에 구분선과 작은 문구
가 포함된 완성형 라벨이 출력됩니다.
⚙️ 출력 방법
ZPL 명령어를 직접 출력하는 방법은 다음과 같습니다.
- Zebra Setup Utilities 또는 ZDesigner 드라이버 설치
- 프로그램 내 “Send File” 기능을 사용
- 위 명령을
.zpl파일로 저장 후 전송
Windows 명령줄에서 직접 테스트하려면:
copy example.zpl LPT1
또는 USB 프린터 포트 이름을 입력하면 됩니다.
💡 마무리
ZPL은 처음엔 다소 낯설지만, 한 번 구조를 익히면
GUI 편집기보다 훨씬 빠르고 유연하게 라벨을 구성할 수 있습니다.
제품 라벨, 출하 바코드, QR 코드, 문구 등을 자유롭게 조합할 수 있기 때문에
물류, 제조, IT 자산관리 등 다양한 현장에서 널리 사용되고 있습니다.
Zebra 프린터를 직접 다루는 분이라면,
ZPL 명령어를 익혀두는 것이 큰 도움이 됩니다.
코드를 통해 프린터를 자동 제어하고,
시스템에서 바로 출력까지 연결할 수 있으니까요.
About the Author
