プロトコル・バージョン1.2
はじめに
mimoLiveはレイヤーにAppleのQuartz Composerテクノロジーとそのドキュメントを使用しています。mimoLiveはQuartz Composerのドキュメントにいくつかの環境パラメータを伝え、そこから結果を読み取る必要があるため、mimoLiveが提供するすべての機能を利用するために従わなければならないプロトコルを設計しました。以下に、このプロトコルに関するすべての技術情報を示します。
Quartz Composerでカスタムレイヤーを作成する方法を学びたい場合は、「Creating Customer Layers for mimoLive」:en:pro:custom_layer:creating_custom_layerをお読みください。
プロパティ
Quartz Composer で Editor Ȓ Edit information (⌥⌘I) を選択すると、プロトコルを編集できます。
| 名称 | 必須 | タイプ | サンプル値 |
|---|---|---|---|
| カテゴリー | ストリング | ||
| 著作権 | ストリング | © 2016 MySoftwareCompany | |
| 記述 | ストリング | フルスクリーン入力を再生する | |
| 名称 | はい | ストリング | フルスクリーンプレーヤー |
| 廃止 tv_カテゴリー | ストリング | バックドロップ,フルスクリーン | |
| tv_デバッグ | ブーリアン | ||
| tv_FileData_ 入力名 | データ | (インポートされたXMLファイル） | |
| tv_ファイル名 入力名 | ストリング | 順位表.xml | |
| tv_HelpURL | ストリング | ||
| tv_HiddenInputKeys | 文字列の配列 | ||
| tv_InputLabel_ 入力名 | ストリング | ビデオ入力 | |
| tv_LayerIdentifier | はい | ストリング | com.example.layer.mylayer |
| tv_LayerVersion | はい | 数字（実数） | 1.01 |
| tv_レイヤープレビュー | データ | (インポートされたPNGファイル） | |
| tv_LayerProtocolVersion | はい | 数字（実数） | 1 |
| tv_SortKey | ストリング | ||
| tv_StepSize_ 入力名 | 数字（実数） | 0.1 | |
| 廃止 tv_タグライン | ストリング | フルスクリーン入力を再生する | |
| tv_UseAudioFromSource | ストリング | tvIn_VideoSourceA | |
| tv_UnitLabel_ 入力名 | ストリング |
カテゴリー
カテゴリは通常 Quartz composer によって設定され、mimoLive レイヤーには必要ありません。mimoLive カテゴリについては、代わりに tv_Categories を参照してください。
著作権
コピーライトは通常Quartz composerによって設定され、mimoLiveレイヤーには必要ない。
記述
Quartz Composer標準 - プレビューにうまく収まるように、3行程度の長さにしてください。
名称
名前はmimoLiveの中に表示されます。レイヤーを素早く見つけるために、短くてユニークな名前を使いましょう。
プロトコル
この配列は通常Quartz composerによって設定され、mimoLiveレイヤーには必要ない。
tv_カテゴリー
DEPRECATED。
カテゴリは、レイヤーのグループ化とフィルタリングに使用されていました。現在、それらは無視されていますが、再び有効にすることができます。以下の定義済みのカテゴリーをカンマで区切ったリストを使用するか、独自のカテゴリーを定義します。
- Audio" - オーディオソースを使用できるレイヤー
- "Overlay" - データや画像をオーバーレイするレイヤー：Lower Thirds, Title, Logo, ...
- "Fullscreen" - 少なくともデフォルト設定でフルスクリーンを提供するレイヤー - 例: Animations, Single Video, Weather Map
- "Backdrop" - 背景/背景として機能するレイヤー
- "Text" - 何らかのテキスト表示を提供するレイヤー。
-"Data"（データ） - データを表示するレイヤー。
-"Image"（イメージ） - 静的な画像入力を使用して表示する手段を提供するレイヤー
-"Multivideo"（マルチビデオ） - 少なくとも2つのソースを組み合わせるレイヤー。
-"3D"-要素の3Dポジショニングを提供するレイヤー（例：プレゼンター）
-"Segment"-セグメントを区切るアニメーションを提供するレイヤー（例：Digital Upgrade Beitrag）
-"Effect"-オーバーレイ効果を提供するレイヤー（例：拡大鏡、スポットライト、ズーム...）
-"Demo"-一般的な便利な機能を提供するというよりも、むしろ機能をデモンストレーションするためのレイヤー（例：天気図）
-"Segment"-セグメントを区切るアニメーションを提供するレイヤー（例：Digital Upgrade Beitrag）
-"Effect"-オーバーレイ効果を提供するレイヤー（例：拡大鏡、スポットライト、ズーム...）。
- "Consumer" - compositedlayersimageを使用するレイヤー、例: Video Switcher、Zoom、Presenter
- "Generator" - ある種の生成出力を提供するレイヤー、例: Animations
- "Debug" - 最終製品では表示されないデバッグに役立つレイヤー。
tv_デバッグ
このコンポジションはデバッグ環境でのみ使用されるべきであることをアプリケーションに伝える。
tv_FileData_
レイヤー作成時にファイル入力用に作成され、ドキュメントに書き込まれるデータ blob。これは、_TypeFilePathで提供されるテキストファイルや、画像入力用の.movファイルで動作します。tv_FileName_ を参照してください。
tv_ファイル名
tv_FileData_ に対応するファイル名。tv_FileData_* 入力が存在する場合は必須。
tv_HelpURL
この文字列には、このレイヤーの使用方法に関する有益な情報を含むURLを格納することができます。ミモライブは、各レイヤーの情報ポップオーバーに「?ユーザーがこのボタンをクリックすると、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_レイヤープレビュー
レイヤーリスト内のレイヤーのプレビューに使用する画像データ。これはデフォルトのクイックルックプレビューよりも優れたエクスペリエンスを提供できます。プレビュー画像は 256 × 256 ピクセルでなければなりません。
tv_LayerProtocolVersion
将来mimoLiveがプロトコルを大幅に変更した場合の後方互換性のため。現在は 1 に設定する必要があります。
tv_SortKey
mimoLiveのレイヤーのソートを定義します。そのため、フィルターを使用する確率で並べ替えることができます。現在、2つの大文字のスキームが使用されています、例えば、"BM"、"DE"、"DM "など。注意：現在この機能は使用されていませんが、将来使用されるでしょう。
tv_StepSize_
1ピクセルのマウス移動がこの変化量に対応する（+/-クリックも）。
tv_タグライン
DEPRECATED
レイヤーリポジトリの情報ポップオーバーに表示される1行の文字列です。
tv_UseAudioFromSource
mimoLiveは現在、ユーザーインターフェースに1つのオーディオコントロールのみを表示することができます。このプロパティは、制御される入力キーが何であるかを伝えます。完全に対応する入力キーを記入してください。(後方互換性のために、このフィールドは、キーtvIn_VideoSourceAImage、tvIn_VideoSourceBImageまたはtvIn_VideoSourceCImageに変換される "A"、"B "または "C "も受け入れます。提供されない場合、mimoLiveはこのレイヤーでオーディオが使用されないと仮定します。
tv_UnitLabel_
パラメータ・ビューで、指定された入力キーの単位ラベル、例えば "pt "を指定するために使用できる。できるだけ短く。入力の意味を伝えるのに役立つ。Boinxの単位入力は自動的に "px "ラベルになる。
入力
| 名称 | タイプ |
|---|---|
| tvIn_AccountTwitterConsumerKey | ストリング |
| tvIn_AccountTwitterConsumerSecret | ストリング |
| tvIn_AccountTwitterTokenKey | ストリング |
| tvIn_AccountTwitterTokenSecret | ストリング |
| tvIn_CompositedLayersImage | 画像 |
| tvIn_FrameCount | インデックス |
| tvIn_FrameDuration | 番号 |
| tvIn_CompositedLayersImage | 画像 |
| tvIn_遷移方向 | インデックス 移行方向 ディレクション |
| 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_プレビューモード | ブーリアン |
| 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
これらの4つのAccountTwitter入力は、mimoLive Twitter Account Preferencesからのログインデータをコンポジションにフィードするために使用されます。これらの値は、Twitterサービスからデータを読み込むために、JSONパッチとOAuthパッチパッチと共に使用される。
tvIn_CompositedLayersImage
コンポジションにこの入力があり、下のレイヤーのコンテンツがある場合、下のレイヤーの描画結果がこの入力に入力される。
tvIn_FrameCount
この入力は、mimoLiveを開始した後にレンダリングされた総フレーム数を取得します。レンダリング負荷が高すぎるためにフレームがドロップされた場合、フレームカウントはそのドロップされたフレーム数を飛び越えます。
tvIn_FrameDuration
フレーム持続時間は、各レンダリング間の時間間隔（秒）である。
tvIn_遷移方向
トランジション・ディレクションが実行される方向。
tvIn_InTransitionDuration
tvIn_InTransitionType が実行される秒単位の値。
tvIn_InTransitionType
進行中のトランジションのタイプを選択できるレイヤーに便利です。トランジションタイプTypeも参照。
tvIn_KeyboardModifierAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_KeyboardModifierFunction
tvIn_KeyboardModifierShift
ユーザーがキーボードの修飾キーを押している間、これらのブーリアン入力フィールドは真に設定される。この機能は主に直接操作機能に使用されます。UIでどの修飾キーをどの機能に使うかについては、Apple Human User Guide Linesを参照してください。
tvIn_Obscured
この入力は、レイヤーが出力をレンダリングする必要がない場合に真に設定されます。これは、表示されていないがライブに設定されているレイヤーによる重い描画を避けるために使用できます。(例えば、Twitterレイヤーの場合、上のレイヤーに隠されてもレイヤーが呼び出され、Twitterサービスへのインターネット接続を維持する機会を得ます)
tvIn_OnAir
この入力は "true "で始まる。この入力が "false "になったら、コンポジションは発信トランジションを行い、それが終わったらDone出力を設定する。その後、コンポジションは非アクティブになる。アプリケーションは、doneフラグを待たずにレイヤーをオフにすることがあります。
tvIn_OSVersion
この文字列入力には、現在のOS Xのバージョンが設定されます（例："Version 10.11.2 (Build 265341)"）。
tvIn_OutTransitionDirection
tvIn_OutTransitionType の秒単位の値が実行されます。Transition Directionも参照してください。
tvIn_OutTransitionDuration
tvIn_OutTransitionType の秒単位の値が実行されます。
tvIn_OutTransitionType
進行中のトランジションのタイプを選択できるレイヤーに便利です。トランジションタイプTypeも参照。
tvIn_プレビューモード
プレビューモードであることをコンポジションに伝えるために使用できる。
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
進行中のトランジションのタイプを選択できるレイヤーに便利です。トランジションタイプTypeも参照。
tvIn_UISnapColor
UIの一貫性を保つために、mimoLiveは、UIが特定の値にスナップするときにプレビューでガイドラインを描画するための "スナップカラー "を提供します（例えば、カスタム表示モードで "shift "キーを押しながらプレーサーレイヤーを回転させると、回転角度が0度、45度、90度にスナップしたときにガイドラインがその色で描画されます）。
tvIn_VideoSource
レイヤーは最大8つのダイナミック・ビデオ・ソース入力を持つことができる：A"、"B"、"C "など。ユーザーがソース リポジトリからレイヤ スタックにビデオ ソースをドラッグすると、ドロップ ゾーンで表されます。//注: 後方互換性のため、これらの入力の拡張子 "Image" は無視されます。
入力オプション
対応する入力キー
ビデオ入力キーがある場合、それに応じて次の入力キーにも情報が入力される：
(例："tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
| キー | タイプ | 商品説明 |
|---|---|---|
| オーディオゲイン | 番号 | 未定 |
| オーディオレベル0 | 番号 | ゲインコントロール後の左オーディオチャンネルレベル（単位：db |
| オーディオレベル1 | 番号 | ゲインコントロール後の右オーディオチャンネルレベル（単位：db |
| オーディオレベル0生 | 番号 | ゲインコントロール前の左オーディオチャンネルレベル（単位：db |
| オーディオレベル1生 | 番号 | ゲインコントロール前の右オーディオチャンネルレベル（単位：db |
| オーディオパニング | 番号 | 未定 |
| オーディオボリューム | 番号 | 未定 |
| データ | 構造 | ソースのメタデータの辞書。現在実装されているキーは以下のとおり："index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier" である。 |
| 名称 | ストリング | 関連する画像ソースの名前。プレビューでその名前を表示したり、 レイヤーバリアントのデフォルト名を計算したりするのに使います。参照 tvOut_SettingName . |
| 残り時間 | 番号 | 秒単位。ムービーソースに提供されます。ムービー・ソースがループしている場合は -1。 |
| タリーステート | インデックス | 接続ソースのタリー状態 タリー州 州 |
| タイプ | インデックス | 価値 ソースタイプ タイプ |
グループ化入力
グループ化はユーザーインターフェイスで行われます。構文は tvGroup___ のように動作します。グループ名の後のダブルアンダースコア _ _ は入力名の区切り文字であることに注意してください。
常に隠されるべき入力のために特別なグループが定義されています：tvGroup_Hidden_Inputs__ このグループは、debug|Debug Preferences|Debug PreferencesでmimoLiveをデバッグモードに切り替えることで可視化できます。いくつかのレイヤーは、"プレビューインスタンス "と "ライブインスタンス "の間で通信するために、これらの隠しフィールドを使用しています（例えば、ビデオスイッチャーレイヤーは、どのビデオソースが現在ライブであるかをプレビューインスタンスに伝えています）。
入力を動的に隠す
tvOut_hide_出力が "true "に設定されている場合、すべてのプロトコル入力はUIで非表示になります。この値はアプリケーションによって監視され、動的に変更することができます。tvIn "を含む完全な入力名を使う必要があることに注意してください(例えば、入力tvIn_Text_TypeMultilineに対して出力tvOut_hide_tvIn_Text_TypeMultilineを使います)。
出力
| 名称 | タイプ |
|---|---|
| tvOut_Cursor | ストリング |
| tvOut_Done | ブール（信号） |
| tvOut_hide_ | ブーリアン |
| tvOut_不透明 | ブーリアン |
| tvOut_SettingName | ストリング |
| tvOut_Share_ | 任意のタイプ |
| tvOut_残り時間 | 番号 |
| tvOut_UseCompositedLayersImage | ブーリアン |
| tvOut_TallyState | インデックス タリー州 州 |
| tvSet_ | 設定する入力のタイプ |
| tvSetSignal_ | ブーリアン |
| tvSetAudioVolume_ | 番号 |
| tvSetAudioVolumeSignal_ | ブーリアン |
tvOut_Cursor
この出力は、マウスポインタがプレビューまたはプログラム出力ビューのいずれかにある場合のマウスカーソルの外観を指定します。有効な値については、Apples NSCursor Class documentationを参照してください。mimoLiveが提供する追加のマウスカーソルは、"マイナス "と "プラス "です。
AppleのNSCursor定数から"_Cursor "または "Cursor "という接頭辞を削除（例えば、オープンハンドマウスカーソルを取得するには "openHand "を使用）。
tvOut_Done
このレイヤーが終了したことを次のレイヤーに伝えるために使用します。ドキュメントは tvIn_OnAir を参照してください。
tvOut_hide_
パラメータ・ビューで入力値を動的に非表示にするために使用できます。Hide Inputs Dynamically を参照してください。
tvOut_不透明
このレイヤーより下のレイヤーは描画する必要がないことをアプリケーションに伝えるために使用します。デフォルトは "false"。この値は、アルファを含むすべての接続ソースに上書きされます。
tvOut_SettingName
コンポジションは、いくつかの入力に基づいて、セッティングに有用な名前を提案することができる。
tvOut_Share_
レイヤー間の値の共有 を参照してください。
tvOut_残り時間
アプリケーションに大きなタイマーカウントダウン（例：ムービーが終わるまで5秒）を表示できるようにします。現在"-1 "は残り時間についての情報がないことを示し、"-2 "はループしているムービーであることを示します。
tvOut_UseCompositedLayersImage
トランジションなどで下のレイヤーを使用する際のパフォーマンスを最適化するために使用します。レイヤーが現在、合成されたレイヤー画像の入力を必要としていることをアプリに伝えます。tvOut_UseCompositedLayersImage "が存在しない場合、mimoLiveは画像より下のレイヤーは常に入力されるべきであると仮定します。描画の最適化のみで、すべてのメディアはロールされません。tvIn_CompositedLayersImage が存在する場合のみ使用されます。
tvOut_TallyState
この出力レイヤーは、現在その入力に接続されているソースの自動タリー状態を上書きすることができます。これは、トランジションや、ソースが出力に使用されない場合に、タリー状態をオフに切り替えるのに便利です（例えば、Video Switcher は 3 台のカメラを使用しますが、一度に 1 台しか表示しないため、未使用のソースのタリー状態を "TVTallyStateOff" に設定する必要があります）。タリー状態のリストについては、タリー状態を参照してください。
tvSet_
mimoLiveでは、レイヤーやフィルターはそれ自身のパラメーターを操作することができます。これは主に、レイヤーバリアントのプレビューで直接操作機能を実装するためです（例えば、ユーザーがプレビューでアナログクロックをドラッグすると、レイヤーはどの入力キーをどの値に変更すべきかをmimoLiveに伝えます）。しかし、この機能は、ライブデータをプログラムアウトインスタンスからプレビューインスタンスに転送したり、逆に転送したりするためにも使用されます（例えば、ビデオスイッチャーレイヤーでは、プログラムアウトインスタンスがプレビューインスタンスにどのビデオソースが現在ライブであるかを伝え、プレビューインスタンスはプログラムアウトインスタンスにユーザーが画面上で選択したビデオソースを伝えることができます）。
この機能を利用するには、操作したい入力フィールドに対応する2つの出力が必要である：tvSet_'で設定したい新しい値を出力し、'tvSetSignal_'でその値が有効で保存されることを知らせる。
tvSetSignal_
tvSet_ を参照してください。
tvSetAudioVolume_
この出力は、関連するオーディオソース（またはビデオソースのオーディオ）の音量を制御する。有効な値は0=silentから1=fullです。コンポジションは、オーディオボリュームレベルを変更したいたびに、対応する "tvSetAudioVolumeSignal_"を設定する必要があります。例えば、レイヤーにフェードインのトランジションがあり、オーディオもフェードインしたい場合に便利です。
tvSetAudioVolumeSignal_
tvSetAudioVolume_ を参照してください。
レイヤー間の値の共有
レイヤーは、レイヤースタック内の他のレイヤーにデータを送信することができます。データは次のレンダリングサイクルまで、mimoliveによって共有キーで保存されます。レイヤーが複数回使用された場合（または同じ共有キーが異なるレイヤーで使用された場合）、データは上のレイヤーによって上書きされます。この共有データを設定するには、"tvOut_Share_"出力を使用します。QuartzComposerのデータ型であれば何でも格納できるが、複数の値に対して1つの出力があればよいので、構造体を推奨する。受信レイヤー側では、まったく同じデータ型の対応する "tvIn_Shared_" 入力が必要である。受信レイヤーは、レイヤースタック内で送信レイヤーの上にある必要があることに注意。
値の共有は、複数のレイヤーで同じデータが必要な場合に便利です（例：試合のホームとゲストの対戦相手の名前）。
型定義（別名：命名規則）
| キー | タイプ | 商品説明 |
|---|---|---|
| *オーディオ | 画像 | これは非常に特殊なケースです：TypeAudioは、オーディオを含むソース（ムービーソース、ビデオソース、オーディオのみのソースなど）のみを割り当てることができます。レイヤーは、このソースを(将来的に)コントロールし、"_TypeAudioAudioLevel0 "と"_TypeAudioAudioLevel1 "入力によって、左チャンネルと右チャンネルのオーディオボリューム値をコントロールします。 |
| *タイプBoinxX | 番号 | BoinxのX座標で入力された数値（例：-1が最初のピクセル、1が現在の画面寸法の最後のピクセル。 がピクセル単位でユーザーに表示されます。 |
| *タイプBoinxY | 番号 | BoinxのY座標で入力された数値-例えば-1は一番下のピクセル、1は現在の画面寸法の一番上のピクセル。 ピクセル単位でユーザーに表示される |
| *タイプディレクトリパス | ストリング | UIに "Choose... "ボタンが表示され、パスコントロールも表示される。 |
| *期間 | 番号 | 秒単位の時間 - 分：秒で表示され、カスタムUIを取得できます。 |
| *ファイルパス | ストリング | UIに "Choose... "ボタンが表示され、パスコントロールも表示される。 |
| *タイプフォント倍率 | ストリング | BoinxのY座標でのフォントサイズ（例えば2はフルスクリーンの高さ）。 |
| *フォントカラー | カラー | テキストの色を指定するための通常の色入力。 |
| *フォント名 | ストリング | これにより、フォント・チューザーが表示されます。 |
| *_タイプマルチライン | ストリング | 複数行のテキストフィールド。 |
| *パスワード | ストリング | パスワードテキストボックスを表示します。重要：パスワード自体はプレーンテキストで保存され、文書内で読むことができます！ |
| *タイプシグナル | ブーリアン | 単一フレームのパルス信号には、PulseパッチまたはWatcherパッチを使用する。 |
TypeFontName、_TypeFontBoinxSize、_TypeFontColorフィールドは、同じベースラベルを持つ場合、レイヤーパラメータビューで1つのフォントチューザーUI要素にまとめられます。
フィルターテンプレート
これらの入力とプロパティは、mimoLive で画像フィルターとして使用する Quartz Composition を作成する場合に固有のものです。これまでの定義のほとんどはフィルターにも適用されます。
フィルター入力
以下の入力フィールドは、Quartz Composer がフィルターコンポジションに必要とするものです：
| 名称 | タイプ | 商品説明 |
|---|---|---|
| プロトコル入力_プレビューモード | ブール | プレビューモードであることをコンポジションに伝えるために使用できる。 |
| プロトコル入力_X | 番号 | 常に0である。 |
| プロトコル入力_Y | 番号 | 常に0である。 |
フィルター特性
tv_FilterIdentifierとtv_FilterVersionは、フィルタとその更新パスを新しいバージョンで処理するために必要です：
| 名称 | タイプ | サンプル値 | 商品説明 |
|---|---|---|---|
| tv_FilterIdentifier | ストリング | com.boinx.mimoLive.layer.placer | 識別のため、Boinxはさまざまなバージョンを分類して出荷した。 |
| tv_FilterVersion | 数字（ダブル） | 1 | 文書/アプリケーション内のコンポジションの異なるバージョンを照合するため。メジャーバージョン番号は非互換性を示し、他のメジャーバージョンとは一致しない。マイナーバージョン番号は上位互換でなければならず、繰り返しごとに0.001ずつ増加します。例えば、1.0のレイヤーから1.013のレイヤーに設定を読み込んでも、まったく同じに見えるようにしなければなりません。つまり、新しいキーがある場合は、それを表示しないか、前のバージョンの外観と同じになるようなデフォルトが必要です。 |
| tv_FilterOutputIsOpaque | 論理和 | フィルター出力が不透明かどうかを決定する。デフォルトはNO。 |
列挙
Quartz Composer の Index タイプでは、名前付きインデックスを使用できる。インデックスモードで入力スプリッタを追加することで、Quartz Composer Editor で編集できる。
ソース・タイプ
ソースは以下の値のいずれかとなる。
- 0 - イメージ
- 1 - ムービー、ムービーには残り時間があります
- 2 - カメラ、コンポジションかもしれません。
移行方向
独自の方向を定義することができます。出荷されたレイヤーは以下の値を使用している。
- なし
- 左
- 右
- 上
- 下
トランジション・タイプ
独自のトランジション・タイプを定義することもできる。以下に便利な値の例を示します。
- 溶かす
- 拭く
タリー州
UIとTally Lightコンパニオンアプリで表現されるビデオソースには、いくつかのTally Stateが定義されています。
- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram
