UNIFM_HDR struttura (prntfont.h)

Articolo
08/07/2023

La struttura UNIFM_HDR viene usata per definire il contenuto dei file di metriche dei tipi di carattere Unidrv (file ufm).

Sintassi

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;

Members

dwSize

Specifica le dimensioni totali, in byte, del file ufm. Si noti che questa è la dimensione totale di tutte le strutture usate per definire il file. Questo valore non è la dimensione della struttura UNIFM_HDR.

dwVersion

Specifica il numero di versione del file, come definito in prntfont.h da una costante con un formato nome di UNIFM_VERSION_x_x.

ulDefaultCodepage

Specifica l'identificatore della tabella codici per la tabella codici predefinita del tipo di carattere. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

lGlyphSetDataRCID

Specifica un identificatore di risorsa RC_GTT che identifica un file con estensione gtt (tabella di traduzione glifi) o uno degli identificatori di conversione del codice con prefisso CC_ definiti in prntfont.h. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

loUnidrvInfo

Specifica l'offset di byte dall'inizio del file Ufm (Unidrv Font Metrics) al percorso della struttura UNIDRVINFO del file.

loIFIMetrics

Specifica l'offset di byte dall'inizio del file con estensione ufm al percorso della struttura PRINTIFI32 del file.

loExtTextMetric

Specifica l'offset di byte dall'inizio del file ufm al percorso della struttura EXTTEXTMETRIC del file.

loWidthTable

Specifica l'offset di byte dall'inizio del file con estensione ufm al percorso della struttura WIDTHTABLE del file.

loKernPair

Specifica l'offset di byte dall'inizio del file ufm al percorso della struttura KERNDATA del file.

dwReserved[2]

Non usato.

Commenti

Una struttura UNIFM_HDR deve essere la prima struttura contenuta in un file ufm.

Se lGlyphSetDataRCID non è CC_DEFAULT, si applicano le regole seguenti:

Se lGlyphSetDataRCID contiene un identificatore di risorsa RC_GTT, il numero di pagina codici specificato per ulDefaultCodepage deve essere lo stesso numero di tabella codici contenuto nella struttura di primo UNI_CODEPAGEINFO del file .gtt (tabella Glyph Translation).

Se lGlyphSetDataRCID contiene uno degli identificatori di conversione del codice con prefisso CC_ (diverso da CC_DEFAULT), il numero di pagina codici specificato per ulDefaultCodepage deve essere il numero di tabella codici associato all'identificatore con prefisso CC_. Questi numeri di tabella codici sono elencati in Prntfont.h, accanto a ogni identificatore con prefisso CC_.

I codici di conversione dei caratteri predefiniti dal sistema, elencati in Prntfont.h, sono i seguenti:

//
// 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 è CC_DEFAULT, non esistono restrizioni sul valore specificato per ulDefaultCodepage, ma è necessario specificare una tabella codici predefinita.