home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / drawprint / !DrawPrint / !Help next >
Text File  |  1995-01-28  |  12KB  |  230 lines
  1. DrawPrint   DrawFile view/print utility
  2.             (Version 1.01  28 Jan 1995)
  3.  
  4. PURPOSE
  5. This application is a DrawFile viewer and printing utility which allows
  6. replacement of unknown fonts in the DrawFile and which provides a number of
  7. print options, including the ability to print an image too large to fit on
  8. one page segmentally (i.e. across several pages).
  9.  
  10. This application was written in Basic primarily to test and demonstrate the
  11. DrawUtilsA module, which is an alternative to the Acorn DrawFile module but
  12. with some extra facilities. The DrawUtilsA module and two documentation
  13. files ('DUAmodInfo' and 'DUAmodSWIs') can be found inside the application
  14. directory. Another Basic program ('NoWimpDemo') shows how to display and
  15. print drawfiles in a non-Wimp program.
  16.  
  17. DrawPrint requires RISC OS 3.1 or later, and a suitable printer driver
  18. must be installed in order for it to print DrawFiles.
  19.  
  20. Copyright Notice: This software is copyright © of the author (James McQueen)
  21. 1995. However, you are free to give this software to anyone you wish via any
  22. medium including electronic bulletin board or public domain (PD) library
  23. providing it is delivered with this documentation file unaltered. You may
  24. not sell this software, except that PD libraries may make a nominal charge
  25. to cover magnetic media and postage. 
  26.  
  27. GETTING STARTED
  28. To use DrawPrint, double-click on its icon in a directory viewer to install
  29. the application on the icon bar. To display a DrawFile, drag its icon onto
  30. the DrawPrint icon on the icon bar. Once the image window is open, a 
  31. DrawFile can also be loaded by dragging its icon into the image window
  32. (replacing the previous image).
  33.  
  34. ICON BAR OPTIONS
  35. Clicking menu over the icon bar icon will display a menu with four entries.
  36. These are:
  37.  
  38. Info
  39. Move right across the 'Info' arrow to open the standard information window.
  40.  
  41. Font options
  42. This leads to a dialogue box which determines the action taken on loading a
  43. DrawFile containing unknown fonts. There are three choices:
  44.  
  45.  - 'Auto replace': unknown fonts are automatically replaced with a font 
  46.     selected by clicking on the menu icon at the right of the dialogue box. 
  47.     This will produce a menu listing the fonts available on your computer.
  48.     When the replacement is made (on loading a DrawFile), a message of the
  49.     form "replacing font: unknown with replacement" is displayed. You will 
  50.     then be given the option of displaying or discarding the DrawFile.
  51.  
  52.  - 'User select replace': if this option is selected, a dialogue box will
  53.     appear on loading a DrawFile containing unknown fonts. This is described
  54.     below, and allows a replacement for each unknown font to be selected.
  55.  
  56.  - 'No action': a warning message is displayed if the DrawFile contains
  57.     unknown fonts, but otherwise no action is taken.  You will then be given
  58.     the option of displaying or discarding the DrawFile.
  59.  
  60. The 'Font options' dialogue box provides a fourth option - 'Compile font
  61. table'. The font table appears near the start of the DrawFile and provides a
  62. list of the fonts it uses. Fonts used in text objects or transformed text
  63. objects must appear in the font table, but fonts used only in text area
  64. objects need not. Some programs which generate DrawFiles do not include the
  65. latter in the font table, and other programs list many fonts whether or not
  66. they are actually used in the DrawFile. If this option is enabled, the font
  67. table will be properly updated whether or not any font substitution has been
  68. made.
  69.  
  70. Some printers (e.g. PostScript devices) work more efficiently if a list of
  71. fonts required is provided before printing starts. DrawPrint will perform
  72. this font down-loading if appropriate, using the font table to generate the
  73. list. Therefore, if you are using a PostScript or similar printer, the 
  74. 'Compile font table' option should be enabled. 
  75.  
  76. Configure
  77. This leads to a small dialogue box containing a single 'OK' icon. Clicking
  78. on this icon will save the current DrawPrint setup to disc to be used as the
  79. default configuration. This sets the zoom factor for the image window, the
  80. action for handling unknown fonts (and compiling the font table), and the 
  81. method used to print the DrawFile.
  82.  
  83. Quit
  84. Selecting this option will remove DrawPrint from the icon bar.
  85.  
  86. LOADING A DRAWFILE
  87. To display a DrawFile, drag its icon onto the DrawPrint icon on the icon
  88. bar. If the image window is open, a DrawFile can also be loaded by dragging
  89. its icon into the window (this will replace the previous image).
  90.  
  91. With the exception of unknown fonts, any error found in the DrawFile is
  92. reported as a textual message followed by a string of the form "[code = xxx;
  93. tag = xxx; position = xxx; offset = xxx]". Code is the error code on which
  94. the textual message is based. Tag is the tag type of the object containing
  95. the error (e.g. 1 = text object, 2 = path object). Position is the location
  96. of the object in bytes from the start of the file. Offset is the location of
  97. the error-causing sequence in bytes from the start of the object. No offset
  98. value is given if the location of the error-causing sequence can be
  99. determined from the error code.
  100.  
  101. If the DrawFile contains unknown fonts and the 'User select replace' option
  102. was chosen, the image window is closed and the 'Change font' dialogue box
  103. is displayed. DrawPrint makes a list of the unknown fonts, numbering them
  104. 1, 2, 3... etc. Each font appears only once in the list irrespective of the
  105. number of times it is used in the DrawFile. The number of unknown fonts 
  106. appears at the top of the dialogue box, and initially the first unknown font
  107. is displayed alongside its number. The 'Back' and 'Next' icons can be used
  108. to cycle through the list. To select a replacement font, click on the menu
  109. icon to obtain a menu of fonts available and choose one. The 'Replace all'
  110. icon will substitute the displayed replacement font for the currently listed
  111. unknown font and those remaining in the list. It is not necessary to choose
  112. a replacement font for each unknown one (in which case the default action as
  113. used by Draw will be performed when displaying the image). When the
  114. selections have been made, click on the 'OK' icon to perform the font
  115. replacement and display the DrawFile. At any point, clicking on the 'Cancel'
  116. icon will end the dialogue and discard the DrawFile.
  117.  
  118. When displaying a DrawFile containing unknown fonts, the actions are: for a
  119. text object - the system font is used; for a transformed text object -
  120. nothing is displayed; for a text area object - if the unknown font appears
  121. at the start of the text then nothing is displayed, otherwise the previous
  122. font is used.
  123.  
  124. Clicking the menu button over the image window displays a menu with four
  125. entries. These are:
  126.  
  127. Info
  128. This leads to a dialogue box containing some information about the DrawFile.
  129. If font substitution has been performed then the file will be shown as
  130. modified (an asterisk also appears after the file name in the image window
  131. title bar).
  132.  
  133. Save
  134. This leads to a standard save file dialogue box. Either click on the 'OK'
  135. icon, press return or drag the icon to a directory viewer to save the
  136. DrawFile (after changing its name if necessary).
  137.  
  138. Zoom
  139. This leads to a dialogue box in which the zoom factor for the screen display
  140. can be set. Type values for the multiplier and divisor into the writable
  141. icons (only single digits in the range 1-8 can be entered) or use the arrow
  142. icons to alter the values. Press return a second time or click on the 'Set'
  143. icon to rescale the image. The zoom factor can be vary from 1/8th to 8 times
  144. the normal screen display size for the image.
  145.  
  146. Print
  147. Selecting this option will display the print control dialogue box. This is 
  148. described below.
  149.  
  150. PRINTING
  151. In the upper part of the print control dialogue box, you can enter the
  152. number of copies (1 - 999) to be printed using the writable icon or change
  153. the displayed value using the arrow icons. You can also choose whether or
  154. not DrawPrint pauses between pages.
  155.  
  156. In the middle section of the window, you can set the scale at which the
  157. image is printed as a percentage of its 'normal' size and choose one of four
  158. print modes ('Normal', 'Rotate', 'Auto-fit' and 'Segmental'). In some cases
  159. a modifier ('Centre' or 'Crop marks') can