home *** CD-ROM | disk | FTP | other *** search
/ Phenomenon / Phenomenon.iso / quake / utils / map / mm02 / readme.txt < prev   
Encoding:
Text File  |  1996-08-14  |  6.7 KB  |  129 lines
  1.               **************************************************
  2.               *       MakeMAP v0.20 - Quake Level Editor       *
  3.               **************************************************
  4.               *              (c) by Lars Bensmann              *
  5.               **************************************************
  6.               * http://localhost.ruhr.de/~b-man/makebrush.html *
  7.               **************************************************
  8.  
  9. Note:
  10.   This README is probably very confusing, not detailed enough and whatever.
  11.   I just wrote this in a hurry and added some stuff for each new version.
  12.   So some of the information may already be outdated, but I don't feel like
  13.   writing a complete documentation yet, because there are so many things
  14.   that will probably change in future versions.
  15.  
  16. This is the current version of MakeMAP. It's still in heavy development,
  17. but if you're interested you can try it out.
  18.  
  19. It is a GUI I wrote around my util Makebrush. It handles all the vertex
  20. stuff and leaves the actual converting to the plane format of the MAP
  21. files to the code from Makebrush.
  22.  
  23. You can start it by typing:
  24.  
  25.   mm [option]
  26.  
  27.         -6  select 640x480
  28.         -8  select 800x600
  29.  
  30. MakeMAP will start in a 1024x768 resolution as default (unless you use one
  31. of the above options of course).
  32.  
  33. Theoretically it is possible to create a MAP file with it, although you
  34. have to add all entities by hand. Another pretty bad thing is that it 
  35. doesn't keep track of all the textures yet (just one per brush), so some 
  36. more advanced levels will look pretty weird after importing and then
  37. saving them with MakeMAP.
  38. As I said, the whole thing is far from ready. It took me less than a week 
  39. to write this (not counting the functions I added from Makebrush), so don't
  40. expect anything brilliant.
  41.  
  42. The most important thing is the F1 key. This will describe every key
  43. that has a function in MakeMap.
  44.  
  45. MakeMap has a XY (left top window), XZ (right top window), 
  46. YZ (left bottom window) and hopefully soon a 3d view (right bottom window).
  47.  
  48. Every window has it's own mouse cursor that will show the currently
  49. selected position by the mouse. The curser is moved with the mouse or
  50. for more precise positioning with the arrow keys (use Ctrl+arrow or 
  51. Alt+Arrow for different speeds). The active cursor is colored grey (and
  52. is pretty hard to find on the screen :-(, but I will fix this)
  53.  
  54. To change the active mouse cursor you can just move into the window you
  55. want or press Tab (or Shift Tab) to cycle through the cursors without
  56. changing the positions of the cursors.
  57.  
  58. MakeMap always hilights the vertex that is closest to the 3D-mouse cursor.
  59. So if you are wondering why the cursor is on top of a vertex, but a differnet
  60. one is highlighted, look in the other windows as well and change the cursor
  61. position there. The one exception is the 3d-view. As you will notice, you
  62. don't move the 3d-cursor anymore, just the cross representing the mouse,
  63. the vertex that is closest to the mouse cursor is highlighted.
  64.  
  65. You can add vertexes by hitting the INSERT key. To select a 
  66. highlighted vertex just use SPACE (or the left mouse button). To select 
  67. a whole brush, highlight a vertex and hit ENTER or the middle mouse button
  68. (several times to cycle through all the brushes your highlighted point is 
  69. part of).
  70. To create a new brush, select all the vertexes and hit 'b'. To add a
  71. vertex to a brush, select a brush (with ENTER, just selecting all vertexes
  72. doesn't do the job yet), highlight the vertex to be added and type 'a'.
  73. Removing a vertex from a brush is done the exact same way, but type
  74. 'r' instead. (Note: Removing a vertex doesn't delete the vertex itself, it
  75. just isn't part of the brush anymore. The same is true for deleting. Deleting
  76. a brush, doesn't remove it's vertexes. And you cannot delete vertexes that
  77. are still part of a brush. If you want to remove a brush including all the
  78. vertexes, just hit DEL twice. Once to remove the brush. After this all of
  79. the vertexes will still be selected, and so hit DEL  again to delete the 
  80. vertexes.) If you want to unselect all vertexes at once just hit ESC.
  81. The right mouse button has the combined function of removing a vertex from
  82. a brush (if the highlighted vertex is part of the selected brush) and
  83. adding a vertex to a brush (well, if the vertex is not part of the brush).
  84.  
  85. I also added the possibility to limit the displayed vertexes and brushes.
  86. ust hit 'l' in the view and enter the distance around the cursor position that
  87. should be displayed. A negative number will display the vertexes in front
  88. and behind the current cursor position and a positiv number will just
  89. draw those behind the cursor.
  90. The display doesn't update in realtime. So if you move the cursor, just
  91. use 'd' to refresh the display for the current cursor position.
  92.  
  93. And no, you cannot move vertexes around yet, just remove the vertex and
  94. add a new one at the position you want.
  95.  
  96. Once you moved the active cursor into the 3d-view, you can feel yourself
  97. at home and move just like in Quake. Use the arrow keys to move around,
  98. Alt+left or right to strafe and Page Up/Down to look down/up. The keys
  99. Home and End will higher or lower you point of view and Backspace will
  100. do a 180 degree turn. Unfortunately this is slow as hell, but I will try
  101. to fix this in a future version. Oh, BTW, the yellow rectangle that can
  102. be seen in the 2d-windows is your current position in the 3d-view. You can
  103. also jump to a certain point in space by hitting 'j'. This will put the
  104. viewpoint at the coordinates of the 3d-cursor.
  105.  
  106. The 3d-view won't allow you to add or move vertexes. Use the 2d-windows 
  107. instead. If someone comes up with a method to position anything precisely
  108. in a 3d-view window, don't hesitate to tell me how.
  109.  
  110. I know this version is still an alpha, but someone on
  111. rec.games.computer.quake.editing complained about noone releasing anything,
  112. so here is my current version.
  113.  
  114. Currently I'm not interested in bug reports. Just note one thing: If you
  115. shouldn't be able to move the cursor anymore, then type 'mode co80' blindly
  116. and you will probably be back at the nice DOS-Prompt. This is most likely
  117. to happen while loading and saving, because this is handled by the code I
  118. added from Makebrush and it will exit if there is a wrong brush
  119. (not enough points, all points on one plane etc.) You can read the file
  120. ERROR that is generated by MakeMAP and it will tell you what happened.
  121. So, save often and to different filenames or all your work will be lost if
  122. an error occures while saving to your original filename.
  123.  
  124. What I would be interested in is you opinion on the highlighting and selecting
  125. method used. Is it understandable how to move the cursor in the three
  126. dimensions?
  127.  
  128. Comments and suggestions to: Lars@b-man.ruhr.de
  129.