Layout LOPノードには、ポイントインスタンスモデル(例えば、木、茂み、岩、建物)をシーン内にインタラクティブに配置可能なブラシモードがあります。 このノードがマウスイベントからどのようにインスタンスを生成するべきなのかは、 ブラシアセット 側で制御します。 SOPネットワークで独自の挙動が定義された独自のブラシアセットを作成することができます。

このブラシの挙動はコンパイルSOPブロックで定義されているので、カーブやポリゴンの操作ノード、ばら撒きノード、WrangleによるVEXコードを含む(コンパイル可能な)SOPのフルパワーを活かすことができます。

ブラシアセットにパラメータインターフェスを加えることができます。 このインターフェースは、ブラシがアクティブな時にLayout UI内に表示されます。 これによって、あなたの使い勝手に合わせてブラシの挙動をカスタマイズすることができます。

ブラシを実装する前に、おそらく以下のテーマを理解している必要があります:

• コンパイルブロック。ブラシの実装は、(親のLayoutノードから高パフォーマンスでその実装を呼び出せるように)コンパイルブロックの中で行ないます。コンパイルブロック内で使用可能なSOPノードには制限事項があり、SOPノードがクックするエクスプレッションにも制限事項があります。

• WrangleノードとVEXスニペット。たいていの場合、何かしらの挙動を実装する最も簡単な方法は、Attribute Wrangleを使用してアトリビュートを読み込んで、値を計算し、新しいアトリビュートを書き出すことです。とはいえ、これにはVEXスニペットとビルトインのVEX関数に関してある程度の知識が必要になります。

• ブラシは、6本の入力と2本の出力を持ったSOPアセットです。ブラシは、新規ポイントを作成したり、既存ポイントを修正/削除することができます。

• ブラシの中のネットワークには、ユーザがマウスを動かす度に何回も呼び出されるコンパイルブロックが存在します。

• このコンパイルブロックの入力には、親のLayout LOPからの現行ステートとユーザが実行した内容に関する情報が格納されます。

• このコンパイルブロックは、ユーザがストロークを開始する前にマウスを動かしただけでも呼び出されます。これによって、ガイドとプレビューを表示させることができます。

  Switch Ifノードは、特定のマウス操作固有の挙動(例えば、ユーザがマウスをドラッグしている時にポイントのみを出力)を制御するのに役立ちます。

• トランスフォームを表現するレイアウトブラシの規則は、Scatter and Align SOPなどの多くの一般的なSOPから出力されるのと同じでpscaleとorientのアトリビュートで表現されています。

  Note

  他のインスタンス系アトリビュートを追加すると、 現在とこれまでの編集されたすべてのポイント のpscaleとorientのすべてのアトリビュートが上書きされておかしな挙動を招く可能性があります。

• 独自のPointアトリビュートを出力すると、その編集されたすべてのポイントの結果のインスタンス上にPrimitiveアトリビュートが作成されます。アトリビュートが増えるとパフォーマンスが悪くなってしまうので、あまり大量のアトリビュートを取り込まないように注意してください。

• ワーキングセットのモデルをポイント上にインスタンス化するために、以下の事を行ないます:

  • ポイントのasset_indexアトリビュートに、インスタンス化したいモデルに呼応した6番目の入力( Working Set )のポイントのポイント番号を設定します。

• (“New Points”入力または“Existing Points”入力のどれかからの)ポイントを修正するには、以下の事を行ないます:

  • ポイントの位置を設定するには、vector3タイプのP Pointアトリビュートを設定します。

  • ポイント上にインスタンス化されるモデルの向きとスケールを設定するには、その回転とスケールをmatrix3タイプのtransform Pointアトリビュートにエンコードする必要があります。

    Transform SOPを使用すれば、簡単にtransformアトリビュートを設定/編集することができます。 Transofrm SOPをネットワークに追加し、そのノードの Rotate パラメータと Scale パラメータに必要な値を設定し、 Attributes パラメータをtransformに設定してトランスフォームをそのアトリビュートに書き出します。

  • 修正したポイントを1番目の出力に送ります。

    既存のポイントを修正した場合、そのポイントは削除され、それと同じ新しいポイントが次の呼び出し時に1番目の入力( New Points )に追加されます。 そのため、ストロークで編集した既存のポイントは、そのストロークの“New Points”の一部になります。

  Note

  インスタンスをスケール/回転させるには、標準のorientvector4アトリビュートとpscalefloatアトリビュートで エンコードしなければなりません 。 他のインスタンス系アトリビュートを使用すると、スケール/回転が上書きされて不当な効果を招く可能性があります。

