CRenderTarget (clase)

Artículo
06/16/2023

Un contenedor para ID2D1RenderTarget.

Sintaxis

class CRenderTarget : public CObject;

Miembros

Constructores públicos

Nombre	Descripción
CRenderTarget::CRenderTarget	Construye un objeto CRenderTarget.
CRenderTarget::~CRenderTarget	El destructor . Se le llama cuando se está destruyendo un objeto de destino de representación.

Métodos públicos

Nombre	Descripción
CRenderTarget::Attach	Adjunta la interfaz de destino de representación existente al objeto
CRenderTarget::BeginDraw	Inicia el dibujo en este destino de representación.
CRenderTarget::Clear	Borra el área de dibujo con el color especificado.
CRenderTarget::COLORREF_TO_D2DCOLOR	Convierte los valores alfa y color GDI en el objeto D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget	Crea un nuevo destino de representación de mapa de bits para su uso durante el dibujo intermedio fuera de pantalla compatible con el destino de representación actual.
CRenderTarget::Destroy	Elimina uno o más recursos.
CRenderTarget::Detach	Desasocia la interfaz de destino de representación del objeto
CRenderTarget::DrawBitmap	Dibuja el texto con formato descrito por el objeto IDWriteTextLayout especificado.
CRenderTarget::DrawEllipse	Dibuja el contorno de la elipse especificada con el estilo de trazo especificado.
CRenderTarget::DrawGeometry	Dibuja el contorno de la elipse especificada con el estilo de trazo especificado.
CRenderTarget::DrawGlyphRun	Dibuja los glifos especificados.
CRenderTarget::DrawLine	Dibuja una línea entre los puntos especificados con el estilo de trazo especificado.
CRenderTarget::DrawRectangle	Dibuja el contorno de un rectángulo que tiene las dimensiones y el estilo de trazo especificados.
CRenderTarget::DrawRoundedRectangle	Dibuja el contorno del rectángulo especificado con el estilo de trazo especificado.
CRenderTarget::DrawText	Dibuja el texto especificado con la información de formato proporcionada por un objeto IDWriteTextFormat.
CRenderTarget::DrawTextLayout	Dibuja el texto con formato descrito por el objeto IDWriteTextLayout especificado.
CRenderTarget::EndDraw	Finaliza las operaciones de dibujo en el destino de representación e indica el estado de error actual y las etiquetas asociadas.
CRenderTarget::FillEllipse	Pinta el interior de la elipse especificada.
CRenderTarget::FillGeometry	Pinta el interior de la geometría especificada.
CRenderTarget::FillMesh	Pinta el interior de la malla especificada.
CRenderTarget::FillOpacityMask	Aplica la máscara de opacidad descrita por el mapa de bits especificado a un pincel y usa ese pincel para pintar una región del destino de representación.
CRenderTarget::FillRectangle	Pinta el interior del rectángulo especificado.
CRenderTarget::FillRoundedRectangle	Pinta el interior del rectángulo redondeado especificado.
CRenderTarget::Flush	Ejecuta todos los comandos de dibujo pendientes.
CRenderTarget::GetAntialiasMode	Recupera el modo de suavizado de contorno actual para las operaciones de dibujo que no son de texto.
CRenderTarget::GetDpi	Devuelve los puntos por pulgada (PPP) del destino de representación.
CRenderTarget::GetMaximumBitmapSize	Obtiene el tamaño máximo en unidades dependientes del dispositivo (píxeles) de cualquier dimensión de mapa de bits compatible con el destino de representación.
CRenderTarget::GetPixelFormat	Recupera el formato de píxel y el modo alfa del destino de representación.
CRenderTarget::GetPixelSize	Devuelve el tamaño del destino de representación en píxeles del dispositivo.
CRenderTarget::GetRenderTarget	Devuelve la interfaz ID2D1RenderTarget.
CRenderTarget::GetSize	Devuelve el tamaño del destino de representación en píxeles independientes del dispositivo.
CRenderTarget::GetTags	Obtiene la etiqueta para las operaciones de dibujo subsecuentes.
CRenderTarget::GetTextAntialiasMode	Obtiene el modo de suavizado de contorno actual para las operaciones de dibujo de glifos y texto.
CRenderTarget::GetTextRenderingParams	Recupera las opciones de representación de texto actuales del destino de representación.
CRenderTarget::GetTransform	Aplica la transformación especificada al destino de representación, lo que reemplaza la transformación existente. Todas las operaciones de dibujo posteriores se producen en el espacio transformado.
CRenderTarget::IsSupported	Indica si el destino de representación admite las propiedades especificadas.
CRenderTarget::IsValid	Comprueba la validez de un recurso.
CRenderTarget::PopAxisAlignedClip	Quita el último recorte alineado con el eje del destino de representación. Después de llamar a este método, el recorte ya no se aplica a las operaciones de dibujo subsecuentes.
CRenderTarget::PopLayer	Detiene el redireccionamiento de las operaciones de dibujo a la capa especificada por la última llamada a PushLayer.
CRenderTarget::PushAxisAlignedClip	Quita el último recorte alineado con el eje del destino de representación. Después de llamar a este método, el recorte ya no se aplica a las operaciones de dibujo subsecuentes.
CRenderTarget::PushLayer	Agrega la capa especificada al destino de representación de modo que reciba todas las operaciones de dibujo posteriores hasta que se llame a PopLayer.
CRenderTarget::RestoreDrawingState	Establece el estado de dibujo del destino de representación en el del ID2D1DrawingStateBlock especificado.
CRenderTarget::SaveDrawingState	Guarda el estado del dibujo actual en el ID2D1DrawingStateBlock especificado.
CRenderTarget::SetAntialiasMode	Establece el modo de suavizado de contorno del destino de representación. El modo de suavizado de contorno se aplica a todas las operaciones de dibujo posteriores, excepto las operaciones de dibujo de glifos y texto.
CRenderTarget::SetDpi	Establece los puntos por pulgada (PPP) del destino de representación.
CRenderTarget::SetTags	Especifica la etiqueta para las operaciones de dibujo subsecuentes.
CRenderTarget::SetTextAntialiasMode	Especifica el modo de suavizado de contorno que se usará para las operaciones de dibujo de glifos y texto posteriores.
CRenderTarget::SetTextRenderingParams	Especifica las opciones de representación de texto que se aplicarán a todas las operaciones de dibujo de glifos y texto posteriores.
CRenderTarget::SetTransform	Con sobrecarga. Aplica la transformación especificada al destino de representación, lo que reemplaza la transformación existente. Todas las operaciones de dibujo posteriores se producen en el espacio transformado.

