Classe CRenderTarget

Artigo
06/16/2023

Um wrapper para ID2D1RenderTarget.

Sintaxe

class CRenderTarget : public CObject;

Membros

Construtores públicos

Nome	Descrição
CRenderTarget::CRenderTarget	Cria um objeto CRenderTarget.
CRenderTarget::~CRenderTarget	O destruidor. Chamado quando um objeto de destino de renderização está sendo destruído.

Métodos públicos

Nome	Descrição
CRenderTarget::Attach	Anexa a interface de destino de renderização existente para o objeto
CRenderTarget::BeginDraw	Inicia o desenho nesse destino de renderização.
CRenderTarget::Clear	Limpa a área de desenho para a cor especificada.
CRenderTarget::COLORREF_TO_D2DCOLOR	Converte os valores alta e de cor da GDI no objeto D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget	Cria um novo destino de renderização de bitmap para uso durante o desenho intermediário fora da tela compatível com o destino de renderização atual.
CRenderTarget::Destroy	Exclui um ou mais recursos
CRenderTarget::Detach	Desanexa a interface de destino de renderização do objeto
CRenderTarget::DrawBitmap	Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.
CRenderTarget::DrawEllipse	Desenha a estrutura de tópicos da elipse especificada usando o estilo de traço especificado.
CRenderTarget::DrawGeometry	Desenha a estrutura de tópicos da geometria especificada usando o estilo de traço especificado.
CRenderTarget::DrawGlyphRun	Desenha os glifos especificados.
CRenderTarget::DrawLine	Desenha uma linha entre os pontos especificados usando o estilo de traço especificado.
CRenderTarget::DrawRectangle	Desenha a estrutura de tópicos de um retângulo que tem as dimensões e o estilo de traço especificados.
CRenderTarget::DrawRoundedRectangle	Desenha a estrutura de tópicos do retângulo arredondado especificado usando o estilo de traço especificado.
CRenderTarget::DrawText	Desenha o texto especificado usando as informações de formato fornecidas por um objeto IDWriteTextFormat.
CRenderTarget::DrawTextLayout	Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.
CRenderTarget::EndDraw	Encerra as operações de desenho no destino de renderização e indica o estado de erro atual e as marcas associadas.
CRenderTarget::FillEllipse	Pinta o interior da elipse especificada.
CRenderTarget::FillGeometry	Pinta o interior da geometria especificada.
CRenderTarget::FillMesh	Pinta o interior da malha especificada.
CRenderTarget::FillOpacityMask	Aplica a máscara de opacidade descrita pelo bitmap especificado para um pincel e usa esse pincel para pintar uma região do destino de renderização.
CRenderTarget::FillRectangle	Pinta o interior do retângulo especificado.
CRenderTarget::FillRoundedRectangle	Pinta o interior do retângulo arredondado especificado.
CRenderTarget::Flush	Executa todos os comandos de desenho pendentes.
CRenderTarget::GetAntialiasMode	Recupera o modo de suavização atual para operações de desenho que não são texto.
CRenderTarget::GetDpi	Retorna o DPI (pontos por polegada) do destino de renderização
CRenderTarget::GetMaximumBitmapSize	Obtém o tamanho máximo, em unidades dependentes do dispositivo (pixels), de qualquer dimensão de bitmap compatível com o destino de renderização
CRenderTarget::GetPixelFormat	Recupera o formato de pixel e o modo alfa do destino de renderização
CRenderTarget::GetPixelSize	Retorna o tamanho do destino de renderização em pixels de dispositivo
CRenderTarget::GetRenderTarget	Retorna a interface ID2D1RenderTarget
CRenderTarget::GetSize	Retorna o tamanho do destino de renderização em pixels independentes do dispositivo
CRenderTarget::GetTags	Obtém o rótulo para operações de desenho subsequentes.
CRenderTarget::GetTextAntialiasMode	Obtém o modo de suavização atual para operações de desenho de texto e de glifo.
CRenderTarget::GetTextRenderingParams	Recupera as opções atuais de renderização de texto do destino de renderização.
CRenderTarget::GetTransform	Aplica a transformação especificada ao destino de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado.
CRenderTarget::IsSupported	Indica se o destino de renderização é compatível com as propriedades especificadas
CRenderTarget::IsValid	Verifica a validade do recurso
CRenderTarget::PopAxisAlignedClip	Remove o último clipe alinhado ao eixo do destino de renderização. Depois que esse método é chamado, o clipe não é mais aplicado às operações de desenho subsequentes.
CRenderTarget::PopLayer	Para de redirecionar as operações de desenho para a camada especificada pela última chamada ao PushLayer.
CRenderTarget::PushAxisAlignedClip	Remove o último clipe alinhado ao eixo do destino de renderização. Depois que esse método é chamado, o clipe não é mais aplicado às operações de desenho subsequentes.
CRenderTarget::PushLayer	Adiciona a camada especificada ao destino de renderização para que receba todas as operações de desenho subsequentes até que o PopLayer seja chamado.
CRenderTarget::RestoreDrawingState	Define o estado de desenho do destino de renderização como o do ID2D1DrawingStateBlock especificado.
CRenderTarget::SaveDrawingState	Salva o estado de desenho atual no ID2D1DrawingStateBlock especificado.
CRenderTarget::SetAntialiasMode	Define o modo de suavização do destino de renderização. O modo de suavização se aplica a todas as operações de desenho subsequentes, exceto as operações de desenho de texto e de glifo.
CRenderTarget::SetDpi	Define o DPI (pontos por polegada) do destino de renderização.
CRenderTarget::SetTags	Especifica o rótulo para operações de desenho subsequentes.
CRenderTarget::SetTextAntialiasMode	Especifica o modo de suavização a ser usado para operações de desenho de texto e de glifo subsequentes.
CRenderTarget::SetTextRenderingParams	Especifica as opções de renderização de texto a serem aplicadas a todas as operações de desenho de texto e glifo subsequentes.
CRenderTarget::SetTransform	Sobrecarregado. Aplica a transformação especificada ao destino de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado.

