ID2D1BitmapBrush::SetExtendModeX-Methode (d2d1.h)

Gibt an, wie der Pinsel die Bereiche, die über die Bitmap hinaus reichen, horizontal kachelt.

Syntax

void SetExtendModeX(
  D2D1_EXTEND_MODE extendModeX
);

Parameter

extendModeX

Typ: D2D1_EXTEND_MODE

Ein Wert, der angibt, wie der Pinsel die Bereiche, die über die Bitmap hinaus reichen, horizontal kachelt.

Rückgabewert

Keine

Bemerkungen

Manchmal füllt die Bitmap für einen Bitmappinsel den gezeichneten Bereich nicht vollständig aus. In diesem Fall verwendet Direct2D die Erweiterungsmoduseinstellungen horizontal (SetExtendModeX) und vertikal (SetExtendModeY), um zu bestimmen, wie der verbleibende Bereich ausgefüllt werden soll.

Die folgende Abbildung zeigt die Ergebnisse aus jeder möglichen Kombination der Erweiterungsmodi für einen ID2D1BitmapBrush: D2D1_EXTEND_MODE_CLAMP (CLAMP), D2D1_EXTEND_MODE_WRAP (WRAP) und D2D1_EXTEND_MIRROR (MIRROR).

Abbildung einer Bitmap und der resultierenden Bilder aus verschiedenen Erweiterungsmodi

Beispiele

Im folgenden Beispiel wird gezeigt, wie die x- und y-Erweiterungsmodi des Bitmappinsels auf D2D1_EXTEND_MIRROR festgelegt werden. Anschließend zeichnet es das Rechteck mit dem ID2D1BitmapBrush.

Es erzeugt die folgende Ausgabe.

Veranschaulichung eines Originalbilds und des resultierenden Bilds durch Festlegen der x- und y-Modi auf Spiegel
m_pBitmapBrush->SetExtendModeX(D2D1_EXTEND_MODE_MIRROR);
m_pBitmapBrush->SetExtendModeY(D2D1_EXTEND_MODE_MIRROR);

m_pRenderTarget->FillRectangle(exampleRectangle, m_pBitmapBrush);

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
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1BitmapBrush

ID2D1BitmapBrush::GetExtendModeX