JohnWhitePart No: 806-5583May 2000Sun Microsystems, Inc.

901 San Antonio RoadPalo Alto, CA94303-4900U.S.A.

2000 Sun MicrosystemsTitle: Complex Text Layout Language Support in the Solaris Operating EnvironmentPart number: 806-5583Audience: System administrators, software developersPage count: 28Keywords: Solaris 8 operating environment, Internationalization, I18N, CTLThis book provides information and software features for internationalizing software in Complex Text Layout language marketsThis product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers.Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.Sun, Sun Microsystems, the Sun logo, docs.sun.com, AnswerBook, AnswerBook2, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license agreements.Federal Acquisitions: Commercial Software-Government Users Subject to Standard License Terms and Conditions.DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l'utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l'autorisation préalable et écrite de Sun et de ses bailleurs de licence, s'il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.Des parties de ce produit pourront être dérivées du système Berkeley BSD licenciés par l'Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d'autres pays et licenciée exclusivement par X/Open Company, Ltd. Sun, Sun Microsystems, le logo Sun, docs.sun.com, AnswerBook, AnswerBook2, et Solaris sont des marques de fabrique ou des marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc.L'interface d'utilisation graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun détient une licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l'interface d'utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun.CETTE PUBLICATION EST FOURNIE "EN L'ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N'EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L'APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU'ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S'APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.Programming & ToolsSystem AdministrationPrefacePrefaceThe Complex Text Layout Language Support in the Solaris Operating Environment white paper presents information and software features for internationalizing software in Complex Text Layout language markets. Complex Text Layout (CTL) languages require text layout transformations on text input to properly display text output on the screen or printed page. CTL functionality is available in all Unicode locales as well as the Thai, Arabic, and Hebrew locales.This white paper is intended for software developers who are interested in developing internationalized software for the Complex Text Layout Language Solaris operating environment. This white paper is part of a 4-part series on internationalization for Solaris software developers. The four internationalization white papers are:Asian-Language Support in the Solaris Operating EnvironmentComplex Text Layout Language Support in the Solaris Operating EnvironmentUnicode Support in the Solaris Operating EnvironmentEuro Currency Support in the Solaris Operating EnvironmentChapter 1 describes characteristics of CTL languages and how they are managed by the Solaris CTL language engines.Chapter 2 provides an overview of the Solaris CTL architecture and explains how developers can add CTL functionality to an application.Chapter 3 provides helpful resource information.The following books are related to software internationalization: Creating Worldwide Software: Solaris International Developer's Guide Bill Tuthill and David Smallberg.Internationalization Guide, Version 2: Open Group Guide The Open GroupInternational Language Environments Guide Solaris Developer Collection.Programming for the World: A Guide to Internationalization Sandra Martin O'Donnell.The Unicode Standard, Version 3.0 The Unicode Consortium.X Windows on the World, Developing Internationalized Software with X, Motif, and CDE Thomas C. McFarland.The following books are related to CTL language support: CAE Specification: Portable Layout Services ISBN 1-85912-142-X.Portable Layout Services: Context-dependent and Directional Text ISBN 1-85912-075-X.Fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.For a list of documents and how to order them, visit the Sun Documentation Center on Fatbrain.com at http://www1.fatbrain.com/documentation/sun.The docs.sun.com Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.Chapter 11. Complex Text Layout LanguagesThis chapter introduces features of Complex Text Layout languages and their support in the Solaris operating environment. Complex Text Layout language support in SolarisBidirectional scripts (Arabic and Hebrew)Character representationInput and text handlingNumbers and datesStoring and displaying text has traditionally followed the basic structure of writing systems in Western languages (languages based on the Roman, Cyrillic, and Greek alphabets). Input characters are stored in the order in which they are typed, and displayed in the same order. There is no logical difference between how text is stored and how it is displayed.Some writing systems, however, are different than those of Western languages. The direction in which characters are displayed can be different and the shape of a character or word can be modified depending on the adjoining text. Complex text layout transformations are required for display. A Complex Text Layout (CTL) language is any language which stores text differently from how it is displayed. Particularly, many CTL languages use bidirectional script. Words and sentences are written from right to left, while some text, such as numbers and Roman-based words, are written from left to right. Arabic and Hebrew use bidirectional script. Furthermore, some CTL languages are context dependent. In Arabic, characters can be modified depending on the preceding and following characters. Written Thai uses character clusters, a collection of syllabic elements denoting consonants, vowels, and tonal values.The Solaris operating environment supports CTL easily and conveniently in all Unicode and Thai, Arabic, and Hebrew locales. CTL scripts are properly rendered as screen output or in printed format. Most applications need only be recompiled without changing the source code to run under these locales. A CTL-supported application enables users to input, view, and display CTL text without any additional development work.The Solaris operating environment contains a standard API, the Portable Layout Services (PLS) from The Open Group, which provide applications with a consistent interface to the CTL language engines. Developers set various CTL attributes in the PLS configuration file, including cursor positioning and character and cell deletion.Note - Unless otherwise stated, the CTL language engines manage complex text layout transparently to the user.Arabic and Hebrew use bidirectional script. In a bidirectional script, the default text direction is from right to left. However, numbers and Western-language text (such as quotations or proper names) are written from left to right. Text justification depends on line direction--typically, right-to-left text is right justified and left-to-right text is left justified.Because input characters are stored in order, an application must manage the display of blocks of right-to-left and left-to-right text in the proper order. In Figure 1-1, text direction is left to right for the English text and right to left for the Arabic text. Note that the cursor is to the left of the Arabic text after input.

