Documentation for TranslateCharsetInfo.

include/wingdi.h

@@ -394,6 +394,18 @@ DECL_WINELIB_TYPE_AW(ENUMLOGFONT)
 DECL_WINELIB_TYPE_AW(LPENUMLOGFONT)
 DECL_WINELIB_TYPE_AW(LPENUMLOGFONTEX)
 
+/*
+ * The FONTSIGNATURE tells which Unicode ranges and which code pages
+ * have glyphs in a font.
+ *
+ * fsUsb  128-bit bitmap. The most significant bits are 10 (magic number).
+ *        The remaining 126 bits map the Unicode ISO 10646 subranges
+ *        for which the font provides glyphs.
+ *
+ * fsCsb  64-bit bitmap. The low 32 bits map the Windows codepages for
+ *        which the font provides glyphs. The high 32 bits are for 
+ *        non Windows codepages.
+ */
 typedef struct
 {
   DWORD fsUsb[4];
@@ -402,11 +414,17 @@ typedef struct
 
 typedef struct 
 {
-  UINT32	ciCharset;
+  UINT32	ciCharset; /* character set */
-  UINT32	ciACP;
+  UINT32	ciACP; /* ANSI code page */
   FONTSIGNATURE	fs;
 } CHARSETINFO,*LPCHARSETINFO;
 
+/* Flags for TranslateCharsetInfo */
+/* FIXME */
+#define TCI_SRCCHARSET 
+#define TCI_SRCCODEPAGE
+#define TCI_SRCFONTSIG
+
 /* Flags for ModifyWorldTransform */
 #define MWT_IDENTITY      1
 #define MWT_LEFTMULTIPLY  2

objects/font.c

@@ -1339,10 +1339,32 @@ DWORD WINAPI GetKerningPairs32W( HDC32 hDC, DWORD cPairs,
 }
 
 /*************************************************************************
- * TranslateCharSetInfo [GDI32.382]
+ * TranslateCharsetInfo [GDI32.382]
+ *
+ * Fills a CHARSETINFO structure for a character set, code page, or
+ * font. This allows making the correspondance between different labelings
+ * (character set, Windows, ANSI, and OEM codepages, and Unicode ranges) 
+ * of the same encoding.
+ *
+ * Only one codepage will be set in lpCs->fs. If TCI_SRCFONTSIG is used,
+ * only one codepage should be set in *lpSrc.
+ *
+ * RETURNS
+ *   TRUE on success, FALSE on failure.
+ *
+ * BUGS
+ *  Not implemented.
  */
-BOOL32 WINAPI TranslateCharSetInfo(LPDWORD lpSrc,LPCHARSETINFO lpCs,DWORD dwFlags) {
+BOOL32 WINAPI TranslateCharsetInfo(
-    FIXME(font,"(%p,%p,0x%08lx), stub.\n",lpSrc,lpCs,dwFlags);
+  LPDWORD lpSrc, /*
+       if flags == TCI_SRCFONTSIG: pointer to fsCsb of a FONTSIGNATURE
+       if flags == TCI_SRCCHARSET: a character set value
+       if flags == TCI_SRCCODEPAGE: a code page value
+		 */
+  LPCHARSETINFO lpCs, /* structure to receive charset information */
+  DWORD flags /* determines interpretation of lpSrc */
+) {
+    FIXME(font,"(%p,%p,0x%08lx), stub.\n",lpSrc,lpCs, flags);
     return TRUE;
 }
 

relay32/gdi32.spec

@@ -385,7 +385,7 @@ init	MAIN_GdiInit
 379 stub GdiWinWatchOpen
 380 stub GetGlyphOutlineWow
 381 stdcall GetTextCharsetInfo(long ptr long) GetTextCharsetInfo
-382 stdcall TranslateCharsetInfo(ptr ptr long) TranslateCharSetInfo
+382 stdcall TranslateCharsetInfo(ptr ptr long) TranslateCharsetInfo
 383 stub UpdateICMRegKeyA
 384 stub UpdateICMRegKeyW
 385 stub gdiPlaySpoolStream