シェイプの共通プロパティ、演算子、メソッド
| 値 > MAXWrapper > ノード > GeometryClass > シェイプ |
インデックスで指定されたスプライン内の結び目(頂点またはコントロール ポイント)の数を整数で返します。スプラインのインデックスが指定されていない場合は、シェイプ全体のノットの数を返します。
シェイプ シーン オブジェクトを操作する補間関数がいくつかあります。これらの関数は、シェイプ内のカーブ上の座標をとってカーブ沿いにステップを付けたり、カーブの長さをとったり、所定の座標に最も近いカーブ上のポイントを判定します。これらの関数は、カーブ沿いにオブジェクトのクローンを配置したり、アニメーションのときにオブジェクトの集団を「突起」カーブの近くに寄せて配列する上で便利です。
補間関数はいずれも、シェイプ シーン オブジェクト(線分など)、シェイプの中に複数のカーブが存在する場合にはカーブの番号(オプション、既定値は 1)、およびカーブ上のスポットをカーブの長さに対する比率で指定するパラメータ(範囲は 0.0 ～ 1.0)をとります。補間関数には次の 2 つのタイプがあります。
-
3ds Max のパス コントローラに適合する補間関数。この場合、パス沿いのパーセントは均一ではありませんが、コントロール ポイントの間隔によって重みが与えられます。このような単純な補間は、パラメータの間隔に基づいて実行されます。スプラインに 4 つのセグメントがある場合、最初のセグメントのパラメータ値は 0 ～ 0.25、2 番目は 0.25 ～ 0.5、3 番目は 0.5 ～ 0.75、4 番目は 0.75 ～ 1.0 となります。これは、各セグメントの長さに関係なく設定されます。
-
カーブに沿って均一に補間を行う補間関数。この補間によって、パラメータの間隔がスプラインの長さに沿った距離に平均化されます。つまり、パラメータの間隔の開始位置は 0、終了位置は 1.0、カーブの実際の長さの中点は 0.5 です。
3ds Max の非均一パス補間関数は、間隔が不均等なコントロール ポイントがパスにある場合に、パスでアニメートされるオブジェクトの可変速度を上げます。ここに記載された円弧長補間関数は、制御点の配置がいくら不均等であっても、カーブに沿って均一に補間を行います。パス補間関数の利点は、均一な円弧長補間関数よりも計算面で遥かに効率が良いことにあります。円弧長補間関数はある程度のキャッシュを使って処理速度を上げますが、以下に説明するように、ユーザは円弧長補間関数の使用方法を工夫する必要があります。
後述するオプションの steps: キーワード引数によって、統合ステップを指定できます。既定の steps 値はカーブの 3ds Max 単位長の 5 倍であり、通常はこの長さで十分です。たとえば、カーブが 100 3ds Max 単位の長さの場合、既定のステップ サイズは 500 になります。 補間アルゴリズムの精度は、+ または - (1/steps) 3ds Max 単位以下です。単一のカーブに沿って徐々にステップする一般的なケースでは、このメソッドはキャッシュを使って操作を加速します。このキャッシュはカーブ上の最後のポイントについて状態を記憶しており、ユーザが同じカーブに対し同じアニメーションの時間にこの関数を呼び出す場合には、キャッシュはそのポイントを取得します。これは補間プロセスを指数関数的に加速します。ただし、MAXScript では 1 つの呼び出しから次の呼び出しの間にカーブが編集されたかどうかを認識する方法が用意されていないため、コード内の呼び出し間にユーザがカーブを編集できる場合は、resetLengthInterp() メソッドで必ずキャッシュをリセットする必要があります。
3ds Max パス コントローラのパーセント(頂点ベース)補間と一致するパラメータ値(0.0 ～ 1.0)に従って、番号(既定値は 1)で指定されたカーブ上の Point}3 座標を返します。
カーブの全長に沿って該当部分を指定するパラメータ値(0.0 ～ 1.0)に従って、番号(既定値は 1)で指定されたカーブ上の point3 座標を返します。
円弧長補間関数のキャッシュをクリアします。この関数は、円弧長補間関数を使って補間するカーブが、呼び出しと呼び出しの間で編集されている可能性がある場合に使用します。
番号で指定されたカーブの長さを返します。この長さは、シェイプで実行される変換レベルのスケールとは異なります。
所定のカーブに沿って 3ds Maxパス(頂点ベース)補間関数で補間されるポイントでの接線方向のベクトルを返します。たとえば、この関数を使ってカーブを追随する方向にオブジェクトを設定できます。
所定のカーブに沿って円弧長補間関数で補間される点での正接方向のベクトルを返します。たとえば、この関数を使ってカーブを追随する方向にオブジェクトを設定できます。
指定した <point3> 座標に最も近いカーブ沿いのポイントに対応する補間パラメータ値(0.0 ～ 1.0)を返します。このパラメータは、3ds Max パス(頂点ベース)補間パラメータ値として与えられています。次にこの値を pathInterp に使用して最も近いポイントの座標を見つけたり、あるいは以下の関数のいずれかを使用して円弧長パラメータと 3ds Max パスのパーセント パラメータとの間の変換を行います。
このカーブについて、指定した 3ds Max パス(頂点ベース)パラメータに相当する均一円弧長のパラメータを返します。
このカーブについて、指定した均一円弧長パラメータに相当する 3ds Max パス(頂点ベース)パラメータを返します。
関連事項
特に明記されている場合以外は、この作業は、Creative Commons 表示 - 非営利 - 継承 3.0 非移植ライセンス のもと認可を受けています。 Autodesk Creative Commons FAQ (英語版) を参照してください。