• 既存のポイントを修正しなかった場合、それらのポイントを出力に送らないでください(出力は常に現在のストロークで作成された新しい一連の“New Points”を表現します)。ブラシが既存のポイントに影響を与えなかった場合、その2番目の入力をどこかにまったく接続する必要はありません。

• 既存のポイントを削除するには、そのポイント上に整数delete Pointアトリビュートを作成し、その値を1に設定します。次に、そのポイントを1番目の出力にマージします。

  現在のストローク(1番目の入力( New Points ))からポイントを削除するには、単にそのポイントを出力に送らなければよいだけです。

• 通常では、1回のストロークが終了した時のマウスのUpイベントでそのブラシのコンパイルブロックのポイント出力が“確定”されて、Layoutノードのポイントインスタンスデータに統合されます。

• 必要に応じて、ユーザが複数のストロークを1オペレーションとして作成できるようにブラシを実装することができます。

  例えば、クリック/ドラッグの度にユーザが開始点と繋げてフェンスを閉じない限り(または、ユーザがEnterを押してフェンスを開いたままで抜けない限り)フェンス内に新しいコーナーが作成されるフェンス描画ブラシを実装することができます。

  マルチストローク操作を使用することで、ユーザは矩形を描画することもできます。その場合、1回のストロークで矩形の一辺の長さを定義し、次のドラッグでその一辺に隣接する辺を引っ張り出してその長さを定義します。

• 現在のオペレーションを現在のストロークの後に続けたいことを親のLayoutノードに伝えるために、1番目の出力にend_stroke Detailアトリビュートを追加して値を0に設定します。

  Layoutノードは、そのアトリビュートが存在することを確認したら、現在のオペレーションをアクティブなままにします。 すると、以降のストロークは、“Existing Points”と同じリストにポイントの追加を継続するようになります。

• 次に、現在のオペレーションを終了することを親のLayoutノードに伝えるために、1番目の出力yのそのend_stroke Detailアトリビュートの値を1に設定します。

  フェンスの作成を例にすると、Attribute Createノードを作成してend_stroke整数Detailアトリビュートを作成し、そのノードを1番目の出力に接続することになります。 そしてエクスプレッションやAttribute Wrangleノードを使用して、もし現在のストロークが開始点または1回目のストロークの近くにあればそのアトリビュート値を1に、そうでないなら0に設定します。

  Layoutノードは、end_strokeが存在することを確認し、その値が1に設定されていれば、出力を確定します。

