Protokol Versi 1.2
Pendahuluan
mimoLive menggunakan teknologi Quartz Composer dari Apple dan dokumen-dokumennya untuk layer. Karena mimoLive perlu memberi tahu dokumen Quartz Composer beberapa parameter lingkungan serta hasil pembacaannya, kami merancang protokol yang harus Anda ikuti agar dapat memanfaatkan semua fitur yang ditawarkan mimoLive. Berikut ini, Anda akan menemukan semua informasi teknis tentang protokol ini.
Jika Anda ingin mempelajari cara membuat lapisan khusus dengan Quartz Composer, silakan baca "Membuat Lapisan Pelanggan untuk mimoLive":en:pro:custom_layer:creating_custom_layers.
Properti
Anda dapat mengedit protokol di Quartz Composer dengan memilih Editor ⇢ Edit informasi (⌥⌘I)
| Nama | Diperlukan | Jenis | Nilai Sampel |
|---|---|---|---|
| kategori | String | ||
| hak cipta | String | © 2016 MySoftwareCompany | |
| Deskripsi | String | Memutar input layar penuh | |
| nama | Ya. | String | Pemutar Layar Penuh |
| DIPERKOSONGKAN tv_Categories | String | Latar Belakang, Layar Penuh | |
| tv_Debug | Boolean | ||
| tv_FileData_ masukan nama- | Data | (file XML yang diimpor) | |
| tv_NamaFile_ masukan nama- | String | Klasemen.xml | |
| tv_HelpURL | String | ||
| tv_Tombol Masukan Tersembunyi | Array String | ||
| tv_InputLabel_ masukan nama- | String | Masukan Video | |
| tv_LayerIdentifier | Ya. | String | com.example.layer.mylayer |
| tv_LayerVersion | Ya. | Angka (nyata) | 1.01 |
| tv_LayerPreview | Data | (file PNG yang diimpor) | |
| tv_LayerProtocolVersion | Ya. | Angka (nyata) | 1 |
| tv_SortKey | String | ||
| Ukuran Langkah tv_ masukan nama- | Angka (nyata) | 0.1 | |
| DIPERKOSONGKAN tv_Tagline | String | Memutar input layar penuh | |
| tv_GunakanAudioDariSumber | String | tvIn_VideoSourceA | |
| tv_UnitLabel_ masukan nama- | String |
kategori
Kategori ini biasanya diatur oleh komposer Quartz dan tidak diperlukan untuk layer mimoLive. Untuk kategori mimoLive, lihat tv_Categories.
hak cipta
Hak cipta biasanya ditetapkan oleh komposer Quartz dan tidak diperlukan untuk lapisan mimoLive.
Deskripsi
Standar Quartz Composer - jaga agar panjangnya sekitar 3 baris supaya pas dalam pratinjau.
nama
Nama ditampilkan di dalam mimoLive. Gunakan nama yang singkat dan unik untuk menemukan layer Anda dengan cepat.
protokol
Array ini biasanya diatur oleh komposer Quartz dan tidak diperlukan untuk layer mimoLive.
tv_Categories
DISEGELAR
Kategori digunakan untuk mengelompokkan dan memfilter lapisan. Saat ini, kategori tersebut diabaikan, tetapi dapat diaktifkan kembali. Gunakan daftar yang dipisahkan dengan koma dari kategori yang sudah ditentukan berikut ini atau tentukan sendiri.
- "Audio" - Lapisan yang menyediakan kemungkinan untuk menggunakan sumber audio
- "Overlay" - Lapisan yang menghamparkan data atau gambar: Lower Thirds, Judul, Logo, ...
- "Layar Penuh" - Lapisan yang setidaknya melalui pengaturan default menyediakan layar penuh - misalnya Animasi, Video Tunggal, Peta Cuaca
- "Latar Belakang" - Lapisan yang berfungsi sebagai latar belakang/latar belakang untuk hal-hal lain di atasnya.
- "Teks" - Lapisan yang menyediakan semacam tampilan teks, misalnya Kredit, Lower Thirds, Heading
- "Data" - Lapisan yang menampilkan Data, misalnya ticker saham, skor bola basket, dll.
- "Gambar" - Lapisan yang menyediakan sarana untuk menampilkan dengan menggunakan input gambar statis
- "Multivideo" - Lapisan yang menggabungkan setidaknya dua sumber, baik dengan menambahkan setidaknya satu sumber sebagai tambahan pada lapisan di bawahnya atau menggunakan dua sumber atau lebih.
- "3D" - Lapisan yang menyediakan beberapa jenis pemosisian 3d elemen, misalnya Presenter
- "Segmen" - Lapisan yang menyediakan animasi berjangka waktu untuk memisahkan segmen, misalnya Beitrag Peningkatan Digital
- "Efek" - Lapisan yang menyediakan beberapa Efek hamparan, misalnya Kaca Pembesar, Sorotan, Zoom...
- "Demo" - Lapisan yang sebagian besar ditujukan untuk mendemonstrasikan kemampuan daripada menyediakan fungsionalitas umum yang berguna, misalnya."Konsumen" - Lapisan yang menggunakan compositedlayersimage, misalnya Video Switcher, Zoom, Presenter
- "Generator" - Lapisan yang menyediakan semacam output yang dihasilkan, misalnya Animasi
- "Debug" - Lapisan yang berguna untuk melakukan debug yang tidak terlihat pada produk akhir
tv_Debug
Memberitahu aplikasi bahwa komposisi ini hanya boleh digunakan dalam lingkungan debugging.
tv_FileData_
Gumpalan data yang akan dibuat dan dituliskan ke dalam dokumen untuk input file pada pembuatan layer. Ini berfungsi untuk file teks yang akan disediakan dalam _TypeFilePath atau file .mov untuk input gambar. Lihat tv_FileName_.
tv_NamaFile_
Nama file yang sesuai dengan tv_FileData_. Diperlukan jika input tv_FileData_* sudah ada.
tv_HelpURL
String ini dapat menyimpan URL dengan informasi yang berguna tentang cara menggunakan layer ini. mimoLive akan menampilkan tombol "?" pada popover informasi untuk setiap layer. Jika pengguna mengklik tombol ini, URL akan dibuka oleh peramban internet default sistem.
tv_Tombol Masukan Tersembunyi
Dalam array ini, komposisi menyimpan tombol input yang harus disembunyikan dari antarmuka pengguna.
tv_InputLabel_
Dapat digunakan untuk memberikan label nama alternatif untuk tombol input yang diberikan dalam tampilan parameter. String kosong tanpa label juga dimungkinkan. Berfungsi seperti tv_hide_ouput, misalnya nama input protokol harus lengkap (mis. "tv_InputLabel_tvIn_VideoSourceAImage").
tv_LayerIdentifier
Untuk identifikasi, Boinx mengirimkan komposisi dan mengurutkan versi yang berbeda. Harus unik. Domain dengan notasi terbalik direkomendasikan. Contoh: com.mysoftware.layers.videofullscreen
tv_LayerVersion
Untuk mencocokkan berbagai versi komposisi dalam dokumen/aplikasi. Nomor versi mayor menunjukkan ketidakcocokan dan tidak cocok dengan versi mayor lainnya (misalnya, Anda harus meningkatkan versi mayor jika nama tombol input berubah). Nomor versi minor harus kompatibel ke atas dan dapat bertambah 0,001 untuk setiap iterasi. Misalnya, harus dipastikan bahwa pengaturan pemuatan dari layer 1.0 untuk 1.013 harus terlihat sama persis, yang berarti kunci baru jika ada harus memiliki nilai default yang tidak menampilkannya atau sama dengan tampilan versi sebelumnya.
tv_LayerPreview
Data gambar yang akan digunakan untuk pratinjau layer di dalam daftar layer. Hal ini dapat memberikan pengalaman yang lebih baik daripada pratinjau tampilan cepat default. Gambar pratinjau harus berukuran 256 × 256 piksel.
tv_LayerProtocolVersion
Untuk kompatibilitas ke belakang di masa depan jika mimoLive mengubah protokol secara signifikan. Saat ini harus diatur ke 1.
tv_SortKey
Menentukan pengurutan layer di mimoLive. Jadi, Anda dapat mengurutkan filter berdasarkan probabilitas penggunaannya. Saat ini, skema yang digunakan adalah 2 huruf besar, misalnya, "BM", "DE", "DM", dll. CATATAN: Saat ini fitur ini tidak digunakan, tetapi akan digunakan di masa mendatang.
Ukuran Langkah tv_
Dapat digunakan untuk memberikan StepSize khusus untuk roda joging - gerakan mouse satu piksel kemudian sesuai dengan jumlah perubahan ini (juga +/- klik).
tv_Tagline
DEPRECATED
Satu baris string yang akan ditampilkan dalam popover info di repositori layer.
tv_GunakanAudioDariSumber
mimoLive saat ini hanya dapat menampilkan satu kontrol audio di antarmuka pengguna. Properti ini memberitahukan tombol input mana yang akan dikontrol. Isi dengan lengkap tombol input yang sesuai. (Untuk kompatibilitas ke belakang, bidang ini juga menerima "A", "B" atau "C" yang diterjemahkan ke kunci tvIn_VideoSourceAImage, tvIn_VideoSourceBImage, atau tvIn_VideoSourceCImage. Jika tidak disediakan, mimoLive mengasumsikan bahwa tidak ada audio yang akan digunakan dengan layer ini.
tv_UnitLabel_
Dapat digunakan untuk memberikan label unit, misalnya "pt" untuk tombol input yang diberikan dalam tampilan parameter. Buat sesingkat mungkin. Membantu mengkomunikasikan arti dari input. Input unit Boinx akan mendapatkan label "px" secara otomatis.
Masukan
| Nama | Jenis |
|---|---|
| tvIn_AkunTwitterKunciKonsumen | String |
| tvIn_AkunTwitterRahasiaKonsumen | String |
| tvIn_AkunTwitterTokenKey | String |
| tvIn_AkunTwitterTokenSecret | String |
| tvIn_CompositedLayersImage | Gambar |
| tvIn_FrameCount | Indeks |
| tvIn_FrameDuration | Nomor |
| tvIn_CompositedLayersImage | Gambar |
| tvIn_DalamArahTransisi | Indeks Arah Transisi Arah |
| tvIn_DurasiTransisi | Nomor |
| tvIn_InTransitionType | Indeks Jenis Transisi Jenis |
| tvIn_KeyboardModifierAlt | Boolean |
| tvIn_KeyboardModifierCommand | Boolean |
| tvIn_KeyboardModifierControl | Boolean |
| tvIn_KeyboardModifierFunction | Boolean |
| tvIn_KeyboardModifierShift | Boolean |
| tvIn_Kabur | Boolean |
| tvIn_OnAir | Boolean |
| tvIn_OSVersion | String |
| tvIn_OutTransitionDirection | Indeks Arah Transisi Arah |
| Durasi Transisi tvIn_Out | Nomor |
| Jenis Transisi tvIn_Out | Indeks Jenis Transisi Jenis |
| tvIn_PreviewMode | Boolean |
| tvIn_Reset | Boolean (Sinyal) |
| tvIn_RuntimeIdentifier | String |
| tvIn_Shared_ | semua jenis nilai |
| Durasi tayangan tvIn_Show | Nomor |
| tvIn_ShowTimer | Nomor |
| tvIn_Switch | Boolean (Sinyal) |
| tvIn_TransitionDirection | Indeks Arah Transisi Arah |
| tvIn_TransitionDuration | Nomor |
| tvIn_TransitionType | Indeks Jenis Transisi Jenis |
| tvIn_UISnapColor | Warna |
| tvIn_VideoSourceA B C D | Gambar |
tvIn_AkunTwitterKunciKonsumen
tvIn_AkunTwitterRahasiaKonsumen
tvIn_AkunTwitterTokenKey
tvIn_AkunTwitterTokenSecret
Keempat input AccountTwitter tersebut digunakan untuk memasukkan data login dari Preferensi Akun Twitter mimoLive ke dalam komposisi. Nilai-nilai tersebut digunakan dengan JSON Patch dan OAuth Patch Patch untuk membaca data dari layanan Twitter.
tvIn_CompositedLayersImage
Jika input ini ada dalam komposisi dan ada konten dari lapisan di bawahnya, hasil gambar lapisan di bawahnya akan dimasukkan ke dalam input ini.
tvIn_FrameCount
Masukan ini akan mendapatkan jumlah frame yang dirender setelah memulai mimoLive. Jika ada frame yang dibuang karena beban render terlalu tinggi, jumlah frame akan melompati jumlah frame yang dibuang tersebut.
tvIn_FrameDuration
Durasi frame adalah interval waktu antara setiap rendering dalam hitungan detik.
tvIn_DalamArahTransisi
Arah di mana Arah Transisi akan dilakukan.
tvIn_DurasiTransisi
Nilai dalam detik yang akan dilakukan oleh tvIn_InTransitionType.
tvIn_InTransitionType
Jika berguna untuk lapisan yang memungkinkan pengguna memilih jenis transisi yang sedang berlangsung. Juga, lihat Jenis Jenis Transisi.
tvIn_KeyboardModifierAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_KeyboardModifierFunction
tvIn_KeyboardModifierShift
Bidang input boolean tersebut akan ditetapkan ke true (benar) sewaktu pengguna menekan tombol pengubah yang sesuai pada keyboard. Fitur ini terutama digunakan untuk fitur manipulasi langsung. Silakan merujuk ke Baris Panduan Pengguna Manusia Apple untuk mengetahui tombol pengubah mana yang harus digunakan untuk fungsi apa di UI.
tvIn_Kabur
Masukan ini diatur ke true jika layer tidak perlu merender output apa pun karena layer di atasnya akan mengaburkannya dengan menggambar layar penuh. Hal ini dapat digunakan untuk menghindari gambar yang berat dari layer yang tidak terlihat tetapi diatur untuk ditayangkan. (Misalnya, dalam kasus lapisan Twitter, lapisan tersebut tetap dipanggil meskipun dikaburkan oleh lapisan lain di atasnya dan mendapat kesempatan untuk tetap terhubung ke layanan Twitter).
tvIn_OnAir
Masukan ini dimulai dengan nilai "true". Setelah input berubah menjadi "false", komposisi akan melakukan transisi keluar, lalu menetapkan output Done ketika selesai. Komposisi kemudian akan dinonaktifkan. Bisa saja terjadi bahwa aplikasi mematikan sebuah layer tanpa menunggu flag done.
tvIn_OSVersion
Masukan string ini akan diatur ke versi OS X saat ini (misalnya, "Versi 10.11.2 (Build 265341)").
tvIn_OutTransitionDirection
Nilai dalam detik dari tvIn_OutTransitionType akan dilakukan. Juga, lihat Arah Transisi.
Durasi Transisi tvIn_Out
Nilai dalam detik dari tvIn_OutTransitionType akan dilakukan.
Jenis Transisi tvIn_Out
Jika berguna untuk lapisan yang memungkinkan pengguna memilih jenis transisi yang sedang berlangsung. Juga, lihat Jenis Jenis Transisi.
tvIn_PreviewMode
Dapat digunakan untuk memberi tahu komposisi bahwa komposisi tersebut dalam mode pratinjau.
tvIn_Reset
Berguna untuk mengatur ulang Logika Komposisi. Bendera ini ditetapkan ketika layer dialihkan ke hidup dari mati atau ketika beralih di antara pengaturan dan tidak ada input tvIn_Switch yang tersedia.
tvIn_RuntimeIdentifier
Membantu lapisan untuk berkomunikasi antara pratinjau dan contoh langsung. Diatur secara dinamis oleh mimoLive.
tvIn_Shared_
Lihat Berbagi Nilai antar Lapisan Nilai antar Lapisan.
Durasi tayangan tvIn_Show
Jika pengguna mengisi durasi tayangan di Pengaturan Tampilkan, input ini akan memiliki nilai dalam detik.
tvIn_ShowTimer
Pengatur waktu tayang akan mencerminkan tampilan Pengatur Waktu Tayang dokumen mimoLive dalam hitungan detik.
tvIn_Switch
Bendera ini ditetapkan sebagai pengganti tvIn_Reset]] ketika layer dialihkan dari satu pengaturan ke pengaturan lain tanpa menonaktifkan layer. Jika masukan ini tidak ada, [[#tvIn_Reset ketika layer dialihkan dari satu pengaturan ke pengaturan lain tanpa menonaktifkan layer. Jika input ini tidak ada, [[#tvIn_Reset ditetapkan untuk menjaga kompatibilitas dengan lapisan yang lebih lama.
tvIn_TransitionDirection
Arah di mana Arah Transisi akan dilakukan.
tvIn_TransitionDuration
Nilai dalam detik dari tvIn_InTransitionType akan dilakukan.
tvIn_TransitionType
Jika berguna untuk lapisan yang memungkinkan pengguna memilih jenis transisi yang sedang berlangsung. Juga, lihat Jenis Jenis Transisi.
tvIn_UISnapColor
Untuk menjaga konsistensi UI, mimoLive menyediakan "warna jepretan" untuk menggambar panduan di pratinjau setiap kali UI dijepret ke nilai tertentu (misalnya, tahan tombol "shift" saat memutar lapisan Placer dalam mode tampilan khusus, maka panduan akan digambar dengan warna tersebut saat sudut rotasi dijepret ke 0, 45, atau 90 derajat)
tvIn_VideoSource
Sebuah layer dapat memiliki hingga 8 input sumber video dinamis: "A", "B", "C", dan seterusnya. Mereka akan diwakili oleh zona drop jika pengguna menyeret sumber video dari tempat penyimpanan sumber ke tumpukan layer. //Catatan: Untuk kompatibilitas ke belakang, ekstensi "Image" pada input tersebut diabaikan.//
Opsi Masukan
Tombol Input yang Sesuai
Jika ada tombol input video, tombol input berikut ini juga akan diisi dengan informasi yang sesuai:
(misalnya "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
| Kunci | Jenis | Deskripsi |
|---|---|---|
| AudioGain | Nomor | TBD |
| AudioLevel0 | Nomor | Level saluran audio kiri dalam db setelah kontrol penguatan |
| AudioLevel1 | Nomor | Tingkat saluran audio kanan dalam db setelah kontrol penguatan |
| AudioLevel0Raw | Nomor | Level saluran audio kiri dalam db sebelum kontrol penguatan |
| AudioLevel1Raw | Nomor | Tingkat saluran audio kanan dalam db sebelum kontrol penguatan |
| AudioPanning | Nomor | TBD |
| Volume Audio | Nomor | TBD |
| Data | Struktur | Kamus metadata dari sumber. Saat ini, kunci yang diimplementasikan adalah: "indeks" "durasi" "judul" "judulBalik" "artis" "album" "tahun" "pengenalRujukan file" |
| Nama | String | Nama sumber gambar yang terkait. Dapat digunakan untuk menampilkan namanya di pratinjau atau untuk menghitung nama default untuk varian layer. Lihat tvOut_SettingName . |
| SisaWaktu | Nomor | Dalam hitungan detik. Akan disediakan untuk sumber film. -1 jika sumber film diulang (atau sumber lainnya). |
| TallyState | Indeks | Status penghitungan sumber yang tersambung, lihat Negara Bagian Penghitungan Negara Bagian |
| Jenis | Indeks | Nilai jenis sumber Jenis |
Mengelompokkan Input
Pengelompokan disediakan di antarmuka pengguna - untuk itu awalan masukan yang relevan. Sintaksnya bekerja seperti tvGroup___. Harap perhatikan garis bawah ganda _ _ setelah nama grup sebagai pemisah ke nama input.
Grup khusus didefinisikan untuk input yang harus selalu disembunyikan: tvGroup_Hidden_Input__ Grup ini dapat dibuat terlihat dengan mengalihkan mimoLive ke mode debug di debug|Preferensi Debug|Preferensi Debug. Beberapa layer menggunakan bidang tersembunyi tersebut untuk berkomunikasi antara "Preview instance" dan "Live instance" (misalnya, layer Pengalih Video memberi tahu Preview instance tentang sumber video mana yang sedang ditayangkan).
Menyembunyikan Input Secara Dinamis
Setiap Input Protokol akan disembunyikan di UI jika Output tvOut_hide_ disetel ke "true". Nilai ini diamati oleh aplikasi dan dapat diubah secara dinamis. Perhatikan bahwa Anda harus menggunakan nama input lengkap, termasuk "tvIn" (misalnya, gunakan output tvOut_hide_tvIn_Text_TypeMultiline untuk input tvIn_Text_TypeMultiline).
Keluaran
| Nama | Jenis |
|---|---|
| tvOut_Cursor | String |
| tvOut_Done | Boolean (Sinyal) |
| tvOut_hide_ | Boolean |
| tvOut_Buram | Boolean |
| tvOut_SettingName | String |
| tvOut_Share_ | jenis apa saja |
| Sisa_Waktu_Habis | Nomor |
| tvOut_UseCompositedLayersImage | Boolean |
| tvOut_TallyState | Indeks Negara Bagian Penghitungan Negara Bagian |
| tvSet_ | Jenis input yang akan diatur |
| tvSetSignal_ | Boolean |
| tvSetAudioVolume_ | Nomor |
| tvSetAudioVolumeSignal_ | Boolean |
tvOut_Cursor
Output ini menentukan tampilan kursor mouse jika penunjuk mouse berada di atas pratinjau atau tampilan output program. Silakan lihat Dokumentasi Kelas NSCursor Apples) untuk nilai yang valid. Kursor mouse tambahan yang disediakan oleh mimoLive adalah "minus" dan "plus".
Hapus postfix "_Cursor" atau "Cursor" dari konstanta NSCursor Apple (misalnya, gunakan "openHand" untuk mendapatkan kursor mouse dengan tangan terbuka).
tvOut_Done
Digunakan untuk memberi tahu lapisan berikutnya bahwa lapisan ini sudah selesai. Lihat tvIn_OnAir untuk dokumentasi.
tvOut_hide_
Dapat digunakan untuk menyembunyikan nilai input secara dinamis dalam tampilan parameter. Lihat Sembunyikan Input Secara Dinamis.
tvOut_Buram
Digunakan untuk memberi tahu aplikasi bahwa lapisan di bawah lapisan ini tidak perlu digambar. Nilai default "false". Nilai ini akan menimpa semua sumber yang terhubung yang mengandung alpha.
tvOut_SettingName
Komposisi dapat menyarankan nama yang berguna untuk pengaturan berdasarkan beberapa masukan.
tvOut_Share_
Lihat Berbagi Nilai antar Lapisan .
Sisa_Waktu_Habis
Memungkinkan aplikasi untuk menampilkan hitungan mundur waktu yang besar (misalnya 5 detik sampai film selesai). Saat ini menggunakan "-1" untuk menunjukkan tidak ada informasi tentang waktu yang tersisa atau "-2" jika itu adalah film perulangan.
tvOut_UseCompositedLayersImage
Digunakan untuk mengoptimalkan kinerja saat menggunakan layer di bawah dengan transisi, dll. Ini memberi tahu aplikasi bahwa layer saat ini membutuhkan input gambar composited layers. mimoLive akan memasukkan layer di bawah gambar yang digabungkan dalam siklus render berikutnya. Jika "tvOut_UseCompositedLayersImage" tidak ada, mimoLive mengasumsikan bahwa lapisan di bawah gambar harus selalu dimasukkan. Hanya pengoptimalan gambar, semua media akan tetap digulung. Hanya digunakan jika tvIn_CompositedLayersImage ada.
tvOut_TallyState
Lapisan output ini dapat menimpa status penghitungan otomatis dari sumber yang saat ini terhubung ke input tersebut. Hal ini berguna untuk transisi atau jika sumber tidak digunakan untuk output, status penghitungan dapat dimatikan (misalnya Pengalih Video menggunakan 3 kamera namun hanya menampilkan satu kamera saja, sehingga perlu mengatur status penghitungan untuk sumber yang tidak digunakan ke "TVTallyStateOff"). Lihat Status Tally untuk daftar status tally.
tvSet_
Di mimoLive, sebuah layer atau filter dapat memanipulasi parameternya sendiri. Hal ini terutama untuk mengimplementasikan fitur manipulasi langsung dalam pratinjau varian layer (misalnya, jika pengguna menyeret Jam Analog dalam pratinjau, layer akan memberi tahu mimoLive tombol input mana yang harus diubah ke nilai yang mana. Namun, fitur ini juga digunakan untuk mentransfer data langsung dari instance program ke instance pratinjau dan sebaliknya (misalnya, dalam layer Video Switcher, instance program memberitahu instance pratinjau sumber video mana yang sedang ditayangkan, dan instance pratinjau dapat memberi tahu instance program sumber video mana yang dipilih pengguna di layar).
Untuk menggunakan fitur ini, Anda memerlukan dua output yang sesuai dengan bidang input yang ingin Anda manipulasi: Pada 'tvSet_' Anda mengeluarkan nilai baru yang ingin Anda tetapkan dan dengan 'tvSetSignal_' Anda memberi sinyal ketika nilai tersebut valid dan akan disimpan.
tvSetSignal_
Lihat tvSet_ .
tvSetAudioVolume_
Output ini mengontrol volume sumber audio yang terkait (atau audio dari sumber video). Nilai yang valid adalah 0 = hening hingga 1 = penuh. komposisi harus mengatur "tvSetAudioVolumeSignal_" yang sesuai setiap kali ingin mengubah tingkat volume audio. Misalnya, ini berguna jika layer memiliki transisi yang memudar dan ingin memudarkan audio juga.
tvSetAudioVolumeSignal_
Lihat tvSetAudioVolume_ .
Berbagi Nilai antar Lapisan
Sebuah layer dapat mengirimkan data ke layer lain dalam tumpukan layer yang berada di atasnya. Data disimpan oleh mimolive dengan sharing key-nya hingga siklus render berikutnya. Jika sebuah layer digunakan beberapa kali (atau sharing key yang sama digunakan pada layer yang berbeda), maka data tersebut akan ditimpa oleh layer di atasnya. Untuk mengatur data berbagi ini, gunakan output "tvOut_Share_". Anda dapat menyimpan tipe data QuartzComposer apa saja, namun sebuah struct lebih disarankan karena Anda hanya membutuhkan satu output untuk beberapa nilai. Di sisi lapisan penerima, Anda akan membutuhkan input "tvIn_Shared_" yang sesuai dengan tipe data yang sama. Harap diperhatikan bahwa layer penerima harus berada di atas layer pengirim dalam tumpukan layer.
Pembagian nilai berguna jika Anda membutuhkan data yang sama di beberapa lapisan (misalnya nama lawan Tuan Rumah dan Tamu dalam permainan).
Definisi Jenis (alias Konvensi Penamaan)
| Kunci | Jenis | Deskripsi |
|---|---|---|
| *_JenisAudio | Gambar | Ini adalah kasus yang sangat khusus: Sebuah _TypeAudio hanya dapat menetapkan sumber yang berisi audio (misalnya sumber Film, sumber Video, atau sumber Hanya Audio). Layer akan mendapatkan kontrol atas sumber ini (di masa mendatang) serta nilai volume audio untuk saluran kiri dan kanan melalui input "_TypeAudioAudioLevel0" dan "_TypeAudioAudioLevel1". |
| *_TypeBoinxX | Nomor | Input angka dalam Koordinat Boinx X - mis. -1 adalah piksel pertama, 1 adalah piksel terakhir dari dimensi layar saat ini. akan disajikan kepada pengguna dalam piksel |
| *_TypeBoinxY | Nomor | Input angka dalam Koordinat Boinx Y - mis. -1 adalah piksel terbawah, 1 adalah piksel paling atas dari dimensi layar saat ini. akan disajikan kepada pengguna dalam piksel |
| *_TypeDirectoryPath | String | Menghasilkan tombol "Pilih..." di UI, mungkin juga menampilkan kontrol jalur |
| *_TipeDurasi | Nomor | Waktu dalam detik - akan ditampilkan dalam menit:detik dan bisa mendapatkan UI khusus |
| *_TypeFilePath | String | Menghasilkan tombol "Pilih..." di UI, mungkin juga menampilkan kontrol jalur |
| *_TypeFontBoinxSize | String | Ukuran huruf dalam Koordinat Boinx Y (mis. 2 adalah tinggi layar penuh), lihat catatan di bawah ini |
| *_TypeFontColor | Warna | Masukan warna biasa untuk menentukan warna teks, lihat catatan di bawah ini |
| *_KetikanNamaFont | String | Ini akan menghasilkan pemilih font, lihat catatan di bawah ini |
| *_TypeMultiline | String | Bidang teks multiline yang memungkinkan memasukkan pengembalian |
| *_KetikKataPassword | String | Menampilkan kotak teks kata sandi. Penting: Kata Sandi itu sendiri disimpan dalam teks biasa dan dapat dibaca dalam dokumen! |
| * JenisSinyal | Boolean | Untuk sinyal berdenyut bingkai tunggal, gunakan tambalan Pulse atau Watcher |
Bidang _TypeFontName, _TypeFontBoinxSize, dan _TypeFontColor digabungkan menjadi satu elemen UI Font Chooser dalam tampilan parameter lapisan jika memiliki label dasar yang sama.
Templat Filter
Input dan properti tersebut khusus untuk jika Anda membuat Komposisi Kuarsa untuk digunakan sebagai filter gambar di mimoLive. Sebagian besar definisi sebelumnya juga berlaku untuk filter.
Input Filter
Bidang masukan berikut ini diperlukan oleh Quartz Composer untuk komposisi filter:
| Nama | Jenis | Deskripsi |
|---|---|---|
| _protocolInput_PreviewMode | Bool | Dapat digunakan untuk memberi tahu komposisi bahwa komposisi tersebut dalam mode pratinjau |
| _protokolInput_X | Nomor | Selalu 0. |
| _protokolInput_Y | Nomor | Selalu 0. |
Properti Filter
Properti berikut ini didefinisikan oleh mimoLive. tv_FilterIdentifier dan tv_FilterVersion diperlukan untuk menangani filter dan jalur pembaruan dengan versi yang lebih baru:
| Nama | Jenis | Nilai Sampel | Deskripsi |
|---|---|---|---|
| tv_FilterIdentifier | String | com.boinx.mimoLive.layer.placer | Untuk identifikasi, Boinx mengirimkan komposisi dan mengurutkan versi yang berbeda |
| tv_FilterVersion | Nomor (ganda) | 1 | Untuk mencocokkan berbagai versi komposisi dalam dokumen/aplikasi. Nomor versi mayor menunjukkan ketidakcocokan dan tidak cocok dengan versi mayor lainnya. Nomor versi minor harus kompatibel ke atas dan bertambah 0,001 setiap iterasi. Misalnya, harus dipastikan bahwa pengaturan pemuatan dari layer 1.0 untuk 1.013 harus terlihat sama persis, yang berarti tombol baru jika ada harus memiliki default yang tidak menampilkannya atau sama dengan tampilan versi sebelumnya. |
| tv_FilterOutputApakahBuram | BOOL | Menentukan apakah output filter buram. Standarnya adalah TIDAK |
Pencacahan
Indeks tipe Quartz Composer memungkinkan untuk indeks bernama. Indeks ini dapat diedit di Editor Quartz Composer dengan menambahkan pembagi input dalam mode indeks.
Jenis Sumber
Sumbernya adalah salah satu dari nilai berikut ini
- 0 - Gambar
- 1 - Film, film akan memiliki sisa waktu
- 2 - Kamera, juga bisa berupa komposisi
Arah Transisi
Anda dapat menentukan arah Anda sendiri. Layer yang dikirim menggunakan nilai berikut ini.
- Tidak ada
- Kiri
- Kanan
- Atas
- Bawah
Jenis Transisi
Anda dapat menentukan jenis transisi Anda sendiri. Berikut adalah beberapa contoh nilai yang berguna.
- Larutkan
- Bersihkan
Negara Bagian Penghitungan
Ada beberapa Tally State untuk sumber video yang ditentukan yang akan diwakili dalam UI dan aplikasi pendamping Tally Light.
- 0 = TVTallyStateOff
- 10 = TVTallyStateDalamPenggunaan
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram
