CRenderTarget, classe

Article
10/12/2023

Wrapper pour ID2D1RenderTarget.

Syntaxe

class CRenderTarget : public CObject;

Membres

Constructeurs publics

Nom	Description
CRenderTarget ::CRenderTarget	Construit un objet CRenderTarget.
CRenderTarget ::~CRenderTarget	Destructeur. Appelé lorsqu’un objet cible de rendu est détruit.

Méthodes publiques

Nom	Description
CRenderTarget ::Attach	Attache l’interface cible de rendu existante à l’objet
CRenderTarget ::BeginDraw	Lance le dessin sur cette cible de rendu.
CRenderTarget ::Clear	Efface la zone de dessin de la couleur spécifiée.
CRenderTarget ::COLORREF_TO_D2DCOLOR	Convertit les valeurs de couleur et d’alpha GDI en objet D2D1_COLOR_F.
CRenderTarget ::CreateCompatibleRenderTarget	Crée une cible de rendu bitmap à utiliser pendant le dessin hors écran intermédiaire compatible avec la cible de rendu actuelle.
CRenderTarget ::D estroy	Supprime une ou plusieurs ressources
CRenderTarget ::D etach	Détache l’interface cible du rendu de l’objet
CRenderTarget ::D rawBitmap	Dessine le texte mis en forme décrit par l’objet IDWriteTextLayout spécifié.
CRenderTarget ::D rawEllipse	Dessine le contour de l’ellipse spécifié à l’aide du style de trait spécifié.
CRenderTarget ::D rawGeometry	Dessine le contour de la géométrie spécifiée à l’aide du style de trait spécifié.
CRenderTarget ::D rawGlyphRun	Dessine les glyphes spécifiés.
CRenderTarget ::D rawLine	Dessine une ligne entre les points spécifiés à l’aide du style de trait spécifié.
CRenderTarget ::D rawRectangle	Dessine le contour d’un rectangle qui a les dimensions et le style de trait spécifiés.
CRenderTarget ::D rawRoundedRectangle	Dessine le contour du rectangle arrondi spécifié à l’aide du style de trait spécifié.
CRenderTarget ::D rawText	Dessine le texte spécifié à l’aide des informations de format fournies par un objet IDWriteTextFormat.
CRenderTarget ::D rawTextLayout	Dessine le texte mis en forme décrit par l’objet IDWriteTextLayout spécifié.
CRenderTarget ::EndDraw	Termine les opérations de dessin sur la cible de rendu et indique l’état d’erreur actuel et les balises associées.
CRenderTarget ::FillEllipse	Peint l’intérieur de l’ellipse spécifié.
CRenderTarget ::FillGeometry	Peint l’intérieur de la géométrie spécifiée.
CRenderTarget ::FillMesh	Peint l’intérieur du maillage spécifié.
CRenderTarget ::FillOpacityMask	Applique le masque d’opacité décrit par la bitmap spécifiée à un pinceau et utilise ce pinceau pour peindre une région de la cible de rendu.
CRenderTarget ::FillRectangle	Peint l’intérieur du rectangle spécifié.
CRenderTarget ::FillRoundedRectangle	Peint l’intérieur du rectangle arrondi spécifié.
CRenderTarget ::Flush	Exécute toutes les commandes de dessin en attente.
CRenderTarget ::GetAntialiasMode	Récupère le mode antialiasing actuel pour les opérations de dessin non texte.
CRenderTarget ::GetDpi	Retourne les points de la cible de rendu par pouce (PPP)
CRenderTarget ::GetMaximumBitmapSize	Obtient la taille maximale, en unités dépendantes de l’appareil (pixels), d’une dimension bitmap prise en charge par la cible de rendu
CRenderTarget ::GetPixelFormat	Récupère le format de pixel et le mode alpha de la cible de rendu
CRenderTarget ::GetPixelSize	Retourne la taille de la cible de rendu en pixels d’appareil
CRenderTarget ::GetRenderTarget	Retourne l’interface ID2D1RenderTarget
CRenderTarget ::GetSize	Retourne la taille de la cible de rendu en pixels indépendants de l’appareil
CRenderTarget ::GetTags	Obtient l’étiquette pour les opérations de dessin suivantes.
CRenderTarget ::GetTextAntialiasMode	Obtient le mode d’anticrénelage actuel pour les opérations de dessin de texte et de glyphe.
CRenderTarget ::GetTextRenderingParams	Récupère les options de rendu de texte actuelles de la cible de rendu.
CRenderTarget ::GetTransform	Applique la transformation spécifiée à la cible de rendu, en remplaçant la transformation existante. Toutes les opérations de dessin suivantes se produisent dans l’espace transformé.
CRenderTarget ::IsSupported	Indique si la cible de rendu prend en charge les propriétés spécifiées
CRenderTarget ::IsValid	Vérifie la validité des ressources
CRenderTarget ::P opAxisAlignedClip	Supprime le dernier clip aligné sur l’axe de la cible de rendu. Une fois cette méthode appelée, le clip n’est plus appliqué aux opérations de dessin suivantes.
CRenderTarget ::P opLayer	Arrête la redirection des opérations de dessin vers la couche spécifiée par le dernier appel PushLayer.
CRenderTarget ::P ushAxisAlignedClip	Supprime le dernier clip aligné sur l’axe de la cible de rendu. Une fois cette méthode appelée, le clip n’est plus appliqué aux opérations de dessin suivantes.
CRenderTarget ::P ushLayer	Ajoute la couche spécifiée à la cible de rendu afin qu’elle reçoive toutes les opérations de dessin suivantes jusqu’à ce que PopLayer soit appelé.
CRenderTarget ::RestoreDrawingState	Définit l’état de dessin de la cible de rendu sur celui de l’ID2D1DrawingStateBlock spécifié.
CRenderTarget ::SaveDrawingState	Enregistre l’état de dessin actuel dans l’ID2D1DrawingStateBlock spécifié.
CRenderTarget ::SetAntialiasMode	Définit le mode anticrénelage de la cible de rendu. Le mode anticrénelage s’applique à toutes les opérations de dessin suivantes, à l’exclusion des opérations de dessin de texte et de glyphe.
CRenderTarget ::SetDpi	Définit les points par pouce (PPP) de la cible de rendu.
CRenderTarget ::SetTags	Spécifie une étiquette pour les opérations de dessin suivantes.
CRenderTarget ::SetTextAntialiasMode	Spécifie le mode anticrénelage à utiliser pour les opérations de dessin de texte et de glyphe suivantes.
CRenderTarget ::SetTextRenderingParams	Spécifie les options de rendu de texte à appliquer à toutes les opérations de dessin de texte et de glyphe suivantes.
CRenderTarget ::SetTransform	Surcharge. Applique la transformation spécifiée à la cible de rendu, en remplaçant la transformation existante. Toutes les opérations de dessin suivantes se produisent dans l’espace transformé.

Méthodes protégées

Nom	Description
CRenderTarget ::VerifyResource	Vérifie la validité de l’objet CD2DResource ; crée l’objet s’il n’existe pas déjà.

Opérateurs publics

Nom	Description
CRenderTarget ::operator ID2D1RenderTarget*	Retourne l’interface ID2D1RenderTarget

Membres de données protégés

Nom	Description
CRenderTarget ::m_lstResources	Liste de pointeurs vers des objets CD2DResource.
CRenderTarget ::m_pRenderTarget	Pointeur vers un objet ID2D1RenderTarget.
CRenderTarget ::m_pTextFormatDefault	Pointeur vers un objet CD2DTextFormat qui contient un format de texte par défaut.

Hiérarchie d'héritage

CObject

CRenderTarget

Spécifications

En-tête : afxrendertarget.h

CRenderTarget ::~CRenderTarget

Destructeur. Appelé lorsqu’un objet cible de rendu est détruit.

virtual ~CRenderTarget();

CRenderTarget ::Attach

Attache l’interface cible de rendu existante à l’objet

void Attach(ID2D1RenderTarget* pRenderTarget);

Paramètres

pRenderTarget
Interface cible de rendu existante. Impossible d’avoir la valeur NULL

CRenderTarget ::BeginDraw

