User Tools

Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
mapping:cawe:views [2010-10-26 16:39]
Carsten Updated and revised text to match latest source code
mapping:cawe:views [2013-01-07 12:07] (current)
Line 19: Line 19:
  
 By clicking and dragging a windows title bar, the views can be docked, undocked and arranged as you like. By clicking and dragging a windows title bar, the views can be docked, undocked and arranged as you like.
-Press ''​CTRL''​ while dragging a window in order to keep it floating (prevent it from docking to one of the highlighted dock positions).+Press ''​Ctrl''​ while dragging a window in order to keep it floating (prevent it from docking to one of the highlighted dock positions).
  
  
 ===== The active view ===== ===== The active view =====
  
-A view is activated when you move the mouse pointer into its window.+A view is //activated// when you move the mouse pointer into its window.
  
 Keyboard input, menu commands and status bar information all refer to the most recently activated view. Keyboard input, menu commands and status bar information all refer to the most recently activated view.
Line 30: Line 30:
  
  
-===== The 2D views =====+===== Changing the view mode =====
  
-The 2D views show the map from the top, the side or the front+{{ :​mapping:​cawe:​views:​3d_view_context_menu.png|The context menu of a 3D view.}} 
-When a 2D view is activeyou can use the following ​key and mouse actions to navigate in it:+{{ :​mapping:​cawe:​views:​2d_view_context_menu.png|The context menu of a 2D view.}} 
 +In order to change the mode of a 2D or 3D view, use
 +  * the ''​Tab'' ​key
 +  * the ''​Shift+Tab''​ key, 
 +  * or the context menu (right ​mouse button click).
  
-  * The four arrow keys (up, down, left, right) scroll ​the map+<​clear>​The 2D views show the map from the top, the front or the side:
-  * The ''​+''​ and ''​-''​ keys change ​the zoom level. +
-  * When you press and hold the ''​SPACE''​ key, the cursor turns into an open hand, and then you can use the mouse to pan the view. +
-  * Using the mouse wheel zooms, too. +
-  * The ''​CTRL+E''​ menu shortcut centers all 2D views onto the currently selected object(s).+
  
-In the status bar at the bottom of the screen you will see both the current position of the mouse cursor in world coordinates as well as the current zoom level of the active viewThere is also other information shown in the status bar, depending on the currently active tool.+{{:​mapping:​cawe:​views:​2d_view_top.png|2D Top}} 
 +{{:​mapping:​cawe:​views:​2d_view_front.png|2D Front}} 
 +{{:​mapping:​cawe:​views:​2d_view_side.png|2D Side}}
  
 +The 3D views show the map in different render modes, for example "​wire-frame",​ "flat colored",​ "edit materials"​ or "full materials":​
  
-===== The 3D views =====+{{:​mapping:​cawe:​views:​3d_view_wireframe.png|3D Wireframe}} 
 +{{:​mapping:​cawe:​views:​3d_view_flat.png|3D Flat}} 
 +{{:​mapping:​cawe:​views:​3d_view_full.png|3D Full Materials}}
  
-The 3D views show the map from a perspective that comes close to how the Cafu engine will render ​the map. +Note that render mode "3D Edit Mats" often looks much like "3D Full Mats", but whereas ​the latter shows the materials in their "​natural"​ appearance (as in the game engine, e.g. translucentdistorted, invisible, black, etc.), "3D Edit Mats" shows plainly textured surfaces instead. This can be very helpful for seeing the materials properly for editing purposes.
-It's very useful to get an overall impressionapply and align materials and objects, etc.+
  
