CRenderTarget-Klasse

Artikel
10/12/2023

Ein Wrapper für ID2D1RenderTarget.

Syntax

class CRenderTarget : public CObject;

Member

Öffentliche Konstruktoren

Name	Beschreibung
CRenderTarget::CRenderTarget	Erstellt ein CRenderTarget -Objekt.
CRenderTarget::~CRenderTarget	Der Destruktor. Wird aufgerufen, wenn ein Renderzielobjekt zerstört wird.

Öffentliche Methoden

Name	Beschreibung
CRenderTarget::Attach	Fügt vorhandene Renderzielschnittstelle an das Objekt an.
CRenderTarget::BeginDraw	Initiiert die Zeichnung für dieses Renderziel.
CRenderTarget::Clear	Löscht den Zeichnungsbereich auf die angegebene Farbe.
CRenderTarget::COLORREF_TO_D2DCOLOR	Konvertiert GDI-Farb- und Alphawerte in das D2D1_COLOR_F-Objekt.
CRenderTarget::CreateCompatibleRenderTarget	Erstellt ein neues Bitmap-Renderziel für die Verwendung während der zwischengeschalteten Offscreen-Zeichnung, die mit dem aktuellen Renderziel kompatibel ist.
CRenderTarget::D estroy	Löscht eine oder mehrere Ressourcen.
CRenderTarget::D etach	Trennt die Renderzielschnittstelle vom Objekt.
CRenderTarget::D rawBitmap	Zeichnet den formatierten Text, der durch das angegebene IDWriteTextLayout -Objekt beschrieben wird.
CRenderTarget::D rawEllipse	Zeichnet die Kontur der angegebenen Ellipse mithilfe der angegebenen Strichart.
CRenderTarget::D rawGeometry	Zeichnet die Kontur der angegebenen Geometrie mithilfe der angegebenen Strichart.
CRenderTarget::D rawGlyphRun	Zeichnet die angegebenen Glyphen.
CRenderTarget::D rawLine	Zeichnet eine Linie zwischen den angegebenen Punkten mithilfe der angegebenen Strichart.
CRenderTarget::D rawRectangle	Zeichnet die Kontur eines Rechtecks mit den angegebenen Abmessungen und Strichformaten.
CRenderTarget::D rawRoundedRectangle	Zeichnet die Kontur des angegebenen abgerundeten Rechtecks mithilfe der angegebenen Strichart.
CRenderTarget::D rawText	Zeichnet den angegebenen Text mithilfe der Formatinformationen, die von einem IDWriteTextFormat -Objekt bereitgestellt werden.
CRenderTarget::D rawTextLayout	Zeichnet den formatierten Text, der durch das angegebene IDWriteTextLayout -Objekt beschrieben wird.
CRenderTarget::EndDraw	Beendet Zeichnungsvorgänge für das Renderziel und gibt den aktuellen Fehlerstatus und die zugehörigen Tags an.
CRenderTarget::FillEllipse	Zeichnet das Innere der angegebenen Ellipse.
CRenderTarget::FillGeometry	Zeichnet das Innere der angegebenen Geometrie.
CRenderTarget::FillMesh	Zeichnet das Innere des angegebenen Gitters.
CRenderTarget::FillOpacityMask	Wendet die durch die angegebene Bitmap beschriebene Deckkraftmaske auf einen Pinsel an und verwendet diesen Pinsel, um einen Bereich des Renderziels zu zeichnen.
CRenderTarget::FillRectangle	Zeichnet das Innere des angegebenen Rechtecks.
CRenderTarget::FillRoundedRectangle	Zeichnet das Innere des angegebenen abgerundeten Rechtecks.
CRenderTarget::Flush	Führt alle ausstehenden Zeichnungsbefehle aus.
CRenderTarget::GetAntialiasMode	Ruft den aktuellen Antialiasingmodus für Nichttext-Zeichnungsvorgänge ab.
CRenderTarget::GetDpi	Gibt die Punkte pro Zoll (DPI) des Renderziels zurück.
CRenderTarget::GetMaximumBitmapSize	Ruft die maximale Größe in geräteabhängigen Einheiten (Pixel) einer beliebigen Bitmapdimension ab, die vom Renderziel unterstützt wird.
CRenderTarget::GetPixelFormat	Ruft das Pixelformat und den Alphamodus des Renderziels ab.
CRenderTarget::GetPixelSize	Gibt die Größe des Renderziels in Gerätepixeln zurück.
CRenderTarget::GetRenderTarget	Gibt id2D1RenderTarget-Schnittstelle zurück.
CRenderTarget::GetSize	Gibt die Größe des Renderziels in geräteunabhängigen Pixeln zurück.
CRenderTarget::GetTags	Ruft die Beschriftung für nachfolgende Zeichnungsvorgänge ab.
CRenderTarget::GetTextAntialiasMode	Ruft den aktuellen Antialiasingmodus für Text- und Glyphenzeichnungsvorgänge ab.
CRenderTarget::GetTextRenderingParams	Ruft die aktuellen Textrenderingoptionen des Renderziels ab.
CRenderTarget::GetTransform	Wendet die angegebene Transformation auf das Renderziel an, wobei die vorhandene Transformation ersetzt wird. Alle nachfolgenden Zeichnungsvorgänge erfolgen im transformierten Bereich.
CRenderTarget::IsSupported	Gibt an, ob das Renderziel die angegebenen Eigenschaften unterstützt.
CRenderTarget::IsValid	Überprüft die Gültigkeit der Ressource
CRenderTarget::P opAxisAlignedClip	Entfernt den letzten Achsenausrichtungsclip aus dem Renderziel. Nachdem diese Methode aufgerufen wurde, wird der Clip nicht mehr auf nachfolgende Zeichnungsvorgänge angewendet.
CRenderTarget::P opLayer	Beendet das Umleiten von Zeichnungsvorgängen auf die Ebene, die vom letzten PushLayer-Aufruf angegeben wird.
CRenderTarget::P ushAxisAlignedClip	Entfernt den letzten Achsenausrichtungsclip aus dem Renderziel. Nachdem diese Methode aufgerufen wurde, wird der Clip nicht mehr auf nachfolgende Zeichnungsvorgänge angewendet.
CRenderTarget::P ushLayer	Fügt die angegebene Ebene zum Renderziel hinzu, sodass alle nachfolgenden Zeichnungsvorgänge empfangen werden, bis PopLayer aufgerufen wird.
CRenderTarget::RestoreDrawingState	Legt den Zeichnungszustand des Renderziels auf den des angegebenen ID2D1DrawingStateBlock fest.
CRenderTarget::SaveDrawingState	Speichert den aktuellen Zeichnungszustand im angegebenen ID2D1DrawingStateBlock.
CRenderTarget::SetAntialiasMode	Legt den Antialiasingmodus des Renderziels fest. Der Antialiasingmodus gilt für alle nachfolgenden Zeichnungsvorgänge, mit Ausnahme von Text- und Glyphenzeichnungsvorgängen.
CRenderTarget::SetDpi	Legt die Punkte pro Zoll (DPI) des Renderziels fest.
CRenderTarget::SetTags	Gibt eine Beschriftung für nachfolgende Zeichnungsvorgänge an.
CRenderTarget::SetTextAntialiasMode	Gibt den Antialiasingmodus an, der für nachfolgende Text- und Glyphenzeichnungsvorgänge verwendet werden soll.
CRenderTarget::SetTextRenderingParams	Gibt Textrenderingoptionen an, die auf alle nachfolgenden Text- und Glyphenzeichnungsvorgänge angewendet werden sollen.
CRenderTarget::SetTransform	Überladen. Wendet die angegebene Transformation auf das Renderziel an, wobei die vorhandene Transformation ersetzt wird. Alle nachfolgenden Zeichnungsvorgänge erfolgen im transformierten Bereich.

Geschützte Methoden

Name	Beschreibung
CRenderTarget::VerifyResource	Überprüft die Gültigkeit des CD2DResource-Objekts; erstellt das Objekt, wenn es noch nicht vorhanden war.

Öffentliche Operatoren

Name	Beschreibung
CRenderTarget::operator ID2D1RenderTarget*	Gibt id2D1RenderTarget-Schnittstelle zurück.

Geschützte Datenmember

Name	Beschreibung
CRenderTarget::m_lstResources	Eine Liste der Zeiger auf CD2DResource-Objekte.
CRenderTarget::m_pRenderTarget	Ein Zeiger auf ein ID2D1RenderTarget-Objekt.
CRenderTarget::m_pTextFormatDefault	Ein Zeiger auf CD2DTextFormat-Objekt, das ein Standardtextformat enthält.

Vererbungshierarchie

CObject

CRenderTarget

Anforderungen

Header: afxrendertarget.h

CRenderTarget::~CRenderTarget

Der Destruktor. Wird aufgerufen, wenn ein Renderzielobjekt zerstört wird.

virtual ~CRenderTarget();

CRenderTarget::Attach

Fügt vorhandene Renderzielschnittstelle an das Objekt an.

void Attach(ID2D1RenderTarget* pRenderTarget);

Parameter

pRenderTarget
Vorhandene Renderzielschnittstelle. Darf nicht NULL sein.

CRenderTarget::BeginDraw

Initiiert die Zeichnung für dieses Renderziel.

void BeginDraw();

CRenderTarget::Clear

Löscht den Zeichnungsbereich auf die angegebene Farbe.

void Clear(D2D1_COLOR_F color);

Parameter

color
Die Farbe, zu der der Zeichnungsbereich gelöscht wird.

CRenderTarget::COLORREF_TO_D2DCOLOR

Konvertiert GDI-Farb- und Alphawerte in das D2D1_COLOR_F-Objekt.

static D2D1_COLOR_F COLORREF_TO_D2DCOLOR(
    COLORREF color,
    int nAlpha = 255);

Parameter

color
RGB-Wert.

nAlpha

Rückgabewert

D2D1_COLOR_F Wert.

CRenderTarget::CreateCompatibleRenderTarget

Erstellt ein neues Bitmap-Renderziel für die Verwendung während der zwischengeschalteten Offscreen-Zeichnung, die mit dem aktuellen Renderziel kompatibel ist.

BOOL CreateCompatibleRenderTarget(
    CBitmapRenderTarget& bitmapTarget,
    CD2DSizeF sizeDesired = CD2DSizeF(0., 0.),
    CD2DSizeU sizePixelDesired = CD2DSizeU(0, 0),
    D2D1_PIXEL_FORMAT* desiredFormat = NULL,
    D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE);

Parameter

bitmapTarget
Wenn diese Methode zurückgegeben wird, enthält sie die Adresse eines Zeigers auf ein neues Bitmap-Renderziel. Dieser Parameter wird nicht initialisiert übergeben.

sizeDesired
Die gewünschte Größe des neuen Renderziels in geräteunabhängigen Pixeln, wenn sie sich vom ursprünglichen Renderziel oder NULL unterscheiden soll. Weitere Informationen finden Sie im Abschnitt Hinweise.

sizePixelDesired
Die gewünschte Größe des neuen Renderziels in Pixeln, wenn sie sich vom ursprünglichen Renderziel oder NULL unterscheiden soll. Weitere Informationen finden Sie im Abschnitt Hinweise.

desiredFormat
Das gewünschte Pixelformat und Alphamodus des neuen Renderziels oder NULL. Wenn das Pixelformat auf DXGI_FORMAT_UNKNOWN festgelegt ist oder dieser Parameter null ist, verwendet das neue Renderziel das gleiche Pixelformat wie das ursprüngliche Renderziel. Wenn der Alphamodus D2D1_ALPHA_MODE_UNKNOWN ist oder dieser Parameter NULL ist, wird der Alphamodus des neuen Renderziels standardmäßig auf D2D1_ALPHA_MODE_PREMULTIPLIED festgelegt. Informationen zu unterstützten Pixelformaten finden Sie unter Unterstützte Pixelformate und Alphamodi.

Optionen
Ein Wert, der angibt, ob das neue Renderziel mit GDI kompatibel sein muss.

Rückgabewert

Wenn die Methode erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben.

CRenderTarget::CRenderTarget

Erstellt ein CRenderTarget -Objekt.

CRenderTarget();

CRenderTarget::D estroy

Löscht eine oder mehrere Ressourcen.

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parameter

bDeleteResources
Wenn bDeleteResources WAHR ist, werden alle Ressourcen, die sich in m_lstResources befinden, automatisch zerstört.

Rückgabewert

Wenn die Methode erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben.

CRenderTarget::D etach

Trennt die Renderzielschnittstelle vom Objekt.

ID2D1RenderTarget* Detach ();

Rückgabewert

Zeiger auf die getrennte Renderzielschnittstelle.

CRenderTarget::D rawBitmap

Zeichnet den formatierten Text, der durch das angegebene IDWriteTextLayout -Objekt beschrieben wird.

void DrawBitmap(
    CD2DBitmap* pBitmap,
    const CD2DRectF& rectDest,
    float fOpacity = 1.0,
    D2D1_BITMAP_INTERPOLATION_MODE interpolationMode = D2D1_BITMAP_INTERPOLATION_MODE_LINEAR,
    const CD2DRectF* pRectSrc = NULL);