Métodos protegidos

Nome	Descrição
CRenderTarget::VerifyResource	Verifica a validade do objeto CD2DResource. Cria o objeto, se ainda não existir.

Operadores públicos

Nome	Descrição
CRenderTarget::operator ID2D1RenderTarget*	Retorna a interface ID2D1RenderTarget

Membros de dados protegidos

Nome	Descrição
CRenderTarget::m_lstResources	Uma lista de ponteiros para os objetos CD2DResource.
CRenderTarget::m_pRenderTarget	Um ponteiro para um objeto ID2D1RenderTarget.
CRenderTarget::m_pTextFormatDefault	Um ponteiro para o objeto CD2DTextFormat que contém um formato de texto padrão.

Hierarquia de herança

CObject

CRenderTarget

Requisitos

Cabeçalho: afxrendertarget.h

CRenderTarget::~CRenderTarget

O destruidor. Chamado quando um objeto de destino de renderização está sendo destruído.

virtual ~CRenderTarget();

CRenderTarget::Attach

Anexa a interface de destino de renderização existente para o objeto

void Attach(ID2D1RenderTarget* pRenderTarget);

Parâmetros

pRenderTarget
Interface de destino de renderização existente. Não pode ser NULL

CRenderTarget::BeginDraw

Inicia o desenho nesse destino de renderização.

void BeginDraw();

CRenderTarget::Clear

Limpa a área de desenho para a cor especificada.

void Clear(D2D1_COLOR_F color);

Parâmetros

color
A cor para a qual a área de desenho é desmarcada.

CRenderTarget::COLORREF_TO_D2DCOLOR

Converte os valores alta e de cor da GDI no objeto D2D1_COLOR_F.

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

Parâmetros

color
Valor RGB.

