IDCompositionRotateTransform3D::SetAxisZ(float) メソッド (dcomp.h)

3D 回転変換の AxisZ プロパティの値を変更します。 AxisZ プロパティは、回転の軸ベクトルの z 座標を指定します。既定値は 1.0 です。

構文

HRESULT SetAxisZ(
  [in] float axisZ
);

[in] axisZ

型: float

回転の軸ベクトルの新しい z 座標。

種類: HRESULT

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

軸を既定値以外に設定する場合は、常に 3 つの軸プロパティ (AxisX、AxisY、AxisZ) をすべて設定する必要があります。

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

AxisZ プロパティが以前にアニメーション化されていた場合、このメソッドはアニメーションを削除し、AxisX プロパティを指定した静的値に設定します。