v1.5

エッジのセットを分割します。

注: このコマンドは、出力引数を使用します。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。通常、出力引数は XSIApplication.ExecuteCommand メソッド(C#)または ISIVTCollection (スクリプト言語)を介して取得できますが、このコマンドはすでに値を返しています。

この場合の唯一の回避策は、出力引数と戻り値の両方を 1 つの配列で戻す VBScript のカスタム コマンドを作成することです。詳細については、「関数がすでに値を戻している場合の処理について」を参照してください。

oLong = SplitEdge( [ConnectionSet], [Ratio], [EdgeParallelLoop], [EdgeConnect], [ImmediateMode], [NewPointID] );

演算により作成される新しいポイント(ratio=0 または 100 の場合は既存のポイント)の ID を Long として戻します。

パラメータ	タイプ	説明
ConnectionSet	ConnectionSet	分割するエッジを指定します。 デフォルト値: 現在選択されているコンポーネント 警告: 接続セットが無効だと、エラーが発生します。 スクリプトの中断を防ぐため、このオペレータに必要な接続セットを確認してください。
Ratio	Double	複数の入力されたエッジを分割する比率 デフォルト値: 50 指定可能な値： 説明： 0 入力されたエッジがこの比率で分割されます。
EdgeParallelLoop	Boolean	すべてのエッジを入力されたエッジと同時に分割します。 デフォルト値: False
EdgeConnect	Boolean	True の場合は、複数の平行エッジを分割して取得されるポイントを接続します。 デフォルト値: True
ImmediateMode	siOperationMode	オペレータを即座にフリーズするかどうかを指定します。 デフォルト値: siPersistentOperation
NewPointID	Integer	操作により作成される新しいポイントの ID(エッジが複数ある場合は -1 が戻されます)

VBScript の例

' Create a cylinder and split all the edges around the top half of the cylinder

NewScene

CreatePrim "Cylinder", "MeshSurface"

SplitEdge "cylinder.edge[11]", 69.242, False, True

SplitEdge "cylinder.edge[9]", 70.716, False, True

SplitEdge "cylinder.edge[23]", 39.692, False, True

SplitEdge "cylinder.edge[67]", 17.186, False, True

SplitEdge "cylinder.edge[34]", 38.324, False, True

SplitEdge "cylinder.edge[45]", 25.924, False, True

SplitEdge "cylinder.edge[56]", 56.322, False, True

SplitEdge "cylinder.edge[78]", 44.641, False, True

AddEdge