Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.
Um wrapper para ID2D1RenderTarget.
Sintaxe
class CRenderTarget : public CObject;
Membros
Construtores Públicos
| Nome | Description |
|---|---|
| CRenderTarget::CRenderTarget | Constrói um objeto CRenderTarget. |
| CRenderTarget::~CRenderTarget | O destruidor. É chamado quando um objeto de renderização está a ser destruído. |
Métodos Públicos
| Nome | Description |
|---|---|
| CRenderTarget::Anexar | Anexa a interface de render target existente ao objeto |
| CRenderTarget::BeginDraw | Inicia o desenho neste alvo de renderização. |
| CRenderTarget::Limpar | Limpa a área de desenho para a cor especificada. |
| CRenderTarget::COLORREF_TO_D2DCOLOR | Converte os valores de cor e alfa do GDI para o objeto D2D1_COLOR_F. |
| CRenderTarget::CreateCompatibleRenderTarget | Cria um novo alvo de renderização bitmap para uso durante desenhos intermédios fora do ecrã, compatível com o alvo de renderização atual. |
| AlvoCrítico: :D estroy | Elimina um ou mais recursos |
| CRenderTarget::D etach | Desliga a interface de renderização do alvo do objeto |
| CRenderTarget::D rawBitmap | Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado. |
| CRenderTarget::D rawEllipse | Desenha o contorno da elipse especificada usando o estilo de traço especificado. |
| CRenderTarget::D rawGeometry | Desenha o contorno da geometria especificada usando o estilo de traço especificado. |
| CRenderTarget::D rawGlyphRun | Desenha os glifos especificados. |
| CRenderTarget::D rawLine | Traça uma linha entre os pontos especificados usando o estilo de traço especificado. |
| CRenderTarget::D rawRetângulo | Desenha o contorno de um retângulo com as dimensões e o estilo de traço especificados. |
| CRenderTarget::D rawRoundedRectangleT | Desenha o contorno do retângulo arredondado especificado usando o estilo de traço especificado. |
| CRenderTarget::D rawText | Desenha o texto especificado usando a informação de formato fornecida por um objeto IDWriteTextFormat. |
| CRenderTarget::D rawTextLayout | Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado. |
| CRenderTarget::EndDraw | Termina as operações de desenho no alvo de renderização e indica o estado atual do erro e as etiquetas 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::Máscara de OpacidadeDe Preenchimento | Aplica a máscara de opacidade descrita pelo bitmap especificado a um pincel e usa esse pincel para pintar uma região do alvo de renderização. |
| CRenderTarget::FillRectangle | Pinta o interior do retângulo especificado. |
| CRenderTarget::RetânguloDeArredondado Preenchido | Pinta o interior do retângulo arredondado especificado. |
| CRenderTarget::Flush | Executa todos os comandos de desenho pendentes. |
| CRenderTarget::GetAntialiasMode | Recupera o modo de anti-aliasing atual para operações de desenho não textuais. |
| CRenderTarget::GetDpi | Devolve os pontos por polegada (DPI) do alvo de renderização |
| CRenderTarget::GetMaximumBitmapSize | Obtém o tamanho máximo, em unidades dependentes do dispositivo (píxeis), de qualquer dimensão bitmap suportada pelo alvo de renderização |
| CRenderTarget::GetPixelFormat | Recupera o formato de píxeis e o modo alfa do alvo de renderização |
| CRenderTarget::ObténTamanhoPixelPixel | Devolve o tamanho do alvo de renderização em pixels do dispositivo |
| CRenderTarget::GetRenderTarget | Devolve a interface ID2D1RenderTarget |
| CRenderTarget::GetSize | Devolve o tamanho do alvo de renderização em píxeis independentes do dispositivo |
| CRenderTarget::GetTags | Recebe a etiqueta para operações de desenho subsequentes. |
| CRenderTarget::GetTextAntialiasMode | Recebe o modo de antialiasing atual para operações de desenho de texto e glifos. |
| CRenderTarget::GetTextRenderingParams | Recupera as opções atuais de renderização de texto do alvo de renderização. |
| CRenderTarget::GetTransform | Aplica a transformação especificada ao alvo 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 alvo de renderização suporta as propriedades especificadas |
| CRenderTarget::IsValid | Verifica a validade dos recursos |
| CRenderTarget::P opAxisAlignedClip | Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes. |
| CRenderTarget::P opLayer | Deixa de redirecionar as operações de desenho para a camada especificada pela última chamada PushLayer. |
| CRenderTarget::P ushAxisAlignedClip | Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes. |
| CRenderTarget::P ushLayer | Adiciona a camada especificada ao alvo 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 alvo de renderização para o ID2D1DrawingStateBlock especificado. |
| CRenderTarget::SaveDrawingState | Guarda o estado atual do desenho no ID2D1DrawingStateBlock especificado. |
| CRenderTarget::SetAntialiasMode | Define o modo de antialiasing do alvo de renderização. O modo de antialiasing aplica-se a todas as operações de desenho subsequentes, excluindo as operações de desenho de texto e glifos. |
| CRenderTarget::SetDpi | Define os pontos por polegada (DPI) do alvo de renderização. |
| CRenderTarget::SetTags | Especifica uma etiqueta para operações de desenho subsequentes. |
| CRenderTarget::SetTextAntialiasMode | Especifica o modo de antialiasing a usar para operações subsequentes de desenho de texto e glifos. |
| CRenderTarget::SetTextRenderingParams | Especifica opções de renderização de texto a serem aplicadas a todas as operações subsequentes de desenho de texto e glifos. |
| CRenderTarget::SetTransform | Sobrecarregado. Aplica a transformação especificada ao alvo de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado. |
Métodos Protegidos
| Nome | Description |
|---|---|
| CRenderTarget::VerifyResource | Verifica a validade do objeto CD2DResource; cria o objeto se este ainda não existisse. |
Operadores Públicos
| Nome | Description |
|---|---|
| CRenderTarget::operator ID2D1RenderTarget* | Devolve a interface ID2D1RenderTarget |
Membros de Dados Protegidos
| Nome | Description |
|---|---|
| CRenderTarget::m_lstResources | Uma lista de apontadores para objetos CD2DResource. |
| CRenderTarget::m_pRenderTarget | Um ponteiro para um objeto ID2D1RenderTarget. |
| CRenderTarget::m_pTextFormatDefault | Um apontador para o objeto CD2DTextFormat que contém um formato de texto predefinido. |
Hierarquia de herança
Requerimentos
Cabeçalho: afxrendertarget.h
CRenderTarget::~CRenderTarget
O destruidor. É chamado quando um objeto de renderização está a ser destruído.
virtual ~CRenderTarget();
CRenderTarget::Anexar
Anexa a interface de render target existente ao objeto
void Attach(ID2D1RenderTarget* pRenderTarget);
Parâmetros
pRenderTarget
Interface de renderização já existente. Não pode ser NULL
CRenderTarget::BeginDraw
Inicia o desenho neste alvo de renderização.
void BeginDraw();
CRenderTarget::Limpar
Limpa a área de desenho para a cor especificada.
void Clear(D2D1_COLOR_F color);
Parâmetros
cor
A cor para a qual a área de desenho é limpa.
CRenderTarget::COLORREF_TO_D2DCOLOR
Converte os valores de cor e alfa do GDI para o objeto D2D1_COLOR_F.
static D2D1_COLOR_F COLORREF_TO_D2DCOLOR(
COLORREF color,
int nAlpha = 255);
Parâmetros
cor
Valor RGB.
nAlpha
Valor de retorno
D2D1_COLOR_F valor.
CRenderTarget::CreateCompatibleRenderTarget
Cria um novo alvo de renderização bitmap para uso durante desenhos intermédios fora do ecrã, compatível com o alvo 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 este método retorna, contém o endereço de um ponteiro para um novo alvo de renderização bitmap. Este parâmetro é passado sem inicializar.
tamanhoDesejado
O tamanho desejado do novo alvo de renderização em píxeis independentes do dispositivo, caso seja diferente do alvo de renderização original, ou NULL. Para obter mais informações, consulte a seção Observações.
tamanhoPixelDesejado
O tamanho desejado do novo alvo de renderização em pixels se for diferente do alvo original, ou NULL. Para obter mais informações, consulte a seção Observações.
desiredFormato
O formato de píxel desejado e o modo alfa do novo alvo de renderização, ou NULL. Se o formato de píxel estiver definido para DXGI_FORMAT_UNKNOWN ou se este parâmetro for nulo, o novo alvo de renderização usa o mesmo formato de píxel do alvo original. Se o modo alfa for D2D1_ALPHA_MODE_UNKNOWN ou este parâmetro for NULL, o modo alfa do novo destino de renderização passa por defeito a D2D1_ALPHA_MODE_PREMULTIPLIED. Para informações sobre formatos de píxeis suportados, consulte Formatos de Píxeis Suportados e Modos Alfa.
Opções
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 tiver sucesso, devolve VERDADEIRO. Caso contrário, devolve FALSE.
CRenderTarget::CRenderTarget
Constrói um objeto CRenderTarget.
CRenderTarget();
AlvoCrítico: :D estroy
Elimina um ou mais recursos
BOOL Destroy(BOOL bDeleteResources = TRUE);
Parâmetros
bDeleteResources
Se o bDeleteResources for VERDADEIRO, todos os recursos localizados no m_lstResources serão automaticamente destruídos.
Valor de retorno
Se o método tiver sucesso, devolve VERDADEIRO. Caso contrário, devolve FALSE
CRenderTarget::D etach
Desliga a interface de renderização do alvo do objeto
ID2D1RenderTarget* Detach ();
Valor de retorno
Apontador para a interface de renderização de destino separada.
CRenderTarget::D rawBitmap
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 para renderizar.
rectDest
O tamanho e a posição, em píxeis independentes do dispositivo no espaço coordenado do alvo de renderização, da área para onde o bitmap é desenhado. Se o retângulo não estiver bem ordenado, nada é desenhado, mas o alvo de renderização não entra num estado de erro.
fOpacidade
Um valor entre 0,0f e 1,0f, inclusive, que especifica um valor de opacidade a aplicar ao bitmap; Este valor é multiplicado pelos valores alfa do conteúdo do bitmap.
interpolationMode
O modo de interpolação a usar se o bitmap for escalado ou rodado pela operação de desenho.
pRectSrc
O tamanho e a posição, em píxeis independentes do dispositivo no espaço de coordenadas do bitmap, da área dentro do bitmap a desenhar.
CRenderTarget::D rawEllipse
Desenha o contorno 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 desenhar, em píxeis independentes do dispositivo.
pBrush
O pincel usado para pintar o contorno da elipse.
fStrokeWidth
A espessura do traço da elipse. O traço está centrado no contorno da elipse.
Estilo stroke
O estilo de traço para aplicar no contorno da elipse, ou NULL para pintar um traço sólido.
CRenderTarget::D rawGeometry
Desenha o contorno 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
pGeometria
A geometria a desenhar.
pBrush
O pincel usado para pintar o traço da geometria.
fStrokeWidth
A espessura do traço da geometria. O traço está centrado no contorno da geometria.
Estilo stroke
O estilo de traço para aplicar ao contorno da geometria, ou NULL para pintar um traço sólido.
CRenderTarget::D rawGlyphRun
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 píxeis independentes do dispositivo, da linha base dos glifos.
glyphRun
Os glifos a renderizar.
pForegroundBrush
O pincel usado para pintar os glifos especificados.
Modo de medição
Um valor que indica como as métricas de glifos são usadas para medir o texto quando este é formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.
CRenderTarget::D rawLine
Traça 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 início da linha, em píxeis independentes do dispositivo.
ptTo
O ponto final da linha, em píxeis independentes do dispositivo.
pBrush
O pincel usado para pintar o traço da linha.
fStrokeWidth
Um valor maior ou igual a 0,0f que especifica a largura do traço. Se este parâmetro não for especificado, por defeito é 1.0f. O traço está centrado na linha.
Estilo stroke
O estilo de traço para pintar, ou NULL para pintar uma linha sólida.
CRenderTarget::D rawRetângulo
Desenha o contorno de um retângulo com 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
retângulo
As dimensões do retângulo a desenhar, em píxeis independentes do dispositivo
pBrush
O pincel usado para pintar a pincelada do retângulo
fStrokeWidth
Um valor maior ou igual a 0,0f que especifica a largura do traço do retângulo. O traço está centrado no contorno do retângulo.
Estilo stroke
O estilo de traço para pintar, ou NULL para pintar um traço sólido.
CRenderTarget::D rawRoundedRectangleT
Desenha o contorno 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 desenhar, em píxeis independentes do dispositivo.
pBrush
O pincel usado para pintar o contorno do retângulo arredondado.
fStrokeWidth
A largura do traço do retângulo arredondado. O traço está centrado no contorno do retângulo arredondado. O valor padrão é 1.0f.
Estilo stroke
O estilo do traço do retângulo arredondado, ou NULL para pintar um traço sólido. O valor padrão é NULL.
CRenderTarget::D rawText
Desenha o texto especificado usando a informação de formato fornecida 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 apontador para um array de caracteres Unicode para desenhar.
retângulo
O tamanho e a posição da área onde o texto é desenhado.
pForegroundBrush
O pincel usado para pintar o texto.
textFormat
Um objeto que descreve detalhes de formatação do texto a desenhar, como a fonte, o tamanho da fonte e a direção do fluxo.
Opções
Um valor que indica se o texto deve ser ajustado aos limites dos píxeis e se o texto deve ser recortado ao retângulo do layout. O valor predefinido é D2D1_DRAW_TEXT_OPTIONS_NONE, o que indica que o texto deve ser encaixado nos limites dos píxeis e não deve ser recortado ao retângulo do layout.
Modo de medição
Um valor que indica como as métricas de glifos são usadas para medir o texto quando este é formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.
CRenderTarget::D rawTextLayout
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 píxeis independentes do dispositivo, onde o canto superior esquerdo do texto descrito por textLayout é desenhado.
textLayout
O texto formatado para desenhar. Quaisquer efeitos de desenho que não herdem do ID2D1Resource são ignorados. Se houver efeitos de desenho que herdam do ID2D1Resource e que não são escovas, este método falha e o alvo de renderização fica num estado de erro.
pBrushForeground
O pincel usado para pintar qualquer texto em textLayout que não tenha já um pincel associado como efeito de desenho (especificado pelo método IDWriteTextLayout::SetDrawingEffect).
Opções
Um valor que indica se o texto deve ser ajustado aos limites dos píxeis e se o texto deve ser recortado ao retângulo do layout. O valor predefinido é D2D1_DRAW_TEXT_OPTIONS_NONE, o que indica que o texto deve ser encaixado nos limites dos píxeis e não deve ser recortado ao retângulo do layout.
CRenderTarget::EndDraw
Termina as operações de desenho no alvo de renderização e indica o estado atual do erro e as etiquetas associadas.
HRESULT EndDraw();
Valor de retorno
Se o método tiver sucesso, ele devolve S_OK. Caso contrário, devolve 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, em píxeis independentes do dispositivo, da elipse a pintar.
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
pGeometria
A geometria para pintar.
pBrush
O pincel usado para pintar o interior da geometria.
pOpacityBrush
A máscara de opacidade a aplicar à geometria; NULL para não usar máscara de opacidade. Se for especificada uma máscara de opacidade (o parâmetro opacityBrush), o brush deve ser um ID2D1BitmapBrush que tenha os modos x- e y-extend definidos para D2D1_EXTEND_MODE_CLAMP. Para obter mais informações, consulte a seção Observações.
CRenderTarget::FillMesh
Pinta o interior da malha especificada.
void FillMesh(
CD2DMesh* pMesh,
CD2DBrush* pBrush);
Parâmetros
pMesh
A malha para pintar.
pBrush
O pincel usado para pintar a rede.
CRenderTarget::Máscara de OpacidadeDe Preenchimento
Aplica a máscara de opacidade descrita pelo bitmap especificado a um pincel e usa esse pincel para pintar uma região do alvo 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, em píxeis independentes do dispositivo, da elipse a pintar.
pBrush
O pincel usado para pintar a região do alvo de renderização especificada por destinationRectangle.
Conteúdo
O tipo de conteúdo que a máscara de opacidade contém. O valor é usado para determinar o espaço de cor em que a máscara de opacidade é misturada.
rectDest
A região do alvo de renderização a pintar, em píxeis independentes do dispositivo.
rectSrc
A região do bitmap a usar como máscara de opacidade, em píxeis independentes do dispositivo.
CRenderTarget::FillRectangle
Pinta o interior do retângulo especificado.
void FillRectangle(
const CD2DRectF& rectangle,
CD2DBrush* pBrush);
Parâmetros
retângulo
A dimensão do retângulo para pintar, em píxeis independentes do dispositivo.
pBrush
O pincel usado para pintar o interior do retângulo.
CRenderTarget::RetânguloDeArredondado Preenchido
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 para pintar, em píxeis 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 etiqueta para operações de desenho que causaram erros ou 0 se não houvesse erros. Este parâmetro é passado sem inicializar.
tag2
Contém a etiqueta para operações de desenho que causaram erros ou 0 se não houvesse erros. Este parâmetro é passado sem inicializar.
CRenderTarget::GetAntialiasMode
Recupera o modo de anti-aliasing atual para operações de desenho não textuais.
D2D1_ANTIALIAS_MODE GetAntialiasMode() const;
Valor de retorno
Modo de antialiasing atual para operações de desenho sem texto.
CRenderTarget::GetDpi
Devolve os pontos por polegada (DPI) do alvo de renderização
CD2DSizeF GetDpi() const;
Valor de retorno
Os pontos por polegada (DPI) do alvo de renderização.
CRenderTarget::GetMaximumBitmapSize
Obtém o tamanho máximo, em unidades dependentes do dispositivo (píxeis), de qualquer dimensão bitmap suportada pelo alvo de renderização
UINT32 GetMaximumBitmapSize() const;
Valor de retorno
O tamanho máximo, em pixels, de qualquer dimensão bitmap suportada pelo alvo de renderização
CRenderTarget::GetPixelFormat
Recupera o formato de píxeis e o modo alfa do alvo de renderização
D2D1_PIXEL_FORMAT GetPixelFormat() const;
Valor de retorno
O formato de píxeis e o modo alfa do alvo de renderização
CRenderTarget::ObténTamanhoPixelPixel
Devolve o tamanho do alvo de renderização em pixels do dispositivo
CD2DSizeU GetPixelSize() const;
Valor de retorno
O tamanho do alvo de renderização em pixels do dispositivo
CRenderTarget::GetRenderTarget
Devolve a interface ID2D1RenderTarget
ID2D1RenderTarget* GetRenderTarget();
Valor de retorno
Apontar para uma interface ID2D1RenderTarget ou NULL se o objeto ainda não estiver inicializado.
CRenderTarget::GetSize
Devolve o tamanho do alvo de renderização em píxeis independentes do dispositivo
CD2DSizeF GetSize() const;
Valor de retorno
O tamanho atual do alvo de renderização em píxeis independentes do dispositivo
CRenderTarget::GetTags
Recebe a etiqueta para operações de desenho subsequentes.
void GetTags(
D2D1_TAG* tag1 = NULL,
D2D1_TAG* tag2 = NULL) const;
Parâmetros
tag1
Contém a primeira etiqueta para operações de desenho subsequentes. Este parâmetro é passado sem inicializar. Se NULL for especificado, nenhum valor é recuperado para este parâmetro.
tag2
Contém a segunda etiqueta para operações de desenho subsequentes. Este parâmetro é passado sem inicializar. Se NULL for especificado, nenhum valor é recuperado para este parâmetro.
CRenderTarget::GetTextAntialiasMode
Recebe o modo de antialiasing atual para operações de desenho de texto e glifos.
D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;
Valor de retorno
Modo de antialiasing atual para operações de desenho de texto e glifos.
CRenderTarget::GetTextRenderingParams
Recupera as opções atuais de renderização de texto do alvo de renderização.
void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);
Parâmetros
textRenderingParams
Quando este método regressa, textRenderingParámetros contém o endereço de um ponteiro para as opções atuais de renderização do texto do destino de renderização.
CRenderTarget::GetTransform
Obtém a transformação atual do alvo de renderização.
void GetTransform(D2D1_MATRIX_3X2_F* transform);
Parâmetros
transformar
Quando este retorna, contém a transformação atual do alvo de renderização. Este parâmetro é passado sem inicializar.
CRenderTarget::IsSupported
Indica se o alvo de renderização suporta as propriedades especificadas
BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;
Parâmetros
renderTargetProperties
As propriedades do alvo de renderização a testar
Valor de retorno
TRUE se as propriedades especificadas do alvo de renderização forem suportadas por este alvo de renderização; caso contrário, FALSO
CRenderTarget::IsValid
Verifica a validade dos recursos
BOOL IsValid() const;
Valor de retorno
TRUE se o recurso for válido; caso contrário, FALSO.
CRenderTarget::m_lstResources
Uma lista de apontadores para objetos CD2DResource.
CObList m_lstResources;
CRenderTarget::m_pRenderTarget
Um ponteiro para um objeto ID2D1RenderTarget.
ID2D1RenderTarget* m_pRenderTarget;
CRenderTarget::m_pTextFormatDefault
Um apontador para o objeto CD2DTextFormat que contém um formato de texto predefinido.
CD2DTextFormat* m_pTextFormatDefault;
CRenderTarget::operator ID2D1RenderTarget*
Devolve a interface ID2D1RenderTarget
operator ID2D1RenderTarget*();
Valor de retorno
Apontar para uma interface ID2D1RenderTarget ou NULL se o objeto ainda não estiver inicializado.
CRenderTarget::P opAxisAlignedClip
Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes.
void PopAxisAlignedClip();
CRenderTarget::P opLayer
Deixa de redirecionar as operações de desenho para a camada especificada pela última chamada PushLayer.
void PopLayer();
CRenderTarget::P ushAxisAlignedClip
Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser 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 clipping, em píxeis independentes do dispositivo.
mode
O modo de antialiasing usado para desenhar as bordas dos retângulos dos clipes que têm limites subpixels, e para misturar o clip com o conteúdo da cena. A fusão é realizada uma vez quando o método PopAxisAlignedClip é chamado, e não se aplica a cada primitiva dentro da camada.
CRenderTarget::P ushLayer
Adiciona a camada especificada ao alvo 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, máscara geométrica, opacidade, máscara de opacidade e opções de antialiasing para a camada.
Camada
A camada que recebe operações de desenho subsequentes.
CRenderTarget::RestoreDrawingState
Define o estado de desenho do alvo de renderização para o ID2D1DrawingStateBlock especificado.
void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);
Parâmetros
desenhoEstadoBloco
O novo estado de desenho do alvo de renderização.
CRenderTarget::SaveDrawingState
Guarda o estado atual do desenho no ID2D1DrawingStateBlock especificado.
void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;
Parâmetros
desenhoEstadoBloco
Quando este método regressa, contém o estado de desenho atual do alvo de renderização. Este parâmetro deve ser inicializado antes de o passar ao método.
CRenderTarget::SetAntialiasMode
Define o modo de antialiasing do alvo de renderização. O modo de antialiasing aplica-se a todas as operações de desenho subsequentes, excluindo as operações de desenho de texto e glifos.
void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);
Parâmetros
antialiasMode
O modo de antialiasing para futuras operações de desenho.
CRenderTarget::SetDpi
Define os pontos por polegada (DPI) do alvo de renderização.
void SetDpi(const CD2DSizeF& sizeDPI);
Parâmetros
tamanhoDPI
Um valor maior ou igual a zero que especifica o DPI horizontal/vertical do alvo de renderização.
CRenderTarget::SetTags
Especifica uma etiqueta para operações de desenho subsequentes.
void SetTags(
D2D1_TAG tag1,
D2D1_TAG tag2);
Parâmetros
tag1
Um rótulo para aplicar em operações de desenho subsequentes.
tag2
Um rótulo para aplicar em operações de desenho subsequentes.
CRenderTarget::SetTextAntialiasMode
Especifica o modo de antialiasing a usar para operações subsequentes de desenho de texto e glifos.
void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);
Parâmetros
textAntialiasMode
O modo de antialiasing para usar em operações subsequentes de desenho de texto e glifos.
CRenderTarget::SetTextRenderingParams
Especifica opções de renderização de texto a serem aplicadas a todas as operações subsequentes de desenho de texto e glifos.
void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);
Parâmetros
textRenderingParams
As opções de renderização de texto a serem aplicadas a todas as operações subsequentes de desenho de texto e glifos; NULL para limpar as opções atuais de renderização de texto.
CRenderTarget::SetTransform
Aplica a transformação especificada ao alvo 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
transformar
A transformação para aplicar ao alvo de renderização.
CRenderTarget::VerifyResource
Verifica a validade do objeto CD2DResource; cria o objeto se este ainda não existisse.
BOOL VerifyResource(CD2DResource* pResource);
Parâmetros
pResource
Apontador para o objeto CD2DResource.
Valor de retorno
TRUE é objeto se for válido; caso contrário, FALSO.