CDC::GetGlyphOutline

Artigo
02/25/2013

Recupera a curva ou o bitmap estrutura de tópicos para um caractere estrutura de tópicos na fonte atual.

DWORD GetGlyphOutline(
   UINT nChar,
   UINT nFormat,
   LPGLYPHMETRICS lpgm,
   DWORD cbBuffer,
   LPVOID lpBuffer,
   const MAT2* lpmat2
) const;

Parâmetros

nChar
Especifica o caractere para que informações devem ser retornada.

nFormat
Especifica o formato em que a função é retornar informações.Pode ser um dos seguintes valores, ou: 0

Valor	Significado
GGO_BITMAP	Retorna o bitmap de glifos.Quando a função retorna, o buffer apontado por lpBuffer contém um bitmap de bit-por- 1 pixel cujas linhas começa nos limites de palavra composta.
GGO_NATIVE	Retorna os pontos de dados da curva no formato nativo do rasterizador, usando unidades de dispositivo.Quando esse valor é especificado, qualquer transformação especificada em lpmat2 será ignorada.

Quando o valor de nFormat é 0, a função preenche uma estrutura de GLYPHMETRICS mas não retorna dados contorno de glifos.

lpgm
Pontos a estrutura de GLYPHMETRICS que descreve o posicionamento de glifos na célula de caracteres.
cbBuffer
Especifica o tamanho do buffer em que a função copia informações sobre o caractere de estrutura.Se esse valor é 0 e o parâmetro de nFormat são valores de GGO_BITMAP ou de GGO_NATIVE , a função retorna o tamanho do buffer necessário.
lpBuffer
Aponta para um buffer em que a função copia informações sobre o caractere de estrutura.Se nFormat especifica o valor de GGO_NATIVE , a informação é copiada na forma de estruturas de TTPOLYGONHEADER e de TTPOLYCURVE .Se esse valor é NULO e nFormat é o valor de GGO_BITMAP ou de GGO_NATIVE , a função retorna o tamanho do buffer necessário.
lpmat2
Os pontos a MAT2 estrutura que contém uma matriz de transformação para o caractere.Este parâmetro não pode ser NULO, mesmo quando o valor de GGO_NATIVE é especificado para nFormat.

Valor de retorno

O tamanho, em bytes, de buffer necessário para informações recuperadas se cbBuffer é 0 ou lpBuffer é NULO.Caso contrário, é um valor positivo se a função é bem-sucedida, ou – 1 se houver um erro.

Comentários

Um aplicativo pode ativar os caracteres recuperados no formato de bitmap especificando uma matriz de transformação 2 by-2 na estrutura apontada por lpmat2.

Um contorno de glifo é retornado como uma série dos contornos.Cada estrutura é definido por uma estrutura de TTPOLYGONHEADER seguida por tantas estruturas de TTPOLYCURVE como são necessários para descrever.Todos os pontos são retornados como estruturas de POINTFX e representam posições absolutas, move não relacionados.O ponto de partida determinado pelo membro de pfxStart estrutura de TTPOLYGONHEADER é o ponto em que a estrutura para um contorno é iniciado.Estruturas de TTPOLYCURVE que seguem podem ser registros polyline ou registros de spline.Os registros são uma Polyline fx-series de pontos; as linhas desenhadas entre os pontos descrevem o contorno de caracteres.Os registros de spline representam as curvas bézier quadráticas usadas por TrueType (isto é, b- ranhuras quadráticas).