perintah setvideo
Perintah setvideo menetapkan nilai yang terkait dengan pemutaran dan pengambilan video. Perangkat digital-video dan VCR mengenali perintah ini.
Untuk mengirim perintah ini, panggil fungsi mciSendString dengan parameter lpszCommand yang ditetapkan sebagai berikut.
_stprintf_s(
lpszCommand,
TEXT("setvideo %s %s %s"),
lpszDeviceID,
lpszVideo,
lpszFlags
);
Parameter
-
lpszDeviceID
-
Pengidentifikasi perangkat MCI. Pengidentifikasi atau alias ini ditetapkan saat perangkat dibuka.
-
lpszVideo
-
Benderai untuk pemutaran dan pengambilan video. Tabel berikut mencantumkan jenis perangkat yang mengenali perintah setvideo dan bendera yang digunakan oleh setiap jenis.
Nilai Makna Makna digitalvideo algoritma algoritmabitsperpel untuk menghitung kecerahan untuk memperhitungkanclocktimecolor untuk memperhitungkan kontras dengan faktor gamma ke nilaihalftoneinputkey warna ke r:g:bindeks kunci untuk mengindeksoffonoutput selama warna palet durasidi atas indekske gagang palet newrgb untuk menanganikecepatan bingkai rekaman deskriptorkualitas untuk menilaioffsharpness rekaman onrecord untuk memperhitungkan sumber ke nilaiangka sumberyang masih algoritma algoritmamasih kualitas aliran deskriptorkualitas ke warna angkauntuk diperhitungkan Vcr offonmonitor untuk mengetiknomor rekamanoffrecord trek track_number nonaktif record onrecord track track_number onsource untuk mengetik nomor trek nomortrack_numberofftrack track_number aktif Tabel berikut mencantumkan bendera yang dapat ditentukan dalam parameter lpszVideo dan maknanya.
Nilai Makna algoritma algoritma Menentukan algoritma kompresi video untuk digunakan oleh perintah cadangan atau rekaman berikutnya. Algoritma yang didukung oleh perangkat bersifat spesifik untuk perangkat. MCI mendefinisikan konstanta "mpeg" dan "h261" untuk algoritma. Jika algoritma yang ditentukan bertentangan dengan format file saat ini, format file diubah ke format default untuk algoritma. bitsperpel untuk dihitung Mengatur jumlah bit per piksel untuk menyimpan data dengan perintah ambil atau rekam . kecerahan ke faktor Mengatur tingkat kecerahan video. clocktime Menunjukkan bahwa waktu yang ditentukan dalam bendera "lebih" dalam milidetik. Waktunya mutlak dan tidak selangkah dengan bermain ruang kerja. warna ke faktor Mengatur tingkat saturasi warna. kontras dengan faktor Mengatur tingkat kontras video. gamma ke nilai Menentukan eksponen koreksi gamma dikalikan dengan 1000. Misalnya, untuk menentukan eksponen 2,2, gunakan 2200 untuk nilai. Nilai gamma 1,0 (1000) menunjukkan tidak ada koreksi gamma yang diterapkan. Koreksi Gamma menyesuaikan pemetaan antara intensitas yang dikodekan dalam sumber presentasi dan kecerahan yang ditampilkan. halftone Menyebabkan palet halftone digunakan alih-alih palet default. Bendera ini hanya dikenali oleh driver video digital MCIAVI. input Memodifikasi bendera "brightness", "color", "contrast", "gamma", "sharpness", atau "tint" sehingga mempengaruhi sinyal input dan memodifikasi apa yang direkam. Jika memungkinkan, ini adalah default saat memantau input. warna kunci ke r:g:b Mengatur warna kunci. Variabel r:g:b adalah nilai RGB. Titik dua (:) pisahkan nilai merah, hijau, dan biru individual. indeks kunci untuk diindeks Mengatur indeks kunci. Variabel indeks adalah indeks palet fisik. pantau untuk mengetiknomor Mengontrol input sumber mana yang akan diteruskan ke output VCR, tanpa mengubah pilihan input sumber rekaman. Jenis dapat berupa "output", atau salah satu sumber input yang valid. Jika "angka" tidak ditentukan, maka input pertama dari jenis tersebut dipilih. offon Mengaktifkan atau menonaktifkan tampilan video. Menonaktifkan video mengatur piksel di persegi panjang "tujuan" (atau defaultnya, wilayah klien jendela saat ini) ke warna solid. Ini tidak berpengaruh pada buffer bingkai. Sumber video, baik ruang kerja atau input eksternal, mungkin terus menyimpan gambar baru di buffer bingkai. Mereka tidak ditampilkan sampai video diaktifkan. Anda dapat menggunakan perintah "state" jendela untuk menyembunyikan jendela. Defaultnya adalah setvideo "on". output Memodifikasi bendera "brightness", "color", "contrast", "gamma", "sharpness", atau "tint" sehingga hanya memodifikasi sinyal yang ditampilkan dan bukan apa yang direkam. Jika memungkinkan, ini adalah default saat memantau file. lebih dari durasi Menentukan berapa lama waktu yang diperlukan untuk membuat perubahan yang menggunakan variabel faktor . Unit untuk durasi berada dalam format waktu saat ini. Perubahan terjadi pada langkah dengan pemutaran ruang kerja. Saat bermain ditangguhkan, perubahan juga ditangguhkan sampai pemutaran berlanjut. Jika "over" tidak digunakan atau tidak didukung, perubahan akan segera terjadi. warna palet warna di atas indeks ke newrgb Mengatur warna palet baru. Indeks warna dan palet yang akan diubah ditentukan oleh parameter warna dan indeks ; warna baru ditentukan oleh newrgb. Bendera ini hanya dikenali oleh driver video digital MCIAVI. gagang palet untuk ditangani Menentukan handel ke palet yang harus digunakan perangkat untuk penyajian. Item ini hanya didukung oleh perangkat yang menggunakan palet. Jika handel adalah nol, palet default digunakan. Perangkat digital-video tidak boleh membebaskan palet yang diteruskan dengan perintah ini. Aplikasi harus membebaskannya setelah menutup perangkat. deskriptor kualitas Menentukan karakteristik kompresi video yang dilakukan saat video direkam ke file. Semua perangkat mendukung tiga deskriptor: "rendah", "sedang", dan "tinggi". Defaultnya adalah perangkat tertentu. Signifikansi nama-nama ini tergantung pada algoritma dan perangkat. Perangkat mungkin menentukan nama deskriptor tambahan. Perintah kualitas dapat digunakan untuk menentukan nama deskriptor tambahan. Jika bendera "algoritma" tidak digunakan, deskriptor berlaku untuk algoritma saat ini. laju bingkai rekaman ke laju Mengatur rekaman untuk video gerakan. Laju perekaman ditentukan dalam satuan bingkai per detik dikalikan 1000. Misalnya, kecepatan bingkai NTSC 29,97 bingkai per detik direpresentasikan sebagai 29970. rekaman onrecord nonaktif Mengaktifkan atau menonaktifkan perekaman data video. Merekam data video adalah default. track_number trek rekaman nonaktif Menghapus pilihan sumber video sehingga tidak ada video yang akan direkam dengan perintah rekaman berikutnya. "Track" memungkinkan pemilihan trek independen. Jika "track" tidak ditentukan, nilai default 1 diasumsikan. Mungkin perlu untuk terlebih dahulu mengeluarkan perintah "merakit rekaman mati" yang ditetapkan sebelum perekaman video dapat dimatikan. track_number trek rekaman aktif Memilih sumber video yang akan direkam dengan perintah rekaman berikutnya. "Track" memungkinkan pemilihan trek independen. Trek 2 sesuai dengan trek PCM di Hi8. Jika "track" tidak ditentukan, default 1 diasumsikan. ketajaman terhadap faktor Mengatur tingkat ketajaman video. sumber ke nilai nomor sumber Mengatur sumber input video. Ini biasanya sesuai dengan konektor eksternal. Konstanta yang ditentukan untuk sumber termasuk "rgb", "pal", "ntsc", "svideo", dan "secam". Jika ada lebih dari satu input dari jenis yang ditentukan, nilai "angka" opsional menunjukkan input yang diinginkan. Misalnya, setvideo "source to ntsc number 2" menentukan input NTSC kedua. Jika sumber "ke" dihilangkan, maka sumber absolut digunakan seperti yang didefinisikan oleh perintah daftar "sumber video". sumber untuk mengetiknomor Memilih sumber video yang akan direkam pada pita. Jenis harus "tuner", "line", "svideo", "aux", "generic", "mute", atau "rgb". algoritma algoritma masih Menentukan algoritma kompresi gambar diam yang digunakan oleh perintah ambil . Setiap perangkat harus mendukung algoritma "tidak ada", yang berarti tidak ada pemadatan. Ini adalah default. Dalam hal ini, perangkat video digital menyimpan gambar diam sebagai bitmap independen perangkat RGB. Perangkat mungkin juga mendukung daftar algoritma tambahan khusus perangkat. deskriptor kualitas masih Menentukan karakteristik kompresi gambar diam yang dilakukan saat menangkap gambar diam. Semua perangkat mendukung deskriptor "rendah", "sedang", dan "tinggi". Defaultnya adalah perangkat khusus. Jika bendera "algoritma" tidak digunakan, deskriptor berlaku untuk algoritma saat ini.
Perintah kualitas dapat digunakan untuk menentukan nama deskriptor lainnya.streaming ke angka Menentukan aliran video yang diputar kembali dari ruang kerja. Jika aliran tidak ditentukan dan aliran default tidak ditentukan oleh format file, maka aliran video yang diselingi pertama secara fisik diputar. warna ke faktor Mengatur warna gambar. Biasanya, penyesuaian ini dimodelkan setelah kontrol warna dari banyak set televisi warna, dengan 250 yang berarti hijau, 750 berarti merah, dan 0 (atau -
lpszFlags
-
Bisa berupa "tunggu", "beri tahu", "uji", atau kombinasi ini. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.
Tampilkan Nilai
Mengembalikan nol jika berhasil atau kesalahan sebaliknya.
Keterangan
Untuk perangkat VCR, menggunakan setvideo dengan bendera yang menonaktifkan trek individual ("lacak track_number nonaktif") dapat menyebabkan aplikasi Anda menerima pesan status yang menunjukkan bahwa perintah tidak dapat dilakukan. Beberapa VCR hanya dapat menonaktifkan kombinasi trek, bukan trek individual; misalnya, trek audio pertama dan trek video dari kaset video. Dalam hal ini, cukup gunakan setaudio dan setvideo untuk terus mematikan trek lain yang membentuk kombinasi. Driver akan mematikan trek ketika menerima perintah untuk mematikan trek terakhir dalam kombinasi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |