configureLayerを使おう

SOLARIS で USD の構造を作るときに、「どこをどのように分けて構築するか」というのはとても重要なことです。なのですが、ぱっと見てどのように制御するのかがとてもわかりにくかったので手順とかをまとめてみようと思います。

SOLARIS でのレイヤー表示

SOLARIS 上でのレイヤーがどのように切り分けられているかというと、ノードの縁の色単位で表示がわかるようになっています。上の画像の場合は、 assetName と payload1 が同じレイヤー cube2 が別のレイヤーとして作成されます。

レイヤーを編集する

ここでいうところの「レイヤー」というのは、いわゆる USD のファイルのことです。つまり現状だと assetName Prim と cube2 Prim それぞれが存在する USD ファイルがあることになります。

ただし、とくに何もしていない場合このレイヤーは「Anonymous レイヤー」というオンメモリー上にのみ存在するレイヤー扱いになり、

途中コンポジションされている Cube2 の Prim レイヤーがオンメモリー上にしか存在しないレイヤーになってしまうので、 USDROP ノードで Export するとエラーアイコンが表示されてしまいます。

!!! info このあたりの問題は、 http://ikatnek.blogspot.com/2020/06/usd-rop.html こちらに詳細が書かれています

なので、各レイヤーの構造を維持したまま（Flatten しないで）レイヤーワケした状態で Export したい場合は、 ConfigureLayer ノードを利用して、レイヤー設定を追加します。

結果がこちら。 Cube は cube.usda メイン部分は payload.usda という形で出力され、

#usda 1.0
(
    endTimeCode = 1
    framesPerSecond = 24
    metersPerUnit = 1
    startTimeCode = 1
    timeCodesPerSecond = 24
    upAxis = "Y"
)

def Xform "assetName"
{
    def Xform "model" (
        prepend payload = @./cube.usda@
    )
    {
    }
}

cube をペイロードした usda が出力されます。

つまり、 ConfigureLayer ノードは接続されたレイヤーに対して設定を変更する事ができるノードというわけですね。

例えば Cube 側の ConfigureLayer をみてみます。 SavePath はそのレイヤーをどこに保存するのか、DefaultPrimitive はレイヤーのデフォルト Prim をなににするかの設定です。

#usda 1.0
(
    defaultPrim = "cube2"
    framesPerSecond = 24
    metersPerUnit = 1
    timeCodesPerSecond = 24
    upAxis = "Y"
)

def Cube "cube2"
{
    float3[] extent = [(-1, -1, -1), (1, 1, 1)]
    double size = 2
    matrix4d xformOp:transform = ( (1, 0, 0, 0), (0, 1, 0, 0), (0, 0, 1, 0), (0, 0, 0, 1) )
    uniform token[] xformOpOrder = ["xformOp:transform"]
}

その結果出力されるレイヤー。 defaultPrim として cube2 が指定されていることがわかります。

Configure Layer で DefaultPrim が指定されているので、 Payload ノードの Reference Primitive で「 Reference Dfault Primitive 」を指定してペイロードすることができます。

他の設定も色々いれてみると

#usda 1.0
(
    "Hello World"
    customLayerData = {
        string testCustomData = "Test Test!!"
    }
    defaultPrim = "cube2"
    endTimeCode = 240
    framesPerSecond = 24
    metersPerUnit = 1
    startTimeCode = 1
    timeCodesPerSecond = 24
    upAxis = "Y"
)

色々仕込むことができました。

編集部分だけ別レイヤー出力

ConfigureLayer を使用すると、指定の部分のレイヤーの出力パスを編集しレイヤーに対してメタデータを仕込んだりできることができました。次は、編集した部分のみを別ファイルとして切り出してコンポジションしてみます。

全体図がこんな感じになります。 Cube を動かして、動かした部分だけを別レイヤー化してそのファイルをペイロードでロードします。

なので、

モデル部分（cube1）
Edit 部分それぞれをレイヤーとして保存するために、ConfigureLayer ノードで出力先などのレイヤー設定を追加します。

そしてそのレイヤーをペイロードに入れて USD_ROP で Export します。

ここでの注目ポイントは「layerBreak」ノードです。

この layerBreak ノードは、Input から入力された Stage を USDROP などで Export するときのみ Export しないようにするノードです。

なので

こんなかんじにモデルを Input して編集するときに、layerBreak を使用すると Input の Mesh 情報はレイヤーには保存されず、編集情報のみが

over "cube1"
{
    matrix4d xformOp:transform:edit1 = ( (1, 0, 0, 0), (0, 1, 0, 0), (0, 0, 1, 0), (0, 5, 0, 1) )
    uniform token[] xformOpOrder = ["xformOp:transform", "xformOp:transform:edit1"]
}

over でレイヤーに保存されます。

この layerBreak がないと、編集対象が Edit ノードにないためすべてエラーになってしまいます。

Variant Block の場合

更に別のコンポジションを追加してみます。 Houdini の Variant には VariantBlock という、すでにある Prim に対して over で Varinat を作れる機能があります。

詳細はこちらに書いてあります。

これを SOLARIS 上でコンポジションしつつ、サブレイヤーでも合成してみます。

といっても、基本的な方針は同じです。 BaseModel（モデルの実体部分）のレイヤー、Variant 部分のレイヤー、その後に最後に別途編集したい場合。 Variant 側は Variant Block 自体が layerBreak を使用したのと同じ状態になっています。なので、そちらは layerBreak なしでレイヤーを構築して Configure します。それだけだと、BaseModel に Variant が合成されないので、Merge（サブレイヤー）で合成します。

そのあとに別レイヤーで指定のマテリアルを編集したい場合は、layerBreak して編集して configureLayer してレイヤーを出力その結果をサブレイヤー合成して出力します。

上２つのみで基本モデル、別途バージョン違いだったりカットごとの微調整なんかのパターンの場合は EditMaterial 部分のような構造にしておくと 1 レイヤーあたりのファイルサイズが少なく（差分のみ保持）されます。

サンプルは :fa-download:こちら

まとめ

Houdini のノードと USD のシーングラフ構築がいまいち結びつかなくてなかなか意図した構造を作ることができませんでしたが、レイヤーの構造と Configure 系ノードの使い方を理解したおかげで狙った構造が組めるようになりました。

ので、組み方ははわかったので実際のところどうやると良さそうなのかを次は考えてみようと思います（2020 年アドカレネタ）

SOLARIS でのレイヤー表示​

レイヤーを編集する​

編集部分だけ別レイヤー出力​

Variant Block の場合​

まとめ​

SOLARIS でのレイヤー表示

レイヤーを編集する

編集部分だけ別レイヤー出力

Variant Block の場合

まとめ