Lance le dessin sur cette cible de rendu.

void BeginDraw();

CRenderTarget ::Clear

Efface la zone de dessin de la couleur spécifiée.

void Clear(D2D1_COLOR_F color);

Paramètres

color
Couleur à laquelle la zone de dessin est effacée.

CRenderTarget ::COLORREF_TO_D2DCOLOR

Convertit les valeurs de couleur et d’alpha GDI en objet D2D1_COLOR_F.

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

Paramètres

color
Valeur RVB.

nAlpha

Valeur de retour

valeur D2D1_COLOR_F.

CRenderTarget ::CreateCompatibleRenderTarget

Crée une cible de rendu bitmap à utiliser pendant le dessin hors écran intermédiaire compatible avec la cible de rendu actuelle.

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);

Paramètres

bitmapTarget
Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers une nouvelle cible de rendu bitmap. Ce paramètre est passé non initialisé.

sizeDesired
Taille souhaitée de la nouvelle cible de rendu en pixels indépendants de l’appareil si elle doit être différente de la cible de rendu d’origine, ou NULL. Pour plus d'informations, consultez la section Notes.

sizePixelDesired
Taille souhaitée de la nouvelle cible de rendu en pixels si elle doit être différente de la cible de rendu d’origine, ou NULL. Pour plus d'informations, consultez la section Notes.

desiredFormat
Format de pixel et mode alpha souhaités de la nouvelle cible de rendu ou NULL. Si le format de pixel est défini sur DXGI_FORMAT_UNKNOWN ou si ce paramètre a la valeur Null, la nouvelle cible de rendu utilise le même format de pixel que la cible de rendu d’origine. Si le mode alpha est D2D1_ALPHA_MODE_UNKNOWN ou si ce paramètre a la valeur NULL, le mode alpha de la nouvelle cible de rendu est défini par défaut sur D2D1_ALPHA_MODE_PREMULTIPLIED. Pour plus d’informations sur les formats de pixels pris en charge, consultez Formats de pixel pris en charge et Modes Alpha.

options
Valeur qui spécifie si la nouvelle cible de rendu doit être compatible avec GDI.

Valeur de retour

Si la méthode réussit, elle retourne TRUE. Sinon, elle retourne FALSE.

CRenderTarget ::CRenderTarget

Construit un objet CRenderTarget.

CRenderTarget();

CRenderTarget ::D estroy

Supprime une ou plusieurs ressources

BOOL Destroy(BOOL bDeleteResources = TRUE);

Paramètres

bDeleteResources
Si bDeleteResources a la valeur TRUE, toutes les ressources situées dans m_lstResources sont automatiquement détruites.

Valeur de retour

Si la méthode réussit, elle retourne TRUE. Sinon, elle retourne FALSE

CRenderTarget ::D etach

Détache l’interface cible du rendu de l’objet

ID2D1RenderTarget* Detach ();

Valeur de retour

Pointeur vers l’interface cible de rendu détachée.

CRenderTarget ::D rawBitmap

Dessine le texte mis en forme décrit par l’objet IDWriteTextLayout spécifié.

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);

Paramètres

pBitmap
Bitmap à afficher.

rectDest
Taille et position, en pixels indépendants de l’appareil dans l’espace de coordonnées de la cible de rendu, de la zone à laquelle la bitmap est dessinée. Si le rectangle n’est pas bien ordonné, rien n’est dessiné, mais la cible de rendu n’entre pas dans un état d’erreur.

fOpacity
Valeur comprise entre 0.0f et 1.0f, inclusive, qui spécifie une valeur d’opacité à appliquer à la bitmap ; cette valeur est multipliée par rapport aux valeurs alpha du contenu de la bitmap.

interpolationMode
Mode d’interpolation à utiliser si la bitmap est mise à l’échelle ou pivotée par l’opération de dessin.

pRectSrc
Taille et position, en pixels indépendants de l’appareil dans l’espace de coordonnées de la bitmap, de la zone dans la bitmap à dessiner.

CRenderTarget ::D rawEllipse

Dessine le contour de l’ellipse spécifié à l’aide du style de trait spécifié.

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

Paramètres

ellipse
Position et rayon de l’ellipse à dessiner, en pixels indépendants de l’appareil.

pBrush
Pinceau utilisé pour peindre le contour de l’ellipse.

fStrokeWidth
Épaisseur du trait de l’ellipse. Le trait est centré sur le contour de l’ellipse.

strokeStyle
Style de trait à appliquer au contour de l’ellipse, ou NULL pour peindre un trait unie.

CRenderTarget ::D rawGeometry

Dessine le contour de la géométrie spécifiée à l’aide du style de trait spécifié.

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

Paramètres

pGeometry
Géométrie à dessiner.

pBrush
Pinceau utilisé pour peindre le trait de géométrie.

fStrokeWidth
Épaisseur du trait de la géométrie. Le trait est centré sur le contour de la géométrie.

strokeStyle
Style de trait à appliquer au contour de la géométrie, ou NULL pour peindre un trait unie.

CRenderTarget ::D rawGlyphRun

Dessine les glyphes spécifiés.

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

Paramètres

ptBaseLineOrigin
Origine, en pixels indépendants de l’appareil, de la ligne de base des glyphes.

glypheRun
Glyphes à restituer.

pForegroundBrush
Pinceau utilisé pour peindre les glyphes spécifiés.

measuringMode
Valeur qui indique comment les métriques de glyphe sont utilisées pour mesurer le texte lorsqu’elles sont mises en forme. La valeur par défaut est DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget ::D rawLine

Dessine une ligne entre les points spécifiés à l’aide du style de trait spécifié.

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

Paramètres

ptFrom
Point de départ de la ligne, en pixels indépendants de l’appareil.

ptTo
Point de terminaison de la ligne, en pixels indépendants de l’appareil.

pBrush
Pinceau utilisé pour peindre le trait de la ligne.

fStrokeWidth
Valeur supérieure ou égale à 0,0f qui spécifie la largeur du trait. Si ce paramètre n’est pas spécifié, il est défini par défaut sur 1.0f. Le trait est centré sur la ligne.

strokeStyle
Style de trait à peindre ou NULL pour peindre une ligne unie.

CRenderTarget ::D rawRectangle

Dessine le contour d’un rectangle qui a les dimensions et le style de trait spécifiés.

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

Paramètres

rectangle
Dimensions du rectangle à dessiner, en pixels indépendants de l’appareil

pBrush
Pinceau utilisé pour peindre le trait du rectangle

fStrokeWidth
Valeur supérieure ou égale à 0,0f qui spécifie la largeur du trait du rectangle. Le trait est centré sur le contour du rectangle.

strokeStyle
Style de trait à peindre ou NULL pour peindre un trait unie.

CRenderTarget ::D rawRoundedRectangle

Dessine le contour du rectangle arrondi spécifié à l’aide du style de trait spécifié.

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

Paramètres

rectRounded
Dimensions du rectangle arrondi à dessiner, en pixels indépendants de l’appareil.

pBrush
Pinceau utilisé pour peindre le contour du rectangle arrondi.

fStrokeWidth
Largeur du trait du rectangle arrondi. Le trait est centré sur le contour du rectangle arrondi. La valeur par défaut est 1.0f.

strokeStyle
Style du trait du rectangle arrondi, ou NULL pour peindre un trait unie. La valeur par défaut est NULL.

CRenderTarget ::D rawText

Dessine le texte spécifié à l’aide des informations de format fournies par un objet IDWriteTextFormat.

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);

Paramètres

strText
Pointeur vers un tableau de caractères Unicode à dessiner.

rectangle
Taille et position de la zone dans laquelle le texte est dessiné.

pForegroundBrush
Pinceau utilisé pour peindre le texte.

textFormat
Objet qui décrit les détails de mise en forme du texte à dessiner, comme la police, la taille de police et la direction du flux.

options
Valeur qui indique si le texte doit être aligné sur des limites de pixels et si le texte doit être clippé dans le rectangle de disposition. La valeur par défaut est D2D1_DRAW_TEXT_OPTIONS_NONE, ce qui indique que le texte doit être aligné sur des limites de pixels et qu’il ne doit pas être clippé dans le rectangle de disposition.

measuringMode
Valeur qui indique comment les métriques de glyphe sont utilisées pour mesurer le texte lorsqu’elles sont mises en forme. La valeur par défaut est DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget ::D rawTextLayout

Dessine le texte mis en forme décrit par l’objet IDWriteTextLayout spécifié.

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

Paramètres

ptOrigin
Point, décrit en pixels indépendants de l’appareil, auquel le coin supérieur gauche du texte décrit par textLayout est dessiné.

textLayout
Texte mis en forme à dessiner. Tous les effets de dessin qui n’héritent pas d’ID2D1Resource sont ignorés. S’il existe des effets de dessin qui héritent d’ID2D1Resource qui ne sont pas des pinceaux, cette méthode échoue et la cible de rendu est placée dans un état d’erreur.

pBrushForeground
Pinceau utilisé pour peindre un texte dans textLayout qui n’a pas encore de pinceau associé à celui-ci en tant qu’effet de dessin (spécifié par la méthode IDWriteTextLayout ::SetDrawingEffect).

CRenderTarget ::EndDraw

Termine les opérations de dessin sur la cible de rendu et indique l’état d’erreur actuel et les balises associées.

HRESULT EndDraw();

Valeur de retour

Si la méthode réussit, retourne S_OK. Sinon, elle renvoie un code d’erreur HRESULT.

CRenderTarget ::FillEllipse

Peint l’intérieur de l’ellipse spécifié.

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

Paramètres

ellipse
Position et rayon, en pixels indépendants de l’appareil, de l’ellipse à peindre.

pBrush
Pinceau utilisé pour peindre l’intérieur de l’ellipse.

CRenderTarget ::FillGeometry

Peint l’intérieur de la géométrie spécifiée.

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

Paramètres

pGeometry
Géométrie à peindre.

pBrush
Pinceau utilisé pour peindre l’intérieur de la géométrie.

pOpacityBrush
Masque d’opacité à appliquer à la géométrie ; NULL pour aucun masque d’opacité. Si un masque d’opacité (paramètre opacityBrush) est spécifié, le pinceau doit être un id2D1BitmapBrush dont les modes x et y sont définis sur D2D1_EXTEND_MODE_CLAMP. Pour plus d'informations, consultez la section Notes.

CRenderTarget ::FillMesh

Peint l’intérieur du maillage spécifié.

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

Paramètres

pMesh
Maillage à peindre.

pBrush
Pinceau utilisé pour peindre le maillage.

CRenderTarget ::FillOpacityMask

Applique le masque d’opacité décrit par la bitmap spécifiée à un pinceau et utilise ce pinceau pour peindre une région de la cible de rendu.

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

Paramètres

pOpacityMask
Position et rayon, en pixels indépendants de l’appareil, de l’ellipse à peindre.

pBrush
Pinceau utilisé pour peindre la région de la cible de rendu spécifiée par destinationRectangle.

content
Type de contenu que contient le masque d’opacité. La valeur est utilisée pour déterminer l’espace de couleur dans lequel le masque d’opacité est mélangé.

rectDest
Région de la cible de rendu à peindre, en pixels indépendants de l’appareil.

rectSrc
Région de la bitmap à utiliser comme masque d’opacité, en pixels indépendants de l’appareil.

