Changes between Version 8 and Version 9 of Atlas_User%27s_Guide


Ignore:
Timestamp:
2010-04-04 17:31:08 (3 years ago)
Author:
feneur
Comment:

how to start on Linux

Legend:

Unmodified
Added
Removed
Modified
  • Atlas_User%27s_Guide

    v8 v9  
    22 
    33= Atlas tutorial = 
    4  
    5  
    6 == Starting Atlas == 
    7  
     4== Starting Atlas (scenario editor) == 
    85First, assuming that you're on Windows, go to the \binaries\system\ folder in your 0A.D. folder and check for the file called "Atlas.bat". Double click that and you'll see a command window, don't worry though, you don't have to write commands to edit 0 A.D. maps (The 3D world in which the game takes place is known as a map, and both words will be used in this tutorial), it's just loading the program in the correct way. In some seconds you'll see the actual Scenario Editor itself. 
    96 
     7If you're on Linux you can run Atlas by running: 
     8 
     9{{{ 
     10'/path/to/0ad/system/pyrogenesis_dbg' -editor 
     11}}} 
     12in a terminal window (replace "/path/to/0ad/" with the actual path to the folder where 0 A.D. is installed). The rest should be the same for all operating systems. 
     13 
    1014[[Image(start.jpg)]] 
    1115 
     
    1317 
    1418It may seem overwhelming when you first take a look at the different tabs, but don't worry, most things are fairly straight-forward and you'll learn a lot just by playing. In this document you'll however find descriptions for how things are done to guide you on your way into Atlas and map making. 
    15  
    1619 
    1720== The Main Tools == 
     
    2326 
    2427From the left to right they are: 
     28 
    2529=== The Default tool === 
    26  
    2730[[Image(default_tool.png)]] 
    2831 
     
    3235 
    3336==== Navigating in the 3D world ==== 
    34  
    3537Using the arrow keys on your keyboard you can move forwards/backwards/sideways, with the use of the Shift and Ctrl keys you can affect the speed of that movement: 
    3638 
    37  * Shift+arrow keys - move faster  
    38  * Ctrl+arrow keys - move slower  
     39 * Shift+arrow keys - move faster 
     40 * Ctrl+arrow keys - move slower 
    3941 * Ctrl+Shift+arrow keys - move much slower 
    40  
    4142 
    4243The scroll-wheel on your mouse is used to zoom inwards/outwards and the same keys affect the zoom as the moving i.e.: 
     
    4950 
    5051And finally there are two ways to rotate the map: 
     52 
    5153 1. Right mouse button + middle mouse button click-and-drag (i.e. pressing the right mouse button while clicking-and-dragging with the middle mouse button) 
    52  2. Ctrl + middle mouse button click-and-drag 
     54 1. Ctrl + middle mouse button click-and-drag 
    5355 
    5456Both do the same thing i.e. rotate the map. The map is rotated around the point where you click, but in case you find that confusing just rotate until the map is rotated in the way you were aiming for. 
    5557 
    5658=== The Move/Rotate tool === 
    57  
    5859[[Image(tools_move_rotate.png)]] 
    5960 
    60  ''The Move/Rotate Tool'' 
     61  ''The Move/Rotate Tool'' 
    6162 
    6263The Move/Rotate Tool is what you use when you want to either move or rotate objects (everything in the 3D world/map except the terrain are objects). To move/rotate, first select the object you want to manipulate by left-clicking on it. After selecting the object you can use the left mouse button to move the object and the right mouse button to rotate it. If you right click after selecting an object it rotates to face in the direction you clicked and if you press and hold the right mouse button while moving the mouse around the object rotates with it. 
     
    6970 
    7071=== The Alter terrain tool === 
    71  
    7272[[Image(tools_alter_terrain.png)]] 
    7373 
     
    7777 
    7878==== The Area of Influence ==== 
    79  
    8079[[Image(tools_alter_terrain_area_of_influence.png)]] 
    8180 
     
    9190 
    9291=== The Flatten elevation tool === 
    93  
    9492[[Image(tools_flatten.png)]] 
    9593 
     
    104102The result in the image to the right above has been obtained by repeatedly clicking with the flatten elevation tool and as you can see the terrain is much smoother now. What level the terrain gets averaged at is depending on where the center of the grid is (see The Area of Influence above for an image of the grid) and thus you can get different results if you put the center of the tool on a higher area versus a lower area. 
    105103 
    106  
    107  
    108104=== The Paint Terrain Texture tool === 
    109  
    110105[[Image(tools_paint_terrain.png)]] 
    111106 
     
    115110 
    116111== The Tabs == 
    117  
    118112[[Image(tabs_map.png)]] 
    119113 
     
    121115 
    122116=== Map Tab === 
    123  
    124117The buttons on the Map Tab are few, but they're powerful. Especially the first two, as they erase everything you've got on the map and replace that with, in the first case an empty map (no difference in height, only the same green texture all over it, no objects), and in the second case a complete random map (different heights, different textures, objects). 
    125118 
     
    131124 
    132125The buttons are fairly self-explanatory, but for completeness sake here is a list of the buttons and what they do: 
     126 
    133127 * The Play button – starts the simulation 
    134128 * The Fast button – makes the simulation run fast 
     
    137131 * The Reset button – resets the units to the position they were in before the simulation started 
    138132 
    139  
    140133=== Terrain Tab === 
    141  
    142134[[Image(tabs_terrain.png)]] 
    143135 
     
    147139 
    148140==== The terrains ==== 
    149  
    150141[[Image(tabs_terrain_terrains.png)]] 
    151142 
     
    155146 
    156147==== Texture priority ==== 
    157  
    158148When painting terrain you can get different results by either clicking and dragging with the left or the right mouse button. The left mouse button allows you to paint in a more “dominant” style, while the right allows you to paint in a more submissive style. That might be hard to grasp when explained with words, but the picture below will allow you to understand it more easily, and you'll quickly get a grasp of it when playing around in Atlas yourself. 
    159149 
     
    169159 
    170160==== Brush options: Shape ==== 
    171  
    172161To give the user more flexibility in using these tools there is a choice between either a circle or square shaped brush. Both are displayed as square grids, but while the circle brush gives a smoother outline the square brush is sharper. Even at large sizes the circle brush gives a somewhat squarey look due to the fact that the terrain is based on square tiles and thus every tool that is applied has to affect these tiles and nothing else. 
    173162 
    174  
    175163==== Brush options: Size ==== 
    176  
    177164The size is pretty straight forward, increase the number and the size of the displayed grid, and the resulting effect of the brush, increases, and vice versa. Here the Paint terrain tool is a bit different though, as the area below the grid doesn't exactly equal the area affected, the end result is dependent on other things too, as the shape and texture priority settings also affect the final size of what gets painted. You can change the sixe both by writing directly into the text field or by clicking the up/down arrows on the right side of the text field. 
    178165 
    179166==== Brush options: Strength ==== 
    180  
    181167The strength option is a bit different in that it doesn't affect the Paint terrain tool at all. 
    182168 
     
    184170 
    185171=== Object Tab === 
    186  
    187172[[Image(tabs_object.png)]] 
    188173 
     
    192177 
    193178==== Variations ==== 
    194  
    195179Some objects have variations you can choose from. You can do that after placing the object by selecting it using the Move/Rotate tool and then choosing between the different options in the dropdown button. 
    196180 
    197181==== Entities/Actors ==== 
    198  
    199182Above the object list there is a dropdown button which allows you to choose between entities and actors. Actors are a subset of Entities. An actor is a simple visual object in the game and have no effect at all in the play of the game on the map. Entities, on the other hand, are objects in the game that possess parameters and statistics that do play a role in the game. The actor when part of an entity is the visual part of it, it defines the way the entity looks. 
    200183 
    201184=== Environment Tab === 
    202  
    203185The different buttons and sliders etc you can find on the Environment tab are really best learned when playing with them, as they affect things as the lighting (for example the location of the “sun” of the 3D world) and how the water reacts to light etc. Below will follow a short list with the different buttons etc and a short explanation on what they do. First a little recommendation though, to be able to see any difference when using most of the buttons you'll need to enable “fancy water”. As the name implies it's for the looks more than anything else and will require a decent graphics card (which supports the shaders that the fancy waters requires), it will also decrease performance as the power will be used for yet another thing. You enable it by navigating to the \binaries\data\config\ folder and there open the system.cfg using a text editor, in that file find the line: 
     186 
    204187{{{ 
    205188fancywater=false 
    206189}}} 
    207  
    208190Change the false to “true” to get the line: 
     191 
    209192{{{ 
    210193fancywater=true 
     
    230213 
    231214=== Cinematics tab === 
    232  
    233215Originally this tab wasn't going to be in this guide, and most of it won't, there is however one useful button which can be a life saver at times. 
    234216 
    235217==== The Reset Camera button ==== 
    236  
    237218[[Image(tabs_cinematic_reset_camera.png)]] 
    238219