Métodos protegidos

Nombre	Descripción
CRenderTarget::VerifyResource	Verifica la validez del objeto CD2DResource; crea el objeto si aún no existía.

Operadores públicos

Nombre	Descripción
CRenderTarget::operator ID2D1RenderTarget*	Devuelve la interfaz ID2D1RenderTarget.

Miembros de datos protegidos

Nombre	Descripción
CRenderTarget::m_lstResources	Una lista de punteros a objetos CD2DResource.
CRenderTarget::m_pRenderTarget	Un puntero a un objeto ID2D1RenderTarget.
CRenderTarget::m_pTextFormatDefault	Un puntero al objeto CD2DTextFormat que contiene un formato de texto predeterminado.

Jerarquía de herencia

CObject

CRenderTarget

Requisitos

Encabezado: afxrendertarget.h

CRenderTarget::~CRenderTarget

El destructor . Se le llama cuando se está destruyendo un objeto de destino de representación.

virtual ~CRenderTarget();

CRenderTarget::Attach

Adjunta la interfaz de destino de representación existente al objeto

void Attach(ID2D1RenderTarget* pRenderTarget);

Parámetros

pRenderTarget
Interfaz de destino de representación existente. No puede ser NULL.

CRenderTarget::BeginDraw

Inicia el dibujo en este destino de representación.

void BeginDraw();

CRenderTarget::Clear

Borra el área de dibujo con el color especificado.

void Clear(D2D1_COLOR_F color);

Parámetros

color
El color con que se borra el área de dibujo.

CRenderTarget::COLORREF_TO_D2DCOLOR

Convierte los valores alfa y color GDI en el objeto D2D1_COLOR_F.

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

Parámetros

color
El valor RGB.

nAlpha

Valor devuelto

El valor de D2D1_COLOR_F.

CRenderTarget::CreateCompatibleRenderTarget

Crea un nuevo destino de representación de mapa de bits para su uso durante el dibujo intermedio fuera de pantalla compatible con el destino de representación actual.

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

Parámetros

bitmapTarget
Cuando este método devuelve un valor, contiene la dirección de un puntero a un nuevo destino de representación de mapa de bits. Este parámetro se pasa sin inicializar.

sizeDesired
El tamaño deseado del nuevo destino de representación en píxeles independientes del dispositivo, si debe ser diferente del destino de representación original o NULL. Para obtener más información, vea la sección Comentarios.

sizePixelDesired
El tamaño deseado del nuevo destino de representación en píxeles, si debe ser diferente del destino de representación original o NULL. Para obtener más información, vea la sección Comentarios.

desiredFormat
El formato de píxel deseado y el modo alfa del nuevo destino de representación, o NULL. Si el formato de píxel se establece en DXGI_FORMAT_UNKNOWN o si este parámetro es null, el nuevo destino de representación usa el mismo formato de píxel que el destino de representación original. Si el modo alfa es D2D1_ALPHA_MODE_UNKNOWN o este parámetro es NULL, el modo alfa del nuevo destino de representación tiene como valor predeterminado D2D1_ALPHA_MODE_PREMULTIPLIED. Para obtener información sobre los formatos de píxeles admitidos, consulte Formatos de píxeles admitidos y modos alfa.

options
Un valor que especifica si el nuevo destino de representación debe ser compatible con GDI.

Valor devuelto

Si el método se ejecuta correctamente, devuelve TRUE. En caso contrario, devuelve FALSE.

CRenderTarget::CRenderTarget

Construye un objeto CRenderTarget.

CRenderTarget();

CRenderTarget::Destroy

Elimina uno o más recursos.

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parámetros

bDeleteResources
Si bDeleteResources es TRUE, todos los recursos ubicados en m_lstResources se destruirán automáticamente.

Valor devuelto

Si el método se ejecuta correctamente, devuelve TRUE. En caso contrario, devuelve FALSE

CRenderTarget::Detach

Desasocia la interfaz de destino de representación del objeto

ID2D1RenderTarget* Detach ();

Valor devuelto

Un puntero a la interfaz de destino de representación desasociada.

CRenderTarget::DrawBitmap

Dibuja el texto con formato descrito por el objeto IDWriteTextLayout especificado.

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

Parámetros

pBitmap
El mapa de bits que se representará.

rectDest
El tamaño y la posición, en píxeles independientes del dispositivo en el espacio de coordenadas del destino de representación, del área en la que se dibuja el mapa de bits. Si el rectángulo no está bien ordenado, no se dibuja nada, pero el destino de representación no entra en un estado de error.

fOpacity
Un valor entre 0.0f y 1.0f, incluyendo estos límites, que especifica un valor de opacidad que se aplicará al mapa de bits; este valor se multiplica por los valores alfa del contenido del mapa de bits.

interpolationMode
El modo de interpolación que se usará si la operación de dibujo escala o gira el mapa de bits.

pRectSrc
El tamaño y posición, en píxeles independientes del dispositivo en el espacio de coordenadas del mapa de bits, del área dentro del mapa de bits que se dibujará.

CRenderTarget::DrawEllipse

Dibuja el contorno de la elipse especificada con el estilo de trazo especificado.

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

Parámetros

ellipse
La posición y el radio de la elipse que se va a dibujar, en píxeles independientes del dispositivo.

pBrush
El pincel que se usa para pintar el contorno de la elipse.

fStrokeWidth
El grosor del trazo de la elipse. El trazo se centra en el contorno de la elipse.

strokeStyle
El estilo de trazo que se aplicará al contorno de la elipse o NULL para pintar un trazo sólido.

CRenderTarget::DrawGeometry

Dibuja el contorno de la elipse especificada con el estilo de trazo especificado.

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

Parámetros

pGeometry
La geometría que se dibujará.

pBrush
El pincel que se usa para pintar el trazo de la geometría.

fStrokeWidth
El grosor del trazo de la geometría. El trazo se centra en el contorno de la geometría.

strokeStyle
El estilo de trazo que se aplicará al contorno de la geometría o NULL para pintar un trazo sólido.

CRenderTarget::DrawGlyphRun

Dibuja los glifos especificados.

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

Parámetros

ptBaseLineOrigin
El origen, en píxeles independientes del dispositivo, de la línea de base de los glifos.

glyphRun
Los glifos que se representarán.

pForegroundBrush
El pincel que se usará para pintar los glifos especificados.

measuringMode
Un valor que indica cómo se usan las métricas de glifo para medir el texto cuando tiene formato. El valor predeterminado es DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::DrawLine

Dibuja una línea entre los puntos especificados con el estilo de trazo especificado.

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

Parámetros

ptFrom
El punto inicial de la línea, en píxeles independientes del dispositivo.

ptTo
El punto final de la línea, en píxeles independientes del dispositivo.

pBrush
El pincel usado para pintar el trazo de la línea.

fStrokeWidth
Un valor mayor o igual que 0.0f que especifica el ancho del trazo. Si no se especifica este parámetro, el valor predeterminado es 1.0f. El trazo se centra en la línea.

strokeStyle
El estilo de trazo que se pintará o NULL para pintar una línea sólida.

CRenderTarget::DrawRectangle

Dibuja el contorno de un rectángulo que tiene las dimensiones y el estilo de trazo especificados.

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

Parámetros

rectangle
Las dimensiones del rectángulo que se dibujará, en píxeles independientes del dispositivo.

pBrush
El pincel usado para pintar el trazo del rectángulo.

fStrokeWidth
Un valor mayor o igual que 0.0f que especifica el ancho del trazo del rectángulo. El trazo se centra en el contorno del rectángulo.

strokeStyle
El estilo de trazo que se pintará o NULL para pintar un trazo sólido.

CRenderTarget::DrawRoundedRectangle

Dibuja el contorno del rectángulo especificado con el estilo de trazo especificado.

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

Parámetros

rectRounded
Las dimensiones del rectángulo redondeado que se dibujará, en píxeles independientes del dispositivo.

pBrush
El pincel utilizado para pintar el contorno del rectángulo redondeado.

fStrokeWidth
El ancho del trazo del rectángulo redondeado. El trazo se centra en el contorno del rectángulo redondeado. El valor predeterminado es 1.0f.

strokeStyle
El estilo del trazo del rectángulo redondeado o NULL para pintar un trazo sólido. El valor predeterminado es NULL.

CRenderTarget::DrawText

Dibuja el texto especificado con la información de formato proporcionada por un objeto 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);

Parámetros

strText
Un puntero a una matriz de caracteres Unicode por dibujar.

rectangle
El tamaño y la posición del área en que se dibujará el texto.

pForegroundBrush
Pincel usado para pintar el texto.

textFormat
Un objeto que describe los detalles de formato del texto que se dibujará, como la fuente, el tamaño de fuente y la dirección del flujo.

options
Un valor que indica si el texto se debe acoplar a los límites de píxeles y si el texto se debe recortar según el rectángulo de diseño. El valor predeterminado es D2D1_DRAW_TEXT_OPTIONS_NONE, lo que indica que el texto se debe acoplar a los límites de píxeles y no debe recortarse según el rectángulo de diseño.

measuringMode
Un valor que indica cómo se usan las métricas de glifo para medir el texto cuando tiene formato. El valor predeterminado es DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::DrawTextLayout

Dibuja el texto con formato descrito por el objeto IDWriteTextLayout especificado.

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

Parámetros

ptOrigin
El punto, descrito en píxeles independientes del dispositivo, en el que se dibuja la esquina superior izquierda del texto descrito por textLayout.

textLayout
El texto con formato que se dibujará. Los efectos de dibujo que no se heredan de ID2D1Resource se omiten. Si hay efectos de dibujo que se heredan de ID2D1Resource y no son pinceles, este método produce un error y el destino de representación se coloca en un estado de error.

pBrushForeground
El pincel usado para pintar cualquier texto de textLayout que aún no tenga un pincel asociado como un efecto de dibujo (especificado por el método IDWriteTextLayout::SetDrawingEffect).

CRenderTarget::EndDraw

Finaliza las operaciones de dibujo en el destino de representación e indica el estado de error actual y las etiquetas asociadas.

HRESULT EndDraw();

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

CRenderTarget::FillEllipse

Pinta el interior de la elipse especificada.

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

Parámetros

ellipse
La posición y el radio de la elipse que se pintará, en píxeles independientes del dispositivo.

pBrush
El pincel utilizado para pintar el interior de la elipse.

CRenderTarget::FillGeometry

Pinta el interior de la geometría especificada.

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

Parámetros

pGeometry
La geometría que se pintará.

pBrush
El pincel que se usa para pintar el interior de la geometría.

pOpacityBrush
La máscara de opacidad que se aplicará a la geometría; NULL para ninguna máscara de opacidad. Si se especifica una máscara de opacidad (el parámetro opacityBrush), el pincel debe ser un ID2D1BitmapBrush que tenga sus modos x- e y-extend establecidos en D2D1_EXTEND_MODE_CLAMP. Para obtener más información, vea la sección Comentarios.

CRenderTarget::FillMesh

Pinta el interior de la malla especificada.

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

Parámetros

pMesh
La malla que se pintará.

pBrush
El pincel utilizado para pintar la malla.

CRenderTarget::FillOpacityMask

Aplica la máscara de opacidad descrita por el mapa de bits especificado a un pincel y usa ese pincel para pintar una región del destino de representación.

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

Parámetros

pOpacityMask
La posición y el radio de la elipse que se pintará, en píxeles independientes del dispositivo.

pBrush
El pincel utilizado para pintar la región del destino de representación especificado por destinationRectangle.

content
El tipo de contenido que contiene la máscara de opacidad. El valor se usa para determinar el espacio de colores en el que se combina la máscara de opacidad.

rectDest
La región del destino de representación que se pintará, en píxeles independientes del dispositivo.

rectSrc
La región del mapa de bits que se usará como máscara de opacidad, en píxeles independientes del dispositivo.

CRenderTarget::FillRectangle

Pinta el interior del rectángulo especificado.

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

Parámetros

rectangle
Las dimensiones del rectángulo que se pintará, en píxeles independientes del dispositivo.

pBrush
El pincel usado para pintar el interior del rectángulo.

CRenderTarget::FillRoundedRectangle

Pinta el interior del rectángulo redondeado especificado.

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

Parámetros

rectRounded
Las dimensiones del rectángulo redondeado que se pintará, en píxeles independientes del dispositivo.

pBrush
El pincel usado para pintar el interior del rectángulo redondeado.

CRenderTarget::Flush

Ejecuta todos los comandos de dibujo pendientes.

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

Parámetros

tag1
Contiene la etiqueta de las operaciones de dibujo que provocaron errores o 0 si no había errores. Este parámetro se pasa sin inicializar.

tag2
Contiene la etiqueta de las operaciones de dibujo que provocaron errores o 0 si no había errores. Este parámetro se pasa sin inicializar.

CRenderTarget::GetAntialiasMode

Recupera el modo de suavizado de contorno actual para las operaciones de dibujo que no son de texto.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Valor devuelto

Recupera el modo de suavizado de contorno actual para las operaciones de dibujo que no son de texto.

CRenderTarget::GetDpi

Devuelve los puntos por pulgada (PPP) del destino de representación.

CD2DSizeF GetDpi() const;

Valor devuelto

Los puntos por pulgada (PPP) del destino de representación.

CRenderTarget::GetMaximumBitmapSize

Obtiene el tamaño máximo en unidades dependientes del dispositivo (píxeles) de cualquier dimensión de mapa de bits compatible con el destino de representación.

UINT32 GetMaximumBitmapSize() const;

Valor devuelto

El tamaño máximo, en píxeles, de cualquier dimensión de mapa de bits compatible con el destino de representación.

CRenderTarget::GetPixelFormat

Recupera el formato de píxel y el modo alfa del destino de representación.

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Valor devuelto

El formato de píxel y el modo alfa del destino de representación.

CRenderTarget::GetPixelSize

Devuelve el tamaño del destino de representación en píxeles del dispositivo.

CD2DSizeU GetPixelSize() const;

Valor devuelto

El tamaño del destino de representación en píxeles del dispositivo.

CRenderTarget::GetRenderTarget

Devuelve la interfaz ID2D1RenderTarget.

ID2D1RenderTarget* GetRenderTarget();

Valor devuelto

Un puntero a una interfaz ID2D1RenderTarget o NULL si el objeto aún no se ha inicializado.

CRenderTarget::GetSize

Devuelve el tamaño del destino de representación en píxeles independientes del dispositivo.

CD2DSizeF GetSize() const;

Valor devuelto

El tamaño actual del destino de representación en píxeles independientes del dispositivo.

CRenderTarget::GetTags

Obtiene la etiqueta para las operaciones de dibujo subsecuentes.

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

Parámetros

tag1
Contiene la primera etiqueta para las operaciones de dibujo posteriores. Este parámetro se pasa sin inicializar. Si se especifica NULL, no se recupera ningún valor para este parámetro.

tag2
Contiene la segunda etiqueta para las operaciones de dibujo posteriores. Este parámetro se pasa sin inicializar. Si se especifica NULL, no se recupera ningún valor para este parámetro.

CRenderTarget::GetTextAntialiasMode

Obtiene el modo de suavizado de contorno actual para las operaciones de dibujo de glifos y texto.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Valor devuelto

Obtiene el modo de suavizado de contorno actual para las operaciones de dibujo de glifos y texto.

CRenderTarget::GetTextRenderingParams

Recupera las opciones de representación de texto actuales del destino de representación.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parámetros

textRenderingParams
Cuando este método devuelve un valor, textRenderingParams contiene la dirección de un puntero a las opciones de representación de texto actual del destino de representación.

CRenderTarget::GetTransform

Obtiene la transformación actual del destino de representación.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parámetros

transform
Cuando devuelve un valor, contiene la transformación actual del destino de representación. Este parámetro se pasa sin inicializar.

CRenderTarget::IsSupported

Indica si el destino de representación admite las propiedades especificadas.

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parámetros

renderTargetProperties
Las propiedades del destino de representación que se probarán.

Valor devuelto

TRUE si el destino de representación especificado admite las propiedades del destino de representación; en caso contrario, FALSE.

CRenderTarget::IsValid

Comprueba la validez de un recurso.

BOOL IsValid() const;

Valor devuelto

TRUE si el recurso es válido; de lo contrario, FALSE.

CRenderTarget::m_lstResources

Una lista de punteros a objetos CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Un puntero a un objeto ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Un puntero al objeto CD2DTextFormat que contiene un formato de texto predeterminado.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Devuelve la interfaz ID2D1RenderTarget.

operator ID2D1RenderTarget*();

Valor devuelto

Un puntero a una interfaz ID2D1RenderTarget o NULL si el objeto aún no se ha inicializado.

CRenderTarget::PopAxisAlignedClip

Quita el último recorte alineado con el eje del destino de representación. Después de llamar a este método, el recorte ya no se aplica a las operaciones de dibujo subsecuentes.

void PopAxisAlignedClip();

CRenderTarget::PopLayer

Detiene el redireccionamiento de las operaciones de dibujo a la capa especificada por la última llamada a PushLayer.

void PopLayer();

CRenderTarget::PushAxisAlignedClip

Quita el último recorte alineado con el eje del destino de representación. Después de llamar a este método, el recorte ya no se aplica a las operaciones de dibujo subsecuentes.

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

Parámetros

rectClip
El tamaño y la posición del área de recorte, en píxeles independientes del dispositivo.

mode
El modo de suavizado de contorno que se usa para dibujar los bordes de los rectángulos recortados que tienen límites de subpíxeles y para combinar el recorte con el contenido de la escena. La combinación se realiza una vez cuando se llama al método PopAxisAlignedClip y no se aplica a cada primitivo dentro de la capa.

CRenderTarget::PushLayer

Agrega la capa especificada al destino de representación de modo que reciba todas las operaciones de dibujo posteriores hasta que se llame a PopLayer.

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

Parámetros

layerParameters
Los límites de contenido, máscara geométrica, opacidad, máscara de opacidad y opciones de suavizado de contorno para la capa.

layer
La capa que recibe operaciones de dibujo posteriores.

CRenderTarget::RestoreDrawingState

Establece el estado de dibujo del destino de representación en el del ID2D1DrawingStateBlock especificado.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parámetros

drawingStateBlock
El nuevo estado de dibujo del destino de representación.

CRenderTarget::SaveDrawingState

Guarda el estado del dibujo actual en el ID2D1DrawingStateBlock especificado.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parámetros

drawingStateBlock
Cuando este método devuelve un valor, contiene el estado de dibujo actual del destino de representación. Este parámetro debe inicializarse antes de pasarse al método.

CRenderTarget::SetAntialiasMode

Establece el modo de suavizado de contorno del destino de representación. El modo de suavizado de contorno se aplica a todas las operaciones de dibujo posteriores, excepto las operaciones de dibujo de glifos y texto.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parámetros

antialiasMode
El modo de suavizado de contorno para futuras operaciones de dibujo.

CRenderTarget::SetDpi

Establece los puntos por pulgada (PPP) del destino de representación.

void SetDpi(const CD2DSizeF& sizeDPI);

Parámetros

sizeDPI
Un valor mayor o igual que cero que especifica los PPP horizontales o verticales del destino de representación.

CRenderTarget::SetTags

Especifica la etiqueta para las operaciones de dibujo subsecuentes.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parámetros

tag1
Una etiqueta que se aplicará a las operaciones de dibujo posteriores.

tag2
Una etiqueta que se aplicará a las operaciones de dibujo posteriores.

CRenderTarget::SetTextAntialiasMode

Especifica el modo de suavizado de contorno que se usará para las operaciones de dibujo de glifos y texto posteriores.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parámetros

textAntialiasMode
El modo de suavizado de contorno que se usará para las operaciones de dibujo de glifos y texto posteriores.

CRenderTarget::SetTextRenderingParams

Especifica las opciones de representación de texto que se aplicarán a todas las operaciones de dibujo de glifos y texto posteriores.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parámetros

textRenderingParams
Las opciones de representación de texto que se aplicarán a todas las operaciones de dibujo de glifos y texto subsiguientes; NULL para borrar las opciones de representación de texto actuales.

CRenderTarget::SetTransform

Aplica la transformación especificada al destino de representación, lo que reemplaza la transformación existente. Todas las operaciones de dibujo posteriores se producen en el espacio transformado.

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

Parámetros

transform
La transformación que se aplicará al destino de representación.

CRenderTarget::VerifyResource

Verifica la validez del objeto CD2DResource; crea el objeto si aún no existía.

BOOL VerifyResource(CD2DResource* pResource);

Parámetros

pResource
Un puntero al objeto CD2DResource.

Valor devuelto

TRUE si el objeto es válido; en caso contrario, FALSE.

Consulte también

Clases

Compartir a través de

CRenderTarget (clase)

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Métodos protegidos

Operadores públicos

Miembros de datos protegidos

Jerarquía de herencia

Requisitos

CRenderTarget::~CRenderTarget

CRenderTarget::Attach

Parámetros

CRenderTarget::BeginDraw

CRenderTarget::Clear

Parámetros

CRenderTarget::COLORREF_TO_D2DCOLOR

Parámetros

Valor devuelto

CRenderTarget::CreateCompatibleRenderTarget

Parámetros

Valor devuelto

CRenderTarget::CRenderTarget

CRenderTarget::Destroy

Parámetros

Valor devuelto

CRenderTarget::Detach

Valor devuelto

CRenderTarget::DrawBitmap

Parámetros

CRenderTarget::DrawEllipse

Parámetros

CRenderTarget::DrawGeometry

Parámetros

CRenderTarget::DrawGlyphRun

Parámetros

CRenderTarget::DrawLine

Parámetros

CRenderTarget::DrawRectangle

Parámetros

CRenderTarget::DrawRoundedRectangle

Parámetros

CRenderTarget::DrawText

Parámetros

CRenderTarget::DrawTextLayout

Parámetros

CRenderTarget::EndDraw

Valor devuelto

CRenderTarget::FillEllipse

Parámetros

CRenderTarget::FillGeometry

Parámetros

CRenderTarget::FillMesh

Parámetros

CRenderTarget::FillOpacityMask

Parámetros

CRenderTarget::FillRectangle

Parámetros

CRenderTarget::FillRoundedRectangle

Parámetros

CRenderTarget::Flush

Parámetros

CRenderTarget::GetAntialiasMode

Valor devuelto

CRenderTarget::GetDpi

Valor devuelto

CRenderTarget::GetMaximumBitmapSize

Valor devuelto

CRenderTarget::GetPixelFormat

Valor devuelto

CRenderTarget::GetPixelSize

Valor devuelto

CRenderTarget::GetRenderTarget

Valor devuelto

CRenderTarget::GetSize

Valor devuelto

CRenderTarget::GetTags

Parámetros

CRenderTarget::GetTextAntialiasMode