estrutura UNIFM_HDR (prntfont.h)

Artigo
08/07/2023

A estrutura UNIFM_HDR é usada para definir o conteúdo de arquivos de métricas de fonte Unidrv (arquivos.ufm).

Sintaxe

typedef struct _UNIFM_HDR {
  DWORD dwSize;
  DWORD dwVersion;
  ULONG ulDefaultCodepage;
  LONG  lGlyphSetDataRCID;
  DWORD loUnidrvInfo;
  DWORD loIFIMetrics;
  DWORD loExtTextMetric;
  DWORD loWidthTable;
  DWORD loKernPair;
  DWORD dwReserved[2];
} UNIFM_HDR, *PUNIFM_HDR;

Membros

dwSize

Especifica o tamanho total, em bytes, do arquivo .ufm. Observe que esse é o tamanho total de todas as estruturas usadas para definir o arquivo. Esse valor não é o tamanho da estrutura UNIFM_HDR.

dwVersion

Especifica o número de versão do arquivo, conforme definido em prntfont.h por uma constante com um formato de nome de UNIFM_VERSION_x_x.

ulDefaultCodepage

Especifica o identificador de página de código para a página de código padrão da fonte. Para obter mais informações, consulte a seção Comentários a seguir.

lGlyphSetDataRCID

Especifica um identificador de recurso RC_GTT que identifica um arquivo .gtt (Tabela de Tradução de Glifo) ou um dos identificadores de conversão de código prefixados por CC_ definidos em prntfont.h. Para obter mais informações, consulte a seção Comentários a seguir.

loUnidrvInfo

Especifica o deslocamento de bytes do início do arquivo .ufm (Métricas de Fonte Unidrv) para o local da estrutura UNIDRVINFO do arquivo.

loIFIMetrics

Especifica o deslocamento de bytes do início do arquivo .ufm para o local da estrutura PRINTIFI32 do arquivo.

loExtTextMetric

Especifica o deslocamento de bytes do início do arquivo .ufm para o local da estrutura EXTTEXTMETRIC do arquivo.

loWidthTable

Especifica o deslocamento de bytes do início do arquivo .ufm para o local da estrutura WIDTHTABLE do arquivo.

loKernPair

Especifica o deslocamento de bytes do início do arquivo .ufm para o local da estrutura KERNDATA do arquivo.

dwReserved[2]

Não usado.

Comentários

Uma estrutura UNIFM_HDR deve ser a primeira estrutura contida em um arquivo .ufm.

Se lGlyphSetDataRCID não for CC_DEFAULT, as seguintes regras se aplicarão:

Se lGlyphSetDataRCID contiver um identificador de recurso RC_GTT, o número da página de código especificado para ulDefaultCodepage deverá ser o mesmo número de página de código contido na primeira estrutura de UNI_CODEPAGEINFO do arquivo .gtt (Tabela de Tradução de Glifo).

Se lGlyphSetDataRCID contiver um dos identificadores de conversão de código prefixados por CC_ (diferente de CC_DEFAULT), o número da página de código especificado para ulDefaultCodepage deverá ser o número da página de código associado ao identificador prefixado por CC_. (Esses números de página de código são listados em Prntfont.h, ao lado de cada identificador prefixado por CC_.)

Os códigos de conversão de caractere predefinidos pelo sistema, listados em Prntfont.h, são os seguintes:

//
// System predefined character conversion
//
// UNIDRV is going to support  following system predefined character conversion.
// By specifying these number in UNIFM.dwGlyphSetDataRCID;
//

#define CC_NOPRECNV 0x0000FFFF // Not use predefined

//
// ANSI
//
#define CC_DEFAULT  0 // Default Character Conversion
#define CC_CP437   -1 // Unicode to IBM Codepage 437
#define CC_CP850   -2 // Unicode to IBM Codepage 850
#define CC_CP863   -3 // Unicode to IBM Codepage 863

//
// East Asia
//

#define CC_BIG5     -10 // Unicode to Chinese Big 5. Codepage 950.
#define CC_ISC      -11 // Unicode to Korean Industrial Standard. Codepage 949.
#define CC_JIS      -12 // Unicode to JIS X0208. Codepage 932.
#define CC_JIS_ANK  -13 // Unicode to JIS X0208 except ANK. Codepage 932.
#define CC_NS86     -14 // Big-5 to National Standard conversion. Codepage 950
#define CC_TCA      -15 // Big-5 to Taipei Computer Association. Codepage 950.
#define CC_GB2312   -16 // Unicode to GB2312. Codepage 936
#define CC_SJIS     -17 // Unicode to Shift-JIS. Codepage 932.
#define CC_WANSUNG  -18 // Unicode to Extended Wansung. Codepage 949.

Se lGlyphSetDataRCID for CC_DEFAULT, não haverá restrições sobre o valor especificado para ulDefaultCodepage, mas uma página de código padrão deverá ser especificada.