home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / desktop / povfront_1 / ReadMe
Text File  |  1997-06-24  |  9KB  |  155 lines
  1. This file, ReadMe, contains information about versions of !POVray2 setup,
  2. and includes some helpful information. For full instructions, see
  3. the !Help file by selecting 'Help' from the filer menu.
  4.  
  5. POVray2 Setup Version 1.12  -  July 1994
  6. ========================== 
  7.  
  8. This fixes a couple of 'anomalous features' (read bugs) which were present
  9. in Version 1.11 (the first release version). These are:
  10.  
  11. 1.) In version 1.11, an error 'Bad filename .xxx at code 7670' was produced
  12. if you deselected the save box option, and specified a system variable which
  13. hadn't been defined in the 'Path' submenu. Since I supplied the program with
  14. the default path set to <POVpicture$Dir> (which was defined during the boot
  15. up sequence on my machine - see below), this error will almost certainly
  16. have been produced if you tried to use version 1.11 in non-save-box mode
  17. without first setting the path to something sensible (Using 'Save defaults'
  18. from the icon bar menu will save your choice of destination path name).
  19. Version 1.12 now checks the destination path name when 'Start' is clicked,
  20. and will produce a warning if it is in non-save-box mode and the destination
  21. path name is undefined/invalid (error 'Invalid desination path name' is
  22. reported. This reflects the problem better than the rather enigmatic error
  23. above). Also, non-existent destination directories are detected, and this is
  24. also reported. Thanks to everyone who brought this one to my attention!
  25.  
  26. 2.) Whilst fixing the above, I noticed the rather inconsistent behaviour of
  27. the Path submenu itself. In version 1.11, if you had 'Use save box'
  28. selected, then entered text into the path submenu, the 'Use save box' option
  29. would be deselected, and the 'Path' menu item would be ticked. This is as
  30. expected. If, however, you then changed the text in the submenu, the 'Path'
  31. menu item would be deselected (i.e. its status was toggled). This obviously
  32. should not happen, and has been fixed in version 1.12 (i.e. the 'Path' item
  33. now remains selected when the text is changed, until you actually click on
  34. the 'Path' item itself, or select 'Use save box'. This is what should have
  35. happened originally.
  36.  
  37. 3.) Version 1.11 had a rather restrictive limit on the maximum length of the
  38. path and library names. This has now been increased.
  39.  
  40. POVray2 Setup Version 1.14 - October 1994
  41. ==========================
  42.  
  43. This version fixes a bug present in previous versions which prevented the
  44. continue option from working, and allows loading of POV scene files
  45. (filetype &376) by double clicking. Again, thanks to everyone who reported
  46. this bug, and suggested the fix for it!
  47.  
  48. POVray2 Setup Version 1.15 - November 1994
  49. ==========================
  50.  
  51. This is basically the same as version 1.14. The only difference is a small
  52. change to the templates file to make the main window display the marbled
  53. backdrops properly under RISC OS 3.5. 
  54.  
  55. POVray3 Setup Version 1.20 - March 1997
  56. ==========================
  57.  
  58. This version updates version 1.15 to support the version of POV 3.0 which 
  59. is available from HENSA. This version has a different file naming structure
  60. to the previous POVray 2, which is supported transparently to the user,
  61. and support is also provided for radiosity.
  62.  
  63. POVray3 Setup Version 1.21 - June 1997
  64. ==========================
  65.  
  66. A few days after I sent v1.20 to HENSA, I noticed a bug which I'd missed earlier, which
  67. caused a spurious error when using the save box. This is corrected in this version. I've also
  68. added support for my own port of POV 3.01, which does not insist on the 'pov', 'tga' etc.
  69. directory structure which the version on HENSA uses (it uses the filenames given to it on
  70. the command line - extensions are only translated into directories for include files). Support
  71. for the existing version of POV on HENSA is retained by the 'Unix names' option. At present,
  72. my port is not widely available; I may distribute it if there is sufficient demand.
  73.  
  74. The !!Scenes directory
  75. ======================
  76. As I mentioned above, the <POVpicture$Dir> system variable was always set on
  77. my machine. This was done by the !!Scenes directory, which exists solely to
  78. do this, and also to set up the #include library directory (note: it
  79. expects the #include files to be in a directory called 'include' which itself
  80. is in the same directory as the !!Scenes application, ie. 'include' should be
  81. in the same filer window as !!Scenes), and provide somewhere to store the
  82. output scene files (obviously!). Since this was always present in my
  83. machine, I didn't notice problem number 1 above until told about it! I had
  84. meant to include !!Scenes in the first release (1.11), but I forgot....
  85. Anyway, it's here now. It is, of course, completely independent of the POV
  86. front end, which is in no way reliant upon it (other than to set up the
  87. system variables, if you use them), and it's up to you if you want to use it
  88. or not. Double click on !!Scenes to open the output scenes file directory.
  89.  
  90.  
  91. This next section is largely historical. Read if you're interested...
  92.  
  93. Compatibility (from V2.x)
  94. =============
  95. I've tried two versions of the executable on the front end. Version 2.0 
  96. (compiled by Pete Goodwin), obtained from HENSA appears to work properly, 
  97. but does appear to contain a number of bugs, notably that the library
  98. option does not work, and neither, it seems does the continue option. 
  99. Version 2.2 (compiled by Adam Hamilton) is free from bugs, but expects the 
  100. format of #include lines to be Unix or DOS standard 
  101. (eg #include "colors.inc"). Whilst this makes porting of pictures from other machines easier, it seems a little unexpected when using scenes you've 
  102. created yourself - you have to say things like
  103. #include "colors.<POVinc$Dir>.inc" if you've set <POVinc$Dir> as your
  104. include directory, which is a bit confusing if you're used to Acorn 
  105. convention, although it does increase the portability of your scenes. Also,
  106. using 2.2, in the library option, you must specify the directory which
  107. contains the inc and gif etc. directories, rather than the directories 
  108. themselves (does this seem obvious? I suppose it does now, but it certainly
  109. caught me out!).
  110.  
  111. I think the best way of using V2.2 is to have your include files in a
  112. directory called "inc", and place this in the same directory as !!Scenes, 
  113. which will then set <POVinc$Dir> to point to it (as detailed above). Then,
  114. make sure the 'Library' submenu of !POVray2 is set to '<POVinc$Dir>' (it's
  115. already set to this by default as supplied). Then, just use #include 
  116. statements such as "#include colors.inc", and leave the library option
  117. to take care of it.
  118.  
  119. On the whole, having been used to earlier versions of
  120. POV, I think I prefer V2.0's way of accepting Arc style input, but this is,
  121. of course only my opinion, and in any case I don't think you can get hold
  122. of this version any more. You also have to accept the failure of the 
  123. library and continue options (at least, I think they are bugs - correct me
  124. if I'm wrong on this). Version 2.2 also, I think, has some improvements in
  125. the rendering algorithms, so on the whole it's probably worth using this
  126. version....
  127.  
  128. Version 3.0  -  June 1997
  129. -----------
  130. After the above debate on file naming, POV 3.0 appears in HENSA and 
  131. has a completely different approach. It supports DOS / Unix names for the 
  132. #include files, but it expects to find directories named after the filename
  133. extensions in which to store the output files. This should be handled by
  134. POVfront, as long as the 'Unix filenames' menu option is enabled (it should
  135. be by default).
  136.  
  137. Version 3.01 - June 1997
  138. ------------
  139.  
  140. I decided I didn't like the way the existing port of POV 3.0 handles file names; I prefer
  141. it to use the file names it's given on the command line, rather than insisting on
  142. mangling the filename to use the extension as a directory. I guess it's a bit of a matter
  143. of preference, though. Anyway, I decided to do my own port of POV which handled the file
  144. names in my preferred way, whilst still translating the extensions in #include directives.
  145. This is POV 3.01, a slightly later version than the current port (which is of 3.00e at the 
  146. time of writing). As well as the file name differences mentioned above, it has a few bug 
  147. fixes over 3.00e. 
  148.  
  149. This version of POVfront supports both ports of POV - my version has the Unix names option
  150. turned off, whilst the version on HENSA needs it turned on. The next version of POVfront
  151. (which will be completely re-written) will probably be based around my port of POV, although
  152. I'll probably include support for the other filenaming convention.
  153.  
  154.  
  155. Brian Ruth (b.ruth@ucl.ac.uk)