Variabel standar
Penting
Kami menyarankan agar Anda menggunakan driver kelas kotak masuk IPP Microsoft, bersama dengan Print Support Apps (PSA), untuk menyesuaikan pengalaman cetak di Windows 10 dan 11 untuk pengembangan perangkat printer.
Untuk informasi selengkapnya, lihat Panduan desain aplikasi dukungan cetak.
Bahasa GPD mendefinisikan sekumpulan variabel standar yang dapat dirujuk dalam string perintah, menggunakan format string perintah. Driver Unidrv menetapkan nilai ke variabel ini. Dari sudut pandang file GPD, variabel bersifat baca-saja.
Semua variabel standar disimpan sebagai bilangan bulat DWORD.
Entri perintah printer berikut menentukan string perintah yang dikirim ke HP LaserJet 4P ketika blok data raster siap:
*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"
Tabel berikut berisi semua variabel standar, dalam urutan alfabet.
| Nama Variabel Standar | Nilai | Komentar |
|---|---|---|
| BlueValue | Komponen biru warna saat ini. | Valid untuk digunakan dalam string perintah CmdDefinePaletteEntry (lihat GreenValue, RedValue). |
| CurrentFontID | Nomor identifikasi font lunak yang diunduh saat ini. | Valid jika tugas cetak saat ini mencakup font lunak yang diunduh. |
| CurrentPaletteIndex | Indeks saat ini ke palet warna. | Valid untuk digunakan dalam string perintah CmdSelectPaletteEntry (lihat GreenValue, RedValue). |
| CursorOriginX | Koordinat X asal kursor, di unit master. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| CursorOriginY | Koordinat Y asal kursor, di unit master. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| DestX | Koordinat X tujuan kursor, dalam unit master, relatif terhadap asal kursor. | Valid untuk digunakan dalam string perintah CmdXMoveAbsolute. |
| DestXRel | Koordinat X tujuan kursor, di unit master, relatif terhadap posisi kursor saat ini. | Valid untuk digunakan dalam string perintah CmdXMoveRelLeft dan CmdXMoveRelRight. |
| Desty | Koordinat Y tujuan kursor, di unit master, relatif terhadap asal kursor. | Valid untuk digunakan dalam string perintah CmdYMoveAbsolute. |
| DestYRel | Koordinat Y tujuan kursor, dalam unit master, relatif terhadap posisi kursor saat ini. | Valid untuk digunakan dalam string perintah CmdYMoveRelUp dan CmdYMoveRelDown. |
| FontBold | Atur ke satu jika font saat ini tebal, atau nol sebaliknya. | Valid ketika font telah ditentukan. |
| FontHeight | Tinggi, di unit master, dari font saat ini. | Valid ketika font telah ditentukan. |
| FontItalic | Atur ke satu jika font saat ini miring, atau nol sebaliknya. | Valid ketika font telah ditentukan. |
| FontMaxWidth | Atur ke kenaikan karakter maksimum semua glyph dalam font. | Valid ketika font telah ditentukan. |
| FontStrikeThru | Atur ke satu jika coretan diaktifkan untuk font saat ini, atau nol sebaliknya. | Valid ketika font telah ditentukan. |
| FontUnderLine | Atur ke satu jika font saat ini digarisbawaahkan, atau nol sebaliknya. | Valid ketika font telah ditentukan. |
| FontWidth | Lebar, dalam unit master, dari font saat ini. | Valid ketika font telah ditentukan. |
| GraphicsXRes | Resolusi horizontal saat ini untuk grafik, di DPI. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| GraphicsYRes | Resolusi vertikal saat ini untuk grafik, di DPI. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| GrayPercentage | Tingkat abu-abu (persentase) yang digunakan untuk isian abu-abu. | Valid untuk digunakan dalam string perintah CmdRectGrayFill. |
| NilaiHijau | Komponen hijau warna saat ini. | Valid untuk digunakan dalam string perintah CmdDefinePaletteEntry (lihat BlueValue, RedValue). |
| LinefeedSpacing | Jumlah ruang vertikal, dalam unit master, mewakili linefeed. | Valid untuk digunakan dalam string perintah CmdSetLineSpacing. |
| NextFontID | Nomor identifikasi font lunak berikutnya yang akan diunduh. | Valid untuk digunakan dalam string perintah CmdSetFontID. |
| NextGlyph | Kode dua byte dari glyph berikutnya untuk diunduh. | Valid untuk digunakan dalam string perintah CmdSetCharCode. |
| NumOfCopies | Jumlah salinan yang diminta oleh pengguna. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| NumOfDataBytes | Jumlah byte data raster yang siap ditransfer. | Berlaku untuk digunakan dalam string perintah CmdSendXXXData apa pun. Jika data dikompresi, nilainya adalah jumlah byte setelah pemadatan. |
| Nomor Halaman | Jumlah halaman yang sedang dicetak. Perhatikan bahwa ini tidak selalu sesuai dengan nomor halaman aplikasi, melainkan berapa kali DrvSendPage telah dipanggil. Nilai ini diinisialisasi oleh DrvStartDoc dan ditambahkan oleh DrvSendPage. Misalnya, jika N-up = 4 dipilih, PageNumber ditambahkan ke 2 hanya ketika halaman kelima dokumen sedang dicetak. Sebagai contoh lain, jika dokumen dicetak dalam urutan terbalik (kembali ke depan) variabel standar PageNumber masih melaporkan halaman pertama yang akan dicetak sebagai halaman 1, meskipun ini adalah halaman terakhir dokumen. Perilaku ini diperlukan untuk mendukung fitur dupleks otomatis dengan benar. OEM harus menggunakan PageNumber hanya untuk menentukan apakah halaman saat ini adalah sisi depan atau belakang. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| PaletteIndexToProgram | Indeks ke dalam palet warna untuk entri berikutnya ke program. | Valid untuk digunakan dalam string perintah CmdDefinePaletteEntry. (Lihat juga RedValue, GreenValue, BlueValue, CurrentPaletteIndex). |
| PatternBrushID | Nomor identifikasi kuas pola yang diunduh. | Valid untuk digunakan dengan string perintah CmdDownloadPattern dan CmdSelectPattern. |
| PatternBrushSize | Ukuran, dalam byte, dari kuas pola saat ini. | Valid untuk digunakan dengan string perintah CmdDownloadPattern. |
| PatternBrushType | Jenis kuas pola saat ini. Nilainya bisa: 2: Pola bayangan 3: Pola penetasan silang 4: Pola yang ditentukan pengguna. | Valid untuk digunakan dengan string perintah CmdDownloadPattern dan CmdSelectPattern. |
| PhysPaperLength | Panjang mode potret, dalam unit y-master, dari kertas yang saat ini digunakan. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| PhysPaperWidth | Lebar mode potret, dalam unit master, dari kertas yang saat ini digunakan. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| PrintDirInCCDegrees | Jumlah rotasi, diukur berlawanan arah jaga, dalam derajat. | Valid saat driver mengirim string perintah CmdSetSimpleRotation atau CmdSetAnyRotation. |
| RasterDataHeightInPixels | Tinggi, dalam piksel, gambar yang diwakili oleh data saat ini. | Berlaku untuk digunakan dalam string perintah CmdSendXXXData apa pun, dan dalam string perintah CmdSetSrcBmpHeight. Pemadatan tidak mengubah nilai ini. |
| RasterDataWidthInBytes | Jumlah byte yang terkandung dalam baris pemindaian. | Berlaku untuk digunakan dalam string perintah CmdSendXXXData apa pun, dan dalam string perintah CmdSetSrcBmpWidth. Pemadatan tidak mengubah nilai ini. |
| RectXSize | Lebar persegi panjang, dalam unit x-master. | Valid untuk digunakan dalam string perintah CmdSetRectWidth. |
| Rectysize | Panjang persegi panjang, dalam unit y-master. | Valid untuk digunakan dalam string perintah CmdSetRectHeight. |
| Nilai Merah | Komponen merah warna saat ini. | Valid untuk digunakan dalam string perintah CmdDefinePaletteEntry (lihat GreenValue, BlueValue). |
| TextXRes | Resolusi horizontal saat ini untuk teks, di DPI. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
| TextYRes | Resolusi vertikal saat ini untuk teks, di DPI. | Valid setiap kali pekerjaan cetak sedang berlangsung. |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk