First part

apps/opencs/model/world/cellcoordinates.hpp

@@ -38,7 +38,9 @@ namespace CSMWorld
             /// \note The worldspace part of \a id is ignored
             static std::pair<CellCoordinates, bool> fromId (const std::string& id);
 
+            /// \return cell coordinates such that given world coordinates are in it.
             static std::pair<int, int> coordinatesToCellIndex (float x, float y);
+            
     };
 
     bool operator== (const CellCoordinates& left, const CellCoordinates& right);

apps/opencs/view/render/pagedworldspacewidget.cpp

@@ -19,6 +19,7 @@
 
 #include "editmode.hpp"
 #include "mask.hpp"
+#include "cameracontroller.hpp"
 
 bool CSVRender::PagedWorldspaceWidget::adjustCells()
 {
@@ -512,12 +513,15 @@ void CSVRender::PagedWorldspaceWidget::useViewHint (const std::string& hint)
             {
                 char ignore1; // : or ;
                 char ignore2; // #
+                // Current coordinate
                 int x, y;
 
+                // Loop throught all the coordinates to add them to selection
                 while (stream >> ignore1 >> ignore2 >> x >> y)
                     selection.add (CSMWorld::CellCoordinates (x, y));
                                
-                /// \todo adjust camera position
+                // Mark that camera needs setup
+                mCamPositionSet=false;
             }
         }
         else if (hint[0]=='r')

apps/opencs/view/render/pagedworldspacewidget.hpp

@@ -85,6 +85,7 @@ namespace CSVRender
 
             virtual ~PagedWorldspaceWidget();
 
+            /// Decodes the the hint string to set of cell that are rendered.
             void useViewHint (const std::string& hint);
 
             void setCellSelection(const CSMWorld::CellSelection& selection);

apps/opencs/view/render/scenewidget.hpp

@@ -7,15 +7,14 @@
 #include <QWidget>
 #include <QTimer>
 
-#include <osgViewer/View>
-#include <osgViewer/CompositeViewer>
-
 #include <boost/shared_ptr.hpp>
 
 #include "lightingday.hpp"
 #include "lightingnight.hpp"
 #include "lightingbright.hpp"
 
+#include <osgViewer/View>
+#include <osgViewer/CompositeViewer>
 
 namespace Resource
 {
@@ -54,7 +53,6 @@ namespace CSVRender
             RenderWidget(QWidget* parent = 0, Qt::WindowFlags f = 0);
             virtual ~RenderWidget();
 
-            /// Initiates a request to redraw the view
             void flagAsModified();
 
             void setVisibilityMask(int mask);
@@ -64,16 +62,13 @@ namespace CSVRender
         protected:
 
             osg::ref_ptr<osgViewer::View> mView;
-            osg::ref_ptr<osg::Group> mRootNode;
+
+            osg::Group* mRootNode;
 
             QTimer mTimer;
-
-        protected slots:
-
-            void toggleRenderStats();
     };
 
-    /// Extension of RenderWidget to support lighting mode selection & toolbar
+    // Extension of RenderWidget to support lighting mode selection & toolbar
     class SceneWidget : public RenderWidget
     {
             Q_OBJECT
@@ -95,8 +90,18 @@ namespace CSVRender
 
             void setAmbient(const osg::Vec4f& ambient);
 
+            virtual void mousePressEvent (QMouseEvent *event);
+            virtual void mouseReleaseEvent (QMouseEvent *event);
             virtual void mouseMoveEvent (QMouseEvent *event);
             virtual void wheelEvent (QWheelEvent *event);
+            virtual void keyPressEvent (QKeyEvent *event);
+            virtual void keyReleaseEvent (QKeyEvent *event);
+            virtual void focusOutEvent (QFocusEvent *event);
+
+            /// \return Is \a key a button mapping setting? (ignored otherwise)
+            virtual bool storeMappingSetting (const CSMPrefs::Setting *setting);
+
+            std::string mapButton (QMouseEvent *event);
 
             boost::shared_ptr<Resource::ResourceSystem> mResourceSystem;
 
@@ -109,15 +114,17 @@ namespace CSVRender
             LightingBright mLightingBright;
 
             int mPrevMouseX, mPrevMouseY;
-
+            std::string mMouseMode;
-            FreeCameraController* mFreeCamControl;
+            std::auto_ptr<FreeCameraController> mFreeCamControl;
-            OrbitCameraController* mOrbitCamControl;
+            std::auto_ptr<OrbitCameraController> mOrbitCamControl;
             CameraController* mCurrentCamControl;
-
+            /// Tells update that camera isn't set
-        private:
             bool mCamPositionSet;
 
+            std::map<std::pair<Qt::MouseButton, bool>, std::string> mButtonMapping;
+
         public slots:
+            /// \note Remember set the camera before running
             void update(double dt);
 
         protected slots: