Zuschneideeffekt

Verwenden Sie den Zuschneideeffekt, um einen angegebenen Bereich eines Bilds auszugeben.

Die CLSID für diesen Effekt ist CLSID _ D2D1Crop.

Beispielbild

Vorher
das Bild vor dem Effekt.
Danach
das Bild nach der Transformation.
ComPtr<ID2D1Effect> cropEffect;
m_d2dContext->CreateEffect(CLSID_D2D1Crop, &cropEffect);

cropEffect->SetInput(0, bitmap);
cropEffect->SetValue(D2D1_CROP_PROP_RECT, D2D1::RectF(0.0f, 0.0f, 256.0f, 192.0f));

m_d2dContext->BeginDraw();
m_d2dContext->DrawImage(cropEffect.Get());
m_d2dContext->EndDraw();

Effekteigenschaften

Anzeigename und Indexenumeration Typ und Standardwert BESCHREIBUNG
Rect
D2D1_VECTOR_4F
Der Bereich, der als Vektor im Formular (links, oben, Breite, Höhe) angegeben werden soll.
D2D1_CROP_PROP_RECT
{-FLT_MAX, -FLT_MAX, FLT_MAX, FLT_MAX}
Die Einheiten befinden sich in DIPs.

[!Note]

Der Rect wird abgeschnitten, wenn er die Randgrenzen des Eingabebilds überlappt.


D2D1_CROP_PROP_BORDER_MODE
D2D1_BORDER_MODE
D2D1_BORDER_MODE_SOFT
  • D2D1_BORDER_MODE_SOFT: Wenn das Zuschneiderechteck auf Dezimalpunktkoordinaten fällt, wendet der Effekt Antialiasing an, was zu einem weichen Rand führt.
  • D2D1_BORDER_MODE_HARD : Wenn das Zuschneiderechteck auf Dezimalpunktkoordinaten fällt, wird der Effekt klammern, was zu einem harter Rand führt.

Ausgabebitmap

Die Ausgabe dieses Effekts ist die Größe der Rect-Eigenschaft. Länge und Breite werden berechnet.

Mithilfe der hier beschriebenen Formeln:

Ausgabelänge in Pixels=(Rect.Right-Rect.Left) * (DPI/96 des Benutzers)
Ausgabehöhe in Pixel=(Rect.Bottom-Rect.Top) * (DPI/96 des Benutzers)

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [ Desktop-Apps | Windows Store Apps]
Unterstützte Mindestversion (Server) Windows 8 und Plattformupdate für Windows 7 [ Desktop-Apps | Windows Store Apps]
Header d2d1effects.h
Bibliothek d2d1.lib, dxguid.lib

ID2D1Effect