Point_CacheSpacewarpModifier - superclass: SpacewarpModifier

Point_CacheSpacewarpModifier - superclass: SpacewarpModifier; super-superclass:MAXWrapper - classID:#(923738083, 61950361)

3ds Max 9 で、[ポイント キャッシュ]モディファイヤ (ワールド スペース) は、従来はフリーのプラグインであった PointCache2 モディファイヤの特定のバージョンに置き換えられました。PointCache のキャッシュ フォーマットも、Autodesk Maya の新しい PointCache との互換性を持たせるために変更されており、2 つのアプリケーション間でより簡単にアニメーションをやりとりできるようになりました。

従来のバージョンの 3ds Max 用のスクリプト開発者向けの 3ds Max 9以前の[ポイント キャッシュ]モディファイヤ (ワールド スペース) に関するドキュメントは、このページの下部から参照できるようになっています。

コンストラクタ

Point_CacheSpacewarpModifier ...
PointCacheWSM ...

プロパティ

<Point_CacheSpacewarpModifier>.fileName String default: "" -- filename

キャッシュ ファイル名を取得/設定します。

記録

<Point_CacheSpacewarpModifier>.fileCount Integer default: 0 -- integer; File_Count

ファイル カウント ラジオ ボタンの状態を取得/設定します。

有効な値は次のとおりです。

0 - 1 ファイル

1 - フレームごとに 1 つのファイル

3ds Max 2008 以降 で使用可能です。

<Point_CacheSpacewarpModifier>.recordStart Float default: 0.0 -- float; Record_Start         

キャッシュ レコードの開始時間をフレーム数で取得/設定します。

<Point_CacheSpacewarpModifier>.recordEnd Float default: 100.0 -- float; Record_End     

キャッシュ レコードの終了時間をフレーム数で取得/設定します。

<Point_CacheSpacewarpModifier>.sampleRate Float default: 1.0 -- float; Sample_Rate   

キャッシュ サンプル レートをフレームごとのサンプル数で取得/設定します。

荷重タイプ

<Point_CacheSpacewarpModifier>.loadType Integer default: 0 -- integer; Load_Type

ローカル ワークステーションでポイント キャッシュを使用するときの、ロード タイプ モードを取得/設定します。有効な値は次のとおりです。

0 - [ストリーム] - 高速にアクセスできるようにキャッシュ ファイルを開いたままにしますが、メモリを節約するため一度に 1 フレームだけをロードします。

1 - [各サンプル] - キャッシュ ファイルを開いて 1 つのフレームを読み込んだ後、すぐにファイルを閉じます。 ストリーム ロード タイプより遅くなりますが、キャッシュ ファイルからの読み取り中にファイルが開いたままロックされないため、同じキャッシュ ファイルのセットに対して多数のユーザが読み取り/書き込みを行う場合に便利です。

2 - 事前ロード - キャッシュ ファイル全体を RAM にロードして非常にすばやいアクセスを実現し、最後にファイルをクローズします。 特にネットワーク環境や、1 つのシーン内にある多数のオブジェクトが少数のキャッシュを使用している場合 (このケースでは、このモードをオンにすることで各オブジェクトが再生時にその都度ディスクを読み込むのを防ぐことができます) に使用します。このモードでは、RAM が急速に消費されてしまうため、十分に注意して使用する必要があります (ただし、複数のオブジェクトが 1 つのキャッシュ ファイルを使用する場合、キャッシュは RAM に一度だけロードされます)。詳細は、pointCacheMan.GetUsedMemory() メソッドを参照してください。

<Point_CacheSpacewarpModifier>.loadTypeNetwork Integer default: 1 -- integer

ネットワーク ノードでポイント キャッシュを使用している場合のロード タイプ モードを取得/設定します。有効な値は次のとおりです。

1 - [各サンプル]

2 - [事前ロード]

再生オプション(Playback Options)

<Point_CacheSpacewarpModifier>.strength Float default: 1.0 -- animatable; float

キャッシュの強度を取得/設定します。既定値は 1.0 です。値が低いほど、キャッシュ ファイルに保存されている頂点位置よりもメッシュへの影響の方が軽くなります。値が高いほど、アニメーションが誇張されます。

<Point_CacheSpacewarpModifier>.relativeOffset BooleanClass default: false -- boolean; Relative_Offset

[相対オフセット]オプションの状態を取得/設定します。

