home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / mag_discs / volume_9 / issue_08 / breakwell / !Redraw / !Help < prev    next >
Text File  |  1995-01-01  |  9KB  |  282 lines
  1. ****************************************************************************
  2. * !Redraw   Vector Graphics File Convertor                                 *
  3. * Version   2.13                                                            *
  4. * Author    David Breakwell                                                *
  5. ****************************************************************************
  6.  
  7. Background
  8. ----------
  9.  
  10. The excellent !Translator and !ChangeFSI exist to enable the conversion of
  11. Sprites from many formats to the standard Archimedes format. No single 
  12. piece of software exists however for the potentially more useful Vector 
  13. file formats that exist on other machines. !Redraw attempts to address 
  14. this need.
  15.  
  16. Vector file formats are superior to Sprites in that they are totally 
  17. rescalable without loss of detail or Éjaggiesæ.The Archimedes has its
  18. own !Draw standard which is supported by many applications.
  19.  
  20. !Redraw
  21. -------
  22.  
  23. !Redraw supports the Windows Metafile Format (WMF), which is quite 
  24. common on PCs, the old chesnut - BBC Spool Format, HPGL - the standard 
  25. plotter language and Computer Graphics Metafiles (CGM), GEM vector and EPS.
  26.  
  27. Other formats such as WPG will follow when I can locate a 
  28. description of the file formats. If anyone can help then I would
  29. be most grateful. In addition save routines going from !Draw format to
  30. the other formats will be added (eventually!). 
  31.  
  32. To load a file it must have the correct file type:
  33.  
  34.         Windows Metafile Format           000 \
  35.         BBC Spool Format                  004 |- These may change
  36.         GEM Vector Format                 005 |
  37.         PIC Format                        006 /
  38.         CGM Format                        405   NCS Designated
  39.         HPGL                              CAE   Acorn Designated
  40.         EPS                               FF5   Acorn Designated
  41.  
  42. It can then be dragged to the Icon Bar or the open Draw window (they
  43. are not loaded from a double click as they should be regarded as 'resource'
  44. files that any application should be able to use). The file is then
  45. automatically converted to !Draw format. It can be saved in memory to
  46. another application or to disc.
  47.  
  48. WMF Handling
  49. ------------
  50.  
  51. At present the program allows for the following object types:
  52.  
  53.   Å Circles and Ellipses
  54.   Å Paths (filled and unfilled)
  55.   Å Pen and Brush styles
  56.   Å Rectangles
  57.   Å Origin and Extent shifts
  58.   Å All other objects are skipped 
  59.  
  60. This appears to give very good results on all WMF files tested including
  61. those created by Corel Draw. The program will also cope with WMF files 
  62. saved from the windows clipboard as CLP files (it removes the header 
  63. information added by the Clipboard). A single option is available from 
  64. the icon bar menu which alters the way Thin lines are dealt with by !Redraw.
  65. If some lines from the drawing are missing or extra lines appear in the 
  66. illustration then try altering this option. The conversion involves two file
  67. scans so be patient! 
  68.  
  69. BBC Spool File Handling
  70. -----------------------
  71.  
  72. At present the conversion deals with
  73.  
  74.   Å Solid Lines and moves. At present dotted lines are made solid.
  75.   Å Relative and absolute plots
  76.   Å Circles
  77.   Å Arcs, sectors and segments
  78.   Å Triangles and Rectangles
  79.   Å Text printed at the Graphics Cursor (VDU 5)
  80.   Å GCOL (All options are treated as option 0)
  81.   Å CLG and CLS
  82.   Å Single Point Plots (PLOT 69)
  83.   Å Other Objects are skipped
  84.  
  85. At present there is no support for graphics windows and origin changes. 
  86. There is only limited support for ellipses. Options are available from the 
  87. icon bar to ignore CLG and CLS, to create a black background for the file 
  88. and for the default mode to select if no mode statement is present in the
  89. file. The conversion seems to work quite well.
  90.  
  91. HPGL Handling
  92. -------------
  93.  
  94. The program copes with the most used HPGL commands:
  95.  
  96.   Å PA,PD,PU Draw and Move Commands
  97.   Å CI Circle
  98.   Å Scaling and Resizing
  99.   Å Simple text labels
  100.  
  101. This range is currently being expanded and the complex scaling routines 
  102. enhanced. The Icon Bar Menu allows the Paper Size and Pen width to be 
  103. changed. More complicated text handling may be added under RO3 using text
  104. at angles etc.
  105.  
  106. CGM Handling
  107. ------------
  108.  
  109. The program copes with simple CGM Files and converts:
  110.  
  111.   Å Header Information
  112.   Å Pen and fill attributes
  113.   Å Paths and Polygons
  114.   Å Scaling
  115.   ÅáBoth Palette and RGB Colour notations
  116.  
  117. This is based on a simple analysis of CGM files seen by the author and 
  118. may not be totally correct when compared with more complicated files or
  119. the ANSI/ISO specification for this file type. If anyone has the full 
  120. document then I would be very interested in seeing it and enhancing 
  121. !Redraw as necessary to match. Having said that the program seems to cope 
  122. quite well. A special Mono mode is selectable when colour is handled 
  123. incorrectly.
  124.  
  125. EPS Files
  126. ---------
  127.  
  128. Redraw has an EPS convertor! It will cope with 
  129. AutoCAD, AI and Corel output. It does not always process colour 
  130. information correctly. Does a reasonable job on simple files.
  131.  
  132.   Å lineto, moveto, curveto
  133.   Å fill, stroke, closepath
  134.   Å setrgbcolor, setcmykcolor, setgray
  135.   Å end                                              
  136.  
  137. GEM Vector Files
  138. ----------------
  139.  
  140. Redraw also processes GEM Vector files and deals with:
  141.  
  142.   Å Polyline and Polyfill 
  143.   Å Rectangles        
  144.  
  145. VERY basic!
  146.  
  147. PIC Files
  148. ---------
  149.  
  150. Redraw handles PIC files produced by Lotus 123 and other such programs.
  151. Elements handled:
  152.  
  153.   Å Polygons
  154.   Å Colour
  155.   Å Paths
  156.   Å Text and Fonts 
  157.  
  158.  
  159. ---------------------------------------------------------------------------
  160.  
  161. Many thanks to Jon Ribbens the author of the WimpExt module 
  162. !Redraw is ⌐ David Breakwell 1993
  163. !Redraw is **not** Public Domain and must not be distributed as PD.
  164. !Redraw is not shareware. This program must not distributed.
  165.            
  166. All correspondance appreciated:
  167.  
  168.   David Breakwell
  169.   22 Cobs Way
  170.   New Haw
  171.   Addlestone
  172.   Surrey 
  173.   KT15 3AF 
  174.  
  175. All normal disclaimers apply
  176.  
  177.  
  178. Changes
  179. -------
  180.  
  181. Version 1.8  - 22nd April 1993
  182.  
  183.   Å Updated for WimpExt Module version 1.98
  184.   Å Better Memory Handling using WimpSlot rather than RMA
  185.     Allows Program to run better on smaller memory Acorns
  186.   Å 3D Windows and Icons
  187.   ÅáDragASprite Support using WimpExt
  188.   Å RISCOS 3 DOS Extension to RISCOS FileType Mapping
  189.     Gives PC Files the RISCOS FileType Sprites automatically.
  190.   Å Correction to BBC Spool File Bounding Boxes 
  191.  
  192. Version 1.9  -  5th May 1993
  193.  
  194.   Å HPGL File Conversion Added (see above)
  195.  
  196. Version 1.91 - 14th May 1993
  197.  
  198.   Å HPGL Scaling routines rewritten
  199.   Å Pen Colour and width handling added for HPGL
  200.  
  201. Version 2.00 - 9th June 1993
  202.  
  203.   Å CGM Vector format added - filetype 405 as used by NCS Shareware
  204.     Supported as per other files including DOS File extension mapping.
  205.  
  206. Version 2.01 - 12th June 1993
  207.  
  208.   Å CGM Colour support corrected and correction made so that
  209.     ÉOpenæ paths remain so!
  210.  
  211.   Å Export File Menu Added to allow for saving in formats other than 
  212.     !Draw, these will be progressively added as time goes on.
  213.  
  214.     June 26th 1993
  215.  
  216.   Å Add HPGLPal file to program directory to hold the HPGL Pen Colours.
  217.     Standard desktop palette file. Pens start at colour 8 (Def:Navy). 
  218.     Program used to use the current desktop palette.
  219.  
  220.   Å Added Ability to load !Draw files ready to be exported as PC Files. 
  221.     I'm not sure why it took so long to add this!
  222.  
  223. Version 2.02 - July 4th
  224.  
  225.   Å Added Default Filenames to filer boxes
  226.   Å Corrected bug in load routine for Draw Files.
  227.   Å Added new HPGLPal file for plotter file rendering with better colours.
  228.   Å Started to program export routines. The routines do not support RAM
  229.     transfer as on smaller memory acorns space will be tight for big files!
  230.  
  231. Version 2.10 - August 10th
  232.  
  233.   Å Started to add EPS files (AI output) for conversion. This may
  234.     not be easy so wish me luck!
  235.  
  236.  
  237.     August 13th
  238.  
  239.   Å EPS works in a very basic way and will process AI or Corel output 
  240.     files with some preprocessing by the user. I hope to remove the need
  241.     for preprocessing.
  242.            
  243.  
  244.     August 14th
  245.  
  246.   Å The GEM Vector file format is finally added in a very basic form.
  247.  
  248.     September 18th (back to Redraw!)
  249.  
  250.   Å Corrected bug in WMF file identification
  251.   Å Started to add WMF Export routine
  252.  
  253.     October 2nd
  254.  
  255.   Å Improved CGM Path Handling  
  256.  
  257.     November 21st
  258.  
  259.   Å Correct y dimensions in GEM format
  260.   Å Improve Screen redraw to clip rectangle (older versions of WimpExt did
  261.     not handle the clipping rectangle correctly).
  262.  
  263. Version 2.11
  264.  
  265.     December 15th
  266.  
  267.   Å Add CGM Mono mode to prevent problems with poor colour conversion
  268.   Å Improve CGM Path Handling
  269.   Å Change winding path rule for WMF files
  270.   Å Add PIC Handling
  271.  
  272. Version 2.12
  273.  
  274.   Å Enhancements to EPS Handling
  275.  
  276. Version 2.13
  277.  
  278.   Å Further Enhancements to EPS handling
  279.   Å Corrections to memory handling
  280.   Å Corrections to file loading
  281.   Å Remove the need for pre-processing of EPS files
  282.   Å Source type testing for EPS Files