スタイルシートはスタイルのコレクションです。 スタイルには、特定のプリミティブに合致させるターゲット条件、その合致したプリミティブのマテリアルまたはマテリアルパラメータの変更方法の命令が含まれています。 例えば、本質的には“char1オブジェクトの中, skinパックプリミティブの中, shirtグループ内のフェース, Diffuseカラーを青に変更”のようなスタイルを作成することができます。

• スタイルシートとは、パックプリミティブ内のジオメトリを選択できなくてマテリアルが適用できないという制限の回避策です。 その代わりに、マテリアルを設定/変更するためには、スタイルを使ってパックジオメトリを“ターゲット(特定)”しなければなりません。

• スタイルシートでは、レンダリング時の“実際の”ジオメトリのみをターゲットにすることができます。 スタイルシートは、レンダリング時にマテリアルの変更(スクリプトによる変更/ランダムな変更を含む)をインスタンスジオメトリとエージェントに適用することができます。 これによって、同じジオメトリのインスタンス化にはメリットがありますが、さらにそのインスタンスのルックを別のルックにすることも可能です。

• スタイルシートは、ジオメトリを編集したりシーン記述ファイル(IFD)を再生成することなくルックを変更することができます。 これは、巨大なシーンを取り扱うスタジオでは役に立ち、スタイルシートによる迅速な調整は巨大なIFDを再生成するよりも高速です。

スタイルシートは異なるレベルで適用することができます:

• Mantraコマンドラインの-Sオプションでスタイルシートを指定することができます。

• スタイルシートをシーンファイル(.hip)に保存することができるので、そのファイル内のジオメトリをターゲットにすることができます。

• Houdiniオブジェクトにスタイルシートパラメータを追加することができるので、オブジェクト内のジオメトリをターゲットにすることができます。

• material_stylesheetアトリビュートを使用したプリミティブにスタイルシートを指定することができます。パックプリミティブの場合、その中にあるパックジオメトリをターゲットにすることができます。

各レベルは、より低いレベルのジオメトリをターゲットにすることができます。

2つのレベルが同じジオメトリをターゲットにした場合、 高いレベルのスタイルシートが低いレベルを上書きします 。この順位にはいくつかメリットがあります:

• パックプリミティブ上のスタイルシートは、その中にあるジオメトリのマテリアル割り当て/マテリアルパラメータを上書きすることができます。

• コマンドラインによるトップレベルのスタイルシートを指定すれば、レンダリング時に何でも上書きすることができます。 これは、IFDを再生成することなくマテリアルの割り当てやマテリアルパラメータを変更することができるので、巨大なシーンで役に立ちます。

スタイルシート内で 後で リストしたスタイルは、前にリストしたスタイルを上書きします。

ビューポートは、スタイルシートによるジオメトリのマテリアルの割り当てとオーバーライドを表示することができます。 ビューポートのDisplay Optionsのコントロールを使用することで、特定のスタイルシートの機能(オーバーライド、パックプリミティブターゲット)を有効/無効にしたり、完全にスタイルシートの表示を無効にすることができます。

ビューポートでのスタイルシートの表示にはいくつか制限事項があります:

• スタイルシートがマテリアルの割り当てやGL Tagにタグ付けされているマテリアルパラメータの上書きをしている場合にのみ、その効果がビューポートに表示されます。

• デフォルトでは、リアルタイム表示を維持するために、単一オブジェクトに対して最大100個までのマテリアルのみをビューポートに表示します。この制限事項は、Display Options の Optimization タブで変更することができます。

• スタイルシートで“その場に応じて”定義されるマテリアルはビューポートには表示されません。

• スタイルシートを変更すると、ビューポートが更新されます。とはいえ、そのスタイルシートで参照されている外部スクリプトやCVEXノードの変更をHoudiniは検出しません。その表示を手動で更新するには、(ビューアの右側にある)ディスプレイオプションツールバーの View Materialsボタンを右クリックして、 Update stylesheets を選択します。

  (別の方法として、Display Optionsウィンドウの Optimize タブの Update ボタンをクリックすることができます。)

