UNIFM_HDR structure (prntfont.h)

Article
02/27/2024

La structure UNIFM_HDR est utilisée pour définir le contenu des fichiers de métriques de police Unidrv (fichiers .ufm).

Syntaxe

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;

Membres

dwSize

Spécifie la taille totale, en octets, du fichier .ufm. Notez qu’il s’agit de la taille totale de toutes les structures utilisées pour définir le fichier. Cette valeur n’est pas la taille de la structure UNIFM_HDR.

dwVersion

Spécifie le numéro de version du fichier, tel que défini dans prntfont.h par une constante au format de nom UNIFM_VERSION_x_x.

ulDefaultCodepage

Spécifie l’identificateur de la page de codes de la page de codes par défaut de la police. Pour plus d'informations, consultez la section Notes qui suit.

lGlyphSetDataRCID

Spécifie un identificateur de ressource RC_GTT qui identifie un fichier .gtt (table de traduction de glyphes) ou l’un des identificateurs de conversion de code préfixés CC_ définis dans prntfont.h. Pour plus d'informations, consultez la section Notes qui suit.

loUnidrvInfo

Spécifie le décalage d’octets entre le début du fichier .ufm (Unidrv Font Metrics) et l’emplacement de la structure UNIDRVINFO du fichier.

loIFIMetrics

Spécifie le décalage d’octets entre le début du fichier .ufm et l’emplacement de la structure PRINTIFI32 du fichier.

loExtTextMetric

Spécifie le décalage d’octets entre le début du fichier .ufm et l’emplacement de la structure EXTTEXTMETRIC du fichier.

loWidthTable

Spécifie le décalage d’octets entre le début du fichier .ufm et l’emplacement de la structure WIDTHTABLE du fichier.

loKernPair

Spécifie le décalage d’octets entre le début du fichier .ufm et l’emplacement de la structure KERNDATA du fichier.

dwReserved[2]

Non utilisé.

Notes

Une structure UNIFM_HDR doit être la première structure contenue dans un fichier .ufm.

Si lGlyphSetDataRCID n’est pas CC_DEFAULT, les règles suivantes s’appliquent :

Si lGlyphSetDataRCID contient un identificateur de ressource RC_GTT, le numéro de page de codes spécifié pour ulDefaultCodepage doit être le même numéro de page de codes que celui contenu dans la première structure UNI_CODEPAGEINFO du fichier .gtt (Glyph Translation Table).

Si lGlyphSetDataRCID contient l’un des identificateurs de conversion de code avec préfixe CC_ (autres que CC_DEFAULT), le numéro de page de codes spécifié pour ulDefaultCodepage doit être le numéro de page de codes associé à l’identificateur à préfixe CC_. (Ces numéros de page de codes sont répertoriés dans Prntfont.h, en regard de chaque identificateur préfixé par CC_.)

Les codes de conversion de caractères prédéfinis par le système, répertoriés dans Prntfont.h, sont les suivants :

//
// 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 est CC_DEFAULT, il n’existe aucune restriction sur la valeur spécifiée pour ulDefaultCodepage, mais une page de codes par défaut doit être spécifiée.