Classe CRenderTarget

Articolo
10/12/2023

Wrapper per ID2D1RenderTarget.

Sintassi

class CRenderTarget : public CObject;

Membri

Costruttori pubblici

Nome	Descrizione
CRenderTarget::CRenderTarget	Costruisce un oggetto CRenderTarget.
CRenderTarget::~CRenderTarget	Distruttore. Chiamato quando un oggetto di destinazione di rendering viene eliminato definitivamente.

Metodi pubblici

Nome	Descrizione
CRenderTarget::Attach	Collega l'interfaccia di destinazione di rendering esistente all'oggetto
CRenderTarget::BeginDraw	Avvia il disegno su questa destinazione di rendering.
CRenderTarget::Clear	Cancella l'area di disegno sul colore specificato.
CRenderTarget::COLORREF_TO_D2DCOLOR	Converte i valori di colore e alfa GDI nell'oggetto D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget	Crea una nuova destinazione di rendering bitmap da usare durante il disegno intermedio fuori schermo compatibile con la destinazione di rendering corrente.
CRenderTarget::D estroy	Elimina una o più risorse
CRenderTarget::D etach	Scollega l'interfaccia di destinazione di rendering dall'oggetto
CRenderTarget::D rawBitmap	Disegna il testo formattato descritto dall'oggetto IDWriteTextLayout specificato.
CRenderTarget::D rawEllipse	Disegna il contorno dell'ellisse specificata utilizzando lo stile del tratto specificato.
CRenderTarget::D rawGeometry	Disegna il contorno della geometria specificata utilizzando lo stile del tratto specificato.
CRenderTarget::D rawGlyphRun	Disegna i glifi specificati.
CRenderTarget::D rawLine	Disegna una linea tra i punti specificati utilizzando lo stile del tratto specificato.
CRenderTarget::D rawRectangle	Disegna il contorno di un rettangolo con le dimensioni e lo stile del tratto specificati.
CRenderTarget::D rawRoundedRectangle	Disegna il contorno del rettangolo arrotondato specificato utilizzando lo stile del tratto specificato.
CRenderTarget::D rawText	Disegna il testo specificato utilizzando le informazioni sul formato fornite da un oggetto IDWriteTextFormat.
CRenderTarget::D rawTextLayout	Disegna il testo formattato descritto dall'oggetto IDWriteTextLayout specificato.
CRenderTarget::EndDraw	Termina le operazioni di disegno sulla destinazione di rendering e indica lo stato di errore corrente e i tag associati.
CRenderTarget::FillEllipse	Disegna l'interno dell'ellisse specificata.
CRenderTarget::FillGeometry	Disegna l'interno della geometria specificata.
CRenderTarget::FillMesh	Disegna l'interno della mesh specificata.
CRenderTarget::FillOpacityMask	Applica la maschera di opacità descritta dalla bitmap specificata a un pennello e usa tale pennello per disegnare un'area della destinazione di rendering.
CRenderTarget::FillRectangle	Disegna l'interno del rettangolo specificato.
CRenderTarget::FillRoundedRectangle	Disegna l'interno del rettangolo arrotondato specificato.
CRenderTarget::Flush	Esegue tutti i comandi di disegno in sospeso.
CRenderTarget::GetAntialiasMode	Recupera la modalità di anti-aliasing corrente per le operazioni di disegno non di testo.
CRenderTarget::GetDpi	Restituisce i punti della destinazione di rendering per pollice (DPI)
CRenderTarget::GetMaximumBitmapSize	Ottiene le dimensioni massime, in unità dipendenti dal dispositivo (pixel) di una dimensione bitmap supportata dalla destinazione di rendering
CRenderTarget::GetPixelFormat	Recupera il formato pixel e la modalità alfa della destinazione di rendering
CRenderTarget::GetPixelSize	Restituisce le dimensioni della destinazione di rendering in pixel del dispositivo
CRenderTarget::GetRenderTarget	Restituisce l'interfaccia ID2D1RenderTarget
CRenderTarget::GetSize	Restituisce le dimensioni della destinazione di rendering in pixel indipendenti dal dispositivo
CRenderTarget::GetTags	Ottiene l'etichetta per le successive operazioni di disegno.
CRenderTarget::GetTextAntialiasMode	Ottiene la modalità di antialiasing corrente per le operazioni di disegno di testo e glifo.
CRenderTarget::GetTextRenderingParams	Recupera le opzioni di rendering del testo correnti della destinazione di rendering.
CRenderTarget::GetTransform	Applica la trasformazione specificata alla destinazione di rendering, sostituendo la trasformazione esistente. Tutte le operazioni di disegno successive si verificano nello spazio trasformato.
CRenderTarget::IsSupported	Indica se la destinazione di rendering supporta le proprietà specificate
CRenderTarget::IsValid	Verifica la validità delle risorse
CRenderTarget::P opAxisAlignedClip	Rimuove l'ultima clip allineata all'asse dalla destinazione di rendering. Dopo aver chiamato questo metodo, la clip non viene più applicata alle successive operazioni di disegno.
CRenderTarget::P opLayer	Arresta il reindirizzamento delle operazioni di disegno al livello specificato dall'ultima chiamata PushLayer.
CRenderTarget::P ushAxisAlignedClip	Rimuove l'ultima clip allineata all'asse dalla destinazione di rendering. Dopo aver chiamato questo metodo, la clip non viene più applicata alle successive operazioni di disegno.
CRenderTarget::P ushLayer	Aggiunge il livello specificato alla destinazione di rendering in modo che riceva tutte le operazioni di disegno successive fino a quando non viene chiamato PopLayer.
CRenderTarget::RestoreDrawingState	Imposta lo stato del disegno della destinazione di rendering su quello dell'ID2D1DrawingStateBlock specificato.
CRenderTarget::SaveDrawingState	Salva lo stato corrente del disegno nell'ID2D1DrawingStateBlock specificato.
CRenderTarget::SetAntialiasMode	Imposta la modalità di antialiasing della destinazione di rendering. La modalità antialiasing si applica a tutte le operazioni di disegno successive, escluse le operazioni di disegno di testo e glifo.
CRenderTarget::SetDpi	Imposta i punti per pollice (DPI) della destinazione di rendering.
CRenderTarget::SetTags	Specifica un'etichetta per le operazioni di disegno successive.
CRenderTarget::SetTextAntialiasMode	Specifica la modalità di anti-aliasing da utilizzare per le successive operazioni di disegno di testo e glifo.
CRenderTarget::SetTextRenderingParams	Specifica le opzioni di rendering del testo da applicare a tutte le successive operazioni di disegno di testo e glifo.
CRenderTarget::SetTransform	Con overload. Applica la trasformazione specificata alla destinazione di rendering, sostituendo la trasformazione esistente. Tutte le operazioni di disegno successive si verificano nello spazio trasformato.

