Fungsi DrvTextOut (winddi.h)

Artikel
08/27/2023

Fungsi DrvTextOut adalah titik masuk dari GDI yang memanggil driver untuk merender sekumpulan glyph pada posisi yang ditentukan.

Sintaks

BOOL DrvTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  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 untuk menempatkannya.

pfo

Arahkan ke struktur FONTOBJ untuk mengambil informasi tentang font dan glyph-nya.

pco

Penunjuk ke struktur CLIPOBJ yang menentukan wilayah klip tempat semua penyajian harus dilakukan. Pengandar tidak dapat mempengaruhi piksel apa pun di luar wilayah klip.

prclExtra

Penunjuk ke struktur RECTL. GDI selalu mengatur parameter ini ke NULL dalam panggilan ke fungsi ini. Ini harus diabaikan oleh driver.

prclOpaque

Penunjuk ke struktur RECTL yang mewakili persegi panjang buram tunggal. Persegi panjang ini 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 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.

mix

Mode campuran yang mendefinisikan operasi raster latar depan dan latar belakang yang akan digunakan untuk kuas yang ditunjuk pboFore . Untuk informasi selengkapnya tentang mode campuran, lihat Keterangan.

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika fungsi berhasil; jika tidak, itu adalah FALSE.

Keterangan

Parameter input ke DrvTextOut 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.

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 DrvTextOut menentukan set piksel glyph, set persegi panjang ekstra, persegi panjang buram, dan wilayah klip. Adalah tanggung jawab driver untuk menghitung dan kemudian merender set piksel latar depan dan buram.

GDI menjamin bahwa DrvTextOut dan DrvDestroyFont tidak pernah tumpang tindih; akibatnya, driver dapat mengandalkan informasi cache saat memproses panggilan DrvTextOut .

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

Ini adalah fungsi yang diperlukan secara kondisional.