assaultcube-/docs/mapediting1.xml

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<?xml-stylesheet type="text/xsl" href="transformations/cubedoc2xhtml.xslt"?>

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" lang="en" xml:lang="en">
  <head><title>Map editing: Introduction</title></head>
  <body>
    <h1>Map editing: Interface &amp; controls </h1>
    <p>
      Learning and understanding the interface and controls are the first step to map editing...
    </p>
    <h2>The interface</h2>
    <table>
      <tr>
        <td><img src="pics/editmode-grid.jpg" alt="The grid"/></td>
          <td>
            <b>The "cube grid"</b><br />
            <p>
              This will be shown as a white grid of squares drawn where ever you point. 
              <br />Each of the small squares is a single cube. The cubes in AssaultCube are known as "geometery".
              The bigger blue squares, indicate a selection of 8x8 cubes to make map editing easier.
            </p>                        
          </td>
        </tr>
        <tr>
          <td><img src="pics/editmode-heightfield.jpg" alt="Shows a cube that is a heightfield"/></td>
          <td>
            <b>Heightfield cubes</b><br />
            <p>
              These are the light green cubes in the grid.<br /> These cubes indicate heightfields, which will be explained later <a herf="#LINK">here</a>.
            </p>                        
          </td>
        </tr>
        <tr>
          <td><img src="pics/editmode-entity.jpg" alt="Indicates an entity"/></td>
          <td>
            <b>Entity sparkles</b><br />
            <p>
              These are shown as blue sparkly things. They are known as "entities", which will be explained later <a herf="#LINK">here</a>.
            </p>                        
          </td>
        </tr>
        <tr>
          <td><img src="pics/editmode-selector.jpg" alt="Selects cubes"/></td>
          <td>
            <b>Cube selector</b><br />
            <p>
              This appears as a small white box with a red dot in the corner. It will appear in the middle of the screen and you can use it to select
              geometery, a bit like a crosshair. <br />The red dot indicates which corner of a cube you are manipulating, if you are using heightfields, 
              or where your entity will be placed if you are creating an entity, but you don't need to worry about knowing how to use that red dot just yet.
            </p>                        
          </td>
        </tr>
        <tr>
          <td><img src="pics/editmode-nearestent.jpg" alt="Shows nearest entity"/></td>
          <td>
            <b>"Nearest entity" text</b><br />
            <p>
              This is the white writing along the bottom. It will tell you the locaton of the closest entity and its properties, but you don't need 
              to worry about how to use that just yet.
            </p>                        
          </td>
        </tr>
      </table>   
    <p>
      To get a feel for editmode, press E and float around. Try clicking and dragging the small white box at your crosshair over 
      some cubes (you will see a red box over what you are selecting). This is how you select geometery.
    </p>

    <h2 id="controls">Map editing controls</h2>

    <p>
      Below are the controls that get used in map-editing, you will use most of these controls when creating a map, so it's good to learn them.
    </p>
    <h3>Changing geometery</h3>
    <table>
	      <tr>
        <td width="150">
          <b><u>Control</u></b>
        </td>
        <td width="450">
          <b><u>Function</u></b>
        </td>
      </tr>
      <tr>
        <td>
          [
        </td>
        <td>
          Moves cubes in the floor downwards.
        </td>
      </tr>
      <tr>
        <td>
          ]
        </td>
        <td>
          Moves cubes in the floor upwards.
        </td>
      </tr>
      <tr>
        <td>
          O
        </td>
        <td>
          Moves cubes in the ceiling downwards.
        </td>
      </tr>
      <tr>
        <td>
          P
        </td>
        <td>
          Moves cubes in the ceiling upwards.
        </td>
      </tr>
      <tr>
        <td>
          F
        </td>
        <td>
          Makes selected cubes a solid.
        </td>
      </tr>
      <tr>
        <td>
          G
        </td>
        <td>
          Makes selected cubes a space/non-heightfield.
        </td>
      </tr>
      <tr>
        <td>
          K
        </td>
        <td>
          Makes selected cubes a corner.
        </td>
      </tr>
      <tr>
        <td>
          C
        </td>
        <td>
          Copy selected cubes.
        </td>
      </tr>
      <tr>
        <td>
          V
        </td>
        <td>
          Pastes copied cubes. <br />Note: It pastes from the upper corner of the red dot.
        </td>
      </tr>
      <tr>
        <td>
          U
        </td>
        <td>
          Undoes the last action (only applies to geometery).
        </td>
      </tr>
      <tr>
        <td>
          ,
        </td>
        <td>
          Equalize the floor.
        </td>
      </tr>
      <tr>
        <td>
          .
        </td>
        <td>
          Equalize the ceiling.
        </td>
      </tr>

      <tr>
        <td>
          H
        </td>
        <td>
          Makes the floor a heightfield.
        </td>
      </tr>
      <tr>
        <td>
          I
        </td>
        <td>
          Makes the ceiling a heightfield.
        </td>
      </tr>
      <tr>
        <td>
          9
        </td>
        <td>
          Manipulates the corner of a cube where the red dot is positioned upwards. 
          Works only if the cube is a heightfield.
        </td>
      </tr>
      <tr>
        <td>
          8
        </td>
        <td>
          Manipulates the corner of a cube where the red dot is positioned downwards. 
          Works only if the cube is a heightfield.
        </td>
      </tr>
    </table>
    
    <h3>Changing textures</h3>
    <table>
      <tr>
        <td width="150">
          <b><u>Control</u></b>
        </td>
        <td width="350">
          <u><b>Function</b></u>
        </td>
      </tr>
      <tr>
        <td>
          Home
        </td>
        <td>
          Browses forward through wall textures.
        </td>
      </tr>
      <tr>
        <td>
          End
        </td>
        <td>
          Browses backward through wall textures.
        </td>
      </tr>
      <tr>
        <td>
          7 (on the keypad)
        </td>
        <td>
          Browses forward through upper-wall textures.
        </td>
      </tr>
      <tr>
        <td>
          4 (on the keypad)
        </td>
        <td>
          Browses backward through upper-wall textures.
        </td>
      </tr>
      <tr>
        <td>
          Insert
        </td>
        <td>
          Browses forward through floor textures.
        </td>
      </tr>
      <tr>
        <td>
          Delete
        </td>
        <td>
          Browses backward through floor textures.
        </td>
      </tr>
      <tr>
        <td>
          PageUp
        </td>
        <td>
          Browses forward through ceiling textures.
        </td>
      </tr>
      <tr>
        <td>
          PageDown
        </td>
        <td>
          Browses backward through ceiling textures.
        </td>
      </tr>
      </table>

    <h3>Mouse controls</h3>
    <table>
      <tr>
        <td width="150">
          <b><u>Control</u></b>
        </td>
        <td width="400">
          <u><b>Function</b></u>
        </td>
      </tr> 
      <tr>
        <td>
          Left-click
        </td>
        <td>
          Allows you to select cubes.
        </td>
      </tr>
      <tr>
        <td>
          Right-click
        </td>
        <td>
          Show the editing menu.
        </td>
      </tr>
      <tr>
        <td>
          Scrolling
        </td>
        <td>
          Scrolling will move cubes up/down, depending on the direction you look.
        </td>
      </tr>
      <tr>
        <td>
          Hold <b>Q</b> and scroll
        </td>
        <td>
          This will manipulate the corner of a cube where the red dot is positioned up/down. 
          Works only if the cube is a heightfield.
        </td>
      </tr>
      <tr>
        <td>
          Hold <b>Z</b> and scroll
        </td>
        <td>
          Scrolls forward/backwards through textures on the floor/ceiling, depending on the direction you look.
        </td>
      </tr>
      <tr>
        <td>
          Hold <b>X</b> and scroll
        </td>
        <td>
          Scrolls forward/backwards through textures on the wall/upper-wall, depending on the direction you look.
        </td>
      </tr>
    </table>

    <h3>Misc</h3>
    <table>
      <tr>
        <td width="150">
          <b><u>Control</u></b>
        </td>
        <td width="350">
          <b><u>Function</u></b>
        </td>
      </tr>
      <tr>
        <td>
          E
        </td>
        <td>
          Toggle edit mode.
        </td>
      </tr>
      <tr>
        <td>
          Backspace
        </td>
        <td>
          Delete entity.
        </td>
      </tr>
      <tr>
        <td>
          L
        </td>
        <td>
          Shows the lighting menu.
       </td>
      </tr>
      <tr>
        <td>
          F5
        </td>
        <td>
          Toggle ocullsion on/off.
        </td>
      </tr>
      <tr>
        <td>
          F6
        </td>
        <td>
          Toggle showmip on/off.
        </td>
      </tr>
    </table>
    <br />
    <h4>
      The next step? Go to <a href="mapediting2.xml">Map editing: Beginners</a>.
    </h4>

  </body>
</html>