{"id":963,"date":"2012-07-10T16:57:39","date_gmt":"2012-07-10T14:57:39","guid":{"rendered":"http:\/\/ixdc.net\/blog\/?page_id=963"},"modified":"2018-05-05T03:56:56","modified_gmt":"2018-05-05T01:56:56","slug":"arabic","status":"publish","type":"page","link":"https:\/\/ixdc.net\/blog\/arabic\/","title":{"rendered":"Arabic Parsing"},"content":{"rendered":"

An Arabic parsing script for proper Arabic readability on Flash Player 8 and 9 without the use of Adobe Text Layout Framework, runs on the client-side with no need to migrating older projects for Flash Player 10 ..<\/p>\n

You can change Font, Color, Size, .., etc freely using your software.
\n
\n\u064a\u0645\u0643\u0646\u0643 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062e\u0637\u060c \u0627\u0644\u0644\u0648\u0646\u060c \u0627\u0644\u062d\u062c\u0645\u060c ..\u060c \u0627\u0644\u062e \u0628\u0645\u0646\u062a\u0647\u0649 \u0627\u0644\u062d\u0631\u064a\u0629 \u0645\u0646 \u062e\u0644\u0627\u0644 \u0627\u0644\u0628\u0631\u0646\u0627\u0645\u062c \u0627\u0644\u062e\u0627\u0635 \u0628\u0643
\n<\/span><\/p>\n

<\/embed><\/object><\/p>\n

Latest Version: 3.2<\/b><\/p>\n

You can integrate my parser into your library as open-source under GNU GPL<\/a> license.<\/p>\n

\nActionSctipt 2.0 open-source files available here<\/a><\/i>
\nActionSctipt 3.0 open-source files available here<\/a><\/i>
\nAction Input source files available here<\/a><\/i>
\nAction for iOS source files available here<\/a><\/i>\n<\/p><\/blockquote>\n

Older Versions:<\/b><\/p>\n

\n1.9 (AS2)<\/a>, 1.9 (AS3)<\/a>
1.8<\/a>, 1.7<\/a>, 1.6<\/a>, 1.5<\/a>, 1.4<\/a>, 1.3<\/a>, 1.2<\/a>, 1.1<\/a>, 1.0<\/a>\n<\/p><\/blockquote>\n

ActionSctipt 2.0 Usage:<\/b><\/p>\n

\r\nimport net.ixdc.utils.StringUtils;\r\nvar utils:StringUtils = new StringUtils();\r\nutils.wrapFactor = .8; \/\/ optional\r\n\r\nvar format:TextFormat = new TextFormat();\r\nformat.font = \"Arial\";\r\nformat.size = 14;\r\nformat.align = \"right\";\r\nformat.rightMargin = 4;\r\n\r\nvar output:TextField = this.createTextField(\"output\", 1, 10, 10, Stage.width-20, format.size);\r\noutput.autoSize = true;\r\noutput.embedFonts = true;\r\noutput.wordWrap = true;\r\noutput.multiline = true;\r\noutput.html = true;\r\n\r\nvar xml:XML = new XML();\r\nxml.ignoreWhite = true;\r\nxml.onLoad = function(done:Boolean) {\r\n\tif (done) {\r\n\t\toutput.htmlText = utils.parseArabic(this.firstChild.firstChild.nodeValue, output._width, format);\r\n\t}\r\n}\r\nxml.load(\"arabic.xml\");\r\n<\/pre>\n
ActionSctipt 3.0 Usage:<\/b><\/p>\n
\r\npackage {\r\n\timport flash.display.Sprite;\r\n\timport flash.events.Event;\r\n\timport flash.net.URLLoader;\r\n\timport flash.net.URLRequest;\r\n\timport flash.text.TextField;\r\n\timport flash.text.TextFieldAutoSize;\r\n\timport flash.text.TextFormat;\r\n\timport flash.events.MouseEvent;\r\n\timport net.ixdc.utils.StringUtils;\r\n\tpublic class ProperArabicTextAS3 extends Sprite {\r\n\t\tpublic var utils:StringUtils;\r\n\t\tpublic var format:TextFormat;\r\n\t\tpublic var output:TextField;\r\n\t\tpublic function ProperArabicTextAS3() {\r\n\t\t\tutils = new StringUtils();\r\n\t\t\tutils.wrapFactor = .8; \/\/ optional\r\n\t\t\toutput = new TextField();\r\n\t\t\toutput.width = stage.stageWidth-20;\r\n\t\t\toutput.autoSize = TextFieldAutoSize.LEFT;\r\n\t\t\toutput.embedFonts = true;\r\n\t\t\toutput.wordWrap = true;\r\n\t\t\toutput.multiline = true;\r\n\t\t\taddChild(output);\r\n\t\t\tformat = new TextFormat();\r\n\t\t\tformat.font = \"Arial\";\r\n\t\t\tformat.size = 14;\r\n\t\t\tformat.align = \"right\";\r\n\t\t\tformat.rightMargin = 4;\r\n\t\t\tvar xmlLoader:URLLoader = new URLLoader();\r\n\t\t\txmlLoader.addEventListener(Event.COMPLETE, showXML);\r\n\t\t\txmlLoader.load(new URLRequest(\"arabic.xml\"));\r\n\t\t}\r\n\t\tpublic function showXML(event:Event):void {\r\n\t\t\tXML.ignoreWhitespace = true; \r\n\t\t\tvar arabic:XML = new XML(event.target.data);\r\n\t\t\toutput.htmlText = utils.parseArabic(arabic.text(), output.width, format);\r\n\t\t}\r\n\t}\r\n}\r\n<\/pre>\n
Sample XML:<\/b><\/p>\n
\r\n\r\n\r\n\t\r\n<\/arabic>\r\n<\/pre>\n
Features Supported:<\/em><\/p>\n
    \n
  1. Embedding Fonts (just put a dynamic textfield on-stage and select at least Basic Latin (95 glyphs) and Arabic (1088 glyphs) from the Character Embedding menu).<\/li>\n
  2. Arabic Ligatures.<\/li>\n
  3. Arabic Diacritics. (Fonts must support diacritics<\/i>)<\/li>\n
  4. Word Wrapping.<\/li>\n
  5. Bi-Directional text.<\/li>\n
  6. HTML Text. (Optional using StringUtils<\/span> class, otherwise, kindly use the light version with ArabicLight<\/span> class, both classes are included in the sample files above<\/i>)<\/li>\n
  7. Loading External text on run-time.<\/li>\n
  8. Windows\/Mac\/Linux support.<\/li>\n
  9. Arabic enabled input fields using actionscript method (createArabicInput) with the help of javascript (arabicinput.js) beta<\/em><\/li>\n
  10. Urdu support.<\/li>\n<\/ol>\n
    Requirements:<\/em><\/p>\n
      \n
    1. Dynamic TextField.<\/li>\n
    2. HTML enabled TextField.<\/li>\n
    3. pre-assigned TextFormat.<\/li>\n
    4. Arabic fonts. must have Form-B unicode representations<\/i><\/li>\n
    5. Urdu fonts. must have Form-A unicode representations<\/i><\/li>\n<\/ol>\n
      Properties:<\/em><\/p>\n
        \n
      1. data: for referencing original input string.<\/li>\n
      2. wrapFactor: optional reduction value (Mac only) for wrapping correction when using bi-directional text  (default = 0.9).<\/li>\n
      3. htmlLines: array of spliced text block HTML lines.<\/li>\n
      4. embedFonts: boolean (default = true).<\/li>\n
      5. hindiNumeralsOnly: boolean (default = false).<\/li>\n<\/ol>\n
        Omitted Properties:<\/em><\/p>\n
          \n
        1. latinOnly<\/li>\n
        2. americanFormat<\/li>\n<\/ol>\n
          For the font embedding and reducing file size, you can use shared fonts, and port those from a different server, follow this<\/a> guide ..<\/p>\n
          Detailed Case Study<\/h3>\n
          Problem:<\/b><\/p>\n
          \nWell, this issue is a very old one, I\u2019ve always experienced annoying problems each time I try to render Arabic text on run-time using Flash and ActionScript 2.0, Flash doesn\u2019t support right-to-left languages, and when it comes to Arabic, we are talking about proper characters joining and word wrapping.\n<\/p>\n
          Analysis of Alternatives:<\/b><\/p>\n
          \nI never stopped tracking this specific issue to find any new solution has been developed somewhere, for a long time I can only find this<\/a> paid solution.<\/p>\n
          The guy one had it perfectly solved, he was having his solution implemented using ActionScript 2.0 at some point earlier, but he stopped publishing that and left his latest version only, which works with ActionScript 3.0.<\/p>\n
          Recently, Adobe has announced that they finally support right-to-left languages along with bi-directional and complex script ones, only using ActionScript 3.0 and it requires Flash Player 10 or above, they even have an open source framework called Text Layout Framework, it\u2019s perfect actually, it should put an end to this issue, but ..<\/p>\n
          I have my own objections; I made my quick test here<\/a> to check their new technique.<\/p>\n
          Arabic text is finally rendered properly, but why we have to add so many childs to our display list from different TextLines and TextBlocks instead of a single TextField?
          \nAlso we have to set a max width, and I couldn\u2019t find a way to scroll through text without using a custom scroller and masking the text just like any other MovieClip or DisplayObject, personally, I find this much complicated solution just to display simple Arabic string properly!<\/p>\n
          On the other hand, there are others who developed complex solutions developed in ActionScript 2.0 for Arabic speakers, and they\u2019re definitely facing hell to convince their clients to migrate their projects to ActionScript 3.0, an easy solution for ActionScript 2.0 would save the day.<\/p>\n
          I do like ActionScript 2.0 a lot more, not just for handling text easily, also for one other important reason, which is memory Management!
          \nActionScript 3.0 new DisplayList structure has many features yes, but it kills innovation by relaying objects disposal to Flash Player\u2019s Garbage Collector alone, there\u2019s no supported way to destroy objects manually during run-time, unlike ActionSciript 2.0, and I find that an extremely rough obstacle when using ActionScript 3.0.\n<\/p>\n
          Implementation:<\/b><\/p>\n
          \nIn a nutshell, ActionScript 2.0 used to refuse right-to-left languages, so we can\u2019t embed fonts, wrap text properly, and when it comes to Arabic text we also see our characters splitted which is inappropriate for Arabic readers, the old solution for this was loading text encoded in UTF-8 from external text\/xml files, and still no word wrapping, and on Mac machines Arabic letters still splitted, we can align text but its direction still not right-to-left.<\/p>\n
          So, logically, I know that I have to construct my Arabic text manually, to achieve that I had to analyze Arabic rules for character joining with all its special cases, and then find a way to force its direction to be left-to-right, and the word wrapping part is not that hard after all, this is basically what I did actually!<\/p>\n
          My only problem was in finding a way to inject all proper Arabic characters with its unique cases, for a long time I found that very difficult, Flash doesn\u2019t allow me to copy those from other text processing tools, and of course there\u2019s no way to type each character a lone in different cases using keyboard.<\/p>\n
          Finally, I found a way to do that, and it was very simple, I found the following charts at Unicode<\/a> official website.<\/p>\n
          That\u2019s it! Now I can instruct ActionScript 2.0 to handle my Arabic characters properly, by looping through the input string and replacing each Arabic character with it\u2019s proper glyph according to it\u2019s position within each word with a few conditions to maintain Arabic Grammar.<\/p>\n
          The task is basically easy, but when turning that to a complete bi-directional solution, things got a little bit complicated, but it the results were very good.\n<\/p>\n
          Results:<\/b><\/p>\n
          \nMy favorite justification is for one of my clients, Hafez Avocats<\/a>.
          \nData-driven, Multilingual, and Flash-based website developed in ActionScript 2.0 using this solution, the performance is stunning.<\/p>\n
          A JavaScript version<\/a> of this solution to resolve custom Arabic fonts on mobile Safari for iOS.<\/p>\n","protected":false},"excerpt":{"rendered":"
          An Arabic parsing script for proper Arabic readability on Flash Player 8 and 9 without the use of Adobe Text Layout Framework, runs on the client-side with no need to migrating older projects for Flash Player 10 .. You can change Font, Color, Size, .., etc freely using your software. \u064a\u0645\u0643\u0646\u0643 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062e\u0637\u060c \u0627\u0644\u0644\u0648\u0646\u060c \u0627\u0644\u062d\u062c\u0645\u060c […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-963","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/pages\/963","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/comments?post=963"}],"version-history":[{"count":65,"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/pages\/963\/revisions"}],"predecessor-version":[{"id":1217,"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/pages\/963\/revisions\/1217"}],"wp:attachment":[{"href":"https:\/\/ixdc.net\/blog\/wp-json\/wp\/v2\/media?parent=963"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}