Версія протоколу 1.2
Вступ
mimoLive використовує технологію Quartz Composer від Apple та її документи для шарів. Оскільки mimoLive має передавати документу Quartz Composer деякі параметри середовища, а також зчитувати результати з них, ми розробили протокол, якого ви маєте дотримуватися, щоб скористатися всіма можливостями, які пропонує mimoLive. Нижче ви знайдете всю технічну інформацію про цей протокол.
Якщо ви хочете дізнатися, як створювати користувацькі шари за допомогою Quartz Composer, прочитайте статтю "Створення користувацьких шарів для mimoLive":en:pro:custom_layer:creating_custom_layers.
Властивості
Ви можете редагувати протокол у Quartz Composer, вибравши Редактор ⇢ Редагувати інформацію (⌥⌘I)
| Ім'я | Потрібно | Тип | Значення вибірки |
|---|---|---|---|
| категорія | Рядок | ||
| авторське право | Рядок | © 2016 MySoftwareCompany | |
| опис | Рядок | Відтворює повноекранний ввід | |
| ім'я | Так. | Рядок | Повноекранний плеєр |
| ЗНИЖЕНО tv_Categories | Рядок | Фон, Повноекранний режим | |
| tv_Debug | Булевий | ||
| tv_FileData_ ім'я входу- | Дані | (імпортований XML-файл) | |
| tv_Ім'я_файлу ім'я входу- | Рядок | Standings.xml | |
| tv_HelpURL | Рядок | ||
| tv_HiddenInputKeys | Масив рядків | ||
| tv_InputLabel_ ім'я входу- | Рядок | Відеовхід | |
| tv_LayerIdentifier | Так. | Рядок | com.example.layer.mylayer |
| tv_LayerVersion | Так. | Число (дійсне) | 1.01 |
| tv_LayerPreview | Дані | (імпортований файл PNG) | |
| tv_LayerProtocolVersion | Так. | Число (дійсне) | 1 |
| tv_SortKey | Рядок | ||
| tv_StepSize_ ім'я входу- | Число (дійсне) | 0.1 | |
| ЗНИЖЕНО tv_Tagline | Рядок | Відтворює повноекранний ввід | |
| tv_UseAudioFromSource | Рядок | tvIn_VideoSourceA | |
| tv_UnitLabel_ ім'я входу- | Рядок |
категорія
Категорія зазвичай встановлюється композитором Quartz і не потрібна для шарів mimoLive. Для категорій mimoLive див. tv_Categories натомість.
авторське право
Авторське право зазвичай встановлюється композитором Quartz і не потрібне для шарів mimoLive.
опис
Стандарт Quartz Composer - зробіть його довжиною близько 3 рядків, щоб він добре вписувався в прев'ю.
ім'я
Назва відображається всередині mimoLive. Використовуйте коротке та унікальне ім'я, щоб швидко знайти свій шар.
протоколи
Цей масив зазвичай встановлюється композитором Quartz і не потрібен для шарів mimoLive.
tv_Categories
ЗНИЩЕНО
Категорії використовувалися для групування та фільтрування шарів. Наразі вони ігноруються, але їх можна активувати знову. Використовуйте список наведених нижче попередньо визначених категорій, розділених комами, або створіть власну категорію.
- "Аудіо" - шари, які надають можливість використовувати джерело звуку
- "Накладення" - шари, які накладають дані або зображення: Lower Thirds, Заголовок, Логотип, ...
- "Повноекранний" - Шари, які принаймні за замовчуванням забезпечують повноекранний режим - наприклад, Анімація, Окреме відео, Карта погоди
- "Фон" - Шари, які працюють як фон/підкладка для інших елементів зверху.
- "Текст" - Шари, які забезпечують відображення якогось тексту, наприклад Титри, Lower Thirds, Заголовок
- "Дані" - шари, які відображають дані, наприклад, біржові котирування, баскетбольний рахунок тощо.
- "Зображення" - шари, які забезпечують засоби відображення за допомогою статичного зображення
- "Мультивідео" - шари, які поєднують принаймні два джерела, або додаючи принаймні одне джерело на додачу до шарів, розташованих нижче, або використовуючи два або більше джерел.
- "3D" - шари, що забезпечують певне тривимірне позиціонування елементів, наприклад, Presenter
- "Segment" - шари, що забезпечують анімацію окремих сегментів, наприклад, Digital Upgrade Beitrag
- "Effect" - шари, що забезпечують певні ефекти накладання, наприклад, Magnifier, Spotlight, Zoom...
- "Demo" - шари, що здебільшого призначені для демонстрації можливостей, а не для надання загальної корисної функціональності, напр..наприклад, Карта погоди, яка просто показує карту Німеччини.
- "Споживчі" - шари, які використовують композитне зображення, наприклад, Перемикач відео, Масштаб, Презентатор
- "Генератор" - шари, які забезпечують певний тип згенерованого результату, наприклад, Анімація
- "Налагодження" - шари, корисні для налагодження, які не відображаються у кінцевому продукті.
tv_Debug
Вказуючи програмі, що цей склад слід використовувати лише у налагоджувальному середовищі.
tv_FileData_
Блок даних, який буде створено і записано в документ для введення файлу при створенні шару. Це працює для текстових файлів, які будуть надані у _TypeFilePath або .mov-файлах для вхідних зображень. Дивіться tv_FileName_ .
tv_Ім'я_файлу
Відповідне ім'я файлу до tv_FileData_ . Обов'язковий, якщо вхід tv_FileData_* існує.
tv_HelpURL
Цей рядок може містити URL-адресу з корисною інформацією про те, як використовувати цей шар. mimoLive покаже кнопку "?" у спливаючому інформаційному вікні для кожного шару. Якщо користувач натисне цю кнопку, URL-адресу буде відкрито типовим інтернет-браузером системи.
tv_HiddenInputKeys
У цьому масиві композиція містить клавіші введення, які мають бути приховані від користувацького інтерфейсу.
tv_InputLabel_
Може бути використано для надання альтернативної назви мітки для заданої клавіші вводу у вікні параметрів. Порожні рядки для відсутності міток також можливі. Працює подібно до tv_hide_ouput, тобто назва входу протоколу має бути повною (наприклад, "tv_InputLabel_tvIn_VideoSourceAImage").
tv_LayerIdentifier
Для ідентифікації Boinx відправив композиції і відсортував різні версії. Повинен бути унікальним. Рекомендується використовувати домен зі зворотною нотацією. Приклад: com.mysoftware.layers.videofullscreen
tv_LayerVersion
Для зіставлення різних версій композиції в документі/програмі. Основні номери версій означають несумісність і не збігаються з іншими основними версіями (наприклад, вам потрібно збільшити основну версію, якщо змінюється назва клавіш введення). Мінорні номери версій повинні бути сумісними зі збільшенням і можуть збільшуватися на 0.001 для кожної ітерації. Наприклад, необхідно переконатися, що налаштування завантаження з шару 1.0 для шару 1.013 мають виглядати точно так само, а це означає, що нові клавіші, якщо вони присутні, повинні мати значення за замовчуванням, яке їх не показує або дорівнює вигляду попередньої версії.
tv_LayerPreview
Дані зображення для попереднього перегляду шару у списку шарів. Це може забезпечити кращий досвід, ніж попередній перегляд за замовчуванням. Зображення попереднього перегляду має бути розміром 256 × 256 пікселів.
tv_LayerProtocolVersion
Для майбутньої зворотної сумісності, якщо mimoLive суттєво змінить протокол. Наразі має бути встановлено на 1.
tv_SortKey
Визначає сортування шарів у mimoLive. Таким чином ви можете сортувати фільтри за ймовірністю використання. Наразі використовується схема з 2 великих літер, наприклад, "BM", "DE", "DM" тощо. ПРИМІТКА: Наразі ця функція не використовується, але буде в майбутньому.
tv_StepSize_
Можна використовувати для задавання користувацького кроку (StepSize) для бігових коліс - рух миші в один піксель відповідає цій величині зміни (також +/- клацання миші).
tv_Tagline
ПРИЗНАЧЕНО
Однорядковий рядок, який буде показано у спливаючому вікні інформації у сховищі шарів.
tv_UseAudioFromSource
Наразі mimoLive може показувати у користувацькому інтерфейсі лише один елемент керування звуком. Ця властивість вказує, якою клавішею вводу слід керувати. Введіть повну назву відповідної клавіші вводу. (Для зворотної сумісності це поле також може приймати значення "A", "B" або "C", які перекладаються у ключ tvIn_VideoSourceAImage, tvIn_VideoSourceBImage або tvIn_VideoSourceCImage. Якщо його не вказано, mimoLive припускає, що для цього шару не буде використано аудіо.
tv_UnitLabel_
Може використовуватися для позначення одиниці виміру, наприклад, "pt" для даної клавіші вводу у вікні параметрів. Будьте якомога коротшими. Допомагає зрозуміти, що означає вхід. Входи одиниць виміру Boinx отримають автоматичні мітки "px".
Вхідні дані
| Ім'я | Тип |
|---|---|
| tvIn_AccountTwitterConsumerKey | Рядок |
| tvIn_AccountTwitterConsumerSecret | Рядок |
| tvIn_AccountTwitterTokenKey | Рядок |
| tvIn_AccountTwitterTokenSecret | Рядок |
| tvIn_CompositedLayersImage | Зображення |
| tvIn_FrameCount | Індекс |
| tvIn_FrameDuration | Номер |
| tvIn_CompositedLayersImage | Зображення |
| tvIn_InTransitionDirection | Індекс Напрямок переходу Напрямок |
| tvIn_InTransitionDuration | Номер |
| tvIn_InTransitionType | Індекс Тип переходу Тип |
| tvIn_KeyboardModifierAlt | Булевий |
| tvIn_KeyboardModifierCommand | Булевий |
| tvIn_KeyboardModifierControl | Булевий |
| tvIn_KeyboardModifierFunction | Булевий |
| tvIn_KeyboardModifierShift | Булевий |
| tvIn_Obscured | Булевий |
| tvIn_OnAir | Булевий |
| tvIn_OSVersion | Рядок |
| tvIn_OutTransitionDirection | Індекс Напрямок переходу Напрямок |
| tvIn_OutTransitionDuration | Номер |
| tvIn_OutTransitionType | Індекс Тип переходу Тип |
| tvIn_PreviewMode | Булевий |
| tvIn_Reset | Булевий (Сигнал) |
| tvIn_RuntimeIdentifier | Рядок |
| tvIn_Shared_ | будь-який тип значення |
| tvIn_ShowDuration | Номер |
| tvIn_ShowTimer | Номер |
| tvIn_Switch | Булевий (Сигнал) |
| tvIn_TransitionDirection | Індекс Напрямок переходу Напрямок |
| tvIn_TransitionDuration | Номер |
| tvIn_TransitionType | Індекс Тип переходу Тип |
| tvIn_UISnapColor | Колір |
| tvIn_VideoSourceA B C D | Зображення |
tvIn_AccountTwitterConsumerKey
tvIn_AccountTwitterConsumerSecret
tvIn_AccountTwitterTokenKey
tvIn_AccountTwitterTokenSecret
Ці чотири входи AccountTwitter використовуються для передачі даних для входу з налаштувань акаунта mimoLive у Twitter до композиції. Значення використовуються з патчами JSON Patch та OAuth Patch для зчитування даних з сервісу Twitter.
tvIn_CompositedLayersImage
Якщо цей ввід присутній у композиції і на ньому є вміст з шарів, розташованих нижче, результат малювання цих шарів буде додано до цього входу.
tvIn_FrameCount
Цей параметр містить загальну кількість відрендерених кадрів після запуску mimoLive. Якщо кадри було пропущено через надто високе навантаження при зображенні, кількість кадрів буде перевищувати кількість пропущених кадрів.
tvIn_FrameDuration
Тривалість кадру - це інтервал часу між кожним рендерингом у секундах.
tvIn_InTransitionDirection
Напрямок, в якому буде виконано Напрямок переходу.
tvIn_InTransitionDuration
Значення у секундах, за яке буде виконано tvIn_InTransitionType.
tvIn_InTransitionType
Якщо корисно для шару, який дозволяє користувачеві вибирати тип поточного переходу. Також див. розділ Тип переходу.
tvIn_KeyboardModifierAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_KeyboardModifierFunction
tvIn_KeyboardModifierShift
Ці логічні поля вводу будуть встановлені на true, коли користувач натисне відповідну клавішу-модифікатор на клавіатурі. Ця функція переважно використовується для прямого маніпулювання. Будь ласка, зверніться до рядків посібника користувача Apple Human, щоб дізнатися, яку клавішу-модифікатор слід використовувати для якої функції у користувацькому інтерфейсі.
tvIn_Obscured
Цей параметр має значення true, якщо шар не повинен виводити дані, оскільки шар, розташований вище, все одно затуляє його, малюючи на весь екран. Це може бути використано для уникнення надмірного малювання шарами, які не є видимими, але налаштовані як живі. (Наприклад, у випадку шару Twitter цей шар все одно викликається, навіть якщо його затуляє інший шар вище, і має можливість підтримувати інтернет-з'єднання з сервісом Twitter).
tvIn_OnAir
Вхідні дані починаються зі значення "true". Як тільки вхід стане "false", композиція повинна виконати будь-який вихідний перехід, а потім вивести значення Done, коли це буде зроблено. Після цього композиція буде деактивована. Може статися так, що програма вимкне шар, не чекаючи на прапорець done.
tvIn_OSVersion
Цей рядок буде встановлено на поточну версію OS X (наприклад, "Version 10.11.2 (Build 265341)").
tvIn_OutTransitionDirection
Буде виконано значення у секундах tvIn_OutTransitionType. Також дивіться Напрямок переходу.
tvIn_OutTransitionDuration
Буде виконано значення у секундах tvIn_OutTransitionType.
tvIn_OutTransitionType
Якщо корисно для шару, який дозволяє користувачеві вибирати тип поточного переходу. Також див. розділ Тип переходу.
tvIn_PreviewMode
Може використовуватися, щоб повідомити композиції, що вона перебуває в режимі попереднього перегляду.
tvIn_Reset
Корисний для скидання логіки композиції. Цей прапорець встановлюється, коли шар перемикається з вимкненого стану на прямий ефір або під час перемикання між налаштуваннями, а вхід tvIn_Switch недоступний.
tvIn_RuntimeIdentifier
Допомагає шарам взаємодіяти між попереднім переглядом та реальним екземпляром. Встановлюється динамічно за допомогою mimoLive.
tvIn_Shared_
Дивіться Поділ значень між шарами Значення між шарами.
tvIn_ShowDuration
Якщо користувач заповнив тривалість показу у Налаштуваннях показу, цей вхід матиме значення у секундах.
tvIn_ShowTimer
Таймер показу відображатиме відображення таймера показу документа mimoLive у секундах.
tvIn_Switch
Цей прапорець встановлюється замість tvIn_Reset, коли шар перемикається з одного налаштування на інше без вимкнення шару. Якщо цього входу не існує, встановлюється [[#tvIn_Reset]], коли шар перемикається з одного налаштування на інше без вимкнення шару. Якщо цього входу не існує, замість нього встановлюється [[#tvIn_Reset]] для збереження сумісності зі старими шарами.
tvIn_TransitionDirection
Напрямок, у якому буде виконано Напрямок переходу.
tvIn_TransitionDuration
Буде виконано значення в секундах tvIn_InTransitionType.
tvIn_TransitionType
Якщо корисно для шару, який дозволяє користувачеві вибирати тип поточного переходу. Також див. розділ Тип переходу.
tvIn_UISnapColor
Для того, щоб зберегти інтерфейс послідовним, mimoLive надає "колір прив'язки", яким можна малювати напрямні у попередньому перегляді, коли інтерфейс прив'язується до певного значення (наприклад, утримуйте клавішу "shift" під час обертання шару Placer у користувацькому режимі відображення, тоді напрямні буде намальовано цим кольором, коли кут обертання буде прив'язано до 0, 45 або 90 градусів).
tvIn_VideoSource
Рівень може мати до 8 входів динамічного джерела відео: "A", "B", "C" і так далі. Вони будуть представлені зоною падіння, якщо користувач перетягне джерело відео зі сховища джерел до стека шарів. //Примітка: Для забезпечення зворотної сумісності розширення "Image" на цих входах ігнорується.
Параметри введення
Відповідні клавіші введення
Якщо присутня клавіша відеовходу, наступні клавіші входу також будуть заповнені інформацією відповідно:
(наприклад, "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
| Ключ | Тип | Опис |
|---|---|---|
| AudioGain | Номер | TBD |
| AudioLevel0 | Номер | Рівень лівого аудіоканалу в дБ після регулювання підсилення |
| AudioLevel1 | Номер | Рівень правого аудіоканалу в дБ після регулювання підсилення |
| AudioLevel0Raw | Номер | Рівень лівого аудіоканалу в дБ до регулювання підсилення |
| AudioLevel1Raw | Номер | Рівень правого аудіоканалу в дБ до регулювання підсилення |
| Панорамування звуку | Номер | TBD |
| AudioVolume | Номер | TBD |
| Дані | Структура | Словник метаданих джерела. Наразі реалізовано такі ключі: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier" |
| Ім'я | Рядок | Назва пов'язаного джерела зображення. Може використовуватися для відображення його назви у попередньому перегляді або для обчислення назви за замовчуванням для варіанта шару. Дивіться tvOut_SettingName . |
| Час, що залишився | Номер | За лічені секунди. Буде надано для джерел фільмів. -1, якщо джерело фільму зациклено (або будь-яке інше джерело). |
| TallyState | Індекс | Підрахунок стану підключеного джерела, див. Підрахунок штатів Держави |
| Тип | Індекс | Значення тип джерела тип |
Групування вхідних даних
Групування надається в інтерфейсі користувача - для цього має значення префікс вхідних даних. Синтаксис виглядає як tvGroup___. Зверніть увагу на подвійне підкреслення _ _ після назви групи як роздільник назви входу.
Спеціальну групу визначено для входів, які завжди слід приховувати: tvGroup_Hidden_Inputs__ Цю групу можна зробити видимою, перевівши mimoLive у режим налагодження у debug|Параметри налагодження|Параметри налагодження. Деякі шари використовують ці приховані поля для зв'язку між "екземпляром попереднього перегляду" та "екземпляром прямого ефіру" (наприклад, шар Video Switcher повідомляє екземпляру попереднього перегляду, яке джерело відео наразі є прямим).
Динамічно приховувати вхідні дані
Кожен вхід протоколу буде приховано в інтерфейсі, якщо параметр tvOut_hide_ Output має значення "true". Це значення відстежується програмою і може бути змінено динамічно. Зауважте, що вам слід використовувати повну назву входу, включаючи "tvIn" (наприклад, для входу tvOut_hide_tvIn_Text_TypeMultiline використовуйте вихід tvIn_Text_TypeMultiline).
Результати
| Ім'я | Тип |
|---|---|
| tvOut_Cursor | Рядок |
| tvOut_Done | Булевий (Сигнал) |
| tvOut_hide_ | Булевий |
| tvOut_Opaque | Булевий |
| tvOut_SettingName | Рядок |
| tvOut_Share_ | будь-який тип |
| tvOut_TimeRemaining | Номер |
| tvOut_UseCompositedLayersImage | Булевий |
| tvOut_TallyState | Індекс Підрахунок штатів Держави |
| tvSet_ | Тип входу, який потрібно встановити |
| tvSetSignal_ | Булевий |
| tvSetAudioVolume_ | Номер |
| tvSetAudioVolumeSignal_ | Булевий |
tvOut_Cursor
Цей параметр визначає вигляд курсору миші, коли вказівник миші знаходиться над вікном попереднього перегляду або вікном виводу програми. Будь ласка, зверніться до документації класу NSCursor від Apple) для отримання допустимих значень. Додатковими курсорами миші у mimoLive є "мінус" та "плюс".
Видаліть постфікс "_Cursor" або "Cursor" з констант NSCursor від Apple (наприклад, використовуйте "openHand" для отримання курсору миші з відкритою рукою).
tvOut_Done
Використовується для повідомлення наступному шару про те, що цей шар завершено. Документацію наведено за посиланням tvIn_OnAir.
tvOut_hide_
Може використовуватися для динамічного приховування значень вхідних даних у поданні параметрів. Дивіться Динамічно приховувати вхідні дані .
tvOut_Opaque
Використовується для вказівки програмі, що шари нижче цього не потрібно малювати. За замовчуванням "false". Це значення перевизначається будь-яким підключеним джерелом, що містить alpha.
tvOut_SettingName
Композиції можуть запропонувати корисну назву для параметра на основі деяких вхідних даних.
tvOut_Share_
Дивіться Поділ значень між шарами .
tvOut_TimeRemaining
Дозволяє програмі відображати великий зворотний відлік таймера (наприклад, 5 секунд до завершення фільму). Наразі використовується "-1" для позначення відсутності інформації про час, що залишився, або "-2", якщо це зациклений фільм.
tvOut_UseCompositedLayersImage
Використовується для оптимізації продуктивності при використанні шарів, розташованих нижче, з переходами тощо. Він повідомляє програмі, що шар наразі потребує введення складеного зображення. mimoLive додасть шари під складеним зображенням у наступному циклі рендерингу. Якщо "tvOut_UseCompositedLayersImage" відсутній, mimoLive припускає, що шари під зображенням слід завжди додавати. Це лише оптимізація малювання, всі медіа все одно будуть згорнуті. Використовується лише за наявності tvIn_CompositedLayersImage.
tvOut_TallyState
Цей вихідний рівень може перезаписати стан автоматичного підрахунку джерела, яке наразі підключено до цього входу. Це корисно для переходів або якщо джерело не використовується для виводу, стан підрахунку можна вимкнути (наприклад, відеоперемикач використовує 3 камери, але показує лише одну за раз, тому йому потрібно встановити стан підрахунку для невикористаних джерел на "TVTallyStateOff"). Будь ласка, дивіться Стани підрахунку для отримання списку станів підрахунку.
tvSet_
У mimoLive шар або фільтр може керувати власними параметрами. Це головним чином для реалізації функції прямої маніпуляції у попередньому перегляді варіанту шару (наприклад, якщо користувач перетягує аналоговий годинник у попередньому перегляді, шар повідомляє mimoLive, які клавіші вводу слід змінити на які значення). Втім, ця функція також використовується для передачі даних у реальному часі з екземпляра програмного виводу до екземпляра попереднього перегляду і навпаки (наприклад, у шарі Video Switcher екземпляр програмного виводу повідомляє екземпляру попереднього перегляду, яке джерело відео наразі є живим, а екземпляр попереднього перегляду може повідомити екземпляру програмного виводу, яке джерело відео було вибрано користувачем на екрані).
Щоб скористатися цією функцією, вам потрібні два виходи, які відповідають полю введення, яким ви хочете маніпулювати: У 'tvSet_' ви виводите нове значення, яке хочете встановити, а у 'tvSetSignal_' ви сигналізуєте, коли значення дійсне і його потрібно зберегти.
tvSetSignal_
Дивіться tvSet_ .
tvSetAudioVolume_
Цей вихід керує гучністю пов'язаного з ним джерела звуку (або звуку відеоджерела). Допустимі значення від 0=тихо до 1=повна. Композиція повинна встановлювати відповідний "tvSetAudioVolumeSignal_" щоразу, коли хоче змінити рівень гучності звуку. Наприклад, це корисно, якщо шар має зникаючий перехід і хоче, щоб звук також зникав.
tvSetAudioVolumeSignal_
Дивіться tvSetAudioVolume_ .
Обмін значеннями між шарами
Шар може надсилати дані іншим шарам у стеку шарів, що знаходяться над ним. Дані зберігаються mimolive за ключем спільного доступу до наступного циклу зображування. Якщо шар використовується декілька разів (або той самий ключ спільного доступу використовується у різних шарах), дані перезаписуються шаром, що знаходиться вище. Для встановлення даних спільного доступу використовуйте вихід "tvOut_Share_". Ви можете зберігати будь-який тип даних QuartzComposer, однак рекомендується використовувати структуру, оскільки вам потрібен лише один вихід для декількох значень. На стороні приймаючого шару вам знадобиться відповідний вхід "tvIn_Shared_" з тим самим типом даних. Зверніть увагу, що шар-одержувач має бути поверх шару-відправника у стеку шарів.
Спільне використання значень корисне, якщо вам потрібні одні й ті ж дані в декількох шарах (наприклад, імена суперників господарів і гостей у грі).
Визначення типів (також відомі як Угоди про іменування)
| Ключ | Тип | Опис |
|---|---|---|
| *_TypeAudio | Зображення | Це особливий випадок: Тип _TypeAudio може призначатися лише джерелам, що містять звук (наприклад, джерелам фільму, відео або лише аудіо). Шар отримає контроль над цим джерелом (у майбутньому), а також над значеннями гучності для лівого і правого каналів через входи "_TypeAudioAudioLevel0" і "_TypeAudioAudioLevel1". |
| *_TypeBoinxX | Номер | Число, введене у координатах Boinx X - наприклад, -1 - перший піксель, 1 - останній піксель поточних розмірів екрану. буде представлено користувачеві у пікселях |
| *_TypeBoinxY | Номер | Число, введене у координатах Boinx Y - наприклад, -1 - нижній піксель, 1 - верхній піксель поточних розмірів екрану. буде представлено користувачеві у пікселях |
| *_TypeDirectoryPath | Рядок | У результаті в інтерфейсі користувача з'явиться кнопка "Вибрати...", можливо, з елементом керування шляхом |
| *_TypeDuration | Номер | Час в секундах - буде відображатися в хвилинах:секундах і може отримати користувацький інтерфейс |
| *_TypeFilePath | Рядок | У результаті в інтерфейсі користувача з'явиться кнопка "Вибрати...", можливо, з елементом керування шляхом |
| *_TypeFontBoinxSize | Рядок | Розмір шрифту в координатах Boinx Y (наприклад, 2 - повноекранна висота), див. примітку нижче |
| *_TypeFontColor | Колір | Звичайне введення кольору для визначення кольору тексту, див. примітку нижче |
| *_TypeFontName | Рядок | У результаті з'явиться вікно вибору шрифту, див. примітку нижче |
| *_TypeMultiline | Рядок | Багаторядкове текстове поле, яке дозволяє вводити повернення |
| *_TypePassword | Рядок | Відображає текстове вікно з паролем. Важливо: сам пароль зберігається у вигляді звичайного тексту і є читабельним у документі! |
| *_TypeSignal | Булевий | Для однокадрового імпульсного сигналу використовуйте патчі Pulse або Watcher |
Поля _TypeFontName, _TypeFontBoinxSize і _TypeFontColor об'єднуються в один елемент інтерфейсу вибору шрифту у поданні параметрів шарів, якщо вони мають однакову базову мітку.
Шаблони фільтрів
Ці вхідні дані та властивості є специфічними для випадків, коли ви створюєте кварцову композицію для використання як фільтр зображень у mimoLive. Більшість попередніх визначень також застосовуються до фільтрів.
Входи фільтра
Наступні поля вводу вимагаються Quartz Composer для створення композиції фільтра:
| Ім'я | Тип | Опис |
|---|---|---|
| _protocolInput_PreviewMode | Bool | Можна використовувати, щоб повідомити композиції, що вона перебуває в режимі попереднього перегляду |
| _protocolInput_X | Номер | завжди дорівнює 0. |
| _protocolInput_Y | Номер | завжди дорівнює 0. |
Властивості фільтра
Наступні властивості визначаються mimoLive. tv_FilterIdentifier та tv_FilterVersion необхідні для обробки фільтра та шляху його оновлення з новими версіями:
| Ім'я | Тип | Значення вибірки | Опис |
|---|---|---|---|
| tv_FilterIdentifier | Рядок | com.boinx.mimoLive.layer.placer | Для ідентифікації Boinx відправив композиції та відсортував різні версії |
| tv_FilterVersion | Число (double) | 1 | Для зіставлення різних версій композиції в документі/додатку. Основні номери версій означають несумісність і не збігаються з іншими основними версіями. Менші номери версій повинні бути сумісними у напрямку зростання і збільшуватися на 0.001 при кожній ітерації. Наприклад, необхідно переконатися, що налаштування завантаження з шару 1.0 для шару 1.013 мають виглядати точно так само, а це означає, що нові клавіші, якщо вони присутні, повинні мати значення за замовчуванням, яке не показує їх або дорівнює вигляду попередньої версії. |
| tv_FilterOutputIsOpaque | БУЛ | Визначає, чи є вихід фільтра непрозорим. За замовчуванням - НІ |
Перерахування
Тип "Індекс" у Quartz Composer дозволяє створювати іменовані індекси. Їх можна редагувати в редакторі Quartz Composer, додавши розгалужувач входу в режимі індексу.
Тип джерела
Джерелом буде одне з наступних значень
- 0 - Зображення
- 1 - Фільм, фільм матиме час, що залишився
- 2 - Камера, також може бути композицією
Напрямок переходу
Ви можете визначити власні напрямки. У доставлених шарах використовуються такі значення.
- Ні
- Ліворуч
- Праворуч
- Вгору
- Вниз
Тип переходу
Ви можете визначити власні типи переходів. Ось кілька корисних прикладів значень.
- Розчинити
- Протерти
Підрахунок штатів
Для джерел відео визначено кілька станів Tally, які будуть представлені в інтерфейсі користувача і в додатку Tally Light.
- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram
