ZBrushのZScript入門

漠然とZBrushのプラグインか何かを作れるようになりたいとか思いながら、何も手をつけずに6年も経った(笑)



公式ドキュメントを読んでも、イマイチZScriptやZPluginの感覚(メンタルモデル)が掴めなかったのだ。
http://docs.pixologic.com/user-guide/customizing-zbrush/zscripting/
http://docs.pixologic.com/reference-guide/zscript/

記法もわからない段階からZScriptをゼロから書こうとしてもなかなか前に進まないので、とりあえずZScriptに慣れるところから始めようか。
まずはUI操作を記録してZScriptに書き出してみよう。こちらの記事を参考に↓
http://sassembla.github.io/Public/2018:01:19%2022-12-27/2018:01:19%2022-12-27.html

GUI上での操作がScriptコマンドとして残るのはMayaのMELみたいですね。



普段よくやる操作をZScriptで簡略化するのを最初の目標とする。
最近のアヴァンガメラ制作作業の区切りで必ずやっている作業履歴の動画書き出し(F履歴録画)設定をZScriptで自動化してみよう。
ZBrushでUndo Historyを動画に書き出す
ちょっと遅いけど、ZBrush 2019にアップグレードした。で、バージョン2019の新機能とは全然関係なく(笑)、最近になってZBrushのUndo Historyを動画にできることを知った。Undo History Moviesモデルの...


この設定値はZProjectに保存されず、毎回リセットされてしまうので地味に時間を取られていた。

ZScriptのRecord(記録開始)を押して、一連の操作を行ったらEnd Rec(記録停止)を押す↓



そして記録したZScriptをファイルに保存する。ZScriptの拡張子は普通に.txtなのね。
これが設定・録画のZScript↓

//RECORDED ZSCRIPT 2021
[IButton,Play,"Press to play this ZScript. ZScript can be aborted at anytime by pressing the eesci key.",
[IConfig,2021]
[IPress,Movie:Doc]
[IPress,Movie:Large]
[ISet,Movie:Modifiers:Recording FPS,30]
[IPress,Movie:TimeLine:Auto]
[ISet,Movie:Overlay Image :Opacity,0]
[ISet,Movie:Title Image :FadeOut Time,0]
[ISet,Movie:Title Image :FadeIn Time,0]
[IPress,Movie:F History]
]/*End of ZScript*/

ZScriptをシンタックスハイライトするVSCode拡張があるので有難く使わせていただく↓
https://marketplace.visualstudio.com/items?itemName=ouelletjonathan.zscript

読みやすくなった↓



.txtファイルと同じファイル名で一緒に出力される.zscファイルは何だろうと思ったら、ZBrushが.txtのZScriptを読み込むと同じフォルダにコンパイル済み(?)の.zscを書き出すのね。
Pytyonの.pyから.pycが作られるみたいな感じだな。(つまりバージョン管理外にしておいた方が良い)

あ、ZBrushのインストールフォルダの中のZPlugsフォルダ(またはZPlugs64フォルダ)に入っているのも.zscファイルだから、これらはつまりコンパイル済みのZScriptということか。そして、そのZScriptがdllを叩いているわけか。

ようやく理解した。ZPluginと呼ばれるものはZScriptの延長にあり、外部のデータやdllと連携するエントリポイントをZScriptで作るのね。
こちらのブログに書かれていることの意味が分かるようになってきたぞ↓
https://ichiyonnana.hateblo.jp/entry/2017/10/22/200228
https://ichiyonnana.hateblo.jp/entry/2017/10/23/030924

外部に処理を投げて、完了したら結果を受け取るコールバック的な実装はちょっと難しそうだな。クローズドにはSDKが存在するのかな。

公式のZScriptサンプルをちゃんと読んでみよう↓
http://docs.pixologic.com/user-guide/customizing-zbrush/zscripting/sample-zscripts/

ZPlugin interfaceのサンプルに従えば、パレットを自作してボタンから任意のコマンドや外部関数を叩けそうだな。
ZScriptの記法というか、コマンドの一覧はこちらを見れば良いのか↓
http://docs.pixologic.com/user-guide/customizing-zbrush/zscripting/command-reference/

同じページからZPluginのサンプルコードがダウンロードできるね。

GitHubを漁ってみると個人でZPluginを開発している人もチラホラいるようなので、SDKが開示されてなくても結構拡張できるようだ。
https://github.com/fuzzzzzz/zbrush-dll-template
https://github.com/n-taka/n_ZBrushPlugins

関連記事

ZBrushのキャンバスにリファレンス画像を配置する

Human Generator:Blenderの人体生成アドオン

Kaolin:3Dディープラーニング用のPyTorchライブラリ

ZBrushで人型クリーチャー

ポリ男からMetaHumanを作る

プロシージャル手法に特化した本が出てるみたい(まだ買わないけど)

IronPythonを使ってUnity上でPythonのコードを実行する

OpenCV 3.1のsfmモジュールのビルド再び

Live CV:インタラクティブにComputer Visionコーディングができるツール

書籍『ゼロから作るDeep Learning』で自分なりに学ぶ

Houdiniのライセンスの種類

CGのためのディープラーニング

『ピクサー展』へ行ってきた

Blenderでよく使うaddon

Maya には3 種類のシェーダSDKがある?

PythonでBlenderのAdd-on開発

ZBrushで基本となるブラシ

最近のフィギュアの製造工程

MeshLab:3Dオブジェクトの確認・変換に便利なフリーウェア

Paul Debevec

ZBrushで仮面ライダー3号を造る ベース編

OpenFace:Deep Neural Networkによる顔の個人識別フレームワーク

生物の骨格

iOSデバイスと接続して連携するガジェットの開発方法

ラクガキの立体化 目標設定

ZBrushと液晶ペンタブレットでドラゴンをモデリングするチュートリアル動画

ZBrushの練習 手のモデリング

Amazon EC2ログイン用の秘密鍵を無くした場合の対処方法

『パシフィック・リム: アップライジング』のVFXブレイクダウン まとめ

OANDAのfxTrade API

ZBrushでアヴァン・ガメラを作ってみる 口内の微調整・身体のライン修正

Unityで強化学習できる『Unity ML-Agents』

UnityでTweenアニメーションを実装できる3種類の無料Asset

ZBrushでアヴァン・ガメラを作ってみる 歯茎を別パーツへ分割

ZBrushでアヴァン・ガメラを作ってみる 下アゴの付け根を修正

ZBrushで仮面ライダー3号を造る 仮面編 ZRemesher

ドラマ『ファーストクラス』のモーショングラフィックス

『ハン・ソロ/スター・ウォーズ・ストーリー』のVFXブレイクダウン まとめ

ZBrushでゴジラ2001を作ってみる 側頭部のボリュームを探る

天体写真の3D動画

Math Inspector:科学計算向けビジュアルプログラミングツール

PGGAN:段階的に解像度を上げて学習を進めるGAN

コメント