Metodi protetti

Nome	Descrizione
CRenderTarget::VerifyResource	Verifica la validità dell'oggetto CD2DResource; crea l'oggetto se non esiste già.

Operatori pubblici

Nome	Descrizione
CRenderTarget::operator ID2D1RenderTarget*	Restituisce l'interfaccia ID2D1RenderTarget

Membri dati protetti

Nome	Descrizione
CRenderTarget::m_lstResources	Elenco di puntatori agli oggetti CD2DResource.
CRenderTarget::m_pRenderTarget	Puntatore a un oggetto ID2D1RenderTarget.
CRenderTarget::m_pTextFormatDefault	Puntatore all'oggetto CD2DTextFormat che contiene un formato di testo predefinito.

Gerarchia di ereditarietà

CObject

CRenderTarget

Requisiti

Intestazione: afxrendertarget.h

CRenderTarget::~CRenderTarget

Distruttore. Chiamato quando un oggetto di destinazione di rendering viene eliminato definitivamente.

virtual ~CRenderTarget();

CRenderTarget::Attach

Collega l'interfaccia di destinazione di rendering esistente all'oggetto

void Attach(ID2D1RenderTarget* pRenderTarget);

Parametri

pRenderTarget
Interfaccia di destinazione di rendering esistente. Non può essere NULL

CRenderTarget::BeginDraw

Avvia il disegno su questa destinazione di rendering.

void BeginDraw();

CRenderTarget::Clear

Cancella l'area di disegno sul colore specificato.

void Clear(D2D1_COLOR_F color);

Parametri

color
Colore a cui viene cancellata l'area di disegno.

CRenderTarget::COLORREF_TO_D2DCOLOR

Converte i valori di colore e alfa GDI nell'oggetto D2D1_COLOR_F.

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

Parametri

color
Valore RGB.

nAlpha

Valore restituito

D2D1_COLOR_F valore.