Figure 1-1

Note - In the Solaris operating environment, complex text layout issues are managed by Motif. Applications using Motif do not need to address these issues directly. For more information, see Section 2.1, Architecture.In an application supporting bidirectional script, the global direction determines text flow and alignment. For example, in an Arabic word processor, the global direction is right to left for justification, tabulation, and related formatting operations. Roman words and phrases within an Arabic text string, however, remain left-to-right aligned. When a line break occurs in the middle of an Arabic string imbedded in an English sentence, however, the break must still respect the left-to-right text flow as shown in Figure 1-2.

Figure 1-2

Some characters have a meaning related to their direction, such as greater than (>) and less than (<). Bidirectional text strings containing these characters may need to replace one character with its complement to retain the correct meaning. For example, the expression 3 < 4 (three is less than four) is stored in the sequence in which it is typed. To display this expression correctly in a right-to-left string, however, it must appear as 4 > 3 (read right to left as 3 less than 4). Because a direct transposition of the three characters in storage would give 4 < 3, which is incorrect, the transformation process must swap < and >.Replacing complementary symbols to retain their correct meaning is called symmetrical swapping. Characters requiring symmetrical swapping include parentheses: ( and ), angle brackets: < and >, square brackets: [ and ], and curly brackets: { and }. In CTL languages, the basic input character is often modified before being displayed. Character representation is the final display form of the screen or printed character and depends on context, ligatures, diacritical marks, and character clusters. Note that any modified input will not have a one-to-one correspondence between the number of input characters and the number of output glyphs. A single glyph occupying one display cell can represent two or more typed characters. Internal algorithms determine the character representation from the number and sequence of input characters. By using the PLS library, an application uses the appropriate character representation in each CTL language.The shape of a character in its final display form can depend on its position in a word or its position relative to neighboring characters. Changing the shape of a character is called shaping or contextual analysis. For example, in English handwriting, letters can have different shapes in isolation or connected to other letters: the letter "r" appears differently at the beginning, in the middle, or at the end of a word. In English printing, however, character representation is unaffected by position--a character in isolation or connected to other letters is identically represented. For example, lowercase "a" is represented as "a"--either by itself, at the start, in the middle, or at the end of a word as in: a, all, lap, formula.)Arabic uses a cursive script, connecting one character to another as in English handwriting. All characters are affected in many different ways by their context. Arabic characters can have up to four final display forms: initial, final, medial, or isolated. During input, the keystrokes are stored as basic code-point values. The Arabic language engine reads the code-point values and selects the appropriate final display form from the context. Ligatures and diacritics, however, must also be considered.Note - Only the basic shape of each character appears on an Arabic keyboard.A ligature is the combination of two or more characters to create a single character or syllable. For example, in English, a diphthong is a ligature which unites two vowel characters to create another sound: a + e = æ.In Arabic, ligatures are the combinations of two and, sometimes, three characters into one glyph. The resulting glyph replaces the characters composing it. For example, an Arabic letter typed twice is stored in memory as two distinct keystrokes, occupying two display cells. However, the Arabic language engine recognizes the context of each character and returns one glyph as shown in Figure 1-3.

Figure 1-3

In the Arabic language engine, a ligature occupies the same number of display cells as input characters, with one exception: the combination character lamalif.

Figure 1-4

