コンテキストオプションはシーン固有の変数で役に立ちます。 例えば、render_quality変数を作成すれば、その変数をすべてのレンダーノードで参照することができ、shot_name変数を作成すれば、すべての非最終レンダリング画像の上にその文字列を重ねるといったことができます。

コンテキストオプションは、Context Options EditorまたはPythonスクリプトを使って作成し、エクスプレッションまたはPythonでそれらを使用することができます。

これは、特に同じHIPファイルを使って複数の ショット をレンダリングする時に役に立ちます。 ショット固有の値を含んだ変数をセットアップし、作業を別のショットに切り替える時にそれらの変数を変更することができます。

内部的には、コンテキストオプションは、 内部名 文字列をキーとした 浮動小数点 または 文字列 の値を保存することができます。 さらに、これらのキーは、“構成文字列”を各オプションに関連付けることができます。 Context Options Editorは、この文字列を使って、人が解読できるラベル、順序、ユーザインターフェースなどの追加情報を保存します。

エクスプレッション内に@name使用することで、コンテキストオプションの値を参照することができます。 例えば、内部名がrender_qualityのコンテキストオプションを作成すれば、メインのレンダーノードの Quality パラメータには@render_qualityを設定し、プレビュー用のレンダーノードの Quality パラメータには@render_quality / 2を設定することができます。

Pythonスクリプトでhou.setContextOption()とhou.contextOption()を使えば、コンテキストオプションを作成したり、その値を読み込むこともできます。

一部のグローバルコンテキストオプションは、Houdiniによって生成/管理されます。 これらの“自動”コンテキストオプションは、他のコンテキストオプションと同様に照会/変更することができ、 個々のノードによって上書きして、その入力のクックコンテキストを変更することができます。 しかし、そのようなコンテキストオプションを削除しても、上書きされた値がクリアされるだけです。 そのコンテキストオプションは依然存在し、再びHoudiniによって制御されます。 これらの自動コンテキストオプションのリストに関しては、hou.isAutoContextOption()を参照してください。

追加のコンテキストオプションは、HIPファイルと一緒に保存されます。 新規に作成したHIPファイルには、自動コンテキストオプション以外のコンテキストオプションがありません。 新規ファイルが常にデフォルトのコンテキストオプション設定で開始できるようにしたいのであれば、コンテキストオプションをJSONファイルとしてエクスポートし、スタートアップスクリプトである456.pyで、それらのJSONファイルをインポートすることができます。

• パラメータエクスプレッションに@nameを使用することで、そのコンテキストオプションの値を使用することができます。

• Pythonスクリプトでhou.contextOption()を使用することで、コンテキストオプションの値を取得することができます。

パラメータなどの他のHoudiniエレメントと同様に、コンテキストオプションは 内部名 (@nameエクスプレッションやスクリプトで使用する名前)と ラベル (Context Options Editorに表示される人が解読できる名前)を持ちます。

通常では Minimum と Maximum はスライダ範囲を設定しますが、この最小値未満の値やこの最大値より大きい値をユーザーが手動で入力することができます。 Min Locked や Max Locked を有効にすれば、ユーザーが手動で入力した値を強制的に最小値/最大値の範囲に収めることができます。

import os
menu = []
for name, value in os.environ.items():
    if not name.startswith("HOUDINI"):
        continue
    item = ("$" + name, value)
    menu.append(item)
return menu

以下のHOM関数は、コンテキストオプションの値をスクリプト制御することができます:

• hou.contextOptionNames()

• hou.setContextOption()

• hou.contextOption()

• hou.setContextOptionConfig()

• hou.contextOptionConfig()

• hou.removeContextOption()

Context Options EditorのExportとImportをスクリプト制御することもできます:

import contextoptions

# このシーン内のすべてのコンテキストオプションをJSONファイルにエクスポートします。
contextoptions.exportJson("options.json")

# JSONファイルからコンテキストオプションをインポートして、それらをこのシーン内の既存のコンテキストオプションにマージします。
contextoptions.importJson("options.json")

コンテキストオプションをインポートする前に既存のコンテキストオプションをすべてクリアするには、既存のコンテキストオプションすべてに対してループさせることで、それらのコンテキストオプションを削除することができます:

for name in hou.contextOptionNames():
    hou.removeContextOption(name)