Metode IMixerPinConfig::SetColorKey (mpconfig.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode SetColorKey ini mengatur kunci warna yang digunakan oleh aliran video.

Sintaks

HRESULT SetColorKey(
  [in] COLORKEY *pColorKey
);

Parameter

[in] pColorKey

Penunjuk ke struktur COLORKEY .

Nilai kembali

Mengembalikan HRESULT nilai.

Keterangan

Istilah kunci warna memiliki arti yang berbeda tergantung pada aliran mana yang dimaksudnya. Kunci warna aliran utama mengacu pada kunci warna tujuan yang digunakan oleh permukaan overlay. Kunci warna aliran sekunder mengacu pada kunci warna sumber yang digunakan, saat blitting dari permukaan di luar layar ke permukaan utama.

Aplikasi harus mengatur kunci warna pin utama ke warna yang tidak jelas (beberapa warna yang, dalam semua probabilitas, tidak akan ada di desktop). Filter mixer overlay akan mencoba memilih warna yang tidak jelas, tetapi jika aplikasi tahu bahwa warna yang ditentukan adalah bagian dari beberapa konten lain, maka aplikasi harus mengubahnya.

Mengatur kunci warna pada aliran sekunder dapat digunakan untuk membuat aliran transparan dan mengaktifkan gambar nonrektangular. Misalnya, jika aliran sekunder adalah teks teks dengan keterangan tertutup, maka dekoder teks teks tertutup harus melukis warna solid di latar belakang lalu mengatur kunci warna pada pin yang sesuai ke warna tersebut. Ini memastikan bahwa semua piksel ditransfer kecuali piksel yang ditentukan oleh kunci warna. Jika memungkinkan, aplikasi harus mengatur kunci warna aliran sekunder ke yang sama dengan aliran utama untuk memberikan sedikit keunggulan performa.

Mengatur nilai ini pada aliran utama mengatur kunci warna tujuan yang digunakan oleh permukaan overlay. Secara default, kunci warna tujuan digunakan sebagai kunci warna untuk semua aliran transparan (sekunder).

Argumen yang valid untuk parameter pColorKey mencakup CK_INDEX saat mode tampilan video diatur ke 256 warna, dan CK_RGB saat mode tampilan video diatur ke kedalaman warna yang lebih tinggi seperti hi-color, 24-bit, atau 32-bit. Bendera CK_RGB harus ditentukan bersama dengan CK_INDEX. Jika bendera CK_INDEX diatur, indeks akan digunakan sebagai indeks palet dalam mode warna 256. Tetapi Anda harus memberikan COLORREF dengan warna benar yang valid sehingga jika mode tampilan diubah dengan cepat, DirectShow dapat beralih menggunakan warna benar yang ditentukan. Ini karena sejumlah warna benar dapat dipetakan ke indeks palet tunggal, tetapi dengan cara lain dari indeks palet ke warna yang benar bukanlah satu-ke-satu.

Catatan Saat ini, metode ini hanya diimplementasikan untuk pin input utama.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mpconfig.h
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMixerPinConfig

IMixerPinConfig::GetColorKey