home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsd / evntshell / !TemplEd / Manual < prev    next >
Encoding:
Text File  |  1995-05-14  |  28.1 KB  |  695 lines

  1.  
  2.  
  3.                             TemplEd User Manual
  4.                             -------------------
  5.  
  6.  
  7. 1. About TemplEd
  8. ________________
  9.  
  10. TemplEd is a template editor. With it, you can create and edit Template
  11. files, which contain definitions of the windows used by an application. It
  12. is therefore only useful for people who write programs that run in the
  13. desktop.
  14.  
  15. If you want to know what can be in template definitions, and how they can
  16. be read by a program, read the information about the SWIs
  17. Wimp_CreateWindow, Wimp_CreateIcon and Wimp_LoadTemplate. This can be found
  18. in the RiscOS PRM (Programmer's Reference Manual), and on-line in Guttorm
  19. Vik's !StrongHlp application.
  20.  
  21. TemplEd is FreeWare. For conditions of use, read the copyright notice at the
  22. end of this manual.
  23.  
  24.  
  25. 2. About this manual
  26. ____________________
  27.  
  28. If you are an experienced user, the !Help file will probably contain enough
  29. information for you to get started. You may want to skip the boring
  30. discussion of TemplEd's operation that follows. However, there are some
  31. technical details that may be of interest. These have been marked with <TD>.
  32. There is also a list of operation shortcuts and "hidden" features at the end
  33. of this manual.
  34.  
  35.  
  36. 3. Starting the program and loading files
  37. _________________________________________
  38.  
  39. After you have double-clicked on the application, the program installs
  40. itself on the icon bar. A double-click on a Template file also starts
  41. TemplEd, after which TemplEd loads the file.
  42.  
  43. You can load a template file by:
  44.  
  45. * Double-clicking on a Template file. If TemplEd is running and has not
  46. loaded any templates, it loads the file. Otherwise, a new copy of TemplEd is
  47. started.
  48.  
  49. * Dropping the file on the TemplEd icon on the icon bar. TemplEd deletes the
  50. currently loaded templates, and loads the new file. If the current templates
  51. have been modified, TemplEd first asks you to confirm before deleting them.
  52.  
  53. * Dropping the file in the Templates window. TemplEd adds the templates in
  54. the file to the currently loaded ones.
  55.  
  56. If the file is called "Templates", then TemplEd will look for a sprite file
  57. called "Sprites" in the same directory. If there is such a file, TemplEd
  58. will assume that it contains the sprites to be used with the templates, and
  59. automatically loads the sprite file as well.
  60.  
  61. Other sprite files with sprites used in the templates, can be loaded by
  62. dropping them on the icon bar icon.
  63.  
  64. When you drop an application on the icon bar icon, TemplEd will load the
  65. file "Templates" in the application directory (if present). If there is a
  66. sprite file called "Sprites" in that directory, TemplEd will also load it.
  67.  
  68.  
  69. 4. Opening and closing a template window
  70. ________________________________________
  71.  
  72. A click with Select on the TemplEd icon on the icon bar opens the Templates
  73. window. This lists the currently loaded templates. A small window icon
  74. before the name indicates what type of window it is (scrollbars, title). A
  75. yellow background of this icon means that it is currently open.
  76.  
  77. You can open a template by double-clicking on its name. If the template was
  78. already open, it is closed. The "Open" and "Close" entries in the menu serve
  79. the same purpose.
  80.  
  81.  
  82. 5. Selecting icons
  83. __________________
  84.  
  85. Many operation on icons can be done on a single icon but also on a selection
  86. of icons. There are several ways to select (and deselect) icons:
  87.  
  88. * Click with Select to select a single icon while deselecting the others. A
  89. click on the background of the window clears the current selection.
  90.  
  91. * Click with Adjust to select an icon, without changing the rest of the
  92. selection. If the icon was already selected, it is deselected.
  93.  
  94. * A drag with the mouse creates a drag-box in the window area. When you
  95. release the mouse button, all icons within the box are selected.
  96.  
  97. * There are "Select all" and "Clear selection" items in the menu.
  98.  
  99. <TD> Like most other template editors, TemplEd creates a window for each
  100. template, and creates icons exactly as they have been defined. This means
  101. that the Wimp reacts to the mouse just as it would when a program was using
  102. the template. That's why a menu icon is hard to select: you can click on
  103. it, but if you move the pointer away from the icon, the icon is deselected
  104. again. The Wimp also interferes if you want to select several radio buttons
  105. from the same ESG. Even if you click with Adjust, the Wimp deselects the
  106. other buttons (unless their 'Allow adjust' bit is set). You can select these
  107. "difficult" icons with a drag-select.
  108.  
  109. <TD> If you want to check the behaviour of icons to mouse clicks, without
  110. TemplEd reacting to the clicks, press a combination of keys (e.g. Shift +
  111. Alt) while clicking. That way you can check if the ESGs of radio buttons
  112. are set right, if option buttons are switched on and off, etc.
  113.  
  114.  
  115. 6. Moving and resizing icons
  116. ____________________________
  117.  
  118. To move an icon or a selection, click inside the window with Select while
  119. holding down the Shift key. An outline appears around the icon(s) that moves
  120. with the pointer until you release the mouse button. During the operation,
  121. the pointer shape is changed to a hand.
  122.  
  123. To resize an icon or a selection, click on it with Shift+Adjust. A "rubber
  124. box" drag is started, allowing you to move one side. The side that is moved
  125. is the one that was nearest to the pointer when you clicked. It is also
  126. indicated by the pointer shape. Though a resize operation will usually be
  127. done on a single icon, it is possible to resize more than one icon at a
  128. time; the icons are scaled according to the size of the drag-box.
  129.  
  130. An alternative way to move or resize icons is by clicking on them without
  131. using the Shift key, and keeping the mouse button pressed for about half a
  132. second.
  133.  
  134. During the drag, you can move the pointer with the cursor keys. The left,
  135. right, up and down keys move the pointer 1 pixel (in the expected
  136. direction). If you press a cursor key in combination with the Shift key, the
  137. movement is 4 times as fast.
  138.  
  139. Pressing the cursor keys without starting a drag first moves the selected
  140. icons.
  141.  
  142.  
  143. 7. The "Icon Edit" dialogue window
  144. __________________________________
  145.  
  146. Except for size, position and number, all properties of an icon can be set
  147. from the "Icon Edit" dialogue window. To open this window, click with
  148. Shift+Menu, or choose the "Icon ⇨ Edit..." entry in the menu.
  149.  
  150. Icon flags can be set by clicking on the buttons, text and sprite names can
  151. be entered in the appropriate fields. Use the up and down arrow keys to move
  152. the cursor around. Some fields (e.g. button type, colours, font name) can
  153. contain a limited number of values. These can be selected either by clicking
  154. on the arrow icons to the left and right, or by clicking a mouse button
  155. while the pointer is over the field. This pops up a menu from which you can
  156. select a value.
  157.  
  158. <TD> The "1:1" button for the font is the only button not connected to an
  159. icon flag. When on, it keeps X and Y size of the font equal, so you don't
  160. have to set them both.
  161.  
  162. The changes to the icon only take effect if you press the "Update" icon.
  163. "Exit" closes the window, leaving the icon as it was since the last update,
  164. and "Update & Exit" combines the two.
  165.  
  166. <TD> If the indirected text that you entered is longer than the "Max
  167. size" field allows, TemplEd automatically increases the maximum. It also
  168. sets the "Indirected" flag if the text or sprite name uses more than 12
  169. characters.
  170.  
  171. When you edit a selection of icons, not all fields can be modified (to be
  172. exact: only the icon flags). The unchangeable fields are shaded. When you
  173. press "Update" or "Update & Exit", the changeable fields are modified in
  174. all selected icons.
  175.  
  176. In some cases, you may only want to change one field (e.g. set the button
  177. type of all icons). To do this, click Menu above the "Update" or
  178. "Update & Exit" button. A menu pops up from which you can select the flags
  179. that must be changed.
  180.  
  181.  
  182. 8. Moving and resizing windows
  183. ______________________________
  184.  
  185. Usually, you can move a window by dragging the title bar, and you resize it
  186. by dragging its resize icon. But some windows don't have a resize icon, and
  187. some don't even have a title bar. You could of course edit the windows, give
  188. them a title bar or resize icon, and remove these when you are done. But in
  189. TemplEd, it is also possible (and much faster) to move and resize windows
  190. directly. Use Ctrl+Select to move a window, and Ctrl+Adjust to resize it.
  191.  
  192. The work area of the window can also be resized with the mouse, with
  193. Ctrl+Alt+Adjust. When you release the mouse button, the work area is set so,
  194. that it stretches to the bottom-right corner of the visible part of the
  195. window.
  196.  
  197. <TD> To enable the work area to expand, it is made very large at the start
  198. of the drag. This is visible if your window has a scroll bar. At the end of
  199. the drag, the area is shrunk again to the desired size.
  200.  
  201. Just as with moving and resizing icons, the cursor keys can be used during
  202. the drag to position the mouse pointer.
  203.  
  204.  
  205. 9. The "Window Edit" dialogue window
  206. ____________________________________
  207.  
  208. Editing the data of a window is split in two parts. Flags, colours and
  209. button type are edited in the "Window Edit" dialogue window. This window
  210. is opened when you click Ctrl+Menu over the window, The contents of the
  211. title bar are edited separately, using the "Icon Edit" window. It is
  212. accessible with a Shift+Menu click while the pointer is over the title bar.
  213. Both dialogue windows can also be opened from the menu.
  214.  
  215. <TD> The "transparent" colour number 255, that has a special meaning as the
  216. title foreground colour or as the work background colour, is only selectable
  217. from the colour menu, not by clicking on the arrow icons.
  218.  
  219.  
  220. 10. TemplEd's menus
  221. ___________________
  222.  
  223. Most entries in the menus ought to speak for themselves. Some others may
  224. take a small explanation:
  225.  
  226. 10.1 The "Window" menu
  227.  
  228.   Create ⇨
  229.  
  230.   Leads to a submenu with a number of standard icons. Selecting one of these
  231.   creates such an icon, at the position that the pointer was on when the
  232.   menu was popped up. Selecting the "Create" entry itself is equal to
  233.   selecting the first standard icon from the menu.
  234.  
  235.   You can change the set of standard icons, see the section "Customizing" at
  236.   the end of this manual.
  237.  
  238.   <TD> The new icon will be positioned so that its bottom-left corner is at
  239.   the position where the pointer was when you popped up the menu.
  240.  
  241.   Icon/Selection ⇨ Renumber ⇨
  242.  
  243.   You can renumber single icons or selections. When a selection is
  244.   renumbered, the icons are numbered from top to bottom and from left to
  245.   right.
  246.  
  247.   <TD> It is not possible to give an icon a number that is equal to or
  248.   higher than the number of icons in the template. If for instance there
  249.   are 10 icons, they are always numbered from 0 to 9. You may enter a
  250.   higher number but TemplEd will decrease it to 9. (In fact, what TemplEd
  251.   does when renumbering is swap the definitions of two icons: the one that
  252.   you want to renumber, and the one carrying the new number.)
  253.  
  254.   <TD> After renumbering an icon, TemplEd increases the new number by one
  255.   and stores it. You can see this the next time you open the menu. This
  256.   feature comes in handy when you renumber using Alt+Select (see
  257.   "Shortcuts")
  258.  
  259.   Icon/Selection ⇨ Align ⇨
  260.  
  261.   Changes the selected icons so that they are lined up. There is a choice
  262.   of aligning the left-hand sides, right-hand sides, top, bottom, and the
  263.   centres (in either the horizontal or vertical direction).
  264.  
  265.   The icons can be either moved or resized. When resized, the coordinates
  266.   of the icons stay the same except for the side that must be aligned.
  267.  
  268.   <TD> As an anchor for aligning, the outer icon is chosen. For horizontal
  269.   aligning this is the leftmost icon, for top aligning the topmost, etc.
  270.   This ensures that if the icons were inside the visible area before the
  271.   aligning, they will remain fully visible afterwards (except for some cases
  272.   when you align the centres).
  273.  
  274.   Icon/Selection ⇨ Space out ⇨
  275.  
  276.   Moves the selected icons so that there is a constant space between the
  277.   icons. You can choose between horizontal and vertical distribution, and
  278.   between setting a fixed space and using the available space between the
  279.   outer icons. For example:
  280.  
  281.   Suppose you have four icons, positioned
  282.  
  283.      -----               -------  ---        ---
  284.     |  A  |             |   B   || C |      | D |
  285.      -----               -------  ---        ---
  286.  
  287.   Using a fixed space gives you something like
  288.  
  289.      -----    -------    ---    ---
  290.     |  A  |  |   B   |  | C |  | D |
  291.      -----    -------    ---    ---
  292.  
  293.   and choosing "Use available" results in
  294.  
  295.      -----        -------        ---         ---
  296.     |  A  |      |   B   |      | C |       | D |
  297.      -----        -------        ---         ---
  298.  
  299.   <TD> Before doing a Space out operation, TemplEd sorts the icons on their
  300.   minimum coordinate. This means that the leftmost (or bottommost) icon
  301.   always remains in place. It also means that if some icons have equal
  302.   minimum X (or Y) coordinates, they may end up in any order.
  303.  
  304.   <TD> Both the "Align" and the "Space out" operations change the position
  305.   of icons in only one direction. So if you do a horizontal Space out, the Y
  306.   coordinates of the icons remain the same.
  307.  
  308.   Icon/Selection ⇨ Min. size
  309.  
  310.   Minimizes the size of icons, keeping their bottomleft corner at the same
  311.   position.
  312.  
  313.   <TD> It is very complicated to calculate the minimum size correctly,
  314.   especially for icons with outline fonts, 3D borders or multi-line text.
  315.   The procedure used may not always give the best results.
  316.  
  317.   Icon/Selection ⇨ Center
  318.  
  319.   Centers the icon (or icon selection) in the window, relative to the
  320.   area that is currently visible.
  321.  
  322.   Icon/Selection ⇨ Same size
  323.  
  324.   Sets the size of the selected icons to be equal to the topleft one. The
  325.   bottomleft corner is kept at the same position.
  326.  
  327.   Work area ⇨
  328.  
  329.   Leads to a window in which you can set the dimensions of the window work
  330.   area. The "Minimize" button limits the work area to the maximum
  331.   coordinates that are currently visible. The "Maximize" button sets the
  332.   minimum size equal to the current window size. The "Default" button resets
  333.   all values to those of a standard full-screen window.
  334.  
  335.   Misc ⇨ Sprite area
  336.  
  337.   Enables you to choose from which sprite area the sprites in the template
  338.   are read. This can be either the Wimp area or a private area that is
  339.   created when you drop a sprite file on the TemplEd icon.
  340.  
  341.   <TD> When saving templates, TemplEd always sets the sprite area to 1 (i.e.
  342.   the Wimp area). If your program is using a private sprite area, it will
  343.   have to re-direct the sprite area pointers after it has loaded the
  344.   template.
  345.  
  346.   Misc ⇨ Ensure icons ⇨
  347.  
  348.   From this submenu, you can let TemplEd check the position of the icons,
  349.   and move them if needed. The first item in the submenu make sure that all
  350.   icons are within the work area, the second ensures that they are in the
  351.   currently visible part of the window.
  352.  
  353.   Misc ⇨ Deleted icons ⇨
  354.  
  355.   Normally, when you delete an icon, it is only marked as deleted. Most of
  356.   the icon data is retained, and the numbering of the other icons stays the
  357.   same. If, later on, you create an icon, it may get the number of a
  358.   deleted icon. Until that time, it is possible to "undelete" the icon.
  359.   From this submenu, you can:
  360.     * Undelete the deleted icons (e.g. if you accidentally deleted them)
  361.     * Undelete them and move them outside the work area. This can be handy
  362.       if you want to avoid that the icon numbers are used again when you
  363.       edit other icons
  364.     * Purge the deleted icons, so that there are no gaps in the numbering
  365.  
  366.   Note that for indirected icons, the indirected data can not be retrieved.
  367.  
  368. 10.2 The "Templates" menu
  369.  
  370.   Export ⇨ Icon names
  371.  
  372.   This leads to a save-box from where you can save the icon names. The point of
  373.   icon naming is that it allows your program to address icons by their name,
  374.   instead of by the icon number (which may change when editing the template).
  375.   That way, you don't have to adapt the source code after you modified the
  376.   templates. The file with icon names can be read by the program when it starts
  377.   up, or by a C compiler.
  378.  
  379.   You give an icon a name by putting an 'N'-command in the validation string.
  380.   The format of the icon names in an exported file is
  381.     <template name> + "_" + <icon name>
  382.  
  383.   You can save the names in 3 formats:
  384.     * Basic    - creates a Basic file with a procedure PROCiconnames.
  385.     * C        - creates a C header file in which the names are #define'd
  386.     * MsgTrans - creates a text file which can be read by the MsgTrans module 
  387.  
  388.   NB: This is an 'unofficial' feature, since icon names are not part of the
  389.   template definition. The 'N'-command is not recognized by RiscOS, and has
  390.   no effect on the appearance of the icon.
  391.  
  392.   Export ⇨ Templates
  393.  
  394.   This creates a textual description of the templates.
  395.  
  396. 10.3 The icon bar menu
  397.  
  398.   Options...
  399.  
  400.     Opens a window in which you can set a number of options:
  401.     * Double click starts edit
  402.         When on, TemplEd reacts to double-clicks on icons, window title bar
  403.         or background, by opening the appropriate Edit window.
  404.     * Support 'Interface'/'AEH'/'WimpExt' module
  405.         Provides limited support for one of these modules, by making the
  406.         appropriate calls for redrawing icons. The modules provide a number
  407.         of enhancements to the Wimp, among which icon borders with 3D look.
  408.         Addresses of the people who made these modules are listed at the end
  409.         of this file.
  410.         <TD> Support is limited to redrawing icons, including selecting and
  411.         deselecting them upon a click. Other features are not supported.
  412.     * Allow duplicate template names
  413.         If this option is off and a template is added with a name that
  414.         already exists, the old template is deleted. Renaming a template to
  415.         an existing name will also be refused.
  416.     * Hatch user-redrawn templates
  417.         When on, the background of windows of which the "Auto-redraw"
  418.         flag is cleared, will be shown with a cross-hatch pattern.
  419.     * Show icon info
  420.         Enables or disables the Icon info window that shows information
  421.         on the icon that the pointer is currently over.
  422.     * Save icons as unselected
  423.         When on, TemplEd stores all icons as unselected when you save any
  424.         templates. Otherwise, the "selected" state of icons is saved with
  425.         the rest of the data to the file, and when your program uses the
  426.         templates, it will have to make sure that the correct icons are
  427.         selected.
  428.     * Delete icons moved outside
  429.         If you move icons, and drop them outside a template window, they
  430.         will be deleted if this option is on. When off, nothing happens to
  431.         the icons. This option allows for fast deletion of icons.
  432.     * Min. size: Ignore desktop font
  433.         This option is only meaningful if you are working under RiscOS 3.50
  434.         or later, where you can use an outline font for the desktop. If the
  435.         option is off, and TemplEd is calculating the minimum icon size, it
  436.         takes the text width in the Desktop font. However, that width may not
  437.         be enough for other users, who use a different font. That ruins the
  438.         layout. With this option on, TemplEd takes the text width for the
  439.         system (BBC) font, which is usually wider than outline fonts.
  440.     * Grid
  441.         Locks the position of icons that are created or modified to
  442.         a grid (as in !Draw). This makes it easier to get icons lined
  443.         up properly. The grid size can be set by clicking on the arrow
  444.         icons. There are two grids:
  445.           - Icon size grid
  446.             Locks all four corners of an icon, so that its size will be a
  447.             multiple of the grid size
  448.           - Icon position grid
  449.             Locks only the bottomleft corner of the icon; this can be handy
  450.             if you want to keep icons lined up, but want to keep their sizes
  451.             unchanged
  452.         Normally, the Icon position grid will be at least as large as the
  453.         Icon size grid.
  454.         <TD> If you are working in a high-resolution screen mode, it is
  455.         advisable to use at least an Icon size grid of 2x4, so that your
  456.         templates look the same in medium-resolution modes (like 12 and 15)
  457.         <TD> TemplEd automatically adjusts the grid size in case of a mode
  458.         change; the grid size must be at least equal to the number of OS
  459.         units per pixel.
  460.  
  461.     The "Save & Exit" button stores the current settings to a file in
  462.     the application directory, then closes the window. The "Exit" button
  463.     just closes the window.
  464.  
  465.   Statistics...
  466.  
  467.     Opens the statistics window, showing the amount of memory that the
  468.     templates will need if you use them in a program. The amounts can be
  469.     shown in decimal or hexadecimal numbers.
  470.  
  471.     <TD> Note that the statistics window does not change as you modify your
  472.     templates. The figures are re-calculated only when the window is opened
  473.     or when you click on the "Decimal" or "Hex" buttons.
  474.  
  475.   Custom sprites ⇨ View/Edit
  476.  
  477.     "Run"s the file with the custom sprites that your templates are using.
  478.     This normally means that !Paint will load the file.
  479.  
  480.   Custom sprites ⇨ Re-load
  481.  
  482.     Reads the sprite file again, e.g. after you have edited it with !Paint.
  483.  
  484.   Custom sprites ⇨ Reset
  485.  
  486.     Removes the sprites from memory; the templates will use the sprites from
  487.     the Wimp area.
  488.  
  489.  
  490. 11. Shortcuts
  491. _____________
  492.  
  493. * Opening the Icon Edit and Window Edit windows can be done from the menu,
  494. but a faster way is to click on them while pressing a key. Shift+Menu opens
  495. the Icon Edit window. Ctrl+Menu opens the Window Edit window. To edit the
  496. title bar icon, click Shift+Menu on the title bar.
  497.  
  498. * The Edit windows can also be opened with a double-click with the Select
  499. button. Double-clicks on an icon, on the background of a window, or on the
  500. title bar open the appropriate Edit window. This only works if the
  501. corresponding option is on.
  502.  
  503. * Inside the Icon Edit and Window Edit windows, pressing the F2, F3 and F4
  504. keys has the same effect as clicking on the Update, Update&Exit and Exit
  505. icons, respectively. The Escape key has the usual function which is exiting
  506. without doing anything. Escape works not only in these two cases, but in all
  507. windows with writable icons, such as the Save, Space Out and Options
  508. windows.
  509.  
  510. * Many operations on icons can also be done with a control-key:
  511.  
  512.       Ctrl-A    Select all
  513.       Ctrl-C    Copy selection
  514.       Ctrl-D    Copy icons downward
  515.       Ctrl-E    Edit selection
  516.       Ctrl-J    Open "Align" box
  517.       Ctrl-K    Open "SpaceOut" box
  518.       Ctrl-L    Copy icons to left
  519.       Ctrl-Q    Close window (Ctrl-F2 works, too)
  520.       Ctrl-R    Copy icons to right
  521.       Ctrl-T    Edit title bar
  522.       Ctrl-U    Copy icons upward
  523.       Ctrl-W    Edit window
  524.       Ctrl-X    Delete selection
  525.       Ctrl-Z    Clear selection
  526.  
  527. (This only works if the window has the input focus, of course)
  528.  
  529. * Renumbering icons can also be done faster. Click Alt+Select on an icon,
  530. and the icon gets the number that is visible when you open the "Icon ⇨
  531. Renumber" menu. After the renumbering, this number is increased by one, so
  532. you can number the icons sequentially by clicking on them one by one. A
  533. click with Alt+Adjust does the same, except that the number is decreased
  534. after the renumbering.
  535.  
  536. * A fast way to delete icons is by moving them outside the template. (This
  537. only works if you have set the "Delete icons moved outside" option on.)
  538.  
  539.  
  540. 12. "Hidden" features
  541. _____________________
  542.  
  543. TemplEd has a number of features that may not be immediately visible, but
  544. can come in handy. (That's not counting the bugs ;-)
  545.  
  546. * It is possible to copy icons to other templates; just move the icons and
  547. drop them into the other template. This makes it easy to use icons from
  548. other templates.
  549.  
  550. * Extended icon info. When TemplEd starts, the Icon info window is small,
  551. showing only the name of the template and number of the icon that the mouse
  552. is over. If you click on the "toggle size" icon, it becomes full size and
  553. also shows the dimensions of the icon plus the mouse position in window
  554. coordinates. Still more icon info can be gotten from !Help, Acorn's
  555. interactive help application. Open the help window, and move the pointer
  556. over an icon.
  557.  
  558. * Fine-tuning when moving and resizing icons and windows is possible with
  559. the cursor keys. The up, down, left and right keys move the pointer 1 pixel
  560. (or 4 pixels, if Shift is pressed).
  561.  
  562. * Pressing Esc during dragging (icon move, resize, etc.) aborts the
  563. operation.
  564.  
  565. * In the Icon Edit window, clicking Adjust on "Max Size" (the text itself,
  566. not the writable icon) minimizes the value of the "Max Size" field.
  567.  
  568. * Closing the Templates window with the Adjust button opens a Filer window
  569. of the parent directory of the file you are editing. Shift+Adjust also opens
  570. the Filer window but does not close the Templates window. (This is, in fact,
  571. standard Acorn practice for editor-like applications.)
  572.  
  573.  
  574. 13. Customizing
  575. _______________
  576.  
  577. Apart from setting the options, you can also customize TemplEd's menu of
  578. standard icons. Load the file "Templates" in the application directory into
  579. TemplEd. The template "StdIcons" contains the definitions of the standard
  580. icons. TemplEd loads them at program startup. You can change these
  581. definitions to your liking, but bear the following in mind:
  582.  
  583. * There are "name" icons that contain the text of the menu entries. They
  584. must be indirected-text icons, with their ESG set to 31.
  585.  
  586. * The other icons contain the definitions. These MUST have a different
  587. value for the ESG (i.e. 0-30). TemplEd links them to the "name" icon with
  588. the number preceding them. For instance, suppose icons 0 and 3 are "name"
  589. icons. This means that icon 1 and 2 are taken as a group belonging to
  590. icon 0. When you select the text in icon 0 from the "Create icon ⇨ "
  591. submenu, these two icons will be copied to your template window.
  592.  
  593. For those who prefer windows without the 3D-look, there is an alternative
  594. set of templates and sprites. To make TemplEd use them, rename them to the
  595. default "Templates" and "Sprites", after you have given the standard "3D"
  596. files a different name. (Note: you need Risc OS version 3.10 or later to
  597. get the 3D effect.) Alternatively, run the "Use2D" Obey file in the "Extras"
  598. directory; run "Use3D" to switch back to standard templates.
  599.  
  600.  
  601. 14. Credits
  602. ___________
  603.  
  604. Although the edit-dialogue windows are my own idea, not all features
  605. implemented in TemplEd are. Some have been borrowed from RiscForm (the
  606. version of !FormEd by The Risc Squad), some from Jonathan Marten's excellent
  607. !DrawPlus (notably the Align and Space Out windows).
  608.  
  609. Martin Ebourne made the hires sprites file (!Sprites22). The MenuUtils
  610. module which TemplEd uses was written by Alex Petrov.
  611.  
  612. TemplEd has also been much improved by the testing, comments and suggestions
  613. of Stephen Burke, Martin Ebourne, Michael Ellis, Edwin Hautus, Paul Hobbs,
  614. Rupert Johnson, Merlin Hughes, Olaf Krumnow, Paul Lebeau, Ian Palmer, John
  615. Pullan, Niklas RÖjemo, John Tytgat, Julian Wright, and I'm sure I forgot
  616. some others.
  617.  
  618.  
  619. 15. Copyright notice
  620. ____________________
  621.  
  622. This program is FreeWare. This means that I retain the copyright. You may
  623. freely copy and distribute it, provided that it is complete with all
  624. original files, and that you do not sell it. PD libraries may charge a
  625. nominal fee for the cost of duplication, postage etc. When you use the
  626. program, you do so entirely at your own risk. You may change the program to
  627. suit your own needs. If it's a bug fix, or if you think it's an improvement,
  628. then please send the changes to me at the address below.
  629.  
  630. The MenuUtils module is © Alex Petrov.
  631.  
  632.  
  633. 16. Addresses
  634. -------------
  635.  
  636. Here are contact addresses for software used by or supported by TemplEd
  637. Note that these are the most recent that I know, so they may be out of date. 
  638.  
  639. The MenuUtils module (PD):
  640.     Alex Petrov
  641.     Bld. 1, Flat 107
  642.     Kavkazsky
  643.     boulevard, 29
  644.     Moscow 115541
  645.     RUSSIA.
  646.     (e-mail: APetrov@misis.msk.su)
  647.  
  648. The Interface module (PD):
  649.     SoftWare Interrupt Developments.
  650.     40 Castle Ings Gardens,
  651.     New Farnley,
  652.     LEEDS,
  653.     LS12 5EG
  654.     UK.
  655.  
  656. The AEH module (Shareware):
  657.     Andrew Hersee
  658.     The Red House
  659.     Tallington
  660.     Nr.STAMFORD
  661.     Lincs.
  662.     PE9 4RP
  663.     UK.
  664.     (e-mail: ahersee@warwick.ac.uk)
  665.  
  666. The WimpExt module (PD):
  667.     Jon Ribbens
  668.     39 Nutkins Way
  669.     Chesham
  670.     Bucks.
  671.     HP5 2BE
  672.     UK.
  673.  
  674. StrongHelp (PD):
  675.     Guttorm Vik
  676.     Hølbekken 208
  677.     N-5262 Arnatveit
  678.     NORWAY
  679.     (e-mail: guttorm@vestnett.no)
  680.  
  681.  
  682. 17. Finally
  683. ___________
  684.  
  685. If you have any questions, bug reports or suggestions for improvements,
  686. you can contact me at the following address:
  687.  
  688. Lijnslagerstraat 204
  689. NL-5625BP  Eindhoven
  690. The Netherlands
  691.  
  692. or by e-mail: wsinda@info.win.tue.nl
  693.  
  694. Dick Alstein
  695.