v5.1
指定されたフィルタを使用して、指定されたタイムスパンの F カーブをスムージングします。スムージングを実行すると、キー間の平均をとって、F カーブの鋭いスパイクやギザギザが取り除かれます。F カーブは最初にスムージングされ、in_dSamplingStep のサンプリングステップで再サンプリングされます。
注：F カーブがロックされているか、内部のいずれかのキーがロックされている場合は、'Access Denied'（E_ACCESSDENIED）エラーが発生します。
FCurve.Smooth( Object in_StartFrame, Object in_EndFrame, Double in_dFilterSize, Double in_dSamplingStep, siFCurveSmoothFilterType in_filterType, Double in_dGaussianVariance ); |
FCurve.Smooth( [StartFrame], [EndFrame], [FilterSize], [SamplingStep], [FilterType], [GaussianVariance] ); |
| パラメータ | タイプ | 説明 |
|---|---|---|
| StartFrame | Variant |
スムージングする範囲の開始時間EndFrame 値よりも低い値にする必要があります。 デフォルト値：F カーブの最初のキーフレーム。キーがない場合は、PlayControl の In フレーム値 |
| EndFrame | Variant |
スムージングを終了する時間（フレーム） デフォルト値：最後のキーフレーム。キーがない場合は、PlayControl の Out フレーム値 |
| FilterSize | Double |
新しいキーを計算するために平均化するキーの数を定義します。 フィルタのサイズが大きいほど直線に近いカーブが得られます。この値は 1より大きい値である必要があります。 デフォルト値： 5 |
| SamplingStep | Double |
スムージングの後に F カーブに適用されたサンプリングステップ。FilterSize よりも小さい値にする必要があります。 デフォルト値： 1 |
| FilterType | siFCurveSmoothFilterType |
スムージングに使用するフィルタのタイプを指定します。 デフォルト値：siFCurveAverageFilterType |
| GaussianVariance | Double |
ガウスフィルタの変位。スムージングの程度をコントロールします。 変位の値が大きいほど滑らかなファンクション カーブになります。この値は 0 より大きい値である必要があります。 デフォルト値： 1 |
/*
This example illustrates how to use FCurve.Smooth method
*/
// Create a null
NewScene("", false);
var nullobj = Application.ActiveSceneRoot.AddNull();
// Use the Resample method to add keys to empty fcurves
nullobj.posx.AddFCurve().Resample( 1,50, 5 );
nullobj.posy.AddFCurve().Resample( 1,50, 5 );
var posxFC = nullobj.posx.Source;
var posyFC = nullobj.posy.Source;
Application.LogMessage( "posx curve : " + posxFC.GetNumKeys() );
Application.LogMessage( "posy curve : " + posyFC.GetNumKeys() );
// Smooth the posx curve
posxFC.Smooth(1,50);
Application.LogMessage( "smoothed posx curve : " + posxFC.GetNumKeys() );
Application.LogMessage( "posy curve : " + posyFC.GetNumKeys() );
// Outputs:
//INFO : posx curve : 11
//INFO : posy curve : 11
//INFO : smoothed posx curve : 50
//INFO : posy curve : 11 |