【DaVinci Resolve】コンボボックスの選択文字列を取得する方法
まえがき
こんにちは。火注ゆかなです。
最近急に冷えてきましたね。私も喉の調子が悪い日が続いています。みなさんは大丈夫でしょうか?
今回の話題はインスペクタのコンボボックスとマルチボタンについてです。
こういうのですね。ユーザーコントロールで追加できます。
コンボボックスとマルチボタンは値を取得すると、選択したアイテムやボタンに応じて0 ~ アイテム数
の数値を返却します。
でもこれ、ちょっと使いづらいですよね?
数値で取得できた方が良い場面もありますが、選択した文字列が返ってくる方が直感的でわかりやすいと思いますし、その方が楽な場面もあります。
で、そういう選択文字列を取得するための設定方法が We Suck Less フォーラムで投稿されていましたので、その内容を紹介します。
……一応言い訳させてもらうと、今回の記事の内容は丸パクリじゃないですからね。
件の投稿に気付く前に Fusion SDK でも それっぽいの見つけましたし!
だからちゃんと補足情報もあります。本当ですよ?
更新履歴
- 2024/11/6
- 文字列で取得する方法と ID で取得する方法の 2 通りに分けました
- 項目を整理しました
- 2024/11/28
- bit ライブラリについて追記
コンボボックス・マルチボタンで文字列取得する方法
コントロールの追加
まず、コントロールの追加方法について簡単におさらいしておきましょう。
Fusion ページのノードを右クリックし、コントロールを編集
をクリックすると編集用のウィンドウが表示されます。
名前
にはコントロール横に表示するラベル名を、ID
には他のコントロールと被らない識別用 ID を設定してください。
入力
にはコントロールの種類を選択して、コンボボックスとマルチボタンの場合はウィンドウの右側で選択アイテムを設定します。
コンボボックスの編集例
マルチボタンの編集例
これでコントロールが追加できましたが、この方法で追加したマルチボタンは何故かコンボボックスになります。
「コントロールの編集」で追加したマルチボタンはコンボボックス表示になる
マルチボタンの表示を直す
マルチボタンの表示をボタン形式に直しましょう。
まず、ノードを選択してコピーし、テキストエディタに貼り付けます。
するとこんな風になります。(実際にはインデントや改行がされてないことが多いですが)
{
Tools = ordered() {
TextPlus1 = TextPlus {
CtrlWZoom = false,
Inputs = {
GlobalIn = Input { Value = 100, },
GlobalOut = Input { Value = 428, },
Font = Input { Value = "Open Sans", },
Style = Input { Value = "Bold", },
VerticalJustificationNew = Input { Value = 3, },
HorizontalJustificationNew = Input { Value = 3, }
},
ViewInfo = OperatorInfo { Pos = { 275, 115.5 } },
UserControls = ordered() { -- 追加したコントロールのリスト
ComboBox = { -- コンボボックスの属性
LINKS_Name = "コンボボックス",
LINKID_DataType = "Number",
INPID_InputControl = "ComboControl",
INP_Integer = false,
{ CCS_AddString = "Zero" },
{ CCS_AddString = "One" },
{ CCS_AddString = "Two" },
{ CCS_AddString = "Three" },
{ CCS_AddString = "Four" },
CC_LabelPosition = "Horizontal",
},
MultiButton = { -- マルチボタンの属性
LINKS_Name = "マルチボタン",
LINKID_DataType = "Number",
INPID_InputControl = "MultiButtonControl",
INP_Integer = false,
{ MBTNC_AddButton = "Zero" },
{ MBTNC_AddButton = "One" },
{ MBTNC_AddButton = "Two" },
{ MBTNC_AddButton = "Three" },
{ MBTNC_AddButton = "Four" },
MBTNC_StretchToFit = true,
}
}
}
},
ActiveTool = "TextPlus1"
}
その後、マルチボタンの属性にMBTNC_ForceButtons = true
を追加し、編集後のテキストをコピー → ノードを右クリックしてペースト
で置換すればボタン表示になります。
(ショートカットCtrl+V
だと選択ノードを置き換えるのではなく、新しくノードが追加されます)
{
Tools = ordered() {
TextPlus1 = TextPlus {
CtrlWZoom = false,
Inputs = {
GlobalIn = Input { Value = 100, },
GlobalOut = Input { Value = 428, },
Font = Input { Value = "Open Sans", },
Style = Input { Value = "Bold", },
VerticalJustificationNew = Input { Value = 3, },
HorizontalJustificationNew = Input { Value = 3, }
},
ViewInfo = OperatorInfo { Pos = { 275, 115.5 } },
UserControls = ordered() { -- 追加したコントロールのリスト
ComboBox = { -- コンボボックスの属性
LINKS_Name = "コンボボックス",
LINKID_DataType = "Number",
INPID_InputControl = "ComboControl",
INP_Integer = false,
{ CCS_AddString = "Zero" },
{ CCS_AddString = "One" },
{ CCS_AddString = "Two" },
{ CCS_AddString = "Three" },
{ CCS_AddString = "Four" },
CC_LabelPosition = "Horizontal",
},
MultiButton = { -- マルチボタンの属性
LINKS_Name = "マルチボタン",
LINKID_DataType = "Number",
INPID_InputControl = "MultiButtonControl",
INP_Integer = false,
{ MBTNC_AddButton = "Zero" },
{ MBTNC_AddButton = "One" },
{ MBTNC_AddButton = "Two" },
{ MBTNC_AddButton = "Three" },
{ MBTNC_AddButton = "Four" },
MBTNC_StretchToFit = true,
MBTNC_ForceButtons = true, -- ←これを追加するとボタン表示になる
}
}
}
},
ActiveTool = "TextPlus1"
}
ボタン表示に直った
文字列で取得できるようにする
さて、追加したコントロールをそのまま参照すると、前述の通り選択位置に応じた数値が返却されます。
コンボボックス・マルチボタンの値を参照すると選択位置が返ってくる
コンボボックスの選択アイテムの文字列を参照したい場合、対応する文字列を何らかの形で持っておく必要があります。
スクリプトや Fuse なら self:SetData(key, value)
等でテーブルで保持することもできますが、コントロールに設定するエクスプレッションではiif
で条件分岐するくらいしかありません。
選択肢が 1 つや 2 つなら良いかもしれませんが 10 や 20 になるとお手上げです。
なので、コンボボックスの選択結果を指定の文字列で返すコントロールに書き換えましょう。
コントロールの設定を書き換える
まず、マルチボタンの表示を直した時のように、ノードをテキストエディタへコピペしてください。
その後、以下の項目を修正します。
- LINKID_DataType :
FuID
に変更 - INPID_InputControl :
ComboIDControl
またはMultiButtonIDControl
に変更
{
Tools = ordered() {
TextPlus1 = TextPlus {
CtrlWZoom = false,
Inputs = {
GlobalIn = Input { Value = 100, },
GlobalOut = Input { Value = 428, },
Font = Input { Value = "Open Sans", },
Style = Input { Value = "Bold", },
VerticalJustificationNew = Input { Value = 3, },
HorizontalJustificationNew = Input { Value = 3, }
},
ViewInfo = OperatorInfo { Pos = { 275, 115.5 } },
UserControls = ordered() { -- 追加したコントロールのリスト
ComboBox = { -- コンボボックスの属性
LINKS_Name = "コンボボックス",
LINKID_DataType = "FuID", -- データタイプを Number -> FuID に変更
INPID_InputControl = "ComboIDControl", -- ComboControl -> ComboIDControl に変更
INP_Integer = false,
{ CCS_AddString = "Zero", },
{ CCS_AddString = "One", },
{ CCS_AddString = "Two", },
{ CCS_AddString = "Three", },
{ CCS_AddString = "Four", },
CC_LabelPosition = "Horizontal",
},
MultiButton = { -- マルチボタンの属性
LINKS_Name = "マルチボタン",
LINKID_DataType = "FuID", -- データタイプを Number -> FuID に変更
INPID_InputControl = "MultiButtonIDControl",
INP_Integer = false,
{ MBTNC_AddButton = "Zero", },
{ MBTNC_AddButton = "One", },
{ MBTNC_AddButton = "Two", },
{ MBTNC_AddButton = "Three", },
{ MBTNC_AddButton = "Four", },
MBTNC_StretchToFit = true,
MBTNC_ForceButtons = true, -- ←これを追加するとボタン表示になる
}
}
}
},
ActiveTool = "TextPlus1"
}
修正し終わったら Fusion ページへ貼り付けます。
この状態で先ほどと同じように値を参照すると、表示文字列が返ってくるようになりました。
選択したアイテムの文字列が返ってきた
表示文字列とは異なる ID で取得できるようにする
表示文字列を取得できるようになりましたが、表示されてる文字列ではなく、対応する文字列を取得するようにしたいという場合もあるでしょう。
早い話、スクリプトでは半角英数字の方が処理しやすくて都合が良いです。
でも GUI としてユーザに表示するなら日本語の方がわかりやすいですよね。 そういう時に使い分けられます。
そういう場合、選択アイテムの属性に CCID_AddID
か MBTNCID_AddID
を追加すればOKです。
コントロールの設定を書き換える
ノードをテキストエディタへコピペして、以下の項目を修正します。
- LINKID_DataType :
FuID
に変更 - INPID_InputControl :
ComboIDControl
またはMultiButtonIDControl
に変更 - 選択アイテム :
CCID_AddID
またはMBTNCID_AddID
を追加
{
Tools = ordered() {
TextPlus1 = TextPlus {
CtrlWZoom = false,
Inputs = {
GlobalIn = Input { Value = 100, },
GlobalOut = Input { Value = 428, },
Font = Input { Value = "Open Sans", },
Style = Input { Value = "Bold", },
VerticalJustificationNew = Input { Value = 3, },
HorizontalJustificationNew = Input { Value = 3, }
},
ViewInfo = OperatorInfo { Pos = { 275, 115.5 } },
UserControls = ordered() { -- 追加したコントロールのリスト
ComboBox = { -- コンボボックスの属性
LINKS_Name = "コンボボックス",
LINKID_DataType = "FuID", -- データタイプを Number -> FuID に変更
INPID_InputControl = "ComboIDControl", -- ComboControl -> ComboIDControl に変更
INP_Integer = false,
{ CCS_AddString = "Zero", CCID_AddID = "Zero_ID"}, -- アイテムに ID を追加する
{ CCS_AddString = "One", CCID_AddID = "One_ID"},
{ CCS_AddString = "Two", CCID_AddID = "Two_ID"},
{ CCS_AddString = "Three", CCID_AddID = "Three_ID"},
{ CCS_AddString = "Four", CCID_AddID = "Four_ID"},
CC_LabelPosition = "Horizontal",
},
MultiButton = { -- マルチボタンの属性
LINKS_Name = "マルチボタン",
LINKID_DataType = "FuID", -- データタイプを Number -> FuID に変更
INPID_InputControl = "MultiButtonIDControl",
INP_Integer = false,
{ MBTNC_AddButton = "Zero", MBTNCID_AddID = "Zero_ID"}, -- アイテムに ID を追加する
{ MBTNC_AddButton = "One", MBTNCID_AddID = "One_ID"},
{ MBTNC_AddButton = "Two", MBTNCID_AddID = "Two_ID"},
{ MBTNC_AddButton = "Three", MBTNCID_AddID = "Three_ID"},
{ MBTNC_AddButton = "Four", MBTNCID_AddID = "Four_ID"},
MBTNC_StretchToFit = true,
MBTNC_ForceButtons = true, -- ←これを追加するとボタン表示になる
}
}
}
},
ActiveTool = "TextPlus1"
}
修正し終わったら Fusion ページへ貼り付けます。
この状態で先ほどと同じように値を参照すると、対応する ID が返ってくるようになりました。
選択したアイテムに対応する ID が返ってきた
その他
エクスプレッションで参照する
選択アイテムの文字列をエクスプレッションで参照する場合、ComboBox.Value
という風に記述してください。
文字列を返すコントロールの値は.Value
を付けること
これは文字列を返すコントロール全般に当てはまります。
文字列を返すコントロールの値はstring
型ではなくcdata
型であるためです。
フレームレンダースクリプトを記述する時も引っかかりやすいポイントですね。
デフォルト値を指定する方法
選択アイテムの属性値が CCS_AddString
のみか、CCID_AddID
も追加しているかで少し変わります。
個人的には CCS_AddString
のみの場合の手法はあまりオススメしません。(備忘録として記述はしておきますが)
デフォルト値を設定するならCCID_AddID
も追加した場合の手法をオススメします。
CCS_AddString
のみの場合
選択アイテムの属性値が 以下の通りに属性値を修正・追記します。
- LINKID_DataType :
Text
に変更 - INPS_DefaultText : 初期表示したいアイテムの文字列を指定します。
{
Tools = ordered() {
TextPlus1 = TextPlus {
CtrlWZoom = false,
Inputs = {
GlobalIn = Input { Value = 100, },
GlobalOut = Input { Value = 428, },
Font = Input { Value = "Open Sans", },
Style = Input { Value = "Bold", },
VerticalJustificationNew = Input { Value = 3, },
HorizontalJustificationNew = Input { Value = 3, }
},
ViewInfo = OperatorInfo { Pos = { 275, 115.5 } },
UserControls = ordered() { -- 追加したコントロールのリスト
ComboBox = { -- コンボボックスの属性
LINKS_Name = "コンボボックス",
LINKID_DataType = "Text", -- データタイプを Number -> Text に変更
INPID_InputControl = "ComboIDControl", -- ComboControl -> ComboIDControl に変更
INP_Integer = false,
{ CCS_AddString = "Zero", },
{ CCS_AddString = "One", },
{ CCS_AddString = "Two", },
{ CCS_AddString = "Three", },
{ CCS_AddString = "Four", },
INPS_DefaultText = "Two", -- 初期表示アイテムの文字列
CC_LabelPosition = "Horizontal",
},
MultiButton = { -- マルチボタンの属性
LINKS_Name = "マルチボタン",
LINKID_DataType = "Text", -- データタイプを Number -> Text に変更
INPID_InputControl = "MultiButtonIDControl",
INP_Integer = false,
{ MBTNC_AddButton = "Zero", },
{ MBTNC_AddButton = "One", },
{ MBTNC_AddButton = "Two", },
{ MBTNC_AddButton = "Three",},
{ MBTNC_AddButton = "Four", },
INPS_DefaultText = "Four", -- 初期表示アイテムの文字列
MBTNC_StretchToFit = true,
MBTNC_ForceButtons = true, -- ←これを追加するとボタン表示になる
}
}
}
},
ActiveTool = "TextPlus1"
}
コンボボックスでは Two 、マルチボタンでは Four が初期表示されるようになった
CCID_AddID
も追加している場合
選択アイテムの属性値に INPID_DefaultID
属性を追加し、初期表示したいアイテムの ID を指定します。
{
Tools = ordered() {
TextPlus1 = TextPlus {
CtrlWZoom = false,
Inputs = {
GlobalIn = Input { Value = 100, },
GlobalOut = Input { Value = 428, },
Font = Input { Value = "Open Sans", },
Style = Input { Value = "Bold", },
VerticalJustificationNew = Input { Value = 3, },
HorizontalJustificationNew = Input { Value = 3, }
},
ViewInfo = OperatorInfo { Pos = { 275, 115.5 } },
UserControls = ordered() { -- 追加したコントロールのリスト
ComboBox = { -- コンボボックスの属性
LINKS_Name = "コンボボックス",
LINKID_DataType = "FuID", -- データタイプを Number -> FuID に変更
INPID_InputControl = "ComboIDControl", -- ComboControl -> ComboIDControl に変更
INP_Integer = false,
{ CCS_AddString = "Zero", CCID_AddID = "Zero_ID"}, -- アイテムに ID を追加する
{ CCS_AddString = "One", CCID_AddID = "One_ID"},
{ CCS_AddString = "Two", CCID_AddID = "Two_ID"},
{ CCS_AddString = "Three", CCID_AddID = "Three_ID"},
{ CCS_AddString = "Four", CCID_AddID = "Four_ID"},
INPID_DefaultID = "Two_ID", -- 初期表示アイテムの ID
CC_LabelPosition = "Horizontal",
},
MultiButton = { -- マルチボタンの属性
LINKS_Name = "マルチボタン",
LINKID_DataType = "FuID", -- データタイプを Number -> FuID に変更
INPID_InputControl = "MultiButtonIDControl",
INP_Integer = false,
{ MBTNC_AddButton = "Zero", MBTNCID_AddID = "Zero_ID"}, -- アイテムに ID を追加する
{ MBTNC_AddButton = "One", MBTNCID_AddID = "One_ID"},
{ MBTNC_AddButton = "Two", MBTNCID_AddID = "Two_ID"},
{ MBTNC_AddButton = "Three", MBTNCID_AddID = "Three_ID"},
{ MBTNC_AddButton = "Four", MBTNCID_AddID = "Four_ID"},
INPID_DefaultID = "Four_ID", -- 初期表示アイテムの ID
MBTNC_StretchToFit = true,
MBTNC_ForceButtons = true, -- ←これを追加するとボタン表示になる
}
}
}
},
ActiveTool = "TextPlus1"
}
コンボボックスでは Two 、マルチボタンでは Four が初期表示されるようになった
マルチボタンはトグルタイプと併用不可
マルチボタンはMBTNC_Type = "Toggle"
を属性に追加するとトグルタイプになります。
デフォルトのノーマルタイプがラジオボタン(一つをONにすると他がOFFになる)のような挙動をするのに対して、トグルタイプはチェックボックスのように複数選択が可能になります。
Zero と Two が同時に押された状態になっている
ノーマルタイプだと押したボタンの位置によって0 ~ ボタン数-1
の数値を返しますが、トグルタイプはボタンのON/OFF状態をビットで返します。
例えば、上の画像だと5つのボタンがあります。
各ボタンのON/OFF状態をON = 1
OFF = 0
として並べると、全部OFFなら00000
ですし、全部ONなら11111
になります。
で、先ほどの画像では Zero(1桁目)
とTwo(3桁目)
がONになっていました。これをビットで表すと00101
になります。
(ビットとボタンの配置で左右が逆になるので、ちょっと混乱するかもしれません。)
ビットは2進数なので、これを10進数に変換するには
上記の例だと1桁目なら
ビット演算ができればマルチボタン(トグルタイプ)のフラグ管理が楽にできると思います。
まあ、 DaVinci Resolve が対応してるのは Lua5.1 なのでビット演算できないんですけど。**
本題に戻りますが、トグルタイプはMultiButtonIDControl
では指定できません。
指定するとマルチボタンを押してもボタンが変更されなくなるので注意が必要です。
あとがき
コンボボックス・マルチボタンで選択アイテムの文字列を取得できるようにする方法についての説明は以上となります。
この設定ができるとエクスプレッションやスクリプトでコンボボックス周りの処理がスマートになるかもしれません。ならないかもしれません。
とりあえず前回よりは需要があるはず。
私も Fuse を組んでて「選択アイテムに対応した ID を直接取得できれば楽なのに」と悩んでたところなので、少なくとも私には有益な情報でした。
DaVinci Resolve の開発陣がもっと詳細な資料を出してくれれば助かるのですが。
それでは、この記事が皆様のお役に立てば幸いです。
Discussion