docs/html/unicam_8h_source.html

 /*

-  This file is part of the MinGfx Project.

-

-  Copyright (c) 2017,2018 Regents of the University of Minnesota.

-  All Rights Reserved.

-

-  Original Author(s) of this File:

-     Dan Keefe, 2018, University of Minnesota

-

-  Author(s) of Significant Updates/Modifications to the File:

-     ...

-  */

-

- #ifndef SRC_UNICAM_H_

- #define SRC_UNICAM_H_

-

- #include "quick_shapes.h"

- #include "point2.h"

- #include "point3.h"

- #include "vector2.h"

- #include "vector3.h"

-

-

- namespace mingfx {

-

-

- class UniCam {

- public:

-

-     UniCam();

-

-     UniCam(const Matrix4 &initialViewMatrix);

-

-     virtual ~UniCam();

-

-

-     // To make the interaction work, the following set of functions need to be

-     // called from your GraphicsApp or whatever main application class you use

-     // to receive user input events and a draw callback.

-

-     void OnButtonDown(const Point2 &normalizedMousePos, float mouseZ);

-

-     void OnDrag(const Point2 &normalizedMousePos);

-

-     void OnButtonUp(const Point2 &normalizedMousePos);

-

-     void AdvanceAnimation(double dt);

-

-     void Draw(const Matrix4 &projectionMatrix);

-

-

-     Matrix4 view_matrix();

-

-

-     Point3 eye();

-

-     Vector3 look();

-

-

-     // -------------

-

-     void set_view_matrix(Matrix4 viewMatrix);

-

-     void set_default_depth(float d);

-

-

- private:

-

-     void recalc_angular_vel();

-

-     enum class UniCamState {

-         START,

-         PAN_DOLLY_ROT_DECISION,

-         PAN_DOLLY_DECISION,

-         ROT_WAIT_FOR_SECOND_CLICK,

-         PAN,

-         DOLLY,

-         ROT,

-         SPINNING

-     };

-     UniCamState state_;

-

-     Point2  mouseLast_;

-     double  elapsedTime_;

-

-     Point2  initialClickPos_;

-     bool    hitGeometry_;

-     Point3  hitPoint_;

-

-     bool    rotInitialized_;

-     Point3  rotLastIPoint_;

-     float   boundingSphereRad_;

-     Point3  boundingSphereCtr_;

-     double  rotLastTime_;

-     std::vector<std::pair<double, double>> rotAngularVelBuffer_;

-     double rotAngularVel_;

-     Vector3 rotAxis_;

-

-     bool    dollyInitialized_;

-     float   dollyFactor_;

-     float   defaultDepth_;

-

-     bool    showIcon_;

-     QuickShapes quickShapes_;

-

-     Matrix4 V_;

-     Matrix4 Vstart_;

-

-     // saved from the last draw call in order to unproject the mouse pos

-     Matrix4 Pdraw_;

- };

-

-

- } // end namespace

-

- #endif

-

-

-mingfx::Matrix4
A 4x4 transformation matrix stored internally as an array of floats in column-major order so as to be...
Definition: matrix4.h:50

-mingfx::Point2
A 2D Point with floating point coordinates, used for storing 2D texture coordinates,...
Definition: point2.h:28

-mingfx::Point3
A 3D Point with floating point coordinates, used for storing vertices and all sorts of other 3D graph...
Definition: point3.h:52

-mingfx::QuickShapes
This class provides a quick way to draw shapes for use in debugging or simple scenes.
Definition: quick_shapes.h:69

-mingfx::UniCam
This implements a user interface for controlling the camera with the mouse.
Definition: unicam.h:105

-mingfx::UniCam::OnButtonUp
void OnButtonUp(const Point2 &normalizedMousePos)
Attach this to the corresponding button up event, for example, call this from within GraphicsApp::OnR...

-mingfx::UniCam::OnDrag
void OnDrag(const Point2 &normalizedMousePos)
Attach this to the corresponding mouse move event, for example, call this from within GraphicsApp::On...

-mingfx::UniCam::eye
Point3 eye()
Returns the "eye" point (i.e., focal point) of the camera in world space coordinates.

-mingfx::UniCam::set_view_matrix
void set_view_matrix(Matrix4 viewMatrix)
This is not required, but you may use this if you wish to set an initial view matrix or reset the vie...

-mingfx::UniCam::UniCam
UniCam()
Creates a UniCam object with an initial view matrix = identity.

-mingfx::UniCam::set_default_depth
void set_default_depth(float d)
This sets the depth of the center of rotation for the case when the user's click does not intersect a...

-mingfx::UniCam::look
Vector3 look()
Returns the look direction (i.e., -Z axis of the camera matrix) in world space coordinates.

-mingfx::UniCam::OnButtonDown
void OnButtonDown(const Point2 &normalizedMousePos, float mouseZ)
Attach this to whatever mouse button you wish, for example, call this from within GraphicsApp::OnRigh...

-mingfx::UniCam::AdvanceAnimation
void AdvanceAnimation(double dt)
Attach this to a callback that can be used to control animation. Within GraphicsApp::UpdateSimulation...

-mingfx::UniCam::Draw
void Draw(const Matrix4 &projectionMatrix)
Finally, attach this to your draw callback routine. Within GraphicsApp::DrawUsingOpenGL(),...

-mingfx::UniCam::UniCam
UniCam(const Matrix4 &initialViewMatrix)
Creates a UniCam object with the supplied initial view matrix.

-mingfx::UniCam::view_matrix
Matrix4 view_matrix()
Access the camera view matrix created by the UniCam interactions via this method and use it to draw t...

-mingfx::UniCam::~UniCam
virtual ~UniCam()

-mingfx::Vector3
A 3D Vector with floating point coordinates, used for storing normals and all sorts of other 3D graph...
Definition: vector3.h:62

-mingfx
Namespace for the MinGfx Toolkit.
Definition: aabb.h:21

-point2.h

-point3.h

-quick_shapes.h

-vector2.h

-vector3.h

-