estructura UNIFM_HDR (prntfont.h)

Artículo
03/05/2024

La estructura UNIFM_HDR se usa para definir el contenido de los archivos de métricas de fuente Unidrv (archivos .ufm).

Sintaxis

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;

Miembros

dwSize

Especifica el tamaño total, en bytes, del archivo .ufm. Tenga en cuenta que este es el tamaño total de todas las estructuras usadas para definir el archivo. Este valor no es el tamaño de la estructura UNIFM_HDR.

dwVersion

Especifica el número de versión del archivo, tal y como se define en prntfont.h mediante una constante con un formato de nombre de UNIFM_VERSION_x_x.

ulDefaultCodepage

Especifica el identificador de página de códigos de la página de códigos predeterminada de la fuente. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

lGlyphSetDataRCID

Especifica un identificador de recurso de RC_GTT que identifica un archivo .gtt (tabla de traducción de glifos) o uno de los identificadores de conversión de código con prefijo CC_ definidos en prntfont.h. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

loUnidrvInfo

Especifica el desplazamiento de bytes desde el principio del archivo .ufm (Unidrv Font Metrics) en la ubicación de la estructura UNIDRVINFO del archivo.

loIFIMetrics

Especifica el desplazamiento de bytes desde el principio del archivo .ufm hasta la ubicación de la estructura de PRINTIFI32 del archivo.

loExtTextMetric

Especifica el desplazamiento de bytes desde el principio del archivo .ufm hasta la ubicación de la estructura EXTTEXTMETRIC del archivo.

loWidthTable

Especifica el desplazamiento de bytes desde el principio del archivo .ufm hasta la ubicación de la estructura WIDTHTABLE del archivo.

loKernPair

Especifica el desplazamiento de bytes desde el principio del archivo .ufm hasta la ubicación de la estructura KERNDATA del archivo.

dwReserved[2]

No se usa.

Comentarios

Una estructura UNIFM_HDR debe ser la primera estructura contenida en un archivo .ufm.

Si lGlyphSetDataRCID no es CC_DEFAULT, se aplican las reglas siguientes:

Si lGlyphSetDataRCID contiene un identificador de recurso RC_GTT, el número de página de códigos especificado para ulDefaultCodepage debe ser el mismo número de página de códigos que se encuentra en la primera estructura de UNI_CODEPAGEINFO del archivo .gtt (tabla de traducción de glifos).

Si lGlyphSetDataRCID contiene uno de los identificadores de conversión de código con prefijo CC_ (distintos de CC_DEFAULT), el número de página de códigos especificado para ulDefaultCodepage debe ser el número de página de códigos asociado al identificador CC_ prefijo. (Estos números de página de códigos se enumeran en Prntfont.h, junto a cada identificador con prefijo CC_).

Los códigos de conversión de caracteres predefinidos por el sistema, enumerados en Prntfont.h, son los siguientes:

//
// 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.

Si lGlyphSetDataRCID es CC_DEFAULT, no hay restricciones en el valor especificado para ulDefaultCodepage, pero se debe especificar una página de códigos predeterminada.