ビューアがジオメトリ選択モードの場合は現在のジオメトリ選択を返し、 それ以外の場合はNoneを返します。

ビューアがジオメトリ選択モードの場合は現在のジオメトリ選択を置換し、 それ以外の場合はhou.NotAvailableを引き起こします。 指定した選択がgeometry_typeに合致していない場合は、可能な限りそのgeometry_typeに自動的に変換されます。

シーンビューア内のプリミティブ選択のシーングラフパスのタプルを返します。

現行シーングラフプリミティブ選択を設定します。 fix_selection_pathsをTrueに設定すると、selection内の空っぽのパスまたは無効なパスが自動的に修復されます。 Falseに設定すると、無効なパスはhou.ValueErrorを引き起こします。

ビューアがスクリプトによる選択を行なっている場合の現在のジオメトリ選択パラメータ文字列を返します。 この文字列には、selectGeometryなどのメソッドに渡されたselect_parm引数が格納されます。

このメソッドは、hou.SceneViewer.selectPositionsに非常に似ていますが、位置のタイプが常にワールド空間で、位置のタプルではなく、 (position, orientation)のペアのタプルを返します。このpositionはhou.Vector3で、orientationはhou.Matrix3です。 これによって、基準平面や整列などの向きの補助が必要な時に、ユーザに向きと位置を促すことができます。

Scene Graph Viewデータが変更される度に増加する整数。 大きな変更が起きた場合にのみ数値が上がり、無駄に1が増えるわけではありません。

指定したピクセル座標に位置するプリミティブを検索します。 当たった位置におけるスクリーン深度とプリミティブパスのタプルを返します。 何もプリミティブが見つからなかった場合は(-1, “”)を返します。

ビューアの現行ツールステートの名前を返します。

ビューアの現行ツールステートを設定します。 wait_for_exitがTrueなら、この関数は、ビューアがツールを抜けるまで戻りません。

ビューアを、最後に選択したノードのノード固有のツールステートにします。 wait_for_exitがTrueなら、この関数はビューアがツールを抜けるまで戻りません。

ビューアをビューツールステートにします。 wait_for_exitがTrueなら、この関数はビューアがツールを抜けるまで戻りません。

ビューアを移動ツールステートにします。 これは、移動ツールをサポートしているノードコンテキストでのみ利用可能です。 wait_for_exitがTrueなら、この関数はビューアがツールを抜けるまで戻りません。

ビューアを回転ツールステートにします。 これは、移動ツールをサポートしているノードコンテキストでのみ利用可能です。 wait_for_exitがTrueなら、この関数はビューアがツールを抜けるまで戻りません。

ビューアをスケールツールステートにします。 これは、移動ツールをサポートしているノードコンテキストでのみ利用可能です。 wait_for_exitがTrueなら、この関数はビューアがツールを抜けるまで戻りません。

現行のViewer StateでUndo可能な処理を実行するためにUndoブロックを開きます。 これを開いた後に実行されたすべての処理がUndoスタック上に1個の処理として記録されます。 開いたブロックを閉じるには、hou.SceneViewer.endStateUndoを使用します。

beginStateUndoとendStateUndoを使用することで、ある関数で開始して他の関数で終了するUndoブロックを管理することができます。 一連のUndo可能な処理では、1個のUndoブロックしか対応していません。 UndoブロックをendStateUndoで閉じる前に2番目のbeginStateUndoコールが検出されると、例外が引き起こされます。

有効なUndoブロックのPythonステートの例:

def onMouseEvent(self, kwargs):
    ui_event = kwargs["ui_event"]
    node = kwargs["node"]
    if ui_event.reason() == hou.uiEventReason.Start:
        # 左マウスボタンが押された場合
        self.scale = node.parent().parm("scale").evalAsFloat()
        self.scene_viewer.beginStateUndo('scale')

    if ui_event.reason() == hou.uiEventReason.Active:
        # 左マウスボタンを押したままマウスを動かしている場合
        self.scale *= 1.01
        node.parent().parm("scale").set(self.scale)

    if ui_event.reason() == hou.uiEventReason.Changed:
        # 左マウスボタンが離された場合
        self.scene_viewer.endStateUndo()

例外を引き起こす無効なUndoブロックの例:

def onMouseEvent(self, kwargs):
    ui_event = kwargs["ui_event"]
    node = kwargs["node"]
    if ui_event.reason() == hou.uiEventReason.Start:
        # 左マウスボタンが押された場合
        self.tx = node.parent().parm("tx").evalAsFloat()
        self.scale = node.parent().parm("scale").evalAsFloat()
        self.scene_viewer.beginStateUndo('scale')

    if ui_event.reason() == hou.uiEventReason.Active:
        # 左マウスボタンを押したままマウスを動かしている場合
        self.scale *= 1.01
        node.parent().parm("scale").set(self.scale)

        self.scene_viewer.beginStateUndo('move x')
        self.tx += 0.2
        node.parent().parm("tx").set(self.tx)
        self.scene_viewer.endStateUndo()

    if ui_event.reason() == hou.uiEventReason.Changed:
        # 左マウスボタンが離された場合
        self.scene_viewer.endStateUndo()

hou.SceneViewer.beginStateUndoで以前に開いたUndoブロックを閉じます。

endStateUndoは、beginStateUndoの前にコールされると例外を引き起こします。

現行のツールステートにリンクされた表示ハンドルを表示または非表示にします。 このAPIは、通常ではPythonステートで使用し、少し注意が必要ですが、どのPythonステートコールバックからでもコールすることができます。 PythonステートコンストラクタからshowHandleをコールしないようにしてください。コールしてしまうと、ランタイムエラーが発生してしまいます。

hou.Handle.showも参照してください。

hou.ViewerStateTemplate.bindHandleと同様に、動的なビューアハンドルを現在のビューアステートにバインドします。 ただし、bindHandleとは違って、このメソッドは、動的な方法でハンドルを作成して初期化するため、事前にハンドルをビューアステートに登録する必要はありません。 bindViewerHandleは、Houdini内のほぼどこからでも(ビューアステートハンドルやPythonスクリプトなどから)コールすることができますが、ビューアステートの実行中にしかコールできません。

bindViewerHandleを使って追加されたビューアハンドルを除去するには、hou.SceneViewer.unbindViewerHandleを使用します。 ビューアステートを抜けると、bindViewerHandleを使って追加されたすべてのビューアハンドルはHoudini側で自動的に除去されるので、手動で行なう必要はありません。

このメソッドは、Pythonステートでのみ動作し、ビューアステートがPythonステートでない場合は例外が引き起こされます。

hou.ViewerStateTemplate.bindHandleStaticと同様に、静的なビューアハンドルを現在のビューアステートにバインドします。 ただし、bindHandleStaticとは違って、このメソッドは、動的な方法でハンドルを作成して初期化するため、事前にハンドルをビューアステートに登録する必要はありません。 bindViewerHandleStaticは、Houdini内のほぼどこからでも(ビューアステートハンドルやPythonスクリプトなどから)コールすることができますが、ビューアステートの実行中にしかコールできません。

bindViewerHandleStaticを使って追加されたビューアハンドルを除去するには、hou.SceneViewer.unbindViewerHandleを使用します。 ビューアステートを抜けると、bindViewerHandleStaticを使って追加されたすべてのビューアハンドルはHoudini側で自動的に除去されるので、手動で行なう必要はありません。

このメソッドは、Pythonステートでのみ動作し、ビューアステートがPythonステートでない場合は例外が引き起こされます。

現在のPythonステートからビューアハンドルを除去します。 hou.SceneViewer.bindViewerHandleまたはhou.SceneViewer.bindViewerHandleStaticを使って動的に追加されたビューアハンドルは、unbindViewerHandleでしかバインド解除できません。 バインド解除するビューアハンドルがビューアステートに登録済みのハンドルだった場合は例外が引き起こされます。

このメソッドは、Pythonステートでのみ動作し、ビューアステートがPythonステートでない場合は例外が引き起こされます。

指定したViewportVisualizerが存在している場合、そのビジュアライザのインタラクティブビジュアライザエディタダイアログを開きます。

Display Optionsダイアログを開いて、指定したラベルをハイライトします。

現行ステートのセレクターに対してアクションをトリガーします。 このステートはPythonステートタイプでなければなりません。 そうでない場合は例外が発生します。

現行ステートのセレクターの名前を返します。 セレクターがアクティブでない場合は、空っぽの文字列が返されます。 このステートはPythonステートタイプでなければなりません。 そうでない場合は例外が発生します。

アクティブなPythonステートによって実装されたコマンドを実行します。 名前識別子と入力引数を一緒に指定することで、ステートコマンドを呼び出すことができます。

そのステートがPythonステートタイプでない、または、そのステートが実行中でない場合には例外が引き起こされます。

ステートコマンドを実装したサンプル。

import hou
import viewerstate.utils as su