• 現在のところ、パックインスタンス毎にターゲットを変更するスタイルシートに関しては、そのインスタンスが2個以上ある時にターゲットがパックプリミティブ内にある場合は、そのマテリアルの変更をビューポートに表示させることができません。

スタイルの ターゲット 部分では、スタイルのオーバーライドの適用先となるジオメトリを指定します。

ターゲットは以下の4つのアイテムを含めることができます:

ターゲットは以下の 条件 を持つことができます。複数の条件を持たせた場合、ターゲットがそれらの条件に すべて 合致しなければなりません。条件がなければ、スタイルはすべてに合致します。

スタイルの オーバーライド には、合致したジオメトリに割り当てられたマテリアルを変更する方法を指定します。 新しいマテリアルを割り当てたり、マテリアルのパラメータ値を変更することができます。 また、静的な値を使用せずに、CVEXスクリプトを指定してオーバーライド値を計算することもできます。

スタイルには色々なタイプのオーバーライドを含めることができます。 各オーバーライドのタイプは、すべてのターゲットのジオメトリに対して定数を使って設定したり、ターゲットのコンポーネント毎に実行してそのコンポーネントの値を計算するCVEXスクリプトで 設定することができます。

スクリプトは、合致したジオメトリ上のアトリビュート値をCVEX関数の名前付き引数に“バインド”することができます。

ターゲットにしている階層内の高いターゲットレベルほど、 その レベルでアトリビュート値をバインドすることもできます。 そして、CVEXスクリプトへの引数として利用可能なそれらの バインドされたデータ を作成することができます。

例えば、スタイルがパックプリミティブ1と2をターゲットにしていると仮定すると、 サブターゲットは、そのパックプリミティブ内のcolor_primsグループに合致します。 パラメータオーバーライドスクリプトを使用すると、Mantraはcolor_prims内のプリミティブ毎に対してスクリプトを実行します。 スクリプトにはパックプリミティブのプリミティブ番号を知らせる必要があります。 それをするために、トップターゲットにintrinsic:indexorderアトリビュートの値をtop_level_primという名前に バインド することができます。 スクリプトがコールされると、Mantraは、そのスクリプトにパックプリミティブ番号を含んだtop_level_prim引数を渡します。

importFilesトップレベルキーは、スタイルシートの場所(ファイルパスまたはURL)を意味する文字列のリストにマップします。 それらのファイルからのデータは、現行スタイルシートに含まれます。現行ファイル内の共有されるスクリプトとオーバーライドセットは、そこに含まれているスタイルシート内の同じ名前のものを上書きします。

{
    "importFiles" : [ "mss/main_style.json", "prim_style.json" ]
}

scriptDefinitionsトップレベルキーは、共有スクリプト名をスクリプトオブジェクトにマッピングしたオブジェクトにマップします。

{
    "scriptDefinitions" : {
        "mss_shared_script" : {
            "code" : "cvex mySharedFn(int packed_id=0; int unpacked_id=0; export vector c={0,0,0}) { c.r = 0.3 * float(packed_id); c.g = 0.2 * float(unpacked_id); }",
            "bindings": {
                "unpacked_id" : "intrinsic:indexorder",
                "packed_id" : "top_level_prim"
            }
        }
    }
}

理論的には、スタイルシート内にマテリアルを定義することができます。 これにより、自己完結型のスタイルシートを作成することができ、新しいマテリアルを既に生成されたIFDファイルに取り込むことができます。 現実的には、これは、IFDシェーダ文字列を書き出すためのIFDに関する十分な知識が要求されます。

さらに、マテリアルのSurface/Displacementシェーダを定義したVEXコードをマテリアル定義に埋め込むことができます。 これをするには、そのシェーダのタイプに応じて、予約済みシェーダ名の“mss:surface_shader”または“mss:displace_shader”を使用する必要があります。 そのVEXコードは、それと同じ名前のプロパティとしてマテリアル定義に追加されます。 そしてさらに、これは、手動による作成ではなく、Pythonスクリプトで自動的にスタイルシートを生成するような大きなパイプラインで非常に役立ちます。

