root/Trunk/FriBidi.framework/Versions/A/Headers/fribidi_char_sets.h @ 2

/* FriBidi - Library of BiDi algorithm
 * Copyright (C) 1999,2000 Dov Grobgeld, and
 * Copyright (C) 2001,2002 Behdad Esfahbod.
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public  
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 * 
 * This library is distributed in the hope that it will be useful,  
 * but WITHOUT ANY WARRANTY; without even the implied warranty of   
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public License  
 * along with this library, in a file named COPYING; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
 * Boston, MA 02111-1307, USA
 * 
 * For licensing issues, contact <dov@imagic.weizmann.ac.il> and
 * <fwpg@sharif.edu>.
 */

#include "fribidi_config.h"
#ifndef FRIBIDI_NO_CHARSETS

#ifndef FRIBIDI_CHAR_SETS_H
#define FRIBIDI_CHAR_SETS_H

#include "fribidi.h"

#ifdef __cplusplus
extern "C"
{
#endif

#include "fribidi_char_sets_cap_rtl.h"
#include "fribidi_char_sets_utf8.h"
#include "fribidi_char_sets_iso8859_6.h"
#include "fribidi_char_sets_iso8859_8.h"
#include "fribidi_char_sets_cp1255.h"
#include "fribidi_char_sets_cp1256.h"
#include "fribidi_char_sets_isiri_3342.h"

/* The following enum members are going to be used as array indices,
   so they must be numbered from 0, and with the fixed order,
   FRIBIDI_CHARSET_DEFAULT is the one that when a charset leaves it's
   state with fribidi_charset_leave(), it gets into DEFAULT mode,
   so it must have no initialization. */
  typedef enum
  {
    FRIBIDI_CHAR_SET_NOT_FOUND,
#define _FRIBIDI_ADD_CHAR_SET(CHAR_SET, char_set) FRIBIDI_CHAR_SET_##CHAR_SET,
#include "fribidi_char_sets.i"
#undef _FRIBIDI_ADD_CHAR_SET

    FRIBIDI_CHAR_SETS_NUM_PLUS_ONE,

    FRIBIDI_CHAR_SET_DEFAULT = FRIBIDI_CHAR_SET_UTF8
  }
  FriBidiCharSet;

#define FRIBIDI_CHAR_SETS_NUM (FRIBIDI_CHAR_SETS_NUM_PLUS_ONE - 1)

/* Convert the character string "s" in charset "char_set" to unicode
   string "us" and return it's length. */
  FRIBIDI_API int fribidi_charset_to_unicode (FriBidiCharSet char_set,
                                              char *s, int length,
                                              /* output */
                                              FriBidiChar *us);

/* Convert the unicode string "us" with length "length" to character
   string "s" in charset "char_set" and return it's length. */
  FRIBIDI_API int fribidi_unicode_to_charset (FriBidiCharSet char_set,
                                              FriBidiChar *us, int length,
                                              /* output */
                                              char *s);

/* Return the string containing the name of the charset. */
  FRIBIDI_API char *fribidi_char_set_name (FriBidiCharSet char_set);

/* Return the string containing the title (name with a short description)
   of the charset. */
  FRIBIDI_API char *fribidi_char_set_title (FriBidiCharSet char_set);

/* Return the string containing a descreption about the charset, if any. */
  FRIBIDI_API char *fribidi_char_set_desc (FriBidiCharSet char_set);

/* Some charsets like CapRTL may need to change some fribidis tables, by
   calling this function, they can do this changes. */
  FRIBIDI_API fribidi_boolean fribidi_char_set_enter (FriBidiCharSet
                                                      char_set);

/* Some charsets like CapRTL may need to change some fribidis tables, by
   calling this function, they can undo their changes, perhaps to enter
   another mode. */
  FRIBIDI_API fribidi_boolean fribidi_char_set_leave (FriBidiCharSet
                                                      char_set);

/* Return the charset which name is "s". */
  FRIBIDI_API FriBidiCharSet fribidi_parse_charset (char *s);


#ifdef FRIBIDI_INTERFACE_1
/* Interface version 1, deprecated, just for compatibility. */

  FRIBIDI_API int fribidi_charset_to_unicode_1 (FriBidiCharSet char_set,
                                                char *s,
                                                /* output */
                                                FriBidiChar *us);
#define fribidi_charset_to_unicode      fribidi_charset_to_unicode_1

/* Also old character sets. */
#define fribidi_utf8_to_unicode         fribidi_utf8_to_unicode_1
#define fribidi_cap_rtl_to_unicode      fribidi_cap_rtl_to_unicode_1
#define fribidi_iso8859_6_to_unicode    fribidi_iso8859_6_to_unicode_1
#define fribidi_iso8859_8_to_unicode    fribidi_iso8859_8_to_unicode_1
#define fribidi_cp1255_to_unicode       fribidi_cp1255_to_unicode_1
#define fribidi_cp1256_to_unicode       fribidi_cp1256_to_unicode_1
#define fribidi_isiri_3342_to_unicode   fribidi_isiri_3342_to_unicode_1

#define FRIBIDI_TO_UNICODE_DECLARE_1(cs)        \
        int fribidi_##cs##_to_unicode_1 (char *s, FriBidiChar *us);
    FRIBIDI_TO_UNICODE_DECLARE_1 (utf8)
    FRIBIDI_TO_UNICODE_DECLARE_1 (cap_rtl)
    FRIBIDI_TO_UNICODE_DECLARE_1 (iso8859_6)
    FRIBIDI_TO_UNICODE_DECLARE_1 (iso8859_8)
    FRIBIDI_TO_UNICODE_DECLARE_1 (cp1255)
    FRIBIDI_TO_UNICODE_DECLARE_1 (cp1256)
    FRIBIDI_TO_UNICODE_DECLARE_1 (isiri_3342)
#undef FRIBIDI_TO_UNICODE_DECLARE_1
#endif                          /* FRIBIDI_INTERFACE_1 */
#ifdef  __cplusplus
}
#endif

#endif                          /* FRIBIDI_CHAR_SETS_H */

#endif