複数の中断可能な処理を入れ子にすることができます。 例:

# Start the overall, long operation.
with hou.InterruptableOperation("Beginning operation",
                                "Performing a Long Operation",
                                open_interrupt_dialog=True) as iop:
    for i in range(num_tasks):
        # 全体の進捗状況を更新します。
        operation.updateLongProgress(i / num_tasks)

        # サブ処理を開始します。
        with hou.InterruptableOperation(f"Performing Task {i + 1}") as sub_iop:
            for j in range(num_subtasks):
                # サブ処理の進捗状況を更新します。
                sub_iop.updateProgress(j / num_subtasks)

                #
                # ここでサブタスクを実行します。
                #

コンテキストオブジェクトの作成時にtimeout_ms引数を使用することで、処理に要する時間を制限することができます。

• 時間制限に達すると、ユーザが ⎋ Escを押した場合と同様にhou.OperationInterruptedが発生します。

• ユーザが ⎋ Escを押した場合と同様に、通常ではタイムアウトはupdateProgress()メソッドをコールした時にのみチェックされるので、ブロック内で定期的にそのメソッドをコールする必要があります。

  一部のHOM関数には内部で進捗状況を更新するものがあり、それもタイムアウトのチェックをトリガーする可能性があります。 例えば、LopNode.stagePrimStats()コールを、タイムアウトありのhou.InterruptableOperationブロックで囲むと、stagePrimStats()が内部で処理中にHoudiniを更新するため、タイムアウトによってstagePrimStats()が中断されます。

例えば、この修正版のサンプルは通常10秒間実行されますが、timeout_ms=1000引数によって、1秒後にInterruptedと表示されます:

import time
import hou

try:
    with hou.InterruptableOperation("Waiting around doing nothing",
                                    timeout_ms=1000) as iop:
        for i in range(100):
            # ここには実際の処理を記述しますが、今回は単にスリープ処理を入れます。
            time.sleep(0.1)
            iop.updateProgress(i / 100)
except hou.OperationInterrupted:
    # ユーザがEscキーを押しました(または、
    # timeout_ms引数を使用した場合、処理がタイムアウトしました)
    hou.ui.displayMessage("Interrupted")
else:
    # 処理は中断されることなく完了しました。
    hou.ui.displayMessage("Completed")

• デフォルトでは、Houdiniはステータスラインに進捗状況をテキストのみで表示します。 オブジェクトの作成時にopen_interrupt_dialog=Trueを指定すると、Houdiniは進捗状況をプログレスバーで表示するダイアログを開きます。通常、処理に1～2秒以上かかる場合は、ダイアログを開くことを推奨します。

• updateProgress()コールは短い時間で済むものの、それが積み重なって時間がかかってしまいます。ループが多い場合、例えば毎回の反復ではなく、10回に1回といった頻度でコールすることを推奨します。

• hou.InterruptableOperationはPythonシェルでは動作しません。単に試したいだけであれば、シェルフツールを利用してください。

• Houdiniは、ステータスバーにすべての進捗状況の更新を表示しない場合があります。パフォーマンス上の理由から、ステータスバーの更新は独自のスケジュールで行なわれます。

• withステートメント外でこのオブジェクトを作成しようとすると、hou.OperationFailedが発生します。