前置き#
DaVinci Resolveで動画編集する際に、字幕の入力が面倒だった。字幕を1かたまり作成する時に以下の作業が必要になる。
- Text+オブジェクトを配置
- 文字を設定
- フォントを設定
- サイズを設定
- タイムライン上の位置、長さの設定
最後の項目は自動化が難しいが、他は自動化できないか調べたら、どうやらスクリプト機能で実現できるようだったので調べた。以下はその備忘録。
使用環境#
- Windows 11
- DaVinci Resolve 20.2.1
- Python 3.13.7
参考資料#
C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting\README.txt が一次資料らしいのでそれを読んでいく。
LuaかPythonで書けるらしい。Luaであればインタプリタの導入は必要ないし、試しにLuaで書こうと思ったが、Luaの場合いまいちモジュール名がREADMEには書かれておらず不明瞭な点と、Pythonのほうが書き慣れているということでPythonを選択する。
またText+に関してはFusionの機能であり、Fusion関連であれば詳細なドキュメントがある。
Fusion8 Scripting Guide
Pythonの導入#
自分のWindows環境にはこの時点でPythonが入っていなかったため、Pythonを入れる。
https://www.python.org/ からインストーラをDLして来ればよい。
READMEには以下の変数を設定しろと書いてある。内容的にPythonのモジュールパス関連の設定のようだ。
1
2
3
| RESOLVE_SCRIPT_API="%PROGRAMDATA%\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting"
RESOLVE_SCRIPT_LIB="C:\Program Files\Blackmagic Design\DaVinci Resolve\fusionscript.dll"
PYTHONPATH="%PYTHONPATH%;%RESOLVE_SCRIPT_API%\Modules\"
|
GUIの場合はシステム環境変数の設定画面から環境変数を設定すればよいが、PowerShellの場合は以下のコマンドでシステム環境変数を追加できる（管理者権限で実行すること）。
1
2
3
4
5
6
7
| $env:RESOLVE_SCRIPT_API="$env:PROGRAMDATA\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting"
$env:RESOLVE_SCRIPT_LIB="C:\Program Files\Blackmagic Design\DaVinci Resolve\fusionscript.dll"
$env:PYTHONPATH="$env:PYTHONPATH;$env:RESOLVE_SCRIPT_API\Modules\"
[Environment]::SetEnvironmentVariable("RESOLVE_SCRIPT_API", "$env:RESOLVE_SCRIPT_API", 'Machine')
[Environment]::SetEnvironmentVariable("RESOLVE_SCRIPT_LIB", "$env:RESOLVE_SCRIPT_LIB", 'Machine')
[Environment]::SetEnvironmentVariable("PYTHONPATH", "$env:PYTHONPATH", 'Machine')
|
これでDaVinci Resolveのコンソールから、関連モジュールがimportできるようになる。
下記redditによると、DaVinciのコンソールからならimport文は不要らしい。
https://www.reddit.com/r/davinciresolve/comments/1frb4lj/save_me_please_from_this_modulenotfound_error/?tl=ja
コンソール画面を開く#
Workspace → Console を押す。
プロジェクトの取得#
Py3のタブを押し、スクリプトを入力していく。
現在開いているプロジェクトのオブジェクトを取得する。
1
2
| project_manager = resolve.GetProjectManager()
project = project_manager.GetCurrentProject()
|
以下のように出力されていれば問題ない。
タイムラインの追加#
タイムラインを作成してメディアプールに追加する。
1
2
| mediapool = project.GetMediaPool()
timeline = mediapool.CreateEmptyTimeline("Timeline1")
|
EditページにText+を追加する#
試しにテキストを追加してみる。以下の処理を実行する。
- 現在のTimelineを取得
- Timelineに
Text+ を作成し挿入 → TimelineItem オブジェクトが帰ってくる - TimelineItem からFusion Compositionを取得（
GetFusionCompByIndex(1) ） → Composition オブジェクトが返ってくる - Composition オブジェクトからFusionノードのリストを取得（
GetToolList() ） - リストの1番目から
Text+ ノードを取得 - ノードのプロパティを設定する
1
2
3
4
5
6
7
8
9
| timeline = project.GetCurrentTimeline()
newtext = timeline.InsertFusionTitleIntoTimeline("Text+")
tool_list = newtext.GetFusionCompByIndex(1).GetToolList()
text_plus = tool_list[1]
text_plus.StyledText = 'Hello'
text_plus.Red1 = 1.0
text_plus.Green1 = 1.0
text_plus.Blue1 = 1.0
|
ちなみに、ノードが持つプロパティ名はGUIのインスペクタから調べられる。変えたいパラメータ名の上にマウスをかざすと、画面左下にプロパティ名が表示される。
テキストファイルから文字を取得してテキストを挿入する#
ここまでDaVinci Resolve固有のライブラリの操作方法がわかれば、あとは普通にテキストファイルを読み込んで自動挿入することができる。
例えば以下のようなテキストファイルを用意する。ファイル C:\Users\bombrary\Desktop\neko.txt として保存されているものとする（エンコーディングはUTF-8）。
1
2
3
4
5
6
7
8
9
| わがはいは猫である。名前はまだ無い。
どこで生れたかとんと見当けんとうがつかぬ。
何でも薄暗いじめじめした所でニャーニャー泣いていた事だけは記憶している。
吾輩はここで始めて人間というものを見た。
しかもあとで聞くとそれは書生という人間中で一番獰悪どうあくな種族であったそうだ。
この書生というのは時々我々を捕つかまえて煮にて食うという話である。
しかしその当時は何という考もなかったから別段恐しいとも思わなかった。
ただ彼の掌てのひらに載せられてスーと持ち上げられた時何だかフワフワした感じがあったばかりである。
掌の上で少し落ちついて書生の顔を見たのがいわゆる人間というものの見始みはじめであろう。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
| import time
timeline = project.GetCurrentTimeline()
with open("C:\\Users\\bombrary\\Desktop\\neko.txt", "r", encoding="utf-8") as f:
for line in f:
styled_text = line.strip()
print(styled_text)
newtext = timeline.InsertFusionTitleIntoTimeline("Text+")
tool_list = newtext.GetFusionCompByIndex(1).GetToolList()
text_plus = tool_list[1]
text_plus.StyledText = styled_text
text_plus.Font = "Yu Gothic"
text_plus.Style = "Regular"
text_plus.Size = 0.05
text_plus.Red1 = 1.0
text_plus.Green1 = 1.0
text_plus.Blue1 = 1.0
time.sleep(0.5)
|
まとめ#
DaVinci ResolveとPythonを使って、テキストを自動挿入する方法を作った。ある程度は単純作業が簡略化できてうれしい。