CRenderTarget::CreateCompatibleRenderTarget

Crea una nuova destinazione di rendering bitmap da usare durante il disegno intermedio fuori schermo compatibile con la destinazione di rendering corrente.

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

Parametri

bitmapTarget
Quando termina, questo metodo contiene l'indirizzo di un puntatore a una nuova destinazione di rendering bitmap. Questo parametro viene passato non inizializzato.

sizeDesired
Le dimensioni desiderate della nuova destinazione di rendering in pixel indipendenti dal dispositivo se devono essere diverse dalla destinazione di rendering originale o NULL. Per altre informazioni, vedere la sezione Osservazioni.

sizePixelDesired
Dimensioni desiderate della nuova destinazione di rendering in pixel se devono essere diverse dalla destinazione di rendering originale o NULL. Per altre informazioni, vedere la sezione Osservazioni.

desiredFormat
Formato pixel desiderato e modalità alfa della nuova destinazione di rendering o NULL. Se il formato pixel è impostato su DXGI_FORMAT_UNKNOWN o se questo parametro è Null, la nuova destinazione di rendering usa lo stesso formato pixel della destinazione di rendering originale. Se la modalità alfa è D2D1_ALPHA_MODE_UNKNOWN o questo parametro è NULL, la modalità alfa della nuova destinazione di rendering viene D2D1_ALPHA_MODE_PREMULTIPLIED. Per informazioni sui formati pixel supportati, vedere Formati pixel supportati e modalità alfa.

options
Valore che specifica se la nuova destinazione di rendering deve essere compatibile con GDI.

Valore restituito

Se il metodo ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE.

CRenderTarget::CRenderTarget

Costruisce un oggetto CRenderTarget.

CRenderTarget();

CRenderTarget::D estroy

Elimina una o più risorse

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parametri

bDeleteResources
Se bDeleteResources è TRUE, tutte le risorse che si trovano in m_lstResources verranno eliminate automaticamente.

Valore restituito

Se il metodo ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE

CRenderTarget::D etach

Scollega l'interfaccia di destinazione di rendering dall'oggetto

ID2D1RenderTarget* Detach ();

Valore restituito

Puntatore all'interfaccia di destinazione di rendering scollegata.

CRenderTarget::D rawBitmap

Disegna il testo formattato descritto dall'oggetto IDWriteTextLayout specificato.

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

Parametri

pBitmap
Bitmap di cui eseguire il rendering.

rectDest
Dimensioni e posizione, in pixel indipendenti dal dispositivo nello spazio delle coordinate della destinazione di rendering, dell'area in cui viene disegnata la bitmap. Se il rettangolo non è ordinato correttamente, non viene disegnato alcun elemento, ma la destinazione di rendering non immette uno stato di errore.

fOpacity
Valore compreso tra 0,0f e 1,0f, inclusivo, che specifica un valore di opacità da applicare alla bitmap; questo valore viene moltiplicato rispetto ai valori alfa del contenuto della bitmap.

interpolationMode
Modalità di interpolazione da utilizzare se la bitmap viene ridimensionata o ruotata dall'operazione di disegno.

pRectSrc
Dimensioni e posizione, in pixel indipendenti dal dispositivo nello spazio delle coordinate della bitmap, dell'area all'interno della bitmap da disegnare.

CRenderTarget::D rawEllipse

Disegna il contorno dell'ellisse specificata utilizzando lo stile del tratto specificato.

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

Parametri

ellisse
Posizione e raggio dell'ellisse da disegnare, in pixel indipendenti dal dispositivo.

pBrush
Pennello utilizzato per disegnare il contorno dell'ellisse.

fStrokeWidth
Spessore del tratto dell'ellisse. Il tratto è centrato sul contorno dell'ellisse.

strokeStyle
Stile del tratto da applicare al contorno dell'ellisse o NULL per disegnare un tratto a tinta unita.

CRenderTarget::D rawGeometry

Disegna il contorno della geometria specificata utilizzando lo stile del tratto specificato.

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

Parametri

pGeometry
Geometria da disegnare.

pBrush
Pennello utilizzato per disegnare il tratto della geometria.

fStrokeWidth
Spessore del tratto della geometria. Il tratto è centrato sul contorno della geometria.

strokeStyle
Stile del tratto da applicare al contorno della geometria o NULL per disegnare un tratto a tinta unita.

CRenderTarget::D rawGlyphRun

Disegna i glifi specificati.

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

Parametri

ptBaseLineOrigin
Origine, in pixel indipendenti dal dispositivo, della linea di base dei glifi.

glyphRun
Glifi di cui eseguire il rendering.

pForegroundBrush
Pennello utilizzato per disegnare i glifi specificati.

measuringMode
Valore che indica come vengono usate le metriche del glifo per misurare il testo quando viene formattato. Il valore predefinito è DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Disegna una linea tra i punti specificati utilizzando lo stile del tratto specificato.

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

Parametri

ptFrom
Punto iniziale della linea, in pixel indipendenti dal dispositivo.

ptTo
Punto finale della linea, in pixel indipendenti dal dispositivo.

pBrush
Pennello utilizzato per disegnare il tratto della linea.

fStrokeWidth
Valore maggiore o uguale a 0,0f che specifica la larghezza del tratto. Se questo parametro non è specificato, per impostazione predefinita è 1.0f. Il tratto è centrato sulla linea.

strokeStyle
Stile del tratto da disegnare o NULL per disegnare una linea continua.

CRenderTarget::D rawRectangle

Disegna il contorno di un rettangolo con le dimensioni e lo stile del tratto specificati.

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

Parametri

rettangolo
Dimensioni del rettangolo da disegnare, in pixel indipendenti dal dispositivo

pBrush
Pennello utilizzato per disegnare il tratto del rettangolo

fStrokeWidth
Valore maggiore o uguale a 0,0f che specifica la larghezza del tratto del rettangolo. Il tratto è centrato sul contorno del rettangolo.

strokeStyle
Stile del tratto da disegnare o NULL per disegnare un tratto a tinta unita.

CRenderTarget::D rawRoundedRectangle

Disegna il contorno del rettangolo arrotondato specificato utilizzando lo stile del tratto specificato.

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

Parametri

rectRounded
Dimensioni del rettangolo arrotondato da disegnare, in pixel indipendenti dal dispositivo.

pBrush
Pennello utilizzato per disegnare il contorno del rettangolo arrotondato.

fStrokeWidth
Larghezza del tratto del rettangolo arrotondato. Il tratto è centrato sul contorno del rettangolo arrotondato. Il valore predefinito è 1,0f.

strokeStyle
Stile del tratto del rettangolo arrotondato o NULL per disegnare un tratto solido. Il valore predefinito è NULL.

CRenderTarget::D rawText

Disegna il testo specificato utilizzando le informazioni sul formato fornite da un oggetto 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);

Parametri

strText
Puntatore a una matrice di caratteri Unicode da disegnare.

rettangolo
Dimensioni e posizione dell'area in cui viene disegnato il testo.

pForegroundBrush
Pennello utilizzato per disegnare il testo.

textFormat
Oggetto che descrive i dettagli di formattazione del testo da disegnare, ad esempio il tipo di carattere, le dimensioni del carattere e la direzione del flusso.

options
Valore che indica se il testo deve essere ritagliato ai limiti dei pixel e se il testo deve essere ritagliato nel rettangolo di layout. Il valore predefinito è D2D1_DRAW_TEXT_OPTIONS_NONE, che indica che il testo deve essere ritagliato ai limiti dei pixel e non deve essere ritagliato nel rettangolo di layout.

measuringMode
Valore che indica come vengono usate le metriche del glifo per misurare il testo quando viene formattato. Il valore predefinito è DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawTextLayout

Disegna il testo formattato descritto dall'oggetto IDWriteTextLayout specificato.

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

Parametri

ptOrigin
Punto, descritto in pixel indipendenti dal dispositivo, in cui viene disegnato l'angolo superiore sinistro del testo descritto da textLayout.

textLayout
Testo formattato da disegnare. Tutti gli effetti di disegno che non ereditano da ID2D1Resource vengono ignorati. Se sono presenti effetti di disegno che ereditano da ID2D1Resource che non sono pennelli, questo metodo ha esito negativo e la destinazione di rendering viene inserita in uno stato di errore.

pBrushForeground
Pennello utilizzato per disegnare qualsiasi testo in textLayout a cui non è già associato un pennello come effetto di disegno (specificato dal metodo IDWriteTextLayout::SetDrawingEffect).

CRenderTarget::EndDraw

Termina le operazioni di disegno sulla destinazione di rendering e indica lo stato di errore corrente e i tag associati.

HRESULT EndDraw();

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. In caso contrario, restituisce un codice di errore HRESULT.

CRenderTarget::FillEllipse

Disegna l'interno dell'ellisse specificata.

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

Parametri

ellisse
Posizione e raggio, in pixel indipendenti dal dispositivo, dell'ellisse da disegnare.

pBrush
Pennello utilizzato per disegnare l'interno dell'ellisse.

CRenderTarget::FillGeometry

Disegna l'interno della geometria specificata.

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

Parametri

pGeometry
Geometria da disegnare.

pBrush
Pennello utilizzato per disegnare l'interno della geometria.

pOpacityBrush
Maschera di opacità da applicare alla geometria; NULL per nessuna maschera di opacità. Se viene specificata una maschera di opacità (parametro opacityBrush), il pennello deve essere un ID2D1BitmapBrush con le relative modalità x- e y-extend impostate su D2D1_EXTEND_MODE_CLAMP. Per altre informazioni, vedere la sezione Osservazioni.

CRenderTarget::FillMesh

Disegna l'interno della mesh specificata.

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

Parametri

pMesh
Mesh da disegnare.

pBrush
Pennello utilizzato per disegnare la mesh.

CRenderTarget::FillOpacityMask

Applica la maschera di opacità descritta dalla bitmap specificata a un pennello e usa tale pennello per disegnare un'area della destinazione di rendering.

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

Parametri

pOpacityMask
Posizione e raggio, in pixel indipendenti dal dispositivo, dell'ellisse da disegnare.

pBrush
Pennello utilizzato per disegnare l'area della destinazione di rendering specificata da destinationRectangle.

content
Tipo di contenuto contenuto nella maschera di opacità. Il valore viene utilizzato per determinare lo spazio colore in cui viene combinata la maschera di opacità.

rectDest
Area della destinazione di rendering da disegnare, in pixel indipendenti dal dispositivo.

rectSrc
Area della bitmap da usare come maschera di opacità, in pixel indipendenti dal dispositivo.

CRenderTarget::FillRectangle

Disegna l'interno del rettangolo specificato.

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

Parametri

rettangolo
Dimensione del rettangolo da disegnare, in pixel indipendenti dal dispositivo.

pBrush
Pennello utilizzato per disegnare l'interno del rettangolo.

CRenderTarget::FillRoundedRectangle

Disegna l'interno del rettangolo arrotondato specificato.

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

Parametri

rectRounded
Dimensioni del rettangolo arrotondato da disegnare, in pixel indipendenti dal dispositivo.

pBrush
Pennello utilizzato per disegnare l'interno del rettangolo arrotondato.

CRenderTarget::Flush

Esegue tutti i comandi di disegno in sospeso.

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

Parametri

tag1
Contiene il tag per le operazioni di disegno che hanno causato errori o 0 se non sono presenti errori. Questo parametro viene passato non inizializzato.

tag2
Contiene il tag per le operazioni di disegno che hanno causato errori o 0 se non sono presenti errori. Questo parametro viene passato non inizializzato.

CRenderTarget::GetAntialiasMode

Recupera la modalità di anti-aliasing corrente per le operazioni di disegno non di testo.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Valore restituito

Modalità di antialiasing corrente per operazioni di disegno non di testo.

CRenderTarget::GetDpi

Restituisce i punti della destinazione di rendering per pollice (DPI)

CD2DSizeF GetDpi() const;

Valore restituito

Punti per pollice (DPI) della destinazione di rendering.

CRenderTarget::GetMaximumBitmapSize

Ottiene le dimensioni massime, in unità dipendenti dal dispositivo (pixel) di una dimensione bitmap supportata dalla destinazione di rendering

UINT32 GetMaximumBitmapSize() const;

Valore restituito

Dimensioni massime, in pixel, di una dimensione bitmap supportata dalla destinazione di rendering

CRenderTarget::GetPixelFormat

Recupera il formato pixel e la modalità alfa della destinazione di rendering

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Valore restituito

Formato pixel e modalità alfa della destinazione di rendering

CRenderTarget::GetPixelSize

Restituisce le dimensioni della destinazione di rendering in pixel del dispositivo

CD2DSizeU GetPixelSize() const;

Valore restituito

Dimensioni della destinazione di rendering in pixel del dispositivo

CRenderTarget::GetRenderTarget

Restituisce l'interfaccia ID2D1RenderTarget

ID2D1RenderTarget* GetRenderTarget();

Valore restituito

Puntatore a un'interfaccia ID2D1RenderTarget o NULL se l'oggetto non è ancora inizializzato.

CRenderTarget::GetSize

Restituisce le dimensioni della destinazione di rendering in pixel indipendenti dal dispositivo

CD2DSizeF GetSize() const;

Valore restituito

Dimensioni correnti della destinazione di rendering in pixel indipendenti dal dispositivo

CRenderTarget::GetTags

Ottiene l'etichetta per le successive operazioni di disegno.

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

Parametri

tag1
Contiene la prima etichetta per le successive operazioni di disegno. Questo parametro viene passato non inizializzato. Se si specifica NULL, non viene recuperato alcun valore per questo parametro.

tag2
Contiene la seconda etichetta per le operazioni di disegno successive. Questo parametro viene passato non inizializzato. Se si specifica NULL, non viene recuperato alcun valore per questo parametro.

CRenderTarget::GetTextAntialiasMode

Ottiene la modalità di antialiasing corrente per le operazioni di disegno di testo e glifo.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Valore restituito

Modalità di antialiasing corrente per le operazioni di disegno di testo e glifo.

CRenderTarget::GetTextRenderingParams

Recupera le opzioni di rendering del testo correnti della destinazione di rendering.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parametri

textRenderingParams
Quando termina, textRenderingParams contiene l'indirizzo di un puntatore alle opzioni di rendering del testo correnti della destinazione di rendering.

CRenderTarget::GetTransform

Ottiene la trasformazione corrente della destinazione di rendering.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parametri

transform
Quando termina, contiene la trasformazione corrente della destinazione di rendering. Questo parametro viene passato non inizializzato.

CRenderTarget::IsSupported

Indica se la destinazione di rendering supporta le proprietà specificate

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parametri

renderTargetProperties
Proprietà della destinazione di rendering da testare

Valore restituito

TRUE se le proprietà di destinazione di rendering specificate sono supportate da questa destinazione di rendering; in caso contrario, FALSE

CRenderTarget::IsValid

Verifica la validità delle risorse

BOOL IsValid() const;

Valore restituito

TRUE se la risorsa è valida; in caso contrario FALSE.

CRenderTarget::m_lstResources

Elenco di puntatori agli oggetti CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Puntatore a un oggetto ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Puntatore all'oggetto CD2DTextFormat che contiene un formato di testo predefinito.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Restituisce l'interfaccia ID2D1RenderTarget

operator ID2D1RenderTarget*();

Valore restituito

Puntatore a un'interfaccia ID2D1RenderTarget o NULL se l'oggetto non è ancora inizializzato.

CRenderTarget::P opAxisAlignedClip

Rimuove l'ultima clip allineata all'asse dalla destinazione di rendering. Dopo aver chiamato questo metodo, la clip non viene più applicata alle successive operazioni di disegno.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Arresta il reindirizzamento delle operazioni di disegno al livello specificato dall'ultima chiamata PushLayer.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

Rimuove l'ultima clip allineata all'asse dalla destinazione di rendering. Dopo aver chiamato questo metodo, la clip non viene più applicata alle successive operazioni di disegno.

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

Parametri

rectClip
Dimensioni e posizione dell'area di ritaglio, in pixel indipendenti dal dispositivo.

mode
Modalità antialiasing utilizzata per disegnare i bordi dei rettangoli di ritaglio con limiti subpixel e per combinare la clip con il contenuto della scena. La fusione viene eseguita una volta quando viene chiamato il metodo PopAxisAlignedClip e non si applica a ogni primitiva all'interno del livello.

CRenderTarget::P ushLayer

Aggiunge il livello specificato alla destinazione di rendering in modo che riceva tutte le operazioni di disegno successive fino a quando non viene chiamato PopLayer.

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

Parametri

layerParameters
Limiti del contenuto, maschera geometrica, opacità, maschera di opacità e opzioni di antialiasing per il livello.

strato
Livello che riceve le successive operazioni di disegno.

CRenderTarget::RestoreDrawingState

Imposta lo stato del disegno della destinazione di rendering su quello dell'ID2D1DrawingStateBlock specificato.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parametri

drawingStateBlock
Nuovo stato di disegno della destinazione di rendering.

CRenderTarget::SaveDrawingState

Salva lo stato corrente del disegno nell'ID2D1DrawingStateBlock specificato.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parametri

