home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0500 / CCE_0562.ZIP / CCE_0562.PD / CEDIT3D2 / CEDIT3D.DOC next >
Text File  |  1992-03-25  |  17KB  |  398 lines
  1. 3-D Object Colorizer v2.0 
  2. Copyright (c) 1991, 1992   J. C. Stanford
  3.  
  4. Since this version is the direct result of several users requests 
  5. it has been decided to make this release shareware to help 
  6. compensate for its development time.
  7.  
  8. 3-D Object Colorizer v2.0 is a SHAREWARE program.  A SHAREWARE 
  9. program is one which you may freely distribute, but if after 
  10. trying out the program you continue to use it you must then pay 
  11. the author.
  12.  
  13.  
  14.           Please send your SHAREWARE fee of $15.00 to:
  15.  
  16.                          J. C. Stanford
  17.                          7007 NW Montrose
  18.                          Kansas City, MO 64151
  19.  
  20. Registered users of 3D-Object Colorizer V2.0 will receive a Desk 
  21. Accessory version of the program. (2 megs of memory is required to 
  22. use the accessory version with Cyber Sculpt.)
  23.  
  24. Please include your address with the shareware payment.
  25.  
  26. Please support ALL shareware authors!
  27.  
  28.  
  29. ================================================================
  30.  
  31. 3-D Object Colorizer is a utility which allows one to recolor 
  32. individual faces of a CAD-3D v2.0 three dimensional object. 
  33. Individual objects may be viewed in solid form from any camera 
  34. angle. Changing a face's color is then as simple as clicking the 
  35. mouse on the face you wish to change. Objects may then be resaved 
  36. in CAD-3D file format.
  37.  
  38. ================================================================
  39.  
  40. COMPATIBILITY
  41.  
  42. This program should run on all STs and TTs in all resolutions. 1 
  43. meg or more memory required.
  44.  
  45. ================================================================
  46.  
  47. USING THE PROGRAM
  48.  
  49. After the program has loaded a screen begging for money will 
  50. appear. Pressing the Return key or clicking the mouse in the exit 
  51. box will clear the screen and allow access to the menu bar. All 
  52. program options are selected from the menu bar.
  53.  
  54. =========
  55. FILE MENU
  56. =========
  57.  
  58. The file menu contains entries for configuring the program and 
  59. loading and saving files.
  60.  
  61. COLOR PALETTE
  62. -------------
  63. The first menu entry displays the size of the color palette, the 
  64. total number of different colors which may be used to recolor 
  65. objects. This figure will default to 512 colors on all machines. 
  66. On STe's and TT's the hardware color palette has been extended to 
  67. 4096 colors. This program will allow the use of the extended 
  68. palette to recolor objects, even on systems with 512 colors. 
  69. (Though the additional colors will not be visible.) Selecting this 
  70. menu entry will toggle the figure between 512 colors and 4096 
  71. colors.
  72.  
  73. (NOTE - It has not been determined at this time if CAD-3D can make 
  74. use of the extended palette information on STe's and TT's. This 
  75. information is ignored by CAD-3D on 512 color systems. 
  76.  
  77. Lexicor's Chronos is NOT compatible with objects created in 
  78. extended palette mode, and their use will cause unexpected 
  79. results. Representatives of Lexicor have stated that compatibility 
  80. may be added in a future version of Chronos.
  81.  
  82. The upcoming release of RENDER 512 v2.1 has been designed to make 
  83. use of the extended palette information.)
  84.  
  85. DISPLAY MODE
  86. ------------
  87. The second menu entry sets the method used to display the 3D 
  88. objects. In VDI Mode the objects will be displayed in the current 
  89. graphics resolution, ensuring compatibility on all systems. 
  90. Clicking on the menu entry will select Line-a Mode, which allows 
  91. viewing objects in all 16 colors from ST Medium Resolution. Line-a 
  92. Mode is not fully compatible with the TT, and violates several of 
  93. Atari's programming guidelines. Consider yourself warned!
  94.  
  95. SHOW EDGES
  96. ----------
  97. This menu entry determines if objects will be drawn with visible 
  98. edges around each face in the Recolor Object and View All modes. 
  99. The menu entry will be checked if edges have been selected.
  100.  
  101. LOAD
  102. ----
  103. Load brings up the file selector to select a 3D2 object file to 
  104. load into memory. Any objects already in memory will be erased.
  105.  
  106. SAVE
  107. ----
  108. Save brings up the file selector to save the modified objects in 
  109. memory to a 3D2 disk file.
  110.  
  111. QUIT
  112. ----
  113. Exits the program.
  114.  
  115. ============
  116. RECOLOR MENU
  117. ============
  118.  
  119. The menu entries under this heading allow the recoloring and 
  120. viewing of objects, and editing of the CAD-3D color palette.
  121.  
  122. RECOLOR OBJECT
  123. --------------
  124. Selecting this menu entry displays the object selector from which 
  125. an object may be picked for editing. The object selector works 
  126. just like the system file selector, to choose an object double-
  127. click on its name in the window. If more than 21 objects are in 
  128. memory the scroll bar may be used to view them all.
  129.  
  130. Once an object has been selected the screen will clear and the 
  131. object will be displayed in the center of the screen as a solid 3D 
  132. form, as it would be viewed from CAD-3D with a camera setting of 0 
  133. degrees horizontal and 0 degrees vertical. Each visible face will 
  134. be drawn in its assigned color (or a shading pattern, depending on 
  135. the display resolution), without lightsource shading.
  136.  
  137. COLOR PALETTE CONTROLS
  138. At the top of the screen will be a grid of 16 colored boxes, one 
  139. for each color register. An outline will be drawn around the 
  140. leftmost entry indicating the active color. This is the color 
  141. which will be used for any face changes.
  142.  
  143. To select a new active color click the mouse in the desired color 
  144. entry. An outline will be drawn around the new color.
  145.  
  146. Another method to change the active color is to hold the left 
  147. shift key down while clicking the mouse on a 3D object face. The 
  148. active color will change to the color register used to color that 
  149. face.
  150.  
  151. To change the color assigned to a color register double click in 
  152. the box for that color. The color palette editor will be 
  153. displayed, allowing one to set the red, green and blue levels for 
  154. the color register. If a 512 color palette has been set each RGB 
  155. value can range from 0 to 7. If the 4096 color palette has been 
  156. selected the range is from 0 to 15. The new color will be 
  157. displayed in the box on the right (except on monochrome systems). 
  158. Selecting EXIT will change the color register to the new color, 
  159. and will also change any faces colored with that register (in all 
  160. objects) to the new color. Selecting CANCEL will restore the 
  161. original color.
  162.  
  163. Immediately below the color registers are several bands indicating 
  164. which colors are grouped together in the CAD-3D color shading 
  165. groups. To change a shading group position the mouse over the 
  166. leftmost color of the group you wish to create. Press and hold the 
  167. ALT key and then click and hold the mouse button. Drag the mouse 
  168. to the right to draw a dotted box over the colors you wish to 
  169. include in the group. Releasing the mouse will add the new color 
  170. group to the display. Refer to your CAD-3D documentation for 
  171. information on the use of Color shading groups. (Shading group 
  172. information is ignored by RENDER 512 and Chronos.)
  173.  
  174. CAMERA CONTROLS
  175. The 3D object is displayed based on the position of the camera. 
  176. This camera functions similarly to the default camera in CAD-3D 
  177. and is centered around the object. At the extreme top of the 
  178. screen the current camera settings are displayed. The keyboard is 
  179. used to change the camera settings. The left and right arrow keys 
  180. are used to pan the display in 10 degree increments. The up and 
  181. down arrow keys will rotate the camera vertically by 10 degrees. 
  182. The plus and minus keys will increase and decrease the zoom 
  183. magnification. The screen will not re-draw when a camera setting 
  184. has changed, allowing several changes to be made at once. The new 
  185. camera settings will be displayed at the top of the screen and an 
  186. '*' will appear to indicate changes have been made. To redraw the 
  187. object with the new camera settings press the spacebar. Pressing 
  188. the ESC key will abort the redraw, though the object will already 
  189. have been moved to its new position.
  190.  
  191. RECOLORING OBJECT FACES - SINGLE FACES
  192. Clicking the mouse within any of the visible faces will change 
  193. that face's color to the active color (the outlined color at the 
  194. top of the screen). The face will be redrawn in its new color. 
  195. After changing a face's color it may be restored to its previous 
  196. color by pressing the UNDO key. The UNDO key only operates on the 
  197. last face selected.
  198.  
  199. (NOTE - If a face which is changed is partially hidden by a closer 
  200. face, when the face is redrawn in its new color the entire face 
  201. will be drawn, as if it were the closest to the viewer. Pressing 
  202. the spacebar will redraw the object with its previous 
  203. relationship.)
  204.  
  205. RECOLORING OBJECT FACES - MULTIPLE FACES
  206. There are two methods available to change the color of more than 
  207. one face at a time.
  208.  
  209. METHOD 1 VERTEX SELECT - Holding the control key down while 
  210. clicking and holding the left mouse button creates a box which may 
  211. be used to cover the vertices of one or more faces. Releasing the 
  212. mouse button will recolor every face facing the viewer which share 
  213. vertices enclosed in the box. The object will be redrawn with its 
  214. new colors. The UNDO key does not work with this function.
  215.  
  216. WYSI<WYG (What you see is less than what you get): ALL faces 
  217. directed towards the viewer within the bounded area are recolored 
  218. with this operation, even ones which are partially or fully 
  219. obstructed by closer faces. Keep this in mind as it can lead to 
  220. unexpected results.
  221.  
  222. METHOD 2 COLOR REGISTER SELECT - You may also change all faces 
  223. colored with one register to another. Position the mouse over the 
  224. color register of the faces you wish to change, then hold the left 
  225. mouse button while pressing the control, alt and shift keys 
  226. simultaneously. Drag the box which appears so it covers the color 
  227. register you wish to copy the faces to and release the mouse 
  228. button. Any face which was colored with the first register will be 
  229. re-assigned and colored with the second register.
  230.  
  231. EXIT
  232. Press the "x" key to exit the editor and return to the menu.
  233.  
  234.  
  235. OPERATION DIFFERENCES BASED ON DISPLAY RESOLUTION
  236. Since CAD-3D objects may use up to 16 different colors, it stands 
  237. to reason that this program works best when run in a resolution 
  238. which can display 16 or more colors at once. However it will work 
  239. on systems which may display fewer colors, with some minor 
  240. differences.
  241.  
  242. - VDI modes with 16 or more colors: Each color register will be 
  243. displayed with its appropriate color. The mouse and text colors 
  244. will be set for maximum contrast against the background. The 
  245. background will be colored with the first color register on the 
  246. left, and the face outline color will be set to the register 
  247. specified in the 3D2 file for the wireframe color (usually the 
  248. color register on the far right).
  249.  
  250. - Line-a Mode in ST medium: This mode functions similarly to the 
  251. VDI mode with 16 colors. However the face outline color will 
  252. always be set to the rightmost color register. It might also be 
  253. necessary to change this color for better contrast of the mouse 
  254. and text. Line-a mode does not work in monochrome.
  255.  
  256. - VDI Mode in monochrome - The color registers are displayed as 
  257. grey scales increasing in brightness from left to right. The 
  258. object faces will also be displayed with greyscales. Double 
  259. clicking on a color register will still allow editing the color 
  260. settings, though the color will not be visible. Note that the 
  261. greyscales do not indicate intensity of the color, but the 
  262. position of the color register.
  263.  
  264. - VDI Mode in 4 color resolution - Only two actual colors will be 
  265. available to display the object. The program will attempt to match 
  266. these colors to the ones used by the object. If the object uses 
  267. more than two colors the other colors will be displayed with 
  268. greyscales as in the monochrome mode above. To reposition the two 
  269. actual colors to different color registers position the mouse over 
  270. one of the color registers which is currently displaying its 
  271. actual color. Press and hold the left mouse button while holding 
  272. down the Shift key. Drag the box which appears over the new color 
  273. register desired and release the button.
  274.  
  275.  
  276. RANDOM COLOR OBJECT
  277. -------------------
  278. Selecting this menu entry will bring up the object selector to 
  279. choose an object. Each face of the selected object will be 
  280. randomly assigned one of the color registers.
  281.      
  282.      (I STILL can't think of a use for this, but...)
  283.  
  284. CHANGE LINE COLORS
  285. ------------------
  286. Selecting this entry displays a dialog box allowing one to change 
  287. the CAD-3D wireframe and outline colors. Both of these values may 
  288. range from 0 to 15, 0 corresponding to the furthest left color 
  289. register and 15 to furthest right.
  290.  
  291. VIEW ALL
  292. --------
  293. This entry displays ALL of the objects in memory at once in their 
  294. original positions. Once the objects have been drawn the 
  295. camera position is displayed at the top of the screen and may be 
  296. repositioned using the same controls as in the face color editor. 
  297. The spacebar will redraw the scene. Pressing the ESC key will 
  298. abort the redraw. The "x" key will return to the menu bar.
  299.  
  300. This option is only available in 16 color display modes.
  301.  
  302. =================================================================
  303. =================================================================
  304.  
  305. This version addresses all of the complaints/suggestions I have 
  306. received regarding the initial version. I expect improvements to 
  307. continue.
  308.  
  309. Any and all comments, criticisms and suggestions are welcome. I 
  310. can be reached on GENIE as J.STANFORD2 or by snail mail at the 
  311. address given in the beginning of this document.
  312.  
  313. +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
  314.                     ADVERTISEMENTS!!!
  315. +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
  316.  
  317. CYBER SCULPT EXTRUDE AUTO-TRACER: This program will convert a PI1, 
  318. PI2, or PI3 picture file (created with DEGAS ELITE or similar) 
  319. into an extrude TMP file which may be used by Cyber Sculpt to 
  320. create 3D objects. Extrude templates are created as outlines of 
  321. the picture image. CYBRTRCE.LZH on GENIE, search under CYBER.
  322.  
  323. CAD-3D->CYBER SCULPT TEMPLATE CONVERTER: Translates CAD-3D 2.0 
  324. extrude templates to Cyber Sculpt format. CADTCVT.LZH on GENIE, 
  325. search under CYBER.
  326.  
  327. ALSO ON GENIE!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  328. -----------------------------------------------------
  329.  
  330. RENDER 512 v2.0 - Copyright (c) 1991 J C Stanford
  331.  
  332. RENDER 512 is similar to CAD-3D 2.0, it displays three-dimensional 
  333. objects on the screen as solid objects.
  334. However RENDER 512 adds a few additional features over CAD-3D:
  335.  
  336. o Rounded objects are drawn with smooth shading across their 
  337.   surface. No more polygon edges.
  338.  
  339. o Objects may be drawn with highlights.
  340.  
  341. o Objects may cast shadows on other objects.
  342.  
  343. o Objects may be displayed with texturing: wood grain, marble, or 
  344.   wrap any Spectrum image around the object.
  345.  
  346. o Rendered pictures are created and saved in SPECTRUM 512 format. 
  347.   NO MORE 16 COLOR LIMIT!! 
  348.  
  349. o Number of objects is limited only by memory.
  350.  
  351. o 4 different lightsource types available.
  352.  
  353. o Up to 21 lightsources in a scene.
  354.  
  355. o Every object may have its own individual color palette. It is 
  356.   possible to have 180 objects, each a different color!
  357.  
  358. CAD-3D v2.x or Cyber Sculpt are required to create objects.
  359.  
  360. RENDER 512 works on any standard Atari ST, color monitor and 1 meg 
  361. or more memory required. It does not work on the TT (yet!).
  362.  
  363.  
  364. RENDER 512 is available on GENIE in the ST software library, 
  365. REND512.LZH - file #21730. Search under CYBER or RENDER.
  366.  
  367. A bug in RENDER 512 V2.0 requires that Gribnif's Form-Do-It dialog 
  368. replacement program be installed to use all of RENDER 512's 
  369. features. Form-Do-It is also available on GENIE, FRMDO12D.LZH - 
  370. file #20463, and is a very useful program anyway.
  371.  
  372. RENDER 512 V2.0 is SHAREWARE. Version 2.05 is currently being 
  373. shipped (free) to all registered users. 2.05 fixes several minor 
  374. bugs, and adds or improves a number of features.
  375.  
  376.  
  377.  
  378.  
  379. ================================================================
  380. Spectrum 512, CAD-3D, and Cyber Sculpt are trademarks of Antic 
  381. Software.
  382. Chronos is a trademark of Lexicor Software.
  383. =====================================================================
  384. ====================================================================
  385. This program is supplied in the belief that it operates as specified,
  386. the author shall not be liable in any circumstance whatsoever for any 
  387. direct or indirect loss or damage to property incurred or suffered by
  388. the customer or any other person as a result of any fault or defect
  389. in the goods or services supplied by the author and in no 
  390. circumstances shall the author be liable against consequential
  391. damage or loss of profits (whether or not the possibility thereof was
  392. separately advised to it or reasonably foreseeable) arising from the
  393.  use or performance of such goods or services.
  394.  
  395.  
  396.  
  397.  
  398.