home *** CD-ROM | disk | FTP | other *** search
/ Raytrace - The Official POV-RAY CDROM / Raytrace_The_Official_POV-RAY_CD-ROM_Walnut_Creek_April_1995.iso / pc / readme.txt < prev    next >
Text File  |  1995-05-12  |  20KB  |  462 lines
  1. =============================== README.TXT ==================================
  2.  
  3. Welcome to the Official POV-Ray CDROM!
  4.  
  5. This CDROM is a compilation of images, scene source, program source,
  6. utilities, and tips on POV-Ray, the Persistence of Vision Raytracing
  7. program.  This CDROM represents the culmination of over 1000 hours of
  8. effort by the editor.  The contents of the CDROM itself represent, in
  9. addition, countless thousands of hours of effort by programmers and
  10. artists throughout the world.
  11.  
  12. ============================================================================
  13.  
  14. Here is a list of some important files and directories of the disc.
  15.  
  16. VIEW.EXE         MSDOS File Browser/Uncompressor
  17. 00global.txt     Global index of the disc
  18.  
  19. DOCS\            Documentation regarding these discs
  20. DOCS\VIEW.DOC    Documentation regarding VIEW.EXE
  21.  
  22. SETUP.EXE        Windows Installation Program
  23. install.exe      MSDOS Image Viewer installation program
  24.  
  25. _BBS\            BBS files
  26.  
  27. ============================================================================
  28.  
  29. Macintosh Users:
  30.  
  31. For your convenience, this disc is Macintosh ready!
  32.  
  33. All of the JPEG and GIF pictures are ready to be viewed -- just
  34. double click on the icons!  For the other picture formats, you can
  35. use your own image procesing program (Debabelizer, Adobe Photoshop)
  36. to view, process, and convert the pictures.  We also recommend
  37. Graphic Converter, a shareware program located in the
  38. MacUtils:Graphics folder.  (Please be sure to pay the author of the
  39. program if you plan to use it for an extended period of time.)
  40.  
  41. Please take a look in the red Mac_POVray folder on the CDROM for
  42. ready-to-run versions programs contained on the disc.  In here,
  43. you'll find the Macintosh versions of POVRay and other assorted
  44. utilities for the Macintosh.
  45.  
  46. We have also included a lot of wonderful shareware and freeware
  47. utilities within the MacUtils folder.  You'll find
  48. Compression/Decompression programs, Graphics utilities, Sound
  49. applications, and many, many other utilities to help you use this
  50. disc to the fullest. 
  51.  
  52. ============================================================================
  53.  
  54.                         FILES TO LOOK OUT FOR
  55.  
  56. Here's a quick list of files to have a look at !
  57.  
  58. POWERVIEW - the powerful new DOS image file viewer, in the \utils\pv
  59. directory.  PV.EXE has support for Walnut Creek's file description
  60. format, which means you can browse the image files on this CD using
  61. it and still get the short and long descriptions of each file. PV
  62. supports over 150 video cards.
  63.  
  64. If you only want to view image files, you will find browsing using
  65. POWERVIEW more convenient. POWERVIEW supports all image formats on
  66. this CDROM and will also display the file descriptions (both long
  67. and short) !
  68.                                                                 
  69. Simply type pv in the root directory of the CDROM or use the view
  70. program for full functionality.
  71.  
  72. NEW USERS - if you run Windows, please copy the file
  73.   \programs\winpvtut\winpvtut.exe
  74. to your hard disk (if you have 12 meg of disk space free) and then
  75. run it. If you don't have the space then run it from the CD-ROM. It
  76. contains an interactive tutorial on how to use POV-Ray, complete with
  77. pictures and animations!  
  78.  
  79. The \text\tutorials directory also contains more tutorials.
  80.  
  81. Ready-to-Run versions of POV-Ray are in \programs\povray\unoff\compiles\
  82.  
  83.                            BEST OF THE BEST
  84.  
  85. If you're keen to see some nice images, check out the
  86.   \images\hallfame
  87. directory for a selection of images in my Hall of Fame.
  88.  
  89. Run the SLIDES.BAT file in the root directory for a slideshow (using
  90. powerview) of the Hall of Fame.
  91.  
  92.                              WINDOWS USERS
  93.  
  94. Run the setup program in the root directory of this CD-ROM to create a
  95. Windows group which will contain at least one viewer.
  96.  
  97. ============================================================================
  98.  
  99.                          DOS/UNIX CONSIDERATIONS
  100.  
  101. Many of the files on this CDROM came from the UNIX world. Additionally,
  102. a number came from DOS. This poses a problem as DOS and UNIX have
  103. incompatible text file formats.
  104.  
  105. Since this CD is targeted at a large audience, comprising of DOS,
  106. UNIX and Mac users, the decision was made to use the DOS text file
  107. format on all nonarchived files. This is because a Unix formatted
  108. file (LF only) is usually unreadable in most DOS file viewers,
  109. whereas a DOS formatted text file, when viewed under UNIX merely
  110. shows some annoying but harmless ^M characters.
  111.  
  112. NOTE however that file in archives will not, in most cases, have been
  113. converted from their native format. If the archive originated on a
  114. UNIX system, files will most likely be LF only. A DOS archive will
  115. have CR-LF pairs. Please use the provided DOS2UNIX and UNIX2DOS
  116. programs to convert the files when needed.
  117.  
  118. ============================================================================
  119.  
  120.                            ARCHIVE FORMAT
  121.  
  122. In an attempt to provide a archive format that is useful to all
  123. target audiences of this CDROM, I made the decision to use the .ZIP
  124. archive method. This is because .ZIP is probably the most widely
  125. supported format in popular use today.  In most cases, even
  126. machine specific files (e.g., UNIX only programs) have been converted
  127. from, say, .tar.gz to .zip, simply because people on other systems
  128. may want to examine their contents or read/port the source.
  129.  
  130. When rearchiving UNIX files (i.e. any .tar archive), the Info-Zip
  131. archiver was used with the DOS compatibility flag turned OFF. This
  132. means that all of the original attributes of the files (permissions
  133. and long filenames) are preserved.
  134.  
  135. If you unzip one of these archives under DOS, the DOS unzip program
  136. should attempt to convert long filenames to DOS compatible 8.3
  137. filenames. If, in this process, two separate files in the same
  138. directory are truncated to the same filename, you should be prompted
  139. to rename one of them. In this case, don't forget to rename the file
  140. in any relevant makefiles that were in the archive.
  141.  
  142. ============================================================================
  143.  
  144.                         WHY NOT ROCKRIDGE ?
  145.  
  146. Originally, I intended to make this CDROM ISO-9660 + Rock Ridge
  147. extensions.  This would have allowed Unix users to see long
  148. filenames. However, I discovered that Macintosh computers cannot read
  149. any CDROM that has Rock Ridge extensions present. Since POV-Ray is
  150. officially supported on the Macintosh, I decided it would not be
  151. acceptable to exclude this group of users from being able to use this
  152. CD. Hence the decision to go with plain, vanilla ISO-9660. Note that
  153. many of the .ZIP archives on this CD contain long filenames. 
  154.  
  155. ============================================================================
  156.  
  157.                           DUPLICATED FILES
  158.  
  159. You will note that there is some amount of duplication of files on
  160. the disk, particularly in the wallpaper subdirectory, which consists
  161. solely of images that are present in the images directory, converted
  162. to Windows .BMP format.
  163.  
  164. In this and the other cases, I made the decision to increase the
  165. usability of the CDROM rather than try to cram the maximum amount of
  166. data onto it. This gives you, the purchaser, more value for money.
  167. Anyone can cram data onto a CD, but it takes time and effort to lay a
  168. CD out 'just so', in what I hope is a very usable manner.
  169.  
  170. ============================================================================
  171.  
  172.                              COPYRIGHT
  173.  
  174.  
  175. Many files on this CDROM did NOT come from publicly-accessible sources
  176. such as the internet, Compuserve or BBS's. A number were contributed
  177. specifically for this CD, and the right to use some others were
  178. purchased by the editor.
  179.  
  180. These files may NOT be redistributed without prior written permission
  181. from the author of the work. In almost all cases, work on this CD is
  182. protected by the author's own copyright, but redistribution is
  183. permitted as the author has granted permission to do so. You are only
  184. permitted to redistribute copyrighted files that have such permission
  185. granted by comments or information in the archive.
  186.  
  187. The list of subdirectories in the \_bbs directory contains all the
  188. subdirectories where all the files are ok.  You may mount any of the
  189. files in any of these subdirectories on your BBS. You may not mount
  190. any subdirectories that are not in this list.
  191.  
  192. The above guidelines should be sufficient to allow you to determine
  193. which files may be redistributed. However, I will explicitly point
  194. out that the version of QPEG on this CDROM is NOT shareware and may
  195. not be redistributed. Also, Dan Farmer's FROSTY image source may not
  196. be redistributed. The same applies to the Graphics Gems subdirectory.
  197.  
  198.                          WHAT IS REDISTRIBUTION ?
  199.  
  200. The term 'redistribution' refers to physically redistributing files
  201. or to making them available for distribution, such as on a bulletin
  202. board system.  Most files on this CDROM may be used on a BBS but you
  203. must respect the authors requests in each case. For example, you may
  204. not make QPEG or the Frosty source available for downloading, nor may
  205. you pass it on to third parties. It is your responsibility to ensure
  206. you comply with copyright. The location of a file or its absence of
  207. explicit mention in this document does not imply that it is free to
  208. redistribute.
  209.  
  210.                           COLLECTION COPYRIGHT
  211.  
  212. The entire contents of this CD are protected by collection copyright
  213. and may not be reproduced in whole or significant part without prior
  214. written permission from Walnut Creek CDROM and Christopher J. Cason.
  215.  
  216.                             POV-Ray COPYRIGHT
  217.  
  218. The POV-Ray copyright places specific conditions on how it may be
  219. distributed. Please read POVLEGAL.DOC in the povray/ subdirectory if
  220. you intend redistributing POV-Ray. One of the conditions it places
  221. on distribution is that no CDROM containing POV-Ray may be sold for
  222. more than the equivalent of US$0.10 per megabyte. This means that if
  223. you are reselling this CDROM you may not exceed that price without
  224. violating copyright.
  225.  
  226.                              DERIVATIVE WORKS
  227.  
  228. A 'derivative work' is a work that incorporates portions of some
  229. other person's work. A good example is a POV-Ray scene file that you
  230. create that uses, in full or in part, one of the other scene files on
  231. this CDROM. In most cases, you will not be permitted to distribute
  232. the scene source OR the image that you create with it, unless the
  233. owner of the original file has granted you permission to do so.  Most
  234. authors state their policy in the scene source itself. Absence of a
  235. prohibition does not constitute permission.  Please keep this in mind
  236. if you modify any scenes here.
  237.  
  238.                              WINDOWS WALLPAPER
  239.  
  240. Note that despite the above, you ARE permitted to take the images in
  241. the windows wallpaper directories and place them on your local area
  242. network so that users may choose wallpaper backgrounds from them.
  243.  
  244. ============================================================================
  245.  
  246.                           Where to get POVRAY.
  247.  
  248. POV-Ray is a free program and may be obtained from a variety of
  249. sources. In particular, many good quality bulletin boards carry it.
  250. It can also be found on Compuserve (GO GRAPHDEV), the Internet
  251. (ftp.povray.org, ftp.uwa.edu.au, alfred.ccs.carleton.ca) and many
  252. other online services. See POVINF.DOC in the povray/ subdirectory for
  253. more details.
  254.  
  255. ============================================================================
  256.  
  257.                           GENERAL INFORMATION
  258.  
  259. When I started this project, I had no comprehension of the amount of
  260. time it would occupy. I wanted to produce a quality product, which
  261. deserved the POV-Ray name. To achieve this, it would not be possible
  262. to take the 'shovel the files on' attitude taken by some CDROM
  263. producers. Each and every file on this CD was individually selected
  264. and catalogued. In many cases, the author of the file had to be
  265. contacted and permission obtained to use it. This is not a trivial
  266. exercise.
  267.  
  268. In addition to the files obtained from the internet and Compuserve,
  269. many of the files on this CD were contributed specifically for the CD
  270. by the authors. In some cases, non-exclusive rights to use some of
  271. the files were purchased by me from a few authors.
  272.  
  273. The purpose of this CD was to provide you, the reader, the means to
  274. produce images with POV-Ray, a freeware ray tracer produced by the
  275. POV-Team.
  276.  
  277. The POV-Team is a group of programmers (including myself) and artists
  278. that spans the world. These people produce and give away free of
  279. charge this superb graphic tool. Look in the images/ directory of
  280. this CDROM to see what can be done with POV-Ray. To put it simply,
  281. it makes it possible for a person with no traditional artistic
  282. ability to produce superb images.
  283.  
  284. When you purchased this CD, you did not purchase POV-Ray, which - as
  285. I said - is free. In fact, you did not purchase any software. What you
  286. purchased is a collection of files that is designed to allow you to
  287. achieve maximum leverage in using POV-Ray. Of course, POV itself is here,
  288. but so also is a large collection of POV utilities and scene source. I
  289. also added a good range of 3d graphic utilities and source code to allow
  290. those of you who are programmers to create your OWN utilities.
  291.  
  292. If a file which you use is marked as 'shareware' in the author's
  293. documentation or the executable itself, please comply with the
  294. author's instructions regarding registration if you continue to use
  295. the program.
  296.  
  297. Enjoy! And, if you come up with what you think is a useful utility or
  298. a very good image, please share them with the world !
  299.  
  300. Christopher J. Cason.
  301. Perth, Australia.
  302. 10 December 1994.
  303.  
  304. Internet:   Chris.Cason@povray.org
  305. Compuserve: INTERNET:Chris.Cason@povray.org
  306.  
  307. --------------------------------- THANKS ---------------------------
  308.  
  309. This CDROM could not have happened without the efforts and belief of
  310. many people worldwide. Thanks go to (in no particular order):
  311.  
  312. David K. Buck
  313.  
  314.   David is the author of the DKBTrace raytracer. David contributed
  315.   the DKBTrace code, which formed the basis of POV-Ray.
  316.  
  317. Chris Young
  318.  
  319.   Chris is the POV-Team leader. He coordinates and also works on the
  320.   development of POV and has authored several books on the subject.
  321.   Chris devotes a large amount of his time and tremendous energy to the
  322.   project.
  323.  
  324. David Combes.
  325.  
  326.   Dave virtually camped over at my office the last few weeks of the
  327.   project.  He lugged his 10-ton tower over and hooked it into my
  328.   network, where he helped with on the final indexing and arrangements
  329.   of the files most evenings and several weekends.
  330.  
  331. Matthew Kaustinen.
  332.  
  333.   For invaluable logistical support and help with my email. (When I
  334.   was accepting contributions from the internet I was receiving an
  335.   almost-unmanageable 40 to 50 email messages a day, most of which
  336.   required replies).  Matt also contributed the desktop scene on the
  337.   back of this CD, which was made especially for the purpose. Check out
  338.   his superb ELWOOD animation on the CD, too.
  339.  
  340. Linus Torvalds.
  341.  
  342.   Linus is the author of what has become the Linux operating system.
  343.   Linux is a Un*x compatible operating system which aims towards POSIX
  344.   compliance. Most of the work done for this CD was done on a 486
  345.   running Linux. Like POV-Ray, Linux is free. Also like POV, it is (in
  346.   my ever so humble opinion <grin>) as good as or better than many
  347.   commercial offerings. Linus also impressed me as one of the few
  348.   people I've met who can walk into a Mexican restaurant, order extra-
  349.   hot food, and then not choke when he eats it.
  350.  
  351. Matt Drury.
  352.  
  353.   Of the Go Graphics Group (see the featured/ggg subdirectory.) His
  354.   assistance with obtaining permission for the use of many files from
  355.   Compuserve is appreciated.
  356.  
  357. The POV-Team
  358.  
  359.   For moral support and permission to include their copyrighted
  360.   program.
  361.  
  362. All contributors and persons whose work is featured.
  363.  
  364.   For permission to use their work too !
  365.  
  366. And uncountable other people ...
  367.  
  368.   I can't possibly name you all. You know who you are ... thanks !
  369.  
  370. ---------------------------- About the Editor ----------------------
  371.  
  372. I'm calling myself an 'editor' rather than an 'author' since my work
  373. was mainly in pulling together all the work that you see here. It was
  374. not a simple task.  It has occupied almost all of my spare time the
  375. past four to five months. More than 1000 hours of my time went into
  376. this project, 75% of which was probably administrivia.
  377.  
  378. I also manage two Internet FTP sites for POV-Ray, ftp.povray.org and
  379. ftp.uwa.edu.au. If you have internet access I suggest you check out
  380. povray.org, it's full of POV goodies. By the time this CD comes out
  381. we hope that our World Wide Web page will be operational. If you use
  382. the WWW check out http://www.povray.org.
  383.  
  384. I can be contacted via any of the following addresses -
  385.  
  386. Internet : Chris.Cason@povray.org
  387.  
  388. Postal   : GPO Box 2270,
  389.            Canberra, ACT,
  390.            Australia 2601.
  391.  
  392. ==========================================================================
  393.  
  394. Disclaimer:
  395.  
  396. This CDROM comes with a full money back guarantee.  If you are
  397. dissatisfied for any reason, you can return it for a full refund.
  398. Walnut Creek CDROM makes no warranty about any file on this CDROM,
  399. including any written by Walnut Creek.  You, not Walnut Creek CDROM,
  400. assume all risk of using any of the files on this CDROM.  We reserve
  401. the right to limit any effort on our part to rectify problems with
  402. any file on this CDROM.
  403.  
  404. ==========================================================================
  405.  
  406. You also need to be aware that we cannot accept any responsibility,
  407. or liability in the event that using the software on this disk causes
  408. you grief, malfunction, data loss or thinning of the hair.  As with
  409. any new software, make sure that you back up your system regularly so
  410. that you can recover from unforeseen crashes.
  411.  
  412. Although we have made every attempt to examine every program on this
  413. disc, some non-shareware or public domain programs may have slipped
  414. by.  If you find such a program on this disc, please notify us
  415. immediately so we can rectify the situation.  Thanks.
  416.  
  417. ==========================================================================
  418.  
  419. Walnut Creek CDROM is an approved vendor and associate member of the
  420. Association of Shareware Professionals (ASP).  ASP wants to make sure
  421. that the shareware principle works for you.  If you are unable to
  422. resolve a shareware-related problem with an ASP member by contacting
  423. the member directly, ASP may be able to help.  The ASP Ombudsman can
  424. help you resolve a dispute or problem with an ASP member, but does
  425. not provide technical support for members' products.  Please write to
  426. the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a
  427. CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536.
  428.  
  429. ==========================================================================
  430.  
  431. All trademarks belong to their respective trademark holders.
  432. Third-Party applications/software/information are copyrighted by
  433. their respective owners.
  434.  
  435. ==========================================================================
  436.  
  437. This CDROM copyright (c) 1995 Walnut Creek CDROM.  All rights reserved.
  438.  
  439. ==========================================================================
  440.  
  441. This CDROM is unconditionally guaranteed.  If you are dissatisfied
  442. for any reason, simply return it with a short note and your contact
  443. information for a full refund.
  444.  
  445.         Walnut Creek CDROM
  446.         Suite 260
  447.         1547 Palos Verdes Mall
  448.         Walnut Creek CA  94596
  449.         USA
  450.  
  451.          1 800 786-9907 (Toll Free Sales) 
  452.          1 800 731-7177 (Toll Free Tech Support)
  453.         +1 510 674-0783 (Sales) 
  454.         +1 510 603-1234 (Tech Support)
  455.         +1 510 674-0821 FAX
  456.         Email: orders@cdrom.com (Orders)
  457.         Email: info@cdrom.com (Information)
  458.         Email: support@cdrom.com (Tech Support)
  459.         WWW:   http://www.cdrom.com/
  460.         FTP:   ftp.cdrom.com
  461.  
  462. =============================== README.TXT ==================================