class State(object):
    def __init__(self, state_name, scene_viewer):
        self.state_name = state_name
        self.scene_viewer = scene_viewer    
        self.text_size = 5
        self.text_color = 'yellow'

        # ビューポート内にテキスト文字列を描画するためのDrawable
        self.text_drawable = hou.TextDrawable(self.scene_viewer, 'text_drawable_name',
            params = {'margins': (10.0,-10.0), 
                'origin' : hou.drawableTextOrigin.UpperLeft,
                'multi_line' : True} )
        self.text_drawable.show(True)

    def onCommand( self, kwargs ):
        # ビューポートテキストを更新するコマンド
        name = kwargs['command']
        args = kwargs['command_args']
        state_parms = kwargs['state_parms']

        if name == 'update_text':
            # 設定を更新
            state_parms['text']['value'] = args['text'];
            self.text_color = args['color']
            self.text_size = args['size']
            # ビューポートを再描画
            self.scene_viewer.curViewport().draw()

    def onDraw( self, kwargs ):
        # ビューポートの左上にテキストを描画
        handle = kwargs['draw_handle']
        state_parms = kwargs['state_parms']

        (x,y,width,height) = self.scene_viewer.curViewport().size()
        text = '<font color="%s", size=%d>%s</font>' % (self.text_color, 
            self.text_size, state_parms['text']['value'])        
        self.text_drawable.draw( handle, params = {'text': text, 'translate': (0.0, height, 0.0)} )


def registerState():
    state_typename = kwargs['type'].definition().sections()['DefaultState'].contents() 
    state_label = "State command demo"
    state_cat = hou.objNodeTypeCategory()

    template = hou.ViewerStateTemplate(state_typename, state_label, state_cat)

    template.bindFactory(State)

    template.bindParameter( hou.parmTemplateType.String, name="text", label="Text",
        default_value="Lorem ipsum dolor sit amet." )

    hou.ui.registerViewerState(template)    


def unregisterState():
    state_typename = kwargs['type'].definition().sections()['DefaultState'].contents() 
    try:
        hou.ui.unregisterViewerState(state_typename)
    except hou.StateNotRegistered:
        pass
    except:
        raise

以下のコードは、コマンドの呼び出し方の例です。

import toolutils

args = { 'text': text, 'color': color, 'size': size }
toolutils.sceneViewer().runStateCommand( 'update_text', args = args )

setGeometryVisibilityがコールされてジオメトリが非表示になっていればFalseを返します。そうでない場合はTrueを返します。 そのジオメトリが現行ビューポートにない場合はhou.InvalidInputを引き起こします。

指定したジオメトリノードに対してビューポートの可視性オーバーライドを制御します。 Python Stateでこれを使用することで、そのPython StateがDrawableを使って代用のビジュアライゼーションを描画する際に一時的にビューポートのジオメトリを非表示にすることができます。 このビューポートのジオメトリの可視性は持続せず、ディスプレイフラグを切り替えたり、または、ノードを再選択した時にTrueに戻されます。 そのジオメトリが現行ビューポートにない場合はhou.InvalidInputを引き起こします。

Drawableジオメトリ選択を実行します。 このメソッドは、Drawableセレクターが実行中の時にのみ動作し、 セレクターを実装したPythonステートまたは通常のPythonスクリプトのどちらかからコールすることができます。 このメソッドをコールすると、PythonステートのonSelectionハンドラーが発動されます。

Drawableセレクターが実行中でない場合はhou.OperationFailed、入力の引数が無効な場合はhou.InvalidInputを引き起こします。

このビューアのペースペクティブビューポート内の基準平面(またはグリッド)を返します。

詳細は、hou.ConstructionPlaneを参照してください。

このビューアのPerspectiveビューポート内の基準平面(またはグリッド)を返します。

詳細は、hou.ReferencePlaneを参照してください。

現行SOPノードのジオメトリディスプレイフラグを有効/無効に設定します。 このフラグが有効な場合、ビューポートは、そのノードに取り付けられているジオメトリを表示します。 無効な場合、ジオメトリを非表示にします。 SOPステートに入ると、デフォルトではこのフラグは有効になっています。

下流ノードに対してディスプレイフラグをTrueに設定し、そして上流ノードを選択するという状況を考えてみましょう。 ノードのステートに入ると、通常ではビューポートは上流ノードのジオメトリをワイヤーフレームで表示し、ディスプレイノードをシェーディングします。 一部の場合では、ステートに入れば、下流ノードで結果が非常に上手く可視化される選択ノードのパラメータを設定したいです。 この場合だと、showCurrentSopGeometryを使用することで、上流ノードのジオメトリの表示をオフにすることができます。