Parameter

pBitmap
Die zu rendernde Bitmap.

rectDest
Die Größe und Position in geräteunabhängigen Pixeln im Koordinatenbereich des Renderziels des Bereichs, in den die Bitmap gezeichnet wird. Wenn das Rechteck nicht ordnungsgemäß sortiert ist, wird nichts gezeichnet, aber das Renderziel gibt keinen Fehlerzustand ein.

fOpacity
Ein Wert zwischen 0,0f und 1,0f (einschließlich), der einen Deckkraftwert angibt, der auf die Bitmap angewendet werden soll; Dieser Wert wird mit den Alphawerten des Bitmapinhalts multipliziert.

Interpolationmode
Der Interpolationsmodus, der verwendet werden soll, wenn die Bitmap durch den Zeichnungsvorgang skaliert oder gedreht wird.

pRectSrc
Die Größe und Position in geräteunabhängigen Pixeln im Koordinatenbereich der Bitmap des zu zeichnenden Bereichs innerhalb der Bitmap.

CRenderTarget::D rawEllipse

Zeichnet die Kontur der angegebenen Ellipse mithilfe der angegebenen Strichart.

void DrawEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameter

Ellipse
Die Position und der Radius der zu zeichnenden Ellipse in geräteunabhängigen Pixeln.

pBrush
Der Pinsel, der zum Zeichnen der Kontur der Ellipse verwendet wird.

fStrokeWidth
Die Stärke des Ellipsenstrichs. Der Strich wird auf der Ellipse zentriert.

strokeStyle
Die Art des Strichs, der auf die Kontur der Ellipse angewendet werden soll, oder NULL, um einen durchgezogenen Strich zu zeichnen.

CRenderTarget::D rawGeometry

Zeichnet die Kontur der angegebenen Geometrie mithilfe der angegebenen Strichart.

void DrawGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameter

pGeometry
Die zu zeichnende Geometrie.

pBrush
Der Pinsel, der zum Zeichnen des Geometriestrichs verwendet wird.

fStrokeWidth
Die Stärke des Strichs der Geometrie. Der Strich wird auf der Gliederung der Geometrie zentriert.

strokeStyle
Das Format des Strichs, der auf die Gliederung der Geometrie angewendet werden soll, oder NULL, um einen einfarbigen Strich zu zeichnen.

CRenderTarget::D rawGlyphRun

Zeichnet die angegebenen Glyphen.

