다음을 통해 공유


표준 변수

Important

최신 인쇄 플랫폼은 Windows에서 프린터와 통신하는 데 선호되는 수단입니다. 프린터 장치 개발을 위해 Windows 10 및 11의 인쇄 환경을 사용자 지정하려면 MICROSOFT의 IPP 받은 편지함 클래스 드라이버와 PSA(인쇄 지원 앱)를 사용하는 것이 좋습니다.

자세한 내용은 최신 인쇄 플랫폼 및 인쇄 지원 앱 디자인 가이드를 참조하세요.

GPD 언어는 명령 문자열 형식을 사용하여 명령 문자열 내에서 참조할 수 있는 표준 변수 집합을 정의합니다. Unidrv 드라이버는 이러한 변수에 값을 할당합니다. GPD 파일의 관점에서 변수는 읽기 전용입니다.

모든 표준 변수는 DWORD 정수로 저장됩니다.

다음 프린터 명령 항목은 래스터 데이터 블록이 준비되면 HP LaserJet 4P로 전송되는 명령 문자열을 지정합니다.

*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"

다음 표에는 모든 표준 변수가 사전순으로 포함되어 있습니다.

표준 변수 이름 설명
BlueValue 현재 색의 파란색 구성 요소입니다. CmdDefinePaletteEntry 명령 문자열에서 사용할 수 있습니다(GreenValue, RedValue 참조).
CurrentFontID 현재 다운로드한 소프트 글꼴의 ID 번호입니다. 현재 인쇄 작업에 다운로드한 소프트 글꼴이 포함되어 있는지 유효합니다.
CurrentPaletteIndex 색상표의 현재 인덱스입니다. CmdSelectPaletteEntry 명령 문자열에 사용할 수 있습니다(GreenValue, RedValue 참조).
CursorOriginX 커서 원점의 X 좌표(마스터 단위)입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
CursorOriginY 커서 원점의 Y 좌표(마스터 단위)입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
DestX 커서 원본을 기준으로 커서 대상의 X 좌표(마스터 단위)입니다. CmdXMoveAbsolute 명령 문자열에 사용할 수 있습니다.
DestXRel 현재 커서 위치를 기준으로 커서 대상의 X 좌표(마스터 단위)입니다. CmdXMoveRelLeft 및 CmdXMoveRelRight 명령 문자열에 사용할 수 있습니다.
Desty 커서 원본을 기준으로 커서 대상의 Y 좌표(마스터 단위)입니다. CmdYMoveAbsolute 명령 문자열에 사용할 수 있습니다.
DestYRel 현재 커서 위치를 기준으로 커서 대상의 Y 좌표(마스터 단위)입니다. CmdYMoveRelUp 및 CmdYMoveRelDown 명령 문자열에 사용할 수 있습니다.
FontBold 현재 글꼴이 굵게 표시되면 1로 설정하거나, 그렇지 않으면 0으로 설정합니다. 글꼴을 지정한 경우 유효합니다.
FontHeight 현재 글꼴의 높이(마스터 단위)입니다. 글꼴을 지정한 경우 유효합니다.
FontItalic 현재 글꼴이 기울임꼴이면 1로 설정하거나, 그렇지 않으면 0으로 설정합니다. 글꼴을 지정한 경우 유효합니다.
FontMaxWidth 글꼴에 있는 모든 문자 모양의 최대 문자 증분으로 설정합니다. 글꼴을 지정한 경우 유효합니다.
FontStrikeThru 현재 글꼴에 대해 취소를 사용하는 경우 1로 설정하거나, 그렇지 않으면 0으로 설정합니다. 글꼴을 지정한 경우 유효합니다.
FontUnderLine 현재 글꼴에 밑줄이 그어지면 1로 설정하거나, 그렇지 않으면 0으로 설정합니다. 글꼴을 지정한 경우 유효합니다.
FontWidth 현재 글꼴의 너비(마스터 단위)입니다. 글꼴을 지정한 경우 유효합니다.
GraphicsXRes DPI의 그래픽에 대한 현재 가로 해상도입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
GraphicsYRes DPI의 그래픽에 대한 현재 세로 해상도입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
GrayPercentage 회색 채우기에 사용할 회색 수준(백분율)입니다. CmdRectGrayFill 명령 문자열에 사용할 수 있습니다.
GreenValue 현재 색의 녹색 구성 요소입니다. CmdDefinePaletteEntry 명령 문자열에서 사용할 수 있습니다(BlueValue, RedValue 참조).
LinefeedSpacing 줄 바꿈을 나타내는 세로 공간의 양(마스터 단위)입니다. CmdSetLineSpacing 명령 문자열에 사용할 수 있습니다.
NextFontID 다운로드할 다음 소프트 글꼴의 ID 번호입니다. CmdSetFontID 명령 문자열에 사용할 수 있습니다.
NextGlyph 다운로드할 다음 문자 모양의 2바이트 코드입니다. CmdSetCharCode 명령 문자열에 사용할 수 있습니다.
NumOfCopies 사용자가 요청한 복사본 수입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
NumOfDataBytes 전송할 준비가 된 래스터 데이터의 바이트 수입니다. 모든 CmdSendXXXData 명령 문자열에 사용할 수 있습니다. 데이터가 압축된 경우 값은 압축 후의 바이트 수입니다.
PageNumber 현재 인쇄 중인 페이지 수입니다. 이는 애플리케이션의 페이지 번호에 해당하는 것이 아니라 DrvSendPage가 호출된 횟수에 해당합니다. 이 값은 DrvStartDoc에 의해 초기화되고 DrvSendPage에 의해 증가합니다. 예를 들어 N-up = 4를 선택하면 문서의 다섯 번째 페이지가 인쇄될 때만 PageNumber 가 2로 증가합니다. 또 다른 예로 문서가 역순으로 인쇄되는 경우(뒤로) PageNumber 표준 변수는 문서의 마지막 페이지임에도 불구하고 1페이지로 인쇄할 첫 번째 페이지를 보고합니다. 자동 이중 기능을 제대로 지원하려면 이 동작이 필요합니다. OEM은 PageNumber를 사용하여 현재 페이지가 전면 또는 후면인지 여부를 확인해야 합니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
PaletteIndexToProgram 프로그램의 다음 항목에 대한 색 팔레트에 인덱싱합니다. CmdDefinePaletteEntry 명령 문자열에 사용할 수 있습니다. (또한 참조 RedValue, GreenValue, BlueValue, CurrentPaletteIndex).
PatternBrushID 다운로드한 패턴 브러시의 ID 번호입니다. CmdDownloadPattern 및 CmdSelectPattern 명령 문자열에 사용할 수 있습니다.
PatternBrushSize 현재 패턴 브러시의 크기(바이트)입니다. CmdDownloadPattern 명령 문자열에 사용할 수 있습니다.
PatternBrushType 현재 패턴 브러시의 형식입니다. 값은 2: 음영 패턴 3: 교차 해치 패턴 4: 사용자 정의 패턴일 수 있습니다. CmdDownloadPattern 및 CmdSelectPattern 명령 문자열에 사용할 수 있습니다.
PhysPaperLength 현재 사용 중인 용지의 세로 모드 길이(y 마스터 단위)입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
PhysPaperWidth 현재 사용 중인 용지의 세로 모드 너비(마스터 단위)입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
PrintDirInCCDegrees 시계 반대 방향으로 측정된 회전 양(도)입니다. 드라이버가 CmdSetSimpleRotation 또는 CmdSetAnyRotation 명령 문자열을 보낼 때 유효합니다.
RasterDataHeightInPixels 현재 데이터가 나타내는 이미지의 높이(픽셀)입니다. 모든 CmdSendXXXData 명령 문자열 및 CmdSetSrcBmpHeight 명령 문자열에서 사용할 수 있습니다. 압축은 이 값을 수정하지 않습니다.
RasterDataWidthInBytes 스캔 줄에 포함된 바이트 수입니다. 모든 CmdSendXXXData 명령 문자열 및 CmdSetSrcBmpWidth 명령 문자열에서 사용할 수 있습니다. 압축은 이 값을 수정하지 않습니다.
RectXSize 사각형 너비(x 마스터 단위)입니다. CmdSetRectWidth 명령 문자열에 사용할 수 있습니다.
RectYSize 사각형 길이(y 마스터 단위)입니다. CmdSetRectHeight 명령 문자열에 사용할 수 있습니다.
RedValue 현재 색의 빨간색 구성 요소입니다. CmdDefinePaletteEntry 명령 문자열에 사용할 수 있습니다(GreenValue, BlueValue 참조).
TextXRes 텍스트의 현재 가로 해상도(DPI)입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.
TextYRes 텍스트의 현재 세로 해상도(DPI)입니다. 인쇄 작업이 진행 중일 때마다 유효합니다.