The rules governing ligatures in Arabic text are very complex and do not depend solely on individual characters. Certain fonts define as many as 200 ligatures, while other fonts do not use ligatures at all.Diacritical marks (or diacritics) are added to a character to show pronunciation. For example, in French, an accent is a diacritical mark above a vowel which alters the stress of the vowel: à á è é.In Hebrew, diacritical marks represent vowel sounds and appear above, below, or inside characters . Typically, however, words are written without diacritics and vowel sounds are determined from the context.In Arabic, diacritical marks can appear above (single or double diacritic) or below (single diacritic) any character. In the Arabic language engine, diacritics are entered as separate keystrokes and occupy the same cell as their associated character.In Thai, diacritical marks appear above or below the base line containing consonants, vowels, symbols, and numbers. In the Thai language engine, diacritics are entered as separate keystrokes and occupy the same cell as their associated character.A character cluster is a collection of alphabetic characters forming a single word or syllable.A Hebrew character cluster can contain characters and diacritics, though diacritics are not often used. Character clusters are integral to written text in Thai. A Thai character cluster consists of up to four parallel lines:Base line of consonant, vowel, or symbolLower line of lower vowel or diacriticUpper line of upper vowel or diacriticLine above the upper line for tone marks and upper diacriticsOne or more elements may change shape in the presence of other elements. In the Thai language engine, a character cluster occupies one display cell. Depending on the composition, one display cell can contain up to three input characters, as shown in Figure 1-5.

Figure 1-5

The Solaris operating environment locales support text input in a number of different writing systems. In the UTF-8 locale, to choose an input mode, press the Compose key and a two-letter code as in Table 1-1. For example, to input text in Thai, press Compose+tt. Alternatively, click the status area and select an input mode. (To select the English/European input mode, press Control+Space.)Note - In a CTL locale, to toggle between the English/European and CTL locale, press Control+Space. The bottom left corner of the text window displays the current input mode, as shown in Figure 1-6.

Figure 1-6

The user can mix text between English and the CTL language locale (Arabic, Hebrew, Thai) by switching input modes. The formatting rules governing the input stream are managed by the application.Table 1-1 LanguageCodeCyrillicccGreekggThaittArabicarHebrewhhUnicode HexuhUnicode OctaluoLookupllEnglish/EuropeanControl+SpaceNote - To switch modes, press Compose+code. On a X86 machine, use Ctrl+Shift+F1 as the Compose key.CTL text can also be input with a lookup table as shown in Figure 1-7.

Figure 1-7

To view a lookup table, click the status area, [Lookup], and a Lookup input mode. To input a character, click the character. The default cursor position is the upper left corner of the screen. The cursor direction depends on the input mode (left-to-right for Western languages and right-to-left for Arabic and Hebrew). The cursor position is determined after the second keystroke. In English and other Western languages, the cursor redisplays to the right of each keystroke. In Hebrew and Arabic, the cursor remains stationary, with the character stream appearing to the right or left of the cursor, depending on the page alignment.In Thai, the character cluster is composed to the left of the cursor. If a set of two or three keystrokes belong to the same cluster, the language engine values these keystrokes as zero and the cursor remains in place. The cursor moves to the right as each cluster is composed.Note - Cursor attributes can be reconfigured in the application resource file. For more information, see Step 4 in Section 3.1 CTL Motif Resources.To manage editing character clusters, the CTL language supports both character-based deletion and cell-based deletion. In character-based deletion, the user deletes the separate elements of the character cluster with each press of the Delete key. In cell-based deletion, the user deletes the entire cluster with one keystroke.The two deletion modes can be assigned to separate keys on the keyboard using translation and resources. For more information, see Step 3 in Section 3.1 CTL Motif Resources.In the Solaris operating environment, all CTL text is stored in logical order--the order of the character input stream. The CTL language engines manage the transformation from CTL scripts to final display form on screen.Most legacy systems containing CTL text store data in physical order--the order represented on screen. This was done because there was no processing capability at the terminal for reading and correctly rendering logical input. Screens of text were stored and then read again to screen.Applications can read legacy data using the CTL language engines by configuring the appropriate language engine modifier. For more information, see Step 1 in Section 3.1 CTL Motif Resources.For other language-engine configuration parameters, see CAE Specification: Portable Layout Services (ISBN 1-85912-142-X).For numbers, most countries use the "Arabic" or Western format of ten digits: 1 2 3 4 5 6 7 8 9 0. Some Arabic countries, however, use Hindi digits.

Figure 1-8