void DrawGlyphRun(
    const CD2DPointF& ptBaseLineOrigin,
    const DWRITE_GLYPH_RUN& glyphRun,
    CD2DBrush* pForegroundBrush,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

Parameter

ptBaseLineOrigin
Der Ursprung in geräteunabhängigen Pixeln der Grundlinie der Glyphen.

Glyphrun
Die zu rendernden Glyphen.

pForegroundBrush
Der Pinsel, der zum Zeichnen der angegebenen Glyphen verwendet wird.

measuringMode
Ein Wert, der angibt, wie Glyphenmetriken verwendet werden, um Text beim Formatieren zu messen. Der Standardwert ist DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Zeichnet eine Linie zwischen den angegebenen Punkten mithilfe der angegebenen Strichart.

void DrawLine(
    const CD2DPointF& ptFrom,
    const CD2DPointF& ptTo,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameter

ptFrom
Der Anfangspunkt der Linie in geräteunabhängigen Pixeln.

ptTo
Der Endpunkt der Linie in geräteunabhängigen Pixeln.

pBrush
Der Pinsel, der zum Zeichnen des Linienstrichs verwendet wird.

fStrokeWidth
Ein Wert größer oder gleich 0,0f, der die Breite des Strichs angibt. Wenn dieser Parameter nicht angegeben ist, wird er standardmäßig auf 1,0f festgelegt. Der Strich wird auf der Linie zentriert.

strokeStyle
Das Format des zu zeichnenden Strichs oder NULL zum Zeichnen einer durchgezogenen Linie.

CRenderTarget::D rawRectangle

Zeichnet die Kontur eines Rechtecks mit den angegebenen Abmessungen und Strichformaten.

void DrawRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameter

Rechteck
Die Abmessungen des zu zeichnenden Rechtecks in geräteunabhängigen Pixeln

pBrush
Der Pinsel zum Zeichnen des Strichs des Rechtecks

fStrokeWidth
Ein Wert größer oder gleich 0,0f, der die Breite des Strichs des Rechtecks angibt. Der Strich wird auf der Gliederung des Rechtecks zentriert.

strokeStyle
Das Format des zu zeichnenden Strichs oder NULL zum Zeichnen eines einfarbigen Strichs.

CRenderTarget::D rawRoundedRectangle

Zeichnet die Kontur des angegebenen abgerundeten Rechtecks mithilfe der angegebenen Strichart.

void DrawRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameter

rectRounded
Die Abmessungen des abgerundeten Rechtecks, das in geräteunabhängigen Pixeln gezeichnet werden soll.

pBrush
Der Pinsel, der zum Zeichnen der abgerundeten Gliederung des Rechtecks verwendet wird.

fStrokeWidth
Die Breite des gerundeten Rechtecksstrichs. Der Strich wird auf der abgerundeten Gliederung des Rechtecks zentriert. Der Standardwert ist 1,0f.

strokeStyle
Die Formatvorlage des gerundeten Rechteckstrichs oder NULL, um einen durchgezogenen Strich zu zeichnen. Der Standardwert ist NULL.

CRenderTarget::D rawText

Zeichnet den angegebenen Text mithilfe der Formatinformationen, die von einem IDWriteTextFormat -Objekt bereitgestellt werden.

void DrawText(
    const CString& strText,
    const CD2DRectF& rectangle,
    CD2DBrush* pForegroundBrush,
    CD2DTextFormat* textFormat = NULL,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

Parameter

strText
Ein Zeiger auf ein Array von Unicode-Zeichen, die gezeichnet werden sollen.

Rechteck
Die Größe und Position des Bereichs, in dem der Text gezeichnet wird.

pForegroundBrush
Der Pinsel, der zum Zeichnen des Texts verwendet wird.

textFormat
Ein Objekt, das Formatierungsdetails des zu zeichnenden Texts beschreibt, z. B. die Schriftart, den Schriftgrad und die Flussrichtung.

Optionen
Ein Wert, der angibt, ob der Text an Pixelbegrenzungen angedockt werden soll und ob der Text auf das Layoutrechteck zugeschnitten werden soll. Der Standardwert ist D2D1_DRAW_TEXT_OPTIONS_NONE, was angibt, dass Text an Pixelbegrenzungen angedockt werden soll und nicht auf das Layoutrechteck zugeschnitten werden soll.

measuringMode
Ein Wert, der angibt, wie Glyphenmetriken verwendet werden, um Text beim Formatieren zu messen. Der Standardwert ist DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawTextLayout

Zeichnet den formatierten Text, der durch das angegebene IDWriteTextLayout -Objekt beschrieben wird.

void DrawTextLayout(
    const CD2DPointF& ptOrigin,
    CD2DTextLayout* textLayout,
    CD2DBrush* pBrushForeground,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE);

Parameter

ptOrigin
Der in geräteunabhängigen Pixeln beschriebene Punkt, an dem die obere linke Ecke des text beschriebenen Texts gezeichnet wird.

Textlayout
Der formatierte Text, der gezeichnet werden soll. Alle Zeichnungseffekte, die nicht von ID2D1Resource erben, werden ignoriert. Wenn Zeicheneffekte vorhanden sind, die von ID2D1Resource erben, die keine Pinsel sind, schlägt diese Methode fehl, und das Renderziel wird in einen Fehlerzustand versetzt.

pBrushForeground
Der Pinsel, der zum Zeichnen von Text in textLayout verwendet wird, der noch keinen Pinsel als Zeichnungseffekt zugeordnet ist (angegeben durch die IDWriteTextLayout::SetDrawingEffect-Methode).

CRenderTarget::EndDraw

Beendet Zeichnungsvorgänge für das Renderziel und gibt den aktuellen Fehlerstatus und die zugehörigen Tags an.

HRESULT EndDraw();

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

CRenderTarget::FillEllipse

Zeichnet das Innere der angegebenen Ellipse.

void FillEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush);

Parameter

Ellipse
Die Position und der Radius in geräteunabhängigen Pixeln der zu zeichnenden Auslassungspunkte.

pBrush
Der Pinsel, der zum Zeichnen des Inneren der Ellipse verwendet wird.

CRenderTarget::FillGeometry

Zeichnet das Innere der angegebenen Geometrie.

void FillGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    CD2DBrush* pOpacityBrush = NULL);

Parameter

pGeometry
Die zu zeichnende Geometrie.

pBrush
Der Pinsel, der zum Zeichnen des Inneren der Geometrie verwendet wird.

pOpacityBrush
Die Deckkraftmaske, die auf die Geometrie angewendet werden soll; NULL für keine Deckkraftmaske. Wenn eine Deckkraftmaske (der opacityBrush-Parameter) angegeben ist, muss Pinsel ein ID2D1BitmapBrush sein, deren X- und Y-Erweiterungsmodi auf D2D1_EXTEND_MODE_CLAMP festgelegt sind. Weitere Informationen finden Sie im Abschnitt Hinweise.

CRenderTarget::FillMesh

Zeichnet das Innere des angegebenen Gitters.

void FillMesh(
    CD2DMesh* pMesh,
    CD2DBrush* pBrush);

Parameter

pMesh
Das zu zeichnende Gitter.

pBrush
Der Pinsel, der zum Zeichnen des Gitters verwendet wird.

CRenderTarget::FillOpacityMask

Wendet die durch die angegebene Bitmap beschriebene Deckkraftmaske auf einen Pinsel an und verwendet diesen Pinsel, um einen Bereich des Renderziels zu zeichnen.

void FillOpacityMask(
    CD2DBitmap* pOpacityMask,
    CD2DBrush* pBrush,
    D2D1_OPACITY_MASK_CONTENT content,
    const CD2DRectF& rectDest,
    const CD2DRectF& rectSrc);

Parameter

pOpacityMask
Die Position und der Radius in geräteunabhängigen Pixeln der zu zeichnenden Auslassungspunkte.

pBrush
Der Pinsel, der zum Zeichnen des Bereichs des durch destinationRectangle angegebenen Renderziels verwendet wird.

content
Der Inhaltstyp, den die Deckkraftmaske enthält. Der Wert wird verwendet, um den Farbraum zu bestimmen, in dem die Deckkraftmaske gemischt wird.

rectDest
Der Bereich des Renderziels zum Zeichnen in geräteunabhängigen Pixeln.

rectSrc
Der Bereich der Bitmap, die als Deckkraftmaske in geräteunabhängigen Pixeln verwendet werden soll.

CRenderTarget::FillRectangle

Zeichnet das Innere des angegebenen Rechtecks.

void FillRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush);

