Houdiniは現在ではSOHO(Scripted Output of Houdini Objects) Pythonバインディングを通してレンダラーと通信します。レンダラーすべてが、パラメータ定義と評価のために、同じプロセスを使います。MantraとRenderMan出力ドライバは現在では単にPythonスクリプトのフロントエンド(ユーザインターフェース)で、デジタルアセットになっています。各レンダラーにはそれ独自のパラメータ定義とバインディングをPythonマッピングによって追加することができます。

SOHOには主に2つメリットがあります:

• 別のレンダラー用に新しくレンダー出力ノードを定義するのが簡単です。SOHOには、レンダラー固有のファイルフォーマットを出力するのに必要な情報をHoudiniに問い合わせるインターフェースがあります。

• 新しくレンダーノードを作成してsoho_programパラメータ(以下参照)をカスタマイズすることでレンダー出力の生成をカスタマイズすることができます。いくつかのケースで、これは、ライト、カメラ、レンダーノードにレンダリングプロパティを追加するよりも便利で柔軟性があります。

SOHOインターフェースは、ジオメトリ、オブジェクトトランスフォーム、レンダリングプロパティをレンダラーに送信するために使います。それぞれサポートされているレンダラーには事前定義済みのレンダリングプロパティ一式があります。オブジェクトにそれらのプロパティのどれかをユーザパラメータとしてもっていれば、その値がレンダラーに送信されます。

“Edit Rendering Parameters”インターフェースを使ってオブジェクト(マテリアル)に追加可能な事前定義済みレンダリングパラメータ一式があります。これらのパラメータはHoudiniインターフェースからレンダラーのプロパティの1対1のマッピングに対応しています。

SOHOは、シェーダとレンダリングプロパティを処理するマテリアルワークフローを新しく作ります。詳細は、マテリアル、プロパティの上書きのヘルプを参照してください。

SOHOレンダラープロパティのデフォルト値はターゲットのレンダラーのデフォルト値に対応します。プロパティの値がデフォルト値のままであれば、プロパティは通常はレンダラーの入力ストリームに書き出しません。

Mantraレンダー出力デジタルアセットのType Propertiesを見ると、soho_programというパラメータが不可視になっているのがわかります。このパラメータにはHoudiniが出力ファイルを書き出すPythonスクリプトが含まれています(Mantraドライバの場合、IFDファイル)。

Pythonスクリプトには以下のようなコードが含まれています:

value = obj.getDefaultedFloat('vm_displacebound', 0.0)

(またはプロパティのバッチ評価)SOHOプログラムがこのようなパラメータを評価すると、プロパティの継承順を適用します。つまり、より具体的に定義したプロパティ(例えば、シェーダ上で定義)はより幅広く定義したプロパティ(例えば、出力ドライバノード上で定義)よりも優先順位が高いです。

SOHOのAPIと実装は$HFS/houdini/sohoのPythonスクリプトフォルダにあります。

SOHOの生成プロセスを制御するには、次のパラメータを使うことができます。

レンダリングプロパティに関する情報は、レンダリングプロパティのドキュメントを参照してください。

Mantraが知っているプロパティのリストを出力するには、ray_showコマンドを使用します。これは出力するプロパティのカテゴリを引数として受け取ります。

echo ray_show device | mantra
echo ray_show global | mantra
echo ray_show object | mantra
echo ray_show light | mantra
echo ray_show image | mantra
echo ray_show fog | mantra

SOHOはコールバックファンクションをサポートしています。または上級ユーザがレンダープロセスの低レベルパーツを修正、置換できるように フック します。

(Houdiniの以前のバージョンでは、SOHOの機能を変更する手段として“monkey patch”SOHOファンクションが可能でした。しかし、コールバックは、よりすっきりとして将来性のあるメソッドです。)

ドキュメントは、$HFS/houdini/soho/IFDhooks.pyや$HFS/houdini/soho/RIBhooks.pyを参照してください。

サンプルのフックファイル:

'''
    IFDuserhooks.py
    IFDhooksの機能について説明した簡単な例
'''
import traceback
from IFDapi import *

def pre_lockObjects(parmlist, objparms, now, camera):
    ''' SOHOがオブジェクトをロックする前にコールされます。
        これにより、SOHOから見えるオブジェクトを変更することができます。'''
    ray_comment('IFD Hook - rendering from camera: %s' % repr(camera))
    return False

def pre_render(camlist, now, objlist, lightlist, spacelist, foglist,
                fromlight, forphoton, cubemap, photoncam):
    '''画像がレンダリングされる前にコールされます。'''
    ray_comment('IFD Hook - Render at time: %g %s' % (now, repr(camlist)))
    return False

'''このファイル内のフックのリスト。'''
_HOOKS = {
    'pre_lockObjects'   : pre_lockObjects,
    'pre_render'        : pre_render,
}

def call(name='', *args, **kwargs):
    '''コールバック関数をフックします。'''
    method = _HOOKS.get(name, None)
    if method:
        try:
            if method(*args, **kwargs):
                return True
            else:
                return False
        except Exception, err:
            ray_comment('Hook Error[%s]: %s %s' % (name, __file__, str(err)))
            ray_comment('Traceback:\n# %s\n' %
                        '\n#'.join(traceback.format_exc().split('\n')))
    return False