128 lines
13 KiB
HTML
128 lines
13 KiB
HTML
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Character encoding</title><link rel="stylesheet" type="text/css" href="manual.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.0"><link rel="home" href="index.html" title="JpGraph Manual"><link rel="up" href="ch08.html" title="Chapter 8. Text and font handling"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Character encoding</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center">Chapter 8. Text and font handling</th><td width="20%" align="right"> </td></tr></table><hr></div><div class="sect1" title="Character encoding"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec1.character-encoding"></a>Character encoding</h2></div></div></div>
|
|||
|
|
|
|||
|
|
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
|
|||
|
|
<p>If you are not using Japanese, Chinese, Cyrillic , Greek or Hebrew
|
|||
|
|
languages then this section can be safely skipped.</p>
|
|||
|
|
</div><p>The core problem for the library is that it has no way of knowing in what
|
|||
|
|
input encoding the string given to the library is using. Hence it is necessary to,
|
|||
|
|
sometime, tell the library what input encoding is being used in order for the
|
|||
|
|
library to do necessary character encoding conversion to generate UTF-8 (or UTF-16)
|
|||
|
|
as needed to properly render the TTF fonts. The specific encoding options for each
|
|||
|
|
major supported locale are explained below.</p>
|
|||
|
|
<p>By default all JpGraph library files and examples are encoded in UTF-8</p>
|
|||
|
|
<p>All defines mentioned below can be found in the file
|
|||
|
|
"<code class="filename">jpgraph_ttf.inc.php</code>" </p>
|
|||
|
|
<div class="sect2" title="Japanese encoding options"><div class="titlepage"><div><div><h3 class="title"><a name="id2500277"></a>Japanese encoding options</h3></div></div></div>
|
|||
|
|
|
|||
|
|
<p>There is only one possible option that can be specified.</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="table"><a name="id2500290"></a><p class="title"><b>Table 8.4. Japanese encoding options</b></p><div class="table-contents">
|
|||
|
|
|
|||
|
|
<table summary="Japanese encoding options" border="1"><colgroup><col class="c1"><col class="c2"><col class="c3"></colgroup><thead><tr><th>Symbolic define</th><th>Possible values </th><th>Description</th></tr></thead><tbody><tr><td><code class="code">ASSUME_EUCJP_ENCODING</code></td><td>true/false</td><td>Assumes that Japanese text have been entered in EUC-JP
|
|||
|
|
encoding. If this define is true then conversion from EUC-JP
|
|||
|
|
to UTF8 is done automatically in the library using the
|
|||
|
|
<code class="code">mbstring</code> module in PHP. Note that the
|
|||
|
|
multibyte extension in PHP is not normally enabled.</td></tr></tbody></table>
|
|||
|
|
</div></div><p><br class="table-break">
|
|||
|
|
</p>
|
|||
|
|
<p>Otherwise it is assumed that the input characters are encoded in UTF-8.
|
|||
|
|
Remember that to show the Japanese character sets (Kanji, Hiragana and Katakana)
|
|||
|
|
one of the Japanese font families (<code class="code">FF_MINCHO</code>,
|
|||
|
|
<code class="code">FF_PMINCHO</code>, <code class="code">FF_GOTHIC</code> or <code class="code">FF_PGOTHIC</code>)
|
|||
|
|
must be specified. </p>
|
|||
|
|
<p>An example of using Japanese locale together with Windrose plots can be seen
|
|||
|
|
in <a class="xref" href="ch21s03.html#sec.windrose-locale-compass" title="Localizing the default names for the compass directions">Localizing the default names for the compass directions</a>.</p>
|
|||
|
|
</div>
|
|||
|
|
<div class="sect2" title="Chinese encoding options"><div class="titlepage"><div><div><h3 class="title"><a name="id2500408"></a>Chinese encoding options</h3></div></div></div>
|
|||
|
|
|
|||
|
|
<p>There are no specific settings that control the encoding. The following rules
|
|||
|
|
are used depending on the font is specified. </p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
|
|||
|
|
<p>If the font is specified as <code class="code">FF_SIMSUN</code> the built-in
|
|||
|
|
library conversion from GB2312 to UTF-8 will be used. This
|
|||
|
|
translation table is stored in the file
|
|||
|
|
<code class="filename">jpgraph_gb2312.inc.php</code>.</p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p>If the font is specified as <code class="code">FF_CHINESE</code> then no
|
|||
|
|
conversion is made since it is assumed that the input character
|
|||
|
|
string is already in UTF-8 This only has the effect of changing the
|
|||
|
|
font to the default Chinese font family.</p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p>If the font is specified as <code class="code">FF_BIG5</code> then it is
|
|||
|
|
assumed that the input character string is encoded in BIG5 and the
|
|||
|
|
internal translation to UTF-8 is done by the <code class="code">iconv()</code>
|
|||
|
|
function. This means that PHP must be built with
|
|||
|
|
<code class="code">iconv()</code> support. By default this is not compiled
|
|||
|
|
into PHP (needs the "<code class="code">--width-iconv</code>" when configured).
|
|||
|
|
For more on building PHP with the right options see <a class="xref" href="api.html" title="Appendix I. Compiling PHP">Appendix I. <i>Compiling PHP</i></a>. If this method is not present
|
|||
|
|
the library will generate the following an error message.</p>
|
|||
|
|
</li></ol></div><p>
|
|||
|
|
</p>
|
|||
|
|
<p>An example of using Chinese encoding with Windrose plots can be seen in <a class="xref" href="ch21s03.html#fig.windrose_ex6.1" title="Figure 21.11. Using chinese fonts (windrose_ex6.1.php)">Figure 21.11. Using chinese fonts <code class="uri"><a class="uri" href="example_src/windrose_ex6.1.html" target="_top">(<code class="filename">windrose_ex6.1.php</code>)</a></code> </a>
|
|||
|
|
</p>
|
|||
|
|
</div>
|
|||
|
|
<div class="sect2" title="Cyrillic encoding options"><div class="titlepage"><div><div><h3 class="title"><a name="id2500502"></a>Cyrillic encoding options</h3></div></div></div>
|
|||
|
|
|
|||
|
|
<p>In order to do proper translation to unicode from cyrillic the
|
|||
|
|
<code class="code">LANGUAGE_CYRILLIC</code> define should be set to true. If you are
|
|||
|
|
running the library in multiuser environment it might be necessary to also
|
|||
|
|
adjust the <code class="code">LANGUGAE_CHARSET</code> define as described below.</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="table"><a name="id2500523"></a><p class="title"><b>Table 8.5. Cyrillic encoding options</b></p><div class="table-contents">
|
|||
|
|
|
|||
|
|
<table summary="Cyrillic encoding options" border="1"><colgroup><col class="c1"><col class="c2"><col class="c3"></colgroup><thead><tr><th>Symbolic define</th><th>Possible values </th><th>Description</th></tr></thead><tbody><tr><td><code class="code">LANGUAGE_CYRILLIC</code></td><td>true/false</td><td>
|
|||
|
|
<p>Special unicode cyrillic language support</p>
|
|||
|
|
</td></tr><tr><td><code class="code">CYRILLIC_FROM_WINDOWS</code></td><td>true/false</td><td>
|
|||
|
|
<p>If you are setting this config to true the conversion
|
|||
|
|
will assume that the input text is encoded in windows
|
|||
|
|
1251, if false it will assume koi8-r</p>
|
|||
|
|
</td></tr><tr><td><code class="code">LANGUAGE_CHARSET</code></td><td>string</td><td>
|
|||
|
|
<p>This constant is used to auto-detect whether cyrillic
|
|||
|
|
conversion is really necessary if enabled. Just specify
|
|||
|
|
the encoding used, e.g. 'windows-1251', with a variable
|
|||
|
|
containing the input character encoding string of your
|
|||
|
|
application calling JpGraph. </p>
|
|||
|
|
<p>A typical such string would be 'UTF-8' or 'utf-8'. The
|
|||
|
|
comparison is case-insensitive. If this charset is not a
|
|||
|
|
'koi8-r' or 'windows-1251' derivate then no conversion
|
|||
|
|
is done. This constant can be very important in
|
|||
|
|
multi-user multi-language environments where a cyrillic
|
|||
|
|
conversion could be needed for some cyrillic people and
|
|||
|
|
resulting in just erroneous conversions for non cyrillic
|
|||
|
|
language based people. </p>
|
|||
|
|
<p>Example: In the free project management software
|
|||
|
|
dotproject.net <code class="code">$locale_char_set</code> is
|
|||
|
|
dynamically set by the language environment the user has
|
|||
|
|
chosen. </p>
|
|||
|
|
<p>Usage: <code class="code">define('LANGUAGE_CHARSET',
|
|||
|
|
$locale_char_set);</code> where
|
|||
|
|
<code class="code">$locale_char_set</code> is a GLOBAL (string)
|
|||
|
|
variable from the application including JpGraph.</p>
|
|||
|
|
</td></tr></tbody></table>
|
|||
|
|
</div></div><p><br class="table-break">
|
|||
|
|
</p>
|
|||
|
|
</div>
|
|||
|
|
<div class="sect2" title="Hebrew encoding options"><div class="titlepage"><div><div><h3 class="title"><a name="id2500687"></a>Hebrew encoding options</h3></div></div></div>
|
|||
|
|
|
|||
|
|
<p>There are no user adjustable settings. The conversion is made from iso to
|
|||
|
|
unicode with the help of the PHP method "<code class="code">hebrev()</code>" which is used to
|
|||
|
|
convert logical Hebrew text to visual text. This conversion is done
|
|||
|
|
automatically when the font is one of <code class="code">FF_DAVID</code>,
|
|||
|
|
<code class="code">FF_MIRIAM</code> or <code class="code">FF_AHRON</code></p>
|
|||
|
|
</div>
|
|||
|
|
<div class="sect2" title="Greek encoding options"><div class="titlepage"><div><div><h3 class="title"><a name="id2500718"></a>Greek encoding options</h3></div></div></div>
|
|||
|
|
|
|||
|
|
<p>In order to do proper translation to unicode from greek the
|
|||
|
|
<code class="code">LANGUAGE_GREEK</code> define should be specified to true.</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="table"><a name="id2500733"></a><p class="title"><b>Table 8.6. Greek encoding options</b></p><div class="table-contents">
|
|||
|
|
|
|||
|
|
<table summary="Greek encoding options" border="1"><colgroup><col class="c1"><col class="c2"><col class="c3"></colgroup><thead><tr><th>Symbolic define</th><th>Possible values </th><th>Description</th></tr></thead><tbody><tr><td><code class="code">LANGUAGE_GREEK</code></td><td>true/false</td><td>Special unicode greek language support</td></tr><tr><td><code class="code">GREEK_FROM_WINDOWS</code></td><td>true/false</td><td>If you are setting this define to true the conversion of
|
|||
|
|
greek characters will assume that the input text is windows
|
|||
|
|
1251</td></tr></tbody></table>
|
|||
|
|
</div></div><p><br class="table-break">
|
|||
|
|
</p>
|
|||
|
|
</div>
|
|||
|
|
</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"><a accesskey="u" href="ch08.html">Up</a></td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
|