home *** CD-ROM | disk | FTP | other *** search
/ Power DOS 1995 July / Power_DOS_CD-ROM_Walnut_Creek_July_1995.iso / graphics / raytrace / pv3d_ord.doc < prev    next >
Text File  |  1993-01-13  |  12KB  |  366 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                   PV3D
  8.              Beta version 0.10
  9.              15th October 1992
  10.  
  11.  
  12.            Written by : Lecointe Ludovic
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.             (c)  C3L Informatique 1992
  25.              Lecointe Ludovic
  26.             16 rue du Bouvreuil
  27.             77 Cesson la Forêt
  28.                   France
  29.  
  30. Beta version 0.10 of PV3D
  31.  
  32. PV3D is Copyright 1992 by
  33. Lecointe Ludovic
  34. All Rights Reserved
  35.  
  36. What is PV3D
  37. ------------
  38.  
  39. PV3D it is a graphics wire modeler software for raytracers.
  40.      Some feature as included in PV3D :
  41.         100% graphics interface
  42.         Vectoriel object structure
  43.         Sphere QSphere Cylinder (X Y Z) Cone (X Y Z) Plane (X Y Z)
  44.         Pyramid Tore .... primitive shapes include.
  45.         Dynamic Rotate Move Scale (R-M-S) of the shape
  46.         Dynamics use of the shapes with the mouse.
  47.         Visualisation of the standard textures of POV-Ray
  48.         Visualisation of the standard color of POV-Ray
  49.         Direct generation of POV-Ray 1.0 scene file with textures....
  50.         Direct generation of TXT file
  51.         Direct use of TXT file.
  52.         Spline generation (Profil generate bounded Triangle object
  53.                    with specific rotation translation...)
  54.         Duplicate shape function with orbital option and full
  55.                    other parameter.
  56.         Shape Mirror fonction
  57.         Dynamics Zoom(+/-) of the scene
  58.         Shape automatic alignement function
  59.         2D X-Y Y-Z Z-Y X-Y-Z visualisation and work
  60.         3D Isometric visualisation and work
  61.         Other ......
  62.         And a lot of new features in a future version.
  63.                    I work the night for that
  64.  
  65. PV3D generate TXT and POV (version 1.0) files
  66.  
  67. PV3D feature a GUI interface and requires:
  68.     -a VGA Graphics Card (640x480 16 and 320x200 256)
  69.     -a Microsoft-compatible mouse
  70.     -286/386/486 supported   (XX87 version only in license version)
  71.      The best result it is with one 486 DX 33Mhz and one good VGA board.
  72.  
  73. PV3D was written in MS C6.00,  All source code, include object-shedule is
  74.      self-written.
  75.  
  76. PV3D BETA 0.10 it is a shareware software. we encourage you to freely copy
  77.      and distribute this demonstration version.
  78.      If you want receive the licensed version see the "Shareware condition
  79.      of PV3D" Chapter.
  80. Sory but Beta version 0.10 of PV3D it is a very early version, so it might
  81. not bug-free. I work for bug-free and new feature : CSG, ANIMATE ....
  82.  
  83. Beta version 0.10 of PV3D
  84.  
  85. Generated files
  86. ---------------
  87.  
  88.  TXT File
  89.  
  90.  The TXT file consists of 12 numbers per line with each line representing
  91.  the coordinates and colour of one triangle.  The numbers are arranged as
  92.  follows:
  93.  
  94.            Ax Ay Az Bx By Bz Cx Cy Cz [R G B]
  95.  
  96.  where Ax, Ay, etc are the x,y,z coordinates of the three verticies A, B,
  97.  and C. R, G, and B represent the Red, Green, and Blue components of the
  98.  triangle colour and range from 0.0 to 1.0.  If colour no components are
  99.  given they are assumed to all be 1.0.
  100.  
  101.  It possible to use this file directly with the TXT2DKB software of Steve
  102.  Anger (TXT to DKB)
  103.  
  104. POV File
  105.  
  106.  POV it is scene description file used by the raytracers POV.
  107.  POV-Ray: PERSISTENCE OF VISION raytracer it is the power full
  108.  raytracer of the public domain.
  109.  If you want a copy of there freeware contact the POV-Team on the
  110.  Compuserve Online Service in the GRAPHICS forums, COMART forum
  111.  message section 16 (!GO COMART). Or every serious BBS.
  112.  The CIS COMART forum is devoted to computer generated artwork like
  113.  raytracing, animation and fractals.
  114.  For more information on Compuserve call (USA) 1-800-848-8990.
  115.  
  116.  Inquiries may be made to:
  117.  
  118.        Drew Wells
  119.        POV-Team Leader
  120.        CIS: 73767,1244 (preffered)
  121.        AOL: Drew Wells
  122.        Internet: 73767.1244@compuserve.com
  123.        Prodigy: SXNX74A (not used often)
  124.        US Mail:
  125.      905 North Avenue 66
  126.      Los Angeles, CA, USA
  127.      90042
  128.        Phone: (213) 254-4041
  129.  
  130.  POV-Ray is based on the popular DKBTrace version 2.12 with the
  131.  permission of the authors.
  132.  DKBTrace was originally written by David K. Buck.
  133.  DKBTrace Ver 2.0-2.12 were written by David K. Buck & Aaron A. Collins.
  134.  
  135.  PV3D generate only a POV-RAY version 1.0 data file.
  136.  
  137. Beta version 0.10 of PV3D
  138.  
  139. PV3D Installation
  140. -----------------
  141.  
  142. PV3D Beta 0.10 was a package of 3 archived files :
  143.  
  144.         PV3DB010.ZIP program  file  Version BETA 0.10
  145.         PV3D-IMG.ZIP 80x50 IMG textures files
  146.         PV3D-SCN.ZIP Examples files
  147.  
  148. To install PV3D BETA 0.10 :
  149.  
  150.     Create one PV3D directory and put on the unarchived file of PV3DB010
  151.     and PV3D-SCN.
  152.     Create one PV3D\IMG directory and put on the unarchived file PV3D-IMG.
  153.  
  154.     Root-\PV3D            <-(PV3DB010 and PV3D-SCN)
  155.          \PV3D\IMG        <-(PV3D-IMG)
  156.  
  157. Please do not upload any modifications to the ZIP file itself.  If
  158. you  find  any bugs, or have any  suggestions  for  enhancements,
  159. please contact me for inclusion in future updates.  You can reach
  160. me by mail at the address listed below.
  161.  
  162. To run PV3D BETA 0.10 type :
  163.  
  164.     PV3D (enter)
  165.  
  166.     To activate some function in the work scene push the left or right
  167.     mouse button on the desired icone.
  168.  
  169.     To activate the line-help  function push the 'Help' icone  with the 
  170.     left mouse button.
  171.  
  172.     Load examples file.
  173.  
  174.  
  175. Beta version 0.10 of PV3D
  176.  
  177. Quick documentation 
  178. ------------------- 
  179.  
  180. ==========================================================================
  181. =Sorry for my english but I am a French body. At this time I writting one=
  182. =  more complet documentation logiquely avalaible in a futur release.    =
  183. ==========================================================================
  184.                                     
  185. Push the 'help' button with left mouse button to enable the online help.
  186.  
  187. Some button have two functions : use the left or right mouse button to select
  188.                  one of this.
  189.  
  190. In a graphic area :
  191. -------------------
  192.  
  193. Press the right mouse button on the shape to select this.
  194. Press the left mouse button on the box arround the selected shape to move 
  195. this.
  196.       Press the right mouse button to validate
  197. Press the left mouse button in the left box corner to scale the shape.
  198.       Press the right mouse button to validate
  199. Press the left mouse button in a free area to display the quick shape 
  200. information.
  201.  
  202. In a text button area :
  203. ------------------
  204.  
  205. 'S'      icone : To change the scale of the scene and center the scene
  206.  
  207. '3D iso' icone : Left mouse button to display the scene in isometric 
  208.          representation.
  209.          Right mouse button to select the radius.
  210.          Some dynamic function was available in this mode, play with
  211.          icones to see that.
  212.  
  213. 'R-M-S' icone : Rotate Move Scale
  214.         When you select this icone the R-M-S menu it displayed in the 
  215.         left corner of the screen. One box it displayed arround the 
  216.         selected shape. Tree area it is available, press the x- x+
  217.         y- y+ z- z+ button to Rotate Move or Scale the shape.
  218.         a+ a- scale the shape in the 3 axis .
  219.         The green icone define the step of Rotation Moving or Scaling.
  220.         In the Rotate area if you press the right mouse button in a
  221.         x+ x y+ y- z+ z- icone it is possible to input directly the 
  222.         rotation value.
  223.  
  224.         Warning:
  225.         ========
  226.         When PV3D generate One POV file if you have a shape rotation 
  227.         PV3D generate 1 rotation command by axis.
  228.          
  229.             rotate < 0 10 0 >
  230.             rotate < 0 0 10 >
  231.             rotate < 10 0 0 >
  232.         
  233.         Some time POV 1.0 not supporte this, in this case change 
  234.         directly in the POV  file the order of the rotaton.
  235.  
  236. 'mov' icone : When you press this icone the dynamic moving of the selected
  237.           shape as enabled. If you press the left mouse button in a free
  238.           graphic area automatiquely the shape pass in move mode.
  239.           This function it is to move a little shape.
  240.  
  241. 'colored' x 16  icone : Left mouse button change the color of the selected 
  242.         shape in a screen
  243.         Right mouse button change the color of the background
  244.         The color of the shape in the screen it just for a good 
  245.         presentation of the shape in a screen. If you want assign
  246.         a 24 bit color for the POV file use the 'color' icone
  247.  
  248. 'spline' icone : Left button mouse start the drawing of the shape_profil and
  249.          push a new dot for create the profil.
  250.          Right button mouse stop the profil creation and start the
  251.          spline menu.
  252.          
  253. 'duplicate' icone : Duplication of the selected shape with Scale Move and 
  254.             Rotation parameters. 
  255.             Orbital yes : to generate a rotation arround the X Y Z 0 
  256.             axis
  257.             Orbital no  : to rotate the shape 
  258.  
  259.  
  260. 'texture' icone : Left mouse button to quick selection of the POV standard 
  261.           texture.
  262.           Right mouse button to see and select the POV standard 
  263.           texture (put the img file in a PV3D\IMG directory for this 
  264.           function).
  265.  
  266. 'Gen POV' icone : Generate a POV V1.0 file directly used by the PVRAY render
  267.           software.
  268.  
  269.  
  270. Beta version 0.10 of PV3D
  271.  
  272. In a graphic button area:
  273. -------------------------
  274.  
  275. >The magenta icone with graphic load in a scene a primitive shape.
  276.  
  277. All of this primitive shape are displayed with triangle in a screen but when
  278. you generate a POV file PV3D put a POV primitive shape in the scene 
  279. description file.
  280.  
  281. Warning:
  282. -------
  283. For the Torus shape PV3D use only the X axis to calculate the High radius of 
  284. the torus and the Y axis to calculate the low radius. The Z axis was not used
  285. with this version of PV3D.
  286. For the plane one flat cube it is displayed but in reality the plane are no
  287. limit. If you scale the plane you scale the texture of the plane. 
  288.  
  289.  
  290. >The cyan icone was to center the shape.
  291.  
  292. In first select a reference shape and press the '[S]' icone.
  293. Select the shape to justifie with the referenced shape and use the center 
  294. icone the axis icone or the rotation icone.
  295. When you select the rotation icone or the axis icone one menu it is displayed
  296. in a screen. Select the axis (X (or/and) Y (or/and) Z) to work. 
  297.  
  298. >The gray icone was to put a Light, Camera and Look_at in the scene.
  299.  
  300. It is possible to put every light (POV limit) but just one Camera and
  301. one Look_at. For move the light, camera and look_at use the 'mov' icone.
  302. Use the 'color' icone to select the color of the light.
  303.  
  304. >The brown icone 'Other' it is to load a TXT file.
  305.            
  306.            Ax Ay Az Bx By Bz Cx Cy Cz [R G B]
  307.  
  308. Warning:
  309. --------
  310. PV3D not load the [R G B] information of the TXT file in this version.
  311. PV3D save the 24 bit [R G B] information selected for the shape in a TXT file.
  312.  
  313.  
  314. Play with the icone to see all functionality of this software and happy time
  315. with this. Only the 'Save' Icone was not valid with the demonstration version.
  316.  
  317. Beta version 0.10 of PV3D
  318.  
  319. Shareware condition of PV3D
  320. ---------------------------
  321.  
  322. PV3D it is a shareware software. we encourage you to freely copy and
  323. distribute this demonstration version. No part of this package may be
  324. included as part of a commercial package without My explicit written
  325. permission .
  326.  
  327. Sory but Beta version of PV3D it is a very early version, so it might not
  328. bug-free. I work for bug-free and new feature : CSG, ANIMATE ....
  329.  
  330. This is a demontration version of PV3D. It's fully functional except it can
  331. not save scene file.
  332.  
  333. If you want receive :
  334.  
  335.     - PV3D last version with Full save/load option
  336.     - XX87 Coprocesseur version
  337.     - Other "surprise"
  338.  
  339.       send to me
  340.       for France 250FF Check or money
  341.       for US and other $55 no check or credit card just money or traveller.
  342.  
  343.       Lecointe Ludovic
  344.       16 rue du Bouvreuil
  345.       77 Cesson la Forêt
  346.       France
  347.  
  348.  
  349. Legal Stuff
  350. -----------
  351.  
  352.    This software is provided as is without any guarantees or warranty.
  353.    Although the authors have attempted to find and correct any bugs in
  354.    the package, they are not responsible for any damage or losses of any
  355.    kind caused by the use or misuse of the package. The authors are
  356.    under no obligation to provide service, corrections, or upgrades
  357.    to this package.
  358.  
  359.    No part of this package may be included as part of a commercial package
  360.    without My explicit written permission .
  361.  
  362.  
  363. /*****************************/
  364.  
  365.  
  366.