hou.SceneViewer.isShowingCurrentSopGeometryを参照してください。

現行ノードのジオメトリディスプレイフラグを返します。hou.SceneViewer.showCurrentSopGeometryを参照してください。

このビューアの現行ビューポートを返します。現行ビューポートは、マウスカーソルを含んだビューポートです。 このカーソルがビューポートになかった場合は、選択またはアクティブなビューポートが返されます。

このビューアの選択されたビューポートを返します。 ビューポートは、Spaceを押しながらNキーを押すことで選択することができます。

現在のビューポートレイアウトをhou.geometryViewportLayout値として返します。

ビューアのビューポートレイアウトを設定します。

viewer_pane.setViewportLayout(hou.geometryViewportLayout.Quad)

スクリーンの下部にメッセージを表示するビューポートを設定します。

hou.SceneViewer.setPromptMessageを使って以前に設定したプロンプトメッセージをクリアします。

シーンビューアの左上コーナーにメッセージを一時的に表示します。 指定した画像ファイルは、そのメッセージの前にスケールされて配置されます。 このメッセージは、指定した秒数でフェードアウトします。 オプションのhou.GeometryViewportを使用することで、ビューアの特定のビューポートにメッセージを描画することができます。

ビューア内に読み込み専用のヘッドアップディスプレイパネルを作成、更新、制御します。 このHUDパネルは、ビューポートの分割線を越えて広がります。

このインターフェースは実験段階であり、変更される可能性があります。詳細は、PythonステートInfoパネルを参照してください。

• ツール/ステートが変更されると、Houdiniは自動的にこのHUDパネルをクリアします。

• ユーザが⇧ Shift + F1を押すと、Houdiniは自動的にこのHUDパネルを非表示/表示します。

詳細は、ビューアのHUD情報パネルを参照してください。

ホットキーシンボルのタプルに関連付けられている各アクションに現在割当ら得ているホットキーを表現した文字列のタプルを返します。 このキー文字列はhou.ui.hotkeysメソッドが返す形式で、"Ctrl+Shift+G"のようにそのキーの記号と修飾キーの組み合わせになっています。

現行スナップモードに対して現行ジオメトリへのスナップが有効かどうかを返します。

現行スナップモードに対して現行ジオメトリへのスナップを有効にするかどうか設定します。

現行スナップモードに対してガイドへのスナップが有効かどうかを返します。

現行スナップモードに対してガイドへのスナップを有効にするかどうかを設定します。

現在のスナッピングモードの重力値を返します。

現行スナップモードのhou.snappingPriority値のタプルを返します。 これらの値は、Snap Optionsウィンドウで設定された優先度の順番(降順)で並んでいます。 そのモードに優先度がなければ、空っぽのタプルを返します。

領域ベースの選択を実行した時、ビューアが可視コンポーネントだけをピックするように設定されていればTrueを返します。 このオプションは、コンポーネント選択ボタンのコンテキストメニュー内のマッチングチェックボックスに相当します。

ボックスやブラシのピックのような領域ベースの選択を実行した時に可視コンポーネントだけを選択するオプションをオン/オフします。

領域ベースの選択を実行した時、ビューアが、そこに完全に含まれているコンポーネントだけをピックするように設定されていればTrueを返します。 このオプションは、コンポーネント選択ボタンのコンテキストメニュー内のマッチングチェックボックスに相当します。

ボックスやブラシのピックのような領域ベースの選択を実行した時に完全に含まれているコンポーネントだけを選択するオプションをオン/オフします。

hou.selectionModeタイプのビューアの選択モードを返します。

このビューの選択モードを設定します。 'selection_mode'の値は、hou.selectionModeからの値でなければなりません。

グループ、アトリビュート、接続性情報を使用して、このビューア内で行なった選択を自動的に広げるならTrueを返します。 このオプションは、コンポーネント選択ボタンのコンテキストメニュー内のマッチングチェックボックスに相当します。

ピックベースのグループ、アトリビュート、接続性をオン/オフします。オンの時、グループリストガジェットが自動的に可視になります。

このビューア内で行なった選択が全体のジオメトリを含むように自動展開するなら、Trueを返します。 このオプションは、コンポーネント選択ボタンのコンテキストメニュー内のマッチングチェックボックスに相当します。

このビューア内で行なった選択を全体のジオメトリを含むように展開するオプションをオン/オフします。

このビューア内で安全選択が有効であればTrueを返します。 このオプションは、選択ツールのコンテキストメニュー内のSecure Selectionオプションに相当します。

このビューア内でSecure Selectionオプションをオン/オフします。