• ユーザはEnter`を押すことでいつでもストロークを終了して現在のオペレーションを確定することができます。

• マルチストロークなブラシを実装するのは非常に複雑ですが、いくつか役に立つテクニックがあります。

  • 一連のSwitch Ifノードを使用して個々のブランチを切り替えることで、異なるイベントタイプを制御することができます。

  • Invocation(呼び出し)とストロークの間で情報を渡す必要がある場合は、1番目の出力に独自のDetailアトリビュートを設定すると良いでしょう。オペレーションが確定しない限り、その1番目の出力からそのDetailアトリビュートが1番目の入力( New Points )にコピーされるようになります。

    矩形の描画の例では、Detailアトリビュートを使用することで、現在のストロークがオペレーションの 1回目 それとも 2回目 のどちらのストロークなのか追跡することができます。

ユーザがオペレーションを終了した時:

• Layoutノードは、出力ジオメトリに追加されたすべてのDetaiアトリビュートをクリアします。

  出力ジオメトリ上に作成したDetailアトリビュートは、次の反復の1番目の入力( New Points )のDetailアトリビュートとして利用可能です。 これらのDetailアトリビュートを使用して反復(または、マルチストロークなブラシのストローク)間で情報を渡しても、その情報はオペレーション間では渡りません。

• Layoutノードは、ブラシから生成されたすべてのプリミティブも念のためにクリアします。

  ポイントクラウドのマージが頻繁に行われるので、プリミティブが呼び出されると、そのプリミティブのマージによってすぐに指数関数的に重くなりHoudiniがロックアップしてしまいます。

ブラシ用にパラメータインターフェスをデザインすることができます。 そして、そのブラシのコンパイルブロック内でchエクスプレッションを使用してパラメータの値を読み込んで、その値を使ってそのブラシの挙動を変更することができます。

例えば、ユーザがドラッグした時にブラシがばら撒くポイント数を制御することができるDensityパラメータ(内部名がdensity)をブラシアセット上に追加したとします。 そのブラシのコンパイルブロック内で、例えば、Scatter SOPの Force Total Count パラメータにch("../density")のエクスプレッションを使用することで、そのDensityパラメータの値をコピーすることができます。

ブラシがLayoutノード内でアクティブになっている時、そのLayoutノードのインターフェースは、パラメータエディタで表示されるものと同じブラシパラメータを表示します。

ユーザがスクロールホイールを使ってブラシの挙動を変更できる方法が2つあります。

• ブラシのパラメータインターフェースに内部名がscrollで始まるパラメータがあれば、ユーザがマウスホイールをスクロールするとそのパラメータ値が増減します(2個以上のパラメータがscrollで始まっている場合、Layoutノードはそれらすべてのパラメータを変更します)。

• アセットのPythonモジュール内にonMouseWheelEvent(kwargs)関数を実装すれば、ユーザがマウスホイールをスクロールすると、Layoutノードステートがその関数をコールします。

ブラシの半径(または同等のアトリビュート)のサイズ変更の規則は、Attribute Paint SOPやVellumブラシと同様で⌃ Ctrl + ⇧ Shift + です。

ブラシでこれを有効にするには、影響を与えたいパラメータ(s)に対してdrag_resizeタグを追加します。

デフォルトでは、パラメータを変更すると、ブラシの最後の呼び出しが再適用されます。 これは、たいていのパラメータでは望ましいですが、場合によっては、フォルダなどの整理整頓系パラメータがあったり、ブラシモードを制御するメニューパラメータであっても最後のストロークに変更を加えたくないものもあります。

特定のパラメータ変更によるブラシの呼び出しを無効にするには、そうしたいパラメータに対してlayout_ignoreタグを追加します。

ブラシ作成者のあなたは、ユーザが選んだモデルのワーキングセットの使い方を決めることができます。 ワーキングセット内のアイテムの順番に意味を持たせるのかどうか選択することができます。

• ワーキングセットのよくある使われる方は、(例えば、シーン内にアイテムをばら撒く時に)ワーキングセットからランダムにアイテムを選択することです。

• ブラシは、ワーキングセットの順番を利用することができます。例えば、ワーキングセット内の1番目のアイテムをシーンに投入し、そのアイテムを中心に2番目のアイテムのインスタンスをおおまかに円状にばら撒いて、さらにそのインスタンスを中心に3番目のアイテムを円状にばら撒くといったブラシを作成することができます(これは、周辺に岩、枯れ枝などの小さな生態系をもった木々を散乱させるのに役立ちます)。

  アイテムをランダムに配置するブラシの他の例を挙げると、アイテムの順番を利用して、ワーキングセット内の順番が先のアイテムほど確率が高くなるように、各アイテムが選択される確率に影響を与えることができます。

• 現在のところ、ブラシがワーキングセットの順番に意味をもたせているかどうかをブラシ利用者に自動的に伝える方法がありません。そのため、ブラシのドキュメントにそのことを記載するか、または、ブラシのパラメータインターフェースで制御できるようにする必要があります。

• 生成されたポイント上に上手くランダムにワーキングセットを配置する方法は、ワーキングセット入力にConnectivity SOPを接続し、ピースアトリビュート名をasset_indexに設定してから、Attrib From Pieces SOPを使用してポイントにピースを割り当てます。

デジタルアセットには、Pythonソースコードを格納するために使用できるセクションが用意されています。 これは、アセットの様々なコールバックで利用できるように共有された便利関数を格納するのに役立つことが多いです。 さらには、もしあればアセットのインタラクティブステートの実装の格納先としても役立ちます。

ブラシアセットに対して、親のLayoutノードはそのアセット内のいくつかの関数をチェックします。

現在のところ、Layoutノードステートは、ブラシアセットのPythonモジュール内に以下の関数が存在すれば、その関数を使用します。

def registerGadgets():
    return [("line_gadget", hou.drawableGeometryType.Line), ("face_gadget", hou.drawableGeometryType.Face)]

def onDrawGuides(kwargs):
    draw_handle = kwargs['draw_handle']
    guide_geo = kwargs['guide_geo']
    line_gadget = kwargs['gadgets']['line_gadget']
    face_gadget = kwargs['gadgets']['face_gadget']

    line_gadget.setGeometry(guide_geo)
    line_gadget.show(True)
    line_gadget.draw(draw_handle)

    face_gadget.setGeometry(guide_geo)
    face_gadget.show(True)
    face_gadget.draw(draw_handle)

def onMouseWheelEvent(self, kwargs):
    # Get the UI device object
    device = kwargs["ui_event"].device()
    scroll_amount = device.mouseWheel()

def hudTemplate():
    return [
        {"key": "G", "label": "Change brush shape"},
        {"key": "mousewheel", "label": "Change brush radius"},
        {"key": "LMB", "label": "Scatter instances"},
        {"key": "Shift + LMB", "label": "Smooth instance orientations"},
    ]

def hudTemplate():
    return [{
        'id': 'info',
        'label': ''
    }]

def hudUpdate():
    # パラメータコールバックスクリプトでlayout.utils.requestHUDUpdate()をコールすることで、
    # この関数を発動させることができます。
    # 何のモードがアクティブになっているのか評価して、そのモードに応じて'info'ラベルを更新します。
    import layout.utils
    node = layout.utils.currentBrushNode()
    mode = node.evalParm("mode")

    if mode == 0:
        label = 'Define grid'
    elif mode == 1:
        label = 'Define disk radius'
    elif mode == 2:
        label = 'Draw scatter region'
    else:
        raise ValueError("Invalid brush mode.")

    return  {'info': {'label': label, 'key': 'LMB'}}

def radialMenu(kwargs):
    node = kwargs["node"]

    entries = {}
    entries['n'] = {
        'type':'script_action',
        'label':'Reset Radius',
        'script': lambda: node.setParm("radius", 1.0)
    }
    entries['e'] = {
        'type':'script_action',
        'label':'Embiggen Instances',
        'script': lambda: node.setParm("instance_scale", node.evalParm("instance_scale") + 1.0)
    }
    entries['s'] = {
        'type':'script_action',
        'label':'Disembiggen Instances',
        'script': lambda: node.setParm("instance_scale", node.evalParm("instance_scale") - 1.0)
    }
    return entries

スクリーン空間で動作するブラシの作成を簡単にするために、5番目の入力( Stroke )にscreen_to_world_xform Detailアトリビュートが用意されます。 このトランスフォーム行列は次の計算結果に相当します: viewport.windowToViewportTransform() * viewport.viewportToNDCTransform() * viewport.ndcToCameraTransform() * viewport.cameraToModelTransform() * viewport.modelToGeometryTransform()

これが意味していること言葉で説明すると、ワールド空間のポイントをスクリーン空間にマッピングしています。 しかし、適切なスクリーン空間の位置を取得するには、その結果のベクトルを'w'コンポーネントで除算して非同次化する必要があります。 非同次化すると、xとyのコンポーネントは、スクリーン座標を示し、zコンポーネントは-1から1までのNDC座標の深度(-1がニアクリップ、1がファークリップに相当)を示します。

DeleteブラシやNudgeブラシなどの既存のスクリーン空間ブラシは単にコピーしてから必要に応じて変更することを強く推奨します。

• 2個以上のアイテムを持つワーキングセットからアセットの割り当てを制御するには、そのワーキングセットをConnectivity SOPに接続して、Pieceアトリビュート名をasset_indexに設定してから、そのConnectivity SOPをAttrib From Pieces SOPの2番目の入力に接続します(インスタンス先のポイントを1番目の入力に接続します)。

• Wrangleの入力内のポイントの数を取得するには、VEXスニペット内でnpoints(input_num)を使用します。これはWrangleで動作するものの、すべての入力をクックするので、コンパイルSOPsでは通常Spare入力を使用して、そのSpare入力に対してnpointsをコールする必要があります。例えば、npoints(-1)です。コンパイルSOPsを参照してください。

• コンパイルブロックの外側で、“セットアップ”を実施するノードを作成してから、もう1つCompile Block Startノードをそのコンパイルブロックに“追加引数”として追加して、その“外側”のノードをそのCompile Block Startノードに接続することができます。これらのノードは 1回だけ クックされ、その静的な結果をそのブロック入力からブロック内で利用可能になります。

  例えば、何か複雑なガイドジオメトリをセットアップしたい時に、Invocation中はトランスフォームのみが変わり、ジオメトリ自体が変わらないのであれば、コンパイルブロックの外側でそのジオメトリを作成して、それをコンパイルブロックに接続すれば、Invocationの度にジオメトリが再生成されなく済みます。