The Solaris operating environment supports both Arabic and Hindi digits. By default, Western language input modes display Arabic numbers while the Arabic input mode displays Hindi numbers, though this is configurable by the user. To change the default, see Step 1 in Section 3.1 CTL Motif Resources.Arabic countries use both the Gregorian (Western) and Hijri (Islamic) date systems. These and other numeric data, such as time and monetary formats and currency symbol, are managed by the Solaris operating environment locale settings.CTL languages require complex transformations to properly display or print characters. The fundamental characteristics of CTL languages are:Bidirectional text--Arabic and Hebrew are written right to left, but numbers and Roman-based characters are written left to right. Contextual analysis--each Arabic character has up to four display representations. The representation glyph depends on its position in the text. Ligatures--combinations of two or more Arabic characters can form a different, single character. Diacritics--diacritical marks placed above, below, or inside vowels and consonants modify their tonal value. Character clusters--syllables and cells, especially in Thai, are composed of several alphabetic elements, including vowels, consonants, diacritics, and tone marks. Number and date formats--some Arabic countries use Hindi digits rather than Arabic digits, and the Islamic calendar rather than the Western calendar.Motif interfaces with PLS which interfaces with the CTL language engines. Applications that make use of Motif services need not address CTL issues directly because all CTL transformations and rendering are handled transparently.Chapter 22. Technical ConsiderationsThis chapter outlines the implementation of CTL support in the Solaris operating environment.ArchitectureMultiscript supportRepresentation managementCTL localesCTL language support in the Solaris operating environment comprises a set of extensions supporting transformations between text input and text output.The CTL language engines enable the CDE/Motif drawing and measurement API for character shaping, such as ligatures and diacritics, the transformation of static and dynamic text widgets, and right-to-left and left-to-right text alignment and tabbing. Because text rendering is handled through the rendition layer, other widget libraries can be extended to support CTL.The new CTL features require the Portable Layout Services (PLS) library and the appropriate language engine. CTL uses PLS as the interface to the language engines to transform text before rendering.Note - 1. There are no changes to the Motif public APIs. A few resources have been added, but all old resources still work.2. Existing applications can inherit CTL support by adding the resources without changing any source code.

Figure 2-1

Desktop and Motif applications, at the top of the stack, use Motif functionality to render text. Motif interfaces with the language engines using PLS. PLS needs to know the current locale only when calling the appropriate language engine.The language engines perform character transformations for shaping and reordering text. The character stream can come from keyboard input, an application's text strings, or a file.Note - Because the CTL architecture easily supports new languages, Sun may develop new language engines in future. Because of the CTL framework, Unicode characters and CTL features can easily be presented together in a Unicode locale. The UTF-8 locales use the Universal Multiscript Language Engine (UMLE). UMLE is controlled by the utility genlayouttbl(1) which can be used to add/customize the script layout. For more information about this utility and the Universal Multiscript Language Engine, see the genlayouttbl(1) man pages. Figure 2-2 shows a sample multiscript e-mail in dtmail (en_US.UTF-8 locale).

Figure 2-2

