[TouchDesigner]gitでのバージョン管理を支援するtox


この記事はTouchDesigner Advent Calendar 2020の2日目の記事です。

前日(1日目)の記事は @miwa_maroon さんの「[Touchdesigner]新卒でもハンドトラッキングできるんじゃ! leapmotionとともに」です。

翌日(3日目)の記事は @shks さんの「ParsecTOP : ParsecをTouchDesignerで使って低遅延60FPSストリーミング送受信 」です。


さてみなさんいきなりですが、toeファイルのバージョン管理、諦めてませんか?

> git log --oneline --name-status
f4b6ef7 (HEAD -> main) パラメータをいい感じに変更
M       proj/main.toe
dfc410b みやすく整理
M       proj/main.toe
d4425b2 いい感じのフィルタを追加
M       proj/main.toe
78f5ca4 テクスチャサイズをちょっと小さくした
M       proj/main.toe

コミットメッセージを細かく書こうにも限界があるし、自動マージ無理だしコンフリクトなんて起きたときはもう、ねえ?

要は変更の差分が見えれば良いわけなので、それができるものを作ってみました。

使い方

NetworkExporter.toxをどこかに置くだけ!

できること

  • 監視対象(デフォルト:/)とその下層のオペレーターの情報(オペレータータイプ、位置、サイズ、タグ、コメント、各種フラグ、OP間の接続、パラメータ)をJSONファイルにexport
  • 上記処理をPreSave/PostSaveからフック

上のスクショの状態だと、書き出されるファイル群はこんな感じになります。
オペレーター毎にJSONファイルがあり、COMPに対しては同名のフォルダがくっつき、下層の情報がフォルダ内に書き出されています。
network_structureはtoxのパラメータで指定できる書き出しパス

エスケープシーケンスで読み辛いけど書き出しのスクリプトはこんな感じ(ちなみにこれは書き出しスクリプトが書いてあるTextDATのエクスポート結果。TouchDesignerのファイルの中身をこういう形で見せられるの、すごくよくない?)
export_script
module_extract

JSONファイルはデータ毎にいちいち改行するフォーマットになっているので、gitでdiffを見るのに向いていると思います。
TextDATやTableDATの内容もちょっと冗長な感じ(JSON string arrayなので……)になってしまいますが一応行ごとに差分が取れる作りになってます。

こういうファイルがオペレーター毎に作られます。

execute1.json
{
    "name": "execute1",
    "OPType": "executeDAT",
    "comment": "",
    "nodeX": 100,
    "nodeY": 275,
    "nodeWidth": 130,
    "nodeHeight": 90,
    "storage": {},
    "tags": [],
    "replicator": null,
    "activeViewer": false,
    "allowCooking": true,
    "bypass": false,
    "cloneImmune": false,
    "render": false,
    "viewer": true,
    "inputConnectors": [
        {}
    ],
    "outputConnectors": [
        {}
    ],
    "par": [
        {
            "name": "projectpresave",
            "val": false,
            "expr": "op('par1')['Exportonpresaving']",
            "enableExpr": null,
            "exportOP": null,
            "exportSource": null,
            "bindExpr": null,
            "bindReferences": [],
            "mode": "EXPRESSION"
        },
        {
            "name": "projectpostsave",
            "val": false,
            "expr": "op('par1')['Exportonpostsaving']",
            "enableExpr": null,
            "exportOP": null,
            "exportSource": null,
            "bindExpr": null,
            "bindReferences": [],
            "mode": "EXPRESSION"
        }
    ],
    "text": [
        "# me - this DAT",
        "# ",
        "# frame - the current frame",
        "# state - True if the timeline is paused",
        "# ",
        "# Make sure the corresponding toggle is enabled in the Execute DAT.",
        "",
        "def onStart():",
        "\treturn",
        "",
        "def onCreate():",
        "\treturn",
        "",
        "def onExit():",
        "\treturn",
        "",
        "def onFrameStart(frame):",
        "\treturn",
        "",
        "def onFrameEnd(frame):",
        "\treturn",
        "",
        "def onPlayStateChange(state):",
        "\treturn",
        "",
        "def onDeviceChange():",
        "\treturn",
        "",
        "def onProjectPreSave():",
        "\top('export_script').run()",
        "\treturn",
        "",
        "def onProjectPostSave():",
        "\top('export_script').run()",
        "\treturn",
        "",
        "\t"
    ]
}

実際のgit差分は例えばこんなふうに見えます。
NetworkExporterという名前のbaseCOMPの位置を動かして、Watchtargetという名前のパラメータを変更したコミット
(View this commit on GitHub)

できないこと

  • exportした情報のimport
    とりあえずunsupportedですが、やりたいところではありますね・・・。
    ちなみに公式ツールのtoeexpand/toecollapseを使えばできるらしい。
    教えていただきました。

toeexpand/toecollapseについて

これらを使いたい場合はこちらに、git commitをフックしてtoeexpandを叩くスクリプトを作ったのでこれを使うと捗るかもしれません。
https://github.com/nariakiiwatani/toeexpand-git-pre-commit
macのみ対応してますが、toeexpandのパスを書き換えるだけでWindowsでも動くんじゃないかと思うのでそのうちやるかもしれません。

toeexpandも、各オペレーターやそれらの構造をテキストファイルに展開してくれるツールなのでgit管理のために使おうと思えば使えると思うんですが、個人的には、あんまりこのツールで書き出した情報が人間に読みやすいかというとそうでもない気がしてるので、やはりやるなら自前でも作っておきたいかな、と思っています。

その他

  • WatchTarget/にして書き出すと、ルートにrootという名前のbaseCOMPがあるのがわかりました。普通に使ってると目に入りませんがそういう作りになってるんですねえふむふむ。
    これもしかして唯一の「名前とネットワークパスとが一致しないオペレーター」なのでは?
    https://github.com/nariakiiwatani/VersioningTouchDesignerNetwork/blob/4076f1aa7ce43ac28aeb38f548088212cc576b9f/network_structure/.json

  • Pro版のSave Privateで保存されたtoxはどう見えるんですかね・・・?

  • もし興味を持って使ってみたいという方がいらっしゃれば、ベータテスター的な感じで使用感や改善点の感想をもらえると嬉しいです。
    もしインポートできるツールを作るなら有料で公開かなと思っているんですが、なんらかフィードバックくださった方には無償で提供します。(結局作らなかったり、気が変わって無料で公開したらすみません・・・!)