home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / duamodule / !DF_Render / !Help next >
Text File  |  1995-08-25  |  4KB  |  86 lines
  1. DF_Render  DrawFile display program
  2.            (for testing DrawUtilsA and DrawFile modules)
  3.  
  4.            (Version 1.00 Aug 1995  :  RISC OS 3 only)
  5.  
  6. by James McQueen
  7.  
  8.  
  9. PURPOSE
  10. This application was written to test the new transformation facility of the
  11. DrawUtilsA module, which is an alternative to the DrawFile module (both do
  12. most of the work of displaying a drawfile). For comparison purposes the
  13. program can also use the DrawFile module. 
  14.  
  15. Which module is used depends on the variable dua_module% which is declared
  16. at the start of the !RunImage program. If non-zero the DrawUtilsA module is
  17. used (module calls are made from PROCprocess_file1 and PROCrender_image1),
  18. otherwise the DrawFile module is used by calls from PROCprocess_file2 and
  19. PROCrender_image2. Remember to load the DrawFile module if necessary.
  20.  
  21. If the DrawUtilsA module is used, any unknown fonts used in the drawfile are
  22. automatically replaced by Homerton.Medium (replace_font$ defined in
  23. PROCinit_variables) by a call to PROCauto_replace_ unknown_fonts made from
  24. PROCprocess_file1. A message is displayed when this occurs. The required
  25. changes to the drawfile are actually made by the module.
  26.  
  27.  
  28. USING THE PROGRAM
  29. DF_Render does not install on the icon bar but opens a blank image window
  30. when started. To display a drawfile just drag its icon into the window.
  31.  
  32. The window is re-sized if necessary when the drawfile is loaded and the
  33. image is always centered in the window work area.
  34.  
  35. A rectange with tags around its edge (the 'grid') also appears centered in
  36. the work area; this is used to control scaling and rotation of the image by
  37. dragging on the tags with the select button held down. The tag initially at
  38. the bottom right (shown as an open circle) determines rotation and the other
  39. corner tags affect x- and y-scaling simultaneously. The mid-point tags on
  40. the vertical sides affect only x-scaling and those on the horizontal sides
  41. only y-scaling.
  42.  
  43. The scale values are set to 1.0 and the rotation to zero when a drawfile is
  44. loaded.
  45.  
  46. The program allows scale values in the range 0.05 - 10. If dragging would
  47. reduce a scale value below 0.05 it changes to -0.05 and will then become
  48. more negative (to a limit of -10) if the drag is continued in the same
  49. direction. Thus the image can be flipped about its horizontal, vertical or
  50. both axes. This works best if the pointer is moved slowly as the scale
  51. factor(s) are about to change sign.
  52.  
  53. For more precise control of image transformation, click menu over the image
  54. window and select 'View...'. This opens the view control dialogue box. 
  55.  
  56. At the top of the dialogue box are three writeable icons for x- and
  57. y-scaling and rotation (in degrees). As above, the scale values can be in
  58. the range 0.05 - 10 or -0.05 - -10. Below these are a number of icons as
  59. follows:
  60.  
  61. Proportional grid: If enabled, the grid size is proportional to the current
  62. image size after x- and y-scaling. Otherwise the grid size depends (almost)
  63. logarithmically on the x- and y-scale factors. The first allows more
  64. accurate control of scaling over the whole of the allowable range, and the
  65. second allows gives more rapid rescaling but with a loss of accuracy.
  66.  
  67. Grid colour: The grid colour can be changed or the grid can be switched off
  68. if not required.
  69.  
  70. Lock pointer: If enabled, the pointer is continuously re-positioned over the
  71. grid control tag as the drag operation proceeds. This gives more accurate
  72. control of scaling and rotation but requires more mouse movement. Otherwise
  73. more rapid changes in scaling and rotation are produced but with a loss of
  74. accuracy.
  75.  
  76. Window size: The image window (work area) size is determined when the
  77. drawfile is loaded, but does not change automatically with rescaling or
  78. rotation. Instead, the window size can be set to that corresponding to one
  79. of the standard paper 'A' sizes (e.g. A4 landscape = 2104 x 1488 os units).
  80. The image is always centered in the window work area whatever size is
  81. selected.
  82.  
  83. Changes made in the view control dialogue box do not take effect until 'OK'
  84. is clicked. 'Cancel' restores the previous settings.
  85.  
  86.