home *** CD-ROM | disk | FTP | other *** search
/ Freelog 34 / Freelog034.iso / Graphisme3D / Citygen / readme.txt < prev    next >
Encoding:
Text File  |  1999-01-08  |  8.4 KB  |  211 lines
  1.             ======================================
  2.  
  3.                 CITYGEN v1.5 FULL VERSION
  4.                           by Dale Cieslak
  5.                        dcieslak@yahoo.com
  6.  
  7.             ======================================
  8. Last update: 1/8/99 (Some changes to this file from Beta 3)
  9.  
  10. Additions since Beta 3:
  11. + Fixed all building bugs.
  12. + Found wintxt file!  
  13.   + integrated it.
  14.   + new brick textures.
  15. + Added splash screen, updated 'about box.'
  16. + Now remembers last export path!
  17. + Got rid of 'sun' sphere, tweaked colors a bit, etc.
  18.  
  19. Thank you for downloading CityGen v1.5!  And, kudos to you 
  20. for actually reading this file.  Not many people take the time
  21. to read 'README' files (yes, I'm quite guilty myself :) ).  Anyway,
  22. this file will tell you how to get started and give you some basic
  23. instructions.
  24.  
  25. I. INSTALLATION
  26.  
  27. 1. Assuming you've unzipped the file already (how else could you be
  28. reading this?), make sure you have these THREE files:
  29.  
  30. citygen.exe
  31. citygen.hlp
  32. citygen.cnt
  33. winsolid.inc
  34. wintxt.inc
  35. dskies.inc
  36. readme.txt
  37.  
  38. 2. Copy the citygen.exe wherever you want. 
  39.  
  40. 3. Copy the citygen.hlp and citygen.cnt in the same directory as 
  41. citygen.exe.
  42.  
  43. 4. Copy  the .inc files into your POV include directory (for Win 95 or NT, 
  44. this will probably be C:\Program Files\POV-Ray for Windows\Include).
  45.  
  46. That's it!  Click on the Citygen icon or run citygen.exe to begin!
  47.  
  48. * If it doesn't run, download DLLPAK.ZIP from my web site, and put both 
  49.   DLLs into your c:\windows\system directory.
  50.  
  51. II. BASIC USE
  52.  
  53. The simplest way to create a basic city using CityGen requires less
  54. than five mouse clicks:
  55.  
  56. 1. Click the 'Generate Streets' button (fourth from the left, has a 
  57. grid-like shape surrounded by yellow bursts).
  58.  
  59. 2. Click the 'Generate Buildings' button (fifth from left, has a
  60. skyline with yellow lines above it).
  61.  
  62. 3. Click the 'Export to POV' button (third from left, has a black
  63. and white checkerboard with a red arrow on it).
  64.  
  65. 4. Choose directory to export file to (your POV directory is 
  66. recommended), type the file name, and hit 'Save'.
  67.  
  68. 5. Wait while the file is exported.  When finished, you can go 
  69. to POV, load and render your city. 
  70.  
  71. That's all there is to it!
  72.  
  73. Repeatedly clicking the 'Generate Streets' button will give you 
  74. different street layouts.  You can click it until you get a layout
  75. that pleases you.  Once you've decided on the layout, click the
  76. 'Generate Buildings' button until the buildings suit you.
  77.  
  78. III. MORE OPTIONS
  79.  
  80. Yeah, that's all well and good, but you want more control over your
  81. city than that, don't you?  Fortunately, there IS more you can do
  82. to make more interesting cities.
  83.  
  84. IIIa. EDITING THE STREET LAYOUT
  85.  
  86. Clicking the 'Edit Streets' button (third from right, the only button
  87. with a yellow arrow on it) opens the Street Layout Dialog.  You should
  88. see a bird's-eye view of your city.  The green square indicates the
  89. center of the city, the light blue square shows the current selection,
  90. and the red square indicates the whole extent of the city (see diagram
  91. below):
  92.  
  93.  
  94.             |--------------------------------|
  95.             |                                |
  96.             |                                |<---- Whole City Size
  97.             |                                |
  98.             |                                |
  99.             |        |-------------|         |
  100.             |        |             |<-------------- City Center Size
  101.             |        |             |         |
  102.             |        |             |         |
  103.             |        |      []<-------------------- Current Selection
  104.             |        |             |         |
  105.             |        |             |         |
  106.             |        |             |         |
  107.             |        |-------------|         |
  108.             |                                |
  109.             |                                |
  110.             |                                |
  111.             |                                |
  112.             |                                |
  113.             |--------------------------------| 
  114.  
  115.  
  116. The city center will always be completely filled with buildings and/or
  117. streets.  The extent of the city determines the maximum length of the
  118. outlying streets and buildings.  In other words, the cities tend to 
  119. be cross-shaped.  You can resize the whole city and resize and move 
  120. the city center.  Experiment to get different city shapes and sizes.
  121. You can hit the 'Generate Streets' button on the dialog or the toolbar
  122. to see the effect of your changes.
  123.  
  124. You may also edit grid squares by hand if you wish.  Simply click on the
  125. building/street/empty cell you wish to edit.  The information shows
  126. the current attributes for that cell.  To change from a street to a building 
  127. or vice versa, simply click the appropriate button.  To reset a building's 
  128. height, change the height and click 'Set Height.' 
  129.  
  130. You may close the dialog when finished or leave it open, though it is 
  131. kind of big.  I suggest closing it unless you have a huge monitor or 
  132. very high resolution.
  133.  
  134. IIIb. EDITING THE CITY PROFILE
  135.  
  136. If you'd like your city to have more skyscrapers, or barely any tall 
  137. buildings at all, you need to adjust the City Profiles.  Click on the
  138. 'Edit Profiles' button (fourth from the right) to open this dialog.  
  139. Basically, the sliders represent the profile of your city from two
  140. sides.  Randomness will make your buildings not adhere exactly to 
  141. these, but generally, they will.  Moving the sliders upward will 
  142. tend to make taller buildings in that area, and conversely, moving
  143. a slider down will make shorter buildings in an area.  Experiment
  144. to find city shapes you like.  
  145.  
  146. NOTE: if you move the city center in the Street Layout dialog, it 
  147. does NOT affect the Profiles at all.  You have to adjust the profiles
  148. to fit your new city center, if that's where you want your tallest
  149. buildings to be.  Rotating the view to SE will make this easiest to
  150. do.  Fortunately, I have added buttons (they look like '<<' and '>>')
  151. to let you shift the profiles left and right.
  152.  
  153. To reset the profiles to their default values, hit the appropriate
  154. buttons.
  155.  
  156. IV. EXPORTING A CITY
  157.  
  158. To export the city to POV, simply click the Export To POV button or
  159. select it under the File menu.  You can select the time of day using
  160. the slider provided. Type a filename and click the 'Save' button.  Note 
  161. that this isn't the same as Saving a city, I am just having trouble 
  162. making that button say 'Export' right now. 
  163.  
  164. V. OTHER IMPORTANT INFO
  165.  
  166. 1. Saving a city is different from Exporting a city!!!  Imagine it 
  167. this way:  A saved city is like a saved document.  You can re-load
  168. it and edit it, then save it again, etc.  An exported city is like
  169. a printout.  You can't reload it or edit it in CityGen.  
  170.  
  171. 1a. Saving a city also saves the position of the center, city size,
  172. and profiles.  So, if you like a particular layout & profiles, save
  173. the city, so when you want the same type, just re-load it and hit
  174. the generate buttons to get similarly-styled cities.
  175.  
  176. 2. If you export the same city multiple times, you'll get different-
  177. looking cities each time!  The particular buildings aren't chosen
  178. until export time.  So, if you like a particular city in CityGen, 
  179. but don't like the way it renders, re-export it until you get one
  180. that creates pleasing renders.
  181.  
  182. 3. You can view the city from different angles by rotating the view.
  183. But you'd probably figure that out on your own quite quickly.
  184.  
  185. 4. All of the commands mentioned in here can also be accomplished
  186. through the menus.  Some people just aren't toolbar types.  
  187.  
  188. 5. Cities are now centered around the origin, whereas before, they
  189. were positioned so one corner was at (0,0, 0).  If you were to #declare
  190. the city as one big union, you could place it at the origin and it would
  191. look exactly the same, provided you didn't translate, scale, rotate, etc.
  192. (Hint: if you WANT to do any of these things, #declare-ing it as one big
  193. object would be an easy way to accomplish this.)
  194.  
  195. VI. CONCLUSION
  196.  
  197. I hope you like this beta, and will look forward to the actual 
  198. release of CityGen.  Please, please, PLEASE e-mail me with any
  199. comments, suggestions, or bugs you find.  My e-mail address is
  200.  
  201. dcieslak@yahoo.com
  202.  
  203. and my web page is
  204.  
  205. http://members.tripod.com/~DCieslak
  206.  
  207. Please visit to keep updated.  I am also starting a mailing list, so
  208. if you want to be included, let me know.  And hey, if this thing ever
  209. takes off, maybe I'll make a User Gallery.  :)  
  210.  
  211.