home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK2 / MULTI_04 / GIFDXF.ZIP / GIFDXF.DOC next >
Text File  |  1991-11-17  |  8KB  |  244 lines
  1.                                   Gifdxf
  2.  
  3.                    Copyright (C) 1991, Kamyan Software.
  4.                              1228 Robin Drive 
  5.                           Carol Stream Il. 60188
  6.                             All rights reserved
  7.  
  8.  
  9. Index for Gifdxf
  10.  
  11. 1.0 Introduction
  12.  
  13. 2.0 Disclaimer
  14.  
  15. 3.0 Registration Information
  16.  
  17. 4.0 Distribution Information
  18.  
  19. 5.0 File list
  20.  
  21. 6.0 Revision History
  22.  
  23. 7.0 Users Reference
  24.  
  25. 8.0 Credits
  26.  
  27.  
  28.  
  29. 1.0 Introduction
  30.  
  31. Gifdxf is a dxf file generator.  The program will take as input a gif file.
  32. The image will be sampled at the rate specified generating a 3D representation
  33. of the image.  The dxf file generated is geared for input into Autodesk 3D
  34. Studio.  The dxf file will contain only one entity consisting of polyfaces.
  35. Designed to be used as an aid to generating landscapes for 3D Studio using
  36. fractal gif files.  However, we're sure other uses will be found.
  37.  
  38.  
  39.  
  40. 2.0 Disclaimer
  41.  
  42. Kamyan Software makes no representations or warranties with respect to
  43. this software or documentation, and specifically disclaims any express
  44. or implied warranties of merchantablilty or fitness for any purpose.
  45. Further Kamyan Software reserves the right to make changes to any and all 
  46. parts of the software, at any time, without obligations to notify any 
  47. person or organizations.  Kamyan Software will not be liable for any special,
  48. incidental, consequential, indirect or similar damages due to loss of data or
  49. any other reason, even if Kamyan Software or an agent of Kamyan Software
  50. has been advised of the possibility of such damages.  In no event shall
  51. Kamyan Software's liability for any damages ever exceed the price paid
  52. for the license to use the software, regardless of the form of the claim.
  53.  
  54.  
  55.  
  56. 3.0 Registration Information
  57.  
  58. Gifdxf is a shareware product which has a five day free
  59. evaluation period after which a payment of $15.00 is required.
  60.  
  61. Your payment will make you a registered user of Gifdxf.  As
  62. a registered user you will have the legal right to use Gifdxf 
  63. on a single computer.  
  64.  
  65. Upgrades are free to registered users.  Generally Kamyan software will
  66. not be distributing upgrade disks.  However, if you are a registered user
  67. and would like an upgrade disk sent to you, indicate this along with a check
  68. for $5.00 to handle mailing and disks costs:
  69.  
  70. Calculate your payment as follows:
  71.     $15.00 multiplied by the number of computers Gifdxf will be
  72.     be installed on.
  73.  
  74. For Network installations calculate your payment as follows:
  75.     $15.00 multiplied by the number of users that may use Gifdxf.
  76.  
  77. Send payments to:
  78.  
  79.     Kamyan Software
  80.     1228 Robin Drive 
  81.     Carol Stream Il. 60188
  82.  
  83. When you register indicate 5.25" or 3.5" disks and the latest version of 
  84. Gifdxf will be sent to you.  In an attempt to keep updates frequent
  85. and the cost as low as possible hardcopy documentation will not be 
  86. distributed.
  87.  
  88. If you like, use the registration form in the file "gifdxf.reg".
  89.  
  90. To arrange for a site license contact Kamyan software directly at
  91. address above or contact Ken Carlino online at (CIS) 73447,1114.
  92.  
  93.  
  94.  
  95. 4.0 Distribution Information
  96.  
  97. Kamyan Software allows Gifdxf to be freely copied and distributed in its
  98. unmodified form via electronic means or other shareware distribution 
  99. methods.
  100.  
  101. You are specifically prohibited from charging or requesting donations
  102. for any copies made or distributed with the exception of organizations 
  103. which distribute shareware software for a small fee ( less then $7.50 
  104. per disk) to cover distribution costs.
  105.  
  106. Gifdxf can not be distributed with any retail product without the
  107. express written consent of Kamyan Software.
  108.  
  109.  
  110. 5.0 Files list
  111.     
  112. The following files make up the Gifdxf software package:
  113.  
  114.     gifdxf.exe    - the windows application
  115.     gifdxf.doc    - this file
  116.     gifdxf.reg  - registration form
  117.  
  118. 6.0 Revision information
  119.  
  120.     Version 1.0 - November 17, 1991
  121.         First release
  122.  
  123.  
  124.  
  125. 7.0 User Reference
  126.  
  127. Gifdxf creates a grid of vertices on the x/y plane.  The /x and /y 
  128. parameters determine the number of vertices along each axis.  The location
  129. of each vertex along the z axis is determined by sampling the gif image,
  130. using either the palette index or the luminance value.  The result is a 
  131. polyface entity written to a dxf file which can then be loaded into 3D
  132. Studio.    
  133.  
  134. 7.1 Command line usage
  135.  
  136.     gifdxf [/Xnnnn] [/Ynnnn] [/P [LI]] giffile dxffile
  137.  
  138.         /Xnnnn - number of x vertices ( default 20)
  139.         /Ynnnn - number of y vertices ( default 20)
  140.         /Snnn  - scale % for Z axis depth ( default 30)
  141.         /P     - Palette interpretation for Z axis depth
  142.             L - luminance (default)
  143.             I - Index
  144.  
  145. 7.2 Description of command line parameters
  146. 7.2.1 /X - number of x vertices
  147.  
  148. This parameter will be the number of x axis vertices generated.  This value
  149. times the /y parameter will determine the total number of vertices in the 
  150. entity.  
  151.  
  152. 7.2.2 /Y - number of y vertices
  153.  
  154. This parameter will be the number of y axis vertices generated.  This value
  155. times the /x parameter will determine the total number of vertices in the 
  156. entity.  
  157.  
  158. 7.2.3 /S - Scale percent along the z axis
  159.  
  160. This is what gives the object depth.  The larger the percentage the more 
  161. variance in depth.  This parameter will determine how far along the z axis 
  162. a vertex will be ploted.  At 100% the maximum z value will be 256. So at 
  163. the default of 30% the maximum z value will be 76.8.
  164.  
  165.  
  166.  
  167. 7.2.4 /P Palette interpretation
  168.  
  169. This determines how the gif image will be sampled to determine a vertex
  170. location along the z axis.
  171.  
  172. The /PL setting for luminance means that every pixel that is sampled 
  173. in the gif image will be given a value based on the value of its red,
  174. green and blue components.  This is like saying the image will be looked
  175. at as if it was a gray scale image.
  176.  
  177. The /PI setting for palette index means that every pixel that is sampled
  178. in the gif image will be given a value base on its palette index. Note 
  179. this may have nothing to do with the actual color you see when viewing 
  180. the gif image.
  181.  
  182. 7.2.5 The gif file name
  183.  
  184. This is the name and optionally the path and extension of the gif file.
  185. The gif file must be a non-interlaced file.  Most gif files are 
  186. non-interlaced so this should not cause a problem.  If you have a gif image
  187. which is interlaced have another program convert it to a non-interlaced
  188. gif image before using it in this utility.
  189.  
  190. 7.2.6 The dxf file name
  191.  
  192. This is the name and optionally the path and extension of the dxf file name.
  193. The dxf data written will consist only of one entity consisting of polyfaces.
  194.  
  195. 7.3 Examples of use
  196.  
  197. gifdxf giftest dxftest
  198.  
  199. This will look for the gif file giftest.gif in the current directory.  A
  200. grid of 20 x vertices by 20 y vertices will be generated.  The maximum
  201. z value for any vertex will be 76 and the gif image will be sampled based
  202. its the luminance of its pixels.  The dxf data will be written to a file
  203. dxftest.dxf in the current directory.
  204.  
  205.  
  206. gifdxf /X45 /Y80 /S200 /PI giftest dxftest
  207.  
  208. This will look for the gif file giftest.gif in the current directory.  A
  209. grid of 45 x vertices by 80 y vertices will be generated.  The maximum
  210. z value for any vertex will be 512 and the gif image will be sampled based
  211. its the palette index value of its pixels.  The dxf data will be written to 
  212. a file dxftest.dxf in the current directory.
  213.  
  214.  
  215.  
  216. 7.4 Loading into 3D Studio
  217.  
  218. Load as a dxf file into the 3D editor.  You will be asked whether to derive
  219. by layer, color or entity, select entity.  Once loaded the face normals will
  220. be facing away from you, so you most likly will want to flip the face normals.
  221. Use the surface/normals/object flip command to do this.  You may also want
  222. to apply smoothing to the object.  Use the surface/smoothing/object/assign
  223. command to do this.  
  224.  
  225. 7.5 Using the DXF file in other porgrams
  226.  
  227. The dxf files generated by this program have only been tested with 
  228. 3D Studio.  We welcome any comments or information about the suitability
  229. of the dxf files in other programs.
  230.  
  231.  
  232. 8.0. Credits
  233.  
  234. 3D Studio is a registered trademarks (tm) of Autodesk, Inc.
  235.  
  236. GIF and 'Graphics Interchange Format' are trademarks (tm) of
  237. Compuserve, Incorporated, an H&R Block Company.
  238.  
  239. The gif decoder was based on code written by Steven A. Bennett 
  240. and Steve Wilhite.
  241.  
  242.  
  243. End of Document
  244.