2 * "$Id: transcode.c 7560 2008-05-13 06:34:04Z mike $"
4 * Transcoding support for CUPS.
6 * Copyright 2007-2010 by Apple Inc.
7 * Copyright 1997-2007 by Easy Software Products.
9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * which should have been included with this file. If this file is
13 * file is missing or damaged, see the license at "http://www.cups.org/".
15 * This file is subject to the Apple OS-Developed Software exception.
19 * _cupsCharmapFlush() - Flush all character set maps out of cache.
20 * _cupsCharmapFree() - Free a character set map.
21 * _cupsCharmapGet() - Get a character set map.
22 * cupsCharsetToUTF8() - Convert legacy character set to UTF-8.
23 * cupsUTF8ToCharset() - Convert UTF-8 to legacy character set.
24 * cupsUTF8ToUTF32() - Convert UTF-8 to UTF-32.
25 * cupsUTF32ToUTF8() - Convert UTF-32 to UTF-8.
26 * compare_wide() - Compare key for wide (VBCS) match.
27 * conv_sbcs_to_utf8() - Convert legacy SBCS to UTF-8.
28 * conv_utf8_to_sbcs() - Convert UTF-8 to legacy SBCS.
29 * conv_utf8_to_vbcs() - Convert UTF-8 to legacy DBCS/VBCS.
30 * conv_vbcs_to_utf8() - Convert legacy DBCS/VBCS to UTF-8.
31 * free_sbcs_charmap() - Free memory used by a single byte character set.
32 * free_vbcs_charmap() - Free memory used by a variable byte character set.
33 * get_charmap() - Lookup or get a character set map (private).
34 * get_charmap_count() - Count lines in a charmap file.
35 * get_sbcs_charmap() - Get SBCS Charmap.
36 * get_vbcs_charmap() - Get DBCS/VBCS Charmap.
40 * Include necessary headers...
43 #include "cups-private.h"
54 static pthread_mutex_t map_mutex
= PTHREAD_MUTEX_INITIALIZER
;
55 /* Mutex to control access to maps */
56 #endif /* HAVE_PTHREAD_H */
57 static _cups_cmap_t
*cmap_cache
= NULL
;
58 /* SBCS Charmap Cache */
59 static _cups_vmap_t
*vmap_cache
= NULL
;
60 /* VBCS Charmap Cache */
67 static int compare_wide(const void *k1
, const void *k2
);
68 static int conv_sbcs_to_utf8(cups_utf8_t
*dest
,
69 const cups_sbcs_t
*src
,
71 const cups_encoding_t encoding
);
72 static int conv_utf8_to_sbcs(cups_sbcs_t
*dest
,
73 const cups_utf8_t
*src
,
75 const cups_encoding_t encoding
);
76 static int conv_utf8_to_vbcs(cups_sbcs_t
*dest
,
77 const cups_utf8_t
*src
,
79 const cups_encoding_t encoding
);
80 static int conv_vbcs_to_utf8(cups_utf8_t
*dest
,
81 const cups_sbcs_t
*src
,
83 const cups_encoding_t encoding
);
84 static void free_sbcs_charmap(_cups_cmap_t
*sbcs
);
85 static void free_vbcs_charmap(_cups_vmap_t
*vbcs
);
86 static void *get_charmap(const cups_encoding_t encoding
);
87 static int get_charmap_count(cups_file_t
*fp
);
88 static _cups_cmap_t
*get_sbcs_charmap(const cups_encoding_t encoding
,
89 const char *filename
);
90 static _cups_vmap_t
*get_vbcs_charmap(const cups_encoding_t encoding
,
91 const char *filename
);
95 * '_cupsCharmapFlush()' - Flush all character set maps out of cache.
99 _cupsCharmapFlush(void)
101 _cups_cmap_t
*cmap
, /* Legacy SBCS / Unicode Charset Map */
102 *cnext
; /* Next Legacy SBCS Charset Map */
103 _cups_vmap_t
*vmap
, /* Legacy VBCS / Unicode Charset Map */
104 *vnext
; /* Next Legacy VBCS Charset Map */
107 #ifdef HAVE_PTHREAD_H
108 pthread_mutex_lock(&map_mutex
);
109 #endif /* HAVE_PTHREAD_H */
112 * Loop through SBCS charset map cache, free all memory...
115 for (cmap
= cmap_cache
; cmap
; cmap
= cnext
)
119 free_sbcs_charmap(cmap
);
125 * Loop through DBCS/VBCS charset map cache, free all memory...
128 for (vmap
= vmap_cache
; vmap
; vmap
= vnext
)
132 free_vbcs_charmap(vmap
);
137 #ifdef HAVE_PTHREAD_H
138 pthread_mutex_unlock(&map_mutex
);
139 #endif /* HAVE_PTHREAD_H */
144 * '_cupsCharmapFree()' - Free a character set map.
146 * This does not actually free; use '_cupsCharmapFlush()' for that.
151 const cups_encoding_t encoding
) /* I - Encoding */
153 _cups_cmap_t
*cmap
; /* Legacy SBCS / Unicode Charset Map */
154 _cups_vmap_t
*vmap
; /* Legacy VBCS / Unicode Charset Map */
158 * See if we already have this SBCS charset map loaded...
161 #ifdef HAVE_PTHREAD_H
162 pthread_mutex_lock(&map_mutex
);
163 #endif /* HAVE_PTHREAD_H */
165 for (cmap
= cmap_cache
; cmap
; cmap
= cmap
->next
)
167 if (cmap
->encoding
== encoding
)
176 * See if we already have this DBCS/VBCS charset map loaded...
179 for (vmap
= vmap_cache
; vmap
; vmap
= vmap
->next
)
181 if (vmap
->encoding
== encoding
)
189 #ifdef HAVE_PTHREAD_H
190 pthread_mutex_unlock(&map_mutex
);
191 #endif /* HAVE_PTHREAD_H */
196 * '_cupsCharmapGet()' - Get a character set map.
198 * This code handles single-byte (SBCS), double-byte (DBCS), and
199 * variable-byte (VBCS) character sets _without_ charset escapes...
200 * This code does not handle multiple-byte character sets (MBCS)
201 * (such as ISO-2022-JP) with charset switching via escapes...
204 void * /* O - Charset map pointer */
206 const cups_encoding_t encoding
) /* I - Encoding */
208 void *charmap
; /* Charset map pointer */
211 DEBUG_printf(("7_cupsCharmapGet(encoding=%d)", encoding
));
214 * Check for valid arguments...
217 if (encoding
< 0 || encoding
>= CUPS_ENCODING_VBCS_END
)
219 DEBUG_puts("8_cupsCharmapGet: Bad encoding, returning NULL!");
224 * Lookup or get the charset map pointer and return...
227 #ifdef HAVE_PTHREAD_H
228 pthread_mutex_lock(&map_mutex
);
229 #endif /* HAVE_PTHREAD_H */
231 charmap
= get_charmap(encoding
);
233 #ifdef HAVE_PTHREAD_H
234 pthread_mutex_unlock(&map_mutex
);
235 #endif /* HAVE_PTHREAD_H */
242 * 'cupsCharsetToUTF8()' - Convert legacy character set to UTF-8.
244 * This code handles single-byte (SBCS), double-byte (DBCS), and
245 * variable-byte (VBCS) character sets _without_ charset escapes...
246 * This code does not handle multiple-byte character sets (MBCS)
247 * (such as ISO-2022-JP) with charset switching via escapes...
250 int /* O - Count or -1 on error */
252 cups_utf8_t
*dest
, /* O - Target string */
253 const char *src
, /* I - Source string */
254 const int maxout
, /* I - Max output */
255 const cups_encoding_t encoding
) /* I - Encoding */
257 int bytes
; /* Number of bytes converted */
261 * Check for valid arguments...
264 DEBUG_printf(("2cupsCharsetToUTF8(dest=%p, src=\"%s\", maxout=%d, encoding=%d)",
265 dest
, src
, maxout
, encoding
));
270 if (!dest
|| !src
|| maxout
< 1 || maxout
> CUPS_MAX_USTRING
)
272 DEBUG_puts("3cupsCharsetToUTF8: Bad arguments, returning -1");
277 * Handle identity conversions...
280 if (encoding
== CUPS_UTF8
||
281 encoding
< 0 || encoding
>= CUPS_ENCODING_VBCS_END
)
283 strlcpy((char *)dest
, src
, maxout
);
284 return ((int)strlen((char *)dest
));
288 * Handle ISO-8859-1 to UTF-8 directly...
291 if (encoding
== CUPS_ISO8859_1
)
293 int ch
; /* Character from string */
294 cups_utf8_t
*destptr
, /* Pointer into UTF-8 buffer */
295 *destend
; /* End of UTF-8 buffer */
299 destend
= dest
+ maxout
- 2;
301 while (*src
&& destptr
< destend
)
307 *destptr
++ = 0xc0 | (ch
>> 6);
308 *destptr
++ = 0x80 | (ch
& 0x3f);
316 return ((int)(destptr
- dest
));
320 * Convert input legacy charset to UTF-8...
323 #ifdef HAVE_PTHREAD_H
324 pthread_mutex_lock(&map_mutex
);
325 #endif /* HAVE_PTHREAD_H */
327 if (encoding
< CUPS_ENCODING_SBCS_END
)
328 bytes
= conv_sbcs_to_utf8(dest
, (cups_sbcs_t
*)src
, maxout
, encoding
);
330 bytes
= conv_vbcs_to_utf8(dest
, (cups_sbcs_t
*)src
, maxout
, encoding
);
332 #ifdef HAVE_PTHREAD_H
333 pthread_mutex_unlock(&map_mutex
);
334 #endif /* HAVE_PTHREAD_H */
341 * 'cupsUTF8ToCharset()' - Convert UTF-8 to legacy character set.
343 * This code handles single-byte (SBCS), double-byte (DBCS), and
344 * variable-byte (VBCS) character sets _without_ charset escapes...
345 * This code does not handle multiple-byte character sets (MBCS)
346 * (such as ISO-2022-JP) with charset switching via escapes...
349 int /* O - Count or -1 on error */
351 char *dest
, /* O - Target string */
352 const cups_utf8_t
*src
, /* I - Source string */
353 const int maxout
, /* I - Max output */
354 const cups_encoding_t encoding
) /* I - Encoding */
356 int bytes
; /* Number of bytes converted */
360 * Check for valid arguments...
363 if (!dest
|| !src
|| maxout
< 1 || maxout
> CUPS_MAX_USTRING
)
372 * Handle identity conversions...
375 if (encoding
== CUPS_UTF8
||
376 encoding
< 0 || encoding
>= CUPS_ENCODING_VBCS_END
)
378 strlcpy(dest
, (char *)src
, maxout
);
379 return ((int)strlen(dest
));
383 * Handle UTF-8 to ISO-8859-1 directly...
386 if (encoding
== CUPS_ISO8859_1
)
388 int ch
; /* Character from string */
389 char *destptr
, /* Pointer into ISO-8859-1 buffer */
390 *destend
; /* End of ISO-8859-1 buffer */
394 destend
= dest
+ maxout
- 1;
396 while (*src
&& destptr
< destend
)
400 if ((ch
& 0xe0) == 0xc0)
402 ch
= ((ch
& 0x1f) << 6) | (*src
++ & 0x3f);
409 else if ((ch
& 0xf0) == 0xe0 ||
412 else if (!(ch
& 0x80))
418 return ((int)(destptr
- dest
));
422 * Convert input UTF-8 to legacy charset...
425 #ifdef HAVE_PTHREAD_H
426 pthread_mutex_lock(&map_mutex
);
427 #endif /* HAVE_PTHREAD_H */
429 if (encoding
< CUPS_ENCODING_SBCS_END
)
430 bytes
= conv_utf8_to_sbcs((cups_sbcs_t
*)dest
, src
, maxout
, encoding
);
432 bytes
= conv_utf8_to_vbcs((cups_sbcs_t
*)dest
, src
, maxout
, encoding
);
434 #ifdef HAVE_PTHREAD_H
435 pthread_mutex_unlock(&map_mutex
);
436 #endif /* HAVE_PTHREAD_H */
443 * 'cupsUTF8ToUTF32()' - Convert UTF-8 to UTF-32.
445 * 32-bit UTF-32 (actually 21-bit) maps to UTF-8 as follows...
447 * UTF-32 char UTF-8 char(s)
448 * --------------------------------------------------
449 * 0 to 127 = 0xxxxxxx (US-ASCII)
450 * 128 to 2047 = 110xxxxx 10yyyyyy
451 * 2048 to 65535 = 1110xxxx 10yyyyyy 10zzzzzz
452 * > 65535 = 11110xxx 10yyyyyy 10zzzzzz 10xxxxxx
454 * UTF-32 prohibits chars beyond Plane 16 (> 0x10ffff) in UCS-4,
455 * which would convert to five- or six-octet UTF-8 sequences...
458 int /* O - Count or -1 on error */
460 cups_utf32_t
*dest
, /* O - Target string */
461 const cups_utf8_t
*src
, /* I - Source string */
462 const int maxout
) /* I - Max output */
464 int i
; /* Looping variable */
465 cups_utf8_t ch
; /* Character value */
466 cups_utf8_t next
; /* Next character value */
467 cups_utf32_t ch32
; /* UTF-32 character value */
471 * Check for valid arguments and clear output...
474 DEBUG_printf(("2cupsUTF8ToUTF32(dest=%p, src=\"%s\", maxout=%d)", dest
,
480 if (!dest
|| !src
|| maxout
< 1 || maxout
> CUPS_MAX_USTRING
)
482 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad arguments)");
488 * Convert input UTF-8 to output UTF-32...
491 for (i
= maxout
- 1; *src
&& i
> 0; i
--)
496 * Convert UTF-8 character(s) to UTF-32 character...
502 * One-octet UTF-8 <= 127 (US-ASCII)...
507 DEBUG_printf(("4cupsUTF8ToUTF32: %02x => %08X", src
[-1], ch
));
510 else if ((ch
& 0xe0) == 0xc0)
513 * Two-octet UTF-8 <= 2047 (Latin-x)...
517 if ((next
& 0xc0) != 0x80)
519 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
524 ch32
= ((ch
& 0x1f) << 6) | (next
& 0x3f);
527 * Check for non-shortest form (invalid UTF-8)...
532 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
539 DEBUG_printf(("4cupsUTF8ToUTF32: %02x %02x => %08X",
540 src
[-2], src
[-1], (unsigned)ch32
));
542 else if ((ch
& 0xf0) == 0xe0)
545 * Three-octet UTF-8 <= 65535 (Plane 0 - BMP)...
549 if ((next
& 0xc0) != 0x80)
551 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
556 ch32
= ((ch
& 0x0f) << 6) | (next
& 0x3f);
559 if ((next
& 0xc0) != 0x80)
561 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
566 ch32
= (ch32
<< 6) | (next
& 0x3f);
569 * Check for non-shortest form (invalid UTF-8)...
574 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
581 DEBUG_printf(("4cupsUTF8ToUTF32: %02x %02x %02x => %08X",
582 src
[-3], src
[-2], src
[-1], (unsigned)ch32
));
584 else if ((ch
& 0xf8) == 0xf0)
587 * Four-octet UTF-8...
591 if ((next
& 0xc0) != 0x80)
593 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
598 ch32
= ((ch
& 0x07) << 6) | (next
& 0x3f);
601 if ((next
& 0xc0) != 0x80)
603 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
608 ch32
= (ch32
<< 6) | (next
& 0x3f);
611 if ((next
& 0xc0) != 0x80)
613 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
618 ch32
= (ch32
<< 6) | (next
& 0x3f);
621 * Check for non-shortest form (invalid UTF-8)...
626 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
633 DEBUG_printf(("4cupsUTF8ToUTF32: %02x %02x %02x %02x => %08X",
634 src
[-4], src
[-3], src
[-2], src
[-1], (unsigned)ch32
));
639 * More than 4-octet (invalid UTF-8 sequence)...
642 DEBUG_puts("3cupsUTF8ToUTF32: Returning -1 (bad UTF-8 sequence)");
648 * Check for UTF-16 surrogate (illegal UTF-8)...
651 if (ch32
>= 0xd800 && ch32
<= 0xdfff)
657 DEBUG_printf(("3cupsUTF8ToUTF32: Returning %d characters", maxout
- 1 - i
));
659 return (maxout
- 1 - i
);
664 * 'cupsUTF32ToUTF8()' - Convert UTF-32 to UTF-8.
666 * 32-bit UTF-32 (actually 21-bit) maps to UTF-8 as follows...
668 * UTF-32 char UTF-8 char(s)
669 * --------------------------------------------------
670 * 0 to 127 = 0xxxxxxx (US-ASCII)
671 * 128 to 2047 = 110xxxxx 10yyyyyy
672 * 2048 to 65535 = 1110xxxx 10yyyyyy 10zzzzzz
673 * > 65535 = 11110xxx 10yyyyyy 10zzzzzz 10xxxxxx
675 * UTF-32 prohibits chars beyond Plane 16 (> 0x10ffff) in UCS-4,
676 * which would convert to five- or six-octet UTF-8 sequences...
679 int /* O - Count or -1 on error */
681 cups_utf8_t
*dest
, /* O - Target string */
682 const cups_utf32_t
*src
, /* I - Source string */
683 const int maxout
) /* I - Max output */
685 cups_utf8_t
*start
; /* Start of destination string */
686 int i
; /* Looping variable */
687 int swap
; /* Byte-swap input to output */
688 cups_utf32_t ch
; /* Character value */
692 * Check for valid arguments and clear output...
695 DEBUG_printf(("2cupsUTF32ToUTF8(dest=%p, src=%p, maxout=%d)", dest
, src
,
701 if (!dest
|| !src
|| maxout
< 1)
703 DEBUG_puts("3cupsUTF32ToUTF8: Returning -1 (bad args)");
709 * Check for leading BOM in UTF-32 and inverted BOM...
713 swap
= *src
== 0xfffe0000;
715 DEBUG_printf(("4cupsUTF32ToUTF8: swap=%d", swap
));
717 if (*src
== 0xfffe0000 || *src
== 0xfeff)
721 * Convert input UTF-32 to output UTF-8...
724 for (i
= maxout
- 1; *src
&& i
> 0;)
729 * Byte swap input UTF-32, if necessary...
730 * (only byte-swapping 24 of 32 bits)
734 ch
= ((ch
>> 24) | ((ch
>> 8) & 0xff00) | ((ch
<< 8) & 0xff0000));
737 * Check for beyond Plane 16 (invalid UTF-32)...
742 DEBUG_puts("3cupsUTF32ToUTF8: Returning -1 (character out of range)");
748 * Convert UTF-32 character to UTF-8 character(s)...
754 * One-octet UTF-8 <= 127 (US-ASCII)...
757 *dest
++ = (cups_utf8_t
)ch
;
760 DEBUG_printf(("4cupsUTF32ToUTF8: %08x => %02x", (unsigned)ch
, dest
[-1]));
765 * Two-octet UTF-8 <= 2047 (Latin-x)...
770 DEBUG_puts("3cupsUTF32ToUTF8: Returning -1 (too long 2)");
775 *dest
++ = (cups_utf8_t
)(0xc0 | ((ch
>> 6) & 0x1f));
776 *dest
++ = (cups_utf8_t
)(0x80 | (ch
& 0x3f));
779 DEBUG_printf(("4cupsUTF32ToUTF8: %08x => %02x %02x", (unsigned)ch
,
780 dest
[-2], dest
[-1]));
782 else if (ch
< 0x10000)
785 * Three-octet UTF-8 <= 65535 (Plane 0 - BMP)...
790 DEBUG_puts("3cupsUTF32ToUTF8: Returning -1 (too long 3)");
795 *dest
++ = (cups_utf8_t
)(0xe0 | ((ch
>> 12) & 0x0f));
796 *dest
++ = (cups_utf8_t
)(0x80 | ((ch
>> 6) & 0x3f));
797 *dest
++ = (cups_utf8_t
)(0x80 | (ch
& 0x3f));
800 DEBUG_printf(("4cupsUTF32ToUTF8: %08x => %02x %02x %02x", (unsigned)ch
,
801 dest
[-3], dest
[-2], dest
[-1]));
806 * Four-octet UTF-8...
811 DEBUG_puts("3cupsUTF32ToUTF8: Returning -1 (too long 4)");
816 *dest
++ = (cups_utf8_t
)(0xf0 | ((ch
>> 18) & 0x07));
817 *dest
++ = (cups_utf8_t
)(0x80 | ((ch
>> 12) & 0x3f));
818 *dest
++ = (cups_utf8_t
)(0x80 | ((ch
>> 6) & 0x3f));
819 *dest
++ = (cups_utf8_t
)(0x80 | (ch
& 0x3f));
822 DEBUG_printf(("4cupsUTF32ToUTF8: %08x => %02x %02x %02x %02x",
823 (unsigned)ch
, dest
[-4], dest
[-3], dest
[-2], dest
[-1]));
829 DEBUG_printf(("3cupsUTF32ToUTF8: Returning %d", (int)(dest
- start
)));
831 return ((int)(dest
- start
));
836 * 'compare_wide()' - Compare key for wide (VBCS) match.
840 compare_wide(const void *k1
, /* I - Key char */
841 const void *k2
) /* I - Map char */
843 cups_vbcs_t key
; /* Legacy key character */
844 cups_vbcs_t map
; /* Legacy map character */
847 key
= *((cups_vbcs_t
*)k1
);
848 map
= ((_cups_wide2uni_t
*)k2
)->widechar
;
850 return ((int)(key
- map
));
855 * 'conv_sbcs_to_utf8()' - Convert legacy SBCS to UTF-8.
858 static int /* O - Count or -1 on error */
860 cups_utf8_t
*dest
, /* O - Target string */
861 const cups_sbcs_t
*src
, /* I - Source string */
862 int maxout
, /* I - Max output */
863 const cups_encoding_t encoding
) /* I - Encoding */
865 _cups_cmap_t
*cmap
; /* Legacy SBCS / Unicode Charset Map */
866 cups_ucs2_t
*crow
; /* Pointer to UCS-2 row in 'char2uni' */
867 cups_sbcs_t legchar
; /* Legacy character value */
868 cups_utf32_t work
[CUPS_MAX_USTRING
], /* Internal UCS-4 string */
869 *workptr
; /* Pointer into string */
873 * Find legacy charset map in cache...
876 if ((cmap
= (_cups_cmap_t
*)get_charmap(encoding
)) == NULL
)
880 * Convert input legacy charset to internal UCS-4 (and insert BOM)...
884 for (workptr
= work
+ 1; *src
&& workptr
< (work
+ CUPS_MAX_USTRING
- 1);)
889 * Convert ASCII verbatim (optimization)...
893 *workptr
++ = (cups_utf32_t
)legchar
;
897 * Convert unknown character to Replacement Character...
900 crow
= cmap
->char2uni
+ legchar
;
905 *workptr
++ = (cups_utf32_t
)*crow
;
912 * Convert internal UCS-4 to output UTF-8 (and delete BOM)...
917 return (cupsUTF32ToUTF8(dest
, work
, maxout
));
922 * 'conv_utf8_to_sbcs()' - Convert UTF-8 to legacy SBCS.
925 static int /* O - Count or -1 on error */
927 cups_sbcs_t
*dest
, /* O - Target string */
928 const cups_utf8_t
*src
, /* I - Source string */
929 int maxout
, /* I - Max output */
930 const cups_encoding_t encoding
) /* I - Encoding */
932 cups_sbcs_t
*start
; /* Start of destination string */
933 _cups_cmap_t
*cmap
; /* Legacy SBCS / Unicode Charset Map */
934 cups_sbcs_t
*srow
; /* Pointer to SBCS row in 'uni2char' */
935 cups_utf32_t unichar
; /* Character value */
936 cups_utf32_t work
[CUPS_MAX_USTRING
], /* Internal UCS-4 string */
937 *workptr
; /* Pointer into string */
941 * Find legacy charset map in cache...
944 if ((cmap
= (_cups_cmap_t
*)get_charmap(encoding
)) == NULL
)
948 * Convert input UTF-8 to internal UCS-4 (and insert BOM)...
951 if (cupsUTF8ToUTF32(work
, src
, CUPS_MAX_USTRING
) < 0)
955 * Convert internal UCS-4 to SBCS legacy charset (and delete BOM)...
958 for (workptr
= work
, start
= dest
; *workptr
&& maxout
> 0; maxout
--)
960 unichar
= *workptr
++;
965 * Convert ASCII verbatim (optimization)...
970 *dest
++ = (cups_sbcs_t
)unichar
;
975 * Convert unknown character to visible replacement...
978 srow
= cmap
->uni2char
[(int)((unichar
>> 8) & 0xff)];
981 srow
+= (int)(unichar
& 0xff);
993 return ((int)(dest
- start
));
998 * 'conv_utf8_to_vbcs()' - Convert UTF-8 to legacy DBCS/VBCS.
1001 static int /* O - Count or -1 on error */
1003 cups_sbcs_t
*dest
, /* O - Target string */
1004 const cups_utf8_t
*src
, /* I - Source string */
1005 int maxout
, /* I - Max output */
1006 const cups_encoding_t encoding
) /* I - Encoding */
1008 cups_sbcs_t
*start
; /* Start of destination string */
1009 _cups_vmap_t
*vmap
; /* Legacy DBCS / Unicode Charset Map */
1010 cups_vbcs_t
*vrow
; /* Pointer to VBCS row in 'uni2char' */
1011 cups_utf32_t unichar
; /* Character value */
1012 cups_vbcs_t legchar
; /* Legacy character value */
1013 cups_utf32_t work
[CUPS_MAX_USTRING
], /* Internal UCS-4 string */
1014 *workptr
; /* Pointer into string */
1017 DEBUG_printf(("7conv_utf8_to_vbcs(dest=%p, src=\"%s\", maxout=%d, "
1018 "encoding=%d)", dest
, src
, maxout
, encoding
));
1021 * Find legacy charset map in cache...
1024 if ((vmap
= (_cups_vmap_t
*)get_charmap(encoding
)) == NULL
)
1026 DEBUG_puts("8conv_utf8_to_vbcs: Returning -1 (no charmap)");
1032 * Convert input UTF-8 to internal UCS-4 (and insert BOM)...
1035 if (cupsUTF8ToUTF32(work
, src
, CUPS_MAX_USTRING
) < 0)
1037 DEBUG_puts("8conv_utf8_to_vbcs: Returning -1 (Unable to convert to UTF-32)");
1043 * Convert internal UCS-4 to VBCS legacy charset (and delete BOM)...
1046 for (start
= dest
, workptr
= work
; *workptr
&& maxout
> 0; maxout
--)
1048 unichar
= *workptr
++;
1051 * Convert ASCII verbatim (optimization)...
1056 *dest
++ = (cups_sbcs_t
)unichar
;
1058 DEBUG_printf(("9conv_utf8_to_vbcs: %08x => %02X", (unsigned)unichar
,
1065 * Convert unknown character to visible replacement...
1068 vrow
= vmap
->uni2char
[(int)((unichar
>> 8) & 0xff)];
1071 vrow
+= (int)(unichar
& 0xff);
1073 if (!vrow
|| !*vrow
)
1074 legchar
= (cups_vbcs_t
)'?';
1076 legchar
= (cups_vbcs_t
)*vrow
;
1079 * Save n-byte legacy character...
1082 if (legchar
> 0xffffff)
1086 DEBUG_puts("8conv_utf8_to_vbcs: Returning -1 (out of space)");
1091 *dest
++ = (cups_sbcs_t
)(legchar
>> 24);
1092 *dest
++ = (cups_sbcs_t
)(legchar
>> 16);
1093 *dest
++ = (cups_sbcs_t
)(legchar
>> 8);
1094 *dest
++ = (cups_sbcs_t
)legchar
;
1098 DEBUG_printf(("9conv_utf8_to_vbcs: %08x => %02X %02X %02X %02X",
1099 (unsigned)unichar
, dest
[-4], dest
[-3], dest
[-2], dest
[-1]));
1101 else if (legchar
> 0xffff)
1105 DEBUG_puts("8conv_utf8_to_vbcs: Returning -1 (out of space)");
1110 *dest
++ = (cups_sbcs_t
)(legchar
>> 16);
1111 *dest
++ = (cups_sbcs_t
)(legchar
>> 8);
1112 *dest
++ = (cups_sbcs_t
)legchar
;
1116 DEBUG_printf(("9conv_utf8_to_vbcs: %08x => %02X %02X %02X",
1117 (unsigned)unichar
, dest
[-3], dest
[-2], dest
[-1]));
1119 else if (legchar
> 0xff)
1121 *dest
++ = (cups_sbcs_t
)(legchar
>> 8);
1122 *dest
++ = (cups_sbcs_t
)legchar
;
1126 DEBUG_printf(("9conv_utf8_to_vbcs: %08x => %02X %02X",
1127 (unsigned)unichar
, dest
[-2], dest
[-1]));
1131 *dest
++ = (cups_sbcs_t
)legchar
;
1133 DEBUG_printf(("9conv_utf8_to_vbcs: %08x => %02X",
1134 (unsigned)unichar
, dest
[-1]));
1142 DEBUG_printf(("8conv_utf8_to_vbcs: Returning %d characters",
1143 (int)(dest
- start
)));
1145 return ((int)(dest
- start
));
1150 * 'conv_vbcs_to_utf8()' - Convert legacy DBCS/VBCS to UTF-8.
1153 static int /* O - Count or -1 on error */
1155 cups_utf8_t
*dest
, /* O - Target string */
1156 const cups_sbcs_t
*src
, /* I - Source string */
1157 int maxout
, /* I - Max output */
1158 const cups_encoding_t encoding
) /* I - Encoding */
1160 _cups_vmap_t
*vmap
; /* Legacy VBCS / Unicode Charset Map */
1161 cups_ucs2_t
*crow
; /* Pointer to UCS-2 row in 'char2uni' */
1162 _cups_wide2uni_t
*wide2uni
; /* Pointer to row in 'wide2uni' */
1163 cups_sbcs_t leadchar
; /* Lead char of n-byte legacy char */
1164 cups_vbcs_t legchar
; /* Legacy character value */
1165 cups_utf32_t work
[CUPS_MAX_USTRING
], /* Internal UCS-4 string */
1166 *workptr
; /* Pointer into string */
1170 * Find legacy charset map in cache...
1173 DEBUG_printf(("7conv_vbcs_to_utf8(dest=%p, src=%p, maxout=%d, encoding=%d)",
1174 dest
, src
, maxout
, encoding
));
1176 if ((vmap
= (_cups_vmap_t
*)get_charmap(encoding
)) == NULL
)
1178 DEBUG_puts("8conv_vbcs_to_utf8: Returning -1 (NULL vmap)");
1184 * Convert input legacy charset to internal UCS-4 (and insert BOM)...
1188 for (workptr
= work
+ 1; *src
&& workptr
< (work
+ CUPS_MAX_USTRING
- 1);)
1191 leadchar
= (cups_sbcs_t
)legchar
;
1194 * Convert ASCII verbatim (optimization)...
1199 *workptr
++ = (cups_utf32_t
)legchar
;
1201 DEBUG_printf(("9conv_vbcs_to_utf8: %02X => %08X", src
[-1],
1202 (unsigned)legchar
));
1207 * Convert 2-byte legacy character...
1210 if (vmap
->lead2char
[(int)leadchar
] == leadchar
)
1214 DEBUG_puts("8conv_vbcs_to_utf8: Returning -1 (short string)");
1219 legchar
= (legchar
<< 8) | *src
++;
1222 * Convert unknown character to Replacement Character...
1225 crow
= vmap
->char2uni
[(int)((legchar
>> 8) & 0xff)];
1227 crow
+= (int) (legchar
& 0xff);
1229 if (!crow
|| !*crow
)
1230 *workptr
++ = 0xfffd;
1232 *workptr
++ = (cups_utf32_t
)*crow
;
1234 DEBUG_printf(("9conv_vbcs_to_utf8: %02X %02X => %08X",
1235 src
[-2], src
[-1], (unsigned)workptr
[-1]));
1240 * Fetch 3-byte or 4-byte legacy character...
1243 if (vmap
->lead3char
[(int)leadchar
] == leadchar
)
1245 if (!*src
|| !src
[1])
1247 DEBUG_puts("8conv_vbcs_to_utf8: Returning -1 (short string 2)");
1252 legchar
= (legchar
<< 8) | *src
++;
1253 legchar
= (legchar
<< 8) | *src
++;
1255 else if (vmap
->lead4char
[(int)leadchar
] == leadchar
)
1257 if (!*src
|| !src
[1] || !src
[2])
1259 DEBUG_puts("8conv_vbcs_to_utf8: Returning -1 (short string 3)");
1264 legchar
= (legchar
<< 8) | *src
++;
1265 legchar
= (legchar
<< 8) | *src
++;
1266 legchar
= (legchar
<< 8) | *src
++;
1270 DEBUG_puts("8conv_vbcs_to_utf8: Returning -1 (bad character)");
1276 * Find 3-byte or 4-byte legacy character...
1279 wide2uni
= (_cups_wide2uni_t
*)bsearch(&legchar
,
1282 sizeof(_cups_wide2uni_t
),
1286 * Convert unknown character to Replacement Character...
1289 if (!wide2uni
|| !wide2uni
->unichar
)
1290 *workptr
++ = 0xfffd;
1292 *workptr
++ = wide2uni
->unichar
;
1294 if (vmap
->lead3char
[(int)leadchar
] == leadchar
)
1295 DEBUG_printf(("9conv_vbcs_to_utf8: %02X %02X %02X => %08X",
1296 src
[-3], src
[-2], src
[-1], (unsigned)workptr
[-1]));
1298 DEBUG_printf(("9conv_vbcs_to_utf8: %02X %02X %02X %02X => %08X",
1299 src
[-4], src
[-3], src
[-2], src
[-1], (unsigned)workptr
[-1]));
1306 DEBUG_printf(("9conv_vbcs_to_utf8: Converting %d UTF-32 characters to UTF-8",
1307 (int)(workptr
- work
)));
1310 * Convert internal UCS-4 to output UTF-8 (and delete BOM)...
1313 return (cupsUTF32ToUTF8(dest
, work
, maxout
));
1318 * 'free_sbcs_charmap()' - Free memory used by a single byte character set.
1322 free_sbcs_charmap(_cups_cmap_t
*cmap
) /* I - Character set */
1324 int i
; /* Looping variable */
1327 for (i
= 0; i
< 256; i
++)
1328 if (cmap
->uni2char
[i
])
1329 free(cmap
->uni2char
[i
]);
1336 * 'free_vbcs_charmap()' - Free memory used by a variable byte character set.
1340 free_vbcs_charmap(_cups_vmap_t
*vmap
) /* I - Character set */
1342 int i
; /* Looping variable */
1345 for (i
= 0; i
< 256; i
++)
1346 if (vmap
->char2uni
[i
])
1347 free(vmap
->char2uni
[i
]);
1349 for (i
= 0; i
< 256; i
++)
1350 if (vmap
->uni2char
[i
])
1351 free(vmap
->uni2char
[i
]);
1354 free(vmap
->wide2uni
);
1361 * 'get_charmap()' - Lookup or get a character set map (private).
1363 * This code handles single-byte (SBCS), double-byte (DBCS), and
1364 * variable-byte (VBCS) character sets _without_ charset escapes...
1365 * This code does not handle multiple-byte character sets (MBCS)
1366 * (such as ISO-2022-JP) with charset switching via escapes...
1370 static void * /* O - Charset map pointer */
1372 const cups_encoding_t encoding
) /* I - Encoding */
1374 char filename
[1024]; /* Filename for charset map file */
1375 _cups_globals_t
*cg
= _cupsGlobals(); /* Global data */
1378 DEBUG_printf(("7get_charmap(encoding=%d)", encoding
));
1381 * Get the data directory and charset map name...
1384 snprintf(filename
, sizeof(filename
), "%s/charmaps/%s.txt",
1385 cg
->cups_datadir
, _cupsEncodingName(encoding
));
1387 DEBUG_printf(("9get_charmap: filename=\"%s\"", filename
));
1390 * Read charset map input file into cache...
1393 if (encoding
< CUPS_ENCODING_SBCS_END
)
1394 return (get_sbcs_charmap(encoding
, filename
));
1395 else if (encoding
< CUPS_ENCODING_VBCS_END
)
1396 return (get_vbcs_charmap(encoding
, filename
));
1403 * 'get_charmap_count()' - Count lines in a charmap file.
1406 static int /* O - Count or -1 on error */
1407 get_charmap_count(cups_file_t
*fp
) /* I - File to read from */
1409 int count
; /* Number of lines */
1410 char line
[256]; /* Line from input map file */
1414 * Count lines in map input file...
1419 while (cupsFileGets(fp
, line
, sizeof(line
)))
1424 * Return the number of lines...
1435 * 'get_sbcs_charmap()' - Get SBCS Charmap.
1438 static _cups_cmap_t
* /* O - Charmap or 0 on error */
1440 const cups_encoding_t encoding
, /* I - Charmap Encoding */
1441 const char *filename
) /* I - Charmap Filename */
1443 unsigned long legchar
; /* Legacy character value */
1444 cups_utf32_t unichar
; /* Unicode character value */
1445 _cups_cmap_t
*cmap
; /* Legacy SBCS / Unicode Charset Map */
1446 cups_file_t
*fp
; /* Charset map file pointer */
1447 char *s
; /* Line parsing pointer */
1448 cups_ucs2_t
*crow
; /* Pointer to UCS-2 row in 'char2uni' */
1449 cups_sbcs_t
*srow
; /* Pointer to SBCS row in 'uni2char' */
1450 char line
[256]; /* Line from charset map file */
1454 * See if we already have this SBCS charset map loaded...
1457 DEBUG_printf(("7get_sbcs_charmap(encoding=%d, filename=\"%s\")", encoding
,
1460 for (cmap
= cmap_cache
; cmap
; cmap
= cmap
->next
)
1462 if (cmap
->encoding
== encoding
)
1465 DEBUG_printf(("8get_sbcs_charmap: Returning existing cmap=%p", cmap
));
1467 return ((void *)cmap
);
1472 * Open SBCS charset map input file...
1475 if ((fp
= cupsFileOpen(filename
, "r")) == NULL
)
1477 DEBUG_printf(("8get_sbcs_charmap: Returning NULL (%s)", strerror(errno
)));
1483 * Allocate memory for SBCS charset map...
1486 if ((cmap
= (_cups_cmap_t
*)calloc(1, sizeof(_cups_cmap_t
))) == NULL
)
1489 DEBUG_puts("8get_sbcs_charmap: Returning NULL (Unable to allocate memory)");
1495 cmap
->encoding
= encoding
;
1498 * Save SBCS charset map into memory for transcoding...
1501 while (cupsFileGets(fp
, line
, sizeof(line
)))
1506 legchar
= strtol(line
, &s
, 16);
1507 if (legchar
< 0 || legchar
> 0xff)
1510 unichar
= strtol(s
, NULL
, 16);
1511 if (unichar
< 0 || unichar
> 0x10ffff)
1515 * Save legacy to Unicode mapping in direct lookup table...
1518 crow
= cmap
->char2uni
+ legchar
;
1519 *crow
= (cups_ucs2_t
)(unichar
& 0xffff);
1522 * Save Unicode to legacy mapping in indirect lookup table...
1525 srow
= cmap
->uni2char
[(unichar
>> 8) & 0xff];
1528 srow
= (cups_sbcs_t
*)calloc(256, sizeof(cups_sbcs_t
));
1532 cmap
->uni2char
[(unichar
>> 8) & 0xff] = srow
;
1535 srow
+= unichar
& 0xff;
1538 * Convert Replacement Character to visible replacement...
1541 if (unichar
== 0xfffd)
1542 legchar
= (unsigned long)'?';
1545 * First (oldest) legacy character uses Unicode mapping cell...
1549 *srow
= (cups_sbcs_t
)legchar
;
1555 * Add it to the cache and return...
1558 cmap
->next
= cmap_cache
;
1561 DEBUG_printf(("8get_sbcs_charmap: Returning new cmap=%p", cmap
));
1566 * If we get here, there was an error in the cmap file...
1571 free_sbcs_charmap(cmap
);
1575 DEBUG_puts("8get_sbcs_charmap: Returning NULL (Read/format error)");
1582 * 'get_vbcs_charmap()' - Get DBCS/VBCS Charmap.
1585 static _cups_vmap_t
* /* O - Charmap or 0 on error */
1587 const cups_encoding_t encoding
, /* I - Charmap Encoding */
1588 const char *filename
) /* I - Charmap Filename */
1590 _cups_vmap_t
*vmap
; /* Legacy VBCS / Unicode Charset Map */
1591 cups_ucs2_t
*crow
; /* Pointer to UCS-2 row in 'char2uni' */
1592 cups_vbcs_t
*vrow
; /* Pointer to VBCS row in 'uni2char' */
1593 _cups_wide2uni_t
*wide2uni
; /* Pointer to row in 'wide2uni' */
1594 cups_sbcs_t leadchar
; /* Lead char of 2-byte legacy char */
1595 unsigned long legchar
; /* Legacy character value */
1596 cups_utf32_t unichar
; /* Unicode character value */
1597 int mapcount
; /* Count of lines in charmap file */
1598 cups_file_t
*fp
; /* Charset map file pointer */
1599 char *s
; /* Line parsing pointer */
1600 char line
[256]; /* Line from charset map file */
1601 int i
; /* Loop variable */
1602 int legacy
; /* 32-bit legacy char */
1605 DEBUG_printf(("7get_vbcs_charmap(encoding=%d, filename=\"%s\")\n",
1606 encoding
, filename
));
1609 * See if we already have this DBCS/VBCS charset map loaded...
1612 for (vmap
= vmap_cache
; vmap
; vmap
= vmap
->next
)
1614 if (vmap
->encoding
== encoding
)
1617 DEBUG_printf(("8get_vbcs_charmap: Returning existing vmap=%p", vmap
));
1619 return ((void *)vmap
);
1624 * Open VBCS charset map input file...
1627 if ((fp
= cupsFileOpen(filename
, "r")) == NULL
)
1629 DEBUG_printf(("8get_vbcs_charmap: Returning NULL (%s)", strerror(errno
)));
1635 * Count lines in charmap file...
1638 if ((mapcount
= get_charmap_count(fp
)) <= 0)
1640 DEBUG_puts("8get_vbcs_charmap: Unable to get charmap count!");
1647 DEBUG_printf(("8get_vbcs_charmap: mapcount=%d", mapcount
));
1650 * Allocate memory for DBCS/VBCS charset map...
1653 if ((vmap
= (_cups_vmap_t
*)calloc(1, sizeof(_cups_vmap_t
))) == NULL
)
1655 DEBUG_puts("8get_vbcs_charmap: Unable to allocate memory!");
1663 vmap
->encoding
= encoding
;
1666 * Save DBCS/VBCS charset map into memory for transcoding...
1676 while (cupsFileGets(fp
, line
, sizeof(line
)))
1681 legchar
= strtoul(line
, &s
, 16);
1682 if (legchar
== ULONG_MAX
)
1685 unichar
= strtol(s
, NULL
, 16);
1686 if (unichar
< 0 || unichar
> 0x10ffff)
1691 DEBUG_printf(("9get_vbcs_charmap: i=%d, legchar=0x%08lx, unichar=0x%04x", i
,
1692 legchar
, (unsigned)unichar
));
1695 * Save lead char of 2/3/4-byte legacy char...
1698 if (legchar
> 0xffffff)
1700 leadchar
= (cups_sbcs_t
)(legchar
>> 24);
1701 vmap
->lead4char
[leadchar
] = leadchar
;
1703 else if (legchar
> 0xffff)
1705 leadchar
= (cups_sbcs_t
)(legchar
>> 16);
1706 vmap
->lead3char
[leadchar
] = leadchar
;
1710 leadchar
= (cups_sbcs_t
)(legchar
>> 8);
1711 vmap
->lead2char
[leadchar
] = leadchar
;
1715 * Save Legacy to Unicode mapping...
1718 if (legchar
<= 0xffff)
1721 * Save DBCS 16-bit to Unicode mapping in indirect lookup table...
1724 crow
= vmap
->char2uni
[(int)leadchar
];
1727 crow
= (cups_ucs2_t
*)calloc(256, sizeof(cups_ucs2_t
));
1731 vmap
->char2uni
[(int)leadchar
] = crow
;
1734 crow
[(int)(legchar
& 0xff)] = (cups_ucs2_t
)unichar
;
1739 * Save VBCS 32-bit to Unicode mapping in sorted list table...
1745 vmap
->widecount
= (mapcount
- i
+ 1);
1746 wide2uni
= (_cups_wide2uni_t
*)calloc(vmap
->widecount
,
1747 sizeof(_cups_wide2uni_t
));
1751 vmap
->wide2uni
= wide2uni
;
1754 wide2uni
->widechar
= (cups_vbcs_t
)legchar
;
1755 wide2uni
->unichar
= (cups_ucs2_t
)unichar
;
1760 * Save Unicode to legacy mapping in indirect lookup table...
1763 vrow
= vmap
->uni2char
[(int)((unichar
>> 8) & 0xff)];
1766 vrow
= (cups_vbcs_t
*)calloc(256, sizeof(cups_vbcs_t
));
1770 vmap
->uni2char
[(int) ((unichar
>> 8) & 0xff)] = vrow
;
1773 vrow
+= (int)(unichar
& 0xff);
1776 * Convert Replacement Character to visible replacement...
1779 if (unichar
== 0xfffd)
1780 legchar
= (unsigned long)'?';
1783 * First (oldest) legacy character uses Unicode mapping cell...
1787 *vrow
= (cups_vbcs_t
)legchar
;
1790 vmap
->charcount
= (i
- vmap
->widecount
);
1795 * Add it to the cache and return...
1798 vmap
->next
= vmap_cache
;
1801 DEBUG_printf(("8get_vbcs_charmap: Returning new vmap=%p", vmap
));
1806 * If we get here, the file contains errors...
1811 free_vbcs_charmap(vmap
);
1815 DEBUG_puts("8get_vbcs_charmap: Returning NULL (Read/format error)");
1822 * End of "$Id: transcode.c 7560 2008-05-13 06:34:04Z mike $"