CRenderTarget (clase)
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
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).
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.
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de