Parameter

Rechteck
Die Dimension des zu zeichnenden Rechtecks in geräteunabhängigen Pixeln.

pBrush
Der Pinsel, der zum Zeichnen des Innenbereichs des Rechtecks verwendet wird.

CRenderTarget::FillRoundedRectangle

Zeichnet das Innere des angegebenen abgerundeten Rechtecks.

void FillRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush);

Parameter

rectRounded
Die Abmessungen des abgerundeten Rechtecks zum Zeichnen in unabhängigen Pixeln des Geräts.

pBrush
Der Pinsel, der zum Zeichnen des Innenbereichs des abgerundeten Rechtecks verwendet wird.

CRenderTarget::Flush

Führt alle ausstehenden Zeichnungsbefehle aus.

void Flush(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL);

Parameter

tag1
Enthält das Tag für Zeichnungsvorgänge, die Fehler verursacht haben, oder 0, wenn keine Fehler aufgetreten sind. Dieser Parameter wird nicht initialisiert übergeben.

Tag2
Enthält das Tag für Zeichnungsvorgänge, die Fehler verursacht haben, oder 0, wenn keine Fehler aufgetreten sind. Dieser Parameter wird nicht initialisiert übergeben.

CRenderTarget::GetAntialiasMode

Ruft den aktuellen Antialiasingmodus für Nichttext-Zeichnungsvorgänge ab.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Rückgabewert

Aktueller Antialiasingmodus für Nichttext-Zeichnungsvorgänge.

CRenderTarget::GetDpi

Gibt die Punkte pro Zoll (DPI) des Renderziels zurück.

CD2DSizeF GetDpi() const;

Rückgabewert

Die Punkte pro Zoll (DPI) des Renderziels.

CRenderTarget::GetMaximumBitmapSize

Ruft die maximale Größe in geräteabhängigen Einheiten (Pixel) einer beliebigen Bitmapdimension ab, die vom Renderziel unterstützt wird.

UINT32 GetMaximumBitmapSize() const;

Rückgabewert

Die maximale Größe in Pixeln einer bitmapdimension, die vom Renderziel unterstützt wird

CRenderTarget::GetPixelFormat

