gecko-dev/gfx/layers/AxisPhysicsMSDModel.h
Daniel Holbert 126bd9e1a4 Bug 1412427 part 8: (automated patch) Switch a bunch of C++ files in gfx to use our standard mode lines. r=jrmuizel
This patch was generated automatically by the "modeline.py" script, available
here: https://github.com/amccreight/moz-source-tools/blob/master/modeline.py

For every file that is modified in this patch, the changes are as follows:
 (1) The patch changes the file to use the exact C++ mode lines from the
     Mozilla coding style guide, available here:
https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Coding_Style#Mode_Line

 (2) The patch deletes any blank lines between the mode line & the MPL
     boilerplate comment.

 (3) If the file previously had the mode lines and MPL boilerplate in a
     single contiguous C++ comment, then the patch splits them into
     separate C++ comments, to match the boilerplate in the coding style.

MozReview-Commit-ID: 77D61xpSmIl

--HG--
extra : rebase_source : c6162fa3cf539a07177a19838324bf368faa162b
2017-10-27 16:10:06 -07:00

87 lines
2.3 KiB
C++

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_layers_AxisPhysicsMSDModel_h
#define mozilla_layers_AxisPhysicsMSDModel_h
#include "AxisPhysicsModel.h"
namespace mozilla {
namespace layers {
/**
* AxisPhysicsMSDModel encapsulates a 1-dimensional MSD (Mass-Spring-Damper)
* model. A unit mass is assumed.
*/
class AxisPhysicsMSDModel : public AxisPhysicsModel {
public:
AxisPhysicsMSDModel(double aInitialPosition, double aInitialDestination,
double aInitialVelocity, double aSpringConstant,
double aDampingRatio);
~AxisPhysicsMSDModel();
/**
* Gets the raw destination of this axis at this moment.
*/
double GetDestination() const;
/**
* Sets the raw destination of this axis at this moment.
*/
void SetDestination(double aDestination);
/**
* Returns true when the position is close to the destination and the
* velocity is low.
*/
bool IsFinished(double aSmallestVisibleIncrement);
protected:
virtual double Acceleration(const State &aState);
private:
/**
* mDestination represents the target position and the resting position of
* the simulated spring.
*/
double mDestination;
/**
* Greater values of mSpringConstant result in a stiffer / stronger spring.
*/
double mSpringConstant;
/**
* mSpringConstantSqrtTimesTwo is calculated from mSpringConstant to reduce
* calculations performed in the inner loop.
*/
double mSpringConstantSqrtXTwo;
/**
* Damping Ratio: http://en.wikipedia.org/wiki/Damping_ratio
*
* When mDampingRatio < 1.0, this is an under damped system.
* - Overshoots destination and oscillates with the amplitude gradually
* decreasing to zero.
*
* When mDampingRatio == 1.0, this is a critically damped system.
* - Reaches destination as quickly as possible without oscillating.
*
* When mDampingRatio > 1.0, this is an over damped system.
* - Reaches destination (exponentially decays) without oscillating.
*/
double mDampingRatio;
};
} // namespace layers
} // namespace mozilla
#endif