nAlpha

Valor de retorno

Valor D2D1_COLOR_F.

CRenderTarget::CreateCompatibleRenderTarget

Cria um novo destino de renderização de bitmap para uso durante o desenho intermediário fora da tela compatível com o destino de renderização atual.

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
Quando esse método retorna, contém o endereço de um ponteiro para um novo destino de renderização de bitmap. Este parâmetro é passado não inicializado.

sizeDesired
O tamanho desejado do novo destino de renderização em pixels independentes do dispositivo, se for diferente do destino de renderização original ou NULL. Para obter mais informações, consulte a seção Comentários.

sizePixelDesired
O tamanho desejado do novo destino de renderização em pixels, se for diferente do destino de renderização original ou NULL. Para obter mais informações, consulte a seção Comentários.

desiredFormat
O formato de pixel desejado e o modo alfa do novo destino de renderização ou NULL. Se o formato de pixel estiver definido como DXGI_FORMAT_UNKNOWN ou se esse parâmetro for nulo, o novo destino de renderização usará o mesmo formato de pixel que o destino de renderização original. Se o modo alfa for D2D1_ALPHA_MODE_UNKNOWN ou esse parâmetro for NULL, o modo alfa do novo destino de renderização será padrão para D2D1_ALPHA_MODE_PREMULTIPLIED. Para obter informações sobre formatos de pixel com suporte, confira Formatos de pixel com suporte e modos alfa.

options
Um valor que especifica se o novo destino de renderização deve ser compatível com o GDI.

Valor de retorno

Se o método for bem-sucedido, retornará TRUE. Caso contrário, retornará FALSE.

CRenderTarget::CRenderTarget

Cria um objeto CRenderTarget.

CRenderTarget();

CRenderTarget::Destroy

Exclui um ou mais recursos

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parâmetros

bDeleteResources
Se bDeleteResources for TRUE, todos os recursos localizados em m_lstResources serão destruídos automaticamente.

Valor de retorno

Se o método for bem-sucedido, retornará TRUE. Caso contrário, retorna FALSE

CRenderTarget::Detach

Desanexa a interface de destino de renderização do objeto

ID2D1RenderTarget* Detach ();

Valor de retorno

Ponteiro para a interface de destino de renderização desanexada.

CRenderTarget::DrawBitmap

Desenha o texto formatado descrito pelo 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
O bitmap a ser renderizado.

rectDest
O tamanho e a posição, em pixels independentes do dispositivo no espaço de coordenadas do destino de renderização, da área para a qual o bitmap é desenhado. Se o retângulo não estiver bem ordenado, nada será desenhado, mas o destino de renderização não entrará em estado de erro.

fOpacity
Um valor entre 0.0f e 1.0f, inclusive, que especifica um valor de opacidade a ser aplicado ao bitmap. Esse valor é multiplicado em relação aos valores alfa do conteúdo do bitmap.

interpolationMode
O modo de interpolação a ser usado, se o bitmap for dimensionado ou girado pela operação de desenho.

pRectSrc
O tamanho e a posição, em pixels independentes do dispositivo no espaço de coordenadas do bitmap, da área no bitmap a ser desenhado.

CRenderTarget::DrawEllipse

Desenha a estrutura de tópicos da elipse especificada usando o estilo de traço especificado.

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

Parâmetros

elipse
A posição e o raio da elipse a ser desenhada, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar a estrutura de tópicos da elipse.

fStrokeWidth
A espessura do traço da elipse. O traço é centralizado na estrutura de tópicos da elipse.

strokeStyle
O estilo de traço a ser aplicado à estrutura de tópicos da elipse ou NULL para pintar um traço sólido.

CRenderTarget::DrawGeometry

Desenha a estrutura de tópicos da geometria especificada usando o estilo de traço especificado.

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

Parâmetros

pGeometry
A geometria a ser desenhada.

pBrush
O pincel usado para pintar o traço da geometria.

fStrokeWidth
A espessura do traço da geometria. O traço é centralizado na estrutura de tópicos da geometria.

strokeStyle
O estilo de traço a ser aplicado à estrutura de tópicos da geometria ou NULL para pintar um traço sólido.

CRenderTarget::DrawGlyphRun

Desenha os 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
A origem, em pixels independentes do dispositivo, da linha de base dos glifos.

glyphRun
Os glifos a serem renderizados.

pForegroundBrush
O pincel usado para pintar os glifos especificados.

measuringMode
Um valor que indica como as métricas de glifo são usadas para medir o texto, quando formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::DrawLine

Desenha uma linha entre os pontos especificados usando o estilo de traço especificado.

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

Parâmetros

ptFrom
O ponto de partida da linha, em pixels independentes do dispositivo.

ptTo
O ponto final da linha, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar o traço da linha.

fStrokeWidth
Um valor maior que ou igual a 0.0f, que especifica a largura do traço. Se esse parâmetro não for especificado, o padrão será 1.0f. O traço está centralizado na linha.

strokeStyle
O estilo de traço a ser pintado ou NULL para pintar uma linha sólida.

CRenderTarget::DrawRectangle

Desenha a estrutura de tópicos de um retângulo que tem as dimensões e o estilo de traço especificados.

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

Parâmetros

rectangle
As dimensões do retângulo a ser desenhado, em pixels independentes do dispositivo

pBrush
O pincel usado para pintar o traço do retângulo

fStrokeWidth
Um valor maior que ou igual a 0.0f, que especifica a largura do traço do retângulo. O traço é centralizado na estrutura de tópicos do retângulo.

strokeStyle
O estilo de traço a ser pintado ou NULL para pintar uma traço sólido.

CRenderTarget::DrawRoundedRectangle

Desenha a estrutura de tópicos do retângulo arredondado especificado usando o estilo de traço especificado.

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

Parâmetros

rectRounded
As dimensões do retângulo arredondado a ser desenhado, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar a estrutura de tópicos do retângulo arredondado.

fStrokeWidth
A largura do traço do retângulo arredondado. O traço é centralizado na estrutura de tópicos do retângulo arredondado. O valor padrão é 1.0f.

strokeStyle
O estilo do traço do retângulo arredondado ou NULL para pintar um traço sólido. O valor padrão é NULL.

CRenderTarget::DrawText

Desenha o texto especificado usando as informações de formato fornecidas por um 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
Um ponteiro para uma matriz de caracteres Unicode a ser desenhada.

rectangle
O tamanho e a posição da área em que o texto é desenhado.

pForegroundBrush
O pincel usado para pintar o texto.

textFormat
Um objeto que descreve os detalhes de formatação do texto a ser desenhado, como a fonte, o tamanho da fonte e a direção do fluxo.

options
Um valor que indica se o texto deve ser ajustado aos limites de pixel e se o texto deve ser recortado no retângulo de layout. O valor padrão é D2D1_DRAW_TEXT_OPTIONS_NONE, o que indica que o texto deve ser ajustado aos limites de pixel e não deve ser recortado no retângulo de layout.

measuringMode
Um valor que indica como as métricas de glifo são usadas para medir o texto, quando formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::DrawTextLayout

Desenha o texto formatado descrito pelo 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
O ponto, descrito em pixels independentes do dispositivo, no qual o canto superior esquerdo do texto descrito por textLayout é desenhado.

textLayout
O texto formatado a ser desenhado. Todos os efeitos de desenho que são herdados do ID2D1Resource são ignorados. Se houver efeitos de desenho herdados do ID2D1Resource que não são pincéis, esse método falhará e o destino de renderização será colocado em um estado de erro.

pBrushForeground
O pincel usado para pintar textos no textLayout que ainda não têm um pincel associado como efeito de desenho (especificado pelo método IDWriteTextLayout::SetDrawingEffect).

CRenderTarget::EndDraw

