struktur D3DDDIARG_COMPOSERECTS (d3dumddi.h)

Artikel
02/23/2024

Struktur D3DDDIARG_COMPOSERECTS menjelaskan parameter yang digunakan untuk menyusun area persegi panjang.

Sintaks

typedef struct _D3DDDIARG_COMPOSERECTS {
  [in] HANDLE                hSrcResource;
  [in] UINT                  SrcSubResourceIndex;
  [in] HANDLE                hDstResource;
  [in] UINT                  DstSubResourceIndex;
  [in] HANDLE                hSrcRectDescsVB;
  [in] UINT                  NumRects;
  [in] HANDLE                hDstRectDescsVB;
  [in] D3DDDI_COMPOSERECTSOP Operation;
  [in] INT                   XOffset;
  [in] INT                   YOffset;
} D3DDDIARG_COMPOSERECTS;

Anggota

[in] hSrcResource

Handel ke sumber daya sumber yang berisi permukaan sumber. Saat permukaan dibuat, driver tampilan mode pengguna menerima nilai D3DDDIFMT_A1 (satu bit per piksel) di anggota Format dan bendera bidang bit TextApi di anggota Bendera struktur D3DDDIARG_CREATERESOURCE dalam panggilan ke fungsi CreateResource driver. Permukaan harus dibuat sebagai bagian dari tekstur.

[in] SrcSubResourceIndex

Indeks ke permukaan sumber dalam sumber daya sumber.

[in] hDstResource

Handel ke sumber daya tujuan yang berisi permukaan tujuan. Saat permukaan dibuat, driver tampilan mode pengguna menerima nilai D3DDDIFMT_A1 (satu bit per piksel) di format anggotaD3DDDIARG_CREATERESOURCE dalam panggilan ke CreateResource driver. Permukaan harus dibuat sebagai bagian dari tekstur. Permukaan mungkin telah dibuat dengan bendera bit-field TextApi .

[in] DstSubResourceIndex

Indeks ke permukaan tujuan dalam sumber daya tujuan.

[in] hSrcRectDescsVB

Handel ke buffer vertex yang berisi array struktur D3DCOMPOSERECTSRCDESC. Setiap elemen dalam array mendefinisikan persegi panjang pada permukaan sumber. Saat buffer vertex dibuat, driver tampilan mode pengguna menerima bendera bidang bit TextApi di anggota Bendera struktur D3DDDIARG_CREATERESOURCE dalam panggilan ke fungsi CreateResource driver.

[in] NumRects

Jumlah area persegi panjang yang akan disalin, yang merupakan jumlah struktur D3DCOMPOSERECTDSTDESC dalam buffer vertex yang diidentifikasi oleh anggota hDstRectDescsVB . Driver harus mengabaikan panggilan ke ComposeRects dengan NumRects diatur ke lebih besar dari 0xFFFF.

[in] hDstRectDescsVB

Handel ke buffer vertex yang berisi array struktur D3DCOMPOSERECTDSTDESC. Setiap elemen dalam array menentukan tempat menyalin persegi sumber di permukaan tujuan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini. Saat buffer vertex dibuat, driver tampilan mode pengguna menerima bendera bidang bit TextApi di anggota Bendera struktur D3DDDIARG_CREATERESOURCE dalam panggilan ke fungsi CreateResource driver.

[in] Operation

Nilai D3DDDI_COMPOSERECTSOP yang menjelaskan cara menyusun area persegi panjang. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
D3DDDICOMPOSERECTS_COPY	Salin setiap bit sumber ke tujuan.
D3DDDICOMPOSERECTS_OR	Gabungkan bit sumber dan tujuan dalam operasi OR dan salin ke tujuan.
D3DDDICOMPOSERECTS_AND	Gabungkan bit sumber dan tujuan dalam operasi AND dan salin ke tujuan.
D3DDDICOMPOSERECTS_NEG	Gabungkan negatif bit sumber dengan bit tujuan dan salin ke tujuan. [Dest bit & (~ Src bit)]

[in] XOffset

Offset untuk ditambahkan ke koordinat x dari semua area persegi panjang tujuan. Offset bisa negatif, yang dapat menyebabkan persegi panjang yang dihasilkan ditolak atau diklip.

[in] YOffset

Offset untuk ditambahkan ke koordinat y dari semua area persegi panjang tujuan. Offset bisa negatif, yang dapat menyebabkan persegi panjang yang dihasilkan ditolak atau diklip.

Keterangan

Buffer vertex yang berisi instruksi penyusunan dibuat dengan penggunaan D3DUSAGE_TEXTAPI. Kode berikut mendefinisikan struktur yang terkandung dalam array buffer vertex. Untuk informasi selengkapnya tentang struktur ini, lihat dokumentasi DirectX SDK.

struct D3DCOMPOSERECTSRCDESC {
USHORT X, Y;          // Coordinates of top-left corner
USHORT width, height; // Width and height of the glyph in bits
};

struct D3DCOMPOSERECTDSTDESC {
USHORT RectDescIndex; // Index of one of the D3DCOMPOSERECTSRCDESC structures in the vertex buffer represented by hSrcRectDescsVB
USHORT reserved;      // Use to align the struct and fields to good boundaries
SHORT X, Y;            // Position in bits in the destination surface
};

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

ComposeRects

RECT

Bagikan melalui