home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Raytrace & Morphing / SOS-RAYTRACE.ISO / programm / utility / dos / pv3d / pv3d_ord.doc < prev    next >
Encoding:
Text File  |  1992-11-26  |  16.6 KB  |  495 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                   PV3D
  8.              Beta version 0.20
  9.              25th November 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.                77240 Cesson la Forêt
  28.                   France
  29.  
  30. Beta version 0.20 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 (GUI)
  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.         Blob structure
  46.         Dynamic Rotate Move Scale (R-M-S) of the shape
  47.         Dynamics use of the shapes with the mouse.
  48.         Visualisation of the standard textures of POV-Ray
  49.         Visualisation of the standard color of POV-Ray
  50.         Direct generation of POV-Ray 1.0 scene file with textures....
  51.         Direct generation of TXT file
  52.         Generation of PTX file for smooh triangles.
  53.         Direct use of TXT file.
  54.         Spline generation (Profil generate bounded Triangle object
  55.                    with specific rotation translation...)
  56.         Duplicate shape function with orbital option and full
  57.                    other parameter.
  58.         Shape Mirror fonction
  59.         Dynamics Zoom(+/-) of the scene
  60.         Shape automatic alignement function
  61.         2D X-Y Y-Z Z-Y X-Y-Z visualisation and work
  62.         3D Isometric visualisation and work
  63.         Other ......
  64.         And a lot of new features in a future version.
  65.                    I work the night for that
  66.  
  67. PV3D generate TXT and POV (version 1.0) files
  68.  
  69. PV3D feature a GUI interface and requires:
  70.     -a VGA Graphics Card (640x480 16 and 320x200 256)
  71.     -a Microsoft-compatible mouse
  72.     -286/386/486 supported   (XX87 version only in license version)
  73.      The best result it is with one 486 DX 33Mhz and one good VGA board.
  74.  
  75. PV3D was written in MS C6.00,  All source code, include object-shedule is
  76.      self-written.
  77.      PV3D2POV it is based in a TXT2DKB source of Steve Anger (TXT to DKB)
  78.  
  79. PV3D BETA 0.20 it is a shareware software. we encourage you to freely copy
  80.      and distribute this demonstration version.
  81.      If you want receive the licensed version see the "Shareware condition
  82.      of PV3D" Chapter.
  83. Sory but Beta version 0.20 of PV3D it is a very early version, so it might
  84. not bug-free. I work for bug-free and new feature : CSG, ANIMATE ....
  85.  
  86. Beta version 0.20 of PV3D
  87.  
  88. Generated files
  89. ---------------
  90.  
  91.  TXT File
  92.  
  93.  The TXT file consists of 12 numbers per line with each line representing
  94.  the coordinates and colour of one triangle.  The numbers are arranged as
  95.  follows:
  96.  
  97.            Ax Ay Az Bx By Bz Cx Cy Cz [R G B]
  98.  
  99.  where Ax, Ay, etc are the x,y,z coordinates of the three verticies A, B,
  100.  and C. R, G, and B represent the Red, Green, and Blue components of the
  101.  triangle colour and range from 0.0 to 1.0.  If colour no components are
  102.  given they are assumed to all be 1.0.
  103.  
  104.  It possible to use this file directly with the TXT2DKB software of Steve
  105.  Anger (TXT to DKB)
  106.  
  107. POV File
  108.  
  109.  POV it is scene description file used by the raytracers POV.
  110.  POV-Ray: PERSISTENCE OF VISION raytracer it is the power full
  111.  raytracer of the public domain.
  112.  If you want a copy of there freeware contact the POV-Team on the
  113.  Compuserve Online Service in the GRAPHICS forums, COMART forum
  114.  message section 16 (!GO COMART). Or every serious BBS.
  115.  The CIS COMART forum is devoted to computer generated artwork like
  116.  raytracing, animation and fractals.
  117.  For more information on Compuserve call (USA) 1-800-848-8990.
  118.  
  119.  Inquiries may be made to:
  120.  
  121.        Drew Wells
  122.        POV-Team Leader
  123.        CIS: 73767,1244 (preffered)
  124.        AOL: Drew Wells
  125.        Internet: 73767.1244@compuserve.com
  126.        Prodigy: SXNX74A (not used often)
  127.        US Mail:
  128.      905 North Avenue 66
  129.      Los Angeles, CA, USA
  130.      90042
  131.        Phone: (213) 254-4041
  132.  
  133.  POV-Ray is based on the popular DKBTrace version 2.12 with the
  134.  permission of the authors.
  135.  DKBTrace was originally written by David K. Buck.
  136.  DKBTrace Ver 2.0-2.12 were written by David K. Buck & Aaron A. Collins.
  137.  
  138.  PV3D generate only a POV-RAY version 1.0 data file.
  139.  
  140.  
  141. Beta version 0.20 of PV3D
  142.  
  143. PTX file
  144.  
  145.  The [PV3D2POV] icone option generate 2 files : a POV file for the POV
  146.  primitive shape and a PTX file for the triangle shape (Spline).
  147.  The tools PV3D2POV optimize the triangle PTX shape file and generate a
  148.  POV file with smoothed or not triangle. (PV3D2POV append the POV and PTX
  149.  file).
  150.   The syntax of PV3D2POV it is:
  151.  
  152.     PV3D2POV filename -sxxx
  153.  
  154.     filename : it is the name of the filename.POV and filename.PTX file
  155.     xxx      : it is the value for the smoothed triangle.
  156.  
  157.    If the first character of the shape name it is $ PV3D2POV dont smooth
  158.    the triangle of the shape. With this option it is possible to make smoothed
  159.    and not smoothed triangle in a same scene.
  160.  
  161.  
  162. Beta version 0.20 of PV3D
  163.  
  164. PV3D Installation
  165. -----------------
  166.  
  167. PV3D Beta 0.20 was a package of 3 archived files :
  168.  
  169.         PV3DB020.ZIP program  file  Version BETA 0.20
  170.         PV3D-IMG.ZIP 80x50 IMG textures files
  171.         PV3D-SCN.ZIP Examples files
  172.  
  173. To install PV3D BETA 0.20 :
  174.  
  175.     Create one PV3D directory and put on the unarchived file of PV3DB020
  176.     and PV3D-SCN.
  177.     Create one PV3D\IMG directory and put on the unarchived file PV3D-IMG.
  178.  
  179.     Root-\PV3D            <-(PV3DB020 and PV3D-SCN)
  180.          \PV3D\IMG        <-(PV3D-IMG)
  181.  
  182. Please do not upload any modifications to the ZIP file itself.  If
  183. you  find  any bugs, or have any  suggestions  for  enhancements,
  184. please contact me for inclusion in future updates.  You can reach
  185. me by mail at the address listed below.
  186.  
  187. To run PV3D BETA 0.20 type :
  188.  
  189.     PV3D (enter)
  190.  
  191.     To activate some function in the work scene push the left or right
  192.     mouse button on the desired icone.
  193.  
  194.     To activate the line-help  function push the 'Help' icone  with the 
  195.     left mouse button.
  196.  
  197.     Load examples file.
  198.  
  199.  
  200. Beta version 0.20 of PV3D
  201.  
  202. Quick documentation 
  203. ------------------- 
  204.  
  205. ==========================================================================
  206. =Sorry for my english but I am a French body. At this time I writting one=
  207. =  more complet documentation logiquely avalaible in a futur release.    =
  208. ==========================================================================
  209.                                     
  210. Push the 'help' button with left mouse button to enable the online help.
  211.  
  212. Some button have two functions : use the left or right mouse button to select
  213.                  one of this.
  214.  
  215. In a graphic area :
  216. -------------------
  217.  
  218. Press the right mouse button on the shape to select this.
  219. Press the left mouse button on the box arround the selected shape to move 
  220. this.
  221.       Press the right mouse button to validate
  222. Press the left mouse button in the left box corner to scale the shape.
  223.       Press the right mouse button to validate
  224. Press the left mouse button in a free area to display the quick shape 
  225. information.
  226.  
  227. In a text button area :
  228. ------------------
  229. 'Draw'   icone : redraw the scene in a screen
  230.          The flag button at the left of the 'Draw' it is for
  231.          stop the automatic redraw of the scene.
  232.  
  233. 'Zoom'   icone : Zoom a part of the screen
  234.          Press the left mouse button in the left corner of the
  235.          selected box area, move the mouse and press the right
  236.          mouse button to zoom the area.
  237.  
  238. 'S'      icone : To change the scale of the scene and center the scene
  239.          This option it is used to Zoom in and center the scene.
  240.  
  241. '2D XY'  icone : To work in 2D mode with the X and Y axis.
  242.  
  243. '2D ZX'  icone : To work in 2D mode with the Z and X axis.
  244.  
  245. '2D ZY'  icone : To work in 2D mode with the Z and Y axis.
  246.  
  247. '2D XYZ' icone : To work with the 3 views in a same time
  248.  
  249. '3D iso' icone : Left mouse button to display the scene in isometric 
  250.          representation.
  251.          Right mouse button to select the radius.
  252.          Some dynamic function was available in this mode, play with
  253.          icones to see that. The selected shape was not box arround
  254.          the shape at this time. Use R-M-S icone to move, scale and
  255.          rotate the shape. '+''-' icone to select the active shape.
  256.  
  257. Beta version 0.20 of PV3D
  258.  
  259.  
  260. 'Objet' icone  : Left mouse button display or hidden the select box around
  261.          the selected shape.
  262.          Right mouse button display the information of the selected
  263.          shape and permit to change the name of the shape.
  264.          If the first character of the triangle shape it is $ and
  265.          you use the PV3D2POV option the shape are not smoothed.
  266.  
  267. '+''-'  icone  : it is to change the selected shape
  268.  
  269. 'Del' icone : Delete the selected shape
  270.  
  271. 'mov' icone : When you press this icone the dynamic moving of the selected
  272.           shape as enabled. If you press the left mouse button in a free
  273.           graphic area automatiquely the shape pass in move mode.
  274.           This function it is to move a little shape.
  275.  
  276. 'mirror' icone : It is to duplicate the shape with the X Y or Z axis
  277.  
  278. 'duplicate' icone : Duplication of the selected shape with Scale Move and
  279.             Rotation parameters.
  280.             When you select this option a new menu it is displayed,
  281.             press the coordonate icone to put your parameter.
  282.             Orbital yes : to generate a rotation arround the X Y Z 0
  283.             axis
  284.             Orbital no  : to rotate the shape
  285.  
  286. 'R-M-S' icone : Rotate Move Scale
  287.         When you select this icone the R-M-S menu it displayed in the 
  288.         left corner of the screen. One box it displayed arround the 
  289.         selected shape. Tree area it is available, press the x- x+
  290.         y- y+ z- z+ button to Rotate Move or Scale the shape.
  291.         a+ a- scale the shape in the 3 axis .
  292.         The green icone define the step of Rotation Moving or Scaling.
  293.         In the Rotate area if you press the right mouse button in a
  294.         x+ x y+ y- z+ z- icone it is possible to input directly the 
  295.         rotation value.
  296.  
  297.         Warning:
  298.         ========
  299.         When PV3D generate One POV file if you have a shape rotation 
  300.         PV3D generate 1 rotation command by axis.
  301.          
  302.             rotate < 0 10 0 >
  303.             rotate < 0 0 10 >
  304.             rotate < 10 0 0 >
  305.         
  306.         Some time POV 1.0 not supporte this, in this case change 
  307.         directly in the POV  file the order of the rotaton.
  308.     >|      when you load PV3D the standard scale of the display it is
  309.     >|      50 and the scaling incrementation value it is to big.
  310.     >|      Select a new value for this scale or pass in scale 1 with
  311.     >|      the 'S' icone;
  312.  
  313.  
  314. Beta version 0.20 of PV3D
  315.  
  316. 'spline' icone :
  317.          A spline shape it is created by orbital rotation with the
  318.          Y axis. The result it is a Triangular shape definition. With
  319.          PV3D it is possible to put some parameter to make a complex
  320.          rotation with scaling moving and rotatif effect. Spiral
  321.          shape it is very easy to create with PV3D.
  322.  
  323.     With the Left mouse button: (free profil)
  324.          Left button mouse start the drawing of the shape_profil and
  325.          push a new dot for create the profil.
  326.          Right button mouse stop the profil creation and start the
  327.          spline menu.
  328.     With the Right mouse button: (file profil)
  329.          Load in first a PRO file (profile) and move, scale, rotate
  330.          this with the standard function of PV3D. When you select
  331.          the spline icone with one PRO shape selected you make a
  332.          spline shape with this.
  333.  
  334.     WARNING:
  335.         When you generate a spline shape PV3D center this in the
  336.         scene (<0 0 0 >) for a more easy calculation.
  337.         Move, Scale, Rotate directly the shape generated with
  338.         the mouse to the correct possition.
  339.  
  340. 'colored' x 16  icone : Left mouse button change the color of the selected
  341.         shape in a screen
  342.         Right mouse button change the color of the background
  343.         The color of the shape in the screen it just for a good
  344.         presentation of the shape in a screen. If you want assign
  345.         a 24 bit color for the POV file use the 'color' icone
  346.  
  347. 'color'   icone : Left mouse button to a quick selection of the 24 bit
  348.           standard colors of POV.
  349.           Right mouse button to see and select the POV standard
  350.           colors.
  351.  
  352. 'texture' icone : Left mouse button to a quick selection of the POV standard
  353.           texture.
  354.           Right mouse button to see and select the POV standard
  355.           texture (put the img file in a PV3D\IMG directory for this
  356.           function).
  357.  
  358.  
  359. Beta version 0.20 of PV3D
  360.  
  361. 'Full scn'icone : Display the scene without icone.
  362.  
  363. 'Grid'    icone : Display a grid in a scene area.
  364.  
  365. 'New scn' icone : delete all shape in memory and prepare PV3D for a new scene.
  366.  
  367. 'Save'    icone : Generate a PVD and PVT scene description files for PV3D.
  368. 'Load'    icone : Load a PVD and PVT  PV3D description scene.
  369.  
  370. 'Save TXT'icone : Generate a TXT file of the scene.
  371.  
  372. 'Gen POV' icone : Generate a POV V1.0 file directly used by the PVRAY render
  373.           software.
  374.  
  375. 'PV3D2POV'icone : Generate two file :
  376.             a POV file for the POV primitive shape and a PTX file
  377.             for the triangle shape (Spline).
  378.             The tools PV3D2POV optimize the triangle PTX shape
  379.             file and generate a POV file with smoothed or not
  380.             triangle. (PV3D2POV append the POV and PTX file).
  381.  
  382.  
  383. Beta version 0.20 of PV3D
  384.  
  385. In a graphic button area:
  386. -------------------------
  387.  
  388. >The magenta icone with graphic, load in a scene a primitive shape in a center
  389. of the scene (<0 0 0>). Move, Scale, Rotate directly the shape loaded with
  390. the mouse to the correct position.
  391.  
  392. All of this primitive shape are displayed with triangle in a screen but when
  393. you generate a POV file, PV3D put a POV primitive shape in the scene
  394. description file.
  395.  
  396. Warning:
  397. -------
  398. For the Torus shape PV3D use only the X axis to calculate the High radius of 
  399. the torus and the Y axis to calculate the low radius. The Z axis was not used
  400. with this version of PV3D.
  401. For the plane one flat cube it is displayed but in reality the plane are no
  402. limit. If you scale the plane you scale the texture of the plane. 
  403.  
  404. >Blue and Red icone
  405.  
  406. It is to generate one BLOB structure.
  407. The Blob + and Blob - generate a BLOB structure. Only the first BLOB loaded
  408. it is used by PV3D to define thr colors or texture of the structure.
  409.  
  410. >The brown icone it is to load PRO file and TXT file.
  411.  
  412.     PRO file it is used with the spline function.
  413.         select the PRO icone and load a PRO file. Move , scale,
  414.         rotate the shape with the standard option of PV3D. When you
  415.         have correctly positionned you profil press the Spline icone
  416.         with th right mouse button. Put the desired parameter in a
  417.         spline menu and enjoy to see you creation.
  418.  
  419. >The cyan icone was to center the shape.
  420.  
  421. In first select a reference shape and press the '[S]' icone.
  422. Select the shape to justifie with the referenced shape and use the center 
  423. icone the axis icone or the rotation icone.
  424. When you select the rotation icone or the axis icone one menu it is displayed
  425. in a screen. Select the axis (X (or/and) Y (or/and) Z) to work. 
  426.  
  427. >The gray icone was to put a Light, Camera and Look_at in the scene.
  428.  
  429. It is possible to put every light (POV limit) but just one Camera and
  430. one Look_at. For move the light, camera and look_at use the 'mov' icone.
  431. Use the 'color' icone to select the color of the light.
  432.  
  433. >The brown icone 'Other' it is to load a TXT file.
  434.            
  435.            Ax Ay Az Bx By Bz Cx Cy Cz [R G B]
  436.  
  437. Warning:
  438. --------
  439. PV3D not load the [R G B] information of the TXT file in this version.
  440. PV3D save the 24 bit [R G B] information selected for the shape in a TXT file.
  441.  
  442.  
  443. Play with the icone to see all functionality of this software and happy time
  444. with this. Only the 'Save' Icone was not valid with the demonstration version.
  445.  
  446. Beta version 0.20 of PV3D
  447.  
  448. Shareware condition of PV3D
  449. ---------------------------
  450.  
  451. PV3D it is a shareware software. we encourage you to freely copy and
  452. distribute this demonstration version. No part of this package may be
  453. included as part of a commercial package without My explicit written
  454. permission .
  455.  
  456. Sory but Beta version of PV3D it is a very early version, so it might not
  457. bug-free. I work for bug-free and new feature : CSG, ANIMATE ....
  458.  
  459. This is a demontration version of PV3D. It's fully functional except it can
  460. not save scene file.
  461.  
  462. If you want receive :
  463.  
  464.     - PV3D last version with Full save/load option
  465.     - XX87 Coprocesseur version
  466.     - Other "surprise"
  467.  
  468.       send to me
  469.       for France 250FF Check or money
  470.       for US and other $55 no check or credit card just money or traveller.
  471.  
  472.       Lecointe Ludovic
  473.       16 rue du Bouvreuil
  474.       77240 Cesson la Forêt
  475.       France
  476.  
  477.  
  478. Legal Stuff
  479. -----------
  480.  
  481.    This software is provided as is without any guarantees or warranty.
  482.    Although the authors have attempted to find and correct any bugs in
  483.    the package, they are not responsible for any damage or losses of any
  484.    kind caused by the use or misuse of the package. The authors are
  485.    under no obligation to provide service, corrections, or upgrades
  486.    to this package.
  487.  
  488.    No part of this package may be included as part of a commercial package
  489.    without My explicit written permission .
  490.  
  491.  
  492. /*****************************/
  493.  
  494.  
  495.