Fungsi DrvFillPath (winddi.h)

Artikel
08/27/2023

Fungsi DrvFillPath adalah titik masuk opsional untuk menangani pengisian jalur tertutup.

Sintaks

BOOL DrvFillPath(
  [in, out] SURFOBJ  *pso,
  [in]      PATHOBJ  *ppo,
  [in]      CLIPOBJ  *pco,
  [in]      BRUSHOBJ *pbo,
  [in]      POINTL   *pptlBrushOrg,
  [in]      MIX      mix,
  [in]      FLONG    flOptions
);

Parameter

[in, out] pso

Arahkan ke struktur SURFOBJ yang menentukan permukaan untuk menggambar.

[in] ppo

Penunjuk ke struktur PATHOBJ yang menentukan jalur yang akan diisi. Rutinitas layanan PATHOBJ_Xxx disediakan untuk menghitung garis, kurva Bezier, dan data lain yang membentuk jalur.

[in] pco

Penunjuk ke struktur CLIPOBJ . Rutinitas layanan CLIPOBJ_Xxx disediakan untuk menghitung wilayah klip sebagai satu set persegi panjang.

[in] pbo

Arahkan ke struktur BRUSHOBJ yang menentukan pola dan warna yang digunakan untuk mengisi jalur tertutup. Parameter ini harus didereferensikan hanya jika operasi pengisian yang ditentukan dalam campuran memerlukan penggunaan kuas. Misalnya, jika campuran diatur ke BLACKNESS, pbo tidak ditentukan dan tidak boleh didereferensikan.

[in] pptlBrushOrg

Pointer ke struktur POINTL yang mendefinisikan asal kuas, yang digunakan untuk menyelaraskan pola kuas pada perangkat.

[in] mix

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

[in] flOptions

Menentukan FP_WINDINGMODE, menunjukkan bahwa pengisian mode berliku harus dilakukan, atau FP_ALTERNATEMODE, menunjukkan bahwa pengisian mode alternatif harus dilakukan. Semua bendera lain harus diabaikan. Untuk informasi selengkapnya tentang mode ini, lihat Mode Isian Jalur.

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika driver dapat mengisi jalur. Jika jalur atau kliping terlalu kompleks untuk ditangani oleh driver dan harus ditangani oleh GDI, nilai yang dikembalikan adalah FALSE, dan kode kesalahan tidak dicatat. Jika driver mengalami kesalahan yang tidak terduga, seperti tidak dapat mewujudkan kuas, nilai yang dikembalikan DDI_ERROR, dan kode kesalahan dicatat.

Keterangan

GDI dapat memanggil DrvFillPath untuk mengisi jalur pada permukaan yang dikelola perangkat. Saat memutuskan apakah akan memanggil fungsi ini, GDI membandingkan persyaratan isi dengan bendera berikut di anggota flGraphicsCaps dari struktur DEVINFO : GCAPS_BEZIERS, GCAPS_ALTERNATEFILL, dan GCAPS_WINDINGFILL.

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.