Ruft das Pixelformat und den Alphamodus des Renderziels ab.

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Rückgabewert

Das Pixelformat und der Alphamodus des Renderziels

CRenderTarget::GetPixelSize

Gibt die Größe des Renderziels in Gerätepixeln zurück.

CD2DSizeU GetPixelSize() const;

Rückgabewert

Die Größe des Renderziels in Gerätepixeln

CRenderTarget::GetRenderTarget

Gibt id2D1RenderTarget-Schnittstelle zurück.

ID2D1RenderTarget* GetRenderTarget();

Rückgabewert

Zeiger auf eine ID2D1RenderTarget-Schnittstelle oder NULL, wenn das Objekt noch nicht initialisiert ist.

CRenderTarget::GetSize

Gibt die Größe des Renderziels in geräteunabhängigen Pixeln zurück.

CD2DSizeF GetSize() const;

Rückgabewert

Die aktuelle Größe des Renderziels in geräteunabhängigen Pixeln

CRenderTarget::GetTags

Ruft die Beschriftung für nachfolgende Zeichnungsvorgänge ab.

void GetTags(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL) const;

Parameter

tag1
Enthält die erste Beschriftung für nachfolgende Zeichnungsvorgänge. Dieser Parameter wird nicht initialisiert übergeben. Wenn NULL angegeben ist, wird kein Wert für diesen Parameter abgerufen.

Tag2
Enthält die zweite Beschriftung für nachfolgende Zeichnungsvorgänge. Dieser Parameter wird nicht initialisiert übergeben. Wenn NULL angegeben ist, wird kein Wert für diesen Parameter abgerufen.

CRenderTarget::GetTextAntialiasMode

Ruft den aktuellen Antialiasingmodus für Text- und Glyphenzeichnungsvorgänge ab.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Rückgabewert

Aktueller Antialiasingmodus für Text- und Glyphenzeichnungsvorgänge.

CRenderTarget::GetTextRenderingParams

Ruft die aktuellen Textrenderingoptionen des Renderziels ab.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parameter

textRenderingParams
Wenn diese Methode zurückgegeben wird, enthält textRenderingParams die Adresse eines Zeigers auf die aktuellen Textrenderingoptionen des Renderziels.

CRenderTarget::GetTransform

Ruft die aktuelle Transformation des Renderziels ab.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parameter

transform
Wenn dies zurückgegeben wird, enthält die aktuelle Transformation des Renderziels. Dieser Parameter wird nicht initialisiert übergeben.

CRenderTarget::IsSupported

Gibt an, ob das Renderziel die angegebenen Eigenschaften unterstützt.

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parameter

renderTargetProperties
Zu testende Renderzieleigenschaften

Rückgabewert

TRUE, wenn die angegebenen Renderzieleigenschaften von diesem Renderziel unterstützt werden; andernfalls FALSE

CRenderTarget::IsValid

Überprüft die Gültigkeit der Ressource

BOOL IsValid() const;

Rückgabewert

TRUE, wenn die Ressource gültig ist; andernfalls FALSE.

CRenderTarget::m_lstResources

Eine Liste der Zeiger auf CD2DResource-Objekte.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Ein Zeiger auf ein ID2D1RenderTarget-Objekt.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Ein Zeiger auf CD2DTextFormat-Objekt, das ein Standardtextformat enthält.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Gibt id2D1RenderTarget-Schnittstelle zurück.

operator ID2D1RenderTarget*();

Rückgabewert

Zeiger auf eine ID2D1RenderTarget-Schnittstelle oder NULL, wenn das Objekt noch nicht initialisiert ist.

CRenderTarget::P opAxisAlignedClip

Entfernt den letzten Achsenausrichtungsclip aus dem Renderziel. Nachdem diese Methode aufgerufen wurde, wird der Clip nicht mehr auf nachfolgende Zeichnungsvorgänge angewendet.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Beendet das Umleiten von Zeichnungsvorgängen auf die Ebene, die vom letzten PushLayer-Aufruf angegeben wird.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

Entfernt den letzten Achsenausrichtungsclip aus dem Renderziel. Nachdem diese Methode aufgerufen wurde, wird der Clip nicht mehr auf nachfolgende Zeichnungsvorgänge angewendet.

void PushAxisAlignedClip(
    const CD2DRectF& rectClip,
    D2D1_ANTIALIAS_MODE mode = D2D1_ANTIALIAS_MODE_PER_PRIMITIVE);

Parameter

