|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /home/queenjbs/www/FusionChart/Contents/advanced/special-chars/ |
Upload File : |
<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Using Multi-lingual text in FusionCharts XT </title>
<link rel="stylesheet" href="../../assets/ui/css/style.css" type="text/css" />
<style type="text/css">
#imageTable , #imageTable tr td{ border:1px solid #94B0BE; }
</style>
<script type="text/javascript" src="../../assets/prettify/prettify.js"></script>
<link rel="stylesheet" type="text/css" href="../../assets/prettify/prettify.css" />
<script type="text/javascript" src="../../assets/ui/js/jquery.min.js" ></script>
<style type="text/css">
<!--
div.WebHelpPopupMenu { position:absolute;
left:0px;
top:0px;
z-index:4;
visibility:hidden; }
a.whtbtnhide, a.whtbtnshow, a.whtbtnhidenav , a.whtbtnshownav { border-bottom:none !important; }
-->
</style>
<script type="text/javascript" language="javascript1.2" src="../../assets/ui/js/whmsg.js"></script>
<script type="text/javascript" language="javascript" src="../../assets/ui/js/whver.js"></script>
<script type="text/javascript" language="javascript1.2" src="../../assets/ui/js/whproxy.js"></script>
<script type="text/javascript" language="javascript1.2" src="../../assets/ui/js/whutils.js"></script>
<script type="text/javascript" language="javascript1.2" src="../../assets/ui/js/whlang.js"></script>
<script type="text/javascript" language="javascript1.2" src="../../assets/ui/js/whtopic.js"></script>
<script type="text/javascript" src="../../assets/ui/js/lib.js"></script>
</head>
<body>
<!-- breadcrumb starts here -->
<div id="breadcrumb"></div>
<script type="text/javascript">
document.write( addFCBreadcrumb( [ "Home|../../Introduction/Overview.html", "Advanced charting", "Using Special characters", "Using multi-lingual text" ] ) );
</script>
<!-- breadcrumb ends here -->
<table width="98%" border="0" cellspacing="0" cellpadding="3" align="center">
<tr>
<td class="pageHeader">Using Multi-lingual text in FusionCharts XT </td>
</tr>
<tr>
<td valign="top" class="text"><p>FusionCharts XT allows you to use multi-lingual (UTF-8) characters on the charts. Shown below is an example where we have used Arabic names on the chart:</p> </td>
</tr>
<tr>
<td valign="top" class="text"><img src="Images/SpChar_1.jpg" width="460" height="210" /></td>
</tr>
<tr>
<td valign="top" class="text"><p>You can use multi-lingual characters in all the charts in FusionCharts XT suite. </p>
<p class="highlightBlock">FusionCharts XT supports only left-to-right languages as of now. It does not have native support for right-to-left languages like Hebrew. So, if you want to use Hebrew with FusionCharts XT, you will have to programmatically reverse the sequence of words/characters and then provide the same to FusionCharts XT. </p> </td>
</tr>
<tr>
<td valign="top" class="header">How to use multi-lingual characters? </td>
</tr>
<tr>
<td valign="top" class="text">
<p>To use multi-lingual characters on the chart, you necessarily need to use UTF-8 encoded XML. More importantly, the XML file or stream<strong> does require a BOM stamp</strong> to be present as the very first three bytes of the file. Hence, one must remember the two basic thumb rules :</p>
<ol>
<li>for <strong>Data URL </strong>method - the XML file or stream should be having the BOM stamp and </li>
<li>for <strong>Data String </strong>method - the HTML or application file containing the XML as well as the chart SWF should have the BOM stamp. </li>
</ol>
</td>
</tr>
<tr>
<td valign="top"><a name="bomdetail"></a>
<p class="highlightBlock">What is BOM - Byte Order Mark. It is 'EF BB EF' - these three bytes in case of UTF-8 encoded files, the BOM being placed at the very beginning of the file. It is an indicator that the file is containing UTF-8 encoded strings.</p> </td>
</tr>
<tr>
<td valign="top" class="highlightBlock"><strong>WARNING</strong> : Do not rely on specifying the encoding setting, that is, <span class="codeInline"><?xml version="1.0" encoding="UTF-8"?></span> in the XML header region. <strong>This does not add the Byte Order Mark (BOM)</strong> to the XML file.</td>
</tr>
<tr>
<td valign="top" class="text"><p>Please note that without the BOM stamp the chart will produce gibberish characters. Please compare the images below: </p></td>
</tr>
<tr>
<td valign="top" class="text">
<table class="textBold" cellpadding="5" cellspacing="2" id="imageTable" >
<tr>
<td width="50%" class="blueTr">Standard (with BOM) </td>
<td width="50%" class="blueTr">Gibberish (without BOM) </td>
</tr>
<tr>
<td><img src="Images/multilanguages.jpg" width="398" height="296" class="imageBorder" /></td>
<td><img src="Images/nolanguage.jpg" width="394" height="294" class="imageBorder" /></td>
</tr>
</table>
</td>
</tr>
<tr>
<td valign="top" class="text"> </td>
</tr>
<tr>
<td valign="top" class="pageHeader">How to add BOM ?</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="header">1. In static XML </td>
</tr>
<tr>
<td valign="top" class="text"><p>For the XML files which are generated one-time and remains static, you
can manually insert a BOM mark. This method is applicable when data is
retrieved from file using the <span class="code-inline">Data URL method</span>. All you have to do is make sure the file containing the XML
data contains a BOM mark or specify one if it is absent. In order to
specify a BOM mark, follow these steps:</p>
<ol>
<li>Open the file in question in a text-editor that supports
UTF-8 encoding with BOM stamp (Example – Windows Notepad).</li>
<li>Open the <span class="codeInline">Save</span> menu and specify file name, file type,
encoding and BOM mark (if the option is available).</li>
<li>Save the file.</li>
</ol>
</td>
</tr>
<tr>
<td valign="top" class="text"><p>The image below shows how this can be done in Windows Notepad. </p></td>
</tr>
<tr>
<td valign="top" class="text"><img src="Images/addBOM1.jpg" width="457" height="155" class="imageBorder" /></td>
</tr>
<tr>
<td valign="top" class="text"><p>The image below shows how this can be done in Dreamweaver for MAC.</p></td>
</tr>
<tr>
<td valign="top" class="text"><img src="Images/addBOM2.jpg" class="imageBorder" /><br /><br /></td>
</tr>
<tr>
<td valign="top" class="header">2. In dynamically generated XML using server-side script</td>
</tr>
<tr>
<td valign="top" class="text">
<p> When generating the XML data using Server-side scripts and databases, BOM can added using either of the two methods: </p>
<ol>
<li> <span style="text-decoration:underline;">Manually add BOM to the XML relayer script file</span> - just like adding BOM stamp to the static XML files, you can also add the BOM stamp to the Server-side file which will be generating (relaying) the XML. This needs to be done when the script file is created for the first time before you start coding in it.<br />
<br />
</li>
<li> <span style="text-decoration:underline;">Write BOM using script</span> - In most cases the XML generator Server-side script file might be created with ANSI encoded format. In this case, one needs to add the BOM using script at the very beginning of the output stream. Moreover, when a Server-side script creates an XML file, it should add the BOM stamp as the very first three bytes of the file. </li>
</ol>
</td>
</tr>
<tr>
<td valign="top" class="text"><p>We list below techniques to implement BOM stamp using major server side technologies. </p></td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using ASP.NET C# </strong><br /><br /></td>
</tr>
<tr>
<td valign="top" class="code_container">
<p class="prettyprint lang-c#"><span class="typ">Response</span><span class="pun">.</span><span class="typ">ContentType</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="str">"text/xml; characterset=utf-8" </span><span class="pun">;</span><span class="pln"><br />
</span><span class="typ">Response</span><span class="pun">.</span><span class="typ">BinaryWrite</span><span class="pun">(</span><span class="kwd"> new</span><span class="pln"> byte</span><span class="pun">[]</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> </span><span class="lit">0xEF</span><span class="pun">,</span><span class="pln"> </span><span class="lit">0xBB</span><span class="pun">,</span><span class="pln"> </span><span class="lit">0xBF</span><span class="pln"> </span><span class="pun">} );</span></p>
<p class="codeComment"> // Now write your XML data to output stream </p>
</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using ASP.NET VB </strong></td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="code_container">
<p class="prettyprint lang-php"><span class="typ">Response</span><span class="pun">.</span><span class="typ">ContentType</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="str">"text/xml"</span><span class="pln"><br />
</span><span class="typ">Dim</span><span class="pln"> </span><span class="typ">UTFHeader</span><span class="pun">()</span><span class="pln"> </span><span class="typ">As</span><span class="pln"> </span><span class="typ">Byte</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{&</span><span class="pln">HEF</span><span class="pun">,</span><span class="pln"> </span><span class="pun">&</span><span class="pln">HBB</span><span class="pun">,</span><span class="pln"> </span><span class="pun">&</span><span class="pln">HBF</span><span class="pun">}</span><span class="pln"><br />
</span><span class="typ">Response</span><span class="pun">.</span><span class="typ">BinaryWrite</span><span class="pun">(</span><span class="typ">UTFHeader</span><span class="pun">)</span></p>
<p class="prettyprint lang-php"><span class="codeComment">// Now write your XML data to output stream </span></p>
</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using PHP </strong></td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="code_container">
<p class="prettyprint lang-php"><span class="pln">header</span><span class="pun"> ( </span><span class="str">'Content-type: text/xml' </span><span class="pun">);</span><span class="pln"><br />
echo pack</span><span class="pun"> ( </span><span class="str">"C3" </span><span class="pun">, </span><span class="lit">0xef</span><span class="pun">, </span><span class="lit">0xbb</span><span class="pun">, </span><span class="lit">0xbf</span><span class="pun"> );</span></p>
<p class="prettyprint lang-php"><span class="codeComment">// Now write your XML data to output stream </span></p>
</td>
</tr>
<tr>
<td valign="top" class="text"> </td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using ASP </strong></td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="code_container"><p class="prettyprint lang-asp"><span class="typ">Response</span><span class="pun">.</span><span class="typ">AddHeader</span><span class="pln"> </span><span class="str">"Content-Type"</span><span class="pun">,</span><span class="pln"> </span><span class="str">"text/xml;charset=UTF-8"</span><span class="pln"><br />
</span><span class="typ">Response</span><span class="pun">.</span><span class="typ">CodePage</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="lit">65001</span><span class="str">"</span><span class="pln"><br />
<br />
</span><span class="typ">Response</span><span class="pun">.</span><span class="typ">BinaryWrite</span><span class="pun">( </span><span class="pln">chrb</span><span class="pun">(</span><span class="lit">239</span><span class="pun">) )</span><span class="pln"><br />
</span><span class="typ">Response</span><span class="pun">.</span><span class="typ">BinaryWrite</span><span class="pun">(</span><span class="pln"> chrb</span><span class="pun">(</span><span class="lit">187</span><span class="pun">) )</span><span class="pln"><br />
</span><span class="typ">Response</span><span class="pun">.</span><span class="typ">BinaryWrite</span><span class="pun">(</span><span class="pln"> chrb</span><span class="pun">(</span><span class="lit">191</span><span class="pun">) )</span></p>
<p class="prettyprint lang-asp"><span class="codeComment">// Now write your XML data to output stream </span></p>
</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using J2EE </strong></td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="code_container">
<p class="prettyprint lang-java"><span class="pln">response</span><span class="pun">.</span><span class="pln">setContentType</span><span class="pun">( </span><span class="str">"text/xml; charset=UTF-8" </span><span class="pun">);</span><span class="pln"><br />
</span><span class="typ">OutputStream</span><span class="pln"> outs </span><span class="pun">=</span><span class="pln"> response</span><span class="pun">.</span><span class="pln">getOutputStream</span><span class="pun">();</span><span class="pln"><br />
outs</span><span class="pun">.</span><span class="pln">write</span><span class="pun">(</span><span class="kwd"> new</span><span class="pln"> </span><span class="kwd">byte</span><span class="pun">[]{(</span><span class="kwd">byte</span><span class="pun">)</span><span class="lit">0xEF</span><span class="pun">,</span><span class="pln"> </span><span class="pun">(</span><span class="kwd">byte</span><span class="pun">)</span><span class="lit">0xBB</span><span class="pun">,</span><span class="pln"> </span><span class="pun">(</span><span class="kwd">byte</span><span class="pun">)</span><span class="lit">0xBF</span><span class="pun">} );</span><span class="pln"><br />
</span>outs.flush();</p>
<p class="prettyprint lang-java"><span class="codeComment">// Now write your XML data to output stream </span></p>
</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using ColdFusion </strong></td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="code_container">
<p class="prettyprint lang-cfm"><span class="pln">context </span><span class="pun">=</span><span class="pln"> getPageContext</span><span class="pun">();</span><span class="pln"><br />
response </span><span class="pun">=</span><span class="pln"> context</span><span class="pun">.</span><span class="pln">getResponse</span><span class="pun">().</span><span class="pln">getResponse</span><span class="pun">();</span><span class="pln"><br />
</span><span class="kwd">out</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> response</span><span class="pun">.</span><span class="pln">getOutputStream</span><span class="pun">();</span><span class="pln"><br />
</span><span class="kwd"><br />
out</span><span class="pun">.</span><span class="pln">write</span><span class="pun">(</span><span class="lit">239</span><span class="pun">);</span><span class="pln"><br />
</span><span class="kwd">out</span><span class="pun">.</span><span class="pln">write</span><span class="pun">(</span><span class="lit">187</span><span class="pun">);</span><span class="pln"><br />
</span><span class="kwd">out</span><span class="pun">.</span><span class="pln">write</span><span class="pun">(</span><span class="lit">191</span><span class="pun">);</span></p>
<p class="prettyprint lang-cfm"><span class="codeComment">// Now write your XML data to output stream </span></p>
</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="text"><strong>Using ROR </strong></td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="code_container">
<p>utf8_arr = [0xEF,0xBB,0xBF]<br />
utf8_str = utf8_arr.pack("c3")</p>
<p><span class="codeComment"># Now write your XML data to output stream </span></p>
</td>
</tr>
<tr>
<td valign="top" height="23"></td>
</tr>
<tr>
<td valign="top" class="header">3. While using data String method</td>
</tr>
<tr>
<td valign="top" class="text">
<p>In many cases you might need to put the XML in the HTML/application file itself. We call this as Data String method. Just like adding BOM stamp to a static XML files, in this case too, you need to save the file containing the chart SWF and XML with BOM stamp. This needs to be done when the script or HTML file is created for the first time before you start coding in it.</p>
</td>
</tr>
</table>
<!-- footer links starts-->
<div id="fcfooter"></div>
<script type="text/javascript">
document.getElementById("fcfooter").innerHTML = addFCFooter("Number formatting - Input Number formatting|../number-format/Number_Input.html","Using Currency symbols|SpCharAll.html");
</script>
<!-- footer links ends -->
<script type="text/javascript" language="javascript1.2">//<![CDATA[
<!--
highlightSearch();
//-->
//]]></script>
</body>
</html>