hpl3:tools:maineditors:model_editor:main
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
hpl3:tools:maineditors:model_editor:main [2012/07/03 15:27] luis [EditMode selection bar] |
hpl3:tools:maineditors:model_editor:main [2013/01/31 16:22] (current) luis |
||
|---|---|---|---|
| Line 10: | Line 10: | ||
| When run, the first screen we get to see is like this: | When run, the first screen we get to see is like this: | ||
| - | + | {{ :hpl3:tools:maineditors:model_editor:modeleditor.png?nolink |}} | |
| - | [[{{:hpl2:tools:editors:modeleditoroverview.jpg?nolink&}}]] | + | |
| Each part of the screen has a specific function, as follows: | Each part of the screen has a specific function, as follows: | ||
| - | - Main menu bar: this is where every non-editor command lies, as well as some edition ones. | + | - [[#main_menu|Main menu bar]]: this is where every non-editor command lies, as well as some edition ones. |
| - | - [[:hpl2:tools:editors:model_editor|EditMode sidebar]]: here you will find a set of buttons used to switch the current behaviour of the editor. More on this later. | + | - [[#editmode_selection_bar|EditMode sidebar]]: here you will find a set of buttons used to switch the current behaviour of the editor. More on this later. |
| - EditMode window area: any helper input the current EditMode needs will appear here. | - EditMode window area: any helper input the current EditMode needs will appear here. | ||
| - | - Viewport area: this area of the screen is reserved for the viewports, which are used to actually see what you are doing to the map. Every viewport has its own menu bar, to control some parameters of the visualization. | + | - [[#viewport_area|Viewport area]]: this area of the screen is reserved for the viewports, which are used to actually see what you are doing to the map. Every viewport has its own menu bar, to control some parameters of the visualization. |
| - | - Lower toolbar: some tools that are either viewport-dependent or global are located here. | + | - [[#lower_toolbar|Lower toolbar]]: some tools that are either viewport-dependent or global are located here. |
| + | |||
| + | |||
| + | Not listed above are some special windows, used pretty often here: | ||
| - | ===== Main Menu ===== | + | * [[:hpl3:tools:maineditors:level_editor:save_dialog|Save entity dialog]] |
| + | * [[:hpl3:tools:maineditors:level_editor:load_dialog|Load entity dialog]] | ||
| + | * [[:hpl3:tools:maineditors:common:color_dialog|Color Picker]] | ||
| + | * [[:hpl3:tools:maineditors:common:texture_browser|Texture Browser]] | ||
| + | * [[:hpl3:tools:maineditors:common:sound_browser|Sound Browser]] | ||
| Line 32: | Line 37: | ||
| * **File** | * **File** | ||
| * **New**: This command will reset the map to an empty one, and the editor to a default state as well. | * **New**: This command will reset the map to an empty one, and the editor to a default state as well. | ||
| - | * **Open**: This will load an entity file in the editor. | + | * **Open**: This will open the [[:hpl3:tools:maineditors:level_editor:load_dialog|Load entity dialog]] to load an entity file in the editor. If the mesh used in the entity was updated with a different number of submeshes or with some of these renamed, the [[:hpl3:tools:maineditors:model_editor:submesh_reassign_dialog|SubMesh Reassign dialog]] will pop up to set up how the new submeshes should replace the old ones. |
| - | * **Save**: Use this to save your work to a file in disk. Will ask for a file name when no file has been created. | + | * **Save**: Use this to save your work to a file in disk. Will open the [[:hpl3:tools:maineditors:level_editor:save_dialog|Save entity dialog]] in case no file had been created already. |
| - | * **Save As**: This will also save your work, but will ask for a file name everytime it is called. | + | * **Save As**: This will also save your work, but will always open the [[:hpl3:tools:maineditors:level_editor:save_dialog|Save entity dialog]] to ask for a file name whenever it is chosen. |
| - | * **Import Mesh**: This option will open a dialog for importing a mesh file into the entity. | + | * **Import Mesh**: This option will open a dialog for importing a mesh file into the entity. Will open the [[:hpl3:tools:maineditors:model_editor:submesh_reassign_dialog|SubMesh Reassign dialog]] in case an imported mesh is already present. |
| * **Open Recent**: This will show a list of up to 10 files that have been recently loaded or saved. | * **Open Recent**: This will show a list of up to 10 files that have been recently loaded or saved. | ||
| * **Quit**: This will exit the program. | * **Quit**: This will exit the program. | ||
| * **Edit** | * **Edit** | ||
| - | * **Undo**: Use this to undo the last action. Note that not everything you can do in the editor is undo-able. | + | * **Undo**: Use this to undo the last action. Note that not everything you can do in the editor is undoable. |
| * **Redo**: Use this to redo the last undone action. | * **Redo**: Use this to redo the last undone action. | ||
| * **Delete**: This will delete the current selected objects. Note that not all objects can be deleted. | * **Delete**: This will delete the current selected objects. Note that not all objects can be deleted. | ||
| * **Clone**: This will create copy objects out of the currently selected ones. Note that not all objects can be cloned. | * **Clone**: This will create copy objects out of the currently selected ones. Note that not all objects can be cloned. | ||
| * **View** | * **View** | ||
| - | * **Outline**: This will bring up the [[:hpl2:tools:editors:model_editor|Outline Window]]. It can be used to edit attachments with ease. | + | * **Outline**: This will bring up the [[:hpl3:tools:maineditors:model_editor:window_outline|Outline Window]]. It can be used to edit attachments with ease. |
| - | * **Settings** | + | * **Entity Settings** |
| - | * **User defined variables**: This will bring up the [[:hpl2:tools:editors:model_editor:outline|User Defined Variables window]]. Use this to set up a defined type to your created entity. | + | * **Class**: This will bring up the [[:hpl3:tools:maineditors:model_editor:window_class|Entity class window]]. Use this to set up a user defined type to your created entity. |
| - | * **Animations**: This will bring up the [[:hpl2:tools:editors:model_editor:uservars|Animations window]]. Animations are added and its parameters set here. | + | * **Animations**: This will bring up the [[:hpl3:tools:maineditors:model_editor:window_animation|Animations window]]. Animations are added and set up here. |
| + | * **Notes**: Brings up the [[:hpl3:tools:maineditors:model_editor:window_notes|Entity notes window]]. You can add information about the entity in text form with this tool. | ||
| ===== EditMode selection bar ===== | ===== EditMode selection bar ===== | ||
| + | Here you will be able to switch between the different EditModes available in this editor. An EditMode describes the state the editor is going to work in when selected. These five EditModes can be found in both this and the Model Editor. | ||
| - | Here you will be able to switch between the different EditModes available in this editor. An EditMode describes the state the editor is going to work in when selected. These five EditModes can be found in this editor and the Model Editor. | + | * [[hpl3:tools:maineditors:common:select_editmode|Select EditMode]]: this mode is used to select and edit objects. |
| - | + | * [[hpl3:tools:maineditors:common:light_editmode|Light EditMode]]: with this mode you will be able to place lights around. | |
| - | + | * [[hpl3:tools:maineditors:common:billboard_editmode|Billboard EditMode]]: use this to create Billboards. Light halos, light shafts, and some other | |
| - | * [[:hpl3:tools:maineditors:common:select_editmode|Select EditMode]]: this mode is used to select and edit objects. | + | * [[hpl3:tools:maineditors:common:particlesystem_editmode|Particle System EditMode]]: one can add Particle systems to the map with this mode. |
| - | * [[:hpl3:tools:maineditors:common:light_editmode|Light EditMode]]: with this mode you will be able to place lights around. | + | * [[hpl3:tools:maineditors:common:sound_editmode|Sound EditMode]]: used to place sound entities in the map. |
| - | * [[:hpl3:tools:maineditors:common:billboard_editmode|Billboard EditMode]]: use this to create Billboards. Light halos, light shafts, and some other | + | * [[hpl3:tools:maineditors:common:lensflare_editmode|LensFlare EditMode]]: used to create objects that will generate a lensflare effect when looked at. |
| - | * [[:hpl3:tools:maineditors:common:particle_system_editmode|Particle Systems EditMode]]: one can add Particle systems to the map with this mode. | + | |
| - | * [[:hpl3:tools:maineditors:common:sound_editmode|Sound EditMode]]: used to place sound entities in the map. | + | |
| The following EditModes are exclusive to the Model Editor | The following EditModes are exclusive to the Model Editor | ||
| - | * [[:hpl2:tools:editors:sound_editmode|Shape EditMode]]: physical bodies are created over shapes. Create shapes with this EditMode. | + | * [[:hpl3:tools:maineditors:model_editor:shape_editmode|Shape EditMode]]: physical bodies are created over shapes. Create shapes with this EditMode. |
| - | * [[:hpl2:tools:editors:model_editor:shape_editmode|Joint EditMode]]: using this mode you will be able to create joints. Joints are used to add contraints to body movements. | + | * [[:hpl3:tools:maineditors:model_editor:joint_editmode|Joint EditMode]]: using this mode you will be able to create joints. Joints are used to add contraints to body movements. |
| ===== Viewport area ===== | ===== Viewport area ===== | ||
| Line 73: | Line 78: | ||
| - | [[:hpl2:tools:editors:model_editor:joint_editmode?id=hpl2:tools:editors:model_editor|{{:hpl2:tools:editors:model_viewports.jpg?nolink&}}]] | + | {{ :hpl3:tools:maineditors:level_editor:viewportarea.png?nolink |}} |
| Line 90: | Line 95: | ||
| Each viewport has a "View" menu bar, which includes the following options: | Each viewport has a "View" menu bar, which includes the following options: | ||
| - | + | * **Camera Mode**: choosing an item from this submenu will reset the viewport to a preset. An ortho preset means that it will use orthographic mode, so no perspective distortion will be seen. All presets reset the camera target to a (0,0,0) position. One out of the following presets can be picked: | |
| - | * **Render Mode**: the mode that will be used by the viewport to draw objects | + | |
| - | * **Shaded**: drawing will be fully done, using lighting just like ingame. Ortho presets cannot use this mode. | + | |
| - | * **Wireframe**: only edge lines for polygons will be drawn in this mode. | + | |
| - | * **Presets**: choosing an item from this submenu will reset the viewport to a preset. An ortho preset means that it will use orthographic mode, so no perspective distortion will be seen. All presets reset the camera target to a (0,0,0) position. One out of the following presets can be picked: | + | |
| * **Front**: ortho preset, scene will be seen from the front. | * **Front**: ortho preset, scene will be seen from the front. | ||
| * **Right**: ortho preset, scene will be seen from the right side of the objects, pointing to the left. | * **Right**: ortho preset, scene will be seen from the right side of the objects, pointing to the left. | ||
| * **Top**: ortho preset, scene will be seen top-bottom. | * **Top**: ortho preset, scene will be seen top-bottom. | ||
| * **Perspective**: this is the only perspective mode, will reset the camera position to (10,10,10). | * **Perspective**: this is the only perspective mode, will reset the camera position to (10,10,10). | ||
| + | |||
| + | * **Render Mode**: the mode that will be used by the viewport to draw objects | ||
| + | * **Wireframe**: only edge lines for polygons will be drawn in this mode. | ||
| + | * **Shaded**: drawing will be fully done, using lighting just like ingame. Ortho presets cannot use this mode. | ||
| + | * **Controllers**: under this item you will find the available controllers for the current view. These can either be **Maya** or **Fly**. More details later. | ||
| * **Show Grid**: toggles showing of the helper grid. | * **Show Grid**: toggles showing of the helper grid. | ||
| * **Show Axes**: toggles showing of the XYZ axes. | * **Show Axes**: toggles showing of the XYZ axes. | ||
| ==== Moving and looking around ==== | ==== Moving and looking around ==== | ||
| + | Depending on the active controller, moving will be done differently, but all are activated using the view mode key (default left Alt). When this key is held, the red focus frame will turn yellow. | ||
| - | All movement and looking will be done using the mouse. In a nutshell, there are three basic movements that can be done, all need the 'view' key to be pressed (default left Alt). When this key is held, the red focus frame will turn yellow. These movements are listed next: | + | **Linux Note:** Left Super (aka "Windows" or Apple key) and the Z key are also the view key as the Alt key is usually bound by the Window Manager. \\ **Mac<nowiki> OS</nowiki> X Note:** A three button mouse is required to use the editor. |
| - | + | ||
| - | + | ||
| - | **Linux Note:** Left Super (aka "Windows" or Apple key) and the Z key are also the view key as the Alt key is usually bound by the Window Manager. \\ **Mac<nowiki> OS</nowiki> X Note:** A three button mouse is required to use the editor. | + | |
| + | === Maya === | ||
| + | All movement and looking will be done using the mouse. In a nutshell, there are three basic movements that can be done: | ||
| * **Tumble**: pressing the 'view' key and the left mouse button at the same time will activate the Tumble mode. This means the camera target will stay in place while the camera will orbit around it. | * **Tumble**: pressing the 'view' key and the left mouse button at the same time will activate the Tumble mode. This means the camera target will stay in place while the camera will orbit around it. | ||
| Line 115: | Line 121: | ||
| * Tracking lock to grid is enabled: this allows the user to click on the grid, hold and drag to get a camera displacement. Pretty useful when one wants to cover large distances. This mode is forced in ortho views. | * Tracking lock to grid is enabled: this allows the user to click on the grid, hold and drag to get a camera displacement. Pretty useful when one wants to cover large distances. This mode is forced in ortho views. | ||
| * **Zoom**: pressing the 'view' key and the right mouse button at the same time will activate the Zoom mode. Moving the mouse forward/backward will then zoom in/out respectively. Note there are limits for zooming in and out. You can also zoom in/out by rolling the mouse wheel up/down. | * **Zoom**: pressing the 'view' key and the right mouse button at the same time will activate the Zoom mode. Moving the mouse forward/backward will then zoom in/out respectively. Note there are limits for zooming in and out. You can also zoom in/out by rolling the mouse wheel up/down. | ||
| + | |||
| + | === Fly === | ||
| + | Looking around is done with the mouse, moving is done with standard FPS controls: W key moves forward, S key moves backward, A and D goes left and right respectively. Q and E for moving up and down. | ||
| ==== Enlarging a viewport ==== | ==== Enlarging a viewport ==== | ||
| When working in a viewport, the common thing to do is enlarging it. This can be done by clicking on the 'enlarge button' in the lower toolbar, or pressing the shortcut for it (spacebar). | When working in a viewport, the common thing to do is enlarging it. This can be done by clicking on the 'enlarge button' in the lower toolbar, or pressing the shortcut for it (spacebar). | ||
| - | |||
| ===== Lower Toolbar ===== | ===== Lower Toolbar ===== | ||
| + | You can find some useful controls in this bar located at all times at the lower part of the screen. | ||
| - | You can find some useful controls in this bar located at all times at the lower part of the screen. {{:hpl2:tools:editors:model_lowertoolbar.jpg?nolink&}} | + | {{ :hpl3:tools:maineditors:model_editor:window_modeleditor_lowertoolbar.png?nolink |}} |
| - Grid Controls: | - Grid Controls: | ||
| - | * Grid Plane: cycles through the available grid planes (XZ, XY, YZ). | + | * **Grid Plane**: cycles through the available grid planes (XZ, XY, YZ). |
| - | * Toggle Snap(magnet button): enables/disables snapping for translation (over grid), rotation and scale. | + | * **Toggle Snap** (magnet button): enables/disables snapping for translation (over grid), rotation and scale. |
| - | * Grid Height: height of the plane, measured on the plane normal. | + | * **Grid Height**: height of the plane, measured on the plane normal. |
| - | * Snap Separation: separation of snapping points. | + | * **Snap Separation**: separation of snapping points. |
| - | - Enlarge Viewport button: will toggle enlargement of the focused viewport. | + | - **Enlarge Viewport button**: will toggle enlargement of the focused viewport. |
| - | - Entity Preview button: will toggle the entity preview window. | + | - **Entity Preview button**: will toggle the [[hpl3:tools:maineditors:model_editor:window_entitypreview|entity preview mode]]. |
| - Misc controls: | - Misc controls: | ||
| - | * A: toggles global ambient lighting | + | * **A**: toggles global ambient lighting |
| - | * P: togles global point light | + | * **P**: togles global point light |
| - | * LT: toggles Lock to grid for tracking in focused viewport | + | * **LT**: toggles Lock to grid for tracking in focused viewport |
| - | * F: focus on current selection | + | * **F**: focus on currently selected object(s) |
| + | * **I**: toggles displaying of icons. | ||
| ===== Types of Objects ===== | ===== Types of Objects ===== | ||
| Line 150: | Line 158: | ||
| * [[hpl3:tools:maineditors:common:billboards|Billboards]] | * [[hpl3:tools:maineditors:common:billboards|Billboards]] | ||
| * [[hpl3:tools:maineditors:common:particle_systems|Particle Systems]] | * [[hpl3:tools:maineditors:common:particle_systems|Particle Systems]] | ||
| - | * [[hpl3:tools:maineditors:common:sounds|Sounds]] | + | * [[hpl3:tools:maineditors:common:sounds|Sounds]] |
| + | * [[hpl3:tools:maineditors:common:lensflares|LensFlares]] | ||
hpl3/tools/maineditors/model_editor/main.1341329221.txt.gz · Last modified: 2012/07/03 15:27 by luis
