home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / convtmplt / !ConvTmplt / !Help < prev    next >
Encoding:
Text File  |  1992-11-19  |  5.2 KB  |  147 lines
  1. | Help for ConvertTemplates "2.00 (19-Nov-1992)"
  2. |
  3.  
  4. This program is a general purpose Wimp Template file filter.  It is for Wimp
  5. programmers who wish to either:
  6.         1. Anti-alias all their text icons
  7.         2. Convert Interface validation strings to RO3.10 ones
  8.         3. See which icons are beyond a windows' extent
  9.         3. Insert "secret messages" into Template files :-)
  10.  
  11. I wrote it because I'm a convert to anti-aliased text icons, and although I
  12. do like Simon Huntington's Interface module - it's a pain having to
  13. distribute it with every program.
  14.  
  15. The current things it can do:
  16.         Turn text icons into anti-aliased text icons
  17.         Make sure anti-aliased text colours are correct
  18.         Translates Interface (RO3.00) "B" validation strings to the
  19.                 equivalent RO3.10 "R" validation strings
  20.         Set window extent to bbox of its' icons
  21.  
  22. Possible things it could easily do
  23.         Delete zero-width/height icons
  24.         Make sure icons are always wide enough for there contents
  25.  
  26. There are two programs, the nice Wimp front end and the back end itself. 
  27. The latter is provided in source format, so change to suit yourself,
  28. although you'd need a new front end :-(  The back end uses my CAssembler
  29. module to handle a dynamic wimp heap, so it should handle any sized template
  30. with ease.
  31.  
  32.  
  33. The Wimp Program
  34.  
  35.  
  36. Drag a template file to the icon bar icon.  A stander xfer_send dbox
  37. appears.  Just drag the icon to a filer window.  Easy.
  38.  
  39. Note that because the front end is separate from the back end, everything
  40. has to be in physical files, so no RAMTransfer's here, I'm afraid.
  41.  
  42.  
  43. Command line parameters:
  44.  
  45. In the Boot file an alias `ConvTmplt' is set up for CLI use.  Its' usage is
  46. as follows:
  47.  
  48. ConvTmplt
  49.  <in>                   name of input templates file
  50.  <out>                  name of output file
  51.  [-Hourglass]           hourglass usage (on)
  52.  [-Title]               title font -> anti-aliased      (on)
  53.  [-TFont <name>]        font name for title bar         (Homerton.Medium)
  54.  [-TSize <points>]      point size of title bar font    (12)
  55.  [-Icon]                text font -> anti-aliased       (on)
  56.  [-IFont <name>]        name of icon font               (Homerton.Medium)
  57.  [-ISize <points>]      size of icon font               (13)
  58.  [-CheckColours]        add "F" validation string if
  59.                         change to anti-aliased          (on)
  60.  [-BValidation]         see below                       (on)
  61.  [-Extent]              set window extent to bbox of 
  62.                         all icons (see below)           (off)
  63.  [-Debug]               error messages include line no  (off)
  64.  
  65.  
  66. The BValidation switch toggles the following conversions:
  67.  
  68.   "B0"  -> "R5", bbox extended by 4 os units
  69.   "B1"  -> "R3", bbox extended by 8 os units
  70.   "B2"  -> "R6", bbox extended by 16 os units
  71.   "B3"  -> "R2", bbox extended by 8 os units
  72.  
  73. any other "B" validation string fails.  Note that extra parameters (ie the
  74. comma separated list) are automatically stripped.  Also, the icon is forced
  75. to have a border, and the window is set to be automatically drawn by the
  76. Wimp.
  77.  
  78. Because all extra parameters are stripped, you lose the colour
  79. specifications, but as these are invariably unused, this doesn't matter so
  80. much.
  81.  
  82.  
  83. Anti-Aliased fonts
  84.  
  85. Text / text and sprite icons can be converted to use anti-aliased fonts. 
  86. However, there is some difficult with this in the COLOURS department. 
  87. Because of the way anti-aliased text is implemented, the font colours
  88. default to black on white.  This is OK for writable fields, but for comments
  89. which are on a grey (1) background they don't look QUITE as good as they
  90. could.
  91.  
  92. The way you specify anti-aliased font colours is to use an "F" field in the
  93. validation string.  Thus the algorithm to anti-alias an icon is:
  94.         fore <-- icon.fore
  95.         if icon is filled then
  96.                 back <-- icon.back
  97.         else
  98.                 back <-- window.workback
  99.         set text to anti-aliased
  100.         if fore<>7 or back<>0
  101.                 if indirected
  102.                         if validation string exists && no F field
  103.                                 append "F"<back><fore>
  104.                         else
  105.                                 create  "F"<back><fore>
  106.                 else
  107.                         force icon to be indirected
  108.                         create  "F"<back><fore>
  109.  
  110. As you can see, you may need to force an icon to be indirected.
  111.  
  112. Note you can't `slab' anti-aliased icons.  Well, you can, but it always
  113. slabs to the background colour of the font!
  114.  
  115.  
  116. Extent
  117.  
  118.  
  119. With this switch you can find all `hidden' icons.  It sets the windows'
  120. extent to the bbox of all its' icons, opens the window full size.  This
  121. option is useful for sneaking looks at other peoples' template files!
  122.  
  123.  
  124. Updates
  125. =======
  126.  
  127. 17-Nov-1992     v1.00   semi-working version (oops)
  128. 19-Nov-1992     v2.00   Handles long file names now!!
  129.                         can convert BValidation without Anti-Aliasing
  130.  
  131.  
  132. FreeWare
  133. ========
  134.  
  135. This program is released as FreeWare,  That means it comes WITHOUT ANY
  136. WARRANTY.  You can use it, sell it, delete it.  Who cares.  I don't.  If you
  137. want more stuff added, then just write - or better yet do it yerself and
  138. send it in.
  139.  
  140. Cy Booker
  141. 86 Church View
  142. Main Road
  143. Crockenhill
  144. Swanley
  145. Kent.  BR8 8JW
  146. U.K.
  147.