The various components of the CTL stack manage different functions of the string, processing, and display of CTL language characters and symbols. The language engines are responsible for all aspects of character formation and rendering in the appropriate language. The language engines support the following shaping and reordering features:BidirectionalitySymmetrical swappingNumeral shapingContextual analysisPositional variationLigationDiacriticsCharacter clustersThe language engine algorithms apply language-specific rules to the input stream and return the appropriate glyphs for rendering by the X11 rendition layer. Motif is responsible for all on screen text manipulations, including: Cursor positioningHighlightingText selectionCut and pasteInsert/deleteMotif also manages the flow of the character input stream so that the language engine receives only CTL characters for processing. The application manages the physical layout of text, including alignment, justification, word demarcation, and other page-formatting features. The application also manages the collation of CTL text, non-processed text, and locale-specific information. For example, when displaying currency strings, the application collates the processed number stream and the current locale's monetary format and currency symbol.The Solaris operating environment provides the following CTL locales.Table 2-1 LocaleCodesetTypefaceConversionArabic: ar_ARiso8859-6Akhbar, Shayyal, Naskh (Regular and Bold)8859-6 <-> UTF-88859-6 <-> Win1256Hebrew: he_HEiso8859-8Arial, CourierNew, TimesNewRoman, LucidaSans (Regular, Bold, Italic, and BoldItalic)8859-8 <-> UTF-8Thai: th_THiso8859-11 (TIS620.2533)AngsanaUPC, BrowaliaUPC, CordiaUPC, Lucida (Medium, Bold, Italic, and BoldItalic)8859-11 <-> UTF-8*.UTF-8Unicode 3.0All of the aboveUTF-8 <-> ISO 646(ASCII)UTF-8<->ISO 8859-1 ~ -11, -15UTF-8<->KOI8-R<->UCS-2UTF-8<->UTF-7UTF-8<->UTF-16<->UCS-4,UTF-8<->PCK(aka SJIS)UTF-8<->various euc encodingsUTF-8<->ISO-2022-JP ~ -TW, -KR, -CNUTF-8<->BIG5UTF-8<->GBKUTF-8<->IBM MBCS CP933, CP935, CP937Note - CTL locales must be installed before CTL applications can be used.Chapter 33. Adding CTL Support to an ApplicationAdding CTL support to an application requires little or no change to the source code. Certain resources are set in the resource file to control the behavior of the language engine for all Text, TextField, and other static text. If an application was compiled in an earlier version of Solaris, the code should be recompiled in Solaris 8. Ensure that the application is linked to the default Motif library in Solaris 8 (libXm.so) which is linked to the latest Motif library (libXm.so.4). Add the flag -DSUN_CTL to Makefiles for compilation. For finer control over CTL attributes, such as cursor positioning and character and cell deletion, use the APIs provided in PLS with its configuration file. For more information about the Portable Layout Services APIs, see CAE Specification: Portable Layout Services: ISBN 1-85912-142-X To control CTL functionality in an application, use the following Motif resources: layoutModifier Visual modeDefault keystroke overridelayoutDirectionDynamically switch screen layout Step 1. Control the behavior of the language engine through the layoutModifier resource in the application resource file. For example, the default numeral type, text type, and text orientation can be changed using the following resource:*layoutModifier: @ls numerals=nominal:contextual,typeoftext=implicit:visual, orientation=ltr:rtlTable 3-1 ModifierValuesDescriptionorientation=in:outltrleft-to-right global orientation (default in and out) rtlright-to-left global orientationcontextualcontext-sensitive orientationnumerals=in:outnominal Arabic numerals (Latin) (default in) national national shaping of numeralscontextualnumeral shaping based on the context of the surrounding text (default out)swapping=valueyesenable symmetric swapping (default) nodisable symmetric swapping typeoftext=in:outvisualvisual order (default out) implicitlogical order (default in) explicitlogical order with embedded controlFor a complete list of layout modifiers, see Portable Layout Services: Context-Dependent and Directional Text: ISBN 1-85912-075-X.Step 2. Configure Hebrew and Arabic locales to support Visual mode for editing in the resource file as follows: *editPolicy: XmEDIT_VISUAL (default is XmEDIT_LOGICAL)Step 3. To override the default keystrokes in an application, make the necessary changes in the resource file, as shown in the following example: *XmText.translations: #override \n\ c <Key>q:right-word() \n\ c <Key>w:left-word() \n\ c <Key>g:forward-word(extend) \n\ c <Key>h:backward-word(extend) \n\ c <Key>f:next-line(extend) \n\ c <Key>b:previous-line(extend) \n\ c <Key>>:right-character() \n\ c <Key><:left-character() \n\ c <Key>t:prev-cell() \n\ c <Key>v:forward-cell() \n\ c <Key>+:delete-right-word() \n\ c <Key>-:delete-left-word() \n\ c <Key>r:right-character(extend) \n\ c <Key>l:left-character(extend) Step 4. The Motif resource layoutDirection can be used to set the right to left screen layout. In this screen mode, the screen origin is the top right corner and all application Motif widgets are mirrored. The following example shows how to set this in the resource file:*layoutDirection: XmBOTTOM_TO_TOP_RIGHT_TO_LEFTThis resource changes the layout of the whole application. To change the layout of some widgets only, such as Text or TextField, use the following:*XmText*layoutDirection: XmBOTTOM_TO_TOP_RIGHT_TO_LEFT *XmTextField*layoutDirection: XmBOTTOM_TO_TOP_RIGHT_TO_LEFTStep 5. The screen layout can be dynamically switched for the Text and TextField widgets by defining the dynamic switching hot keys in the Motif translation table. The following example shows how to add this function to the resource file:1-Text: *XmText.translations: #override \n\ Ctrl<Key>m:toggle-rtl-mode()2-TextField: *XmTextField.translations: #override \n\ Ctrl<Key>m:toggle-rtl-mode() Note - CTRL+m is defined as the key combination to dynamically switch the screen layout. Any key combination which doesn't interfere with the application hot keys can be defined instead. This entry can also be appended to the original key translation table as discussed in Step 3 above. Each locale provides text input and display in the locale language and in English. Solaris 8 also includes the print utilities ctlmp and ctlconvert_text which can be used to print the CTL text. ctlmp creates a PostScript file from a text file created in a CTL locale. The utility performs the necessary CTL transformations and ensures WYSIWYG printing support. For more information on ctlmp, see man ctlmp. ctlconvert_text creates a standard print file from a text file created in a CTL locale for printing on non-PostScript devices.