src/camera.cpp

   1 /*
   2 Minetest
   3 Copyright (C) 2010-2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #include "camera.h"
  21 #include "debug.h"
  22 #include "client.h"
  23 #include "main.h" // for g_settings
  24 #include "map.h"
  25 #include "clientmap.h" // MapDrawControl
  26 #include "mesh.h"
  27 #include "player.h"
  28 #include "tile.h"
  29 #include <cmath>
  30 #include "settings.h"
  31 #include "itemdef.h" // For wield visualization
  32 #include "noise.h" // easeCurve
  33 #include "gamedef.h"
  34 #include "sound.h"
  35 #include "event.h"
  36 #include "util/numeric.h"
  37 #include "util/mathconstants.h"
  38
  39 Camera::Camera(scene::ISceneManager* smgr, MapDrawControl& draw_control,
  40                 IGameDef *gamedef):
  41         m_smgr(smgr),
  42         m_playernode(NULL),
  43         m_headnode(NULL),
  44         m_cameranode(NULL),
  45
  46         m_wieldmgr(NULL),
  47         m_wieldnode(NULL),
  48         m_wieldlight(0),
  49
  50         m_draw_control(draw_control),
  51         m_gamedef(gamedef),
  52
  53         m_camera_position(0,0,0),
  54         m_camera_direction(0,0,0),
  55
  56         m_aspect(1.0),
  57         m_fov_x(1.0),
  58         m_fov_y(1.0),
  59
  60         m_added_frametime(0),
  61         m_added_frames(0),
  62         m_range_old(0),
  63         m_frametime_old(0),
  64         m_frametime_counter(0),
  65         m_time_per_range(30. / 50), // a sane default of 30ms per 50 nodes of range
  66
  67         m_view_bobbing_anim(0),
  68         m_view_bobbing_state(0),
  69         m_view_bobbing_speed(0),
  70
  71         m_digging_anim(0),
  72         m_digging_button(-1)
  73 {
  74         //dstream<<__FUNCTION_NAME<<std::endl;
  75
  76         // note: making the camera node a child of the player node
  77         // would lead to unexpected behaviour, so we don't do that.
  78         m_playernode = smgr->addEmptySceneNode(smgr->getRootSceneNode());
  79         m_headnode = smgr->addEmptySceneNode(m_playernode);
  80         m_cameranode = smgr->addCameraSceneNode(smgr->getRootSceneNode());
  81         m_cameranode->bindTargetAndRotation(true);
  82
  83         // This needs to be in its own scene manager. It is drawn after
  84         // all other 3D scene nodes and before the GUI.
  85         m_wieldmgr = smgr->createNewSceneManager();
  86         m_wieldmgr->addCameraSceneNode();
  87         m_wieldnode = m_wieldmgr->addMeshSceneNode(createCubeMesh(v3f(1,1,1)), NULL);  // need a dummy mesh
  88 }
  89
  90 Camera::~Camera()
  91 {
  92         m_wieldnode->setMesh(NULL);
  93         m_wieldmgr->drop();
  94 }
  95
  96 bool Camera::successfullyCreated(std::wstring& error_message)
  97 {
  98         if (m_playernode == NULL)
  99         {
 100                 error_message = L"Failed to create the player scene node";
 101                 return false;
 102         }
 103         if (m_headnode == NULL)
 104         {
 105                 error_message = L"Failed to create the head scene node";
 106                 return false;
 107         }
 108         if (m_cameranode == NULL)
 109         {
 110                 error_message = L"Failed to create the camera scene node";
 111                 return false;
 112         }
 113         if (m_wieldmgr == NULL)
 114         {
 115                 error_message = L"Failed to create the wielded item scene manager";
 116                 return false;
 117         }
 118         if (m_wieldnode == NULL)
 119         {
 120                 error_message = L"Failed to create the wielded item scene node";
 121                 return false;
 122         }
 123         return true;
 124 }
 125
 126 // Returns the fractional part of x
 127 inline f32 my_modf(f32 x)
 128 {
 129         double dummy;
 130         return modf(x, &dummy);
 131 }
 132
 133 void Camera::step(f32 dtime)
 134 {
 135         if (m_view_bobbing_state != 0)
 136         {
 137                 //f32 offset = dtime * m_view_bobbing_speed * 0.035;
 138                 f32 offset = dtime * m_view_bobbing_speed * 0.030;
 139                 if (m_view_bobbing_state == 2)
 140                 {
 141 #if 0
 142                         // Animation is getting turned off
 143                         if (m_view_bobbing_anim < 0.5)
 144                                 m_view_bobbing_anim -= offset;
 145                         else
 146                                 m_view_bobbing_anim += offset;
 147                         if (m_view_bobbing_anim <= 0 || m_view_bobbing_anim >= 1)
 148                         {
 149                                 m_view_bobbing_anim = 0;
 150                                 m_view_bobbing_state = 0;
 151                         }
 152 #endif
 153 #if 1
 154                         // Animation is getting turned off
 155                         if(m_view_bobbing_anim < 0.25){
 156                                 m_view_bobbing_anim -= offset;
 157                         } else if(m_view_bobbing_anim > 0.75){
 158                                 m_view_bobbing_anim += offset;
 159                         } if(m_view_bobbing_anim < 0.5){
 160                                 m_view_bobbing_anim += offset;
 161                                 if(m_view_bobbing_anim > 0.5)
 162                                         m_view_bobbing_anim = 0.5;
 163                         } else {
 164                                 m_view_bobbing_anim -= offset;
 165                                 if(m_view_bobbing_anim < 0.5)
 166                                         m_view_bobbing_anim = 0.5;
 167                         }
 168                         if(m_view_bobbing_anim <= 0 || m_view_bobbing_anim >= 1 ||
 169                                         fabs(m_view_bobbing_anim - 0.5) < 0.01)
 170                         {
 171                                 m_view_bobbing_anim = 0;
 172                                 m_view_bobbing_state = 0;
 173                         }
 174 #endif
 175                 }
 176                 else
 177                 {
 178                         float was = m_view_bobbing_anim;
 179                         m_view_bobbing_anim = my_modf(m_view_bobbing_anim + offset);
 180                         bool step = (was == 0 ||
 181                                         (was < 0.5f && m_view_bobbing_anim >= 0.5f) ||
 182                                         (was > 0.5f && m_view_bobbing_anim <= 0.5f));
 183                         if(step){
 184                                 MtEvent *e = new SimpleTriggerEvent("ViewBobbingStep");
 185                                 m_gamedef->event()->put(e);
 186                         }
 187                 }
 188         }
 189
 190         if (m_digging_button != -1)
 191         {
 192                 f32 offset = dtime * 3.5;
 193                 float m_digging_anim_was = m_digging_anim;
 194                 m_digging_anim += offset;
 195                 if (m_digging_anim >= 1)
 196                 {
 197                         m_digging_anim = 0;
 198                         m_digging_button = -1;
 199                 }
 200                 float lim = 0.15;
 201                 if(m_digging_anim_was < lim && m_digging_anim >= lim)
 202                 {
 203                         if(m_digging_button == 0){
 204                                 MtEvent *e = new SimpleTriggerEvent("CameraPunchLeft");
 205                                 m_gamedef->event()->put(e);
 206                         } else if(m_digging_button == 1){
 207                                 MtEvent *e = new SimpleTriggerEvent("CameraPunchRight");
 208                                 m_gamedef->event()->put(e);
 209                         }
 210                 }
 211         }
 212 }
 213
 214 void Camera::update(LocalPlayer* player, f32 frametime, v2u32 screensize,
 215                 f32 tool_reload_ratio)
 216 {
 217         // Get player position
 218         // Smooth the movement when walking up stairs
 219         v3f old_player_position = m_playernode->getPosition();
 220         v3f player_position = player->getPosition();
 221         if (player->isAttached && player->parent)
 222                 player_position = player->parent->getPosition();
 223         //if(player->touching_ground && player_position.Y > old_player_position.Y)
 224         if(player->touching_ground &&
 225                         player_position.Y > old_player_position.Y)
 226         {
 227                 f32 oldy = old_player_position.Y;
 228                 f32 newy = player_position.Y;
 229                 f32 t = exp(-23*frametime);
 230                 player_position.Y = oldy * t + newy * (1-t);
 231         }
 232
 233         // Set player node transformation
 234         m_playernode->setPosition(player_position);
 235         m_playernode->setRotation(v3f(0, -1 * player->getYaw(), 0));
 236         m_playernode->updateAbsolutePosition();
 237
 238         //Get camera tilt timer (hurt animation)
 239         float cameratilt = fabs(fabs(player->hurt_tilt_timer-0.75)-0.75);
 240
 241         // Set head node transformation
 242         m_headnode->setPosition(player->getEyeOffset()+v3f(0,cameratilt*-player->hurt_tilt_strength,0));
 243         m_headnode->setRotation(v3f(player->getPitch(), 0, cameratilt*player->hurt_tilt_strength));
 244         m_headnode->updateAbsolutePosition();
 245
 246         // Compute relative camera position and target
 247         v3f rel_cam_pos = v3f(0,0,0);
 248         v3f rel_cam_target = v3f(0,0,1);
 249         v3f rel_cam_up = v3f(0,1,0);
 250
 251         if (m_view_bobbing_anim != 0)
 252         {
 253                 f32 bobfrac = my_modf(m_view_bobbing_anim * 2);
 254                 f32 bobdir = (m_view_bobbing_anim < 0.5) ? 1.0 : -1.0;
 255
 256                 #if 1
 257                 f32 bobknob = 1.2;
 258                 f32 bobtmp = sin(pow(bobfrac, bobknob) * M_PI);
 259                 //f32 bobtmp2 = cos(pow(bobfrac, bobknob) * M_PI);
 260
 261                 v3f bobvec = v3f(
 262                         0.3 * bobdir * sin(bobfrac * M_PI),
 263                         -0.28 * bobtmp * bobtmp,
 264                         0.);
 265
 266                 //rel_cam_pos += 0.2 * bobvec;
 267                 //rel_cam_target += 0.03 * bobvec;
 268                 //rel_cam_up.rotateXYBy(0.02 * bobdir * bobtmp * M_PI);
 269                 float f = 1.0;
 270                 f *= g_settings->getFloat("view_bobbing_amount");
 271                 rel_cam_pos += bobvec * f;
 272                 //rel_cam_target += 0.995 * bobvec * f;
 273                 rel_cam_target += bobvec * f;
 274                 rel_cam_target.Z -= 0.005 * bobvec.Z * f;
 275                 //rel_cam_target.X -= 0.005 * bobvec.X * f;
 276                 //rel_cam_target.Y -= 0.005 * bobvec.Y * f;
 277                 rel_cam_up.rotateXYBy(-0.03 * bobdir * bobtmp * M_PI * f);
 278                 #else
 279                 f32 angle_deg = 1 * bobdir * sin(bobfrac * M_PI);
 280                 f32 angle_rad = angle_deg * M_PI / 180;
 281                 f32 r = 0.05;
 282                 v3f off = v3f(
 283                         r * sin(angle_rad),
 284                         r * (cos(angle_rad) - 1),
 285                         0);
 286                 rel_cam_pos += off;
 287                 //rel_cam_target += off;
 288                 rel_cam_up.rotateXYBy(angle_deg);
 289                 #endif
 290
 291         }
 292
 293         // Compute absolute camera position and target
 294         m_headnode->getAbsoluteTransformation().transformVect(m_camera_position, rel_cam_pos);
 295         m_headnode->getAbsoluteTransformation().rotateVect(m_camera_direction, rel_cam_target - rel_cam_pos);
 296
 297         v3f abs_cam_up;
 298         m_headnode->getAbsoluteTransformation().rotateVect(abs_cam_up, rel_cam_up);
 299
 300         // Set camera node transformation
 301         m_cameranode->setPosition(m_camera_position);
 302         m_cameranode->setUpVector(abs_cam_up);
 303         // *100.0 helps in large map coordinates
 304         m_cameranode->setTarget(m_camera_position + 100 * m_camera_direction);
 305
 306         // Get FOV setting
 307         f32 fov_degrees = g_settings->getFloat("fov");
 308         fov_degrees = MYMAX(fov_degrees, 10.0);
 309         fov_degrees = MYMIN(fov_degrees, 170.0);
 310
 311         // FOV and aspect ratio
 312         m_aspect = (f32)screensize.X / (f32) screensize.Y;
 313         m_fov_y = fov_degrees * M_PI / 180.0;
 314         // Increase vertical FOV on lower aspect ratios (<16:10)
 315         m_fov_y *= MYMAX(1.0, MYMIN(1.4, sqrt(16./10. / m_aspect)));
 316         // WTF is this? It can't be right
 317         m_fov_x = 2 * atan(0.5 * m_aspect * tan(m_fov_y));
 318         m_cameranode->setAspectRatio(m_aspect);
 319         m_cameranode->setFOV(m_fov_y);
 320
 321         // Position the wielded item
 322         //v3f wield_position = v3f(45, -35, 65);
 323         v3f wield_position = v3f(55, -35, 65);
 324         //v3f wield_rotation = v3f(-100, 120, -100);
 325         v3f wield_rotation = v3f(-100, 120, -100);
 326         if(m_digging_anim < 0.05 || m_digging_anim > 0.5){
 327                 f32 frac = 1.0;
 328                 if(m_digging_anim > 0.5)
 329                         frac = 2.0 * (m_digging_anim - 0.5);
 330                 // This value starts from 1 and settles to 0
 331                 f32 ratiothing = pow((1.0f - tool_reload_ratio), 0.5f);
 332                 //f32 ratiothing2 = pow(ratiothing, 0.5f);
 333                 f32 ratiothing2 = (easeCurve(ratiothing*0.5))*2.0;
 334                 wield_position.Y -= frac * 25.0 * pow(ratiothing2, 1.7f);
 335                 //wield_position.Z += frac * 5.0 * ratiothing2;
 336                 wield_position.X -= frac * 35.0 * pow(ratiothing2, 1.1f);
 337                 wield_rotation.Y += frac * 70.0 * pow(ratiothing2, 1.4f);
 338                 //wield_rotation.X -= frac * 15.0 * pow(ratiothing2, 1.4f);
 339                 //wield_rotation.Z += frac * 15.0 * pow(ratiothing2, 1.0f);
 340         }
 341         if (m_digging_button != -1)
 342         {
 343                 f32 digfrac = m_digging_anim;
 344                 wield_position.X -= 50 * sin(pow(digfrac, 0.8f) * M_PI);
 345                 wield_position.Y += 24 * sin(digfrac * 1.8 * M_PI);
 346                 wield_position.Z += 25 * 0.5;
 347
 348                 // Euler angles are PURE EVIL, so why not use quaternions?
 349                 core::quaternion quat_begin(wield_rotation * core::DEGTORAD);
 350                 core::quaternion quat_end(v3f(80, 30, 100) * core::DEGTORAD);
 351                 core::quaternion quat_slerp;
 352                 quat_slerp.slerp(quat_begin, quat_end, sin(digfrac * M_PI));
 353                 quat_slerp.toEuler(wield_rotation);
 354                 wield_rotation *= core::RADTODEG;
 355         }
 356         else {
 357                 f32 bobfrac = my_modf(m_view_bobbing_anim);
 358                 wield_position.X -= sin(bobfrac*M_PI*2.0) * 3.0;
 359                 wield_position.Y += sin(my_modf(bobfrac*2.0)*M_PI) * 3.0;
 360         }
 361         m_wieldnode->setPosition(wield_position);
 362         m_wieldnode->setRotation(wield_rotation);
 363         m_wieldlight = player->light;
 364
 365         // Render distance feedback loop
 366         updateViewingRange(frametime);
 367
 368         // If the player seems to be walking on solid ground,
 369         // view bobbing is enabled and free_move is off,
 370         // start (or continue) the view bobbing animation.
 371         v3f speed = player->getSpeed();
 372         if ((hypot(speed.X, speed.Z) > BS) &&
 373                 (player->touching_ground) &&
 374                 (g_settings->getBool("view_bobbing") == true) &&
 375                 (g_settings->getBool("free_move") == false ||
 376                                 !m_gamedef->checkLocalPrivilege("fly")))
 377         {
 378                 // Start animation
 379                 m_view_bobbing_state = 1;
 380                 m_view_bobbing_speed = MYMIN(speed.getLength(), 40);
 381         }
 382         else if (m_view_bobbing_state == 1)
 383         {
 384                 // Stop animation
 385                 m_view_bobbing_state = 2;
 386                 m_view_bobbing_speed = 60;
 387         }
 388 }
 389
 390 void Camera::updateViewingRange(f32 frametime_in)
 391 {
 392         if (m_draw_control.range_all)
 393                 return;
 394
 395         m_added_frametime += frametime_in;
 396         m_added_frames += 1;
 397
 398         // Actually this counter kind of sucks because frametime is busytime
 399         m_frametime_counter -= frametime_in;
 400         if (m_frametime_counter > 0)
 401                 return;
 402         m_frametime_counter = 0.2;
 403
 404         /*dstream<<__FUNCTION_NAME
 405                         <<": Collected "<<m_added_frames<<" frames, total of "
 406                         <<m_added_frametime<<"s."<<std::endl;
 407
 408         dstream<<"m_draw_control.blocks_drawn="
 409                         <<m_draw_control.blocks_drawn
 410                         <<", m_draw_control.blocks_would_have_drawn="
 411                         <<m_draw_control.blocks_would_have_drawn
 412                         <<std::endl;*/
 413
 414         // Get current viewing range and FPS settings
 415         f32 viewing_range_min = g_settings->getS16("viewing_range_nodes_min");
 416         viewing_range_min = MYMAX(5.0, viewing_range_min);
 417
 418         f32 viewing_range_max = g_settings->getS16("viewing_range_nodes_max");
 419         viewing_range_max = MYMAX(viewing_range_min, viewing_range_max);
 420
 421         // Immediately apply hard limits
 422         if(m_draw_control.wanted_range < viewing_range_min)
 423                 m_draw_control.wanted_range = viewing_range_min;
 424         if(m_draw_control.wanted_range > viewing_range_max)
 425                 m_draw_control.wanted_range = viewing_range_max;
 426
 427         // Just so big a value that everything rendered is visible
 428         // Some more allowance than viewing_range_max * BS because of clouds,
 429         // active objects, etc.
 430         if(viewing_range_max < 200*BS)
 431                 m_cameranode->setFarValue(200 * BS * 10);
 432         else
 433                 m_cameranode->setFarValue(viewing_range_max * BS * 10);
 434
 435         f32 wanted_fps = g_settings->getFloat("wanted_fps");
 436         wanted_fps = MYMAX(wanted_fps, 1.0);
 437         f32 wanted_frametime = 1.0 / wanted_fps;
 438
 439         m_draw_control.wanted_min_range = viewing_range_min;
 440         m_draw_control.wanted_max_blocks = (2.0*m_draw_control.blocks_would_have_drawn)+1;
 441         if (m_draw_control.wanted_max_blocks < 10)
 442                 m_draw_control.wanted_max_blocks = 10;
 443
 444         f32 block_draw_ratio = 1.0;
 445         if (m_draw_control.blocks_would_have_drawn != 0)
 446         {
 447                 block_draw_ratio = (f32)m_draw_control.blocks_drawn
 448                         / (f32)m_draw_control.blocks_would_have_drawn;
 449         }
 450
 451         // Calculate the average frametime in the case that all wanted
 452         // blocks had been drawn
 453         f32 frametime = m_added_frametime / m_added_frames / block_draw_ratio;
 454
 455         m_added_frametime = 0.0;
 456         m_added_frames = 0;
 457
 458         f32 wanted_frametime_change = wanted_frametime - frametime;
 459         //dstream<<"wanted_frametime_change="<<wanted_frametime_change<<std::endl;
 460
 461         // If needed frametime change is small, just return
 462         // This value was 0.4 for many months until 2011-10-18 by c55;
 463         // Let's see how this works out.
 464         if (fabs(wanted_frametime_change) < wanted_frametime*0.33)
 465         {
 466                 //dstream<<"ignoring small wanted_frametime_change"<<std::endl;
 467                 return;
 468         }
 469
 470         f32 range = m_draw_control.wanted_range;
 471         f32 new_range = range;
 472
 473         f32 d_range = range - m_range_old;
 474         f32 d_frametime = frametime - m_frametime_old;
 475         if (d_range != 0)
 476         {
 477                 m_time_per_range = d_frametime / d_range;
 478         }
 479
 480         // The minimum allowed calculated frametime-range derivative:
 481         // Practically this sets the maximum speed of changing the range.
 482         // The lower this value, the higher the maximum changing speed.
 483         // A low value here results in wobbly range (0.001)
 484         // A high value here results in slow changing range (0.0025)
 485         // SUGG: This could be dynamically adjusted so that when
 486         //       the camera is turning, this is lower
 487         //f32 min_time_per_range = 0.0015;
 488         f32 min_time_per_range = 0.0010;
 489         //f32 min_time_per_range = 0.05 / range;
 490         if(m_time_per_range < min_time_per_range)
 491         {
 492                 m_time_per_range = min_time_per_range;
 493                 //dstream<<"m_time_per_range="<<m_time_per_range<<" (min)"<<std::endl;
 494         }
 495         else
 496         {
 497                 //dstream<<"m_time_per_range="<<m_time_per_range<<std::endl;
 498         }
 499
 500         f32 wanted_range_change = wanted_frametime_change / m_time_per_range;
 501         // Dampen the change a bit to kill oscillations
 502         //wanted_range_change *= 0.9;
 503         //wanted_range_change *= 0.75;
 504         wanted_range_change *= 0.5;
 505         //dstream<<"wanted_range_change="<<wanted_range_change<<std::endl;
 506
 507         // If needed range change is very small, just return
 508         if(fabs(wanted_range_change) < 0.001)
 509         {
 510                 //dstream<<"ignoring small wanted_range_change"<<std::endl;
 511                 return;
 512         }
 513
 514         new_range += wanted_range_change;
 515
 516         //f32 new_range_unclamped = new_range;
 517         new_range = MYMAX(new_range, viewing_range_min);
 518         new_range = MYMIN(new_range, viewing_range_max);
 519         /*dstream<<"new_range="<<new_range_unclamped
 520                         <<", clamped to "<<new_range<<std::endl;*/
 521
 522         m_draw_control.wanted_range = new_range;
 523
 524         m_range_old = new_range;
 525         m_frametime_old = frametime;
 526 }
 527
 528 void Camera::setDigging(s32 button)
 529 {
 530         if (m_digging_button == -1)
 531                 m_digging_button = button;
 532 }
 533
 534 void Camera::wield(const ItemStack &item)
 535 {
 536         IItemDefManager *idef = m_gamedef->idef();
 537         scene::IMesh *wield_mesh = idef->getWieldMesh(item.getDefinition(idef).name, m_gamedef);
 538         if(wield_mesh)
 539         {
 540                 m_wieldnode->setMesh(wield_mesh);
 541                 m_wieldnode->setVisible(true);
 542         }
 543         else
 544         {
 545                 m_wieldnode->setVisible(false);
 546         }
 547 }
 548
 549 void Camera::drawWieldedTool()
 550 {
 551         // Set vertex colors of wield mesh according to light level
 552         u8 li = m_wieldlight;
 553         video::SColor color(255,li,li,li);
 554         setMeshColor(m_wieldnode->getMesh(), color);
 555
 556         // Clear Z buffer
 557         m_wieldmgr->getVideoDriver()->clearZBuffer();
 558
 559         // Draw the wielded node (in a separate scene manager)
 560         scene::ICameraSceneNode* cam = m_wieldmgr->getActiveCamera();
 561         cam->setAspectRatio(m_cameranode->getAspectRatio());
 562         cam->setFOV(72.0*M_PI/180.0);
 563         cam->setNearValue(0.1);
 564         cam->setFarValue(100);
 565         m_wieldmgr->drawAll();
 566 }