Encerra as operações de desenho no destino de renderização e indica o estado de erro atual e as marcas associadas.

HRESULT EndDraw();

Valor de retorno

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

CRenderTarget::FillEllipse

Pinta o interior da elipse especificada.

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

Parâmetros

elipse
A posição e o raio da elipse a ser desenhada, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar o interior da elipse.

CRenderTarget::FillGeometry

Pinta o interior da geometria especificada.

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

Parâmetros

pGeometry
A geometria a ser pintada.

pBrush
O pincel usado para pintar o interior da geometria.

pOpacityBrush
A máscara de opacidade a ser aplicada à geometria. NULL para nenhuma máscara de opacidade. Se uma máscara de opacidade (o parâmetro opacityBrush) for especificada, o pincel deve ser um ID2D1BitmapBrush que tenha os modos de extensão x e y definidos como D2D1_EXTEND_MODE_CLAMP. Para obter mais informações, consulte a seção Comentários.

CRenderTarget::FillMesh

Pinta o interior da malha especificada.

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

Parâmetros

pMesh
A malha a ser pintada.

pBrush
O pincel usado para pintar a malha.

CRenderTarget::FillOpacityMask

Aplica a máscara de opacidade descrita pelo bitmap especificado para um pincel e usa esse pincel para pintar uma região do destino de renderização.

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

Parâmetros

pOpacityMask
A posição e o raio da elipse a ser desenhada, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar a região do destino de renderização especificado por destinationRectangle.

content
O tipo de conteúdo que a máscara de opacidade contém. O valor é usado para determinar o espaço de cores em que a máscara de opacidade é combinada.

rectDest
A região do destino de renderização a ser pintado, em pixels independentes do dispositivo.

rectSrc
A região do bitmap a ser usada como a máscara de opacidade, em pixels independentes do dispositivo.

CRenderTarget::FillRectangle

Pinta o interior do retângulo especificado.

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

Parâmetros

rectangle
As dimensões do retângulo a ser pintado, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar o interior do retângulo.

CRenderTarget::FillRoundedRectangle

Pinta o interior do retângulo arredondado especificado.

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

Parâmetros

rectRounded
As dimensões do retângulo arredondado a ser pintado, em pixels independentes do dispositivo.

pBrush
O pincel usado para pintar o interior do retângulo arredondado.

CRenderTarget::Flush

Executa todos os comandos de desenho pendentes.

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

Parâmetros

tag1
Contém a marca para operações de desenho que causaram erros ou 0 se não houver erros. Este parâmetro é passado não inicializado.

tag2
Contém a marca para operações de desenho que causaram erros ou 0 se não houver erros. Este parâmetro é passado não inicializado.

CRenderTarget::GetAntialiasMode

Recupera o modo de suavização atual para operações de desenho que não são texto.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Valor de retorno

O modo de suavização atual para operações de desenho que não são texto.

CRenderTarget::GetDpi

Retorna o DPI (pontos por polegada) do destino de renderização

CD2DSizeF GetDpi() const;

Valor de retorno

O DPI (pontos por polegada) do destino de renderização.

CRenderTarget::GetMaximumBitmapSize

Obtém o tamanho máximo, em unidades dependentes do dispositivo (pixels), de qualquer dimensão de bitmap compatível com o destino de renderização

UINT32 GetMaximumBitmapSize() const;

Valor de retorno

O tamanho máximo, em pixels, de qualquer dimensão de bitmap compatível com o destino de renderização

CRenderTarget::GetPixelFormat

Recupera o formato de pixel e o modo alfa do destino de renderização

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Valor de retorno

O formato de pixel e o modo alfa do destino de renderização

CRenderTarget::GetPixelSize

Retorna o tamanho do destino de renderização em pixels de dispositivo

CD2DSizeU GetPixelSize() const;

Valor de retorno

O tamanho do destino de renderização em pixels de dispositivo

CRenderTarget::GetRenderTarget

Retorna a interface ID2D1RenderTarget

ID2D1RenderTarget* GetRenderTarget();

Valor de retorno

Ponteiro para uma interface ID2D1RenderTarget ou NULL, se o objeto ainda não estiver inicializado.

CRenderTarget::GetSize

Retorna o tamanho do destino de renderização em pixels independentes do dispositivo

CD2DSizeF GetSize() const;

Valor de retorno

O tamanho atual do destino de renderização em pixels independentes do dispositivo

CRenderTarget::GetTags

Obtém o rótulo para operações de desenho subsequentes.

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

Parâmetros

tag1
Contém o primeiro rótulo para operações de desenho subsequentes. Este parâmetro é passado não inicializado. Se NULL for especificado, nenhum valor será recuperado para esse parâmetro.

tag2
Contém o segundo rótulo para operações de desenho subsequentes. Este parâmetro é passado não inicializado. Se NULL for especificado, nenhum valor será recuperado para esse parâmetro.

CRenderTarget::GetTextAntialiasMode

Obtém o modo de suavização atual para operações de desenho de texto e de glifo.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Valor de retorno

O modo de suavização atual para operações de desenho de texto e de glifo.

CRenderTarget::GetTextRenderingParams

Recupera as opções atuais de renderização de texto do destino de renderização.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parâmetros

textRenderingParams
Quando esse método retorna, textRenderingParams contém o endereço de um ponteiro para as opções atuais de renderização de texto do destino de renderização.

CRenderTarget::GetTransform

Obtém a transformação atual do destino de renderização.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parâmetros

transform
Quando isso retorna, contém a transformação atual do destino de renderização. Este parâmetro é passado não inicializado.

CRenderTarget::IsSupported

Indica se o destino de renderização é compatível com as propriedades especificadas

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parâmetros

renderTargetProperties
As propriedades de destino de renderização a serem testadas

Valor de retorno

TRUE, se as propriedades de destino de renderização especificadas forem compatíveis com esse destino de renderização. Caso contrário, FALSE

CRenderTarget::IsValid

Verifica a validade do recurso

BOOL IsValid() const;

Valor de retorno

TRUE se o recurso for válido; caso contrário, FALSE.

CRenderTarget::m_lstResources

Uma lista de ponteiros para os objetos CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Um ponteiro para um objeto ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Um ponteiro para o objeto CD2DTextFormat que contém um formato de texto padrão.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Retorna a interface ID2D1RenderTarget

operator ID2D1RenderTarget*();

Valor de retorno

Ponteiro para uma interface ID2D1RenderTarget ou NULL, se o objeto ainda não estiver inicializado.

CRenderTarget::PopAxisAlignedClip

Remove o último clipe alinhado ao eixo do destino de renderização. Depois que esse método é chamado, o clipe não é mais aplicado às operações de desenho subsequentes.

void PopAxisAlignedClip();

CRenderTarget::PopLayer

Para de redirecionar as operações de desenho para a camada especificada pela última chamada ao PushLayer.

void PopLayer();

CRenderTarget::PushAxisAlignedClip

Remove o último clipe alinhado ao eixo do destino de renderização. Depois que esse método é chamado, o clipe não é mais aplicado às operações de desenho subsequentes.

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

Parâmetros

rectClip
O tamanho e a posição da área de recorte, em pixels independentes do dispositivo.

mode
O modo de suavização usado para desenhar as bordas dos retângulos de clipe que têm limites de subpixel e para combinar o clipe com o conteúdo da cena. A combinação é executada uma vez quando o método PopAxisAlignedClip é chamado e não se aplica a cada primitivo na camada.

CRenderTarget::PushLayer

Adiciona a camada especificada ao destino de renderização para que receba todas as operações de desenho subsequentes até que o PopLayer seja chamado.

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

Parâmetros

layerParameters
Os limites de conteúdo, a máscara geométrica, a opacidade, a máscara de opacidade e as opções de suavização da camada.

layer
A camada que recebe as operações de desenho subsequentes.

CRenderTarget::RestoreDrawingState

Define o estado de desenho do destino de renderização como o do ID2D1DrawingStateBlock especificado.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parâmetros

drawingStateBlock
O novo estado de desenho do destino de renderização.

CRenderTarget::SaveDrawingState

Salva o estado de desenho atual no ID2D1DrawingStateBlock especificado.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parâmetros

drawingStateBlock
Quando esse método retorna, contém o estado de desenho atual do destino de renderização. Esse parâmetro deve ser inicializado antes de ser passado para o método.

CRenderTarget::SetAntialiasMode

Define o modo de suavização do destino de renderização. O modo de suavização se aplica a todas as operações de desenho subsequentes, exceto as operações de desenho de texto e de glifo.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parâmetros

antialiasMode
O modo de suavização para operações de desenho futuras.

CRenderTarget::SetDpi

Define o DPI (pontos por polegada) do destino de renderização.

void SetDpi(const CD2DSizeF& sizeDPI);

Parâmetros

sizeDPI
Um valor maior que ou igual a zero, que especifica o DPI horizontal/vertical do destino de renderização.

CRenderTarget::SetTags

Especifica o rótulo para operações de desenho subsequentes.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parâmetros

tag1
Um rótulo a ser aplicado às operações de desenho subsequentes.

tag2
Um rótulo a ser aplicado às operações de desenho subsequentes.

CRenderTarget::SetTextAntialiasMode

Especifica o modo de suavização a ser usado para operações de desenho de texto e de glifo subsequentes.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parâmetros

textAntialiasMode
Especifica o modo de suavização a ser usado para operações de desenho de texto e de glifo subsequentes.

CRenderTarget::SetTextRenderingParams

Especifica as opções de renderização de texto a serem aplicadas a todas as operações de desenho de texto e glifo subsequentes.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parâmetros

textRenderingParams
As opções de renderização de texto a serem aplicadas a todas as operações de desenho de texto e de glifo subsequentes. NULL para limpar as opções atuais de renderização de texto.

CRenderTarget::SetTransform

Aplica a transformação especificada ao destino de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado.

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

Parâmetros

transform
A transformação a ser aplicada ao destino de renderização.

CRenderTarget::VerifyResource

Verifica a validade do objeto CD2DResource. Cria o objeto, se ainda não existir.

BOOL VerifyResource(CD2DResource* pResource);

Parâmetros

pResource
Ponteiro para o objeto CD2DResource.

Valor de retorno

TRUE é objeto, se válido. Caso contrário, FALSE.

Confira também

Classes

Compartilhar via

Classe CRenderTarget

Sintaxe

Membros

Construtores públicos

Métodos públicos

Métodos protegidos

Operadores públicos

Membros de dados protegidos

Hierarquia de herança

Requisitos

CRenderTarget::~CRenderTarget

CRenderTarget::Attach

Parâmetros

CRenderTarget::BeginDraw

CRenderTarget::Clear

Parâmetros

CRenderTarget::COLORREF_TO_D2DCOLOR

Parâmetros

Valor de retorno

CRenderTarget::CreateCompatibleRenderTarget

Parâmetros

Valor de retorno

CRenderTarget::CRenderTarget

CRenderTarget::Destroy

Parâmetros

Valor de retorno

CRenderTarget::Detach

Valor de retorno

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 de retorno

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 de retorno

CRenderTarget::GetDpi

Valor de retorno

CRenderTarget::GetMaximumBitmapSize

Valor de retorno

CRenderTarget::GetPixelFormat

Valor de retorno

CRenderTarget::GetPixelSize

Valor de retorno

CRenderTarget::GetRenderTarget

Valor de retorno

CRenderTarget::GetSize

Valor de retorno

CRenderTarget::GetTags

Parâmetros

CRenderTarget::GetTextAntialiasMode