IDCompositionAnimation::AddSinusoidal メソッド (dcompanimation.h)

アニメーション関数に正弦セグメントを追加します。

構文

HRESULT AddSinusoidal(
  double beginOffset,
  float  bias,
  float  amplitude,
  float  frequency,
  float  phase
);

beginOffset

型: double

アニメーション関数の先頭から、このセグメントを有効にするポイントまでのオフセット (秒単位)。

bias

型: float

正弦に追加される定数。

amplitude

型: float

正弦に適用されるスケール係数。

frequency

型: float

時間オフセットに適用されるスケール係数 (Hertz)。

phase

型: float

時間オフセットに追加される定数 (度単位)。

種類: HRESULT

関数が成功した場合は、S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。エラーコードの一覧については、「 DirectComposition エラーコード」を参照してください。

このメソッドは、いずれかのパラメーターが NaN、正の無限大、または負の無限大である場合、または beginOffset パラメーターが負の場合に失敗します。

アニメーションセグメントを増やす順序で追加する必要があるため、 beginOffset パラメーターが前のセグメントの beginOffset パラメーター (存在する場合) 以下の場合、このメソッドは失敗します。

このアニメーションセグメントは、アニメーション関数の次のセグメントの開始時刻まで有効なままです。アニメーション関数にこれ以上セグメントが含まれていない場合、このセグメントは無期限に有効なままになります。