rectClip
Die Größe und Position des Clippingbereichs in geräteunabhängigen Pixeln.

mode
Der Antialiasingmodus, der verwendet wird, um die Ränder von Cliprechtecks mit Subpixelbegrenzungen zu zeichnen und den Clip mit dem Szeneninhalt zu mischen. Die Vermischung wird einmal ausgeführt, wenn die PopAxisAlignedClip-Methode aufgerufen wird und nicht auf jeden Grundtyp innerhalb der Ebene angewendet wird.

CRenderTarget::P ushLayer

Fügt die angegebene Ebene zum Renderziel hinzu, sodass alle nachfolgenden Zeichnungsvorgänge empfangen werden, bis PopLayer aufgerufen wird.

void PushLayer(
    const D2D1_LAYER_PARAMETERS& layerParameters,
    CD2DLayer& layer);

Parameter

layerParameters
Die Inhaltsgrenzen, geometrische Maske, Deckkraft, Deckkraftmaske und Antialiasingoptionen für die Ebene.

Schicht
Die Ebene, die nachfolgende Zeichnungsvorgänge empfängt.

CRenderTarget::RestoreDrawingState

Legt den Zeichnungszustand des Renderziels auf den des angegebenen ID2D1DrawingStateBlock fest.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parameter

drawingStateBlock
Der neue Zeichnungszustand des Renderziels.

CRenderTarget::SaveDrawingState

Speichert den aktuellen Zeichnungszustand im angegebenen ID2D1DrawingStateBlock.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parameter

drawingStateBlock
Wenn diese Methode zurückgegeben wird, enthält sie den aktuellen Zeichnungszustand des Renderziels. Dieser Parameter muss initialisiert werden, bevor er an die Methode übergeben wird.

CRenderTarget::SetAntialiasMode

Legt den Antialiasingmodus des Renderziels fest. Der Antialiasingmodus gilt für alle nachfolgenden Zeichnungsvorgänge, mit Ausnahme von Text- und Glyphenzeichnungsvorgängen.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parameter

antialiasMode
Der Antialiasingmodus für zukünftige Zeichnungsvorgänge.

CRenderTarget::SetDpi

Legt die Punkte pro Zoll (DPI) des Renderziels fest.

void SetDpi(const CD2DSizeF& sizeDPI);

Parameter

sizeDPI
Ein Wert größer oder gleich Null, der den horizontalen/vertikalen PI des Renderziels angibt.

CRenderTarget::SetTags

Gibt eine Beschriftung für nachfolgende Zeichnungsvorgänge an.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parameter

tag1
Eine Bezeichnung, die auf nachfolgende Zeichnungsvorgänge angewendet werden soll.

Tag2
Eine Bezeichnung, die auf nachfolgende Zeichnungsvorgänge angewendet werden soll.

CRenderTarget::SetTextAntialiasMode

Gibt den Antialiasingmodus an, der für nachfolgende Text- und Glyphenzeichnungsvorgänge verwendet werden soll.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parameter

textAntialiasMode
Der Antialiasingmodus, der für nachfolgende Text- und Glyphenzeichnungsvorgänge verwendet werden soll.

CRenderTarget::SetTextRenderingParams

Gibt Textrenderingoptionen an, die auf alle nachfolgenden Text- und Glyphenzeichnungsvorgänge angewendet werden sollen.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parameter

textRenderingParams
Die Textrenderingoptionen, die auf alle nachfolgenden Text- und Glyphenzeichnungsvorgänge angewendet werden sollen; NULL zum Löschen der aktuellen Textrenderingoptionen.

CRenderTarget::SetTransform

Wendet die angegebene Transformation auf das Renderziel an, wobei die vorhandene Transformation ersetzt wird. Alle nachfolgenden Zeichnungsvorgänge erfolgen im transformierten Bereich.

void SetTransform(const D2D1_MATRIX_3X2_F* transform);
void SetTransform(const D2D1_MATRIX_3X2_F& transform);

Parameter

transform
Die Transformation, die auf das Renderziel angewendet werden soll.

CRenderTarget::VerifyResource

Überprüft die Gültigkeit des CD2DResource-Objekts; erstellt das Objekt, wenn es noch nicht vorhanden war.

BOOL VerifyResource(CD2DResource* pResource);

Parameter

pResource
Zeiger auf CD2DResource-Objekt.

Rückgabewert

TRUE ist Objekt, falls gültig; andernfalls FALSE.

Siehe auch

Klassen