制限事項

文字列パラメータへの接続

カスタムオペレータは、文字列パラメータに直接接続することはできません。カスタムオペレータから文字列パラメータに対して読み書きを行うには、そのパラメータを所有するオブジェクト(たとえば、CustomProperty または CustomProperty など)に接続します。

ブロックされたメソッドおよびプロパティ

一部のメソッドおよびプロパティは、カスタムオペレータのコンテキストでブロックされます(レガシーおよびランタイムオペレータについても同じことが言えます)。入力の値を変更したり、入力として接続されていないシーンのエレメントを読み込んだりすることはできません。

使用するメソッドまたはプロパティが、カスタムオペレータで使用しても安全であるかどうかを確認するには、この項目の各リファレンスページを参照してください。安全に使用できる場合、その横にアスタリスク(*)が示されます。

使用できないコマンド

そのコマンドは、シーンデータには完全に影響しない限り、(たとえば、PickObject など)、オペレータの内部からコマンドを呼び出すことはできません。
ジオメトリやシーンオブジェクト(CreatePrimやAddNull など)を生成するコマンドや、トポロジを変更したり項目をクラスタに追加するあらゆるコマンドは、シーンデータを変更し、Softimage の動作を不安定にするおそれがあるため、呼び出しは厳禁です。

トポロジの変更

シーン時間の制限

シーングラフは、オペレータが評価されるタイミング以外のタイミングで読み込むことはできません。ただし、シーンが最初から最後まで注意深く評価されている場合は、回避策として、オペレータ内にデータをキャッシュすることができます。この種類の回避策の実装方法については、「ParticleOp の例」を参照してください。
オペレータが評価されるタイミングが再生コントロールによって設定された現在の時間であると想定すること、またはフレームごとに評価が1つしかないと想定することはできません。以下のツールを使用できます。OperatorContext.Time または OperatorContext::GetTime を使用して、現在の評価時間を取得できます。

デフォーマ接続をセットアップする

ポートグループ内での複数接続

可能であれば、各ポートグループにポートを 1 つずつ使用して、接続を明確にしておくことをお勧めします。ダイナミックオペレータについては、数多くのインスタンスを含む 1 つのポートを定義できます。詳細については、「スタティックオペレータとダイナミックオペレータ」を参照してください。

パーシステンス(持続性)に関する問題

カスタムオペレータの数多くの用途の 1 つとして、カスタムパーティクルシミュレーションの作成があります。シーンに定義されているパーティクルタイプは、Scene.ParTypes コンテナに保存されます。 Scene.ParTypes に接続することは可能ですが、シーンを再ロードすると接続が失われます。

ブランチまたはグループで操作する

グループまたは階層に追加(または削除)されたオブジェクトは、カスタムオペレータがプリミティブに書き込む出力ポートを定義している場合にのみ、カスタムオペレータに自動的に接続(または切断)されます。これは、グループ/ブランチオペレータ機能の既知の制限事項です。
PortGroup が Filter を定義し、オペレータがブランチグループ接続をサポートしている場合、フィルタにはグループフィルタが含まれている必要があります。これにより、オペレータをブランチ内のオブジェクトやグループオブジェクト上に適用する場合、ApplyOp コマンドまたは Operator.Connect メソッドによって入力オブジェクトを評価できるようになります。
グループ/ブランチフラグは、Primitive 上の IO ポートにのみ使用できます