Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
set_ucodepage(3)		Allegro	manual		      set_ucodepage(3)

       set_ucodepage  -	 Sets 8-bit to Unicode conversion tables. Allegro game
       programming library.

       #include	<allegro.h>

       void set_ucodepage(const	unsigned short *table,	const  unsigned	 short

       When  you select	the U_ASCII_CP encoding	mode, a	set of tables are used
       to convert between 8-bit	characters and their Unicode equivalents.  You
       can  use	this function to specify a custom set of mapping tables, which
       allows you to support different 8-bit codepages.

       The `table' parameter points to an array	of 256 shorts,	which  contain
       the Unicode value for each character in your codepage. The `extras' pa-
       rameter,	if not NULL, points to a list of mapping pairs,	which will  be
       used when reducing Unicode data to your codepage. Each pair consists of
       a Unicode value,	followed by the	way it should be represented  in  your
       codepage.   The list is terminated by a zero Unicode value. This	allows
       you to create a many->one mapping, where	many different Unicode charac-
       ters  can  be  represented by a single codepage value (eg. for reducing
       accented	vowels to 7-bit	ASCII).

       Allegro will use	the `table' parameter when  it	needs  to  convert  an
       ASCII string to an Unicode string. But when Allegro converts an Unicode
       string to ASCII,	it will	use  both  parameters.	First,	it  will  loop
       through the `table' parameter looking for an index position pointing at
       the Unicode value it is trying to convert (ie. the `table' parameter is
       also  used  for	reverse	matching). If that fails, the `extras' list is
       used. If	that fails too,	Allegro	will put the character `^', giving  up
       the conversion.

       Note  that Allegro comes	with a default `table' and `extras' parameters
       set internally. The default `table' will	convert	 8-bit	characters  to
       `^'.   The default `extras' list	reduces	Latin-1	and Extended-A charac-
       ters to 7 bits in a sensible way	(eg. an	accented vowel will be reduced
       to the same vowel without the accent).


Allegro				 version 4.4.3		      set_ucodepage(3)


Want to link to this manual page? Use this URL:

home | help