CRenderTarget ::FillRectangle

Peint l’intérieur du rectangle spécifié.

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

Paramètres

rectangle
Dimension du rectangle à peindre, en pixels indépendants de l’appareil.

pBrush
Pinceau utilisé pour peindre l’intérieur du rectangle.

CRenderTarget ::FillRoundedRectangle

Peint l’intérieur du rectangle arrondi spécifié.

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

Paramètres

rectRounded
Dimensions du rectangle arrondi à peindre, en pixels indépendants de l’appareil.

pBrush
Pinceau utilisé pour peindre l’intérieur du rectangle arrondi.

CRenderTarget ::Flush

Exécute toutes les commandes de dessin en attente.

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

Paramètres

tag1
Contient la balise pour les opérations de dessin qui ont provoqué des erreurs ou 0 s’il n’y avait aucune erreur. Ce paramètre est passé non initialisé.

tag2
Contient la balise pour les opérations de dessin qui ont provoqué des erreurs ou 0 s’il n’y avait aucune erreur. Ce paramètre est passé non initialisé.

CRenderTarget ::GetAntialiasMode

Récupère le mode antialiasing actuel pour les opérations de dessin non texte.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Valeur de retour

Mode anticrénelage actuel pour les opérations de dessin non texte.

CRenderTarget ::GetDpi

Retourne les points de la cible de rendu par pouce (PPP)

CD2DSizeF GetDpi() const;

Valeur de retour

Points par pouce (PPP) de la cible de rendu.

CRenderTarget ::GetMaximumBitmapSize

Obtient la taille maximale, en unités dépendantes de l’appareil (pixels), d’une dimension bitmap prise en charge par la cible de rendu

UINT32 GetMaximumBitmapSize() const;

Valeur de retour

Taille maximale, en pixels, d’une dimension bitmap prise en charge par la cible de rendu

CRenderTarget ::GetPixelFormat

Récupère le format de pixel et le mode alpha de la cible de rendu

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Valeur de retour

Format de pixel et mode alpha de la cible de rendu

CRenderTarget ::GetPixelSize

Retourne la taille de la cible de rendu en pixels d’appareil

CD2DSizeU GetPixelSize() const;

Valeur de retour

Taille de la cible de rendu en pixels d’appareil

CRenderTarget ::GetRenderTarget

Retourne l’interface ID2D1RenderTarget

ID2D1RenderTarget* GetRenderTarget();

Valeur de retour

Pointeur vers une interface ID2D1RenderTarget ou NULL si l’objet n’est pas encore initialisé.

CRenderTarget ::GetSize

Retourne la taille de la cible de rendu en pixels indépendants de l’appareil

CD2DSizeF GetSize() const;

Valeur de retour

Taille actuelle de la cible de rendu en pixels indépendants de l’appareil

CRenderTarget ::GetTags

Obtient l’étiquette pour les opérations de dessin suivantes.

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

Paramètres

tag1
Contient la première étiquette pour les opérations de dessin suivantes. Ce paramètre est passé non initialisé. Si la valeur NULL est spécifiée, aucune valeur n’est récupérée pour ce paramètre.

tag2
Contient la deuxième étiquette pour les opérations de dessin suivantes. Ce paramètre est passé non initialisé. Si la valeur NULL est spécifiée, aucune valeur n’est récupérée pour ce paramètre.

CRenderTarget ::GetTextAntialiasMode

Obtient le mode d’anticrénelage actuel pour les opérations de dessin de texte et de glyphe.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Valeur de retour

Mode anticrénelage actuel pour les opérations de dessin de texte et de glyphe.

CRenderTarget ::GetTextRenderingParams

Récupère les options de rendu de texte actuelles de la cible de rendu.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Paramètres

textRenderingParams
Lorsque cette méthode est retournée, textRenderingParamscontains l’adresse d’un pointeur vers les options de rendu de texte actuelles de la cible de rendu.

