ID2D1ImageBrush::SetSourceRectangle-Methode (d2d1_1.h)

Legt das Quellrechteck im Bildpinsel fest.

Syntax

void SetSourceRectangle(
  [in] const D2D1_RECT_F *sourceRectangle
);

Parameter

[in] sourceRectangle

Typ: const D2D1_RECT_F*

Das Quellrechteck, das den Teil des zu kachelnden Bilds definiert.

Rückgabewert

Keine

Bemerkungen

Die obere linke Ecke des sourceRectangle-Parameters wird dem Ursprung des Pinselraums zugeordnet. Das heißt, wenn Pinsel- und Welttransformationen beide Identitäten sind, wird der Teil des Bilds in der oberen linken Ecke des Quellrechtecks bei (0,0) im Renderziel gerendert.

Das Quellrechteck wird unterschiedlich erweitert, je nachdem, ob das Eingabebild auf Pixeln (einer Bitmap oder einem Effekt) oder einer Befehlsliste basiert.

• Wenn das Eingabebild eine Bitmap oder ein Effekt ist, wird das Rechteck erweitert, um ein vollständiges Eingabepixel zu kapseln, bevor es zusätzlich herunterskaliert wird, um sicherzustellen, dass das projizierte Rechteck im letzten Szenenbereich korrekt ist.
• Wenn das Eingabebild eine Befehlsliste ist, wird die Befehlsliste leicht erweitert, um ein vollständiges Eingabepixel zu kapseln.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_1.h
DLL	D2d1.dll

Weitere Informationen

ID2D1ImageBrush