UNIFM_HDR Struktur (prntfont.h)

Artikel
02/07/2025

Die UNIFM_HDR Struktur wird verwendet, um den Inhalt Unidrv-Schriftartmetrikendateien (UFM-Dateien) zu definieren.

Syntax

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;

Angehörige

dwSize

Gibt die Gesamtgröße der UFM-Datei in Bytes an. Beachten Sie, dass dies die Gesamtgröße aller Strukturen ist, die zum Definieren der Datei verwendet werden. Dieser Wert ist nicht die Größe der UNIFM_HDR Struktur.

dwVersion

Gibt die Dateiversionsnummer an, wie in prntfont.h durch eine Konstante mit einem Namensformat von UNIFM_VERSION_x_xdefiniert.

ulDefaultCodepage

Gibt den Codeseitenbezeichner für die Standardcodeseite der Schriftart an. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

lGlyphSetDataRCID

Gibt einen RC_GTT Ressourcenbezeichner an, der eine .gtt-Datei (Glyph Translation Table) oder eine der in prntfont.h definierten CC_-Präfix-Codekonvertierungsbezeichner identifiziert. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

loUnidrvInfo

Gibt den Byteoffset vom Anfang der ufm-Datei (Unidrv Font Metrics) an den Speicherort der UNIDRVINFO Struktur der Datei an.

loIFIMetrics

Gibt den Byteoffset vom Anfang der UFM-Datei an den Speicherort der PRINTIFI32 Struktur der Datei an.

loExtTextMetric

Gibt den Byteoffset vom Anfang der UFM-Datei an den Speicherort der EXTTEXTMETRIC Struktur der Datei an.

loWidthTable

Gibt den Byteoffset vom Anfang der UFM-Datei an den Speicherort der WIDTHTABLE Struktur der Datei an.

loKernPair

Gibt den Byteoffset vom Anfang der UFM-Datei an den Speicherort der KERNDATA Struktur der Datei an.

dwReserved[2]

Wird nicht verwendet.

Bemerkungen

Eine UNIFM_HDR Struktur muss die erste Struktur sein, die in einer UFM-Datei enthalten ist.

Wenn lGlyphSetDataRCID- nicht CC_DEFAULT ist, gelten die folgenden Regeln:

Wenn lGlyphSetDataRCID- einen RC_GTT Ressourcenbezeichner enthält, muss die für ulDefaultCodepage angegebene Codeseitennummer dieselbe Codeseitenzahl sein, die in der ersten UNI_CODEPAGEINFO Struktur der Glyphen-Übersetzungstabelle enthalten ist.

Wenn lGlyphSetDataRCID- einen der CC_-präfixierten Codekonvertierungs-IDs (außer CC_DEFAULT) enthält, muss die Codeseitennummer, die für ulDefaultCodepage- angegeben ist, die Codeseitennummer sein, die dem CC_-Präfix-Bezeichner zugeordnet ist. (Diese Codeseitenzahlen werden in Prntfont.h neben jedem CC_-Präfix-Bezeichner aufgeführt.)

Die vom System vordefinierten Zeichenkonvertierungscodes, die in Prntfont.h aufgeführt sind, sind wie folgt:

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

Wenn lGlyphSetDataRCID CC_DEFAULT ist, gibt es keine Einschränkungen für den für ulDefaultCodepageangegebenen Wert, aber eine Standardcodepage muss angegeben werden.