CRenderTarget ::GetTransform

Obtient la transformation actuelle de la cible de rendu.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Paramètres

transform
Lorsque cela est retourné, contient la transformation actuelle de la cible de rendu. Ce paramètre est passé non initialisé.

CRenderTarget ::IsSupported

Indique si la cible de rendu prend en charge les propriétés spécifiées

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Paramètres

renderTargetProperties
Propriétés de la cible de rendu à tester

Valeur de retour

TRUE si les propriétés de la cible de rendu spécifiées sont prises en charge par cette cible de rendu ; sinon, FALSE

CRenderTarget ::IsValid

Vérifie la validité des ressources

BOOL IsValid() const;

Valeur de retour

TRUE si la ressource est valide ; sinon FALSE.

CRenderTarget ::m_lstResources

Liste de pointeurs vers des objets CD2DResource.

CObList m_lstResources;

CRenderTarget ::m_pRenderTarget

Pointeur vers un objet ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget ::m_pTextFormatDefault

Pointeur vers un objet CD2DTextFormat qui contient un format de texte par défaut.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget ::operator ID2D1RenderTarget*

Retourne l’interface ID2D1RenderTarget

operator ID2D1RenderTarget*();

Valeur de retour

Pointeur vers une interface ID2D1RenderTarget ou NULL si l’objet n’est pas encore initialisé.

CRenderTarget ::P opAxisAlignedClip

Supprime le dernier clip aligné sur l’axe de la cible de rendu. Une fois cette méthode appelée, le clip n’est plus appliqué aux opérations de dessin suivantes.

void PopAxisAlignedClip();

CRenderTarget ::P opLayer

Arrête la redirection des opérations de dessin vers la couche spécifiée par le dernier appel PushLayer.

void PopLayer();

CRenderTarget ::P ushAxisAlignedClip

Supprime le dernier clip aligné sur l’axe de la cible de rendu. Une fois cette méthode appelée, le clip n’est plus appliqué aux opérations de dessin suivantes.

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

Paramètres

rectClip
Taille et position de la zone de découpage, en pixels indépendants de l’appareil.

mode
Mode anticrénelage utilisé pour dessiner les bords des rectangles clip qui ont des limites de sous-pixel et pour fusionner le clip avec le contenu de la scène. La fusion est effectuée une fois lorsque la méthode PopAxisAlignedClip est appelée et ne s’applique pas à chaque primitive au sein de la couche.

CRenderTarget ::P ushLayer

Ajoute la couche spécifiée à la cible de rendu afin qu’elle reçoive toutes les opérations de dessin suivantes jusqu’à ce que PopLayer soit appelé.

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

Paramètres

layerParameters
Limites de contenu, masque géométrique, opacité, masque d’opacité et options d’anticrénelage pour la couche.

couche
Couche qui reçoit les opérations de dessin suivantes.

CRenderTarget ::RestoreDrawingState

Définit l’état de dessin de la cible de rendu sur celui de l’ID2D1DrawingStateBlock spécifié.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Paramètres

drawingStateBlock
Nouvel état de dessin de la cible de rendu.

CRenderTarget ::SaveDrawingState

Enregistre l’état de dessin actuel dans l’ID2D1DrawingStateBlock spécifié.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Paramètres

drawingStateBlock
Lorsque cette méthode est retournée, contient l’état de dessin actuel de la cible de rendu. Ce paramètre doit être initialisé avant de le transmettre à la méthode.

CRenderTarget ::SetAntialiasMode

Définit le mode anticrénelage de la cible de rendu. Le mode anticrénelage s’applique à toutes les opérations de dessin suivantes, à l’exclusion des opérations de dessin de texte et de glyphe.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Paramètres

antialiasMode
Mode anticrénelage pour les opérations de dessin futures.

CRenderTarget ::SetDpi

Définit les points par pouce (PPP) de la cible de rendu.

void SetDpi(const CD2DSizeF& sizeDPI);

Paramètres

