home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / x / xchars / !XChars / !Help next >
Text File  |  1995-11-28  |  10KB  |  199 lines
  1. XChars 1.01 (28-Nov-95)
  2.  
  3. Purpose:     Advanced chars utility
  4. Author:      Martin Würthner
  5. Runs under:  RISC OS 3.1 or higher
  6. Status:      FREEWARE (see below)
  7.  
  8. XChars is a replacement for the Chars utility that comes with RISC OS
  9. with a lot of additional features, such as:
  10. - multiple windows
  11. - outline fonts at arbitrary sizes
  12. - font aspect, line/character spacing control
  13. - different arrangements of characters (+optional display of ctrl chars)
  14. - configurable default settings
  15. - character zoom window at configurable size by clicking Adjust on a letter
  16.   (during the duration of the button press only or as a persistent window)
  17. - configurable character insertion hot key: Shift, Ctrl or Alt (both keys
  18.   or only left/only right key)
  19. - option to install an application icon on the icon bar
  20. - all options can be set independently in each window
  21. - "hotlist": the state of all options (font,font size,line spacing etc.) of
  22.   a window can be saved (associating a name with it) and restored later
  23.   from the hotlist menu
  24.  
  25. Starting XChars
  26. ---------------
  27. Double-click on the !XChars application to load it. Depending on the
  28. Startup options which have been set up, the application installs an
  29. icon on the icon bar and/or opens a character display window.
  30.  
  31. The XChars window
  32. -----------------
  33. Each window shows the full character set in one font. If you click SELECT
  34. on a character, it is inserted at the caret position in the application
  35. which currently owns the input focus (the window with the cream title bar).
  36.   If you click ADJUST, the character is displayed in a bigger 'zoom' window
  37. (note that this only works with outline fonts, not with the System font!).
  38. Depending on the 'Persistent zoom window' option in the Choices window (see
  39. below under "Choices window"), the zoom window disappears automatically as
  40. soon as you release the ADJUST button or it remains on screen (in the latter
  41. case it is called persistent). The persistent zoom window has a close icon,
  42. so you can close it just as any other window. To reopen it, simply click
  43. ADJUST again in any XChars window.
  44.   The font size to be used in the zoom window can be changed in the Display
  45. options window (see below).
  46.   When trying to enter text in a writable menu field or a transient
  47. dialogue box, the SELECT click method cannot be used, because this would
  48. cause the destination window to disappear. To overcome this problem, you
  49. can also insert a character by placing the pointer over it and pressing
  50. the character insertion hotkey (e.g. Ctrl). The hotkey to be used can be
  51. configured in the Choices window (see below).
  52.  
  53. Changing the font, font size etc.
  54. ---------------------------------
  55. The toolbar (at the top of each character window) shows the current font
  56. and the font size. The font can be changed by clicking on the pop-up menu
  57. button next to the font name and choosing a font from the menu.
  58.   If the current font is an outline font (i.e. not the System font), then 
  59. The size can be changed by using the up/down arrows or entering a number
  60. in the input field. The change only takes effect if you click on the OK
  61. button. A quicker way of changing the font size is to choose a size from
  62. the font size menu which appears if you click on the pop-up menu button
  63. next to the font size input field. This changes the font size immediately.
  64.   The arrangement of the characters can be changed from the window's menu:
  65. You can choose between 32 by 8,16 by 16 and 8 by 32. Also, if you select
  66. the option 'Show ctrl', then the window shows the control characters at
  67. the top row as inverted letters. So, e.g. to enter Ctrl-C, click SELECT
  68. on the inverted letter 'C'.
  69.   More advanced options are found in the Display options window: Choose
  70. 'Display options' from the window's menu to open it:
  71.  
  72. The Display options window:
  73. ---------------------------
  74. In this window you can change the font aspect, the line and character
  75. spacing and zoom font size. The font aspect determines the width of the
  76. characters in relation to their height. Normally, characters are displayed
  77. at 100% which is the default. If the aspect ratio is smaller than 100%, the
  78. characters appear narrow, if it is greater than 100%, they are expanded.
  79.   The next two options, line spacing and char spacing can in most cases
  80. be left at their default values, i.e. at 100%. XChars automatically leaves
  81. enough room vertically to accomodate even the highest character of the font.
  82. Horizontally, it uses by default 80% of the widest character (i.e. this
  83. corresponds to char spacing 100%) which is enough in almost all cases as it
  84. is very inlikely that two very wide characters are next to each other.
  85.   However, if you want more (or less) space between the rows/columns, then
  86. you can increase (or decrease) the line/char spacing.
  87.   The last value is the font size to be used in the character zoom window
  88. (this is the window you call up by clicking ADJUST on a character). This is
  89. set for each window individually, so if you have a persistent zoom box (or
  90. if you press and hold Adjust) the size of the zoom window may change as you
  91. move from one window to another.
  92.  
  93. Default settings
  94. ----------------
  95. The whole set of options can be saved as the default by choosing 'Save as
  96. default' from the window's menu. This means that any new window now has
  97. the properties of the current window, e.g. the font, font size etc.
  98.   This is saved to disc, so the next time you start the application it will
  99. still remember which default settings to use.
  100.  
  101. The hotlist
  102. -----------
  103. One of the most powerful features of XChar is the hotlist: You can add the
  104. complete state of a window including all options to the hotlist and give
  105. it a name. By choosing the entry from a menu later, you can recall the
  106. settings you associated with that name.
  107.   Supposed you use Dingbats quite often and you want it to be displayed at
  108. 24pt with a line spacing of 120%. Instead of setting all these options
  109. every time you want to view Dingbats, you can set them once and then add
  110. the current window state to the hotlist:  Click menu over the window and
  111. follow the submenu arrow of the entry "Add to hotlist". Then, type the name
  112. which you want to associate with these settings, e.g. "Dingbats" and click
  113. on OK.
  114.   To recall the settings later, click on the "A" icon to the left of the
  115. tool bar. This displays the hotlist. The first entry of the hotlist is
  116. always "Default". Choosing this restores the default settings. Below this
  117. entry, you can see all the additional entries. Choosing one of these
  118. restores the settings associated with the corresponding entry.
  119.   If you want to modify one of the entries, choose it, change the options,
  120. and then use "Add to hotlist" again without changing the name in the
  121. writable field. This overwrites the old definition with your modified one.
  122. A hotlist entry can be removed by choosing its name from the "Remove"
  123. sub-menu.
  124.   Like the default settings, the hotlist is immediately saved to disc
  125. every time you modify it.
  126.  
  127. The Choices window
  128. ------------------
  129. The Choices window is opened by choosing 'Choices...' from the icon bar menu.
  130. Obviously, this is only possible if there is an XChars icon on the icon bar.
  131. If there is not, the 'Choices...' entry is present in the main menu obtained
  132. by clicking Menu over any XChars window.
  133.   The Choices window allows you to configure some options which are global
  134. and do not belong to a particular window. These are the startup options,
  135. the character insertion hotkey and the zoom window behaviour:
  136.   When the application starts up it can either install an icon on the
  137. icon bar or open a window (or do both). Of course, doing neither of
  138. both is not sensible as in this case you could not access the application
  139. at all! This option only takes effect if you quit and re-load the
  140. application.
  141.   The character insertion hotkey can be either of Ctrl, Shift or Alt. As
  142. each of these keys appear twice on the keyboard, you can choose which one
  143. is to be used. If you want both keys to be active, select both option icons,
  144. 'Left key' and 'Right key'. By deselecting both option icons, the whole
  145. feature (character insertion by hotkey) can be disabled.
  146.   The last option in the Choices window determines whether the zoom window
  147. stays on the screen when yo