このビューア内で行なった選択をCurrent SOPからピックする場合はTrueを返します。 Falseなら、ピックはDisplay SOPに対して行ないます。 このオプションは、コンポーネント選択ボタンのコンテキストメニュー内のcurrent/displayオプションに相当します。

このビューアにピックをCurrent SOPに対して行なうのかDisplay SOPに対して行なうのか伝えます。

このビューア内でピックされるジオメトリのタイプを返します。 このオプションは、コンポーネント選択ボタンのコンテキストメニュー内で選択可能なコンポーネントタイプに相当します。

このビューア内でピックされるジオメトリのタイプを設定します。 この値はユーザによって、またはセレクターが読み出された時にいつでも変更することができます。

このビューアで現在使用されている領域ピックのスタイルを返します。 このオプションは、選択ツールのコンテキストメニューで指定したピックスタイルに相当します。

このビューアで使用する領域ピックのスタイルを設定します。

既存選択と組み合わせられる追加選択の方法を返します。 選択ツールメニューで選択されるようなピックモディファイヤが欲しいのであれば、代わりにhou.SceneViewer.toolPickModifierの使用を検討してください。

新しく選択をした時の既存選択の修正に使用するメソッドを設定します。 さらに修飾キーを使用することで、この挙動を変更することができます。 デフォルトの操作(修飾キーなし)のみがこの設定の影響を受けます。 選択状態は、終了時にデフォルトのピックモディファイヤに戻るので、この状態を維持させるには、setDefaultPickModifier()を使って、このデフォルトの挙動を変更する必要があります。

選択状態が終了した後にHoudiniが戻すデフォルトのピックモディファイヤを返します。

選択状態が終了した後にHoudiniが戻すデフォルトのピックモディファイヤを設定します。

ユーザが正面または背面、それとも両方のコンポーネントをピックできるのかを示した値を返します。 このオプションは、コンポーネント選択ボタンのコンテキストメニューのFront and Back Facingオプションに相当します。

選択を正面、背面、それとも両方のコンポーネントに制限するかどうかのオプションを設定します。

このメソッドはhou.SceneViewer.pickModifierと同様ですが、選択ツールメニューで選択されているピックモディファイヤを返します。

本来ならワールド空間の値が実際には現行オブジェクトのローカル空間である場合にTrueを返します。 これは、selectPositions(), hou.GeometryViewport::mapToScreen(), hou.GeometryViewport::mapToWorld(), hou.GeometryViewport().viewPivot()などの戻り値が該当します。

シーンビューアがLOPsでUSDステージをビューイングしていればTrueを返します。

シーンビューアがLOPsをビューイングしていれば、表示されているUSDステージを返します。

LOPsをビューイングした時にシーンジオメトリを表示または非表示にします。

LOPsをビューイングした時にシーンジオメトリが表示されるかどうかを照会します。

LOPsをビューイングした時にカメラガイドを表示または非表示にします。

LOPsをビューイングした時にカメラガイドが表示されるかどうかを照会します。

LOPsをビューイングした時にライトガイドを表示または非表示にします。

LOPsをビューイングした時にライトガイドが表示されるかどうかを照会します。

LOPsをビューイングした時に選択ハイライトを表示します。

LOPsをビューイングした時に選択ハイライトが表示されるかどうかを照会します。

LOPsをビューイングした時にレンダラー統計情報が表示されるかどうかを照会します。すべてのレンダラーでこの情報を表示できるわけではありません。

LOPsをビューイングした時にレンダラー統計情報を表示または非表示にします。

LOPsをビューイングした時にレンダリング時間と進捗率が表示されるかどうかを照会します。すべてのレンダラーでこの情報を表示できるわけではありません。

LOPsをビューイングした時にレンダリング時間と進捗率が表示されるかどうかを照会します。

実行されるプリミティブ選択の種類を設定します。 kindには、USDプリミティブのKind(component, subcomponent, model, group, assembly, leaf primitive)のどれか、または、カスタムKindを指定することができます。 そのKindを認識できなければ例外が引き起こされます。 大文字小文字の区別はありません。 これは、ポイントインスタンス選択がアクティブだった場合のプリミティブ選択の選択モードを設定します。

ユーザが選択ステートに入った時に選択される現行プリミティブの種類を照会します。これは、リーフプリミティブが選択されるとNull文字列を返します。

