IDCompositionAnimation::AddSinusoidal-Methode (dcompanimation.h)

  • Artikel

Fügt der Animationsfunktion ein sinusförmiges Segment hinzu.

Syntax

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

Parameter

beginOffset

Typ: double

Der Offset in Sekunden vom Anfang der Animationsfunktion bis zu dem Punkt, an dem dieses Segment wirksam werden soll.

bias

Typ: float

Eine Konstante, die dem Sinusoid hinzugefügt wird.

amplitude

Typ: float

Ein Skalierungsfaktor, der auf das Sinusoid angewendet wird.

frequency

Typ: float

Ein Skalierungsfaktor, der auf den Zeitoffset in Hertz angewendet wird.

phase

Typ: float

Eine Konstante, die dem Zeitoffset in Grad hinzugefügt wird.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Diese Methode schlägt fehl, wenn einer der Parameter NaN, positive Unendlichkeit oder negative Unendlichkeit ist oder wenn der beginOffset-Parameter negativ ist.

Da Animationssegmente in zunehmender Reihenfolge hinzugefügt werden müssen, schlägt diese Methode fehl, wenn der beginOffset-Parameter kleiner als oder gleich dem beginOffset-Parameter des vorherigen Segments (sofern vorhanden) ist.

Dieses Animationssegment bleibt bis zur Startzeit des nächsten Segments in der Animationsfunktion wirksam. Wenn die Animationsfunktion keine weiteren Segmente enthält, bleibt dieses Segment unbegrenzt wirksam.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dcompanimation.h
Bibliothek Dcomp.lib
DLL Dcomp.dll

Weitere Informationen

IDCompositionAnimation