/* * Copyright (c) 2014-2021, NVIDIA CORPORATION. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * SPDX-FileCopyrightText: Copyright (c) 2014-2021 NVIDIA CORPORATION * SPDX-License-Identifier: Apache-2.0 */ #ifndef NV_CAMCONTROL_INCLUDED #define NV_CAMCONTROL_INCLUDED #include #include namespace nvh { ////////////////////////////////////////////////////////////////////////// /** \class nvh::CameraControl \brief nvh::CameraControl is a utility class to create a viewmatrix based on mouse inputs. It can operate in perspective or orthographic mode (`m_sceneOrtho==true`). perspective: - LMB: rotate - RMB or WHEEL: zoom via dolly movement - MMB: pan/move within camera plane ortho: - LMB: pan/move within camera plane - RMB or WHEEL: zoom via dolly movement, application needs to use `m_sceneOrthoZoom` for projection matrix adjustment - MMB: rotate The camera can be orbiting (`m_useOrbit==true`) around `m_sceneOrbit` or otherwise provide "first person/fly through"-like controls. Speed of movement/rotation etc. is influenced by `m_sceneDimension` as well as the sensitivity values. */ class CameraControl { public: CameraControl() : m_lastButtonFlags(0) , m_lastWheel(0) , m_senseWheelZoom(0.05f / 120.0f) , m_senseZoom(0.001f) , m_senseRotate((nv_pi * 0.5f) / 256.0f) , m_sensePan(1.0f) , m_sceneOrbit(0.0f) , m_sceneDimension(1.0f) , m_sceneOrtho(false) , m_sceneOrthoZoom(1.0f) , m_useOrbit(true) , m_sceneUp(0, 1, 0) { } inline void processActions(const nvmath::vec2i& window, const nvmath::vec2f& mouse, int mouseButtonFlags, int wheel) { int changed = m_lastButtonFlags ^ mouseButtonFlags; m_lastButtonFlags = mouseButtonFlags; int panFlag = m_sceneOrtho ? 1 << 0 : 1 << 2; int zoomFlag = 1 << 1; int rotFlag = m_sceneOrtho ? 1 << 2 : 1 << 0; m_panning = !!(mouseButtonFlags & panFlag); m_zooming = !!(mouseButtonFlags & zoomFlag); m_rotating = !!(mouseButtonFlags & rotFlag); m_zoomingWheel = wheel != m_lastWheel; m_startZoomWheel = m_lastWheel; m_lastWheel = wheel; if(m_rotating) { m_panning = false; m_zooming = false; } if(m_panning && (changed & panFlag)) { // pan m_startPan = mouse; m_startMatrix = m_viewMatrix; } if(m_zooming && (changed & zoomFlag)) { // zoom m_startMatrix = m_viewMatrix; m_startZoom = mouse; m_startZoomOrtho = m_sceneOrthoZoom; } if(m_rotating && (changed & rotFlag)) { // rotate m_startRotate = mouse; m_startMatrix = m_viewMatrix; } if(m_zooming || m_zoomingWheel) { float dist = m_zooming ? -(nvmath::dot(mouse - m_startZoom, nvmath::vec2f(-1, 1)) * m_sceneDimension * m_senseZoom) : (float(wheel - m_startZoomWheel) * m_sceneDimension * m_senseWheelZoom); if(m_zoomingWheel) { m_startZoomOrtho = m_sceneOrthoZoom; m_startMatrix = m_viewMatrix; } if(m_sceneOrtho) { float newzoom = m_startZoomOrtho - (dist); if(m_zoomingWheel) { if(newzoom < 0) { m_sceneOrthoZoom *= 0.5; } else if(m_sceneOrthoZoom < abs(dist)) { m_sceneOrthoZoom *= 2.0; } else { m_sceneOrthoZoom = newzoom; } } else { m_sceneOrthoZoom = newzoom; } m_sceneOrthoZoom = std::max(0.0001f, m_sceneOrthoZoom); } else { nvmath::mat4f delta = nvmath::translation_mat4(nvmath::vec3f(0, 0, dist * 2.0f)); m_viewMatrix = delta * m_startMatrix; } } if(m_panning) { float aspect = float(window.x) / float(window.y); nvmath::vec3f winsize(window.x, window.y, 1.0f); nvmath::vec3f ortho(m_sceneOrthoZoom * aspect, m_sceneOrthoZoom, 1.0f); nvmath::vec3f sub(mouse - m_startPan, 0.0f); sub /= winsize; sub *= ortho; sub.y *= -1.0; if(!m_sceneOrtho) { sub *= m_sensePan * m_sceneDimension; } nvmath::mat4f delta; delta.as_translation(sub); m_viewMatrix = delta * m_startMatrix; } if(m_rotating) { float aspect = float(window.x) / float(window.y); nvmath::vec2f angles = (mouse - m_startRotate) * m_senseRotate; if(m_useOrbit) { nvmath::mat4f rot = nvmath::rotation_yaw_pitch_roll(angles.x, angles.y, 0.0f); nvmath::vec3f center = nvmath::vec3f(m_startMatrix * nvmath::vec4f(m_sceneOrbit, 1.0f)); nvmath::mat4f delta = nvmath::translation_mat4(center) * rot * nvmath::translation_mat4(-center); m_viewMatrix = delta * m_startMatrix; } else { // FIXME use sceneUP nvmath::mat4f rot = nvmath::rotation_yaw_pitch_roll(angles.x, angles.y, 0.0f); m_viewMatrix = rot * m_startMatrix; } } } bool m_useOrbit; bool m_sceneOrtho; float m_sceneOrthoZoom; float m_sceneDimension; nvmath::vec3f m_sceneUp; nvmath::vec3f m_sceneOrbit; nvmath::mat4f m_viewMatrix; float m_senseWheelZoom; float m_senseZoom; float m_senseRotate; float m_sensePan; private: bool m_zooming; bool m_zoomingWheel; bool m_panning; bool m_rotating; nvmath::vec2f m_startPan; nvmath::vec2f m_startZoom; nvmath::vec2f m_startRotate; nvmath::mat4f m_startMatrix; int m_startZoomWheel; float m_startZoomOrtho; int m_lastButtonFlags; int m_lastWheel; }; } // namespace nvh #endif