php-src

mirror of https://github.com/php/php-src.git synced 2024-11-25 19:05:31 +08:00

History

Tal Peer af3493d30c Changed fribidi_get_charsets() return value to also include the constant itself (as the key).		2002-10-18 08:59:15 +00:00
..
tests	Changed fribidi_get_charsets() return value to also include the constant	2002-10-18 08:59:15 +00:00
config.m4	Made the fribidi-config search a bit better.	2002-10-12 01:14:42 +00:00
CREDITS	- Fixed case in extension name	2002-09-27 12:12:06 +00:00
EXPERIMENTAL	- Initial commit	2002-09-26 05:47:56 +00:00
fribidi.c	Changed fribidi_get_charsets() return value to also include the constant	2002-10-18 08:59:15 +00:00
fribidi.dsp	Added win32 project file.	2002-10-16 00:02:32 +00:00
php_fribidi.h	New functions:	2002-10-17 18:04:43 +00:00
README	- Reverted back to old param parsing api (and eliminated a segfault by doing that)	2002-09-26 10:43:42 +00:00

README

Purpose
=======
         
This extension is basically a wrapper for the FriBidi implementation
of the Unicode Bidi algorithm. The need for such an algorithm rises
from the bidirectional language usage  done by applications. 
Arabic/Hebrew embedded within English is such a case.

Usage
=====

 The only function used is fribidi_log2vis (logical [non-reversed] to visual [reversed]).
     Input: 
            1) The Logical string.
            2) Base direction of application. Possible values:
                 a) FRIBIDI_RTL  - right to left
                 b) FRIBIDI_LTR  - left to right
                 c) FRIBIDI_AUTO - autodetect the base direction
            3) The char code being used, which can be one of the following
               constants:
                 a) FRIBIDI_CHARSET_UTF8       (Unicode)
                 b) FRIBIDI_CHARSET_8859_6     (Arabic)
                 c) FRIBIDI_CHARSET_8859_8     (Hebrew)
                 d) FRIBIDI_CHARSET_CP1255     (Hebrew/Yiddish)
                 e) FRIBIDI_CHARSET_CP1256     (Arabic)
                 f) FRIBIDI_CHARSET_ISIRI_3342 (Persian)
                 g) FRIBIDI_CHARSET_CAP_RTL - Used for test purposes, will treat CAPS as non-English letetrs

Note: Currently, FriBidi supports the above Character Codes alone. 

      Output: A Visual string.


Compiling
=========== 
1) Static - ./configure --with-fribidi=base-directory-of-FriBidi-installation-path 
             (defaults to /usr/local).

2) dl - same, just add shared, to get .... --with-fribidi=shared,base....
  
Prerequisites
=============
1) FriBidi version 0.10.4 or later must be installed. Latest version can be obtained thru 
   http://fribidi.sourceforge.net/

Note
=====

The function fribidi_log2vis computes three more arrays which are currently not passed back as output.
These arrays are:
	1) mapping from the logical to the visual string.
	2) mapping from the visual to the logical string.
	3) embedding level of characters as figured out by the FriBidi algorithm.

The extension needs further implementation to support this. 
p.s. - If you don't understand this, you probably don't need it.