perintah put

  • Artikel

Perintah put menentukan area gambar sumber dan jendela tujuan yang digunakan untuk tampilan. Perangkat digital-video dan video-overlay mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendString dengan parameter lpszCommand yang ditetapkan sebagai berikut.

_stprintf_s(
  lpszCommand, 
  TEXT("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
);

Parameter

lpszDeviceID

Pengidentifikasi perangkat MCI. Pengidentifikasi atau alias ini ditetapkan saat perangkat dibuka.

lpszRegions

Bendera untuk menentukan area. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah put dan bendera yang digunakan oleh setiap jenis.

Nilai Makna Makna
digitalvideo tujuan tujuan pada bingkai persegi panjangpada sumber sumber persegi panjangpada persegi panjang video video di jendela persegi panjangpada klien jendela klien jendela persegi panjangpada persegi panjang
Overlay tujuan tujuan pada bingkai persegi panjangpada persegi panjang sumber sumber pada video persegi panjangpada persegi panjang

Tabel berikut mencantumkan bendera yang dapat ditentukan dalam parameter lpszRegions dan maknanya.

Nilai Makna
tujuan Memilih seluruh area klien dari jendela tujuan untuk menampilkan data.
tujuan pada persegi panjang Memilih sebagian area klien dari jendela tujuan yang digunakan untuk menampilkan gambar. Ketika area jendela tampilan ditentukan dan perangkat mendukung peregangan, gambar sumber direntangkan ke offset dan jangkauan tujuan.
Frame Memilih seluruh buffer bingkai untuk menerima gambar video masuk.
bingkai pada persegi panjang Memilih sebagian buffer bingkai untuk menerima gambar video masuk.
sumber Memilih seluruh gambar untuk ditampilkan di jendela tujuan.
sumber pada persegi panjang Memilih sebagian gambar untuk ditampilkan di jendela tujuan. Ketika area gambar sumber ditentukan, dan perangkat mendukung peregangan, gambar sumber direntangkan ke offset dan jangkauan tujuan.
Video Memilih seluruh gambar video masuk untuk diambil dalam buffer bingkai.
video pada persegi panjang Memilih sebagian gambar video masuk untuk diambil di buffer bingkai.
jendela Memulihkan ukuran jendela awal pada tampilan. Perintah ini juga menampilkan jendela.
jendela pada persegi panjang Mengubah ukuran dan lokasi jendela tampilan. Persegi panjang yang ditentukan relatif terhadap jendela induk jendela tampilan (biasanya desktop) jika bendera "gaya anak" telah digunakan untuk perintah terbuka . Untuk mengubah lokasi jendela tanpa mengubah tinggi atau lebarnya, tentukan nol untuk tinggi dan lebar.
klien jendela Memulihkan area klien jendela.
klien jendela pada persegi panjang Mengubah ukuran dan lokasi area klien jendela. Persegi panjang yang ditentukan relatif terhadap jendela induk jendela klien. Untuk mengubah lokasi jendela tanpa mengubah tinggi atau lebarnya, tentukan nol untuk tinggi dan lebar.

Ketika bendera menyertakan persegi panjang, koordinat persegi panjang relatif terhadap asal jendela atau asal gambar, sebagaimana merujuk, dan ditentukan sebagai X1 Y1 X2 Y2. Koordinat X1Y1 menentukan sudut kiri atas, dan koordinat X2Y2 menentukan lebar dan tinggi persegi panjang.

lpszFlags

Bisa "tunggu", "beri tahu", atau keduanya. Untuk perangkat video digital, "pengujian" juga dapat ditentukan. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Perintah put menentukan satu atau beberapa persegi berikut saat bekerja dengan perangkat video-overlay:

  • Persegi panjang video menentukan wilayah gambar video masuk untuk diambil.
  • Persegi panjang bingkai menentukan wilayah buffer bingkai yang menerima gambar video masuk.
  • Persegi panjang sumber menentukan wilayah buffer bingkai mana yang disalin ke persegi tujuan.
  • Persegi panjang tujuan menentukan wilayah area klien jendela tampilan yang menerima gambar video.

Persegi panjang video terkait dengan persegi panjang bingkai dengan cara yang sama seperti persegi panjang sumber terkait dengan persegi panjang tujuan. Peregangan dapat terjadi dari persegi video ke persegi bingkai dan dari persegi panjang sumber ke persegi panjang tujuan. Tidak semua perangkat mendukung peregangan, dan peregangan harus diaktifkan (dengan menggunakan perintah set ).

Perintah berikut menentukan tiga wilayah untuk video, bingkai, dan sumber.

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

Wilayah dalam contoh ini didefinisikan sebagai berikut:

  • Wilayah 200 kali 200 piksel dari data video masuk, mulai dari 120 piksel asal dari sudut kiri atas, akan ditangkap ke buffer bingkai.
  • Data video akan ditempatkan di wilayah 200 dengan 200 piksel di sudut kiri atas buffer bingkai.
  • Transfer dilakukan dari wilayah 200 hingga 200 piksel di sudut kiri atas buffer bingkai ke jendela tujuan.

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

Terbuka

set