true の場合、キャッシュの最初のフレームとのdifferencesによって、現在のオブジェクトが変形されます。キャッシュを記録する場合に、このオプションを true に設定し、キャッシュの下に別のモディファイヤを追加してメッシュを変形すると、記録された変形は新しい変形の上に追加されます。同様に、記録されていた元のモディファイヤがまだ有効である場合は、オブジェクトには二重の変形が適用されます。

false の場合は、キャッシュ ファイル内のポイントの位置は、キャッシュの以下の追加的な変形をすべて上書きし、明示的に現在のオブジェクトのポイント位置を設定します。

<Point_CacheSpacewarpModifier>.applyToWholeObject BooleanClass default: true -- boolean; Apply_To_Whole_Object

[全オブジェクトに適用]オプションの状態を取得/設定します。

再生タイプ

<Point_CacheSpacewarpModifier>.playbackType Integer default: 0 -- integer; Playback_Type

再生のタイプを取得/設定します。有効な値は次のとおりです。

0 - オリジナル範囲 - 常に最初に記録された範囲でキャッシュを再生します (このため、アニメーションはalways元と同じになります)。

1 - [カスタム開始] - キャッシュをカスタムの開始時間から再生します。ただし、アニメーションの長さ/再生速度は元のアニメーションと同じです)。

2 - カスタム範囲 - 現在のキャッシュの再生範囲となる開始フレームおよび終了フレームを設定できます。 元の記録範囲よりも小さい範囲を使用すると、キャッシュは高速で再生され、大きい範囲を使用するとキャッシュはゆっくり再生されます。

3 - [記録形状を再生] - 特定の時間にどのキャッシュ フレームを再生するかをアニメートできます。 たとえば、キャッシュをフレーム 0 から 100 まで記録する場合、フレーム 0 でこのパラメータを 0 に設定し、フレーム 100 で100 になるようアニメートします。トラックビューに表示されるこのパラメータの関数曲線を見ると、キャッシュがどのように再生されているかがわかります。これをアニメートすることにより、キャッシュの速度を少しずつ落としていく、キャッシュをピンポン再生するなど、さまざまな効果を得ることができます。

<Point_CacheSpacewarpModifier>.playbackStart Float default: 0.0 -- float; Playback_Start

[開始フレーム]の値を取得/設定します。

<Point_CacheSpacewarpModifier>.playbackEnd Float default: 100.0 -- float; Playback_End

[終了フレーム]の値を取得/設定します。

<Point_CacheSpacewarpModifier>.playbackFrame Float default: 0.0 -- animatable; float; Playback_Frame

[フレーム]を取得/設定します。記録形状を再生モードの場合は、この値にキーフレームを指定して再生を制御することができます。

<Point_CacheSpacewarpModifier>.clampGraph BooleanClass default: false -- boolean; Clamp_Graph

[記録形状をクランプ]オプションの状態を取得/設定します。再生グラフのフレームが元の記録範囲の外部にある場合は、ロードの対象物を制御します。たとえば、再生フレームが 105 に設定されていて、元のキャッシュは 0 から 100 までしか記録されていなかったとします。clampGraph が true に設定されている場合は、ロードされるフレームは 100 です。に設定されている場合は、キャッシュを「循環」してフレーム 5 がロードされます。このように、キャッシュをより簡単にループすることができます。先ほどの例では、2 つのキーを使用した再生グラフを 1 つ作成するだけで済みます。キー 1 はフレーム 0 に設定して値は 0、キー 2 はフレーム 100 に設定して値は 100 にします。そしてこのグラフの範囲外のタイプを「線形補外」に設定するだけで、キャッシュはフレーム 101 で先頭にループバックします。

次のプロパティは UI に公開されておらず、完全にはサポートされていません。

<Point_CacheSpacewarpModifier>.applyMeshToSpline BooleanClass default: false -- boolean; Apply_To_Spline

このオプションは、UI には公開されません。使用しないでください。

<Point_CacheSpacewarpModifier>.forceUncPath BooleanClass default: true -- boolean; Force_UNC_Path

キャッシュ パスを UNC パスに強制するかどうかを取得/設定します。このオプションは、UI には公開されません。

<Point_CacheSpacewarpModifier>.interpolationType Integer default: 0 -- integer; Interpolation_Type

このオプションは、UI には公開されません。使用しないでください。

<Point_CacheSpacewarpModifier>.playbackORTafter Integer default: 0 -- integer; Playback_Out_Of_Range_After

このオプションは、UI には公開されません。

<Point_CacheSpacewarpModifier>.playbackORTbefore Integer default: 0 -- integer; Playback_Out_Of_Range_Before

このオプションは、UI には公開されません。

