struktur UNIFM_HDR (prntfont.h)

Artikel
02/26/2024

Struktur UNIFM_HDR digunakan untuk menentukan konten file metrik font Unidrv (file.ufm).

Sintaks

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;

Anggota

dwSize

Menentukan ukuran total, dalam byte, dari file .ufm. Perhatikan bahwa ini adalah ukuran total semua struktur yang digunakan untuk menentukan file. Nilai ini bukan ukuran struktur UNIFM_HDR.

dwVersion

Menentukan nomor versi file, seperti yang didefinisikan dalam prntfont.h dengan konstanta dengan format nama UNIFM_VERSION_x_x.

ulDefaultCodepage

Menentukan pengidentifikasi halaman kode untuk halaman kode default font. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

lGlyphSetDataRCID

Menentukan pengidentifikasi sumber daya RC_GTT yang mengidentifikasi file .gtt (Glyph Translation Table), atau salah satu pengidentifikasi konversi kode awalan CC_ yang ditentukan dalam prntfont.h. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

loUnidrvInfo

Menentukan offset byte dari awal file .ufm (Metrik Font Unidrv) ke lokasi struktur UNIDRVINFO file.

loIFIMetrics

Menentukan offset byte dari awal file .ufm ke lokasi struktur PRINTIFI32 file.

loExtTextMetric

Menentukan offset byte dari awal file .ufm ke lokasi struktur EXTTEXTMETRIC file.

loWidthTable

Menentukan offset byte dari awal file .ufm ke lokasi struktur WIDTHTABLE file.

loKernPair

Menentukan offset byte dari awal file .ufm ke lokasi struktur KERNDATA file.

dwReserved[2]

Tidak digunakan.

Keterangan

Struktur UNIFM_HDR harus merupakan struktur pertama yang terkandung dalam file .ufm.

Jika lGlyphSetDataRCID tidak CC_DEFAULT, maka aturan berikut berlaku:

Jika lGlyphSetDataRCID berisi pengidentifikasi sumber daya RC_GTT, nomor halaman kode yang ditentukan untuk ulDefaultCodepage harus merupakan nomor halaman kode yang sama yang terkandung dalam struktur UNI_CODEPAGEINFO pertama file .gtt (Glyph Translation Table).

Jika lGlyphSetDataRCID berisi salah satu pengidentifikasi konversi kode awalan CC_ (selain CC_DEFAULT), nomor halaman kode yang ditentukan untuk ulDefaultCodepage harus berupa nomor halaman kode yang terkait dengan pengidentifikasi awalan CC_. (Nomor halaman kode ini tercantum dalam Prntfont.h, di samping setiap pengidentifikasi awalan CC_.)

Kode konversi karakter yang telah ditentukan sebelumnya oleh sistem, yang tercantum dalam Prntfont.h, adalah sebagai berikut:

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

Jika lGlyphSetDataRCID CC_DEFAULT, tidak ada batasan pada nilai yang ditentukan untuk ulDefaultCodepage, tetapi halaman kode default harus ditentukan.