home *** CD-ROM | disk | FTP | other *** search
/ Learn 3D Graphics Programming on the PC / Learn_3D_Graphics_Programming_on_the_PC_Ferraro.iso / rwwin / rwpaint.tx_ / rwpaint.bin
Text File  |  1995-11-14  |  10KB  |  220 lines
  1.      RenderWare(tm) v1.4 FCS MS Windows Demonstration Programs
  2.      =============================================================
  3.  
  4. ----------------------------------------------------------------------------
  5. This demonstration program is copyright Criterion Software Limited 1994. 
  6. Criterion Software grants you a license to use it only in the form as 
  7. supplied. You may not disassemble, decompile or reverse engineer this 
  8. demonstration program.
  9.  
  10. This demonstration programs is provided as is with no warranties of any
  11. kind. Criterion Software will not, under any circumstances, be liable for
  12. any lost revenue or other damages arising from the use of this
  13. demonstration programs.
  14.  
  15. RenderWare is a registered trademark of Canon Inc.
  16. Other trademarks acknowledged.
  17.  
  18. ----------------------------------------------------------------------------
  19.  
  20. Installation
  21. ============
  22.  
  23. In order to ensure that RWPAINT.EXE can load all the sample scripts 
  24. supplied with RenderWare it is necessary to set the environment variable
  25. RWSHAPEPATH. The environment variable RWSHAPEPATH should be set to point
  26. to the directories containing the script and texture files to be
  27. loaded. (Suitable sample scripts and textures may be obtainde from the
  28. other RenderWare demonstration programs.)
  29.  
  30. Please note that this must be done outside of MS Windows; it
  31. cannot be done from a DOS window under Microsoft Windows, To set
  32. the environment variable RWSHAPEPATH, you must exit MS Windows and
  33. return to the DOS prompt. Assuming that the RenderWare scripts and
  34. textures have been installed in "c:\rwwin\scripts" and "c:\rwwin\textures"
  35. the following command at the DOS prompt will set the environment
  36. variable correctly:
  37.  
  38. set RWSHAPEPATH=c:\rwwin\scripts;c:\rwwin\textures
  39.  
  40. If you have installed the scripts and textures elsewhere, please
  41. substitute that location for "c:\rwwin\".
  42.  
  43. It is strongly recommended that this line be added to the AUTOEXEC.BAT 
  44. file of the computer on which the RenderWare demonstration programs are
  45. to be run. This will ensure that RWSHAPEPATH is set whenever the computer
  46. is started.
  47.  
  48. RWPAINT.EXE
  49. ===========
  50.  
  51. RWPAINT.EXE is an enhanced version of RWVIEW.EXE. The user is able
  52. to paint clumps - and save them out as scripts. RWPAINT.EXE has a
  53. built-in material editor which gives the user a high degree of control over
  54. the surface of a clump. RWPAINT.EXE also demonstrates RenderWare's user-draw
  55. facilities.
  56.  
  57. The Application Controls
  58. ------------------------
  59.  
  60. As mentioned previously, RWPAINT.EXE is, essentially, an enhanced
  61. version of RWVIEW.EXE. It operates in one of two modes. In "Drag"
  62. mode - indicated by the selection of the arrow button in the toolbar -
  63. RwPaint behaves exactly like RWVIEW.EXE. Clumps can be spun and dragged
  64. with the left mouse button. In "Paint" mode - indicated by the
  65. selection of the paintbrush button in the toolbar - the left mouse
  66. button paints the polygons of a clump (or the entire clump)
  67. with the material specified by the material editor dialog.
  68.  
  69. To bring up the material editor dialog box, click the paintbrush button on the
  70. toolbar or press the key 'p'. The material editor is then opened with the
  71. previous material used. Initially the default material is in effect;
  72. Ambient, Diffuse and Specular are zero, Red, Green and Blue are zero, Geometry
  73. Sampling is Solid, LightSampling is Facet, Opacity is one and the material has
  74. no texture. Double clicking the left mouse button over a polygon
  75. will invoke the material editor with the material of the polygon under the
  76. mouse pointer.
  77.  
  78. Clumps may be loaded into the RwPaint by "drag and drop" or with the
  79. Open item of the File menu. Clumps may be saved with the Save and Save As
  80. items of the File menu. This enables the results of your painting to be saved.
  81.  
  82. The Material Editor
  83. -------------------
  84.  
  85. The material editor has four areas. The top left area contains a sphere
  86. rendered with the material shown by the editor's controls. If the material
  87. editor was invoked with the toolbar button or keyboard it will initially
  88. appear as a black circle characteristic of the default material. This sphere is
  89. the 'model' and gives feedback on the changes you make to the color, lighting,
  90. geometry and texture controls. Note that there is a cube inside the sphere
  91. to help judge opacity settings.
  92.  
  93. The top right area contains a number of scrollbars. These control the ambient,
  94. diffuse and specular reflection coefficients of the material, the red, green
  95. and blue components of the material's color and the opacity of the material.
  96.  
  97. The bottom left area contains two groups of radio buttons. These control the
  98. geometry sampling and light sampling of the material.
  99.  
  100. The bottom right area shows the textures currently loaded. These are textures
  101. that have been loaded from scripts dropped on the main window or from texture
  102. files dropped on the main window. Texture files may also be dropped on the
  103. material editor itself. Click on one of these textures to apply it to the
  104. model. The first 'texture' in the list is not actually a texture but rather
  105. shows the currently selected color. Clicking on this will
  106. remove the texture from the material. The check box provides control over
  107. whether the textures are lit.
  108.  
  109. In "Drag" mode the application controls are as follows:
  110. -------------------------------------------------------
  111.  
  112. 1)  Adding a clump.
  113.     Simply drop a script file on the application window from the File
  114.     Manager or use the Load item of the File menu.
  115.  
  116. 2)  Adding a sprite clump
  117.     Simply drop a texture file on the application window from the File
  118.     Manager.
  119.  
  120. 3)  Saving a clump
  121.     Click the left mouse button over a clump to select that clump.
  122.     Then select the Save or Save As items of the File menu. Save will
  123.     save the clump back to the file from which it was loaded. Save As will
  124.     prompt for the name of the script file to save the clump as.
  125.  
  126. 4)  Deleting a clump.
  127.     Click the left mouse button while over the clump and hold down the
  128.     SHIFT and CONTROL keys.
  129.  
  130. 5)  Panning and zooming the camera.
  131.     Hold down the right mouse button 
  132.     Horizontal mouse movement will pan the camera around the scene.
  133.     Vertical mouse movement will zoom the camera into and out of the scene.
  134.  
  135. 6)  Tilting the camera.
  136.     Hold down the right mouse button and the SHIFT key 
  137.     Vertical mouse movement will tilt the camera over and under the scene.
  138.  
  139. 7)  Panning or tilting the light.
  140.     Hold down the right mouse button and the CONTROL key 
  141.     Horizontal mouse movement will pan the light around the scene.
  142.     Vertical mouse movement will tilt the light around the scene.
  143.  
  144. 8)  Spinning a clump.
  145.     Hold down the left mouse button over a clump.
  146.     Horizontal mouse movement will spin the clump about its Y axis.
  147.     Vertical mouse movement will spin the clump about its X axis.
  148.  
  149. 9)  Dragging a clump.
  150.     Hold down the left mouse button and the SHIFT key over a clump.
  151.     Horizontal mouse movement will drag the clump in X.
  152.     Vertical mouse movement will drag the clump in Y.
  153.  
  154. 10) Dragging a clump toward and away from the camera.
  155.     Hold down the left mouse button and the CONTROL key over a clump.
  156.     Vertical mouse movement will drag the clump in Z.
  157.  
  158. In "Paint" mode the application controls are as follows:
  159. --------------------------------------------------------
  160.  
  161. 1) Adding a clump.
  162.    Simply drop a script file on the application window from the File
  163.    Manager.
  164.  
  165. 2) Adding a sprite clump
  166.    Simply drop a texture file on the application window from the File
  167.    Manager.
  168.  
  169. 3) Saving a clump
  170.    Click the left mouse button over a clump to select that clump.
  171.    Then select the Save or Save As items of the File menu. Save will
  172.    save the clump back to the file from which it was loaded. Save As will
  173.    prompt for the name of the script file to save the clump as.
  174.  
  175. 4) Adding a texture to the material editor.
  176.    Simply drop a texture file on the material editor dialog.
  177.  
  178. 5) Panning and zooming the camera.
  179.    Hold down the right mouse button 
  180.    Horizontal mouse movement will pan the camera around the scene.
  181.    Vertical mouse movement will zoom the camera into and out of the scene.
  182.  
  183. 6) Tilting the camera.
  184.    Hold down the right mouse button and the SHIFT key 
  185.    Vertical mouse movement will tilt the camera over and under the scene.
  186.  
  187. 7) Panning or tilting the light.
  188.    Hold down the right mouse button and the CONTROL key 
  189.    Horizontal mouse movement will pan the light around the scene.
  190.    Vertical mouse movement will tilt the light around the scene.
  191.  
  192. 8) Painting one polygon of the clump.
  193.    Click the left mouse button down over the polygon to be painted.
  194.    The material currently specified in the material editor will be
  195.    applied to the polygon. If the mouse is moved whilst holding down
  196.    the left mouse button, the material is applied to each polygon the
  197.    pointer moves over.
  198.  
  199. 9) Painting each polygon in a clump.
  200.    Click the left mouse button whilst holding down the SHIFT over the clump.
  201.    The current material specified by the material editor will be
  202.    applied to each polygon in the clump.
  203.  
  204. The Menus
  205. ---------
  206.  
  207. The File Menu
  208.     Load...                - Load a new clump.
  209.     Save                   - Save a clump.
  210.     Save As...             - Save a clump to a new file.
  211.     Exit                   - Exit the demonstration.
  212.  
  213.  
  214.        ==========================================================
  215.  
  216.  
  217.  
  218.  
  219.  
  220.