Fungsi EngTextOut (winddi.h)

Artikel
08/27/2023

Fungsi EngTextOut menyebabkan GDI merender sekumpulan glyph pada posisi yang ditentukan.

Sintaks

ENGAPI BOOL EngTextOut(
       SURFOBJ  *pso,
       STROBJ   *pstro,
       FONTOBJ  *pfo,
       CLIPOBJ  *pco,
       RECTL    *prclExtra,
       RECTL    *prclOpaque,
       BRUSHOBJ *pboFore,
       BRUSHOBJ *pboOpaque,
       POINTL   *pptlOrg,
  [in] MIX      mix
);

Parameter

pso

Penunjuk ke struktur SURFOBJ yang menjelaskan permukaan untuk menulis.

pstro

Penunjuk ke struktur STROBJ yang mendefinisikan glyph yang akan dirender dan posisi tempat mereka ditempatkan.

pfo

Penunjuk ke struktur FONTOBJ yang digunakan untuk mengambil informasi tentang font dan glyph-nya.

pco

Penunjuk ke struktur CLIPOBJ yang menentukan wilayah klip tempat penyajian harus dilakukan. Tidak ada piksel yang dapat dipengaruhi di luar wilayah klip ini.

prclExtra

Penunjuk ke struktur RECTL . Parameter ini harus selalu NULL.

prclOpaque

Penunjuk ke struktur RECTL yang mengidentifikasi persegi panjang buram tunggal yang eksklusif kanan bawah. Piksel dalam persegi panjang ini (yang bukan latar depan dan tidak terpotong) akan dirender dengan kuas buram. Persegi panjang ini selalu mengikat teks yang akan digambar. Jika parameter ini NULL, tidak ada piksel buram yang akan dirender.

pboFore

Penunjuk ke struktur BRUSHOBJ yang mewakili objek kuas yang akan digunakan untuk piksel latar depan. Kuas ini akan selalu menjadi kuas warna padat.

pboOpaque

Penunjuk ke struktur BRUSHOBJ yang mewakili objek kuas untuk piksel buram. Mode campuran latar depan dan latar belakang untuk kuas ini diasumsikan R2_COPYPEN. Kecuali driver mengatur kemampuan GCAPS_ARBRUSHOPAQUE bit di anggota flGraphicsCaps dari struktur DEVINFO , itu akan selalu dipanggil dengan kuas warna solid.

pptlOrg

Pointer ke struktur POINTL yang mendefinisikan asal kuas untuk kedua kuas. Jika parameter ini diatur ke 0 ketika EngTextOut dipanggil, beberapa driver printer mungkin salah mencetak gambar warna. Untuk informasi selengkapnya, lihat Keterangan.

[in] mix

Menentukan operasi raster latar depan dan latar belakang (mode campuran) untuk pboFore.

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika fungsi berhasil. Jika tidak, itu adalah FALSE, dan kode kesalahan dicatat.

Keterangan

Driver harus memanggil EngTextOut ketika telah menghubungkan DrvTextOut dan tidak dapat merender glyph.

Catatan Driver tidak dapat melakukan punt ke EngTextOut jika telah menghubungkan DrvTextOut untuk permukaan yang dikelola perangkat.

Parameter input ke EngTextOut menentukan dua set piksel: latar depan dan buram. Driver harus merender permukaan sehingga hasilnya identik dengan proses di mana piksel buram dirender terlebih dahulu dengan kuas buram, dan kemudian piksel latar depan dirender dengan kuas latar depan. Masing-masing operasi ini dibatasi oleh kliping.

Ketika parameter pptlOrg dari fungsi ini diatur ke 0, beberapa driver printer mencetak gambar warna salah di Microsoft Windows Server 2003 (versi Jepang). Mengatur pptlOrg ke 0, nilai penunjuk NULL , ditafsirkan berarti bahwa tidak ada asal kuas yang didefinisikan. Untuk mencegah masalah ini, inisialisasi pptlOrg dengan alamat struktur POINTL yang anggotanya diatur ke (0,0), sebelum panggilan ke EngTextOut.

Piksel latar depan dan buram dianggap sebagai layar di mana warna disikat ke permukaan. Glyph font tidak memiliki warna dalam diri mereka sendiri.

Parameter input ke EngTextOut menentukan sekumpulan piksel glyph, kumpulan persegi panjang tambahan, persegi panjang buram, dan wilayah klip. Driver harus menghitung dan kemudian merender set piksel latar depan dan buram.

Mode campuran menentukan bagaimana pola masuk harus dicampur dengan data yang sudah ada di permukaan perangkat. Jenis data MIX terdiri dari dua nilai ROP2 yang dikemas ke dalam satu ULONG. Byte urutan rendah mendefinisikan operasi raster latar depan; byte berikutnya mendefinisikan operasi raster latar belakang. Untuk informasi selengkapnya tentang kode operasi raster, lihat dokumentasi Microsoft Windows SDK.

Persyaratan


Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys