Стандартные переменные

Важно!

Мы рекомендуем использовать драйвер microsoft IPP класса "Входящие" вместе с приложениями поддержки печати (PSA) для настройки печати в Windows 10 и 11 для разработки принтеров.

Дополнительные сведения см. в руководстве по проектированию приложений поддержки печати.

Язык GPD определяет набор стандартных переменных, на которые можно ссылаться в командных строках, используя формат командной строки. Драйвер Unidrv присваивает значения этим переменным. С точки зрения файла GPD переменные доступны только для чтения.

Все стандартные переменные хранятся в виде целых чисел DWORD.

Следующая запись команды принтера указывает командную строку, которая отправляется в HP LaserJet 4P при готовности блока растровых данных:

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

В следующей таблице содержатся все стандартные переменные в алфавитном порядке.

Стандартное имя переменной	Значение	Комментарии
BlueValue	Синий компонент текущего цвета.	Допустимо для использования в командных строках CmdDefinePaletteEntry (см. раздел GreenValue, RedValue).
CurrentFontID	Идентификационный номер текущего загруженного мягкого шрифта.	Допустимо, если текущее задание печати содержит скачанные мягкие шрифты.
CurrentPaletteIndex	Текущий индекс в цветовой палитре.	Допустимо для использования в командных строках CmdSelectPaletteEntry (см. раздел GreenValue, RedValue).
CursorOriginX	Координата X источника курсора в master единицах.	Допустимо при выполнении задания печати.
CursorOriginY	Координата Y источника курсора в master единицах.	Допустимо при выполнении задания печати.
DestX	Координата X назначения курсора в master единицах относительно источника курсора.	Допустимо для использования в командных строках CmdXMoveAbsolute.
DestXRel	Координата X назначения курсора в master единицах относительно текущего положения курсора.	Допустимо для использования в командных строках CmdXMoveRelLeft и CmdXMoveRelRight.
Desty	Координата Y назначения курсора в master единицах относительно источника курсора.	Допустимо для использования в командных строках CmdYMoveAbsolute.
DestyRel	Координата Y назначения курсора в master единицах относительно текущей позиции курсора.	Допустимо для использования в строках команд CmdYMoveRelUp и CmdYMoveRelDown.
FontBold	Задайте значение 1, если текущий шрифт выделен полужирным шрифтом, или ноль в противном случае.	Допустимо при указании шрифта.
FontHeight	Высота текущего шрифта в master единицах.	Допустимо при указании шрифта.
FontItalic	Задайте значение 1, если текущий шрифт курсив, или ноль в противном случае.	Допустимо при указании шрифта.
FontMaxWidth	Задайте максимальный приращение символов для всех глифов в шрифте.	Допустимо при указании шрифта.
FontStrikeThru	Установите значение 1, если для текущего шрифта включена зачеркивная, или ноль в противном случае.	Допустимо при указании шрифта.
FontUnderLine	Задайте значение 1, если текущий шрифт подчеркнут, или ноль в противном случае.	Допустимо при указании шрифта.
FontWidth	Ширина текущего шрифта в master единицах.	Допустимо при указании шрифта.
GraphicsXRes	Текущее горизонтальное разрешение для графики в DPI.	Допустимо при выполнении задания печати.
GraphicsYRes	Текущее вертикальное разрешение для графики в DPI.	Допустимо при выполнении задания печати.
GrayPercentage	Уровень серого (в процентах) для серой заливки.	Допустимо для использования в командных строках CmdRectGrayFill.
GreenValue	Зеленый компонент текущего цвета.	Допустимо для использования в командных строках CmdDefinePaletteEntry (см. раздел BlueValue, RedValue).
LinefeedSpacing	Объем вертикального пространства в master единицах, представляющих канал линий.	Допустимо для использования в командных строках CmdSetLineSpacing.
NextFontID	Идентификационный номер следующего мягкого шрифта для скачивания.	Допустимо для использования в командных строках CmdSetFontID.
Следующий Глиф	Двухбайтовый код следующего глифа для скачивания.	Допустимо для использования в командных строках CmdSetCharCode.
NumOfCopies	Количество копий, запрошенных пользователем.	Допустимо при выполнении задания печати.
NumOfDataBytes	Количество байтов растровых данных, готовых к передаче.	Допустимо для использования в любой командной строке CmdSendXXXData. Если данные сжаты, значением является число байтов после сжатия.
PageNumber	Номер страницы, выполняемой в данный момент. Обратите внимание, что это не обязательно соответствует номеру страницы приложения, а количеству вызовов DrvSendPage . Это значение инициализируется с помощью DrvStartDoc и увеличивается с помощью DrvSendPage. Например, если выбрано значение N-up = 4, pageNumber увеличивается до 2 только при печати пятой страницы документа. В качестве другого примера, если документ печатается в обратном порядке (обратно на передний план), стандартная переменная PageNumber по-прежнему сообщает первую страницу для печати как страницу 1, несмотря на то, что это последняя страница документа. Это необходимо для правильной поддержки функции автоматического дуплексирования. Изготовитель оборудования должен использовать PageNumber только для определения того, является ли текущая страница передней или задней.	Допустимо при выполнении задания печати.
PaletteIndexToProgram	Индекс в цветовой палитре для следующей записи в программе.	Допустимо для использования в командных строках CmdDefinePaletteEntry. (См. также RedValue, GreenValue, BlueValue, CurrentPaletteIndex).
PatternBrushID	Идентификационный номер загруженной кисти шаблона.	Допустимо для использования с командными строками CmdDownloadPattern и CmdSelectPattern.
PatternbrushSize	Размер (в байтах) текущей кисти шаблона.	Допустимо для использования с командной строкой CmdDownloadPattern.
PatternBrushType	Тип текущей кисти шаблона. Значение может быть: 2: шаблон заливки 3: шаблон перекрестной штриховки 4: определяемый пользователем шаблон.	Допустимо для использования с командными строками CmdDownloadPattern и CmdSelectPattern.
PhysPaperLength	Длина бумаги, используемой в настоящее время, в книжном режиме в master единицах.	Допустимо при выполнении задания печати.
PhysPaperWidth	Книжная ширина бумаги, используемой в настоящее время, в master единицах.	Допустимо при выполнении задания печати.
PrintDirInCCDegrees	Величина поворота, измеряемая против часовой стрелки, в градусах.	Допустимо, когда драйвер отправляет командную строку CmdSetSimpleRotation или CmdSetAnyRotation.
RasterDataHeightInPixels	Высота (в пикселях) изображения, представленного текущими данными.	Допустимо для использования в любой командной строке CmdSendXXXData и в командных строках CmdSetSrcBmpHeight. Сжатие не изменяет это значение.
RasterDataWidthInBytes	Число байтов, содержащихся в строке сканирования.	Допустимо для использования в любой командной строке CmdSendXXXData и в командных строках CmdSetSrcBmpWidth. Сжатие не изменяет это значение.
RectXSize	Ширина прямоугольника в x-master единицах.	Допустимо для использования в командных строках CmdSetRectWidth.
RectYSize	Длина прямоугольника в единицах Y-master.	Допустимо для использования в командных строках CmdSetRectHeight.
RedValue	Красный компонент текущего цвета.	Допустимо для использования в командных строках CmdDefinePaletteEntry (см. раздел GreenValue, BlueValue).
TextXRes	Текущее горизонтальное разрешение текста в DPI.	Допустимо при выполнении задания печати.
TextYRes	Текущее вертикальное разрешение текста в DPI.	Допустимо при выполнении задания печати.