選択オペレーションが現在のselectionKindに合致しないプリミティブを返すことを許可します。 これをFalseに設定すると、ユーザ選択が何も結果を返さないことを意味する場合であっても、選択オペレーションは必ずリクエストしたKindのプリミティブを返すようになります。 例えば、selectionKindがassemblyで、ユーザがcomponentモデルの部分のメッシュ上をクリックしても、そのcomponentがassembly内に含まれていない場合、何も選択されません。 これをTrueに設定すると、selectionKindは要件というよりかはヒントとして扱われます。 このモードでは、リクエストしたselectionKindに合致しない場合であっても、ユーザ選択は常に何かを返すようになります。 前述の例では、選択オペレーションは、階層のルートに最も近いgroupプリミティブを返します。 または、もしcomponentがgroup内にない場合、そのcomponentプリミティブが返されます。 または、まったくUSDモデル階層の一部でないプリミティブ(例えば、Cameraプリミティブ)上でユーザがクリックをした場合、リーフ(末端)プリミティブが返されます。

選択オペレーションが現在のselectionKindに合致しないプリミティブを返すことができるかどうかを示したフラグの現在の状態を照会します。

選択オペレーションがインスタンスプロキシプリミティブを返すことを許可します。 これをTrueに設定すると、他のプリミティブとまったく同様に選択オペレーションからインスタンスプロキシプリミティブが選択されて返されます。 これをFalseに設定すると、次にselectionKind要件を適用する前に、インスタンスプロキシでないプリミティブが見つかるまで、階層内の上方に向かって選択オペレーション内の各リーフプリミティブが走査されます。次に、このインスタンスルートプリミティブから始まるselectionKind要件が適用されます。

多くのLOPオペレーションは、インスタンスプロキシプリミティブに対して許可されていません(その理由は、このようなプリミティブ上で表現されているオピニオンはUSDコンポジションシステムでは無視されるからです)。 そのため、最初からこのようなサポートされていないプリミティブをユーザが選択できないようにしておくと役立つ場合が多いです。

選択がインスタンスプロキシプリミティブを返すことができるかどうかを示したフラグの状態を照会します。

選択操作が非表示プリミティブを返せるようにします。 Trueに設定すると、非表示プリミティブが選択できて選択操作から返されます。 Falseに設定すると、selectionKind要件が適用される前に、選択操作内の各末端プリミティブから階層上位に向かって表示プリミティブが見つかるまで走査されます。次に、そのselectionKind要件が適用されます。

非表示プリミティブは、シーングラフツリー内の特別なメタデータがマークされたプリミティブです。 通常では非表示プリミティブはシーングラフツリー内に表示されないので、普段はビューアで非表示プリミティブを直接選択できないようにする方が望ましいです。 非表示フラグは、パイプラインの規則に応じて、特にシーングラフ階層内の望ましい位置でのみトランスフォームや他の編集が行なわれるようにプリミティブ選択を制御するのに使用する場合が多いです。

選択が非表示プリミティブを返す場合があるかどうかを示したフラグの状態を照会します。

ポイントインスタンス選択モードに切り替えます。 topmostがTrueの場合、入れ子化されたインスタンスを選択した時にその最上位のポイントインスタンスが選択されます。 topmostがFalseの場合、その末端のポイントインスタンス(リーフインスタンス)が選択されます。 ポイントインスタンスが入れ子化されていない場合は、topmostは何の効果もありません。

現行選択ステートがポイントインスタンスを選択していればTrueを返し、プリミティブを選択していればFalseを返します。

インスタンス選択モードが最上位インスタンスレベルを選択していればTrue、リーフインスタンスレベルを選択していればFalseを返します。

LOPsで利用可能なレンダラーのリストを照会します。

LOPsの現行レンダラーを設定します。

LOPsの現行レンダラーを照会します。

LOPs内の現行レンダラーを再起動して、シーンをゼロから再構築します。

ネイティブビューポートカメラをデフォルト状態にリセットします。 これによって、直近で選択されたUSDカメラから継承されたすべてのカメラ設定がクリアされます。

このメソッドは、ビューポートのカメラメニューからReset Native Viewport Cameraを選択することと同じです。

LOPsで Proxy Purposeのタグが付いたPrimsを表示(True)または隠します(False)。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

LOPsで Guide Purposeのタグが付いたPrimsを表示(True)または隠します(False)。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

LOPsで Render Purposeのタグが付いたPrimsを表示(True)または隠します(False)。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

ビューアがScene Graph Treeで設定されたオーバーライド(描画モードや可視性など)を適用するかどうかを制御します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

ビューアがScene Graph Treeで設定されたロードマスク(ペイロードの読み込みなど)を適用するかどうかを制御します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

