ZPL 명령어 레퍼런스 & 치트시트
ZPLCraft2026년 8월 17일 업데이트
이것은 형식 구조, 텍스트, 폰트, 바코드, 그래픽, 프린터 제어에 자주 사용되는 ZPL II 명령어의 실용적인 레퍼런스입니다. 모든 위치와 크기는 프린터 도트 단위입니다(203 dpi = 8 도트/mm — 기본 내용은 ZPL이란?을 참조하세요). 구문 열에 표시된 매개변수는: x,y = 왼쪽 상단 모서리에서의 위치, h,w = 높이 및 너비, o = 방향(N 정방향, R 90°, I 180°, B 270°).
라벨 형식
| 명령어 | 구문 | 기능 |
|---|---|---|
^XA | ^XA | 라벨 형식의 시작. 모든 라벨은 이 명령으로 시작합니다. |
^XZ | ^XZ | 라벨 형식의 종료. 프린터는 이 명령을 받으면 라벨을 렌더링하고 인쇄합니다. |
^FX | ^FXcomment | 주석 — 프린터가 무시합니다. 다른 필드와 마찬가지로 ^FS로 끝냅니다. |
^PW | ^PWwidth | 도트 단위 인쇄 너비. 필드가 잘리지 않도록 라벨 너비에 맞게 설정하세요. |
^LL | ^LLlength | 도트 단위 라벨 길이. 주로 연속(비갭) 미디어에 필요합니다. |
^LH | ^LHx,y | 라벨 홈 — 이후의 모든 ^FO 위치 원점을 이동합니다. |
^PQ | ^PQqty | 인쇄 수량 — 이 라벨의 복사본을 몇 장 인쇄할지 지정합니다. |
^PR | ^PRspeed | 인치/초 단위 인쇄 속도. 느릴수록 더 진하고 선명하게 인쇄되는 경우가 많습니다. |
^MD | ^MDdarkness | 미디어 어두움 조정, -30~30. 인쇄가 흐릿하면 값을 올리세요. |
필드 및 텍스트
| 명령어 | 구문 | 기능 |
|---|---|---|
^FO | ^FOx,y | 필드 원점 — 라벨 홈에서 x,y 도트 위치에 다음 필드를 배치합니다. |
^FD | ^FDdata | 필드 데이터 — 현재 필드의 내용(텍스트 또는 바코드 데이터). |
^FS | ^FS | 필드 구분자 — 현재 필드를 닫습니다. 각 필드 뒤에 반드시 필요합니다. |
^FB | ^FBwidth,lines,space,align | 필드 블록 — ^FD 텍스트를 블록으로 래핑합니다: 최대 너비, 최대 줄 수, 줄 간격, 정렬(L/C/R/J). |
^FR | ^FR | 필드 반전 — 검은 영역과 겹치는 부분에서 필드를 흰색으로 인쇄합니다. |
^FH | ^FH | 필드 16진수 — ^FD에서 _xx 16진수 이스케이프를 허용합니다. 예: é의 경우 _C3_A9. |
^CI | ^CIencoding | 문자 집합; ^CI28은 UTF-8을 선택하며 비ASCII 텍스트에 권장됩니다. |
폰트
| 명령어 | 구문 | 기능 |
|---|---|---|
^A | ^Afo,h,w | 다음 필드의 폰트: 폰트 문자 f(0–9, A–Z), 방향, 도트 단위 높이 및 너비. ^A0N,40,40은 40 도트의 스케일러블 기본 폰트입니다. |
^CF | ^CFf,h,w | 자체 ^A를 설정하지 않는 모든 후속 필드의 기본 폰트를 변경합니다. |
^A@ | ^A@o,h,w,name | 프린터에 저장된 폰트 파일 사용(예: 다운로드한 TrueType). |
폰트 0은 스케일러블 벡터 폰트로 일반적인 선택입니다. 폰트 A–H는 고정 크기 비트맵 폰트로, 기본 크기나 정수 배수에서만 올바르게 보입니다.
바코드
| 명령어 | 구문 | 기능 |
|---|---|---|
^BY | ^BYw,r,h | 바코드 필드 기본값: 도트 단위 모듈(좁은 바) 너비, 넓음-좁음 비율, 기본 높이. 바코드 명령 전에 설정하세요. |
^BC | ^BCo,h,f,g,e,m | Code 128 — 배송 및 물류를 위한 주력 1D 바코드. f=Y면 인간이 읽을 수 있는 줄을 인쇄하고, g=Y면 코드 위에 인쇄합니다. |
^B3 | ^B3o,e,h,f,g | Code 39 — 일부 산업 및 국방 규격에서 여전히 요구하는 오래된 1D 심볼로지. |
^BE | ^BEo,h,f,g | EAN-13 소매 바코드(UPC-A는 ^BU 사용). |
^BQ | ^BQa,model,mag,ec | QR 코드. 배율 1–10으로 모듈 크기를 설정하고, ec로 오류 수정(H/Q/M/L)을 설정합니다. 인코딩 모드를 데이터 앞에 붙이세요. 예: ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — 전자부품 및 의료 라벨에서 흔히 사용되는 소형 2D 코드. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — 신분증 및 일부 물류 문서에 사용되는 적층형 2D 코드. |
바코드 크기는 심볼로지마다 다릅니다. ^BY로 모듈 너비, 비율, 높이를 설정한 뒤 최소 치수와 여백은 해당 심볼로지, 운송업체 또는 업계 규격을 따르세요. 미리보기는 프로덕션 스캐너와 미디어를 사용한 실제 인쇄 검증을 대신하지 않습니다.
그래픽
| 명령어 | 구문 | 기능 |
|---|---|---|
^GB | ^GBw,h,t,c,r | 그래픽 박스: 너비, 높이, 테두리 두께, 색상(B/W), 모서리 둥글기 0–8. 얇은 ^GB가 선을 그리는 방법입니다. |
^GC | ^GCd,t,c | 지름 d와 테두리 두께 t를 가진 그래픽 원. |
^GD | ^GDw,h,t,c,o | w×h 박스 안의 대각선 그래픽; o는 방향(L 또는 R)을 설정합니다. |
^GF | ^GFa,b,c,d,data | 그래픽 필드 — 비트맵(예: 로고)을 16진수 또는 이진 데이터로 라벨에 직접 포함합니다. |
~DG | ~DGd:name,t,w,data | 그래픽 다운로드 — 프린터에 이미지를 저장한 후 ^XG로 배치합니다. |
^XG | ^XGd:name,mx,my | 현재 필드 원점에 저장된 그래픽을 x/y 배율로 불러옵니다. |
프린터 제어 및 상태
| 명령어 | 구문 | 기능 |
|---|---|---|
~HS | ~HS | 호스트 상태 — 프린터가 용지 부족, 일시 정지, 버퍼, 오도미터 정보로 응답합니다. |
~HI | ~HI | 호스트 식별 — 모델, 펌웨어 버전, DPI, 메모리. |
^MM | ^MMmode | 인쇄 모드: T 절취, P 박리, R 되감기, C 커터. |
^MN | ^MNtype | 미디어 추적: Y 갭/웹 감지, M 블랙마크, N 연속. |
~JC | ~JC | 미디어 캘리브레이션 실행(프린터가 라벨을 몇 장 이송하여 갭을 찾습니다). |
~JA | ~JA | 프린터 버퍼의 모든 라벨 형식을 취소합니다. |
^JUS | ^JUS | 전원 사이클 후에도 설정이 유지되도록 플래시에 현재 설정을 저장합니다. |
모두 합쳐보기
위 그룹 대부분을 사용한 일반적인 4×6 배송 스타일 라벨:
^XA
^PW812
^CI28
^CF0,32
^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS
^FO40,230^GB732,3,3^FS
^FO40,260^FDOrder #A-10592 / 3 of 4^FS
^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZ도트 좌표를 직접 편집하는 일은 금세 번거로워집니다 — 레이아웃을 조금만 바꿔도 숫자를 수정하고 다시 인쇄해야 합니다. 필드를 직접 드래그하여 배치하고 ZPL이 자동으로 작성되기를 원한다면, 아래 ZPLCraft 편집기가 시각적 캔버스를 바로 이런 깔끔한 ZPL로 컴파일하며, 호환되는 브라우저-프린터 USB 경로로 전송할 수도 있지만 브라우저, 운영체제, 프린터가 점유 가능한 인터페이스를 제공해야 합니다.