fungsi glAddSwapHintRectWIN

Fungsi panggilan balik glAddSwapHintRectWIN menentukan sekumpulan persegi panjang yang akan disalin oleh SwapBuffers.

Sintaks

void WINAPI glAddSwapHintRectWIN(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

Parameter

x

Koordinat x (koordinat dalam jendela) dari sudut kiri bawah persegi panjang wilayah petunjuk.

y

Koordinat y (koordinat di jendela) dari sudut kiri bawah persegi panjang wilayah petunjuk.

width

Lebar persegi panjang wilayah petunjuk.

height

Tinggi persegi panjang wilayah petunjuk.

Mengembalikan nilai

Fungsi ini tidak mengembalikan nilai.

Keterangan

Fungsi glAddSwapHintRectWIN mempercepat animasi dengan mengurangi jumlah pengecatan ulang antar bingkai. Dengan glAddSwapHintRectWIN, Anda menentukan sekumpulan area persegi panjang yang ingin Anda salin saat memanggil SwapBuffers. Ketika Anda tidak menentukan persegi panjang apa pun dengan glAddSwapHintRectWIN sebelum memanggil SwapBuffers, seluruh framebuffer ditukar. Menggunakan glAddSwapHintRectWIN untuk menyalin hanya bagian buffer yang diubah dapat secara signifikan meningkatkan performa SwapBuffers, terutama ketika SwapBuffers diterapkan dalam perangkat lunak.

Fungsi glAddSwapHintRectWIN menambahkan persegi panjang ke wilayah petunjuk. Saat bendera PFD_SWAP_COPY struktur format piksel PIXELFORMATDESCRIPTOR diatur, SwapBuffers menggunakan wilayah ini untuk mengklip penyalinan buffer belakang ke buffer depan. Anda tidak menentukan PFD_SWAP_COPY; ini diatur oleh perangkat keras yang mampu. Wilayah petunjuk dibersihkan setelah setiap panggilan ke SwapBuffers. Dengan beberapa konfigurasi perangkat keras, SwapBuffers dapat mengabaikan wilayah petunjuk dan menukar seluruh buffer. SwapBuffers diimplementasikan oleh sistem, bukan oleh aplikasi.

OpenGL mempertahankan wilayah petunjuk terpisah untuk setiap jendela. Saat Anda memanggil glAddSwapHintRectWIN pada konteks penyajian apa pun yang terkait dengan jendela, persegi panjang petunjuk digabungkan ke dalam satu wilayah.

Panggil glAddSwapHintRectWIN dengan persegi panjang pembatas untuk setiap objek yang digambar untuk bingkai dan untuk setiap persegi yang dibersihkan untuk menghapus objek bingkai sebelumnya.

Catatan

Fungsi glAddSwapHintRectWIN adalah fungsi ekstensi yang bukan bagian dari pustaka OpenGL standar tetapi merupakan bagian dari ekstensi GL_WIN_swap_hint. Untuk memeriksa apakah implementasi OpenGL Anda mendukung glAddSwapHintRectWIN, panggil glGetString(GL_EXTENSIONS). Jika mengembalikan GL_WIN_swap_hint, glAddSwapHintRectWIN didukung. Untuk mendapatkan alamat fungsi ekstensi, panggil wglGetProcAddress.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Gl.h

Lihat juga

glGetString

PIXELFORMATDESCRIPTOR

SwapBuffers

wglGetProcAddress