Fungsi DrvLineTo (winddi.h)

Artikel
08/27/2023

Fungsi DrvLineTo menggambar garis kosmetik tunggal, solid, khusus bilangan bulat.

Sintaks

BOOL DrvLineTo(
  SURFOBJ  *pso,
  CLIPOBJ  *pco,
  BRUSHOBJ *pbo,
  LONG     x1,
  LONG     y1,
  LONG     x2,
  LONG     y2,
  RECTL    *prclBounds,
  MIX      mix
);

Parameter

pso

Arahkan ke struktur SURFOBJ yang menggambarkan permukaan untuk menggambar.

pco

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

pbo

Arahkan ke struktur BRUSHOBJ yang menentukan kuas yang akan digunakan saat menggambar garis.

x1

Tentukan koordinat bilangan bulat x dari titik awal baris.

y1

Tentukan koordinat bilangan bulat y dari titik awal baris.

x2

Tentukan koordinat x bilangan bulat dari titik akhir baris.

y2

Tentukan koordinat bilangan bulat y dari titik akhir baris.

prclBounds

Penunjuk ke struktur RECTL yang menentukan persegi panjang bilangan bulat yang mengikat garis yang tidak terklip. Driver yang mendukung gambar garis perangkat keras dapat menggunakan persegi panjang ini untuk dengan cepat menentukan apakah garis cocok dalam ruang koordinat yang cukup kecil untuk dirender oleh perangkat keras.

mix

Mode campuran yang mendefinisikan operasi raster latar depan dan latar belakang yang akan digunakan untuk sikat. Dalam panggilan ke DrvLineTo, nilai operasi raster latar depan dan latar belakang sama. Untuk informasi selengkapnya tentang mode campuran, lihat Keterangan.

Mengembalikan nilai

DrvLineTo mengembalikan TRUE jika berhasil; jika tidak, ia mengembalikan FALSE.

Keterangan

DrvLineTo adalah titik masuk opsional yang dapat disediakan driver sebagai pengoptimalan untuk panggilan aplikasi ke fungsi Win32 LineTo . Jika driver tidak menghubungkan DrvLineTo, atau jika driver mengembalikan FALSE dari panggilan ke fungsi ini, GDI akan secara otomatis memanggil DrvStrokePath sebagai gantinya. Driver yang telah mengaitkan DrvLineTo dapat memanggil EngLineTo ketika permukaan rendering adalah DIB.

Fungsi ini lebih sederhana daripada DrvStrokePath karena hanya mendukung titik akhir bilangan bulat dan garis kosmetik solid. GDI memiliki lebih sedikit overhead saat memanggil DrvLineTo alih-alih DrvStrokePath; akibatnya, DrvLineTo dimaksudkan untuk digunakan sebagai pengoptimalan sederhana oleh driver yang dapat mempercepat garis lebar nominal dalam perangkat keras.

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.