ID2D1RadialGradientBrush-Schnittstelle (d2d1.h)
Zeichnet einen Bereich mit einem radialen Farbverlauf.
Vererbung
Die ID2D1RadialGradientBrush-Schnittstelle erbt von ID2D1Brush. ID2D1RadialGradientBrush verfügt auch über folgende Membertypen:
Methoden
Die ID2D1RadialGradientBrush-Schnittstelle verfügt über diese Methoden.
| ID2D1RadialGradientBrush::GetCenter Ruft den Mittelpunkt der Farbverlaufsellipse ab. |
| ID2D1RadialGradientBrush::GetGradientOriginOffset Ruft den Offset des Farbverlaufsursprungs relativ zur Mitte der Farbverlaufsellipse ab. |
| ID2D1RadialGradientBrush::GetGradientStopCollection Ruft die ID2D1GradientStopCollection ab, die diesem radialen Farbverlaufspinselobjekt zugeordnet ist. |
| ID2D1RadialGradientBrush::GetRadiusX Ruft den x-Radius der Farbverlaufsellipse ab. |
| ID2D1RadialGradientBrush::GetRadiusY Ruft den y-Radius der Farbverlaufsellipse ab. |
| ID2D1RadialGradientBrush::SetCenter Gibt den Mittelpunkt der Farbverlaufsellipse im Koordinatenraum des Pinsels an. |
| ID2D1RadialGradientBrush::SetGradientOriginOffset Gibt den Offset des Farbverlaufsursprungs relativ zur Mitte der Farbverlaufsellipse an. |
| ID2D1RadialGradientBrush::SetRadiusX Gibt den x-Radius der Farbverlaufsellipse im Koordinatenraum des Pinsels an. |
| ID2D1RadialGradientBrush::SetRadiusY Gibt den y-Radius der Farbverlaufsellipse im Koordinatenraum des Pinsels an. |
Hinweise
Der ID2D1RadialGradientBrush ähnelt dem ID2D1LinearGradientBrush , da beide eine Sammlung von Farbverlaufsstopps einem Farbverlauf zuordnen. Der lineare Farbverlauf hat jedoch einen Anfang und einen Endpunkt, um den Farbverlaufsvektor zu definieren, während der radiale Farbverlauf eine Ellipse und einen Farbverlaufsursprung verwendet, um sein Farbverlaufsverhalten zu definieren. Um die Position und Größe der Auslassungspunkte zu definieren, verwenden Sie die Methoden SetCenter, SetRadiusX und SetRadiusY , um die Mitte, den x-Radius und den y-Radius der Ellipse anzugeben. Der Farbverlaufsursprung ist der Mittelpunkt der Ellipse, es sei denn, ein Farbverlaufsoffset wird mithilfe der SetGradientOriginOffset-Methode angegeben.
Der Pinsel ordnet die Farbverlaufsstoppposition 0,0f des Farbverlaufsurursprungs zu, und die Position 1.0f wird der Ellipsengrenze zugeordnet. Wenn sich der Farbverlaufsursprung innerhalb der Ellipse befindet, schließt der Inhalt der Ellipse den gesamten Bereich [0, 1] des Pinselverlaufs ein. Wenn sich der Farbverlaufsursprung außerhalb der Grenzen der Ellipse befindet, funktioniert der Pinsel weiterhin, aber sein Farbverlauf ist nicht genau definiert.
Start- und Endpunkt werden im Pinselraum beschrieben und dem Renderziel zugeordnet, wenn der Pinsel verwendet wird. Beachten Sie, dass die Anfangs- und Endkoordinaten absolut und nicht relativ zur Renderzielgröße sind. Ein Wert von (0, 0) wird der oberen linken Ecke des Renderziels zugeordnet, während ein Wert von (1, 1) nur einem Pixel diagonal von (0, 0) zugeordnet ist. Wenn eine Nichtidentitäts-Pinseltransformation oder eine Renderzieltransformation vorhanden ist, werden auch die Pinselellipse und der Farbverlaufsursprung transformiert.
Es ist möglich, eine Ellipse anzugeben, die den zu bemalten Bereich nicht vollständig ausfüllt. In diesem Fall bestimmt die D2D1_EXTEND_MODE und Einstellung (angegeben durch den Pinsel ID2D1GradientStopCollection), wie der verbleibende Bereich gezeichnet wird.
Erstellen von ID2D1RadialGradientBrush-Objekten
Um einen radialen Farbverlaufspinsel zu erstellen, verwenden Sie die ID2D1RenderTarget::CreateRadialGradientBrush-Methode des Renderziels, auf dem der Pinsel verwendet wird. Der Pinsel kann nur mit dem Renderziel verwendet werden, von dem er erstellt wurde, oder mit den kompatiblen Zielen für dieses Renderziel.Ein Radialverlaufspinsel ist eine geräteabhängige Ressource: Ihre Anwendung sollte radiale Farbverlaufspinsel erstellen, nachdem sie das Renderziel initialisiert hat, mit dem die Pinsel verwendet werden sollen, und die Pinsel neu erstellen, wenn das Renderziel neu erstellt werden muss. (Weitere Informationen zu Ressourcen finden Sie unter Ressourcenübersicht.)
Beispiele
Ein Beispiel zum Erstellen eines radialen Farbverlaufspinsels finden Sie im Thema Erstellen eines Radialverlaufspinsels .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1.h |