{
    "materialDefinitions" : {
        "mss_const_mat" : {
            "properties" : {
                "surface" : "opdef:/Shop/v_constant clr 0.1 0.1 0.8",
                        "displace" : "mss:displace_shader parm 0 0 1",
                        "mss:displace_shader" : "displace disp1(vector parm=0) { P = P + parm; }"
            }
        }
    }
}

stylesトップレベルキーは、スタイルオブジェクトのリストにマップします。

スタイルオブジェクトは以下のキーを持つことができます:

• target: ターゲットオブジェクト

• overrides: オーバーライドオブジェクト

{
    "styles" : [
        {
            "target" : {
                "type": "self",
                "objectName" : "/obj/colored_object"
            },
            "overrides" : {
                "material" : {
                    "name" : "mss_const_mat"
                },
                "materialParameters" : {
                    "clr" : [ 0.8, 0.1, 0.2 ]
                }
            }
        }
    ]
}

{
    "target" : {
        "group" : "1 2",
        "preBindings" : {
            "top_level_prim" : "intrinsic:indexorder"
        },
        "subTarget" : {
            "subTarget" : {
                "group" : "color_prims"
            }
        }
    },
    "overrides" : {
        "materialParameters" : {
            "clr" : {
                "script" : { "importScript" : "mss_shared_script" }
            }
        }
    }
}

targetオブジェクトには、スタイルの影響を受けるエンティティを指定します。ターゲットジオメトリを参照してください。

これは以下のキーを持つことができます:

{
    "target" : { "group" : "0 5 10 some_group" }
}

{
    "target" : { "group" : "@Cd.r>0.5" }
}

{
    "target" : {
        "group" : "0",
        "subTarget" : {
            "group": "10"
        }
    }
}

overridesオブジェクトには、スタイルがターゲットにしているプリミティブ上のマテリアルを変更する方法を指定します。オーバーライドを参照してください。

オーバーライドオブジェクトは以下のキーを持つことができます:

{
    "material" : {
        "name" : "/shop/material1"
    },
    "materialParameters" : {
        "clr" : [ 0.8, 0.1, 0.2 ],
        "reflect": 0.5,
    }
}

3つのキー内のvalueには、リテラル値(文字列、数値、配列)、{"script": script object}のようなオブジェクトを指定することができます。 scriptキーの値は、値の計算に使用するCVEXスクリプトを参照したスクリプトオブジェクトです。CVEXスクリプトの使い方を参照してください。

{
    "materialParameters" : {
        "clr" : {
            "script" : { "importScript" : "mss_shared_script" }
        }
    }
}

CVEXスクリプトの使い方を参照してください。オブジェクトは以下のキーを持ちます:

{
    "command" : "$HIP/cvex/recolor.vex",
    "bindings": {
        "unpacked_id" : "intrinsic:indexorder",
        "packed_id" : "top_level_prim"
    }
}

バインドオブジェクトは、名前によって関数の引数をアトリビュートまたは他の値にマッピングします。そのオブジェクト内のキーは、その関数の引数名を意味します。 スタイルシートの書式では、それらの値に対して幾つかのバインドメソッドをサポートしています。

デフォルトのバインドスタスタイルは、引数名とアトリビュート名(Intrinsicアトリビュートを含みます)を関連付けます。この値は、アトリビュート名の文字列です。 指定した名前のアトリビュートが見つからなければ、その名前でターゲットバインドを検索します。

別の方法として、文字列の代わりにオブジェクトを使って別のタイプのバインドを指定することができます。このオブジェクトは、バインドメソッドを決定するsourceTypeキーを持ちます:

"bindings": {
    "foo": {
        "sourceType": "default",
        "name": "P"
    },
    "bar": {
        "sourceType": "default",
        "name": "intrinsic:indexorder"
    }
}

"bindings": {
    "foo": {
        "sourceType": "preBinding",
        "name": "aTargetName"
    }
}

"bindings": {
    "stringArg": {
        "sourceType": "constant",
        "value": "string"
    },
    "intArg": {
        "sourceType": "constant",
        "value": 23
    },
    "vectorArg": {
        "sourceType": "constant",
        "value": [1.0, 1.0, 2.0]
    }
}