home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities / _templed / !TemplEd / TechDocs < prev    next >
Encoding:
Text File  |  1994-07-04  |  12.1 KB  |  265 lines
  1. Version history
  2. ---------------
  3.  
  4. 1.29 Bugs fixed:
  5.       . Did not check for proper file type when trying to load sprite file
  6.         called "Sprites"
  7.       . Weird behaviour when clicking all mouse buttons above Statistics
  8.         window
  9.       . WindowEdit window showed flags for "Scroll events" wrongly (when
  10.         "repeat" button was on, the "1" flag was set, and vice versa);
  11.         flags were set correctly, though
  12.      Additions:
  13.       . Export templates as text file
  14.       . Loads sprite file "Sprites22" or "Sprites23" instead of "Sprites"
  15.         when present (and provided you have configured the appropiate
  16.         monitor type)
  17.  
  18. 1.28 Bugs fixed:
  19.       . Got error on startup when support for WimpExt was in Options file
  20.      Additions:
  21.       . Archive 'StyleGuide' in the 'Extras' directory, contains example
  22.         templates from the RiscOS 3 Style Guide
  23.       . New set of standard icons (in the 3D templates) by Neil Spellings.
  24.         These conform to the Style Guide and are suited for RiscOS 3.5.
  25.         Neil also provided an overview of the standard icons, as listed in
  26.         the Style Guide (see the file 'NewIcons' in the 'StyleGuide'
  27.         archive)
  28.       . Statistics window: choice of decimal/hex numbers saved in Options
  29.         file
  30.  
  31. 1.27 Bugs fixed:
  32.       . Deleting icons by dragging them outside a window had stopped
  33.         working (since v. 1.24)
  34.       . Gave error when trying to edit title bar with outline font in it
  35.       . Corrected calculation of minimum icon size for text+sprite icons
  36.         with empty text string
  37.      Additions:
  38.       . Fast resizing of work area, with Ctrl+Alt+Adjust
  39.  
  40. 1.26 NOTE: For this version the source code has been left out of the
  41.         distribution, because the archive was getting rather large.
  42.         (From version 1.27 on, the source is distributed separately.)
  43.      Bugs fixed:
  44.       . Decreased minimum size of drag-box when resizing icons. Old
  45.         minimum (16x32) made it difficult to create sliders.
  46.      Additions:
  47.       . Added support for the WimpExt module. Like the Interface and AEH
  48.         module, this contains a number of extensions to the Wimp (3D
  49.         buttons, pointer change), plus a lot of other support for Wimp
  50.         applications.
  51.       . Can use the OLESupport module: changes in the file with custom
  52.         sprites (e.g. with !Paint) are signalled by the module; TemplEd
  53.         then re-loads the sprite file. (So you don't need to select
  54.         'Re-load' from the menu)
  55.  
  56. 1.25 Bugs fixed:
  57.       . Move icons with cursor keys only (i.e. no drag) gave error if
  58.         you hadn't dragged any icons in the same window first
  59.       . Gave 'Mistake' when deleting a template (though deleting did work)
  60.       . 'Min size' on sprite icons: looks for sprite in Wimp area if not
  61.         found in custom area
  62.      Additions:
  63.       . 'Keep on Screen' and 'Ignore extent' window flags can be edited
  64.         (these flags are for RO3 only)
  65.       . 'Tidy icons' replaced by multiple options
  66.       . From Acorn's !NewLook: 3D sprites, and the BorderUtils module
  67.         (contains fix for the '3D-button bug')
  68.  
  69. 1.24 Bugs fixed:
  70.       . Font usage counting revised again. Version 1.23 might lose a font
  71.         while still in use for an icon, resulting in 'Illegal font handle'
  72.         error
  73.       . Incorrect PROC call within PROCsetworkarea. No one complained, so
  74.         apparently the line is rarely executed
  75.       . Gave an error if an icon resize-drag ended outside the template
  76.      Additions:
  77.       . Pressing the cursor keys moves the currently selected icons
  78.         (without needing to drag with Shift+Select)
  79.       . When editing multiple icons, you can now set just 1 aspect: click
  80.         with Menu on 'Update' or 'Update & Exit'; then choose which flags
  81.         you want to change. The other settings of the icons remain the same
  82.       . Menu items to View/Re-load/Reset the custom sprites. (The 'View'
  83.         item just Filer_Runs the sprite file; use 'Re-load' after editing
  84.         the sprites; 't would be nice if !Paint supported the External Edit
  85.         protocol...)
  86.       . (Due to popular demand:) Pointer changes above appropriate icons in
  87.         the Icon Edit and Window Edit windows (was: only if using the 3D
  88.         templates). Not for RiscOS 2
  89.       . To minimize the 'Max size' field, click with Adjust on the
  90.         'Max size' text icon (sets number to length of text + 1)
  91.      
  92. 1.23 Bugs fixed:
  93.       . PLEASE NOTE: Use of function keys in the Edit windows has changed:
  94.           F2 = Update
  95.           F3 = Update & Exit
  96.           F4 = Exit
  97.         F1 is for activating interactive help, be it !StrongHelp or RiscOS
  98.         !Help. (This also follows Acorn guidelines)
  99.       . If a drag-select ended with the pointer over another window, the
  100.         icons in that window were selected (instead of in the window where
  101.         the drag started ...)
  102.       . Input focus wasn't shown correctly for templates with 'Pane' bit set
  103.         (instead, the non-pane window that was last opened, was highlighted)
  104.       . Count of font usage not always correct; sometimes caused the
  105.         counting by the FontManager to be too high
  106.       . Extended icon info (via !Help) gave wrong ESG number
  107.      Additions:
  108.       . During icon move/resize, Icon info window shows coords of drag-box
  109.         (thanks to Paul Hobbs for showing that it can be done)
  110.         This means that for single icons you can see the new position and
  111.         size during the drag.
  112.       . Interactive help for Icon Edit and Window Edit windows: press F1
  113.         with pointer above a button, to get help on the flag that this
  114.         button represents (!StrongHelp and !TemplHlp must be loaded first)
  115.       . Double grid:
  116.           - 'Icon size' grid locks all corners of the icons
  117.           - 'Icon position' grid locks the bottomleft corner, leaving the
  118.             size unchanged
  119.       . 'Same size' for icon selections
  120.       . Cooperates in desktop save (RiscOS 3)
  121.       . TAB key can be used to move the caret in dialogue windows
  122.  
  123. 1.22 Bugs fixed:
  124.       . Copying templates caused an error, due to a brilliant new bug in
  125.         version 1.21
  126.       . Better calculation of minimum icon size
  127.       . Revised renumbering of icon selection
  128.      Additions:
  129.       . Filer-like browser window
  130.       . Hotkeys for Align, Space Out and for Copy Up/Down/Left/Right
  131.       . When editing title bar, you can set its colours from the Icon
  132.         Edit window (was: from Window Edit window only)
  133.       . Pressing Esc during a drag aborts it
  134.       . Moving icons to other templates is equivalent to copying
  135.       . Prevents desktop shutdown if data is changed & not saved
  136.       . Menus over Edit windows (Button type, ESG, Font etc.) pop up
  137.         when ANY mouse button is pressed (was: only for Menu button)
  138.  
  139. 1.21 Bugs fixed:
  140.       . Sprite area pointer of windows was not reset to 1 (Wimp area) when
  141.         saving
  142.       . Saving to other applications (via Wimp$Scrap) now properly supported
  143.         Now it is possible to exchange templates between 2 copies of TemplEd
  144.       . Another bug in Wimp_LoadTemplate (#$&$#%@!!!): it expects some
  145.         indirected data for an indirected non-text, non-sprite icon.
  146.         Although the indirected data is not used, it won't digest an
  147.         invalid pointer.
  148.      Additions:
  149.       . Uses DragASprite in save windows
  150.       . Hotkeys for some functions (^Z, ^X, ^C etc.)
  151.       . Windows can be centered to the screen
  152.       . Icons can be centered to the window
  153.       . Support for AEH module
  154.       . 'Minimize size' for icons
  155.       . Using cursor keys to move pointer now also works for moving/
  156.         resizing windows (when done using Ctrl+Select/Ctrl+Adjust)
  157.       . When loading a templates file called 'Templates', TemplEd
  158.         automatically loads the 'Sprites' file from same directory, if such
  159.         a file exists
  160.       . MaxFonts% limit removed: font menu can contain any number of font
  161.         families
  162.       . If browser window is closed, all template windows are closed, too
  163.  
  164. 1.20 Bugs fixed:
  165.       . Templates with deleted, indirected icons were saved without any
  166.         indirected data; Wimp_LoadTemplate gave an error when reading this,
  167.         because it expects some indirected data. (Weird...)
  168.       . TemplEd's own templates may now contain outline fonts (including
  169.         the custom icons for the 'Create icon' submenu)
  170.       . Would not run together with Joris Rölings !FontSelect utility; the
  171.         FontLister module did not like the way TemplEd (v1.11) reads the
  172.         font names.
  173.      Additions:
  174.       . Resizing of a selection of icons
  175.       . Reads 'Templates' and 'Sprites' file of an application when its icon
  176.         is dropped on the icon bar
  177.       . Renumbering of a selection of icons
  178.       . Moving the mouse pointer during icon move/resize: cursor keys move
  179.         the pointer 1 pixel, or 4 pixels when combined with the Shift key
  180.       . When creating standard icons (from the 'Create icon' submenu), you
  181.         can now create several icons with one click.
  182.         (NOTE: the way standard icons are defined has changed. If you
  183.         already have a set of custom icons, DON'T just copy them into the
  184.         Templates file. Read the section on customizing in the Manual.)
  185.       . Option 'Delete icons moved outside'
  186.       . Alternative sets of templates and sprites, with 3D look
  187.       . Possibility to resize icons when aligning
  188.       . Icon resizing now only in 1 dimension (x or y) at a time
  189.       . Double-click on icon, title bar or background opens the appropriate
  190.         Edit window
  191.       . Drag-selecting of templates in 'Templates' window
  192.       . Souped-up 'Templates' window: templates appear as sprite+name
  193.       . Direction (up/down/left/right) for copying of icons in menu
  194.       . Extended icon info, such as button type and validation string, is
  195.         sent to !Help (Acorn's interactive help application).
  196.       . Help files for !StrongHlp
  197.       . Possibility to set coordinates of topleft corner (min.X & max.Y) of
  198.         work area (were fixed to 0,0 in old version)
  199.  
  200. 1.11 Removed automatic minimizing of WimpSlot at startup, since it seemed
  201.      to give problems with RiscOS 2
  202.      Grid size now adapts to mode changes
  203.  
  204. 1.10 First distributed version
  205.  
  206. 1.00 Test version
  207.  
  208.  
  209. Known bugs
  210. ----------
  211.  
  212. * In some cases, you may find it difficult to click-select an icon:
  213.      - When its button type is 'Menu' (icon is deselected when pointer
  214.        moves away from the icon)
  215.      - When it has border type 'R5' in its validation string (icon is
  216.        deselected after a short delay)
  217.      - When the icon is shaded (no reaction to a click)
  218.      - When the icon is part of a selection group (ESG), and the 'Allow
  219.        adjust' flags are cleared (click-selecting with Adjust deselects
  220.        the other icons)
  221.   In all cases, you can drag-select the icon, or you can use 'Select all'
  222.   and deselect some other icons.
  223.  
  224. * Double-clicking on an icon to open the Icon Edit window does not work
  225. smoothly with all button types; the Wimp interferes with TemplEd's
  226. reactions to clicks. For the same reason, double-clicking on the title bar
  227. has the weird effect that the Icon Edit window is opened, and immediately
  228. the template window is re-opened on top. I have made the double-click thingy
  229. optional; if you don't like it, you can switch it off.
  230.  
  231.  
  232. Limitations
  233. -----------
  234.  
  235. * Limits on the number of templates and the number of icons per template.
  236. This can be changed by setting the variables MaxTemplates% and MaxIcons%.
  237. There is also a limit on the size of indirected data that is stored with a
  238. template. Current settings:
  239.     MaxTemplates% = 100
  240.     MaxIcons%     = 200
  241.     MaxIndirSize% = 8000
  242. Note: files contain only actual contents; an empty indirected string with
  243. max size of 1000 takes up 1 byte (the CR terminator) in the file.
  244.  
  245. * TemplEd can't handle indirected strings longer than 255 bytes. You can set
  246. the maximum length above this limit, but TemplEd can't put more than 255
  247. characters in a text area.
  248.  
  249. * You can't set the sprite area for each icon separately; all sprites in a
  250. template are read from the same area.
  251.  
  252. * TemplEd is a single-file editor.
  253.  
  254.  
  255. Possible future additions
  256. -------------------------
  257.  
  258. Future versions MAY have one or more of the following features:
  259.  
  260. * Show grid
  261. * Multi-file editing
  262. * Grouping of icons
  263. * Export templates as Text file    
  264. * On fatal error, save templates in <Wimp$ScrapDir>
  265.