ビューアがLOPネットワークからポストレイヤーを適用するかどうかを制御します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合、現在選択されているレンダラーの値が設定されます。 それ以外の場合、rendererにはレンダラーの名前を示した文字列を指定します。

Proxy Purposeが設定されたPrimsがLOPsで表示されていればTrueを返します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

Guide Purposeが設定されたPrimsがLOPsで表示されていればTrueを返します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

Render Purposeが設定されたPrimsがLOPsで表示されていればTrueを返します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

ビューアがScene Graph Treeで設定されたオーバーライド(描画モードや可視性など)を適用していればTrueを返します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

ビューアがScene Graph Treeで設定されたロードマスク(ペイロードの読み込みなど)を適用していればTrueを返します。

この値は、レンダラー毎に別々に保存されます。 rendererがNoneの場合は、現在選択されているレンダラーの値が設定されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

ビューアがLOPネットワークで設定されたポストレイヤーを適用している場合はTrueを返します。

この値は、レンダラー毎に別々に保存されています。 rendererがNoneの場合は、現在選択されているレンダラーの値が返されます。 そうでない場合はrendererにはレンダラーの名前を示した文字列を指定します。

このビューアで表示されたステージのメタデータを使用して再生範囲と再生速度が制御されている場合はTrueを返します。 そうでない場合はFalseを返します。

このビューアで表示されたステージのメタデータを使用して再生範囲と再生速度を設定するかどうかを指定します。 同時に1個のビューアのみがこのオプションを有効にすることができます。 ビューアでこれを有効にすると、他のすべてのビューアではこれが無効になります。

有効にすると、ステージのStartTimeCode、EndTimeCode、TimeCodesPerSecondの値を使用して、それぞれプレイバーの開始フレーム、終了フレーム、FPSのオプションが設定されます。 プレイバーのステップオプションは、ステージのメタデータからTimeCodesPerSecond/FramesPerSecondの値で設定されます。

Houdiniのプレイバーは、“フレーム”よりは“タイムコード”というUSDの概念により密接に呼応しています。 このおかげで、USDアニメーションデータの編集が非常に簡単になっています。

LOPネットワークに変更を加えても更新されないようにビューアのUSDステージが現行状態にロックされていればTrueを返します。 これは、Manual Updateモードと同様ですが、このビューアペインにのみ影響します。 他のすべてのHoudiniペイン(例えば、Scene Graph TreeペインやScene Graph Detailsペイン)は、LOPネットワークによる新しいステージの内容で更新が続きます。

LOPネットワークの変更に反応してビューアがステージの内容を更新しないように指示するフラグを設定します。

グループリストガジェットがこのビューアで有効ならTrueを返します。 この関数は、ビューア内でグループを選択しなかった時にグループリストを表示するオプションを参照するだけです。 その場合、そのグループリストは可視でも、この関数はFalseを返します。

このビューアに対してグループリストガジェットをオン/オフします。

グループリストガジェットが、グループメンバーまたはアトリビュート値に基づいてビューア内のジオメトリを色付けるように設定されていればTrueを返します。

グループリストガジェットが、グループメンバーまたはアトリビュート値に基づいてビューア内のジオメトリを色付けるように設定します。

グループリストガジェットのリスト内に空っぽのグループが含まれていればTrueを返します。

グループリストガジェット内に空っぽのグループを表示します。

グループリストが1つ以上の選択または事前選択されたコンポーネントを含んだグループのみを表示していればTrueを返します。

1つ以上の選択または事前選択されたコンポーネントを含んだグループのみを表示するように、グループリストのトリムを有効にします。

グループリストが、パスを意味する文字列アトリビュートで定義されたグループの階層を縮約していればTrueを返します。

グループリスト内の階層の縮約を有効にします。 これは、パスを意味する文字列アトリビュートによってグループ化されたコンポーネントに適用されます。 このオプションを有効にすることで、多くの情報をそのリストにまとめることができますが、階層内のレベルを区別しにくくなります。

グループリストガジェットの幅と高さをインチで返します。

グループリストガジェットのサイズをインチで設定します。

グループリストガジェットに挙げられたコンポーネントのタイプを返します。

グループリストガジェットに挙げるコンポーネントのタイプを設定します。 これは、特定のコンポーネントタイプに設定したり、現行コンポーネント選択タイプに合わせることができます。

グループリストガジェットがこのビューアに対して有効であればTrueを返します。

このビューアに対してグループリストガジェットのマスク値を設定します。 これは、コンポーネントグループ、アトリビュート名(@文字で始まる)、接続性タイプに適用されたフィルターを指定することができます。