-  * The four arrow keys (up, down, left, right) rotate the camera. 
-  * Use ''​A'',​ ''​W'',​ ''​S''​ and ''​D''​ to move the camera. 
-  * Press ''​Z''​ to toggle the mouse-look-lock. That is, when you pressed ''​Z'',​ you can let everything else go and moving the mouse will still rotate the camera. In combination with the ''​A'',​ ''​W'',​ ''​S''​ and ''​D''​ keys, this is very much like controlling the player when the map is running in-game. Press ''​Z''​ again to release the mouse. 
-  * The scroll wheel moves the camera into and out of the screen, just like the ''​W''​ and ''​S''​ keys. 
-  * Refer to and use the explicit [[mapping:​cawe:​editingtools:​camera|Camera Tool]] for even more ways to set and control the 3D views. 
-  * Press and hold the ''​SPACE''​ key to temporarily control the camera as if the [[mapping:​cawe:​editingtools:​camera|Camera Tool]] was active. That means that while you hold the ''​SPACE''​ key, 
-    * also hold the left mouse button to mouse-look (rotate the camera using the mouse), 
-    * also hold the right mouse button to move the camera using the mouse (strafe left and right, move up and down), 
-    * also hold the left //and// right mouse button to move the camera using the mouse (strafe left and right, but now move into and out of the screen). 
  
 +===== Navigating the 2D views =====
  
-===== All views =====+Use the following keyboard and mouse input in order to navigate the 2D views:
  
