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]

Lihat juga

MCI

String Perintah MCI

Menangkap

list

Menempatkan

record

Reserve

set

setaudio

Jendela