Q100109: カスタム式評価用に追加のパラメータ式関数を作成する方法

まとめ

この記事では、カスタム関数の例を通じてパラメーター式とカスタム オブジェクトをパラメーター式に追加する方法について説明します。

詳しくは

パラメーター式は、完全な Python スクリプトではなく、 Python 式のみをサポートします。

これらは、ラムダの本体、または変数代入の右側に似ています。通常の if/else ブロックやループは使用できませんが、三項演算子とリスト内包表記は使用できます。

カスタム オブジェクトを登録し、パラメータ式内で使用できます。以下は、カスタム関数を登録し、これをパラメーター式で使用する方法を示す例です。

[Python]タブで、次のように関数を定義して登録します。

def triple(value):
  return value * 3

NodegraphAPI.SetExpressionGlobalValue("triple", triple)

次に、パラメーター式から次のように関数を使用できます。

triple(5) + 1

この場合、パラメーターの値は 16 になります。注意すべき重要な点は、式は何らかの値を返すのではなく、何らかの値に評価される必要があるということです。

パラメーター式の目的は、パラメーターの値をプログラム的に計算することです。パラメーター式は、評価の一環としてプロジェクトに変更を加えてはなりません。

多くのパラメータの値を操作する必要がある場合は、シェルフ スクリプトまたはスクリプト ボタンの使用を検討してください。詳細については、 Katanaユーザー ガイドのシェルフ アイテム スクリプト、 ユーザー パラメータ、およびウィジェット タイプに関する章を参照してください。