-The four views are separated by splitter bars, and you can easily adjust their size by pulling ​the splitters ​into a new position. There is currently no full-screen mode available for the views, but moving ​the splitters so that the size of one of the views is maximized simulates ​the effectPress ''​CTRL+A''​ to make the four views (arranged in a 2x2 pattern) all the same size again (this re-centers ​the splitter bars).+^ Keyboard<​nbsp>​Input ​ ^ Action ^ 
 +| Arrow keys ''​←↑↓→'' ​ | Scroll ​the map into the direction of the arrow. | 
 +| ''​Space'' ​           | Pan the view: while the key is being held down, scroll the map by moving ​the mouse
 +''​+'' ​or ''​-'' ​      | Zoom in or out (on mouse pointer). | 
 +| ''​1'',​ ''​2'',​ ''​3'',​ ..., ''​0'' ​     | Zoom to a preset level. | 
 +| ''​Ctrl+E'' ​          | Center all 2D views onto the currently selected object(s). | 
 +| ''​Z'' ​               | Toggle the pan feature: Pressing ''​Z''​ once is like holding down ''​RMB''​ or ''​Space'' ​all the time. Pressing ''​Z''​ anew turns panning off again.  | 
 +| ''​Tab'' ​             | Cycle through top, front or side view modes as described [[#​changing_the_view_mode|above]] ​(''​Shift+Tab''​ for opposite order). | 
 +^ Mouse Input          ^ Action ^ 
 +| ''​RMB''​ (click) ​     | Open the context menu (or apply a tool-specific function). | 
 +| ''​RMB''​ (drag) ​      | Pan the view: while the button is being held down, scroll the map by moving the mouse. | 
 +| Wheel                | Zoom in or out (on mouse pointer). |
  
-{{:​mapping:​cawe:​view_rendermodes.png |View types and render modes.}} ​In each view, there is a drop-down box in the upper left corner where you can change ​the type (2D vs. 3D) and the render mode (textured, solid, wire-frame, etc.) of the view.+In the status bar at the bottom of the screen ​you will see both the current position of the mouse pointer in world coordinates as well as the current zoom level of the active ​view
 +The currently active tool may provide additional information in the status bar as well.
  
-Note that the render mode "3D Edit Mats" often looks much like the "3D Full Mats", but whereas the latter shows the materials in their "​natural"​ appearance (as they appear later in the game, e.g. translucent,​ distorted, invisible, black etc.), "3D Edit Mats" shows plainly textured surfaces instead. This can be very helpful for seeing the materials properly for editing purposes. 
  
-<​clear>​ \\ The images below show three frequently used render modes for the 3D views: \\ +===== Navigating ​the 3D views =====
-{{:​mapping:​cawe:​view_3d_wireframe.png|3D Wireframe}} +
-{{:​mapping:​cawe:​view_3d_flat.png|3D Flat}} +
-{{:​mapping:​cawe:​view_3d_fullmats.png|3D Full Mats}}+
  
 +Each 3D view has an associated camera that can be manipulated in order to show the map from arbitrary points, directions and perspectives.
 +Use the following keyboard and mouse input in order to navigate (the cameras of) the 3D views:
 +
 +^ Keyboard<​nbsp>​Input ​ ^ Action ^
 +| Arrow keys ''​←↑↓→'' ​ | Rotate the camera (look around). |
 +| ''​W'',​ ''​A'',​ ''​S'',​ ''​D'' ​ | Move the camera left/right and forwards/​backwards (along its depth axis). |
 +| ''​Space'' ​           | An alternative to the ''​RMB''​ that works exactly alike, including all combinations of ''​Shift''​ and ''​Ctrl''​. |
 +| ''​Z'' ​               | Toggle camera control: Pressing ''​Z''​ once is like holding down ''​RMB''​ or ''​Space''​ all the time. Pressing ''​Z''​ anew turns camera control off again. ​ |
 +| ''​Tab'' ​             | Cycle through the render modes as described [[#​changing_the_view_mode|above]] (''​Shift+Tab''​ for opposite order). |
 +| ''​1'',​ ''​2'' ​        | Advanced: Move the far clip plane closer to or farther from the camera. |
 +^ Mouse Input          ^ Action ^
 +| ''​RMB''​ (click) ​     | Open the context menu (or apply a tool-specific function). |
 +| ''​RMB''​ (drag) ​      | Rotate: Move the mouse to rotate the camera (look around). |
 +| ''​RMB+Shift'' ​       | Pan: Move the mouse to pan the camera left/right and up/​down. ​ |
 +| ''​RMB+Ctrl'' ​        | Fly: Move the mouse to pan the camera left/right and move it forwards/​backwards. |
 +| ''​RMB+Ctrl+Shift'' ​  | Walk: Move the mouse to rotate and move the camera in the XY-plane. |
 +|  ||
 +| ''​MMB''​ (drag) ​      | Orbit around the point under the mouse pointer (horizontally and vertically). |
 +| ''​MMB+Shift'' ​       | Orbit, and move the camera closer to or farther from the object under the mouse pointer. |
 +| ''​MMB+Ctrl'' ​        | Same as ''​MMB+Shift''​. |
 +|  ||
 +| Wheel                | "​Zoom"​ (move the camera closer to or farther from the object under the mouse pointer). \\ Combine with ''​Ctrl''​ __or__ ''​Shift''​ for slower (but more precise) movement. \\ Combine with ''​Ctrl''​ __and__ ''​Shift''​ for even slower (but even more precise) movement. |
 +
 +Notes and references:
 +  * Except for opening the context menu, which requires a RMB //click//, the mouse buttons RMB and MMB must be pressed //and held// while the mouse is moved to control the camera.
 +  * You can use the [[mapping:​cawe:​editingtools:​camera|Camera Tool]] for more exotic (and less frequently needed) camera control features, such as creating additional cameras or setting the camera origin and orientation in a 2D view.
 +  * The [[mapping:​cawe:​dialogs:​options#​d_views1|Configure CaWE]] dialog has options that affect the 3D views and their cameras, e.g. for setting the movement speed or reversing the mouse Y-axis.
 +
 +
 +===== Video =====
 +
 +This video demonstrates the most important concepts for navigating the 2D and 3D views:
 +
 +<​HTML>​
 +<div style="​text-align:​ center;">​
 +<object width="​770"​ height="​488">​
 +<param name="​movie"​ value="​http://​www.youtube.com/​v/​7TyxggIvmHI?​fs=1&​amp;​hl=de_DE"></​param>​
 +<param name="​allowFullScreen"​ value="​true"></​param><​param name="​allowscriptaccess"​ value="​always"></​param>​
 +<embed src="​http://​www.youtube.com/​v/​7TyxggIvmHI?​fs=1&​amp;​hl=de_DE"​ type="​application/​x-shockwave-flash"​ allowscriptaccess="​always"​ allowfullscreen="​true"​ width="​770"​ height="​488"></​embed>​
 +</​object>​
 +</​div>​
 +</​HTML>​
 +\\
 +You can also download the high-quality edition: [[http://​www.cafu.de/​files/​videos/​CaWE_Navigating_the_Views.mp4|CaWE_Navigating_the_Views.mp4]]
mapping/cawe/views.1288103988.txt.gz · Last modified: 2013-01-07 12:07 (external edit)