Flipbookダイアログ設定にアクセスします。これは、その設定を照会、設定、コピーすることができます。

フリップブックをキャプチャーします。フリップブックは、フレーム毎に連続してビューポートのスクリーンショットを撮ることで、迅速にプレビューアニメーションを作成します。

viewportを指定すればそのビューポート、viewportを指定しなかった場合は現行ビューポートに対してFlipbookを起動します。 オプションで、現行設定を上書きするsettingsにhou.FlipbookSettingsオブジェクトを渡すことができます。 この上書きは、現行Flipbookにのみ影響し、ダイアログ設定を変更しません。 open_dialogがTrueの場合はFlipbookダイアログがユーザに表示され、そうでない場合はFlipbookが即座に起動します。

シーンビューア用の新しいQtウィンドウを作成して返します。

返されたウィンドウは、メインのQtウィンドウの子になっていて、ダイアログやウィンドウなどのQtウィジェットの親として使用することができます。

UI空間内のビューアの位置とサイズを返します。 返されるタプルのエレメントは、メインウィンドウの左下コーナー位置を基準としたビューポート座標とビューアのサイズです。

1. (左下基準の)X位置

2. (左下基準の)Y位置

3. 幅寸法

4. 高さ寸法

ビューアのカラー補正にOpenColorIOが使用されているかどうかを照会します。

ビューアのカラー補正でOpenColorIOを有効または無効にします。

OpenColorIOの表示名、ビュー名、または両方を設定します。 表示とビューはどちらもビューアの出力カラー空間を定義し、任意の数のカラー変換(Looks)が線形ビューポート画像に対して実行されます。

カラー補正で使用されている現在のOpenColorIO表示を返します。

カラー補正で使用されている現在のOpenColorIOビューを返します。

ビューポートの上部にオペレーションツールバーを表示/非表示します。

ビューポートの上部にオペレーションツールバーが表示されていればTrueを返します。

ビューポートの下部にカラー補正ツールバーを表示/非表示します。

ビューポートの下部にカラー補正ツールバーが表示されていればTrueを返します。

ビューポートの下部にメモリツールバーを表示/非表示します。

ビューポートの下部にメモリツールバーが表示されていればTrueを返します。

ビューポートの右側にディスプレイオプションツールバーを表示/非表示します。

ビューポートの右側にディスプレイオプションツールバーが表示されていればTrueを返します。

ビューポートの左側に選択ツールバーを表示/非表示します。

ビューポートの左側に選択ツールバーが表示されていればTrueを返します。

ビューポートの下部にオプションのカラー補正ツールバーを含めます。

ビューポートの下部にオプションのカラー補正ツールバーが含まれていればTrueを返します。

ビューポートの下部にオプションのメモリツールバーを含めます。

ビューポートの下部にオプションのメモリツールバーが含まれていればTrueを返します。

現行ビューポートで名前付きシェルフツールを実行します。

現行ビューポートで名前付きRadialメニューを起動します。

ビューアのタイプを返します。 ビューアがObjects, SOPs, DOPsを見ていればScene、LOPsを見ていればSceneGraphを返します。

desktop.name.categoryの形式でビューアのフルネームを返します。

# Objects、SOPs、DOPsを見るTechnicalデスクトップのビューアのフルネーム
Technical.panetab2.world

# LOPsを見るTechnicalデスクトップのビューアのフルネーム
Technical.panetab2.solaris

ビューアイベントとジオメトリビューポートイベントが発生する度にコールされるPythonコールバックを登録します。

コールバックは、以下の項目を含んだ辞書を使ってコールされます:

• event_type: ビューアイベント。

• desktop: シーンビューアが格納されたデスクトップオブジェクト。

• viewer: このイベントをリッスンしているシーンビューアオブジェクト。

追加項目は特定のイベントで利用可能です:

def onViewerCB(**kwargs):
    event_type=kwargs['event_type']
    desktop=kwargs['desktop']
    viewer=kwargs['viewer']

    print( "event type=",event_type )
    print( "desktop=",desktop )
    print( "viewer=",viewer )

curSceneViewer = [item for item in hou.ui.curDesktop().currentPaneTabs() if item.type() == hou.paneTabType.SceneViewer][0]
curSceneViewer.addEventCallback(onViewerCB)

hou.sceneViewerEvent.addEventCallbackを使って登録されたすべてのPythonコールバックを除去します。

hou.sceneViewerEvent.addEventCallbackを使って登録された特定のPythonコールバックを除去します。

hou.sceneViewerEvent.addEventCallbackを使って登録されたすべてのPythonコールバックのタプルを返します。