drawingStateBlock
Quando termina, questo metodo contiene lo stato di disegno corrente della destinazione di rendering. Questo parametro deve essere inizializzato prima di passarlo al metodo .

CRenderTarget::SetAntialiasMode

Imposta la modalità di antialiasing della destinazione di rendering. La modalità antialiasing si applica a tutte le operazioni di disegno successive, escluse le operazioni di disegno di testo e glifo.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parametri

antialiasMode
Modalità antialiasing per operazioni di disegno future.

CRenderTarget::SetDpi

Imposta i punti per pollice (DPI) della destinazione di rendering.

void SetDpi(const CD2DSizeF& sizeDPI);

Parametri

sizeDPI
Valore maggiore o uguale a zero che specifica l'elemento horizontal/verticalDPI della destinazione di rendering.

CRenderTarget::SetTags

Specifica un'etichetta per le operazioni di disegno successive.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parametri

tag1
Etichetta da applicare alle successive operazioni di disegno.

tag2
Etichetta da applicare alle successive operazioni di disegno.

CRenderTarget::SetTextAntialiasMode

Specifica la modalità di anti-aliasing da utilizzare per le successive operazioni di disegno di testo e glifo.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parametri

textAntialiasMode
Modalità di antialiasing da utilizzare per le successive operazioni di disegno di testo e glifo.

CRenderTarget::SetTextRenderingParams

Specifica le opzioni di rendering del testo da applicare a tutte le successive operazioni di disegno di testo e glifo.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parametri

textRenderingParams
Le opzioni di rendering del testo da applicare a tutte le successive operazioni di disegno di testo e glifo; NULL per cancellare le opzioni di rendering del testo correnti.

CRenderTarget::SetTransform

Applica la trasformazione specificata alla destinazione di rendering, sostituendo la trasformazione esistente. Tutte le operazioni di disegno successive si verificano nello spazio trasformato.

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

Parametri

transform
Trasformazione da applicare alla destinazione di rendering.

CRenderTarget::VerifyResource

Verifica la validità dell'oggetto CD2DResource; crea l'oggetto se non esiste già.

BOOL VerifyResource(CD2DResource* pResource);

Parametri

pResource
Puntatore all'oggetto CD2DResource.

Valore restituito

TRUE è l'oggetto se valido; in caso contrario FALSE.

Vedi anche

Classi

Condividi tramite

Classe CRenderTarget

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Metodi protetti

Operatori pubblici

Membri dati protetti

Gerarchia di ereditarietà

Requisiti

CRenderTarget::~CRenderTarget

CRenderTarget::Attach

Parametri

CRenderTarget::BeginDraw

CRenderTarget::Clear

Parametri

CRenderTarget::COLORREF_TO_D2DCOLOR

Parametri

Valore restituito

CRenderTarget::CreateCompatibleRenderTarget

Parametri

Valore restituito

CRenderTarget::CRenderTarget

CRenderTarget::D estroy

Parametri

Valore restituito

CRenderTarget::D etach

Valore restituito

CRenderTarget::D rawBitmap

Parametri

CRenderTarget::D rawEllipse

Parametri

CRenderTarget::D rawGeometry

Parametri

CRenderTarget::D rawGlyphRun

Parametri

CRenderTarget::D rawLine

Parametri

CRenderTarget::D rawRectangle

Parametri

CRenderTarget::D rawRoundedRectangle

Parametri

CRenderTarget::D rawText

Parametri

CRenderTarget::D rawTextLayout

Parametri

CRenderTarget::EndDraw

Valore restituito

CRenderTarget::FillEllipse

Parametri

CRenderTarget::FillGeometry

Parametri

CRenderTarget::FillMesh

Parametri

CRenderTarget::FillOpacityMask

Parametri

CRenderTarget::FillRectangle

Parametri

CRenderTarget::FillRoundedRectangle

Parametri

CRenderTarget::Flush

Parametri

CRenderTarget::GetAntialiasMode

Valore restituito

CRenderTarget::GetDpi

Valore restituito

CRenderTarget::GetMaximumBitmapSize

Valore restituito

CRenderTarget::GetPixelFormat

Valore restituito

CRenderTarget::GetPixelSize

Valore restituito

CRenderTarget::GetRenderTarget

Valore restituito

CRenderTarget::GetSize

Valore restituito

CRenderTarget::GetTags

Parametri

CRenderTarget::GetTextAntialiasMode