<Point_CacheSpacewarpModifier>.preLoadCache BooleanClass default: false -- boolean; PreLoad_Cache

シーンをロードするときにキャッシュを事前にロードするかどうかを取得/設定します。このオプションは、UI には公開されません。

PointCacheMan 構造体

pointCacheMan.GetMemoryUsed()

シーン内でポイント キャッシュによって使用されているメモリを返します。

cacheOps 構造体

cacheOps.DisableBelow <PointCacheWSM>

ポイント キャッシュ スペース ワープ の配下にあるすべてのモディファイヤを無効にします。

cacheOps.EnableBelow <PointCacheWSM>

ポイント キャッシュ スペース ワープの配下にあるすべてのモディファイヤを有効にします。

cacheOps.RecordCache <PointCacheWSM>

指定されたポイント キャッシュ スペース ワープのキャッシュ データをディスクに記録します。

cacheOps.Reload <PointCacheWSM>

指定されたポイント キャッシュ スペース ワープのキャッシュ データをディスクから再ロードします。

cacheOps.Unload <PointCacheWSM>

指定されたポイント キャッシュ スペース ワープのキャッシュ データをメモリからアンロードします。

3ds Max 9 以前の従来の定義

Point_CacheSpaceWarpModifier : SpaceWarpModifier

Point_CacheSpacewarpModifier - superclass: SpacewarpModifier; super-superclass:MAXWrapper - 7:0 - classID: #(567311073, 1221790701)

コンストラクタ

Point_CacheSpacewarpModifier ... PointCacheWSM ...

プロパティ

<Point_CacheSpacewarpModifier>.time Float default: 0.0 -- float

<Point_CacheSpacewarpModifier>.start_time Float default: 0.0 -- float

キャッシュされたアニメーションが再生を終了するフレーム番号。小数を指定すると、[フレーム : ティック]時間表示を使ったときに、サブフレーム設定で開始されます。既定値は 0.0 です。

頂点アニメーションを記録する最初のフレームを設定します。

<Point_CacheSpacewarpModifier>.end_time Float default: 100.0 -- float

頂点アニメーションを記録する最後のフレームを設定します。

<Point_CacheSpacewarpModifier>.samples Integer default: 1 -- integer

<Point_CacheSpacewarpModifier>.cache_file Filenamedefault: undefined -- string

ディスクのキャッシュ ファイルに格納されている頂点アニメーションを、ポイント キャッシュ モディファイヤにロードします。キャッシュ ファイルの頂点数がオブジェクトの頂点数と一致しない場合、警告が表示されます。ただし、エラーは発生しません。

<Point_CacheSpacewarpModifier>.relativeOffset Boolean default: false -- boolean; Relative_Offset

[強度]設定を有効にします。アニメートされる頂点位置を、記録された位置への相対位置にオフセットします。既定値はオフです。

<Point_CacheSpacewarpModifier>.strength Float default: 1.0 -- animatable; float

元のアニメーションに関連付けられたモーションに影響します。[相対オフセットを使用]がオンの場合のみ有効です。既定値は 1.0 です。範囲は -10.0 ～ 10.0 です。

1.0 を設定すると、アニメーションは記録された状態のまま再生されます。強度に 0 ～ 1 の値を設定すると、アニメーションが相対的に抑制されます。強度を 1 より大きくすると、アニメーションが強調されます。[強度]に負の値を設定すると、モーションは反転します。

ポイント キャッシュ インタフェース:

Interface:pointCacheWSM

メソッド

<void>record()

頂点アニメーションがディスク ファイルに保存されます。

[記録]を呼び出して[ポイントを保存]ダイアログ ボックスをアクティブにし、キャッシュ ファイルのパスと名前を指定します。

[OK]をクリックして、ファイルを記録します。次に、ポイント キャッシュ モディファイヤにファイルをロードすると、再生の準備が完了します。

<void>setCache()

ディスクのキャッシュ ファイルに格納されている頂点アニメーションを、ポイント キャッシュ スペースワープ モディファイヤにロードします。

キャッシュ ファイルの頂点数がオブジェクトの頂点数と一致しない場合、警告が表示されます。ただし、エラーは発生しません。

<void>enableMods()

ポイント キャッシュ スペースワープ モディファイヤ以下のスタック モディファイヤをすべてオンにします。

モディファイヤの設定を変更するときに、オンにします。

<void>disableMods()

このオブジェクトについて、ポイント キャッシュ スペースワープ モディファイヤ以下のスタック モディファイヤをすべてオフにします。アニメーションを再生するときに、キャッシュされた頂点アニメーションだけが表示されます。