Função GetGlyphOutlineA (wingdi.h)

A função GetGlyphOutline recupera a estrutura de tópicos ou bitmap de um caractere na fonte TrueType selecionada no contexto do dispositivo especificado.

Sintaxe

DWORD GetGlyphOutlineA(
  [in]  HDC            hdc,
  [in]  UINT           uChar,
  [in]  UINT           fuFormat,
  [out] LPGLYPHMETRICS lpgm,
  [in]  DWORD          cjBuffer,
  [out] LPVOID         pvBuffer,
  [in]  const MAT2     *lpmat2
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] uChar

O caractere para o qual os dados devem ser retornados.

[in] fuFormat

O formato dos dados que a função recupera. Esse parâmetro pode ser um dos valores a seguir.

Observe que, para os valores de GGO_GRAYn_BITMAP, a função recupera um bitmap de glifo que contém n^2+1 (n quadrado mais um) níveis de cinza.

[out] lpgm

Um ponteiro para a estrutura de GLIFOMÉTRICA que descreve o posicionamento do glifo na célula de caracteres.

[in] cjBuffer

O tamanho, em bytes, do buffer (*lpvBuffer) em que a função é copiar informações sobre o caractere de estrutura de tópicos. Se esse valor for zero, a função retornará o tamanho necessário do buffer.

[out] pvBuffer

Um ponteiro para o buffer que recebe informações sobre o caractere de estrutura de tópicos. Se esse valor for NULL, a função retornará o tamanho necessário do buffer.

[in] lpmat2

Um ponteiro para uma estrutura MAT2 especificando uma matriz de transformação para o caractere.

Valor de retorno

Se GGO_BITMAP, GGO_GRAY2_BITMAP, GGO_GRAY4_BITMAP, GGO_GRAY8_BITMAP ou GGO_NATIVE for especificado e a função for bem-sucedida, o valor retornado será maior que zero; caso contrário, o valor retornado é GDI_ERROR. Se um desses sinalizadores for especificado e o tamanho ou endereço do buffer for zero, o valor retornado especificará o tamanho do buffer necessário, em bytes.

Se GGO_METRICS for especificado e a função falhar, o valor retornado será GDI_ERROR.

Observações

A estrutura de tópicos de glifo retornada pela função GetGlyphOutline é para um glifo equipado com grade. (Um glifo equipado com grade é um glifo que foi modificado para que sua imagem bitmapped esteja em conformidade o mais próximo possível do design original do glifo.) Se um aplicativo precisar de uma estrutura de tópicos de glifo não modificada, ele poderá solicitar a estrutura de tópicos de glifo para um caractere em uma fonte cujo tamanho seja igual à unidade em da fonte. O valor da unidade em de uma fonte é armazenado no membro otmEMSquare da estrutura de OUTLINETEXTMETRIC.

O bitmap de glifo retornado por GetGlyphOutline quando GGO_BITMAP é especificado é um bitmap monocromático alinhado a DWORD, orientado a linhas. Quando GGO_GRAY2_BITMAP é especificado, o bitmap retornado é uma matriz de bytes alinhada a linhas alinhada a DWORD cujos valores variam de 0 a 4. Quando GGO_GRAY4_BITMAP é especificado, o bitmap retornado é uma matriz de bytes alinhada a linhas alinhada a DWORD cujos valores variam de 0 a 16. Quando GGO_GRAY8_BITMAP é especificado, o bitmap retornado é uma matriz de bytes alinhada a linhas alinhada a DWORD cujos valores variam de 0 a 64.

O buffer nativo retornado por GetGlyphOutline quando GGO_NATIVE é especificado é uma estrutura de tópicos de glifo. Um contorno de glifo é retornado como uma série de um ou mais contornos definidos por uma estrutura TTPOLYGONHEADER seguida por uma ou mais curvas. Cada curva no contorno é definida por uma estrutura TTPOLYCURVE seguida por uma série de pontos de dados POINTFX . pontos POINTFX são posições absolutas, não movimentos relativos. O ponto de partida de um contorno é fornecido pelo membro pfxStart da estrutura TTPOLYGONHEADER. O ponto inicial de cada curva é o último ponto da curva anterior ou o ponto inicial do contorno. A contagem de pontos de dados em uma curva é armazenada no cpfx membro da estrutura TTPOLYCURVE. O tamanho de cada contorno no buffer, em bytes, é armazenado no membro cb de estrutura TTPOLYGONHEADER. Definições de curva adicionais são empacotadas no buffer após as curvas anteriores e contornos adicionais são empacotados no buffer após os contornos anteriores. O buffer contém quantos contornos forem ajustados dentro do buffer retornado por GetGlyphOutline .

A estrutura GLIFOMÉTRICA especifica a largura da célula de caracteres e o local de um glifo dentro da célula de caractere. A origem da célula de caractere está localizada no lado esquerdo da célula na linha de base da fonte. O local da origem do glifo é relativo à origem da célula de caractere. A altura de uma célula de caractere, a linha de base e outras métricas globais para a fonte são fornecidas pela estrutura de OUTLINETEXTMETRIC.

Um aplicativo pode alterar os caracteres recuperados em formato bitmap ou nativo especificando uma matriz de transformação 2 por 2 no parâmetro lpMatrix. Por exemplo, o glifo pode ser modificado por tesoura, rotação, dimensionamento ou qualquer combinação dos três usando multiplicação de matriz.

Informações adicionais sobre estruturas de tópicos de glifo estão localizadas nas especificações técnicas TrueType e OpenType.

Requisitos

Consulte também

ExtTextOut

FORM_INFO_1

Funções de fonte e texto

fontes e visão geral de texto

GLIFOMÉTRICO

GetOutlineTextMetrics

MAT2

OUTLINETEXTMETRIC

POINT

POINTFX

TTPOLYCURVE

TTPOLYGONHEADER