sizeDPI
Valeur supérieure ou égale à zéro qui spécifie l’indicateur horizontal/verticalDPI de la cible de rendu.

CRenderTarget ::SetTags

Spécifie une étiquette pour les opérations de dessin suivantes.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Paramètres

tag1
Étiquette à appliquer aux opérations de dessin suivantes.

tag2
Étiquette à appliquer aux opérations de dessin suivantes.

CRenderTarget ::SetTextAntialiasMode

Spécifie le mode anticrénelage à utiliser pour les opérations de dessin de texte et de glyphe suivantes.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Paramètres

textAntialiasMode
Mode anticrénelage à utiliser pour les opérations de dessin de texte et de glyphe suivantes.

CRenderTarget ::SetTextRenderingParams

Spécifie les options de rendu de texte à appliquer à toutes les opérations de dessin de texte et de glyphe suivantes.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Paramètres

textRenderingParams
Options de rendu de texte à appliquer à toutes les opérations de dessin de texte et de glyphe suivantes ; NULL pour effacer les options de rendu de texte actuelles.

CRenderTarget ::SetTransform

Applique la transformation spécifiée à la cible de rendu, en remplaçant la transformation existante. Toutes les opérations de dessin suivantes se produisent dans l’espace transformé.

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

Paramètres

transform
Transformation à appliquer à la cible de rendu.

CRenderTarget ::VerifyResource

Vérifie la validité de l’objet CD2DResource ; crée l’objet s’il n’existe pas déjà.

BOOL VerifyResource(CD2DResource* pResource);

Paramètres

pResource
Pointeur vers l’objet CD2DResource.

Valeur de retour

TRUE est un objet s’il est valide ; sinon FALSE.

Voir aussi

Classes

Partager via

CRenderTarget, classe

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Méthodes protégées

Opérateurs publics

Membres de données protégés

Hiérarchie d'héritage

Spécifications

CRenderTarget ::~CRenderTarget

CRenderTarget ::Attach

Paramètres

CRenderTarget ::BeginDraw

CRenderTarget ::Clear

Paramètres

CRenderTarget ::COLORREF_TO_D2DCOLOR

Paramètres

Valeur de retour

CRenderTarget ::CreateCompatibleRenderTarget

Paramètres

Valeur de retour

CRenderTarget ::CRenderTarget

CRenderTarget ::D estroy

Paramètres

Valeur de retour

CRenderTarget ::D etach

Valeur de retour

CRenderTarget ::D rawBitmap

Paramètres

CRenderTarget ::D rawEllipse

Paramètres

CRenderTarget ::D rawGeometry

Paramètres

CRenderTarget ::D rawGlyphRun

Paramètres

CRenderTarget ::D rawLine

Paramètres

CRenderTarget ::D rawRectangle

Paramètres

CRenderTarget ::D rawRoundedRectangle

Paramètres

CRenderTarget ::D rawText

Paramètres

CRenderTarget ::D rawTextLayout

Paramètres

CRenderTarget ::EndDraw

Valeur de retour

CRenderTarget ::FillEllipse

Paramètres

CRenderTarget ::FillGeometry

Paramètres

CRenderTarget ::FillMesh

Paramètres

CRenderTarget ::FillOpacityMask

Paramètres

CRenderTarget ::FillRectangle

Paramètres

CRenderTarget ::FillRoundedRectangle

Paramètres

CRenderTarget ::Flush

Paramètres

CRenderTarget ::GetAntialiasMode

Valeur de retour

CRenderTarget ::GetDpi

Valeur de retour

CRenderTarget ::GetMaximumBitmapSize

Valeur de retour

CRenderTarget ::GetPixelFormat

Valeur de retour

CRenderTarget ::GetPixelSize

Valeur de retour

CRenderTarget ::GetRenderTarget

Valeur de retour

CRenderTarget ::GetSize

Valeur de retour

CRenderTarget ::GetTags

Paramètres

CRenderTarget ::GetTextAntialiasMode