home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / formdraw / !FormDraw / !Help < prev    next >
Text File  |  1997-02-04  |  6KB  |  159 lines
  1. =========
  2. !FormDraw by Kell Gatherer
  3. =========
  4.  
  5. !FormDraw is a shareware application which provides a short-cut to
  6. complicated graphics printing. It takes a Draw file and a text file and
  7. merges the two, allowing you to create a complicated graphics file with the
  8. minimum of programming and memory overheads.
  9.  
  10. At its simplest, !FormDraw runs as an application in the normal way:
  11. double-click on it to open the application window. In the directory
  12. "Example1" is a Draw file and an Edit file. Drag both of these files to the
  13. !FormDraw window and drag out the result.
  14.  
  15. The Draw file in example 1 has 8 text fields: seven of them are full of
  16. "x's", which makes them varying text fields. !FormDraw finds all these text
  17. fields and substitutes the "x's" for each line of the text file. The result
  18. can be dragged out to Draw or the filer, or printed from !FormDraw.
  19.  
  20. Examples 2 and 3 are more complicated, demonstrating how a form or
  21. letterhead can be created.
  22.  
  23. When creating a Draw file for !FormDraw, it is important to get the text
  24. fields in the right order. Once you've finished your design, get them in the
  25. right order by progressively bringing each one to the front by selecting it
  26. and pressing Ctrl-F. In the directory "Example3" is a text file called "100"
  27. which can be used to test the order of the fields.
  28.  
  29. ----
  30.  
  31. !FormDraw has another mode of operation where it operates "invisibly" - it
  32. can be requested to merge a Draw file and Text file in the background and
  33. process the output file in various ways. This can be achieved by issuing a
  34. "Star command" (operating system command). This could be entered on the
  35. command line, or more likely from an Obey file. The directory "StarComms"
  36. shows examples.
  37.  
  38. The star commands would best be used, however, from within another
  39. application. A simple application would take text input and merge it with a
  40. Draw file to print a complicated form or contract. Example 4 shows such an
  41. application.
  42.  
  43. Within an application, substitute the command "WimpTask" for "Run" in the
  44. following examples. Example 4 is a working application which can be easily
  45. modified (it has its own help file).
  46.  
  47. ----
  48.  
  49. The star command takes the form:
  50.  
  51. *Run FormDraw:!Run <DrawFile> <TextFile> -command
  52.  
  53. where <DrawFile> is the filename of the DrawFile <TextFile> is the filename
  54. of the TextFile and -command can be one of the following:
  55.  
  56.  -D   load the result into Draw 
  57.  -P   send the result to the printer driver 
  58.  -S   open a save box to drag the result elsewhere
  59.  
  60. If there is no command, !FormDraw runs as though you had double-clicked on
  61. the !FormDraw application.
  62.  
  63. If the command is a filename, the result will be saved to that filename.
  64.  
  65. ---- Examples:
  66.  
  67. *Run FormDraw:!Run adfs::4.$.AppForm adfs::4.$.AppText -D
  68.  
  69. will find the DrawFile "AppForm", merge the text with the file "AppText" and
  70. load the result into Draw.
  71.  
  72. ----
  73.  
  74. *Run FormDraw:!Run adfs::4.$.AppForm adfs::4.$.AppText adfs::4.$.Output
  75.  
  76. will save the result as a Draw file "Output".
  77.  
  78. ----
  79.  
  80. From BASIC within an application:
  81.  
  82. OSCLI("WimpTask FormDraw:!Run "+drawfile$+" "+textfile$+" -P")
  83.  
  84. will merge "drawfile$" and "textfile$" and send the resulting Draw file to
  85. the printer driver. The actual printing of the file is performed by the
  86. !Draw application.
  87.     
  88. ----
  89.  
  90. The commercial application "TextEase" is very good for creating a DTP
  91. document and saving it as a Draw file, making it ideal for creating
  92. documents for !FormDraw.
  93.  
  94. ---- Technical notes:
  95.  
  96. !FormDraw uses the heap manager to grab as much or as little memory as it
  97. requires to cope with the Draw file, so the Draw file may be as large as
  98. your computer's memory allows.
  99.  
  100. The application as it stands allows for a maximum of 500 text fields. In the
  101. BASIC program '!RunImage' near the end change the variable 'n%' if you want to
  102. increase this.
  103.  
  104. When using the star commands, !FormDraw only runs while it is processing the
  105. command. When printing, !FormDraw saves the output file as
  106. !FormDraw.Draw.FD_file, sends the file to the printer driver, then quits. 
  107.  
  108. When saving to Draw, the output file is saved as when printing, then the
  109. filer is sent to Draw using  "*Filer_Run FormDraw:Draw.FD_File", then
  110. !FormDraw quits.
  111.  
  112. When using the "-S" command, !FormDraw quits after the output file has been
  113. dragged to Draw or the filer.
  114.  
  115. !FormDraw requires RiscOS 3.
  116.  
  117. ---- © Kell Gatherer 1997 ----
  118.  
  119. IMPORTANT NOTICE:
  120.  
  121. !FormDraw is Shareware.  
  122.  
  123. This means that you may copy it freely provided that
  124.    • all files of the !FormDraw application are distributed
  125.      together without modification 
  126.    • the application is not sold for profit without my written 
  127.      permission - you also have to apply for permission to
  128.      distribute this program on a CD if it is sold for profit 
  129.      or to distribute it together with other commercial software.  
  130.    • I retain the copyright on all files.
  131.  
  132. You may use the !FormDraw application free of charge for a trial period of
  133. up to two weeks. If you then decide to go on using it, you have to register.
  134. Otherwise, you should delete it.
  135.  
  136. In order to register, send £10 to me (for my address see below), cheques
  137. made payable to "Kell Gatherer".
  138.  
  139. As a registered user, you are allowed to use the software on one stand-alone
  140. machine and you will be advised of upgrades. To a limited extent, I should
  141. be able to supply software support by e-mail or letter.
  142.  
  143. If you use the !FormDraw application within another application, or you
  144. create an application that requires use of the !FormDraw application, please
  145. send me a copy. If your application is sold for profit, please contact me
  146. before distributing or selling your product.
  147.  
  148. Shareware provides quality software at low prices! Please register!
  149.  
  150. Kell Gatherer
  151. Kang Software
  152. c/o Location Works Ltd
  153. 42 Old Compton Street
  154. London W1V 6LR
  155.  
  156. email: location.works@argonet.co.uk
  157. fax: 0171 287 2855
  158.  
  159.