struktur DDCAPS_DX3 (ddraw.h)
Struktur DDCAPS mewakili kemampuan perangkat keras yang diekspos melalui objek DirectDraw. Struktur ini berisi struktur DDSCAPS2 yang digunakan dalam konteks ini untuk menjelaskan jenis objek DirectDrawSurface apa yang dapat dibuat. Mungkin tidak mungkin untuk membuat semua permukaan yang dijelaskan oleh kemampuan ini secara bersamaan. Struktur ini digunakan dengan metode IDirectDraw7::GetCaps .
File header Ddraw.h berisi beberapa versi struktur ini (misalnya, DDCAPS_DX7). Untuk informasi selengkapnya tentang cara menentukan versi mana yang akan digunakan, lihat Keterangan.
Sintaks
typedef struct _DDCAPS_DX3 {
DWORD dwSize;
DWORD dwCaps;
DWORD dwCaps2;
DWORD dwCKeyCaps;
DWORD dwFXCaps;
DWORD dwFXAlphaCaps;
DWORD dwPalCaps;
DWORD dwSVCaps;
DWORD dwAlphaBltConstBitDepths;
DWORD dwAlphaBltPixelBitDepths;
DWORD dwAlphaBltSurfaceBitDepths;
DWORD dwAlphaOverlayConstBitDepths;
DWORD dwAlphaOverlayPixelBitDepths;
DWORD dwAlphaOverlaySurfaceBitDepths;
DWORD dwZBufferBitDepths;
DWORD dwVidMemTotal;
DWORD dwVidMemFree;
DWORD dwMaxVisibleOverlays;
DWORD dwCurrVisibleOverlays;
DWORD dwNumFourCCCodes;
DWORD dwAlignBoundarySrc;
DWORD dwAlignSizeSrc;
DWORD dwAlignBoundaryDest;
DWORD dwAlignSizeDest;
DWORD dwAlignStrideAlign;
DWORD dwRops[DD_ROP_SPACE];
DDSCAPS ddsCaps;
DWORD dwMinOverlayStretch;
DWORD dwMaxOverlayStretch;
DWORD dwMinLiveVideoStretch;
DWORD dwMaxLiveVideoStretch;
DWORD dwMinHwCodecStretch;
DWORD dwMaxHwCodecStretch;
DWORD dwReserved1;
DWORD dwReserved2;
DWORD dwReserved3;
DWORD dwSVBCaps;
DWORD dwSVBCKeyCaps;
DWORD dwSVBFXCaps;
DWORD dwSVBRops[DD_ROP_SPACE];
DWORD dwVSBCaps;
DWORD dwVSBCKeyCaps;
DWORD dwVSBFXCaps;
DWORD dwVSBRops[DD_ROP_SPACE];
DWORD dwSSBCaps;
DWORD dwSSBCKeyCaps;
DWORD dwSSBFXCaps;
DWORD dwSSBRops[DD_ROP_SPACE];
DWORD dwReserved4;
DWORD dwReserved5;
DWORD dwReserved6;
} DDCAPS_DX3;
Anggota
dwSize
Ukuran struktur, dalam byte. Anggota ini harus diinisialisasi sebelum struktur digunakan.
dwCaps
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan kemampuan perangkat keras dan driver.
DDCAPS_3D
Perangkat keras tampilan memiliki akselerasi 3-D.
DDCAPS_ALIGNBOUNDARYDEST
DirectDraw hanya mendukung persegi panjang tujuan overlay tersebut dengan sumbu x yang selaras dengan batas dwAlignBoundaryDest permukaan.
DDCAPS_ALIGNBOUNDARYSRC
DirectDraw hanya mendukung persegi panjang sumber overlay tersebut dengan sumbu x yang selaras dengan batas dwAlignBoundarySrc permukaan.
DDCAPS_ALIGNSIZEDEST
DirectDraw hanya mendukung persegi panjang tujuan overlay yang ukuran sumbu x, dalam piksel, adalah kelipatan dwAlignSizeDest .
DDCAPS_ALIGNSIZESRC
DirectDraw hanya mendukung persegi panjang sumber overlay yang ukuran sumbu x, dalam piksel, adalah kelipatan dwAlignSizeSrc .
DDCAPS_ALIGNSTRIDE
DirectDraw membuat permukaan memori tampilan yang memiliki perataan langkah yang sama dengan nilai dwAlignStrideAlign .
DDCAPS_ALPHA
Perangkat keras tampilan mendukung permukaan khusus alfa.
DDCAPS_BANKSWITCHED
Perangkat keras tampilan dialihkan bank dan berpotensi sangat lambat pada akses acak untuk menampilkan memori.
DDCAPS_BLT
Piranti keras tampilan mampu melakukan operasi transfer blok bit (bitblt).
DDCAPS_BLTCOLORFILL
Piranti keras tampilan mampu mengisi warna dengan blitter.
DDCAPS_BLTDEPTHFILL
Perangkat keras tampilan mampu mengisi z-buffer secara mendalam dengan blitter.
DDCAPS_BLTFOURCC
Piranti keras tampilan mampu menginversi ruang warna selama operasi bitblt.
DDCAPS_BLTQUEUE
Perangkat keras tampilan mampu melakukan operasi bitblt asinkron.
DDCAPS_BLTSTRETCH
Perangkat keras tampilan mampu meregangkan selama operasi bitblt.
DDCAPS_CANBLTSYSMEM
Piranti keras tampilan mampu mem-blit ke atau dari memori sistem.
DDCAPS_CANCLIP
Piranti keras tampilan mampu mengklip dengan blitting.
DDCAPS_CANCLIPSTRETCHED
Piranti keras tampilan mampu mengklip saat meregangkan blitting.
DDCAPS_COLORKEY
Mendukung beberapa bentuk kunci warna dalam operasi overlay atau bitblt. Informasi kemampuan kunci warna yang lebih spesifik dapat ditemukan di anggota dwCKeyCaps .
DDCAPS_COLORKEYHWASSIST
Kunci warna sebagian dibantu perangkat keras. Ini berarti bahwa sumber daya lain (CPU atau memori video) mungkin digunakan. Jika bit ini tidak diatur, dukungan perangkat keras penuh tersedia.
DDCAPS_GDI
Piranti keras tampilan dibagikan dengan GDI.
DDCAPS_NOHARDWARE
Tidak ada dukungan perangkat keras.
DDCAPS_OVERLAY
Piranti keras tampilan mendukung overlay.
DDCAPS_OVERLAYCANTCLIP
Piranti keras tampilan mendukung overlay tetapi tidak dapat mengklipnya.
DDCAPS_OVERLAYFOURCC
Perangkat keras overlay mampu melakukan konversi ruang warna selama operasi overlay.
DDCAPS_OVERLAYSTRETCH
Perangkat keras overlay mampu meregangkan. Anggota dwMinOverlayStretch dan dwMaxOverlayStretch berisi data yang valid.
DDCAPS_PALETTE
DirectDraw mampu membuat dan mendukung objek DirectDrawPalette untuk permukaan selain permukaan utama.
DDCAPS_PALETTEVSYNC
DirectDraw mampu memperbarui palet yang disinkronkan dengan refresh vertikal.
DDCAPS_READSCANLINE
Piranti keras tampilan mampu mengembalikan baris pemindaian saat ini.
DDCAPS_VBI
Piranti keras tampilan mampu menghasilkan gangguan kosong vertikal.
DDCAPS_ZBLTS
Mendukung penggunaan z-buffer dengan operasi bitblt.
DDCAPS_ZOVERLAYS
Mendukung penggunaan metode IDirectDrawSurface7::UpdateOverlayZOrder sebagai nilai z untuk overlay untuk mengontrol lapisannya.
dwCaps2
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan lebih banyak kemampuan perangkat keras dan driver.
DDCAPS2_AUTOFLIPOVERLAY
Overlay dapat secara otomatis dibalik ke permukaan berikutnya dalam rantai membalik setiap kali port video VSYNC terjadi, memungkinkan port video dan overlay untuk buffer ganda video tanpa overhead CPU. Opsi ini hanya valid ketika permukaan menerima data dari port video. Jika data port video noninterlaced atau noninterleaved, itu membalik pada setiap VSYNC. Jika data sedang diselingi dalam memori, data akan membalik setiap VSYNC lainnya.
DDCAPS2_CANBOBHARDWARE
Perangkat keras overlay dapat menampilkan setiap bidang aliran video yang saling terkait satu per satu.
DDCAPS2_CANBOBINTERLEAVED
Perangkat keras overlay dapat menampilkan setiap bidang aliran video yang saling terkait satu per satu saat diselingi dalam memori tanpa menyebabkan artefak apa pun yang mungkin biasanya terjadi tanpa dukungan perangkat keras khusus. Opsi ini hanya valid ketika permukaan menerima data dari port video dan video diperbesar setidaknya dua kali ke arah vertikal.
DDCAPS2_CANBOBNONINTERLEAVED
Perangkat keras overlay dapat menampilkan setiap bidang aliran video yang saling terkait satu per satu sementara itu tidak diselingi dalam memori tanpa menyebabkan artefak apa pun yang mungkin biasanya terjadi tanpa dukungan perangkat keras khusus. Opsi ini hanya valid ketika permukaan menerima data dari port video dan video diperbesar setidaknya dua kali ke arah vertikal.
DDCAPS2_CANCALIBRATEGAMMA
Sistem ini memiliki calibrator yang terpasang yang dapat secara otomatis menyesuaikan ramp gamma sehingga hasilnya identik pada semua sistem yang memiliki kalibrasi. Untuk memanggil calibrator saat mengatur tingkat gamma baru, gunakan bendera DDSGR_CALIBRATE saat memanggil metode IDirectDrawGammaControl::SetGammaRamp . Mengkalibrasi gamma landai menimbulkan beberapa overhead pemrosesan dan tidak boleh sering digunakan.
DDCAPS2_CANDROPZ16BIT
Nilai RGBZ enam belas-bit dapat dikonversi menjadi nilai RGB 16-bit. (Sistem tidak mendukung konversi 8-bit.)
DDCAPS2_CANFLIPODDEVEN
Driver mampu melakukan operasi balik ganjil dan genap, seperti yang ditentukan oleh bendera DDFLIP_ODD dan DDFLIP_EVEN yang digunakan dengan metode IDirectDrawSurface7::Flip .
DDCAPS2_CANMANAGETEXTURE
Manajer tekstur Direct3D menggunakan kemampuan ini untuk memutuskan apakah akan menempatkan permukaan terkelola dalam memori video nonlokal. Jika kemampuan diatur, manajer tekstur menempatkan permukaan terkelola dalam memori video nonlokal. Driver yang tidak dapat tekstur dari memori video lokal tidak boleh mengatur kapabilitas ini.
DDCAPS2_CANRENDERWINDOWED
Driver mampu merender dalam mode berjendela.
DDCAPS2_CERTIFIED
Piranti keras tampilan bersertifikat.
DDCAPS2_COLORCONTROLPRIMARY
Permukaan utama berisi kontrol warna (misalnya, gamma).
DDCAPS2_COLORCONTROLOVERLAY
Permukaan overlay berisi kontrol warna (seperti kecerahan dan ketajaman).
DDCAPS2_COPYFOURCC
Driver mendukung blitting permukaan FOURCC apa pun ke permukaan lain dari FOURCC yang sama.
DDCAPS2_FLIPINTERVAL
Driver merespons bendera DDFLIP_INTERVAL*. (Untuk informasi selengkapnya tentang bendera ini, lihat IDirectDrawSurface7::Flip).
DDCAPS2_FLIPNOVSYNC
Driver merespons bendera DDFLIP_NOVSYNC (Untuk informasi selengkapnya tentang bendera ini, lihat IDirectDrawSurface7::Flip).
DDCAPS2_NO2DDURING3DSCENE
Operasi dua dimensi seperti IDirectDrawSurface7::Blt dan IDirectDrawSurface7::Lock tidak dapat dilakukan pada permukaan apa pun yang digunakan Direct3D antara panggilan ke metode BeginScene dan EndScene .
DDCAPS2_NONLOCALVIDMEM
Driver tampilan mendukung permukaan dalam memori video nonlokal.
DDCAPS2_NONLOCALVIDMEMCAPS
Kemampuan bitblt untuk permukaan memori video nonlokal berbeda dari permukaan memori video lokal. Jika bendera ini ada, bendera DDCAPS2_NONLOCALVIDMEM juga ada.
DDCAPS2_NOPAGELOCKREQUIRED
Operasi bitblt DMA didukung pada permukaan memori sistem yang tidak dikunci halaman.
DDCAPS2_PRIMARYGAMMA
Mendukung landaian gamma dinamis untuk permukaan utama.
DDCAPS2_STEREO
Baru untuk DirectX 7.0. Mengaktifkan bit dwSVCaps untuk mendukung mode stereo. Pengandar dapat melakukan stereo dalam setidaknya satu mode selain mode saat ini. Aplikasi ini dapat menggunakan IDirectDraw7::GetDisplayMode atau IDirectDraw7::EnumDisplayModes untuk mendapatkan informasi stereo per mode.
DDCAPS2_TEXMANINNONLOCALVIDMEM
Baru untuk DirectX 7.0. Manajer tekstur Direct3D menggunakan kemampuan ini untuk memutuskan apakah akan menempatkan permukaan terkelola dalam memori video nonlokal. Jika kemampuan diatur, manajer tekstur menempatkan permukaan terkelola dalam memori video nonlokal. Driver yang tidak dapat tekstur dari memori video lokal tidak boleh mengatur kapabilitas ini.
DDCAPS2_VIDEOPORT
Piranti keras tampilan mendukung video langsung.
DDCAPS2_WIDESURFACES
Permukaan layar mendukung permukaan yang lebih lebar dari permukaan utama.
dwCKeyCaps
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan kemampuan kunci warna.
DDCKEYCAPS_DESTBLT
Mendukung blitting transparan dengan kunci warna yang mengidentifikasi bit yang dapat diganti dari permukaan tujuan untuk warna RGB.
DDCKEYCAPS_DESTBLTCLRSPACE
Mendukung blitting transparan dengan ruang warna yang mengidentifikasi bit yang dapat diganti dari permukaan tujuan untuk warna RGB.
DDCKEYCAPS_DESTBLTCLRSPACEYUV
Mendukung blitting transparan dengan ruang warna yang mengidentifikasi bit yang dapat diganti dari permukaan tujuan untuk warna YUV.
DDCKEYCAPS_DESTBLTYUV
Mendukung blitting transparan dengan kunci warna yang mengidentifikasi bit yang dapat diganti dari permukaan tujuan untuk warna YUV.
DDCKEYCAPS_DESTOVERLAY
Mendukung overlaying dengan keying warna bit yang dapat diganti dari permukaan tujuan yang akan dilapisi untuk warna RGB.
DDCKEYCAPS_DESTOVERLAYCLRSPACE
Mendukung ruang warna sebagai kunci warna untuk tujuan warna RGB.
DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV
Mendukung ruang warna sebagai kunci warna untuk tujuan warna YUV.
DDCKEYCAPS_DESTOVERLAYONEACTIVE
Hanya mendukung satu nilai kunci warna tujuan aktif untuk permukaan overlay yang terlihat.
DDCKEYCAPS_DESTOVERLAYYUV
Mendukung overlaying, menggunakan keying warna dari bit yang dapat diganti dari permukaan tujuan yang akan dilapisi untuk warna YUV.
DDCKEYCAPS_NOCOSTOVERLAY
Menunjukkan bahwa tidak ada trade-off bandwidth untuk menggunakan kunci warna dengan overlay.
DDCKEYCAPS_SRCBLT
Mendukung blitting transparan, menggunakan kunci warna untuk sumber dengan permukaan ini untuk warna RGB.
DDCKEYCAPS_SRCBLTCLRSPACE
Mendukung blitting transparan, menggunakan ruang warna untuk sumber dengan permukaan ini untuk warna RGB.
DDCKEYCAPS_SRCBLTCLRSPACEYUV
Mendukung blitting transparan, menggunakan ruang warna untuk sumber dengan permukaan ini untuk warna YUV.
DDCKEYCAPS_SRCBLTYUV
Mendukung blitting transparan, menggunakan kunci warna untuk sumber dengan permukaan ini untuk warna YUV.
DDCKEYCAPS_SRCOVERLAY
Mendukung overlay, menggunakan kunci warna untuk sumber dengan permukaan overlay ini untuk warna RGB.
DDCKEYCAPS_SRCOVERLAYCLRSPACE
Mendukung overlay, menggunakan ruang warna sebagai kunci warna sumber untuk permukaan overlay untuk warna RGB.
DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV
Mendukung overlay, menggunakan ruang warna sebagai kunci warna sumber untuk permukaan overlay untuk warna YUV.
DDCKEYCAPS_SRCOVERLAYONEACTIVE
Hanya mendukung satu nilai kunci warna sumber aktif untuk permukaan overlay yang terlihat.
DDCKEYCAPS_SRCOVERLAYYUV
Mendukung overlay, menggunakan kunci warna untuk sumber dengan permukaan overlay ini untuk warna YUV.
dwFXCaps
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan kemampuan peregangan driver dan efek.
DDFXCAPS_BLTALPHA
Mendukung operasi bitblt alpha-blended.
DDFXCAPS_BLTARITHSTRETCHY
Menggunakan operasi aritmatika, bukan teknik pixel-doubling, untuk meregangkan dan menyusutkan permukaan selama operasi bitblt. Terjadi di sepanjang sumbu y (secara vertikal).
DDFXCAPS_BLTARITHSTRETCHYN
Menggunakan operasi aritmatika, bukan teknik pixel-doubling, untuk meregangkan dan menyusutkan permukaan selama operasi bitblt. Terjadi di sepanjang sumbu y (vertikal), dan hanya berfungsi untuk peregangan bilangan bulat (×1, ×2, dan sebagainya).
DDFXCAPS_BLTFILTER
Driver dapat melakukan pemfilteran rekonstruksi permukaan untuk bitblt warped.
DDFXCAPS_BLTMIRRORLEFTRIGHT
Mendukung pencerminan dari kiri ke kanan dalam operasi bitblt.
DDFXCAPS_BLTMIRRORUPDOWN
Mendukung pencerminan dari atas ke bawah dalam operasi bitblt.
DDFXCAPS_BLTROTATION
Mendukung rotasi arbitrer dalam operasi bitblt.
DDFXCAPS_BLTROTATION90
Mendukung rotasi 90 derajat dalam operasi bitblt.
DDFXCAPS_BLTSHRINKX
Mendukung penyusutan sekejap permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSHRINKXN
Mendukung penyusutan bilangan bulat (×1, ×2, dan sebagainya) permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSHRINKY
Mendukung penyusutan sekejap permukaan di sepanjang sumbu y (secara vertikal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSHRINKYN
Mendukung penyusutan bilangan bulat (×1, ×2, dan sebagainya) dari permukaan di sepanjang sumbu y (vertikal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSTRETCHX
Mendukung peregangan sembrono permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSTRETCHXN
Mendukung peregangan bilangan bulat (×1, ×2, dan sebagainya) dari permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSTRETCHY
Mendukung peregangan sebaris permukaan di sepanjang sumbu y (secara vertikal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTSTRETCHYN
Mendukung peregangan bilangan bulat (×1, ×2, dan sebagainya) permukaan di sepanjang sumbu y (vertikal). Bendera ini hanya berlaku untuk operasi bitblt.
DDFXCAPS_BLTTRANSFORM
Mendukung transformasi geometrik (atau warps) untuk sprite blitted. Transformasi saat ini tidak didukung untuk operasi bitblt eksplisit.
DDFXCAPS_OVERLAYALPHA
Mendukung penpaduan alfa untuk permukaan overlay.
DDFXCAPS_OVERLAYARITHSTRETCHY
Menggunakan operasi aritmatika, bukan teknik pixel-doubling, untuk meregangkan dan menyusutkan permukaan overlay. Terjadi di sepanjang sumbu y (secara vertikal).
DDFXCAPS_OVERLAYARITHSTRETCHYN
Menggunakan operasi aritmatika, bukan teknik pixel-doubling, untuk meregangkan dan menyusutkan permukaan overlay. Terjadi di sepanjang sumbu y (vertikal), dan hanya berfungsi untuk peregangan bilangan bulat (×1, ×2, dan sebagainya).
DDFXCAPS_OVERLAYFILTER
Mendukung pemfilteran rekonstruksi permukaan untuk sprite overlay yang dilapisi. Pemfilteran saat ini tidak didukung untuk permukaan overlay yang ditampilkan secara eksplisit (yang ditampilkan dengan panggilan ke IDirectDrawSurface7::UpdateOverlay).
DDFXCAPS_OVERLAYMIRRORLEFTRIGHT
Mendukung pencerminan overlay di seluruh sumbu vertikal.
DDFXCAPS_OVERLAYMIRRORUPDOWN
Mendukung pencerminan overlay di seluruh sumbu horizontal.
DDFXCAPS_OVERLAYSHRINKX
Mendukung penyusutan sekejap permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; itu tidak menunjukkan bahwa penyusutan tersedia.
DDFXCAPS_OVERLAYSHRINKXN
Mendukung penyusutan bilangan bulat (×1, ×2, dan sebagainya) permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; itu tidak menunjukkan bahwa penyusutan tersedia.
DDFXCAPS_OVERLAYSHRINKY
Mendukung penyusutan sekejap permukaan di sepanjang sumbu y (secara vertikal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; itu tidak menunjukkan bahwa penyusutan tersedia.
DDFXCAPS_OVERLAYSHRINKYN
Mendukung penyusutan bilangan bulat (×1, ×2, dan sebagainya) dari permukaan di sepanjang sumbu y (vertikal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; itu tidak menunjukkan bahwa penyusutan tersedia.
DDFXCAPS_OVERLAYSTRETCHX
Mendukung peregangan sembrono permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; tidak menunjukkan bahwa peregangan tersedia.
DDFXCAPS_OVERLAYSTRETCHXN
Mendukung peregangan bilangan bulat (×1, ×2, dan sebagainya) dari permukaan di sepanjang sumbu x (horizontal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; tidak menunjukkan bahwa peregangan tersedia.
DDFXCAPS_OVERLAYSTRETCHY
Mendukung peregangan sebaris permukaan di sepanjang sumbu y (secara vertikal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; tidak menunjukkan bahwa peregangan tersedia.
DDFXCAPS_OVERLAYSTRETCHYN
Mendukung peregangan bilangan bulat (×1, ×2, dan sebagainya) permukaan di sepanjang sumbu y (vertikal). Bendera ini hanya berlaku untuk permukaan DDSCAPS_OVERLAY. Bendera ini hanya menunjukkan kemampuan permukaan; tidak menunjukkan bahwa peregangan tersedia.
DDFXCAPS_OVERLAYTRANSFORM
Mendukung transformasi geometrik (atau warps) untuk sprite overlay. Transformasi saat ini tidak didukung untuk permukaan overlay yang ditampilkan secara eksplisit (yang ditampilkan dengan panggilan ke IDirectDrawSurface7::UpdateOverlay).
dwFXAlphaCaps
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan kemampuan alfa driver.
DDFXALPHACAPS_BLTALPHAEDGEBLEND
Mendukung perpaduan alfa di sekitar tepi permukaan bertanda warna sumber. Digunakan untuk operasi bitblt.
DDFXALPHACAPS_BLTALPHAPIXELS
Mendukung informasi alfa dalam format piksel. Kedalaman bit informasi alfa dalam format piksel bisa 1, 2, 4, atau 8. Nilai alfa menjadi lebih buram saat nilai alfa meningkat. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai yang sepenuhnya transparan. Digunakan untuk operasi bitblt.
DDFXALPHACAPS_BLTALPHAPIXELSNEG
Mendukung informasi alfa dalam format piksel. Kedalaman bit informasi alfa dalam format piksel bisa 1, 2, 4, atau 8. Nilai alfa menjadi lebih transparan saat nilai alfa meningkat. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai buram sepenuhnya. Bendera ini hanya dapat digunakan jika DDCAPS_ALPHA diatur. Digunakan untuk operasi bitblt.
DDFXALPHACAPS_BLTALPHASURFACES
Mendukung permukaan khusus alfa. Kedalaman bit permukaan khusus alfa bisa 1, 2, 4, atau 8. Nilai alfa menjadi lebih buram saat nilai alfa meningkat. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai yang sepenuhnya transparan. Digunakan untuk operasi bitblt.
DDFXALPHACAPS_BLTALPHASURFACESNEG
Menunjukkan bahwa saluran alfa menjadi lebih transparan saat nilai alfa meningkat. Kedalaman data saluran alfa bisa 1, 2, 4, atau 8. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai buram sepenuhnya. Bendera ini hanya dapat diatur jika DDCAPS_ALPHA telah ditetapkan. Digunakan untuk operasi bitblt.
DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND
Mendukung penpaduan alfa di sekitar tepi permukaan bertanda warna sumber. Digunakan untuk overlay.
DDFXALPHACAPS_OVERLAYALPHAPIXELS
Mendukung informasi alfa dalam format piksel. Kedalaman bit informasi alfa dalam format piksel bisa 1, 2, 4, atau 8. Nilai alfa menjadi lebih buram saat nilai alfa meningkat. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai yang sepenuhnya transparan. Digunakan untuk overlay.
DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG
Mendukung informasi alfa dalam format piksel. Kedalaman bit informasi alfa dalam format piksel bisa 1, 2, 4, atau 8. Nilai alfa menjadi lebih transparan saat nilai alfa meningkat. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai buram sepenuhnya. Bendera ini hanya dapat digunakan jika DDCAPS_ALPHA telah ditetapkan. Digunakan untuk overlay.
DDFXALPHACAPS_OVERLAYALPHASURFACES
Mendukung permukaan khusus alfa. Kedalaman bit permukaan khusus alfa bisa 1, 2, 4, atau 8. Nilai alfa menjadi lebih buram saat nilai alfa meningkat. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai yang sepenuhnya transparan. Digunakan untuk overlay.
DDFXALPHACAPS_OVERLAYALPHASURFACESNEG
Menunjukkan bahwa saluran alfa menjadi lebih transparan saat nilai alfa meningkat. Kedalaman data saluran alfa bisa 1, 2, 4, atau 8. Terlepas dari kedalaman informasi alfa, 0 selalu merupakan nilai buram sepenuhnya. Bendera ini hanya dapat digunakan jika DDCAPS_ALPHA telah ditetapkan. Digunakan untuk overlay.
dwPalCaps
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan kemampuan palet.
DDPCAPS_1BIT
Mendukung palet yang berisi entri warna 1-bit (dua warna).
DDPCAPS_2BIT
Mendukung palet yang berisi entri warna 2-bit (empat warna).
DDPCAPS_4BIT
Mendukung palet yang berisi entri warna 4-bit (16 warna).
DDPCAPS_8BIT
Mendukung palet yang berisi entri warna 8-bit (256 warna).
DDPCAPS_8BITENTRIES
Menentukan indeks ke indeks warna 8-bit. Bidang ini hanya valid saat digunakan dengan kemampuan DDPCAPS_1BIT, DDPCAPS_2BIT, atau DDPCAPS_4BIT dan ketika permukaan target adalah 8 bit per piksel (bpp). Setiap entri warna panjangnya 1 byte dan merupakan indeks ke palet 8-bpp di permukaan tujuan.
DDPCAPS_ALPHA
Mendukung palet yang menyertakan komponen alfa. Untuk palet berkemampuan alfa, anggota peFlags dari setiap struktur PALETTEENTRY yang dikandung palet harus ditafsirkan sebagai nilai alfa 8-bit tunggal (selain data warna di anggota peRed, peGreen, dan peBlue ). Palet yang dibuat dengan bendera ini hanya dapat dilampirkan ke permukaan tekstur.
DDPCAPS_ALLOW256
Mendukung palet yang dapat memiliki 256 entri yang ditentukan.
DDPCAPS_PRIMARYSURFACE
Palet melekat pada permukaan utama. Mengubah palet memiliki efek langsung pada tampilan kecuali kemampuan DDPCAPS_VSYNC ditentukan dan didukung.
DDPCAPS_PRIMARYSURFACELEFT
Palet melekat pada permukaan utama di sebelah kiri. Mengubah palet memiliki efek langsung pada tampilan kecuali kemampuan DDPCAPS_VSYNC ditentukan dan didukung.
DDPCAPS_VSYNC
Palet dapat dimodifikasi secara sinkron dengan kecepatan refresh monitor.
dwSVCaps
Nilai ini terdiri dari satu atau beberapa bendera berikut yang menentukan kemampuan stereo-vision.
DDSVCAPS_RESERVED1, DDSVCAPS_RESERVED2, DDSVCAPS_RESERVED3, DDSVCAPS_RESERVED4
Bendera yang dicadangkan.
DDSVCAPS_STEREOSEQUENTIAL
Baru untuk DirectX 7.0. Pengandar dapat melakukan stereo dalam setidaknya satu mode selain mode saat ini. Aplikasi ini dapat menggunakan IDirectDraw7::GetDisplayMode atau IDirectDraw7::EnumDisplayModes untuk mendapatkan informasi stereo per mode.
dwAlphaBltConstBitDepths
DDBD_2, DDBD_4, atau DDBD_8. (Menunjukkan 2, 4, atau 8 bit per piksel.)
dwAlphaBltPixelBitDepths
DDBD_1, DDBD_2, DDBD_4, atau DDBD_8. (Menunjukkan 1, 2, 4, atau 8 bit per piksel.)
dwAlphaBltSurfaceBitDepths
DDBD_1, DDBD_2, DDBD_4, atau DDBD_8. (Menunjukkan 1, 2, 4, atau 8 bit per piksel.)
dwAlphaOverlayConstBitDepths
DDBD_2, DDBD_4, atau DDBD_8. (Menunjukkan 2, 4, atau 8 bit per piksel.)
dwAlphaOverlayPixelBitDepths
DDBD_1, DDBD_2, DDBD_4, atau DDBD_8. (Menunjukkan 1, 2, 4, atau 8 bit per piksel.)
dwAlphaOverlaySurfaceBitDepths
DDBD_1, DDBD_2, DDBD_4, atau DDBD_8. (Menunjukkan 1, 2, 4, atau 8 bit per piksel.)
dwZBufferBitDepths
DDBD_8, DDBD_16, DDBD_24, atau DDBD_32. (Menunjukkan 8, 16, 24, atau 32 bit per piksel.) Anggota ini usang untuk DirectX 6.0 dan yang lebih baru. Gunakan IDirect3D7::EnumZBufferFormats untuk mengambil informasi tentang format buffer kedalaman yang didukung.
dwVidMemTotal
Jumlah total memori tampilan pada perangkat, dalam byte, dikurangi memori yang disediakan untuk permukaan utama dan struktur data privat apa pun yang disediakan oleh driver. (Nilai ini sama dengan total memori video yang dilaporkan oleh metode IDirectDraw7::GetAvailableVidMem .)
dwVidMemFree
Memori tampilan bebas. Nilai ini sama dengan nilai dalam dwVidMemTotal, dikurangi memori apa pun yang saat ini dialokasikan oleh aplikasi untuk permukaan. Tidak seperti metode IDirectDraw7::GetAvailableVidMem , yang melaporkan memori yang tersedia untuk jenis permukaan tertentu (seperti tekstur), nilai ini mencerminkan memori yang tersedia untuk semua jenis permukaan.
dwMaxVisibleOverlays
Jumlah maksimum overlay yang terlihat atau sprite overlay.
dwCurrVisibleOverlays
Jumlah overlay atau sprite overlay yang terlihat saat ini.
dwNumFourCCCodes
Jumlah kode FourCC.
dwAlignBoundarySrc
Perataan persegi panjang sumber untuk permukaan overlay, dalam piksel.
dwAlignSizeSrc
Perataan ukuran persegi panjang sumber untuk permukaan overlay, dalam piksel. Persegi panjang sumber overlay harus memiliki lebar piksel yang merupakan kelipatan dari nilai ini.
dwAlignBoundaryDest
Perataan persegi panjang tujuan untuk permukaan overlay, dalam piksel.
dwAlignSizeDest
Perataan ukuran persegi panjang tujuan untuk permukaan overlay, dalam piksel. Persegi panjang tujuan overlay harus memiliki lebar piksel yang merupakan kelipatan dari nilai ini.
dwAlignStrideAlign
Perataan langkah.
dwRops[DD_ROP_SPACE]
Operasi raster didukung.
ddsCaps
Struktur DDSCAPS2 yang berisi kemampuan permukaan umum.
dwMinOverlayStretch
Faktor peregangan overlay minimum, dikalikan dengan 1000. Misalnya, 1,3 = 1300.
dwMaxOverlayStretch
Faktor peregangan overlay maksimum, dikalikan dengan 1000. Misalnya, 1,3 = 1300.
dwMinLiveVideoStretch
Usang; jangan gunakan.
dwMaxLiveVideoStretch
Usang; jangan gunakan.
dwMinHwCodecStretch
Usang; jangan gunakan.
dwMaxHwCodecStretch
Usang; jangan gunakan.
dwReserved1
Telah dipesan
dwReserved2
Telah dipesan
dwReserved3
Telah dipesan
dwSVBCaps
Kemampuan khusus driver untuk bitblt dari memori sistem untuk menampilkan memori. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwCaps .
dwSVBCKeyCaps
Kemampuan kunci warna driver untuk bitblt dari memori sistem untuk menampilkan memori. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwCKeyCaps .
dwSVBFXCaps
Kemampuan FX driver untuk bitblt dari memori sistem untuk menampilkan memori. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwFXCaps .
dwSVBRops[DD_ROP_SPACE]
Operasi raster didukung untuk bitblt dari memori sistem untuk menampilkan memori.
dwVSBCaps
Kemampuan khusus driver untuk bitblt dari memori tampilan ke memori sistem. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwCaps .
dwVSBCKeyCaps
Kemampuan kunci warna driver untuk bitblt dari memori tampilan ke memori sistem. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwCKeyCaps .
dwVSBFXCaps
Kemampuan FX driver untuk bitblt dari memori tampilan ke memori sistem. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwFXCaps .
dwVSBRops[DD_ROP_SPACE]
Operasi raster didukung untuk bitblt dari memori tampilan ke memori sistem.
dwSSBCaps
Kemampuan khusus driver untuk bitblt dari memori sistem ke memori sistem. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwCaps .
dwSSBCKeyCaps
Kemampuan kunci warna driver untuk bitblt dari memori sistem ke memori sistem. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwCKeyCaps .
dwSSBFXCaps
Kemampuan FX driver untuk bitblt dari memori sistem ke memori sistem. Bendera yang valid identik dengan bendera terkait bitblt yang digunakan dengan anggota dwFXCaps .
dwSSBRops[DD_ROP_SPACE]
Operasi raster didukung untuk bitblt dari memori sistem ke memori sistem.
dwReserved4
Telah dipesan
dwReserved5
Telah dipesan
dwReserved6
Telah dipesan
Keterangan
Untuk kompatibilitas mundur, file header Ddraw.h berisi beberapa definisi struktur DDCAPS. Versi yang melewati praprosesor ditentukan oleh nilai konstanta DIRECTDRAW_VERSION.
Persyaratan
| Header | ddraw.h |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk