From 805a74c074d6edda6b00216b3c39c1e8c316d1e6 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Thu, 20 Apr 2017 13:21:38 -0400
Subject: [PATCH 001/135] First-pass attempt at remedying the smoothing issue
 (the avatar is never receiving the proper call).

---
 interface/src/avatar/Avatar.cpp | 12 ++++++++----
 interface/src/avatar/Avatar.h   |  2 +-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/interface/src/avatar/Avatar.cpp b/interface/src/avatar/Avatar.cpp
index 5b996a3cdf..b6095f76d3 100644
--- a/interface/src/avatar/Avatar.cpp
+++ b/interface/src/avatar/Avatar.cpp
@@ -358,7 +358,9 @@ void Avatar::simulate(float deltaTime, bool inView) {
                 );
                 updateAttitude();
             }
-        }
+		} else if (AvatarData::getPosition() != _smoothPositionTarget) {
+			setPosition(AvatarData::getPosition());
+		}
 
         if (_smoothOrientationTimer < _smoothOrientationTime) {
             // Smooth the remote avatar movement.
@@ -371,7 +373,9 @@ void Avatar::simulate(float deltaTime, bool inView) {
                 );
                 updateAttitude();
             }
-        }
+        } else if (AvatarData::getOrientation() != _smoothOrientationTarget) {
+			setOrientation(AvatarData::getOrientation());
+		}
     }
 
     PerformanceTimer perfTimer("simulate");
@@ -1386,7 +1390,7 @@ void Avatar::setPosition(const glm::vec3& position) {
     }
 
     // Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-    _smoothPositionInitial = getPosition();
+    _smoothPositionInitial = AvatarData::getPosition();
     _smoothPositionTarget = position;
     _smoothPositionTimer = 0.0f;
 }
@@ -1400,7 +1404,7 @@ void Avatar::setOrientation(const glm::quat& orientation) {
     }
 
     // Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-    _smoothOrientationInitial = getOrientation();
+	_smoothOrientationInitial = AvatarData::getOrientation();
     _smoothOrientationTarget = orientation;
     _smoothOrientationTimer = 0.0f;
 }
diff --git a/interface/src/avatar/Avatar.h b/interface/src/avatar/Avatar.h
index 8c055885fd..fa7ca59d54 100644
--- a/interface/src/avatar/Avatar.h
+++ b/interface/src/avatar/Avatar.h
@@ -253,7 +253,7 @@ protected:
     friend class AvatarManager;
 
     const float SMOOTH_TIME_POSITION = 0.125f;
-    const float SMOOTH_TIME_ORIENTATION = 0.075f;
+    const float SMOOTH_TIME_ORIENTATION = 0.15f;
 
     virtual const QString& getSessionDisplayNameForTransport() const override { return _empty; } // Save a tiny bit of bandwidth. Mixer won't look at what we send.
     QString _empty{};

From b00cd66a2a40047a540b1f368dd399ef8a915fc4 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Fri, 21 Apr 2017 22:36:11 -0400
Subject: [PATCH 002/135] Revisited where smoothing was done (to a much
 lower-level); still needs testing.

---
 interface/src/avatar/Avatar.cpp            | 68 ++--------------------
 interface/src/avatar/Avatar.h              | 23 --------
 interface/src/ui/overlays/ModelOverlay.cpp | 61 ++++++++++++++++---
 interface/src/ui/overlays/ModelOverlay.h   | 27 ++++++++-
 4 files changed, 86 insertions(+), 93 deletions(-)

diff --git a/interface/src/avatar/Avatar.cpp b/interface/src/avatar/Avatar.cpp
index b6095f76d3..63d2459390 100644
--- a/interface/src/avatar/Avatar.cpp
+++ b/interface/src/avatar/Avatar.cpp
@@ -85,14 +85,6 @@ Avatar::Avatar(QThread* thread, RigPointer rig) :
     _lastOrientation(),
     _worldUpDirection(DEFAULT_UP_DIRECTION),
     _moving(false),
-    _smoothPositionTime(SMOOTH_TIME_POSITION),
-    _smoothPositionTimer(std::numeric_limits<float>::max()),
-    _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
-    _smoothOrientationTimer(std::numeric_limits<float>::max()),
-    _smoothPositionInitial(),
-    _smoothPositionTarget(),
-    _smoothOrientationInitial(),
-    _smoothOrientationTarget(),
     _initialized(false),
     _voiceSphereID(GeometryCache::UNKNOWN_ID)
 {
@@ -346,38 +338,6 @@ void Avatar::simulate(float deltaTime, bool inView) {
         _simulationInViewRate.increment();
     }
 
-    if (!isMyAvatar()) {
-        if (_smoothPositionTimer < _smoothPositionTime) {
-            // Smooth the remote avatar movement.
-            _smoothPositionTimer += deltaTime;
-            if (_smoothPositionTimer < _smoothPositionTime) {
-                AvatarData::setPosition(
-                    lerp(_smoothPositionInitial, 
-                        _smoothPositionTarget,
-                        easeInOutQuad(glm::clamp(_smoothPositionTimer / _smoothPositionTime, 0.0f, 1.0f)))
-                );
-                updateAttitude();
-            }
-		} else if (AvatarData::getPosition() != _smoothPositionTarget) {
-			setPosition(AvatarData::getPosition());
-		}
-
-        if (_smoothOrientationTimer < _smoothOrientationTime) {
-            // Smooth the remote avatar movement.
-            _smoothOrientationTimer += deltaTime;
-            if (_smoothOrientationTimer < _smoothOrientationTime) {
-                AvatarData::setOrientation(
-                    slerp(_smoothOrientationInitial, 
-                        _smoothOrientationTarget,
-                        easeInOutQuad(glm::clamp(_smoothOrientationTimer / _smoothOrientationTime, 0.0f, 1.0f)))
-                );
-                updateAttitude();
-            }
-        } else if (AvatarData::getOrientation() != _smoothOrientationTarget) {
-			setOrientation(AvatarData::getOrientation());
-		}
-    }
-
     PerformanceTimer perfTimer("simulate");
     {
         PROFILE_RANGE(simulation, "updateJoints");
@@ -1382,31 +1342,15 @@ glm::quat Avatar::getUncachedRightPalmRotation() const {
 }
 
 void Avatar::setPosition(const glm::vec3& position) {
-    if (isMyAvatar()) {
-        // This is the local avatar, no need to handle any position smoothing.
-        AvatarData::setPosition(position);
-        updateAttitude();
-        return;
-    }
-
-    // Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-    _smoothPositionInitial = AvatarData::getPosition();
-    _smoothPositionTarget = position;
-    _smoothPositionTimer = 0.0f;
+    // This is the local avatar, no need to handle any position smoothing.
+    AvatarData::setPosition(position);
+    updateAttitude();
 }
 
 void Avatar::setOrientation(const glm::quat& orientation) {
-    if (isMyAvatar()) {
-        // This is the local avatar, no need to handle any position smoothing.
-        AvatarData::setOrientation(orientation);
-        updateAttitude();
-        return;
-    }
-
-    // Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-	_smoothOrientationInitial = AvatarData::getOrientation();
-    _smoothOrientationTarget = orientation;
-    _smoothOrientationTimer = 0.0f;
+    // This is the local avatar, no need to handle any position smoothing.
+    AvatarData::setOrientation(orientation);
+    updateAttitude();
 }
 
 void Avatar::updatePalms() {
diff --git a/interface/src/avatar/Avatar.h b/interface/src/avatar/Avatar.h
index fa7ca59d54..80aec18119 100644
--- a/interface/src/avatar/Avatar.h
+++ b/interface/src/avatar/Avatar.h
@@ -228,16 +228,6 @@ public:
 
     bool hasNewJointData() const { return _hasNewJointData; }
 
-    inline float easeInOutQuad(float lerpValue) {
-        assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
-
-        if (lerpValue < 0.5f) {
-            return (2.0f * lerpValue * lerpValue);
-        }
-
-        return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
-    }
-
 public slots:
 
     // FIXME - these should be migrated to use Pose data instead
@@ -252,9 +242,6 @@ public slots:
 protected:
     friend class AvatarManager;
 
-    const float SMOOTH_TIME_POSITION = 0.125f;
-    const float SMOOTH_TIME_ORIENTATION = 0.15f;
-
     virtual const QString& getSessionDisplayNameForTransport() const override { return _empty; } // Save a tiny bit of bandwidth. Mixer won't look at what we send.
     QString _empty{};
     virtual void maybeUpdateSessionDisplayNameFromTransport(const QString& sessionDisplayName) override { _sessionDisplayName = sessionDisplayName; } // don't use no-op setter!
@@ -324,16 +311,6 @@ protected:
     RateCounter<> _skeletonModelSimulationRate;
     RateCounter<> _jointDataSimulationRate;
 
-    // Smoothing data for blending from one position/orientation to another on remote agents.
-    float _smoothPositionTime;
-    float _smoothPositionTimer;
-    float _smoothOrientationTime;
-    float _smoothOrientationTimer;
-    glm::vec3 _smoothPositionInitial;
-    glm::vec3 _smoothPositionTarget;
-    glm::quat _smoothOrientationInitial;
-    glm::quat _smoothOrientationTarget;
-
 private:
     class AvatarEntityDataHash {
     public:
diff --git a/interface/src/ui/overlays/ModelOverlay.cpp b/interface/src/ui/overlays/ModelOverlay.cpp
index ccaa1d4fbc..97ee9f2aef 100644
--- a/interface/src/ui/overlays/ModelOverlay.cpp
+++ b/interface/src/ui/overlays/ModelOverlay.cpp
@@ -18,8 +18,16 @@
 QString const ModelOverlay::TYPE = "model";
 
 ModelOverlay::ModelOverlay()
-    : _model(std::make_shared<Model>(std::make_shared<Rig>(), nullptr, this)),
-      _modelTextures(QVariantMap())
+	: _smoothPositionTime(SMOOTH_TIME_POSITION),
+	 _smoothPositionTimer(std::numeric_limits<float>::max()),
+	 _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
+	 _smoothOrientationTimer(std::numeric_limits<float>::max()),
+	 _smoothPositionInitial(),
+	 _smoothPositionTarget(),
+	 _smoothOrientationInitial(),
+	 _smoothOrientationTarget(), 
+	 _model(std::make_shared<Model>(std::make_shared<Rig>(), nullptr, this)),
+	 _modelTextures(QVariantMap())
 {
     _model->init();
     _isLoaded = false;
@@ -40,6 +48,35 @@ ModelOverlay::ModelOverlay(const ModelOverlay* modelOverlay) :
 }
 
 void ModelOverlay::update(float deltatime) {
+	if (_model && _model->isActive()) {
+		_model->setRotation(getRotation());
+		_model->setTranslation(getPosition());
+
+        if (_smoothPositionTimer < _smoothPositionTime) {
+            // Smooth the remote avatar movement.
+            _smoothPositionTimer+= deltatime;
+            if (_smoothPositionTimer < _smoothPositionTime) {
+				_model->setTranslation(
+                    lerp(_smoothPositionInitial, 
+                        _smoothPositionTarget,
+                        easeInOutQuad(glm::clamp(_smoothPositionTimer / _smoothPositionTime, 0.0f, 1.0f)))
+                );
+            }
+		}
+
+        if (_smoothOrientationTimer < _smoothOrientationTime) {
+            // Smooth the remote avatar movement.
+            _smoothOrientationTimer+= deltatime;
+            if (_smoothOrientationTimer < _smoothOrientationTime) {
+				_model->setRotation(
+                    slerp(_smoothOrientationInitial, 
+                        _smoothOrientationTarget,
+                        easeInOutQuad(glm::clamp(_smoothOrientationTimer / _smoothOrientationTime, 0.0f, 1.0f)))
+                );
+            }
+        }
+	}
+
     if (_updateModel) {
         _updateModel = false;
         _model->setSnapModelToCenter(true);
@@ -173,8 +210,18 @@ ModelOverlay* ModelOverlay::createClone() const {
 void ModelOverlay::locationChanged(bool tellPhysics) {
     Base3DOverlay::locationChanged(tellPhysics);
 
-    if (_model && _model->isActive()) {
-        _model->setRotation(getRotation());
-        _model->setTranslation(getPosition());
-    }
-}
+	if (!_model || !_model->isActive()) {
+		// If it's not active, don't care about it.
+		return;
+	}
+
+	// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
+	_smoothPositionInitial = _model->getTranslation();
+	_smoothPositionTarget = getPosition();
+	_smoothPositionTimer = 0.0f;
+
+	// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
+	_smoothOrientationInitial = _model->getRotation();
+	_smoothOrientationTarget = getRotation();
+	_smoothOrientationTimer = 0.0f;
+}
\ No newline at end of file
diff --git a/interface/src/ui/overlays/ModelOverlay.h b/interface/src/ui/overlays/ModelOverlay.h
index a3ddeed480..01861497a0 100644
--- a/interface/src/ui/overlays/ModelOverlay.h
+++ b/interface/src/ui/overlays/ModelOverlay.h
@@ -39,7 +39,32 @@ public:
     virtual bool addToScene(Overlay::Pointer overlay, const render::ScenePointer& scene, render::Transaction& transaction) override;
     virtual void removeFromScene(Overlay::Pointer overlay, const render::ScenePointer& scene, render::Transaction& transaction) override;
 
-    void locationChanged(bool tellPhysics) override;
+	void locationChanged(bool tellPhysics = true) override;
+
+	// Basic ease-in-ease-out function for smoothing values.
+	inline float easeInOutQuad(float lerpValue) {
+		assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
+
+		if (lerpValue < 0.5f) {
+			return (2.0f * lerpValue * lerpValue);
+		}
+
+		return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
+	}
+
+protected:
+	const float SMOOTH_TIME_POSITION = 0.125f;
+	const float SMOOTH_TIME_ORIENTATION = 0.15f;
+
+	// Smoothing data for blending from one position/orientation to another on remote agents.
+	float _smoothPositionTime;
+	float _smoothPositionTimer;
+	float _smoothOrientationTime;
+	float _smoothOrientationTimer;
+	glm::vec3 _smoothPositionInitial;
+	glm::vec3 _smoothPositionTarget;
+	glm::quat _smoothOrientationInitial;
+	glm::quat _smoothOrientationTarget;
 
 private:
 

From 41cd0d79b29f1ac7ff4f7a11f463b960cbe6e598 Mon Sep 17 00:00:00 2001
From: Atlante45 <clement.brisset@gmail.com>
Date: Mon, 10 Apr 2017 17:24:58 -0700
Subject: [PATCH 003/135] Set max packet per second on the agent

---
 assignment-client/src/Agent.cpp                    | 1 +
 assignment-client/src/scripts/EntityScriptServer.h | 3 ---
 libraries/script-engine/src/ScriptEngine.h         | 2 ++
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/assignment-client/src/Agent.cpp b/assignment-client/src/Agent.cpp
index 46e826c596..7a25605d6a 100644
--- a/assignment-client/src/Agent.cpp
+++ b/assignment-client/src/Agent.cpp
@@ -56,6 +56,7 @@ Agent::Agent(ReceivedMessage& message) :
     ThreadedAssignment(message),
     _receivedAudioStream(RECEIVED_AUDIO_STREAM_CAPACITY_FRAMES, RECEIVED_AUDIO_STREAM_CAPACITY_FRAMES)
 {
+    _entityEditSender.setPacketsPerSecond(DEFAULT_ENTITY_PPS_PER_SCRIPT);
     DependencyManager::get<EntityScriptingInterface>()->setPacketSender(&_entityEditSender);
 
     ResourceManager::init();
diff --git a/assignment-client/src/scripts/EntityScriptServer.h b/assignment-client/src/scripts/EntityScriptServer.h
index a468e62958..709c47503b 100644
--- a/assignment-client/src/scripts/EntityScriptServer.h
+++ b/assignment-client/src/scripts/EntityScriptServer.h
@@ -24,9 +24,6 @@
 #include <ScriptEngine.h>
 #include <ThreadedAssignment.h>
 
-static const int DEFAULT_MAX_ENTITY_PPS = 9000;
-static const int DEFAULT_ENTITY_PPS_PER_SCRIPT = 900;
-
 class EntityScriptServer : public ThreadedAssignment {
     Q_OBJECT
 
diff --git a/libraries/script-engine/src/ScriptEngine.h b/libraries/script-engine/src/ScriptEngine.h
index 5ea8d052e9..671a24e000 100644
--- a/libraries/script-engine/src/ScriptEngine.h
+++ b/libraries/script-engine/src/ScriptEngine.h
@@ -48,6 +48,8 @@ class QScriptEngineDebugger;
 static const QString NO_SCRIPT("");
 
 static const int SCRIPT_FPS = 60;
+static const int DEFAULT_MAX_ENTITY_PPS = 9000;
+static const int DEFAULT_ENTITY_PPS_PER_SCRIPT = 900;
 
 class CallbackData {
 public:

From 53f47c132f61715221096c0aa234e9e6dd375ded Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Thu, 27 Apr 2017 16:12:25 -0400
Subject: [PATCH 004/135] Avatar snap-turn rotation smoothing (sent out from
 the local client outward).

---
 interface/src/avatar/MyAvatar.cpp    | 15 ++++++++++++++-
 libraries/avatars/src/AvatarData.cpp | 17 ++++++++++++++++-
 libraries/avatars/src/AvatarData.h   | 21 +++++++++++++++++++++
 3 files changed, 51 insertions(+), 2 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index f4f078c9e5..6300df1634 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -375,6 +375,10 @@ void MyAvatar::update(float deltaTime) {
     float tau = deltaTime / HMD_FACING_TIMESCALE;
     _hmdSensorFacingMovingAverage = lerp(_hmdSensorFacingMovingAverage, _hmdSensorFacing, tau);
 
+	if (_smoothOrientationTimer < _smoothOrientationTime) {
+		_smoothOrientationTimer = min(_smoothOrientationTimer + deltaTime, _smoothOrientationTime);
+	}
+
 #ifdef DEBUG_DRAW_HMD_MOVING_AVERAGE
     glm::vec3 p = transformPoint(getSensorToWorldMatrix(), _hmdSensorPosition + glm::vec3(_hmdSensorFacingMovingAverage.x, 0.0f, _hmdSensorFacingMovingAverage.y));
     DebugDraw::getInstance().addMarker("facing-avg", getOrientation(), p, glm::vec4(1.0f));
@@ -1742,8 +1746,10 @@ void MyAvatar::updateOrientation(float deltaTime) {
     // Comfort Mode: If you press any of the left/right rotation drive keys or input, you'll
     // get an instantaneous 15 degree turn. If you keep holding the key down you'll get another
     // snap turn every half second.
+	bool snapTurn = false;
     if (getDriveKey(STEP_YAW) != 0.0f) {
         totalBodyYaw += getDriveKey(STEP_YAW);
+		snapTurn = true;
     }
 
     // use head/HMD orientation to turn while flying
@@ -1776,10 +1782,17 @@ void MyAvatar::updateOrientation(float deltaTime) {
         totalBodyYaw += (speedFactor * deltaAngle * (180.0f / PI));
     }
 
-
     // update body orientation by movement inputs
+	glm::quat initialOrientation = getOrientation();
     setOrientation(getOrientation() * glm::quat(glm::radians(glm::vec3(0.0f, totalBodyYaw, 0.0f))));
 
+	if (snapTurn) {
+		// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
+		_smoothOrientationInitial = initialOrientation;
+		_smoothOrientationTarget = getOrientation();
+		_smoothOrientationTimer = 0.0f;
+	}
+
     getHead()->setBasePitch(getHead()->getBasePitch() + getDriveKey(PITCH) * _pitchSpeed * deltaTime);
 
     if (qApp->isHMDMode()) {
diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 20894104ff..a38c269831 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -67,7 +67,11 @@ AvatarData::AvatarData() :
     _displayNameAlpha(1.0f),
     _errorLogExpiry(0),
     _owningAvatarMixer(),
-    _targetVelocity(0.0f)
+    _targetVelocity(0.0f),
+	_smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
+	_smoothOrientationTimer(std::numeric_limits<float>::max()),
+	_smoothOrientationInitial(),
+	_smoothOrientationTarget()
 {
     setBodyPitch(0.0f);
     setBodyYaw(-90.0f);
@@ -1460,6 +1464,17 @@ void AvatarData::parseAvatarIdentityPacket(const QByteArray& data, Identity& ide
     packetStream >> identityOut.uuid >> identityOut.skeletonModelURL >> identityOut.attachmentData >> identityOut.displayName >> identityOut.sessionDisplayName >> identityOut.avatarEntityData;
 }
 
+glm::quat AvatarData::getLocalOrientation() const {
+	if (!isMyAvatar() || (_smoothOrientationTimer > _smoothOrientationTime)) {
+		return (SpatiallyNestable::getLocalOrientation());
+	}
+
+	// Smooth the remote avatar movement.
+	float t = _smoothOrientationTimer / _smoothOrientationTime;
+	float l = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
+	return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, l));
+}
+
 static const QUrl emptyURL("");
 QUrl AvatarData::cannonicalSkeletonModelURL(const QUrl& emptyURL) const {
     // We don't put file urls on the wire, but instead convert to empty.
diff --git a/libraries/avatars/src/AvatarData.h b/libraries/avatars/src/AvatarData.h
index 8319eb5249..b68de2397b 100644
--- a/libraries/avatars/src/AvatarData.h
+++ b/libraries/avatars/src/AvatarData.h
@@ -603,6 +603,9 @@ public:
 
     bool shouldDie() const { return _owningAvatarMixer.isNull() || getUsecsSinceLastUpdate() > AVATAR_UPDATE_TIMEOUT; }
 
+	// Overload the local orientation function for this.
+	virtual glm::quat getLocalOrientation() const override;
+
     static const float OUT_OF_VIEW_PENALTY;
 
     static void sortAvatars(
@@ -619,7 +622,16 @@ public:
     static float _avatarSortCoefficientCenter;
     static float _avatarSortCoefficientAge;
 
+	// Basic ease-in-ease-out function for smoothing values.
+	static inline float easeInOutQuad(float lerpValue) {
+		assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
 
+		if (lerpValue < 0.5f) {
+			return (2.0f * lerpValue * lerpValue);
+		}
+
+		return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
+	}
 
 signals:
     void displayNameChanged();
@@ -778,6 +790,15 @@ protected:
     quint64 _audioLoudnessChanged { 0 };
     float _audioAverageLoudness { 0.0f };
 
+	// Smoothing.
+	const float SMOOTH_TIME_ORIENTATION = 0.15f;
+
+	// Smoothing data for blending from one position/orientation to another on remote agents.
+	float _smoothOrientationTime;
+	float _smoothOrientationTimer;
+	glm::quat _smoothOrientationInitial;
+	glm::quat _smoothOrientationTarget;
+
 private:
     friend void avatarStateFromFrame(const QByteArray& frameData, AvatarData* _avatar);
     static QUrl _defaultFullAvatarModelUrl;

From d446640bc8803db5d9fd474775ae80ff2ed5ae80 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Mon, 1 May 2017 13:28:26 -0400
Subject: [PATCH 005/135] Fixed tab issues.

---
 libraries/avatars/src/AvatarData.cpp | 22 +++++++--------
 libraries/avatars/src/AvatarData.h   | 40 ++++++++++++++--------------
 2 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index a74bcaf189..52a2849ac4 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -68,10 +68,10 @@ AvatarData::AvatarData() :
     _errorLogExpiry(0),
     _owningAvatarMixer(),
     _targetVelocity(0.0f),
-	_smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
-	_smoothOrientationTimer(std::numeric_limits<float>::max()),
-	_smoothOrientationInitial(),
-	_smoothOrientationTarget()
+    _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
+    _smoothOrientationTimer(std::numeric_limits<float>::max()),
+    _smoothOrientationInitial(),
+    _smoothOrientationTarget()
 {
     setBodyPitch(0.0f);
     setBodyYaw(-90.0f);
@@ -1496,14 +1496,14 @@ void AvatarData::parseAvatarIdentityPacket(const QByteArray& data, Identity& ide
 }
 
 glm::quat AvatarData::getLocalOrientation() const {
-	if (!isMyAvatar() || (_smoothOrientationTimer > _smoothOrientationTime)) {
-		return (SpatiallyNestable::getLocalOrientation());
-	}
+    if (!isMyAvatar() || (_smoothOrientationTimer > _smoothOrientationTime)) {
+        return (SpatiallyNestable::getLocalOrientation());
+    }
 
-	// Smooth the remote avatar movement.
-	float t = _smoothOrientationTimer / _smoothOrientationTime;
-	float l = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
-	return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, l));
+    // Smooth the remote avatar movement.
+    float t = _smoothOrientationTimer / _smoothOrientationTime;
+    float l = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
+    return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, l));
 }
 
 static const QUrl emptyURL("");
diff --git a/libraries/avatars/src/AvatarData.h b/libraries/avatars/src/AvatarData.h
index a18af4ea38..278d150259 100644
--- a/libraries/avatars/src/AvatarData.h
+++ b/libraries/avatars/src/AvatarData.h
@@ -602,10 +602,10 @@ public:
         return _lastSentJointData;
     }
 
-	// Overload the local orientation function for this.
-	virtual glm::quat getLocalOrientation() const override;
+    // Overload the local orientation function for this.
+    virtual glm::quat getLocalOrientation() const override;
 
-	static const float OUT_OF_VIEW_PENALTY;
+    static const float OUT_OF_VIEW_PENALTY;
 
     static void sortAvatars(
         QList<AvatarSharedPointer> avatarList,
@@ -621,18 +621,18 @@ public:
     static float _avatarSortCoefficientCenter;
     static float _avatarSortCoefficientAge;
 
-	// Basic ease-in-ease-out function for smoothing values.
-	static inline float easeInOutQuad(float lerpValue) {
-		assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
+    // Basic ease-in-ease-out function for smoothing values.
+    static inline float easeInOutQuad(float lerpValue) {
+        assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
 
-		if (lerpValue < 0.5f) {
-			return (2.0f * lerpValue * lerpValue);
-		}
+        if (lerpValue < 0.5f) {
+            return (2.0f * lerpValue * lerpValue);
+        }
 
-		return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
-	}
+        return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
+    }
 
-	bool getIdentityDataChanged() const { return _identityDataChanged; } // has the identity data changed since the last time sendIdentityPacket() was called
+    bool getIdentityDataChanged() const { return _identityDataChanged; } // has the identity data changed since the last time sendIdentityPacket() was called
     void markIdentityDataChanged() {
         _identityDataChanged = true;
         _identityUpdatedAt = usecTimestampNow();
@@ -795,16 +795,16 @@ protected:
     quint64 _audioLoudnessChanged { 0 };
     float _audioAverageLoudness { 0.0f };
 
-	// Smoothing.
-	const float SMOOTH_TIME_ORIENTATION = 0.15f;
+    // Smoothing.
+    const float SMOOTH_TIME_ORIENTATION = 0.15f;
 
-	// Smoothing data for blending from one position/orientation to another on remote agents.
-	float _smoothOrientationTime;
-	float _smoothOrientationTimer;
-	glm::quat _smoothOrientationInitial;
-	glm::quat _smoothOrientationTarget;
+    // Smoothing data for blending from one position/orientation to another on remote agents.
+    float _smoothOrientationTime;
+    float _smoothOrientationTimer;
+    glm::quat _smoothOrientationInitial;
+    glm::quat _smoothOrientationTarget;
 
-	bool _identityDataChanged { false };
+    bool _identityDataChanged { false };
     quint64 _identityUpdatedAt { 0 };
 
 private:

From 4d7eeed343a4122d2df885e5fb854eaf8325d164 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Mon, 1 May 2017 15:21:25 -0400
Subject: [PATCH 006/135] Marking MyAvatar's rotation as dirty if smoothing is
 going down.

---
 interface/src/avatar/MyAvatar.cpp        | 1 +
 libraries/shared/src/SpatiallyNestable.h | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index d42c153505..e71d3cc920 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -376,6 +376,7 @@ void MyAvatar::update(float deltaTime) {
     _hmdSensorFacingMovingAverage = lerp(_hmdSensorFacingMovingAverage, _hmdSensorFacing, tau);
 
 	if (_smoothOrientationTimer < _smoothOrientationTime) {
+		rotationForceChange();
 		_smoothOrientationTimer = min(_smoothOrientationTimer + deltaTime, _smoothOrientationTime);
 	}
 
diff --git a/libraries/shared/src/SpatiallyNestable.h b/libraries/shared/src/SpatiallyNestable.h
index 820c8685d7..08dd75b0ac 100644
--- a/libraries/shared/src/SpatiallyNestable.h
+++ b/libraries/shared/src/SpatiallyNestable.h
@@ -183,6 +183,8 @@ public:
     bool tranlationChangedSince(quint64 time) const { return _translationChanged > time; }
     bool rotationChangedSince(quint64 time) const { return _rotationChanged > time; }
 
+	inline void rotationForceChange() { _rotationChanged = usecTimestampNow(); }
+
 protected:
     const NestableType _nestableType; // EntityItem or an AvatarData
     QUuid _id;

From 8f34ec4c7ff647a26423cc5c9f05627edbd45571 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Tue, 2 May 2017 13:41:34 -0400
Subject: [PATCH 007/135] Iteration on the snap-turn smoothing based on
 feedback from Andrew. Also additional cleanup.

---
 interface/src/avatar/Avatar.cpp            |  2 -
 interface/src/avatar/Avatar.h              |  1 -
 interface/src/avatar/MyAvatar.cpp          |  6 ++-
 interface/src/avatar/MyAvatar.h            | 20 ++++++++
 interface/src/ui/overlays/ModelOverlay.cpp | 55 +---------------------
 interface/src/ui/overlays/ModelOverlay.h   | 27 -----------
 libraries/avatars/src/AvatarData.cpp       | 17 ++-----
 libraries/avatars/src/AvatarData.h         | 24 +---------
 libraries/shared/src/SpatiallyNestable.h   |  2 -
 9 files changed, 32 insertions(+), 122 deletions(-)

diff --git a/interface/src/avatar/Avatar.cpp b/interface/src/avatar/Avatar.cpp
index 032a91dc3e..7483048e6a 100644
--- a/interface/src/avatar/Avatar.cpp
+++ b/interface/src/avatar/Avatar.cpp
@@ -1361,13 +1361,11 @@ glm::quat Avatar::getUncachedRightPalmRotation() const {
 }
 
 void Avatar::setPosition(const glm::vec3& position) {
-    // This is the local avatar, no need to handle any position smoothing.
     AvatarData::setPosition(position);
     updateAttitude();
 }
 
 void Avatar::setOrientation(const glm::quat& orientation) {
-    // This is the local avatar, no need to handle any position smoothing.
     AvatarData::setOrientation(orientation);
     updateAttitude();
 }
diff --git a/interface/src/avatar/Avatar.h b/interface/src/avatar/Avatar.h
index 181865adcd..be055c495b 100644
--- a/interface/src/avatar/Avatar.h
+++ b/interface/src/avatar/Avatar.h
@@ -34,7 +34,6 @@ namespace render {
 }
 
 static const float SCALING_RATIO = .05f;
-static const float SMOOTHING_RATIO = .05f; // 0 < ratio < 1
 
 extern const float CHAT_MESSAGE_SCALE;
 extern const float CHAT_MESSAGE_HEIGHT;
diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index de8a9e46b4..2043a6b9b6 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -117,6 +117,10 @@ MyAvatar::MyAvatar(QThread* thread, RigPointer rig) :
     _realWorldFieldOfView("realWorldFieldOfView",
                           DEFAULT_REAL_WORLD_FIELD_OF_VIEW_DEGREES),
     _useAdvancedMovementControls("advancedMovementForHandControllersIsChecked", false),
+    _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
+    _smoothOrientationTimer(std::numeric_limits<float>::max()),
+    _smoothOrientationInitial(),
+    _smoothOrientationTarget(),
     _hmdSensorMatrix(),
     _hmdSensorOrientation(),
     _hmdSensorPosition(),
@@ -388,7 +392,7 @@ void MyAvatar::update(float deltaTime) {
     _hmdSensorFacingMovingAverage = lerp(_hmdSensorFacingMovingAverage, _hmdSensorFacing, tau);
 
 	if (_smoothOrientationTimer < _smoothOrientationTime) {
-		rotationForceChange();
+        _rotationChanged = true;
 		_smoothOrientationTimer = min(_smoothOrientationTimer + deltaTime, _smoothOrientationTime);
 	}
 
diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index 6a1e457a97..1d26a2f3f9 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -577,6 +577,17 @@ private:
 
     void setVisibleInSceneIfReady(Model* model, const render::ScenePointer& scene, bool visiblity);
 
+    // Basic ease-in-ease-out function for smoothing values.
+    static inline float easeInOutQuad(float lerpValue) {
+        assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
+
+        if (lerpValue < 0.5f) {
+            return (2.0f * lerpValue * lerpValue);
+        }
+
+        return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
+    }
+
 private:
 
     virtual void updatePalms() override {}
@@ -626,6 +637,15 @@ private:
     Setting::Handle<float> _realWorldFieldOfView;
     Setting::Handle<bool> _useAdvancedMovementControls;
 
+    // Smoothing.
+    const float SMOOTH_TIME_ORIENTATION = 0.15f;
+
+    // Smoothing data for blending from one position/orientation to another on remote agents.
+    float _smoothOrientationTime;
+    float _smoothOrientationTimer;
+    glm::quat _smoothOrientationInitial;
+    glm::quat _smoothOrientationTarget;
+
     // private methods
     void updateOrientation(float deltaTime);
     void updateActionMotor(float deltaTime);
diff --git a/interface/src/ui/overlays/ModelOverlay.cpp b/interface/src/ui/overlays/ModelOverlay.cpp
index 0a05efa3bf..6043e22978 100644
--- a/interface/src/ui/overlays/ModelOverlay.cpp
+++ b/interface/src/ui/overlays/ModelOverlay.cpp
@@ -18,16 +18,8 @@
 QString const ModelOverlay::TYPE = "model";
 
 ModelOverlay::ModelOverlay()
-	: _smoothPositionTime(SMOOTH_TIME_POSITION),
-	 _smoothPositionTimer(std::numeric_limits<float>::max()),
-	 _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
-	 _smoothOrientationTimer(std::numeric_limits<float>::max()),
-	 _smoothPositionInitial(),
-	 _smoothPositionTarget(),
-	 _smoothOrientationInitial(),
-	 _smoothOrientationTarget(), 
-	 _model(std::make_shared<Model>(std::make_shared<Rig>(), nullptr, this)),
-	 _modelTextures(QVariantMap())
+	: _model(std::make_shared<Model>(std::make_shared<Rig>(), nullptr, this)),
+      _modelTextures(QVariantMap())
 {
     _model->init();
     _isLoaded = false;
@@ -51,30 +43,6 @@ void ModelOverlay::update(float deltatime) {
 	if (_model && _model->isActive()) {
 		_model->setRotation(getRotation());
 		_model->setTranslation(getPosition());
-
-        if (_smoothPositionTimer < _smoothPositionTime) {
-            // Smooth the remote avatar movement.
-            _smoothPositionTimer+= deltatime;
-            if (_smoothPositionTimer < _smoothPositionTime) {
-				_model->setTranslation(
-                    lerp(_smoothPositionInitial, 
-                        _smoothPositionTarget,
-                        easeInOutQuad(glm::clamp(_smoothPositionTimer / _smoothPositionTime, 0.0f, 1.0f)))
-                );
-            }
-		}
-
-        if (_smoothOrientationTimer < _smoothOrientationTime) {
-            // Smooth the remote avatar movement.
-            _smoothOrientationTimer+= deltatime;
-            if (_smoothOrientationTimer < _smoothOrientationTime) {
-				_model->setRotation(
-                    slerp(_smoothOrientationInitial, 
-                        _smoothOrientationTarget,
-                        easeInOutQuad(glm::clamp(_smoothOrientationTimer / _smoothOrientationTime, 0.0f, 1.0f)))
-                );
-            }
-        }
 	}
 
     if (_updateModel) {
@@ -306,23 +274,4 @@ bool ModelOverlay::findRayIntersectionExtraInfo(const glm::vec3& origin, const g
 
 ModelOverlay* ModelOverlay::createClone() const {
     return new ModelOverlay(this);
-}
-
-void ModelOverlay::locationChanged(bool tellPhysics) {
-    Base3DOverlay::locationChanged(tellPhysics);
-
-	if (!_model || !_model->isActive()) {
-		// If it's not active, don't care about it.
-		return;
-	}
-
-	// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-	_smoothPositionInitial = _model->getTranslation();
-	_smoothPositionTarget = getPosition();
-	_smoothPositionTimer = 0.0f;
-
-	// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-	_smoothOrientationInitial = _model->getRotation();
-	_smoothOrientationTarget = getRotation();
-	_smoothOrientationTimer = 0.0f;
 }
\ No newline at end of file
diff --git a/interface/src/ui/overlays/ModelOverlay.h b/interface/src/ui/overlays/ModelOverlay.h
index 4a73c42d7e..6991a11bb2 100644
--- a/interface/src/ui/overlays/ModelOverlay.h
+++ b/interface/src/ui/overlays/ModelOverlay.h
@@ -39,33 +39,6 @@ public:
     virtual bool addToScene(Overlay::Pointer overlay, const render::ScenePointer& scene, render::Transaction& transaction) override;
     virtual void removeFromScene(Overlay::Pointer overlay, const render::ScenePointer& scene, render::Transaction& transaction) override;
 
-	void locationChanged(bool tellPhysics = true) override;
-
-	// Basic ease-in-ease-out function for smoothing values.
-	inline float easeInOutQuad(float lerpValue) {
-		assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
-
-		if (lerpValue < 0.5f) {
-			return (2.0f * lerpValue * lerpValue);
-		}
-
-		return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
-	}
-
-protected:
-	const float SMOOTH_TIME_POSITION = 0.125f;
-	const float SMOOTH_TIME_ORIENTATION = 0.15f;
-
-	// Smoothing data for blending from one position/orientation to another on remote agents.
-	float _smoothPositionTime;
-	float _smoothPositionTimer;
-	float _smoothOrientationTime;
-	float _smoothOrientationTimer;
-	glm::vec3 _smoothPositionInitial;
-	glm::vec3 _smoothPositionTarget;
-	glm::quat _smoothOrientationInitial;
-	glm::quat _smoothOrientationTarget;
-
 protected:
     // helper to extract metadata from our Model's rigged joints
     template <typename itemType> using mapFunction = std::function<itemType(int jointIndex)>;
diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index a8856d2da1..3c88ee0749 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -67,11 +67,7 @@ AvatarData::AvatarData() :
     _displayNameAlpha(1.0f),
     _errorLogExpiry(0),
     _owningAvatarMixer(),
-    _targetVelocity(0.0f),
-    _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
-    _smoothOrientationTimer(std::numeric_limits<float>::max()),
-    _smoothOrientationInitial(),
-    _smoothOrientationTarget()
+    _targetVelocity(0.0f)
 {
     setBodyPitch(0.0f);
     setBodyYaw(-90.0f);
@@ -1495,15 +1491,8 @@ void AvatarData::parseAvatarIdentityPacket(const QByteArray& data, Identity& ide
 
 }
 
-glm::quat AvatarData::getLocalOrientation() const {
-    if (!isMyAvatar() || (_smoothOrientationTimer > _smoothOrientationTime)) {
-        return (SpatiallyNestable::getLocalOrientation());
-    }
-
-    // Smooth the remote avatar movement.
-    float t = _smoothOrientationTimer / _smoothOrientationTime;
-    float l = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
-    return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, l));
+glm::quat AvatarData::getOrientationOutbound() const {
+	return (getLocalOrientation());
 }
 
 static const QUrl emptyURL("");
diff --git a/libraries/avatars/src/AvatarData.h b/libraries/avatars/src/AvatarData.h
index 4fbbd84792..2959d47347 100644
--- a/libraries/avatars/src/AvatarData.h
+++ b/libraries/avatars/src/AvatarData.h
@@ -602,8 +602,8 @@ public:
         return _lastSentJointData;
     }
 
-    // Overload the local orientation function for this.
-    virtual glm::quat getLocalOrientation() const override;
+    // A method intended to be overriden by MyAvatar for polling orientation for network transmission.
+    virtual glm::quat getOrientationOutbound() const;
 
     static const float OUT_OF_VIEW_PENALTY;
 
@@ -621,17 +621,6 @@ public:
     static float _avatarSortCoefficientCenter;
     static float _avatarSortCoefficientAge;
 
-    // Basic ease-in-ease-out function for smoothing values.
-    static inline float easeInOutQuad(float lerpValue) {
-        assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
-
-        if (lerpValue < 0.5f) {
-            return (2.0f * lerpValue * lerpValue);
-        }
-
-        return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
-    }
-
     bool getIdentityDataChanged() const { return _identityDataChanged; } // has the identity data changed since the last time sendIdentityPacket() was called
     void markIdentityDataChanged() {
         _identityDataChanged = true;
@@ -795,15 +784,6 @@ protected:
     quint64 _audioLoudnessChanged { 0 };
     float _audioAverageLoudness { 0.0f };
 
-    // Smoothing.
-    const float SMOOTH_TIME_ORIENTATION = 0.15f;
-
-    // Smoothing data for blending from one position/orientation to another on remote agents.
-    float _smoothOrientationTime;
-    float _smoothOrientationTimer;
-    glm::quat _smoothOrientationInitial;
-    glm::quat _smoothOrientationTarget;
-
     bool _identityDataChanged { false };
     quint64 _identityUpdatedAt { 0 };
 
diff --git a/libraries/shared/src/SpatiallyNestable.h b/libraries/shared/src/SpatiallyNestable.h
index 08dd75b0ac..820c8685d7 100644
--- a/libraries/shared/src/SpatiallyNestable.h
+++ b/libraries/shared/src/SpatiallyNestable.h
@@ -183,8 +183,6 @@ public:
     bool tranlationChangedSince(quint64 time) const { return _translationChanged > time; }
     bool rotationChangedSince(quint64 time) const { return _rotationChanged > time; }
 
-	inline void rotationForceChange() { _rotationChanged = usecTimestampNow(); }
-
 protected:
     const NestableType _nestableType; // EntityItem or an AvatarData
     QUuid _id;

From 49881b5ea24f8cae93d60cd4323e00a9d94f6b79 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Tue, 2 May 2017 13:55:32 -0400
Subject: [PATCH 008/135] Actually the full set of changes. Kids: don't forget
 to pop your stash.

---
 interface/src/avatar/MyAvatar.cpp    | 11 +++++++++++
 interface/src/avatar/MyAvatar.h      |  2 ++
 libraries/avatars/src/AvatarData.cpp |  2 +-
 3 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 2043a6b9b6..98afdb56c0 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -268,6 +268,17 @@ QVariant MyAvatar::getOrientationVar() const {
     return quatToVariant(Avatar::getOrientation());
 }
 
+glm::quat MyAvatar::getOrientationOutbound() const {
+    // Allows MyAvatar to send out smoothed data to remote agents if required.
+    if (_smoothOrientationTimer > _smoothOrientationTime) {
+        return (getLocalOrientation());
+    }
+
+    // Smooth the remote avatar movement.
+    float t = _smoothOrientationTimer / _smoothOrientationTime;
+    float l = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
+    return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, l));
+}
 
 // virtual
 void MyAvatar::simulateAttachments(float deltaTime) {
diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index 1d26a2f3f9..c69359cc4c 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -187,6 +187,8 @@ public:
     Q_INVOKABLE void setOrientationVar(const QVariant& newOrientationVar);
     Q_INVOKABLE QVariant getOrientationVar() const;
 
+    // A method intended to be overriden by MyAvatar for polling orientation for network transmission.
+    virtual glm::quat getOrientationOutbound() const override;
 
     // Pass a recent sample of the HMD to the avatar.
     // This can also update the avatar's position to follow the HMD
diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 3c88ee0749..7eedbcd216 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -312,7 +312,7 @@ QByteArray AvatarData::toByteArray(AvatarDataDetail dataDetail, quint64 lastSent
 
     if (hasAvatarOrientation) {
         auto startSection = destinationBuffer;
-        auto localOrientation = getLocalOrientation();
+        auto localOrientation = getOrientationOutbound();
         destinationBuffer += packOrientationQuatToSixBytes(destinationBuffer, localOrientation);
 
         int numBytes = destinationBuffer - startSection;

From f79e032841bb01e65a1294318ca4a8ce7f24ecc7 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Tue, 2 May 2017 14:48:27 -0400
Subject: [PATCH 009/135] Silly online git merge tool. You are silly. Errors
 fixed.

---
 interface/src/avatar/Avatar.h | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/interface/src/avatar/Avatar.h b/interface/src/avatar/Avatar.h
index 1adc83a9f4..867ccde68c 100644
--- a/interface/src/avatar/Avatar.h
+++ b/interface/src/avatar/Avatar.h
@@ -234,6 +234,18 @@ public:
 
     bool hasNewJointData() const { return _hasNewJointData; }
 
+    float getBoundingRadius() const;
+    
+    void addToScene(AvatarSharedPointer self, const render::ScenePointer& scene);
+    void ensureInScene(AvatarSharedPointer self, const render::ScenePointer& scene);
+    bool isInScene() const { return render::Item::isValidID(_renderItemID); }
+    bool isMoving() const { return _moving; }
+
+    //void setMotionState(AvatarMotionState* motionState);
+    void setPhysicsCallback(AvatarPhysicsCallback cb);
+    void addPhysicsFlags(uint32_t flags);
+    bool isInPhysicsSimulation() const { return _physicsCallback != nullptr; }
+
 public slots:
 
     // FIXME - these should be migrated to use Pose data instead

From 0a5dfbb9af15bf2373eff2070903826d074bdf0a Mon Sep 17 00:00:00 2001
From: Trent Polack <trent@joy-machine.com>
Date: Tue, 2 May 2017 19:10:33 -0400
Subject: [PATCH 010/135] Changed l to interp.

In my defense, if anyone ever looked at it and thought the 'l' was a '1', they should never be programming unless they used a special language where you could reassign numbers.
---
 interface/src/avatar/MyAvatar.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 98afdb56c0..29848da89d 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -276,8 +276,8 @@ glm::quat MyAvatar::getOrientationOutbound() const {
 
     // Smooth the remote avatar movement.
     float t = _smoothOrientationTimer / _smoothOrientationTime;
-    float l = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
-    return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, l));
+    float interp = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
+    return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, interp));
 }
 
 // virtual

From 557a8fffd77615655babf9861b5a5142681c4d85 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Tue, 2 May 2017 19:56:36 -0400
Subject: [PATCH 011/135] Addressing some PR feedback; moved easeInEaseOut to
 Interpolate class. My function is faster than andrew's. :D

---
 interface/src/avatar/MyAvatar.cpp          |  6 +++---
 interface/src/avatar/MyAvatar.h            | 11 -----------
 interface/src/ui/overlays/ModelOverlay.cpp | 18 +++++++++++-------
 interface/src/ui/overlays/ModelOverlay.h   |  2 ++
 libraries/shared/src/Interpolate.cpp       | 10 ++++++++++
 libraries/shared/src/Interpolate.h         |  3 +++
 6 files changed, 29 insertions(+), 21 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 29848da89d..970ef51aad 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -276,7 +276,7 @@ glm::quat MyAvatar::getOrientationOutbound() const {
 
     // Smooth the remote avatar movement.
     float t = _smoothOrientationTimer / _smoothOrientationTime;
-    float interp = easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
+    float interp = Interpolate::easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
     return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, interp));
 }
 
@@ -1863,13 +1863,13 @@ void MyAvatar::updateOrientation(float deltaTime) {
     }
 
     // update body orientation by movement inputs
-	glm::quat initialOrientation = getOrientation();
+    glm::quat initialOrientation = getOrientationOutbound();
     setOrientation(getOrientation() * glm::quat(glm::radians(glm::vec3(0.0f, totalBodyYaw, 0.0f))));
 
 	if (snapTurn) {
 		// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
 		_smoothOrientationInitial = initialOrientation;
-		_smoothOrientationTarget = getOrientation();
+        _smoothOrientationTarget = getOrientation();
 		_smoothOrientationTimer = 0.0f;
 	}
 
diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index c69359cc4c..abcfbe865d 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -579,17 +579,6 @@ private:
 
     void setVisibleInSceneIfReady(Model* model, const render::ScenePointer& scene, bool visiblity);
 
-    // Basic ease-in-ease-out function for smoothing values.
-    static inline float easeInOutQuad(float lerpValue) {
-        assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
-
-        if (lerpValue < 0.5f) {
-            return (2.0f * lerpValue * lerpValue);
-        }
-
-        return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
-    }
-
 private:
 
     virtual void updatePalms() override {}
diff --git a/interface/src/ui/overlays/ModelOverlay.cpp b/interface/src/ui/overlays/ModelOverlay.cpp
index 6043e22978..e993166558 100644
--- a/interface/src/ui/overlays/ModelOverlay.cpp
+++ b/interface/src/ui/overlays/ModelOverlay.cpp
@@ -18,7 +18,7 @@
 QString const ModelOverlay::TYPE = "model";
 
 ModelOverlay::ModelOverlay()
-	: _model(std::make_shared<Model>(std::make_shared<Rig>(), nullptr, this)),
+    : _model(std::make_shared<Model>(std::make_shared<Rig>(), nullptr, this)),
       _modelTextures(QVariantMap())
 {
     _model->init();
@@ -40,11 +40,6 @@ ModelOverlay::ModelOverlay(const ModelOverlay* modelOverlay) :
 }
 
 void ModelOverlay::update(float deltatime) {
-	if (_model && _model->isActive()) {
-		_model->setRotation(getRotation());
-		_model->setTranslation(getPosition());
-	}
-
     if (_updateModel) {
         _updateModel = false;
         _model->setSnapModelToCenter(true);
@@ -274,4 +269,13 @@ bool ModelOverlay::findRayIntersectionExtraInfo(const glm::vec3& origin, const g
 
 ModelOverlay* ModelOverlay::createClone() const {
     return new ModelOverlay(this);
-}
\ No newline at end of file
+}
+
+void ModelOverlay::locationChanged(bool tellPhysics) {
+    Base3DOverlay::locationChanged(tellPhysics);
+
+    if (_model && _model->isActive()) {
+        _model->setRotation(getRotation());
+        _model->setTranslation(getPosition());
+    }
+}
diff --git a/interface/src/ui/overlays/ModelOverlay.h b/interface/src/ui/overlays/ModelOverlay.h
index 6991a11bb2..8afe9a20b6 100644
--- a/interface/src/ui/overlays/ModelOverlay.h
+++ b/interface/src/ui/overlays/ModelOverlay.h
@@ -39,6 +39,8 @@ public:
     virtual bool addToScene(Overlay::Pointer overlay, const render::ScenePointer& scene, render::Transaction& transaction) override;
     virtual void removeFromScene(Overlay::Pointer overlay, const render::ScenePointer& scene, render::Transaction& transaction) override;
 
+    void locationChanged(bool tellPhysics) override;
+
 protected:
     // helper to extract metadata from our Model's rigged joints
     template <typename itemType> using mapFunction = std::function<itemType(int jointIndex)>;
diff --git a/libraries/shared/src/Interpolate.cpp b/libraries/shared/src/Interpolate.cpp
index ba93a21a8e..35c164f0f2 100644
--- a/libraries/shared/src/Interpolate.cpp
+++ b/libraries/shared/src/Interpolate.cpp
@@ -77,3 +77,13 @@ float Interpolate::calculateFadeRatio(quint64 start) {
     const float EASING_SCALE = 1.001f;
     return std::min(EASING_SCALE * fadeRatio, 1.0f);
 }
+
+float Interpolate::easeInOutQuad(float lerpValue) {
+    assert(!((lerpValue < 0.0f) || (lerpValue > 1.0f)));
+
+    if (lerpValue < 0.5f) {
+        return (2.0f * lerpValue * lerpValue);
+    }
+
+    return (lerpValue*(4.0f - 2.0f * lerpValue) - 1.0f);
+}
\ No newline at end of file
diff --git a/libraries/shared/src/Interpolate.h b/libraries/shared/src/Interpolate.h
index 79ebd2f7fc..fca6a40b61 100644
--- a/libraries/shared/src/Interpolate.h
+++ b/libraries/shared/src/Interpolate.h
@@ -30,6 +30,9 @@ public:
     static float simpleNonLinearBlend(float fraction);
 
     static float calculateFadeRatio(quint64 start);
+
+    // Basic ease-in-ease-out function for smoothing values.
+    static float easeInOutQuad(float lerpValue);
 };
 
 #endif // hifi_Interpolate_h

From 24f2678cdd17818084300525c41d8a6abbe7ee82 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Wed, 3 May 2017 12:05:21 -0400
Subject: [PATCH 012/135] Adjusted the smooth time for the snap-turn remote
 view. Fixed tab issue.

---
 interface/src/avatar/MyAvatar.cpp | 6 +++---
 interface/src/avatar/MyAvatar.h   | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 970ef51aad..5dd29136e4 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -1868,10 +1868,10 @@ void MyAvatar::updateOrientation(float deltaTime) {
 
 	if (snapTurn) {
 		// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
-		_smoothOrientationInitial = initialOrientation;
+        _smoothOrientationInitial = initialOrientation;
         _smoothOrientationTarget = getOrientation();
-		_smoothOrientationTimer = 0.0f;
-	}
+        _smoothOrientationTimer = 0.0f;
+    }
 
     getHead()->setBasePitch(getHead()->getBasePitch() + getDriveKey(PITCH) * _pitchSpeed * deltaTime);
 
diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index abcfbe865d..afe7fd017a 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -629,7 +629,7 @@ private:
     Setting::Handle<bool> _useAdvancedMovementControls;
 
     // Smoothing.
-    const float SMOOTH_TIME_ORIENTATION = 0.15f;
+    const float SMOOTH_TIME_ORIENTATION = 0.5f;
 
     // Smoothing data for blending from one position/orientation to another on remote agents.
     float _smoothOrientationTime;

From fc3cce6b738590aae6bd6026fcd6d3bb4c21f648 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Wed, 3 May 2017 12:35:35 -0400
Subject: [PATCH 013/135] Fixed the silly and stupid subtle issue that was
 causing the bug in inconsistencies.

---
 interface/src/avatar/MyAvatar.cpp | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 5dd29136e4..2f112924f4 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -404,7 +404,12 @@ void MyAvatar::update(float deltaTime) {
 
 	if (_smoothOrientationTimer < _smoothOrientationTime) {
         _rotationChanged = true;
-		_smoothOrientationTimer = min(_smoothOrientationTimer + deltaTime, _smoothOrientationTime);
+		_smoothOrientationTimer+= deltaTime;
+
+        if (_smoothOrientationTimer >= _smoothOrientationTime) {
+            // Take it back to astronomical value land.
+            _smoothOrientationTimer = std::numeric_limits<float>::max();
+        }
 	}
 
 #ifdef DEBUG_DRAW_HMD_MOVING_AVERAGE

From d7ed727faf586024878cb50d47a8373f2277411e Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Wed, 3 May 2017 16:56:18 -0400
Subject: [PATCH 014/135] Adjustments based on PR feedback, though it looks
 like this snap-turn-snafu-story is not yet complete.

---
 interface/src/avatar/MyAvatar.cpp | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 2f112924f4..4926368f4d 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -117,7 +117,6 @@ MyAvatar::MyAvatar(QThread* thread, RigPointer rig) :
     _realWorldFieldOfView("realWorldFieldOfView",
                           DEFAULT_REAL_WORLD_FIELD_OF_VIEW_DEGREES),
     _useAdvancedMovementControls("advancedMovementForHandControllersIsChecked", false),
-    _smoothOrientationTime(SMOOTH_TIME_ORIENTATION),
     _smoothOrientationTimer(std::numeric_limits<float>::max()),
     _smoothOrientationInitial(),
     _smoothOrientationTarget(),
@@ -270,12 +269,12 @@ QVariant MyAvatar::getOrientationVar() const {
 
 glm::quat MyAvatar::getOrientationOutbound() const {
     // Allows MyAvatar to send out smoothed data to remote agents if required.
-    if (_smoothOrientationTimer > _smoothOrientationTime) {
+    if (_smoothOrientationTimer > SMOOTH_TIME_ORIENTATION) {
         return (getLocalOrientation());
     }
 
     // Smooth the remote avatar movement.
-    float t = _smoothOrientationTimer / _smoothOrientationTime;
+    float t = _smoothOrientationTimer / SMOOTH_TIME_ORIENTATION;
     float interp = Interpolate::easeInOutQuad(glm::clamp(t, 0.0f, 1.0f));
     return (slerp(_smoothOrientationInitial, _smoothOrientationTarget, interp));
 }
@@ -402,14 +401,9 @@ void MyAvatar::update(float deltaTime) {
     float tau = deltaTime / HMD_FACING_TIMESCALE;
     _hmdSensorFacingMovingAverage = lerp(_hmdSensorFacingMovingAverage, _hmdSensorFacing, tau);
 
-	if (_smoothOrientationTimer < _smoothOrientationTime) {
+    if (_smoothOrientationTimer < SMOOTH_TIME_ORIENTATION) {
         _rotationChanged = true;
 		_smoothOrientationTimer+= deltaTime;
-
-        if (_smoothOrientationTimer >= _smoothOrientationTime) {
-            // Take it back to astronomical value land.
-            _smoothOrientationTimer = std::numeric_limits<float>::max();
-        }
 	}
 
 #ifdef DEBUG_DRAW_HMD_MOVING_AVERAGE

From 40908fb1a31bd884f87e21c4e524275f8334471b Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Thu, 4 May 2017 19:21:37 +0100
Subject: [PATCH 015/135] create a smoke texture

---
 interface/resources/images/Smoke.png | Bin 0 -> 131940 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 interface/resources/images/Smoke.png

diff --git a/interface/resources/images/Smoke.png b/interface/resources/images/Smoke.png
new file mode 100644
index 0000000000000000000000000000000000000000..d1b4d8cac9be3a6c7e0bf3f935e09c74d2df2703
GIT binary patch
literal 131940
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
O0000<MNUMnLSTaF9Fffc

literal 0
HcmV?d00001


From 0d21d7108e35f7f26708d8cb2109005aec88bfd9 Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Thu, 4 May 2017 19:27:43 +0100
Subject: [PATCH 016/135] change default particle properties

---
 scripts/system/edit.js | 62 +++++++++++++++++++++++++++++++-----------
 1 file changed, 46 insertions(+), 16 deletions(-)

diff --git a/scripts/system/edit.js b/scripts/system/edit.js
index a6d2d165f7..10f876999a 100644
--- a/scripts/system/edit.js
+++ b/scripts/system/edit.js
@@ -309,7 +309,7 @@ var toolBar = (function () {
                     gravity: dynamic ? { x: 0, y: -10, z: 0 } : { x: 0, y: 0, z: 0 }
                 });
             }
-        }        
+        }
     }
 
     function fromQml(message) { // messages are {method, params}, like json-rpc. See also sendToQml.
@@ -482,22 +482,52 @@ var toolBar = (function () {
             createNewEntity({
                 type: "ParticleEffect",
                 isEmitting: true,
+                emitterShouldTrail: true,
+                color: {
+                    red: 200,
+                    green: 200,
+                    blue: 200
+                },
+              colorSpread: {
+                    red: 0,
+                    green: 0,
+                    blue: 0
+                },
+                colorStart: {
+                    red: 200,
+                    green: 200,
+                    blue: 200
+                },
+                colorFinish: {
+                    red: 0,
+                    green: 0,
+                    blue: 0
+                },
                 emitAcceleration: {
-                    x: 0,
-                    y: -1,
-                    z: 0
+                    x: 0.5,
+                    y: 1.5,
+                    z: 0.5
                 },
                 accelerationSpread: {
-                    x: 5,
-                    y: 0,
-                    z: 5
+                    x: 1.0,
+                    y: 0.0,
+                    z: 1.0
                 },
-                emitSpeed: 1,
+                emitRate: 10,
+                emitSpeed: 2,
+                speedSpread: 0,
                 lifespan: 1,
-                particleRadius: 0.025,
+                maxParticles: 100,
+                particleRadius: 0.25,
+                radiusStart: 0.05,
+                radiusFinish: 0.25,
+                radiusSpread: 0.5,
+                alpha: 0,
+                alphaStart: 0.5,
                 alphaFinish: 0,
-                emitRate: 100,
-                textures: "https://hifi-public.s3.amazonaws.com/alan/Particles/Particle-Sprite-Smoke-1.png"
+                polarStart: 0,
+                polarFinish: 0,
+                textures: "https://raw.githubusercontent.com/Triplelexx/hifi/40908fb1a31bd884f87e21c4e524275f8334471b/interface/resources/images/Smoke.png"
             });
         });
 
@@ -656,7 +686,7 @@ function handleOverlaySelectionToolUpdates(channel, message, sender) {
         return;
 
     var data = JSON.parse(message);
-    
+
     if (data.method === "selectOverlay") {
         print("setting selection to overlay " + data.overlayID);
         var entity = entityIconOverlayManager.findEntity(data.overlayID);
@@ -664,7 +694,7 @@ function handleOverlaySelectionToolUpdates(channel, message, sender) {
         if (entity !== null) {
             selectionManager.setSelections([entity]);
         }
-    } 
+    }
 }
 
 Messages.subscribe("entityToolUpdates");
@@ -774,7 +804,7 @@ function wasTabletClicked(event) {
     var result = Overlays.findRayIntersection(rayPick, true, [HMD.tabletID, HMD.tabletScreenID, HMD.homeButtonID]);
     return result.intersects;
 }
-    
+
 function mouseClickEvent(event) {
     var wantDebug = false;
     var result, properties, tabletClicked;
@@ -784,7 +814,7 @@ function mouseClickEvent(event) {
         if (tabletClicked) {
             return;
         }
-        
+
         if (result === null || result === undefined) {
             if (!event.isShifted) {
                 selectionManager.clearSelections();
@@ -2062,7 +2092,7 @@ function selectParticleEntity(entityID) {
 
     selectedParticleEntity = entityID;
     particleExplorerTool.setActiveParticleEntity(entityID);
-    particleExplorerTool.webView.emitScriptEvent(JSON.stringify(particleData));    
+    particleExplorerTool.webView.emitScriptEvent(JSON.stringify(particleData));
 
     // Switch to particle explorer
     var tablet = Tablet.getTablet("com.highfidelity.interface.tablet.system");

From fae51c5c4652b2bb623168243968b0474f91c4a7 Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Sat, 6 May 2017 20:12:09 +0100
Subject: [PATCH 017/135] change default particle texture to production

---
 scripts/system/edit.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scripts/system/edit.js b/scripts/system/edit.js
index 10f876999a..28d7b89209 100644
--- a/scripts/system/edit.js
+++ b/scripts/system/edit.js
@@ -488,7 +488,7 @@ var toolBar = (function () {
                     green: 200,
                     blue: 200
                 },
-              colorSpread: {
+                colorSpread: {
                     red: 0,
                     green: 0,
                     blue: 0
@@ -527,7 +527,7 @@ var toolBar = (function () {
                 alphaFinish: 0,
                 polarStart: 0,
                 polarFinish: 0,
-                textures: "https://raw.githubusercontent.com/Triplelexx/hifi/40908fb1a31bd884f87e21c4e524275f8334471b/interface/resources/images/Smoke.png"
+                textures: "https://hifi-content.s3.amazonaws.com/DomainContent/production/Particles/Smoke.png"
             });
         });
 

From 03490c81da5a6a76f06f13e1341d44d4fcea9f5e Mon Sep 17 00:00:00 2001
From: Mike Moody <amvmoody@gmail.com>
Date: Sat, 6 May 2017 15:36:18 -0700
Subject: [PATCH 018/135] v1 with bug, looking into.

---
 .../system/libraries/entitySelectionTool.js   | 101 ++++++++++++++++--
 1 file changed, 94 insertions(+), 7 deletions(-)

diff --git a/scripts/system/libraries/entitySelectionTool.js b/scripts/system/libraries/entitySelectionTool.js
index 79d45d5cd2..70ded31ca4 100644
--- a/scripts/system/libraries/entitySelectionTool.js
+++ b/scripts/system/libraries/entitySelectionTool.js
@@ -340,6 +340,11 @@ SelectionDisplay = (function() {
         green: 120,
         blue: 120
     };
+    var grabberColorCloner = {
+        red: 0,
+        green: 155,
+        blue: 0
+    };
     var grabberLineWidth = 0.5;
     var grabberSolid = true;
     var grabberMoveUpPosition = {
@@ -405,6 +410,23 @@ SelectionDisplay = (function() {
         borderSize: 1.4,
     };
 
+    var grabberPropertiesCloner = {
+        position: {
+            x: 0,
+            y: 0,
+            z: 0
+        },
+        size: grabberSizeCorner + 0.025,
+        color: grabberColorCloner,
+        alpha: 1,
+        solid: grabberSolid,
+        visible: false,
+        dashed: false,
+        lineWidth: grabberLineWidth,
+        drawInFront: true,
+        borderSize: 1.4,
+    };
+
     var spotLightLineProperties = {
         color: lightOverlayColor,
         lineWidth: 1.5,
@@ -582,6 +604,8 @@ SelectionDisplay = (function() {
     var grabberPointLightF = Overlays.addOverlay("cube", grabberPropertiesEdge);
     var grabberPointLightN = Overlays.addOverlay("cube", grabberPropertiesEdge);
 
+    var grabberCloner = Overlays.addOverlay("cube", grabberPropertiesCloner);
+
     var stretchHandles = [
         grabberLBN,
         grabberRBN,
@@ -969,6 +993,9 @@ SelectionDisplay = (function() {
         grabberPointLightCircleX,
         grabberPointLightCircleY,
         grabberPointLightCircleZ,
+
+        grabberCloner
+
     ].concat(stretchHandles);
 
     overlayNames[highlightBox] = "highlightBox";
@@ -1015,7 +1042,7 @@ SelectionDisplay = (function() {
 
     overlayNames[rotateZeroOverlay] = "rotateZeroOverlay";
     overlayNames[rotateCurrentOverlay] = "rotateCurrentOverlay";
-
+    overlayNames[grabberCloner] = "grabberCloner";
     var activeTool = null;
     var grabberTools = {};
 
@@ -1107,7 +1134,7 @@ SelectionDisplay = (function() {
         if (event !== false) {
             pickRay = generalComputePickRay(event.x, event.y);
 
-            var wantDebug = false;
+            var wantDebug = true;
             if (wantDebug) {
                 print("select() with EVENT...... ");
                 print("                event.y:" + event.y);
@@ -2291,7 +2318,11 @@ SelectionDisplay = (function() {
             },
             rotation: Quat.fromPitchYawRollDegrees(90, 0, 0),
         });
-
+        Overlays.editOverlay(grabberCloner, {
+            visible: stretchHandlesVisible,
+            rotation: rotation,
+            position: RIGHT
+        });
 
     };
 
@@ -2371,7 +2402,7 @@ SelectionDisplay = (function() {
             return (origin.y - intersection.y) / Vec3.distance(origin, intersection);
         },
         onMove: function(event) {
-            var wantDebug = false;
+            var wantDebug = true;
             pickRay = generalComputePickRay(event.x, event.y);
 
             var pick = rayPlaneIntersection2(pickRay, translateXZTool.pickPlanePosition, {
@@ -2556,7 +2587,7 @@ SelectionDisplay = (function() {
             vector.x = 0;
             vector.z = 0;
 
-            var wantDebug = false;
+            var wantDebug = true;
             if (wantDebug) {
                 print("translateUpDown... ");
                 print("                event.y:" + event.y);
@@ -2580,6 +2611,52 @@ SelectionDisplay = (function() {
         },
     });
 
+    addGrabberTool(grabberCloner, {
+        mode: "CLONE",
+        pickPlanePosition: { x: 0, y: 0, z: 0 },
+        greatestDimension: 0.0,
+        startingDistance: 0.0,
+        startingElevation: 0.0,
+        onBegin: function(event) {
+            SelectionManager.saveProperties();
+            startPosition = SelectionManager.worldPosition;
+            var dimensions = SelectionManager.worldDimensions;
+
+            var pickRay = generalComputePickRay(event.x, event.y);
+            initialXZPick = rayPlaneIntersection(pickRay, translateXZTool.pickPlanePosition, {
+                x: 0,
+                y: 1,
+                z: 0
+            });
+
+            // Duplicate entities if alt is pressed.  This will make a
+            // copy of the selected entities and move the _original_ entities, not
+            // the new ones.
+
+                duplicatedEntityIDs = [];
+                for (var otherEntityID in SelectionManager.savedProperties) {
+                    var properties = SelectionManager.savedProperties[otherEntityID];
+                    if (!properties.locked) {
+                        var entityID = Entities.addEntity(properties);
+                        duplicatedEntityIDs.push({
+                            entityID: entityID,
+                            properties: properties,
+                        });
+                    }
+                }
+
+            isConstrained = false;
+        },
+        elevation: translateXZTool.elevation,
+
+        onEnd: translateXZTool.onEnd,
+
+        onMove: translateXZTool.onMove
+    });
+
+
+
+
     var vec3Mult = function(v1, v2) {
             return {
                 x: v1.x * v2.x,
@@ -2844,7 +2921,7 @@ SelectionDisplay = (function() {
                     });
                 }
 
-                var wantDebug = false;
+                var wantDebug = true;
                 if (wantDebug) {
                     print(stretchMode);
                     //Vec3.print("        newIntersection:", newIntersection);
@@ -3861,7 +3938,7 @@ SelectionDisplay = (function() {
     };
 
     that.mousePressEvent = function(event) {
-        var wantDebug = false;
+        var wantDebug = true;
         if (!event.isLeftButton && !that.triggered) {
             // if another mouse button than left is pressed ignore it
             return false;
@@ -3958,6 +4035,10 @@ SelectionDisplay = (function() {
                         mode = "STRETCH_LEFT";
                         somethingClicked = mode;
                         break;
+                    // case grabberCloner:
+                    //     mode = "CLONE";
+                    //     somethingClicked = mode;
+                    //     break;
 
                     default:
                         mode = "UNKNOWN";
@@ -4344,6 +4425,12 @@ SelectionDisplay = (function() {
                     highlightNeeded = true;
                     break;
 
+                case grabberCloner:
+                    pickedColor = grabberColorCloner;
+                    pickedAlpha = grabberAlpha;
+                    highlightNeeded = true;
+                    break;
+                    
                 default:
                     if (previousHandle) {
                         Overlays.editOverlay(previousHandle, {

From 1873558df15ec8d8bbbdcac7a275738469c1af10 Mon Sep 17 00:00:00 2001
From: Rob Kayson <rkayson@gmail.com>
Date: Sat, 6 May 2017 18:41:57 -0700
Subject: [PATCH 019/135] added floating lantern box that spawns floating
 lanterns

---
 scripts/tutorials/createFloatingLanternBox.js |  42 +++++++
 .../entity_scripts/floatingLantern.js         | 106 ++++++++++++++++++
 .../entity_scripts/floatingLanternBox.js      | 101 +++++++++++++++++
 3 files changed, 249 insertions(+)
 create mode 100644 scripts/tutorials/createFloatingLanternBox.js
 create mode 100644 scripts/tutorials/entity_scripts/floatingLantern.js
 create mode 100644 scripts/tutorials/entity_scripts/floatingLanternBox.js

diff --git a/scripts/tutorials/createFloatingLanternBox.js b/scripts/tutorials/createFloatingLanternBox.js
new file mode 100644
index 0000000000..611e995fcb
--- /dev/null
+++ b/scripts/tutorials/createFloatingLanternBox.js
@@ -0,0 +1,42 @@
+"use strict";
+/* jslint vars: true, plusplus: true, forin: true*/
+/* globals Tablet, Script, AvatarList, Users, Entities, MyAvatar, Camera, Overlays, Vec3, Quat, Controller, print, getControllerWorldLocation */
+/* eslint indent: ["error", 4, { "outerIIFEBody": 0 }] */
+//
+// createFloatinLanternBox.js
+//
+// Created by MrRoboman on 17/05/04
+// Copyright 2017 High Fidelity, Inc.
+//
+// Creates a crate that spawn floating lanterns
+//
+// Distributed under the Apache License, Version 2.0.
+// See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
+
+var COMPOUND_SHAPE_URL = "http://hifi-content.s3.amazonaws.com/Examples%20Content/production/maracas/woodenCrate_phys.obj";
+var MODEL_URL = "http://hifi-content.s3.amazonaws.com/Examples%20Content/production/maracas/woodenCrate_VR.fbx";
+var SCRIPT_URL = Script.resolvePath("./entity_scripts/floatingLanternBox.js?v=" + Date.now());
+var START_POSITION = Vec3.sum(MyAvatar.position, Vec3.multiply(Quat.getFront(MyAvatar.orientation), 2));
+START_POSITION.y -= .6;
+var LIFETIME = 3600;
+
+var lanternBox = {
+  type: "Model",
+  name: "Floating Lantern Box",
+  description: "Spawns Lanterns that float away when grabbed and released!",
+  script: SCRIPT_URL,
+  modelURL: MODEL_URL,
+  shapeType: "Compound",
+  compoundShapeURL: COMPOUND_SHAPE_URL,
+  position: START_POSITION,
+  lifetime: LIFETIME,
+  dimensions: {
+    x: 0.8696,
+    y: 0.58531,
+    z: 0.9264
+  },
+  owningAvatarID: MyAvatar.sessionUUID
+};
+
+Entities.addEntity(lanternBox);
+Script.stop();
diff --git a/scripts/tutorials/entity_scripts/floatingLantern.js b/scripts/tutorials/entity_scripts/floatingLantern.js
new file mode 100644
index 0000000000..8fa2828c90
--- /dev/null
+++ b/scripts/tutorials/entity_scripts/floatingLantern.js
@@ -0,0 +1,106 @@
+"use strict";
+/* jslint vars: true, plusplus: true, forin: true*/
+/* globals Tablet, Script, AvatarList, Users, Entities, MyAvatar, Camera, Overlays, Vec3, Quat, Controller, print, getControllerWorldLocation */
+/* eslint indent: ["error", 4, { "outerIIFEBody": 0 }] */
+//
+// floatinLantern.js
+//
+// Created by MrRoboman on 17/05/04
+// Copyright 2017 High Fidelity, Inc.
+//
+// Makes floating lanterns rise upon being released and corrects their rotation as the fly.
+//
+// Distributed under the Apache License, Version 2.0.
+// See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
+
+(function() {
+  var _this;
+
+  var SLOW_SPIN_THRESHOLD = 0.1;
+  var ROTATION_COMPLETE_THRESHOLD = 0.01;
+  var ROTATION_SPEED = 0.2;
+  var HOME_ROTATION = {x: 0, y: 0, z: 0, w: 0};
+
+
+  floatingLantern = function() {
+    _this = this;
+    this.updateConnected = false;
+  };
+
+  floatingLantern.prototype = {
+
+    preload: function(entityID) {
+      this.entityID = entityID;
+    },
+
+    unload: function(entityID) {
+      this.disconnectUpdate();
+    },
+
+    startNearGrab: function() {
+      this.disconnectUpdate();
+    },
+
+    startDistantGrab: function() {
+      this.disconnectUpdate();
+    },
+
+    releaseGrab: function() {
+      Entities.editEntity(this.entityID, {
+        gravity: {
+          x: 0,
+          y: 0.5,
+          z: 0
+        }
+      });
+    },
+
+    update: function(dt) {
+      var lanternProps = Entities.getEntityProperties(_this.entityID);
+
+      if(lanternProps && lanternProps.rotation && lanternProps.owningAvatarID === MyAvatar.sessionUUID) {
+
+        var spinningSlowly = (
+          Math.abs(lanternProps.angularVelocity.x) < SLOW_SPIN_THRESHOLD &&
+          Math.abs(lanternProps.angularVelocity.y) < SLOW_SPIN_THRESHOLD &&
+          Math.abs(lanternProps.angularVelocity.z) < SLOW_SPIN_THRESHOLD
+        );
+
+        var rotationComplete = (
+           Math.abs(lanternProps.rotation.x - HOME_ROTATION.x) < ROTATION_COMPLETE_THRESHOLD &&
+           Math.abs(lanternProps.rotation.y - HOME_ROTATION.y) < ROTATION_COMPLETE_THRESHOLD &&
+           Math.abs(lanternProps.rotation.z - HOME_ROTATION.z) < ROTATION_COMPLETE_THRESHOLD
+         );
+
+        if(spinningSlowly && !rotationComplete) {
+          var newRotation = Quat.slerp(lanternProps.rotation, HOME_ROTATION, ROTATION_SPEED * dt);
+
+          Entities.editEntity(_this.entityID, {
+            rotation: newRotation,
+            angularVelocity: {
+              x: 0,
+              y: 0,
+              z: 0
+            }
+          });
+        }
+      }
+    },
+
+    connectUpdate: function() {
+      if(!this.updateConnected) {
+        this.updateConnected = true;
+        Script.update.connect(this.update);
+      }
+    },
+
+    disconnectUpdate: function() {
+      if(this.updateConnected) {
+        this.updateConnected = false;
+        Script.update.disconnect(this.update);
+      }
+    }
+  };
+
+  return new floatingLantern();
+});
diff --git a/scripts/tutorials/entity_scripts/floatingLanternBox.js b/scripts/tutorials/entity_scripts/floatingLanternBox.js
new file mode 100644
index 0000000000..2c483f6129
--- /dev/null
+++ b/scripts/tutorials/entity_scripts/floatingLanternBox.js
@@ -0,0 +1,101 @@
+"use strict";
+/* jslint vars: true, plusplus: true, forin: true*/
+/* globals Tablet, Script, AvatarList, Users, Entities, MyAvatar, Camera, Overlays, Vec3, Quat, Controller, print, getControllerWorldLocation */
+/* eslint indent: ["error", 4, { "outerIIFEBody": 0 }] */
+//
+// floatingLanternBox.js
+//
+// Created by MrRoboman on 17/05/04
+// Copyright 2017 High Fidelity, Inc.
+//
+// Spawns new floating lanterns every couple seconds if the old ones have been removed.
+//
+// Distributed under the Apache License, Version 2.0.
+// See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
+
+(function() {
+
+  var _this;
+  var LANTERN_MODEL_URL = "http://hifi-content.s3.amazonaws.com/DomainContent/Welcome%20Area/Models/chinaLantern_capsule.fbx";
+  var LANTERN_SCRIPT_URL = Script.resolvePath("floatingLantern.js?v=" + Date.now());
+  var LIFETIME = 120;
+  var RESPAWN_INTERVAL = 1000;
+  var MAX_LANTERNS = 4;
+
+  var LANTERN = {
+      type: "Model",
+      name: "Floating Lantern",
+      description: "Spawns Lanterns that float away when grabbed and released!",
+      modelURL: LANTERN_MODEL_URL,
+      script: LANTERN_SCRIPT_URL,
+      dimensions: {
+          x: 0.2049,
+          y: 0.4,
+          z: 0.2049
+      },
+      gravity: {
+          x: 0,
+          y: -1,
+          z: 0
+      },
+      velocity: {
+        x: 0, y: .01, z: 0
+      },
+      linearDampening: 0,
+      shapeType: 'Box',
+      lifetime: LIFETIME,
+      dynamic: true
+  };
+
+  lanternBox = function() {
+    _this = this;
+  };
+
+  lanternBox.prototype = {
+
+    preload: function(entityID) {
+      this.entityID = entityID;
+      var props = Entities.getEntityProperties(this.entityID);
+
+      if(props.owningAvatarID === MyAvatar.sessionUUID){
+        this.respawnTimer = Script.setInterval(this.spawnAllLanterns.bind(this), RESPAWN_INTERVAL);
+      }
+    },
+
+    unload: function(entityID) {
+      if(this.respawnTimer)
+        Script.clearInterval(this.respawnTimer);
+    },
+
+    spawnAllLanterns: function() {
+      var props = Entities.getEntityProperties(this.entityID);
+      var lanternCount = 0;
+      var nearbyEntities = Entities.findEntities(props.position, props.dimensions.x * 0.75);
+
+      for(var i = 0; i < nearbyEntities.length; i++) {
+        var name = Entities.getEntityProperties(nearbyEntities[i], ["name"]).name;
+        if(name === "Floating Lantern") {
+          lanternCount++;
+        }
+      }
+
+      while(lanternCount++ < MAX_LANTERNS) {
+        this.spawnLantern();
+      }
+    },
+
+    spawnLantern: function() {
+      var boxProps = Entities.getEntityProperties(this.entityID);
+
+      LANTERN.position = boxProps.position;
+      LANTERN.position.x += Math.random() * .2 - .1;
+      LANTERN.position.y += Math.random() * .2 + .1;
+      LANTERN.position.z += Math.random() * .2 - .1;
+      LANTERN.owningAvatarID = boxProps.owningAvatarID;
+
+      return Entities.addEntity(LANTERN);
+    }
+  };
+
+  return new lanternBox();
+});

From dae652d3db31309f90bbbb63df61c9c1b692187f Mon Sep 17 00:00:00 2001
From: Mike Moody <amvmoody@gmail.com>
Date: Mon, 8 May 2017 11:25:24 -0700
Subject: [PATCH 020/135] v1 HMD duplication overlay.

---
 .../system/libraries/entitySelectionTool.js   | 70 +++++++------------
 1 file changed, 24 insertions(+), 46 deletions(-)

diff --git a/scripts/system/libraries/entitySelectionTool.js b/scripts/system/libraries/entitySelectionTool.js
index 70ded31ca4..3e4b8d8518 100644
--- a/scripts/system/libraries/entitySelectionTool.js
+++ b/scripts/system/libraries/entitySelectionTool.js
@@ -416,7 +416,7 @@ SelectionDisplay = (function() {
             y: 0,
             z: 0
         },
-        size: grabberSizeCorner + 0.025,
+        size: grabberSizeCorner,
         color: grabberColorCloner,
         alpha: 1,
         solid: grabberSolid,
@@ -652,6 +652,8 @@ SelectionDisplay = (function() {
         grabberPointLightR,
         grabberPointLightF,
         grabberPointLightN,
+
+        grabberCloner
     ];
 
 
@@ -994,8 +996,6 @@ SelectionDisplay = (function() {
         grabberPointLightCircleY,
         grabberPointLightCircleZ,
 
-        grabberCloner
-
     ].concat(stretchHandles);
 
     overlayNames[highlightBox] = "highlightBox";
@@ -1134,7 +1134,7 @@ SelectionDisplay = (function() {
         if (event !== false) {
             pickRay = generalComputePickRay(event.x, event.y);
 
-            var wantDebug = true;
+            var wantDebug = false;
             if (wantDebug) {
                 print("select() with EVENT...... ");
                 print("                event.y:" + event.y);
@@ -2355,7 +2355,7 @@ SelectionDisplay = (function() {
         greatestDimension: 0.0,
         startingDistance: 0.0,
         startingElevation: 0.0,
-        onBegin: function(event) {
+        onBegin: function(event,isAltFromGrab) {
             SelectionManager.saveProperties();
             startPosition = SelectionManager.worldPosition;
             var dimensions = SelectionManager.worldDimensions;
@@ -2370,7 +2370,7 @@ SelectionDisplay = (function() {
             // Duplicate entities if alt is pressed.  This will make a
             // copy of the selected entities and move the _original_ entities, not
             // the new ones.
-            if (event.isAlt) {
+            if (event.isAlt || isAltFromGrab) {
                 duplicatedEntityIDs = [];
                 for (var otherEntityID in SelectionManager.savedProperties) {
                     var properties = SelectionManager.savedProperties[otherEntityID];
@@ -2402,7 +2402,7 @@ SelectionDisplay = (function() {
             return (origin.y - intersection.y) / Vec3.distance(origin, intersection);
         },
         onMove: function(event) {
-            var wantDebug = true;
+            var wantDebug = false;
             pickRay = generalComputePickRay(event.x, event.y);
 
             var pick = rayPlaneIntersection2(pickRay, translateXZTool.pickPlanePosition, {
@@ -2587,7 +2587,7 @@ SelectionDisplay = (function() {
             vector.x = 0;
             vector.z = 0;
 
-            var wantDebug = true;
+            var wantDebug = false;
             if (wantDebug) {
                 print("translateUpDown... ");
                 print("                event.y:" + event.y);
@@ -2613,45 +2613,27 @@ SelectionDisplay = (function() {
 
     addGrabberTool(grabberCloner, {
         mode: "CLONE",
-        pickPlanePosition: { x: 0, y: 0, z: 0 },
-        greatestDimension: 0.0,
-        startingDistance: 0.0,
-        startingElevation: 0.0,
         onBegin: function(event) {
-            SelectionManager.saveProperties();
-            startPosition = SelectionManager.worldPosition;
-            var dimensions = SelectionManager.worldDimensions;
 
             var pickRay = generalComputePickRay(event.x, event.y);
-            initialXZPick = rayPlaneIntersection(pickRay, translateXZTool.pickPlanePosition, {
-                x: 0,
-                y: 1,
-                z: 0
-            });
+            var result = Overlays.findRayIntersection(pickRay);
+            translateXZTool.pickPlanePosition = result.intersection;
+            translateXZTool.greatestDimension = Math.max(Math.max(SelectionManager.worldDimensions.x, SelectionManager.worldDimensions.y),
+                SelectionManager.worldDimensions.z);
 
-            // Duplicate entities if alt is pressed.  This will make a
-            // copy of the selected entities and move the _original_ entities, not
-            // the new ones.
-
-                duplicatedEntityIDs = [];
-                for (var otherEntityID in SelectionManager.savedProperties) {
-                    var properties = SelectionManager.savedProperties[otherEntityID];
-                    if (!properties.locked) {
-                        var entityID = Entities.addEntity(properties);
-                        duplicatedEntityIDs.push({
-                            entityID: entityID,
-                            properties: properties,
-                        });
-                    }
-                }
-
-            isConstrained = false;
+            translateXZTool.onBegin(event,true);
+        },
+        elevation: function (event) {
+            translateXZTool.elevation(event);
         },
-        elevation: translateXZTool.elevation,
 
-        onEnd: translateXZTool.onEnd,
+        onEnd: function (event) {
+            translateXZTool.onEnd(event);
+        },
 
-        onMove: translateXZTool.onMove
+        onMove: function (event) {
+            translateXZTool.onMove(event);
+        }
     });
 
 
@@ -2921,7 +2903,7 @@ SelectionDisplay = (function() {
                     });
                 }
 
-                var wantDebug = true;
+                var wantDebug = false;
                 if (wantDebug) {
                     print(stretchMode);
                     //Vec3.print("        newIntersection:", newIntersection);
@@ -3938,7 +3920,7 @@ SelectionDisplay = (function() {
     };
 
     that.mousePressEvent = function(event) {
-        var wantDebug = true;
+        var wantDebug = false;
         if (!event.isLeftButton && !that.triggered) {
             // if another mouse button than left is pressed ignore it
             return false;
@@ -4035,10 +4017,6 @@ SelectionDisplay = (function() {
                         mode = "STRETCH_LEFT";
                         somethingClicked = mode;
                         break;
-                    // case grabberCloner:
-                    //     mode = "CLONE";
-                    //     somethingClicked = mode;
-                    //     break;
 
                     default:
                         mode = "UNKNOWN";

From 138a987a8fb43e51caaaca48c870ad0458ae40cb Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Mon, 8 May 2017 14:27:18 -0700
Subject: [PATCH 021/135] _rotationChanged is a timestamp

---
 interface/src/avatar/MyAvatar.cpp | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 4926368f4d..253a8addcc 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -402,9 +402,9 @@ void MyAvatar::update(float deltaTime) {
     _hmdSensorFacingMovingAverage = lerp(_hmdSensorFacingMovingAverage, _hmdSensorFacing, tau);
 
     if (_smoothOrientationTimer < SMOOTH_TIME_ORIENTATION) {
-        _rotationChanged = true;
-		_smoothOrientationTimer+= deltaTime;
-	}
+        _rotationChanged = usecTimestampNow();
+        _smoothOrientationTimer += deltaTime;
+    }
 
 #ifdef DEBUG_DRAW_HMD_MOVING_AVERAGE
     glm::vec3 p = transformPoint(getSensorToWorldMatrix(), _hmdSensorPosition + glm::vec3(_hmdSensorFacingMovingAverage.x, 0.0f, _hmdSensorFacingMovingAverage.y));
@@ -1825,10 +1825,10 @@ void MyAvatar::updateOrientation(float deltaTime) {
     // Comfort Mode: If you press any of the left/right rotation drive keys or input, you'll
     // get an instantaneous 15 degree turn. If you keep holding the key down you'll get another
     // snap turn every half second.
-	bool snapTurn = false;
+    bool snapTurn = false;
     if (getDriveKey(STEP_YAW) != 0.0f) {
         totalBodyYaw += getDriveKey(STEP_YAW);
-		snapTurn = true;
+        snapTurn = true;
     }
 
     // use head/HMD orientation to turn while flying
@@ -1865,8 +1865,8 @@ void MyAvatar::updateOrientation(float deltaTime) {
     glm::quat initialOrientation = getOrientationOutbound();
     setOrientation(getOrientation() * glm::quat(glm::radians(glm::vec3(0.0f, totalBodyYaw, 0.0f))));
 
-	if (snapTurn) {
-		// Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
+    if (snapTurn) {
+        // Whether or not there is an existing smoothing going on, just reset the smoothing timer and set the starting position as the avatar's current position, then smooth to the new position.
         _smoothOrientationInitial = initialOrientation;
         _smoothOrientationTarget = getOrientation();
         _smoothOrientationTimer = 0.0f;

From afe044732230626ee4af5e5cca5abb2315106e90 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Mon, 8 May 2017 14:27:39 -0700
Subject: [PATCH 022/135] remove unnecessary virtual keyword

---
 interface/src/avatar/MyAvatar.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index afe7fd017a..901ddbef76 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -188,7 +188,7 @@ public:
     Q_INVOKABLE QVariant getOrientationVar() const;
 
     // A method intended to be overriden by MyAvatar for polling orientation for network transmission.
-    virtual glm::quat getOrientationOutbound() const override;
+    glm::quat getOrientationOutbound() const override;
 
     // Pass a recent sample of the HMD to the avatar.
     // This can also update the avatar's position to follow the HMD

From 13186dcb78c6c1d4464d99368f393fb8982d366f Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Mon, 8 May 2017 14:28:08 -0700
Subject: [PATCH 023/135] replace tab characer r with spaces

---
 libraries/avatars/src/AvatarData.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index b1b10f1427..14f80d1f11 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -1490,7 +1490,7 @@ void AvatarData::parseAvatarIdentityPacket(const QByteArray& data, Identity& ide
 }
 
 glm::quat AvatarData::getOrientationOutbound() const {
-	return (getLocalOrientation());
+    return (getLocalOrientation());
 }
 
 static const QUrl emptyURL("");

From a260163aee756b185572f6a32f54323ca5056dc9 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 2 May 2017 18:22:29 -0700
Subject: [PATCH 024/135] WIP commit, first pass at generating limit center
 joints + debug draw

---
 interface/src/avatar/MyAvatar.cpp             | 23 +++++++++++++++
 .../animation/src/AnimInverseKinematics.cpp   | 14 +++++++++
 .../animation/src/AnimInverseKinematics.h     |  5 ++++
 libraries/animation/src/AnimUtil.cpp          | 18 ++++++++++++
 libraries/animation/src/AnimUtil.h            |  4 +--
 libraries/animation/src/ElbowConstraint.cpp   |  8 +++++
 libraries/animation/src/ElbowConstraint.h     |  1 +
 libraries/animation/src/Rig.cpp               | 29 +++++++++++--------
 libraries/animation/src/Rig.h                 |  3 ++
 libraries/animation/src/RotationConstraint.h  |  3 ++
 .../animation/src/SwingTwistConstraint.cpp    | 27 +++++++++++++++++
 .../animation/src/SwingTwistConstraint.h      |  6 ++--
 12 files changed, 125 insertions(+), 16 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 3f3ce7d9e9..7d2aefa7bf 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -38,6 +38,7 @@
 #include <UserActivityLogger.h>
 #include <AnimDebugDraw.h>
 #include <AnimClip.h>
+#include <AnimInverseKinematics.h>
 #include <recording/Deck.h>
 #include <recording/Recorder.h>
 #include <recording/Clip.h>
@@ -1701,6 +1702,28 @@ void MyAvatar::postUpdate(float deltaTime) {
         initAnimGraph();
     }
 
+    // AJT: REMOVE.
+    {
+        auto ikNode = _rig->getAnimInverseKinematicsNode();
+        if (ikNode) {
+            // the rig is in the skeletonModel frame
+            AnimPose xform(glm::vec3(1), _skeletonModel->getRotation(), _skeletonModel->getTranslation());
+            AnimPoseVec limitCenterPoses = ikNode->getLimitCenterPoses();
+
+            // HACK: convert joints from geom to avatar space
+            int hipsIndex = _rig->indexOfJoint("Hips");
+            for (size_t i = 0; i < limitCenterPoses.size(); i++) {
+                if (i == hipsIndex) {
+                    //limitCenterPoses[i].trans() = glm::vec3(); // zero the hips
+                }
+                // convert from cm to m
+                limitCenterPoses[i].trans() = 0.01f * limitCenterPoses[i].trans();
+            }
+            _rig->getAnimSkeleton()->convertRelativePosesToAbsolute(limitCenterPoses);
+            AnimDebugDraw::getInstance().addAbsolutePoses("myAvatarLimitCenterPoses", _rig->getAnimSkeleton(), limitCenterPoses, xform, glm::vec4(1));
+        }
+    }
+
     if (_enableDebugDrawDefaultPose || _enableDebugDrawAnimPose) {
 
         auto animSkeleton = _rig->getAnimSkeleton();
diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 6edd969568..e21db11eed 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -957,6 +957,19 @@ void AnimInverseKinematics::initConstraints() {
     }
 }
 
+void AnimInverseKinematics::initLimitCenterPoses() {
+    assert(_skeleton);
+    _limitCenterPoses.reserve(_skeleton->getNumJoints());
+    for (int i = 0; i < _skeleton->getNumJoints(); i++) {
+        AnimPose pose = _skeleton->getRelativeDefaultPose(i);
+        RotationConstraint* constraint = getConstraint(i);
+        if (constraint) {
+            pose.rot() = constraint->computeCenterRotation();
+        }
+        _limitCenterPoses.push_back(pose);
+    }
+}
+
 void AnimInverseKinematics::setSkeletonInternal(AnimSkeleton::ConstPointer skeleton) {
     AnimNode::setSkeletonInternal(skeleton);
 
@@ -973,6 +986,7 @@ void AnimInverseKinematics::setSkeletonInternal(AnimSkeleton::ConstPointer skele
 
     if (skeleton) {
         initConstraints();
+        initLimitCenterPoses();
         _headIndex = _skeleton->nameToJointIndex("Head");
         _hipsIndex = _skeleton->nameToJointIndex("Hips");
 
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index c91b7aa9c4..e7427d9ebc 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -43,6 +43,9 @@ public:
 
     float getMaxErrorOnLastSolve() { return _maxErrorOnLastSolve; }
 
+    // AJT: TODO REMOVE? for debugging.
+    const AnimPoseVec& getLimitCenterPoses() const { return _limitCenterPoses; }
+
 protected:
     void computeTargets(const AnimVariantMap& animVars, std::vector<IKTarget>& targets, const AnimPoseVec& underPoses);
     void solveWithCyclicCoordinateDescent(const std::vector<IKTarget>& targets);
@@ -55,6 +58,7 @@ protected:
     RotationConstraint* getConstraint(int index);
     void clearConstraints();
     void initConstraints();
+    void initLimitCenterPoses();
     void computeHipsOffset(const std::vector<IKTarget>& targets, const AnimPoseVec& underPoses, float dt);
 
     // no copies
@@ -85,6 +89,7 @@ protected:
     std::vector<IKTargetVar> _targetVarVec;
     AnimPoseVec _defaultRelativePoses; // poses of the relaxed state
     AnimPoseVec _relativePoses; // current relative poses
+    AnimPoseVec _limitCenterPoses;  // relative
 
     // experimental data for moving hips during IK
     glm::vec3 _hipsOffset { Vectors::ZERO };
diff --git a/libraries/animation/src/AnimUtil.cpp b/libraries/animation/src/AnimUtil.cpp
index c5643034e5..314f4a1c3a 100644
--- a/libraries/animation/src/AnimUtil.cpp
+++ b/libraries/animation/src/AnimUtil.cpp
@@ -33,6 +33,24 @@ void blend(size_t numPoses, const AnimPose* a, const AnimPose* b, float alpha, A
     }
 }
 
+glm::quat averageQuats(size_t numQuats, const glm::quat* quats) {
+    if (numQuats == 0) {
+        return glm::quat();
+    }
+    float alpha = 1.0f / (float)numQuats;
+    glm::quat accum(0, 0, 0, 0);
+    glm::quat firstRot = quats[0];
+    for (size_t i = 0; i < numQuats; i++) {
+        glm::quat rot = quats[i];
+        float dot = glm::dot(firstRot, rot);
+        if (dot < 0.0f) {
+            rot = -rot;
+        }
+        accum += alpha * rot;
+    }
+    return glm::normalize(accum);
+}
+
 float accumulateTime(float startFrame, float endFrame, float timeScale, float currentFrame, float dt, bool loopFlag,
                      const QString& id, AnimNode::Triggers& triggersOut) {
 
diff --git a/libraries/animation/src/AnimUtil.h b/libraries/animation/src/AnimUtil.h
index 6d394be882..055fd630eb 100644
--- a/libraries/animation/src/AnimUtil.h
+++ b/libraries/animation/src/AnimUtil.h
@@ -16,9 +16,9 @@
 // this is where the magic happens
 void blend(size_t numPoses, const AnimPose* a, const AnimPose* b, float alpha, AnimPose* result);
 
+glm::quat averageQuats(size_t numQuats, const glm::quat* quats);
+
 float accumulateTime(float startFrame, float endFrame, float timeScale, float currentFrame, float dt, bool loopFlag,
                      const QString& id, AnimNode::Triggers& triggersOut);
 
 #endif
-
-
diff --git a/libraries/animation/src/ElbowConstraint.cpp b/libraries/animation/src/ElbowConstraint.cpp
index 6833c1762e..17c6bb2da6 100644
--- a/libraries/animation/src/ElbowConstraint.cpp
+++ b/libraries/animation/src/ElbowConstraint.cpp
@@ -13,6 +13,7 @@
 
 #include <GeometryUtil.h>
 #include <NumericalConstants.h>
+#include "AnimUtil.h"
 
 ElbowConstraint::ElbowConstraint() :
         _minAngle(-PI),
@@ -77,3 +78,10 @@ bool ElbowConstraint::apply(glm::quat& rotation) const {
     return false;
 }
 
+glm::quat ElbowConstraint::computeCenterRotation() const {
+    const size_t NUM_LIMITS = 2;
+    glm::quat limits[NUM_LIMITS];
+    limits[0] = glm::angleAxis(_minAngle, _axis) * _referenceRotation;
+    limits[1] = glm::angleAxis(_maxAngle, _axis) * _referenceRotation;
+    return averageQuats(NUM_LIMITS, limits);
+}
diff --git a/libraries/animation/src/ElbowConstraint.h b/libraries/animation/src/ElbowConstraint.h
index 21288715b5..868f5cdc6b 100644
--- a/libraries/animation/src/ElbowConstraint.h
+++ b/libraries/animation/src/ElbowConstraint.h
@@ -18,6 +18,7 @@ public:
     void setHingeAxis(const glm::vec3& axis);
     void setAngleLimits(float minAngle, float maxAngle);
     virtual bool apply(glm::quat& rotation) const override;
+    virtual glm::quat computeCenterRotation() const override;
 protected:
     glm::vec3 _axis;
     glm::vec3 _perpAxis;
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index 700761b248..b66b0eafa5 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -305,30 +305,35 @@ void Rig::clearJointAnimationPriority(int index) {
     }
 }
 
-void Rig::clearIKJointLimitHistory() {
+std::shared_ptr<AnimInverseKinematics> Rig::getAnimInverseKinematicsNode() const {
+    std::shared_ptr<AnimInverseKinematics> result;
     if (_animNode) {
         _animNode->traverse([&](AnimNode::Pointer node) {
             // only report clip nodes as valid roles.
             auto ikNode = std::dynamic_pointer_cast<AnimInverseKinematics>(node);
             if (ikNode) {
-                ikNode->clearIKJointLimitHistory();
+                result = ikNode;
+                return false;
+            } else {
+                return true;
             }
-            return true;
         });
     }
+    return result;
+}
+
+void Rig::clearIKJointLimitHistory() {
+    auto ikNode = getAnimInverseKinematicsNode();
+    if (ikNode) {
+        ikNode->clearIKJointLimitHistory();
+    }
 }
 
 void Rig::setMaxHipsOffsetLength(float maxLength) {
     _maxHipsOffsetLength = maxLength;
-
-    if (_animNode) {
-        _animNode->traverse([&](AnimNode::Pointer node) {
-            auto ikNode = std::dynamic_pointer_cast<AnimInverseKinematics>(node);
-            if (ikNode) {
-                ikNode->setMaxHipsOffsetLength(_maxHipsOffsetLength);
-            }
-            return true;
-        });
+    auto ikNode = getAnimInverseKinematicsNode();
+    if (ikNode) {
+        ikNode->setMaxHipsOffsetLength(_maxHipsOffsetLength);
     }
 }
 
diff --git a/libraries/animation/src/Rig.h b/libraries/animation/src/Rig.h
index 2d024628f5..e0c5e9f421 100644
--- a/libraries/animation/src/Rig.h
+++ b/libraries/animation/src/Rig.h
@@ -26,6 +26,7 @@
 #include "SimpleMovingAverage.h"
 
 class Rig;
+class AnimInverseKinematics;
 typedef std::shared_ptr<Rig> RigPointer;
 
 // Rig instances are reentrant.
@@ -111,6 +112,8 @@ public:
     void clearJointStates();
     void clearJointAnimationPriority(int index);
 
+    std::shared_ptr<AnimInverseKinematics> Rig::getAnimInverseKinematicsNode() const;
+
     void clearIKJointLimitHistory();
     void setMaxHipsOffsetLength(float maxLength);
     float getMaxHipsOffsetLength() const;
diff --git a/libraries/animation/src/RotationConstraint.h b/libraries/animation/src/RotationConstraint.h
index 277e5293c6..e4a5334d41 100644
--- a/libraries/animation/src/RotationConstraint.h
+++ b/libraries/animation/src/RotationConstraint.h
@@ -38,6 +38,9 @@ public:
     /// \brief reset any remembered joint limit history
     virtual void clearHistory() {};
 
+    /// \brief return the rotation that lies at the "center" of all the joint limits.
+    virtual glm::quat computeCenterRotation() const = 0;
+
 protected:
     glm::quat _referenceRotation = glm::quat();
 };
diff --git a/libraries/animation/src/SwingTwistConstraint.cpp b/libraries/animation/src/SwingTwistConstraint.cpp
index 12d7e618e5..c1b325a74a 100644
--- a/libraries/animation/src/SwingTwistConstraint.cpp
+++ b/libraries/animation/src/SwingTwistConstraint.cpp
@@ -15,6 +15,7 @@
 #include <GeometryUtil.h>
 #include <GLMHelpers.h>
 #include <NumericalConstants.h>
+#include "AnimUtil.h"
 
 
 const float MIN_MINDOT = -0.999f;
@@ -430,3 +431,29 @@ void SwingTwistConstraint::dynamicallyAdjustLimits(const glm::quat& rotation) {
 void SwingTwistConstraint::clearHistory() {
     _lastTwistBoundary = LAST_CLAMP_NO_BOUNDARY;
 }
+
+glm::quat SwingTwistConstraint::computeCenterRotation() const {
+    const size_t NUM_MIN_DOTS = getMinDots().size();
+    const size_t NUM_LIMITS = 2 * NUM_MIN_DOTS;
+    std::vector<glm::quat> limits;
+    limits.reserve(NUM_LIMITS);
+    glm::quat minTwistRot;
+    glm::quat maxTwistRot;
+    if (_minTwist != _maxTwist) {
+        minTwistRot = glm::angleAxis(_minTwist, _referenceRotation * Vectors::UNIT_Y);
+        minTwistRot = glm::angleAxis(_maxTwist, _referenceRotation * Vectors::UNIT_Y);
+    }
+    const float D_THETA = TWO_PI / NUM_MIN_DOTS;
+    float theta = 0.0f;
+    for (size_t i = 0; i < NUM_MIN_DOTS; i++, theta += D_THETA) {
+        // compute swing rotation from theta and phi angles.
+        float phi = acos(getMinDots()[i]);
+        float cos_phi = getMinDots()[i];
+        float sin_phi = sinf(phi);
+        glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, sin_phi * sinf(theta));
+        glm::quat swing = glm::angleAxis(phi, glm::cross(Vectors::UNIT_Y, swungAxis));
+        limits.push_back(swing * minTwistRot);
+        limits.push_back(swing * maxTwistRot);
+    }
+    return averageQuats(limits.size(), &limits[0]);
+}
diff --git a/libraries/animation/src/SwingTwistConstraint.h b/libraries/animation/src/SwingTwistConstraint.h
index 06afd64232..295edb3ebf 100644
--- a/libraries/animation/src/SwingTwistConstraint.h
+++ b/libraries/animation/src/SwingTwistConstraint.h
@@ -58,7 +58,7 @@ public:
     virtual void dynamicallyAdjustLimits(const glm::quat& rotation) override;
 
     // for testing purposes
-    const std::vector<float>& getMinDots() { return _swingLimitFunction.getMinDots(); }
+    const std::vector<float>& getMinDots() const { return _swingLimitFunction.getMinDots(); }
 
     // SwingLimitFunction is an implementation of the constraint check described in the paper:
     // "The Parameterization of Joint Rotation with the Unit Quaternion" by Quang Liu and Edmond C. Prakash
@@ -81,7 +81,7 @@ public:
         float getMinDot(float theta) const;
 
         // for testing purposes
-        const std::vector<float>& getMinDots() { return _minDots; }
+        const std::vector<float>& getMinDots() const { return _minDots; }
 
     private:
         // the limits are stored in a lookup table with cyclic boundary conditions
@@ -99,6 +99,8 @@ public:
 
     void clearHistory() override;
 
+    virtual glm::quat computeCenterRotation() const override;
+
 private:
     float handleTwistBoundaryConditions(float twistAngle) const;
 

From e992d6703a8faf21e5a38cab5a694bd48da8ff06 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Wed, 3 May 2017 18:51:17 -0700
Subject: [PATCH 025/135] WIP: debug render joint constraints.

---
 interface/src/avatar/MyAvatar.cpp             |   4 +-
 libraries/animation/src/AnimContext.cpp       |   6 +-
 libraries/animation/src/AnimContext.h         |   4 +-
 .../animation/src/AnimInverseKinematics.cpp   | 120 +++++++++++++++++-
 .../animation/src/AnimInverseKinematics.h     |   3 +-
 libraries/animation/src/AnimPose.cpp          |   7 +-
 libraries/animation/src/AnimPose.h            |   3 +-
 libraries/animation/src/ElbowConstraint.h     |   5 +
 libraries/animation/src/Rig.cpp               |   6 +-
 libraries/animation/src/Rig.h                 |   2 +-
 .../animation/src/SwingTwistConstraint.cpp    |  22 ++--
 .../animation/src/SwingTwistConstraint.h      |   3 +
 libraries/render-utils/src/Model.cpp          |   3 +-
 13 files changed, 164 insertions(+), 24 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 7d2aefa7bf..526b80e3f1 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -1703,6 +1703,7 @@ void MyAvatar::postUpdate(float deltaTime) {
     }
 
     // AJT: REMOVE.
+    /*
     {
         auto ikNode = _rig->getAnimInverseKinematicsNode();
         if (ikNode) {
@@ -1714,7 +1715,7 @@ void MyAvatar::postUpdate(float deltaTime) {
             int hipsIndex = _rig->indexOfJoint("Hips");
             for (size_t i = 0; i < limitCenterPoses.size(); i++) {
                 if (i == hipsIndex) {
-                    //limitCenterPoses[i].trans() = glm::vec3(); // zero the hips
+                    limitCenterPoses[i].trans() = glm::vec3(); // zero the hips
                 }
                 // convert from cm to m
                 limitCenterPoses[i].trans() = 0.01f * limitCenterPoses[i].trans();
@@ -1723,6 +1724,7 @@ void MyAvatar::postUpdate(float deltaTime) {
             AnimDebugDraw::getInstance().addAbsolutePoses("myAvatarLimitCenterPoses", _rig->getAnimSkeleton(), limitCenterPoses, xform, glm::vec4(1));
         }
     }
+    */
 
     if (_enableDebugDrawDefaultPose || _enableDebugDrawAnimPose) {
 
diff --git a/libraries/animation/src/AnimContext.cpp b/libraries/animation/src/AnimContext.cpp
index c8d3e7bcda..c59c75b191 100644
--- a/libraries/animation/src/AnimContext.cpp
+++ b/libraries/animation/src/AnimContext.cpp
@@ -10,7 +10,9 @@
 
 #include "AnimContext.h"
 
-AnimContext::AnimContext(bool enableDebugDrawIKTargets, const glm::mat4& geometryToRigMatrix) :
+AnimContext::AnimContext(bool enableDebugDrawIKTargets, const glm::mat4& geometryToRigMatrix, const glm::mat4& rigToWorldMatrix) :
     _enableDebugDrawIKTargets(enableDebugDrawIKTargets),
-    _geometryToRigMatrix(geometryToRigMatrix) {
+    _geometryToRigMatrix(geometryToRigMatrix),
+    _rigToWorldMatrix(rigToWorldMatrix)
+{
 }
diff --git a/libraries/animation/src/AnimContext.h b/libraries/animation/src/AnimContext.h
index 3170911e14..067e64026a 100644
--- a/libraries/animation/src/AnimContext.h
+++ b/libraries/animation/src/AnimContext.h
@@ -16,15 +16,17 @@
 
 class AnimContext {
 public:
-    AnimContext(bool enableDebugDrawIKTargets, const glm::mat4& geometryToRigMatrix);
+    AnimContext(bool enableDebugDrawIKTargets, const glm::mat4& geometryToRigMatrix, const glm::mat4& rigToWorldMatrix);
 
     bool getEnableDebugDrawIKTargets() const { return _enableDebugDrawIKTargets; }
     const glm::mat4& getGeometryToRigMatrix() const { return _geometryToRigMatrix; }
+    const glm::mat4& getRigToWorldMatrix() const { return _rigToWorldMatrix; }
 
 protected:
 
     bool _enableDebugDrawIKTargets { false };
     glm::mat4 _geometryToRigMatrix;
+    glm::mat4 _rigToWorldMatrix;
 };
 
 #endif  // hifi_AnimContext_h
diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index e21db11eed..ae2ca94d66 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -399,6 +399,8 @@ const AnimPoseVec& AnimInverseKinematics::evaluate(const AnimVariantMap& animVar
 //virtual
 const AnimPoseVec& AnimInverseKinematics::overlay(const AnimVariantMap& animVars, const AnimContext& context, float dt, Triggers& triggersOut, const AnimPoseVec& underPoses) {
 
+    debugDrawConstraints(context);
+
     const float MAX_OVERLAY_DT = 1.0f / 30.0f; // what to clamp delta-time to in AnimInverseKinematics::overlay
     if (dt > MAX_OVERLAY_DT) {
         dt = MAX_OVERLAY_DT;
@@ -604,9 +606,9 @@ void AnimInverseKinematics::clearIKJointLimitHistory() {
     }
 }
 
-RotationConstraint* AnimInverseKinematics::getConstraint(int index) {
+RotationConstraint* AnimInverseKinematics::getConstraint(int index) const {
     RotationConstraint* constraint = nullptr;
-    std::map<int, RotationConstraint*>::iterator constraintItr = _constraints.find(index);
+    std::map<int, RotationConstraint*>::const_iterator constraintItr = _constraints.find(index);
     if (constraintItr != _constraints.end()) {
         constraint = constraintItr->second;
     }
@@ -1003,3 +1005,117 @@ void AnimInverseKinematics::setSkeletonInternal(AnimSkeleton::ConstPointer skele
         _hipsParentIndex = -1;
     }
 }
+
+void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) const {
+
+    if (_skeleton) {
+        const vec4 RED(1.0f, 0.0f, 0.0f, 1.0f);
+        const vec4 GREEN(0.0f, 1.0f, 0.0f, 1.0f);
+        const vec4 BLUE(0.0f, 0.0f, 1.0f, 1.0f);
+        const vec4 PURPLE(0.5f, 0.0f, 1.0f, 1.0f);
+        const vec4 CYAN(0.0f, 1.0f, 1.0f, 1.0f);
+        const vec4 GRAY(0.2f, 0.2f, 0.2f, 1.0f);
+        const vec4 MAGENTA(1.0f, 0.0f, 1.0f, 1.0f);
+        const float AXIS_LENGTH = 2.0f; // cm
+        const float TWIST_LENGTH = 4.0f; // cm
+        const float HINGE_LENGTH = 6.0f; // cm
+        const float SWING_LENGTH = 5.0f; // cm
+        AnimPoseVec absPoses = /*_limitCenterPoses;*/ _skeleton->getRelativeDefaultPoses();
+        _skeleton->convertRelativePosesToAbsolute(absPoses);
+
+        mat4 geomToWorldMatrix = context.getRigToWorldMatrix() * context.getGeometryToRigMatrix();
+        for (int i = 0; i < absPoses.size(); i++) {
+            // transform local axes into world space.
+            auto pose = absPoses[i];
+            glm::vec3 xAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_X);
+            glm::vec3 yAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_Y);
+            glm::vec3 zAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_Z);
+            glm::vec3 pos = transformPoint(geomToWorldMatrix, pose.trans());
+            DebugDraw::getInstance().drawRay(pos, pos + AXIS_LENGTH * xAxis, RED);
+            DebugDraw::getInstance().drawRay(pos, pos + AXIS_LENGTH * yAxis, GREEN);
+            DebugDraw::getInstance().drawRay(pos, pos + AXIS_LENGTH * zAxis, BLUE);
+
+            // draw line to parent
+            int parentIndex = _skeleton->getParentIndex(i);
+            if (parentIndex != -1) {
+                glm::vec3 parentPos = transformPoint(geomToWorldMatrix, absPoses[parentIndex].trans());
+                DebugDraw::getInstance().drawRay(pos, parentPos, GRAY);
+            }
+
+            glm::quat parentAbsRot;
+            if (parentIndex != -1) {
+                parentAbsRot = absPoses[parentIndex].rot();
+            }
+
+            const RotationConstraint* constraint = getConstraint(i);
+            if (constraint) {
+                glm::quat refRot = constraint->getReferenceRotation();
+                const ElbowConstraint* elbowConstraint = dynamic_cast<const ElbowConstraint*>(constraint);
+                if (elbowConstraint) {
+                    glm::vec3 hingeAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * refRot * elbowConstraint->getHingeAxis());
+                    DebugDraw::getInstance().drawRay(pos, pos + HINGE_LENGTH * hingeAxis, MAGENTA);
+
+                    // draw elbow constraints
+                    glm::quat minRot = glm::angleAxis(elbowConstraint->getMinAngle(), elbowConstraint->getHingeAxis());
+                    glm::quat maxRot = glm::angleAxis(elbowConstraint->getMaxAngle(), elbowConstraint->getHingeAxis());
+
+                    glm::vec3 minYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * minRot * refRot * Vectors::UNIT_Y);
+                    glm::vec3 maxYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * maxRot * refRot * Vectors::UNIT_Y);
+
+                    const int NUM_SWING_STEPS = 10;
+                    for (int i = 0; i < NUM_SWING_STEPS + 1; i++) {
+                        glm::quat rot = glm::normalize(glm::lerp(minRot, maxRot, i * (1.0f / NUM_SWING_STEPS)));
+                        glm::vec3 axis = transformVectorFast(geomToWorldMatrix, parentAbsRot * rot * refRot * Vectors::UNIT_Y);
+                        DebugDraw::getInstance().drawRay(pos, pos + TWIST_LENGTH * axis, CYAN);
+                    }
+
+                } else {
+                    const SwingTwistConstraint* swingTwistConstraint = dynamic_cast<const SwingTwistConstraint*>(constraint);
+                    if (swingTwistConstraint) {
+                        // twist constraints
+
+                        glm::vec3 hingeAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * refRot * Vectors::UNIT_Y);
+                        DebugDraw::getInstance().drawRay(pos, pos + HINGE_LENGTH * hingeAxis, MAGENTA);
+
+                        glm::quat minRot = glm::angleAxis(swingTwistConstraint->getMinTwist(), Vectors::UNIT_Y);
+                        glm::quat maxRot = glm::angleAxis(swingTwistConstraint->getMaxTwist(), Vectors::UNIT_Y);
+
+                        glm::vec3 minTwistYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * minRot * refRot * Vectors::UNIT_X);
+                        glm::vec3 maxTwistYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * maxRot * refRot * Vectors::UNIT_X);
+
+                        const int NUM_SWING_STEPS = 10;
+                        for (int i = 0; i < NUM_SWING_STEPS + 1; i++) {
+                            glm::quat rot = glm::normalize(glm::lerp(minRot, maxRot, i * (1.0f / NUM_SWING_STEPS)));
+                            glm::vec3 axis = transformVectorFast(geomToWorldMatrix, parentAbsRot * rot * refRot * Vectors::UNIT_X);
+                            DebugDraw::getInstance().drawRay(pos, pos + TWIST_LENGTH * axis, CYAN);
+                        }
+
+                        // draw swing constraints.
+                        glm::vec3 previousSwingTip;
+                        const size_t NUM_MIN_DOTS = swingTwistConstraint->getMinDots().size();
+                        const float D_THETA = TWO_PI / NUM_MIN_DOTS;
+                        float theta = 0.0f;
+                        for (size_t i = 0; i < NUM_MIN_DOTS; i++, theta += D_THETA) {
+                            // compute swing rotation from theta and phi angles.
+                            float phi = acos(swingTwistConstraint->getMinDots()[i]);
+                            float cos_phi = swingTwistConstraint->getMinDots()[i];
+                            float sin_phi = sinf(phi);
+                            glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, sin_phi * sinf(theta));
+                            glm::vec3 worldSwungAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * refRot * swungAxis);
+
+                            glm::vec3 swingTip = pos + SWING_LENGTH * worldSwungAxis;
+                            DebugDraw::getInstance().drawRay(pos, swingTip, PURPLE);
+
+                            if (previousSwingTipValid) {
+                                DebugDraw::getInstance().drawRay(previousSwingTip, swingTip, PURPLE);
+                            }
+                            previousSwingTip = swingTip;
+                            previousSwingTipValid = true;
+                        }
+                    }
+                }
+                pose.rot() = constraint->computeCenterRotation();
+            }
+        }
+    }
+}
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index e7427d9ebc..5ad5638709 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -51,11 +51,12 @@ protected:
     void solveWithCyclicCoordinateDescent(const std::vector<IKTarget>& targets);
     int solveTargetWithCCD(const IKTarget& target, AnimPoseVec& absolutePoses);
     virtual void setSkeletonInternal(AnimSkeleton::ConstPointer skeleton) override;
+    void debugDrawConstraints(const AnimContext& context) const;
 
     // for AnimDebugDraw rendering
     virtual const AnimPoseVec& getPosesInternal() const override { return _relativePoses; }
 
-    RotationConstraint* getConstraint(int index);
+    RotationConstraint* getConstraint(int index) const;
     void clearConstraints();
     void initConstraints();
     void initLimitCenterPoses();
diff --git a/libraries/animation/src/AnimPose.cpp b/libraries/animation/src/AnimPose.cpp
index e1c8528e0b..470bbab8b6 100644
--- a/libraries/animation/src/AnimPose.cpp
+++ b/libraries/animation/src/AnimPose.cpp
@@ -39,7 +39,7 @@ glm::vec3 AnimPose::xformPoint(const glm::vec3& rhs) const {
     return *this * rhs;
 }
 
-// really slow
+// really slow, but accurate for transforms with non-uniform scale
 glm::vec3 AnimPose::xformVector(const glm::vec3& rhs) const {
     glm::vec3 xAxis = _rot * glm::vec3(_scale.x, 0.0f, 0.0f);
     glm::vec3 yAxis = _rot * glm::vec3(0.0f, _scale.y, 0.0f);
@@ -49,6 +49,11 @@ glm::vec3 AnimPose::xformVector(const glm::vec3& rhs) const {
     return transInvMat * rhs;
 }
 
+// faster, but does not handle non-uniform scale correctly.
+glm::vec3 AnimPose::xformVectorFast(const glm::vec3& rhs) const {
+    return _rot * (_scale * rhs);
+}
+
 AnimPose AnimPose::operator*(const AnimPose& rhs) const {
     glm::mat4 result;
     glm_mat4u_mul(*this, rhs, result);
diff --git a/libraries/animation/src/AnimPose.h b/libraries/animation/src/AnimPose.h
index 893a5c1382..a2e22a24be 100644
--- a/libraries/animation/src/AnimPose.h
+++ b/libraries/animation/src/AnimPose.h
@@ -25,7 +25,8 @@ public:
     static const AnimPose identity;
 
     glm::vec3 xformPoint(const glm::vec3& rhs) const;
-    glm::vec3 xformVector(const glm::vec3& rhs) const;  // really slow
+    glm::vec3 xformVector(const glm::vec3& rhs) const;  // really slow, but accurate for transforms with non-uniform scale
+    glm::vec3 xformVectorFast(const glm::vec3& rhs) const;  // faster, but does not handle non-uniform scale correctly.
 
     glm::vec3 operator*(const glm::vec3& rhs) const; // same as xformPoint
     AnimPose operator*(const AnimPose& rhs) const;
diff --git a/libraries/animation/src/ElbowConstraint.h b/libraries/animation/src/ElbowConstraint.h
index 868f5cdc6b..d3f080374a 100644
--- a/libraries/animation/src/ElbowConstraint.h
+++ b/libraries/animation/src/ElbowConstraint.h
@@ -19,6 +19,11 @@ public:
     void setAngleLimits(float minAngle, float maxAngle);
     virtual bool apply(glm::quat& rotation) const override;
     virtual glm::quat computeCenterRotation() const override;
+
+    glm::vec3 getHingeAxis() const { return _axis; }
+    float getMinAngle() const { return _minAngle; }
+    float getMaxAngle() const { return _maxAngle; }
+
 protected:
     glm::vec3 _axis;
     glm::vec3 _perpAxis;
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index b66b0eafa5..2689fe5be8 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -941,7 +941,7 @@ void Rig::updateAnimationStateHandlers() { // called on avatar update thread (wh
     }
 }
 
-void Rig::updateAnimations(float deltaTime, glm::mat4 rootTransform) {
+void Rig::updateAnimations(float deltaTime, glm::mat4 rootTransform, glm::mat4 rigToWorldTransform) {
 
     PROFILE_RANGE_EX(simulation_animation_detail, __FUNCTION__, 0xffff00ff, 0);
     PerformanceTimer perfTimer("updateAnimations");
@@ -954,7 +954,7 @@ void Rig::updateAnimations(float deltaTime, glm::mat4 rootTransform) {
         updateAnimationStateHandlers();
         _animVars.setRigToGeometryTransform(_rigToGeometryTransform);
 
-        AnimContext context(_enableDebugDrawIKTargets, getGeometryToRigTransform());
+        AnimContext context(_enableDebugDrawIKTargets, getGeometryToRigTransform(), rigToWorldTransform);
 
         // evaluate the animation
         AnimNode::Triggers triggersOut;
@@ -1445,7 +1445,7 @@ void Rig::computeAvatarBoundingCapsule(
 
     // call overlay twice: once to verify AnimPoseVec joints and again to do the IK
     AnimNode::Triggers triggersOut;
-    AnimContext context(false, glm::mat4());
+    AnimContext context(false, glm::mat4(), glm::mat4());
     float dt = 1.0f; // the value of this does not matter
     ikNode.overlay(animVars, context, dt, triggersOut, _animSkeleton->getRelativeBindPoses());
     AnimPoseVec finalPoses =  ikNode.overlay(animVars, context, dt, triggersOut, _animSkeleton->getRelativeBindPoses());
diff --git a/libraries/animation/src/Rig.h b/libraries/animation/src/Rig.h
index e0c5e9f421..f8ae0bdfae 100644
--- a/libraries/animation/src/Rig.h
+++ b/libraries/animation/src/Rig.h
@@ -162,7 +162,7 @@ public:
     void computeMotionAnimationState(float deltaTime, const glm::vec3& worldPosition, const glm::vec3& worldVelocity, const glm::quat& worldRotation, CharacterControllerState ccState);
 
     // Regardless of who started the animations or how many, update the joints.
-    void updateAnimations(float deltaTime, glm::mat4 rootTransform);
+    void updateAnimations(float deltaTime, glm::mat4 rootTransform, glm::mat4 rigToWorldTransform);
 
     // legacy
     void inverseKinematics(int endIndex, glm::vec3 targetPosition, const glm::quat& targetRotation, float priority,
diff --git a/libraries/animation/src/SwingTwistConstraint.cpp b/libraries/animation/src/SwingTwistConstraint.cpp
index c1b325a74a..475ee6a59e 100644
--- a/libraries/animation/src/SwingTwistConstraint.cpp
+++ b/libraries/animation/src/SwingTwistConstraint.cpp
@@ -435,13 +435,13 @@ void SwingTwistConstraint::clearHistory() {
 glm::quat SwingTwistConstraint::computeCenterRotation() const {
     const size_t NUM_MIN_DOTS = getMinDots().size();
     const size_t NUM_LIMITS = 2 * NUM_MIN_DOTS;
-    std::vector<glm::quat> limits;
-    limits.reserve(NUM_LIMITS);
-    glm::quat minTwistRot;
-    glm::quat maxTwistRot;
+    std::vector<glm::quat> swingLimits;
+    swingLimits.reserve(NUM_LIMITS);
+
+    glm::quat twistLimits[2];
     if (_minTwist != _maxTwist) {
-        minTwistRot = glm::angleAxis(_minTwist, _referenceRotation * Vectors::UNIT_Y);
-        minTwistRot = glm::angleAxis(_maxTwist, _referenceRotation * Vectors::UNIT_Y);
+        twistLimits[0] = glm::angleAxis(_minTwist, _referenceRotation * Vectors::UNIT_Y);
+        twistLimits[1] = glm::angleAxis(_maxTwist, _referenceRotation * Vectors::UNIT_Y);
     }
     const float D_THETA = TWO_PI / NUM_MIN_DOTS;
     float theta = 0.0f;
@@ -451,9 +451,11 @@ glm::quat SwingTwistConstraint::computeCenterRotation() const {
         float cos_phi = getMinDots()[i];
         float sin_phi = sinf(phi);
         glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, sin_phi * sinf(theta));
-        glm::quat swing = glm::angleAxis(phi, glm::cross(Vectors::UNIT_Y, swungAxis));
-        limits.push_back(swing * minTwistRot);
-        limits.push_back(swing * maxTwistRot);
+        glm::quat swing = glm::angleAxis(phi, glm::normalize(glm::cross(Vectors::UNIT_Y, swungAxis)));
+        swingLimits.push_back(swing);
     }
-    return averageQuats(limits.size(), &limits[0]);
+    glm::quat limits[2];
+    limits[0] = averageQuats(swingLimits.size(), &swingLimits[0]);
+    limits[1] = averageQuats(2, twistLimits);
+    return averageQuats(2, limits);
 }
diff --git a/libraries/animation/src/SwingTwistConstraint.h b/libraries/animation/src/SwingTwistConstraint.h
index 295edb3ebf..ffe9a1d800 100644
--- a/libraries/animation/src/SwingTwistConstraint.h
+++ b/libraries/animation/src/SwingTwistConstraint.h
@@ -101,6 +101,9 @@ public:
 
     virtual glm::quat computeCenterRotation() const override;
 
+    const float getMinTwist() const { return _minTwist; }
+    const float getMaxTwist() const { return _maxTwist; }
+
 private:
     float handleTwistBoundaryConditions(float twistAngle) const;
 
diff --git a/libraries/render-utils/src/Model.cpp b/libraries/render-utils/src/Model.cpp
index acc84646c5..766a584b85 100644
--- a/libraries/render-utils/src/Model.cpp
+++ b/libraries/render-utils/src/Model.cpp
@@ -1046,7 +1046,8 @@ void Model::simulate(float deltaTime, bool fullUpdate) {
 //virtual
 void Model::updateRig(float deltaTime, glm::mat4 parentTransform) {
     _needsUpdateClusterMatrices = true;
-    _rig->updateAnimations(deltaTime, parentTransform);
+    glm::mat4 rigToWorldTransform = createMatFromQuatAndPos(getRotation(), getTranslation());
+    _rig->updateAnimations(deltaTime, parentTransform, rigToWorldTransform);
 }
 
 void Model::computeMeshPartLocalBounds() {

From 7af93f9fea98ac0538d414adc4a9fa88ff724043 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Thu, 4 May 2017 17:16:22 -0700
Subject: [PATCH 026/135] Hooked up IK constraint rendering

---
 interface/src/Menu.cpp                        |   2 +
 interface/src/Menu.h                          |   1 +
 interface/src/avatar/MyAvatar.cpp             |   5 +
 interface/src/avatar/MyAvatar.h               |   2 +
 libraries/animation/src/AnimContext.cpp       |   4 +-
 libraries/animation/src/AnimContext.h         |   5 +-
 .../animation/src/AnimInverseKinematics.cpp   | 102 ++++++++++--------
 libraries/animation/src/Rig.cpp               |   5 +-
 libraries/animation/src/Rig.h                 |   2 +
 .../animation/src/SwingTwistConstraint.cpp    |  15 +--
 10 files changed, 89 insertions(+), 54 deletions(-)

diff --git a/interface/src/Menu.cpp b/interface/src/Menu.cpp
index 9688694287..560fe7582d 100644
--- a/interface/src/Menu.cpp
+++ b/interface/src/Menu.cpp
@@ -523,6 +523,8 @@ Menu::Menu() {
         avatar.get(), SLOT(setEnableDebugDrawSensorToWorldMatrix(bool)));
     addCheckableActionToQMenuAndActionHash(avatarDebugMenu, MenuOption::RenderIKTargets, 0, false,
         avatar.get(), SLOT(setEnableDebugDrawIKTargets(bool)));
+    addCheckableActionToQMenuAndActionHash(avatarDebugMenu, MenuOption::RenderIKConstraints, 0, false,
+        avatar.get(), SLOT(setEnableDebugDrawIKConstraints(bool)));
 
     addCheckableActionToQMenuAndActionHash(avatarDebugMenu, MenuOption::ActionMotorControl,
         Qt::CTRL | Qt::SHIFT | Qt::Key_K, true, avatar.get(), SLOT(updateMotionBehaviorFromMenu()),
diff --git a/interface/src/Menu.h b/interface/src/Menu.h
index 250d2241ac..1231e0c72d 100644
--- a/interface/src/Menu.h
+++ b/interface/src/Menu.h
@@ -161,6 +161,7 @@ namespace MenuOption {
     const QString RenderResolutionQuarter = "1/4";
     const QString RenderSensorToWorldMatrix = "Show SensorToWorld Matrix";
     const QString RenderIKTargets = "Show IK Targets";
+    const QString RenderIKConstraints = "Show IK Constraints";
     const QString ResetAvatarSize = "Reset Avatar Size";
     const QString ResetSensors = "Reset Sensors";
     const QString RunningScripts = "Running Scripts...";
diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 526b80e3f1..368b403910 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -505,6 +505,7 @@ void MyAvatar::simulate(float deltaTime) {
 
         if (_rig) {
             _rig->setEnableDebugDrawIKTargets(_enableDebugDrawIKTargets);
+            _rig->setEnableDebugDrawIKConstraints(_enableDebugDrawIKConstraints);
         }
 
         _skeletonModel->simulate(deltaTime);
@@ -930,6 +931,10 @@ void MyAvatar::setEnableDebugDrawIKTargets(bool isEnabled) {
     _enableDebugDrawIKTargets = isEnabled;
 }
 
+void MyAvatar::setEnableDebugDrawIKConstraints(bool isEnabled) {
+    _enableDebugDrawIKConstraints = isEnabled;
+}
+
 void MyAvatar::setEnableMeshVisible(bool isEnabled) {
     _skeletonModel->setVisibleInScene(isEnabled, qApp->getMain3DScene());
 }
diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index 7c510f0556..5a7bd7c79c 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -518,6 +518,7 @@ public slots:
     void setEnableDebugDrawHandControllers(bool isEnabled);
     void setEnableDebugDrawSensorToWorldMatrix(bool isEnabled);
     void setEnableDebugDrawIKTargets(bool isEnabled);
+    void setEnableDebugDrawIKConstraints(bool isEnabled);
     bool getEnableMeshVisible() const { return _skeletonModel->isVisible(); }
     void setEnableMeshVisible(bool isEnabled);
     void setUseAnimPreAndPostRotations(bool isEnabled);
@@ -703,6 +704,7 @@ private:
     bool _enableDebugDrawHandControllers { false };
     bool _enableDebugDrawSensorToWorldMatrix { false };
     bool _enableDebugDrawIKTargets { false };
+    bool _enableDebugDrawIKConstraints { false };
 
     AudioListenerMode _audioListenerMode;
     glm::vec3 _customListenPosition;
diff --git a/libraries/animation/src/AnimContext.cpp b/libraries/animation/src/AnimContext.cpp
index c59c75b191..70ca3764b0 100644
--- a/libraries/animation/src/AnimContext.cpp
+++ b/libraries/animation/src/AnimContext.cpp
@@ -10,8 +10,10 @@
 
 #include "AnimContext.h"
 
-AnimContext::AnimContext(bool enableDebugDrawIKTargets, const glm::mat4& geometryToRigMatrix, const glm::mat4& rigToWorldMatrix) :
+AnimContext::AnimContext(bool enableDebugDrawIKTargets, bool enableDebugDrawIKConstraints,
+                         const glm::mat4& geometryToRigMatrix, const glm::mat4& rigToWorldMatrix) :
     _enableDebugDrawIKTargets(enableDebugDrawIKTargets),
+    _enableDebugDrawIKConstraints(enableDebugDrawIKConstraints),
     _geometryToRigMatrix(geometryToRigMatrix),
     _rigToWorldMatrix(rigToWorldMatrix)
 {
diff --git a/libraries/animation/src/AnimContext.h b/libraries/animation/src/AnimContext.h
index 067e64026a..f68535005c 100644
--- a/libraries/animation/src/AnimContext.h
+++ b/libraries/animation/src/AnimContext.h
@@ -16,15 +16,18 @@
 
 class AnimContext {
 public:
-    AnimContext(bool enableDebugDrawIKTargets, const glm::mat4& geometryToRigMatrix, const glm::mat4& rigToWorldMatrix);
+    AnimContext(bool enableDebugDrawIKTargets, bool enableDebugDrawIKConstraints,
+                const glm::mat4& geometryToRigMatrix, const glm::mat4& rigToWorldMatrix);
 
     bool getEnableDebugDrawIKTargets() const { return _enableDebugDrawIKTargets; }
+    bool getEnableDebugDrawIKConstraints() const { return _enableDebugDrawIKConstraints; }
     const glm::mat4& getGeometryToRigMatrix() const { return _geometryToRigMatrix; }
     const glm::mat4& getRigToWorldMatrix() const { return _rigToWorldMatrix; }
 
 protected:
 
     bool _enableDebugDrawIKTargets { false };
+    bool _enableDebugDrawIKConstraints{ false };
     glm::mat4 _geometryToRigMatrix;
     glm::mat4 _rigToWorldMatrix;
 };
diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index ae2ca94d66..5dcbfcafad 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -399,7 +399,9 @@ const AnimPoseVec& AnimInverseKinematics::evaluate(const AnimVariantMap& animVar
 //virtual
 const AnimPoseVec& AnimInverseKinematics::overlay(const AnimVariantMap& animVars, const AnimContext& context, float dt, Triggers& triggersOut, const AnimPoseVec& underPoses) {
 
-    debugDrawConstraints(context);
+    if (context.getEnableDebugDrawIKConstraints()) {
+        debugDrawConstraints(context);
+    }
 
     const float MAX_OVERLAY_DT = 1.0f / 30.0f; // what to clamp delta-time to in AnimInverseKinematics::overlay
     if (dt > MAX_OVERLAY_DT) {
@@ -624,17 +626,19 @@ void AnimInverseKinematics::clearConstraints() {
     _constraints.clear();
 }
 
-// set up swing limits around a swingTwistConstraint in an ellipse, where lateralSwingTheta is the swing limit for lateral swings (side to side)
-// anteriorSwingTheta is swing limit for forward and backward swings.  (where x-axis of reference rotation is sideways and -z-axis is forward)
-static void setEllipticalSwingLimits(SwingTwistConstraint* stConstraint, float lateralSwingTheta, float anteriorSwingTheta) {
+// set up swing limits around a swingTwistConstraint in an ellipse, where lateralSwingPhi is the swing limit for lateral swings (side to side)
+// anteriorSwingPhi is swing limit for forward and backward swings.  (where x-axis of reference rotation is sideways and -z-axis is forward)
+static void setEllipticalSwingLimits(SwingTwistConstraint* stConstraint, float lateralSwingPhi, float anteriorSwingPhi) {
     assert(stConstraint);
-    const int NUM_SUBDIVISIONS = 8;
+    const int NUM_SUBDIVISIONS = 16;
     std::vector<float> minDots;
     minDots.reserve(NUM_SUBDIVISIONS);
     float dTheta = TWO_PI / NUM_SUBDIVISIONS;
     float theta = 0.0f;
     for (int i = 0; i < NUM_SUBDIVISIONS; i++) {
-        minDots.push_back(cosf(glm::length(glm::vec2(anteriorSwingTheta * cosf(theta), lateralSwingTheta * sinf(theta)))));
+        float theta_prime = atanf((lateralSwingPhi / anteriorSwingPhi) * tanf(theta));
+        float phi = (cosf(2.0f * theta_prime) * ((lateralSwingPhi - anteriorSwingPhi) / 2.0f)) + ((lateralSwingPhi + anteriorSwingPhi) / 2.0f);
+        minDots.push_back(cosf(phi));
         theta += dTheta;
     }
     stConstraint->setSwingLimits(minDots);
@@ -642,7 +646,6 @@ static void setEllipticalSwingLimits(SwingTwistConstraint* stConstraint, float l
 
 void AnimInverseKinematics::initConstraints() {
     if (!_skeleton) {
-        return;
     }
     // We create constraints for the joints shown here
     // (and their Left counterparts if applicable).
@@ -746,30 +749,27 @@ void AnimInverseKinematics::initConstraints() {
             std::vector<glm::vec3> swungDirections;
             float deltaTheta = PI / 4.0f;
             float theta = 0.0f;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.25f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(cosf(theta), -0.25f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.0f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(cosf(theta), 0.0f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), -0.25f, sinf(theta))); // posterior
+            swungDirections.push_back(glm::vec3(cosf(theta), 0.25f, sinf(theta))); // posterior
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.0f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(cosf(theta), 0.0f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.25f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(cosf(theta), -0.25f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.5f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.5f, sinf(theta))); // anterior
+            swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta))); // anterior
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.5f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta)));
 
-            // rotate directions into joint-frame
-            glm::quat invAbsoluteRotation = glm::inverse(absolutePoses[i].rot());
-            int numDirections = (int)swungDirections.size();
-            for (int j = 0; j < numDirections; ++j) {
-                swungDirections[j] = invAbsoluteRotation * swungDirections[j];
+            std::vector<float> minDots;
+            for (int i = 0; i < swungDirections.size(); i++) {
+                minDots.push_back(glm::dot(glm::normalize(swungDirections[i]), Vectors::UNIT_Y));
             }
-            stConstraint->setSwingLimits(swungDirections);
-
+            stConstraint->setSwingLimits(minDots);
             constraint = static_cast<RotationConstraint*>(stConstraint);
         } else if (0 == baseName.compare("Hand", Qt::CaseSensitive)) {
             SwingTwistConstraint* stConstraint = new SwingTwistConstraint();
@@ -1006,8 +1006,13 @@ void AnimInverseKinematics::setSkeletonInternal(AnimSkeleton::ConstPointer skele
     }
 }
 
-void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) const {
+static glm::vec3 sphericalToCartesian(float phi, float theta) {
+    float cos_phi = cosf(phi);
+    float sin_phi = sinf(phi);
+    return glm::vec3(sin_phi * cosf(theta), cos_phi, -sin_phi * sinf(theta));
+}
 
+void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) const {
     if (_skeleton) {
         const vec4 RED(1.0f, 0.0f, 0.0f, 1.0f);
         const vec4 GREEN(0.0f, 1.0f, 0.0f, 1.0f);
@@ -1020,13 +1025,26 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
         const float TWIST_LENGTH = 4.0f; // cm
         const float HINGE_LENGTH = 6.0f; // cm
         const float SWING_LENGTH = 5.0f; // cm
-        AnimPoseVec absPoses = /*_limitCenterPoses;*/ _skeleton->getRelativeDefaultPoses();
-        _skeleton->convertRelativePosesToAbsolute(absPoses);
+
+        AnimPoseVec poses = _skeleton->getRelativeDefaultPoses();
+
+        // copy reference rotations into the relative poses
+        for (int i = 0; i < poses.size(); i++) {
+            const RotationConstraint* constraint = getConstraint(i);
+            if (constraint) {
+                poses[i].rot() = constraint->getReferenceRotation();
+            }
+        }
+
+        // convert relative poses to absolute
+        _skeleton->convertRelativePosesToAbsolute(poses);
 
         mat4 geomToWorldMatrix = context.getRigToWorldMatrix() * context.getGeometryToRigMatrix();
-        for (int i = 0; i < absPoses.size(); i++) {
+
+        // draw each pose and constraint
+        for (int i = 0; i < poses.size(); i++) {
             // transform local axes into world space.
-            auto pose = absPoses[i];
+            auto pose = poses[i];
             glm::vec3 xAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_X);
             glm::vec3 yAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_Y);
             glm::vec3 zAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_Z);
@@ -1038,13 +1056,13 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
             // draw line to parent
             int parentIndex = _skeleton->getParentIndex(i);
             if (parentIndex != -1) {
-                glm::vec3 parentPos = transformPoint(geomToWorldMatrix, absPoses[parentIndex].trans());
+                glm::vec3 parentPos = transformPoint(geomToWorldMatrix, poses[parentIndex].trans());
                 DebugDraw::getInstance().drawRay(pos, parentPos, GRAY);
             }
 
             glm::quat parentAbsRot;
             if (parentIndex != -1) {
-                parentAbsRot = absPoses[parentIndex].rot();
+                parentAbsRot = poses[parentIndex].rot();
             }
 
             const RotationConstraint* constraint = getConstraint(i);
@@ -1091,26 +1109,24 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
                         }
 
                         // draw swing constraints.
-                        glm::vec3 previousSwingTip;
                         const size_t NUM_MIN_DOTS = swingTwistConstraint->getMinDots().size();
-                        const float D_THETA = TWO_PI / NUM_MIN_DOTS;
+                        const float D_THETA = TWO_PI / (NUM_MIN_DOTS - 1);
                         float theta = 0.0f;
-                        for (size_t i = 0; i < NUM_MIN_DOTS; i++, theta += D_THETA) {
+                        for (size_t i = 0, j = NUM_MIN_DOTS - 2; i < NUM_MIN_DOTS - 1; j = i, i++, theta += D_THETA) {
                             // compute swing rotation from theta and phi angles.
-                            float phi = acos(swingTwistConstraint->getMinDots()[i]);
-                            float cos_phi = swingTwistConstraint->getMinDots()[i];
-                            float sin_phi = sinf(phi);
-                            glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, sin_phi * sinf(theta));
+                            float phi = acosf(swingTwistConstraint->getMinDots()[i]);
+                            glm::vec3 swungAxis = sphericalToCartesian(phi, theta);
                             glm::vec3 worldSwungAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * refRot * swungAxis);
-
                             glm::vec3 swingTip = pos + SWING_LENGTH * worldSwungAxis;
-                            DebugDraw::getInstance().drawRay(pos, swingTip, PURPLE);
 
-                            if (previousSwingTipValid) {
-                                DebugDraw::getInstance().drawRay(previousSwingTip, swingTip, PURPLE);
-                            }
-                            previousSwingTip = swingTip;
-                            previousSwingTipValid = true;
+                            float prevPhi = acos(swingTwistConstraint->getMinDots()[j]);
+                            float prevTheta = theta - D_THETA;
+                            glm::vec3 prevSwungAxis = sphericalToCartesian(prevPhi, prevTheta);
+                            glm::vec3 prevWorldSwungAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * refRot * prevSwungAxis);
+                            glm::vec3 prevSwingTip = pos + SWING_LENGTH * prevWorldSwungAxis;
+
+                            DebugDraw::getInstance().drawRay(pos, swingTip, PURPLE);
+                            DebugDraw::getInstance().drawRay(prevSwingTip, swingTip, PURPLE);
                         }
                     }
                 }
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index 2689fe5be8..2bcd71d5c3 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -954,7 +954,8 @@ void Rig::updateAnimations(float deltaTime, glm::mat4 rootTransform, glm::mat4 r
         updateAnimationStateHandlers();
         _animVars.setRigToGeometryTransform(_rigToGeometryTransform);
 
-        AnimContext context(_enableDebugDrawIKTargets, getGeometryToRigTransform(), rigToWorldTransform);
+        AnimContext context(_enableDebugDrawIKTargets, _enableDebugDrawIKConstraints,
+                            getGeometryToRigTransform(), rigToWorldTransform);
 
         // evaluate the animation
         AnimNode::Triggers triggersOut;
@@ -1445,7 +1446,7 @@ void Rig::computeAvatarBoundingCapsule(
 
     // call overlay twice: once to verify AnimPoseVec joints and again to do the IK
     AnimNode::Triggers triggersOut;
-    AnimContext context(false, glm::mat4(), glm::mat4());
+    AnimContext context(false, false, glm::mat4(), glm::mat4());
     float dt = 1.0f; // the value of this does not matter
     ikNode.overlay(animVars, context, dt, triggersOut, _animSkeleton->getRelativeBindPoses());
     AnimPoseVec finalPoses =  ikNode.overlay(animVars, context, dt, triggersOut, _animSkeleton->getRelativeBindPoses());
diff --git a/libraries/animation/src/Rig.h b/libraries/animation/src/Rig.h
index f8ae0bdfae..396e68d633 100644
--- a/libraries/animation/src/Rig.h
+++ b/libraries/animation/src/Rig.h
@@ -231,6 +231,7 @@ public:
     const glm::mat4& getGeometryToRigTransform() const { return _geometryToRigTransform; }
 
     void setEnableDebugDrawIKTargets(bool enableDebugDrawIKTargets) { _enableDebugDrawIKTargets = enableDebugDrawIKTargets; }
+    void setEnableDebugDrawIKConstraints(bool enableDebugDrawIKConstraints) { _enableDebugDrawIKConstraints = enableDebugDrawIKConstraints; }
 
     // input assumed to be in rig space
     void computeHeadFromHMD(const AnimPose& hmdPose, glm::vec3& headPositionOut, glm::quat& headOrientationOut) const;
@@ -341,6 +342,7 @@ protected:
     float _maxHipsOffsetLength { 1.0f };
 
     bool _enableDebugDrawIKTargets { false };
+    bool _enableDebugDrawIKConstraints { false };
 
 private:
     QMap<int, StateHandler> _stateHandlers;
diff --git a/libraries/animation/src/SwingTwistConstraint.cpp b/libraries/animation/src/SwingTwistConstraint.cpp
index 475ee6a59e..aba0516b2a 100644
--- a/libraries/animation/src/SwingTwistConstraint.cpp
+++ b/libraries/animation/src/SwingTwistConstraint.cpp
@@ -443,19 +443,20 @@ glm::quat SwingTwistConstraint::computeCenterRotation() const {
         twistLimits[0] = glm::angleAxis(_minTwist, _referenceRotation * Vectors::UNIT_Y);
         twistLimits[1] = glm::angleAxis(_maxTwist, _referenceRotation * Vectors::UNIT_Y);
     }
-    const float D_THETA = TWO_PI / NUM_MIN_DOTS;
+    const float D_THETA = TWO_PI / (NUM_MIN_DOTS - 1);
     float theta = 0.0f;
-    for (size_t i = 0; i < NUM_MIN_DOTS; i++, theta += D_THETA) {
+    for (size_t i = 0; i < NUM_MIN_DOTS - 1; i++, theta += D_THETA) {
         // compute swing rotation from theta and phi angles.
         float phi = acos(getMinDots()[i]);
         float cos_phi = getMinDots()[i];
         float sin_phi = sinf(phi);
         glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, sin_phi * sinf(theta));
-        glm::quat swing = glm::angleAxis(phi, glm::normalize(glm::cross(Vectors::UNIT_Y, swungAxis)));
+
+        // to ensure that swings > 90 degrees do not flip the center rotation, we devide phi / 2
+        glm::quat swing = glm::angleAxis(phi / 2, glm::normalize(glm::cross(Vectors::UNIT_Y, swungAxis)));
         swingLimits.push_back(swing);
     }
-    glm::quat limits[2];
-    limits[0] = averageQuats(swingLimits.size(), &swingLimits[0]);
-    limits[1] = averageQuats(2, twistLimits);
-    return averageQuats(2, limits);
+    glm::quat averageSwing = averageQuats(swingLimits.size(), &swingLimits[0]);
+    glm::quat averageTwist = averageQuats(2, twistLimits);
+    return averageSwing * averageTwist * _referenceRotation;
 }

From 712fcbe27a9dce1fa59dc4a37a766575dfa7179f Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Thu, 4 May 2017 18:41:42 -0700
Subject: [PATCH 027/135] Removed cruft/debug code & comments

---
 interface/src/avatar/MyAvatar.cpp             | 24 -------------------
 .../animation/src/AnimInverseKinematics.h     |  3 ---
 2 files changed, 27 deletions(-)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 368b403910..7870bd4968 100644
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -1707,30 +1707,6 @@ void MyAvatar::postUpdate(float deltaTime) {
         initAnimGraph();
     }
 
-    // AJT: REMOVE.
-    /*
-    {
-        auto ikNode = _rig->getAnimInverseKinematicsNode();
-        if (ikNode) {
-            // the rig is in the skeletonModel frame
-            AnimPose xform(glm::vec3(1), _skeletonModel->getRotation(), _skeletonModel->getTranslation());
-            AnimPoseVec limitCenterPoses = ikNode->getLimitCenterPoses();
-
-            // HACK: convert joints from geom to avatar space
-            int hipsIndex = _rig->indexOfJoint("Hips");
-            for (size_t i = 0; i < limitCenterPoses.size(); i++) {
-                if (i == hipsIndex) {
-                    limitCenterPoses[i].trans() = glm::vec3(); // zero the hips
-                }
-                // convert from cm to m
-                limitCenterPoses[i].trans() = 0.01f * limitCenterPoses[i].trans();
-            }
-            _rig->getAnimSkeleton()->convertRelativePosesToAbsolute(limitCenterPoses);
-            AnimDebugDraw::getInstance().addAbsolutePoses("myAvatarLimitCenterPoses", _rig->getAnimSkeleton(), limitCenterPoses, xform, glm::vec4(1));
-        }
-    }
-    */
-
     if (_enableDebugDrawDefaultPose || _enableDebugDrawAnimPose) {
 
         auto animSkeleton = _rig->getAnimSkeleton();
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index 5ad5638709..b40f025ecd 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -43,9 +43,6 @@ public:
 
     float getMaxErrorOnLastSolve() { return _maxErrorOnLastSolve; }
 
-    // AJT: TODO REMOVE? for debugging.
-    const AnimPoseVec& getLimitCenterPoses() const { return _limitCenterPoses; }
-
 protected:
     void computeTargets(const AnimVariantMap& animVars, std::vector<IKTarget>& targets, const AnimPoseVec& underPoses);
     void solveWithCyclicCoordinateDescent(const std::vector<IKTarget>& targets);

From 2166d8c159e15e20a9ff03e62486b426d511268d Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Mon, 8 May 2017 14:10:16 -0700
Subject: [PATCH 028/135] Added setSolutionSource to AnimInverseKinematics
 node.

---
 .../animation/src/AnimInverseKinematics.cpp   | 58 +++++++++++++------
 .../animation/src/AnimInverseKinematics.h     | 13 +++++
 2 files changed, 52 insertions(+), 19 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 5dcbfcafad..bf05d9358c 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -414,25 +414,7 @@ const AnimPoseVec& AnimInverseKinematics::overlay(const AnimVariantMap& animVars
 
         PROFILE_RANGE_EX(simulation_animation, "ik/relax", 0xffff00ff, 0);
 
-        // relax toward underPoses
-        // HACK: this relaxation needs to be constant per-frame rather than per-realtime
-        // in order to prevent IK "flutter" for bad FPS.  The bad news is that the good parts
-        // of this relaxation will be FPS dependent (low FPS will make the limbs align slower
-        // in real-time), however most people will not notice this and this problem is less
-        // annoying than the flutter.
-        const float blend = (1.0f / 60.0f) / (0.25f); // effectively: dt / RELAXATION_TIMESCALE
-        int numJoints = (int)_relativePoses.size();
-        for (int i = 0; i < numJoints; ++i) {
-            float dotSign = copysignf(1.0f, glm::dot(_relativePoses[i].rot(), underPoses[i].rot()));
-            if (_accumulators[i].isDirty()) {
-                // this joint is affected by IK --> blend toward underPose rotation
-                _relativePoses[i].rot() = glm::normalize(glm::lerp(_relativePoses[i].rot(), dotSign * underPoses[i].rot(), blend));
-            } else {
-                // this joint is NOT affected by IK --> slam to underPose rotation
-                _relativePoses[i].rot() = underPoses[i].rot();
-            }
-            _relativePoses[i].trans() = underPoses[i].trans();
-        }
+        initRelativePosesFromSolutionSource(underPoses);
 
         if (!underPoses.empty()) {
             // Sometimes the underpose itself can violate the constraints.  Rather than
@@ -1135,3 +1117,41 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
         }
     }
 }
+
+void AnimInverseKinematics::relaxToPoses(const AnimPoseVec& poses) {
+    // relax toward poses
+    const float blend = (1.0f / 60.0f) / (0.25f);
+    int numJoints = (int)_relativePoses.size();
+    for (int i = 0; i < numJoints; ++i) {
+        float dotSign = copysignf(1.0f, glm::dot(_relativePoses[i].rot(), poses[i].rot()));
+        if (_accumulators[i].isDirty()) {
+            // this joint is affected by IK --> blend toward each pose rotation
+            _relativePoses[i].rot() = glm::normalize(glm::lerp(_relativePoses[i].rot(), dotSign * poses[i].rot(), blend));
+        } else {
+            // this joint is NOT affected by IK --> slam to underPose rotation
+            _relativePoses[i].rot() = poses[i].rot();
+        }
+        _relativePoses[i].trans() = poses[i].trans();
+    }
+}
+
+void AnimInverseKinematics::initRelativePosesFromSolutionSource(const AnimPoseVec& underPoses) {
+    switch (_solutionSource) {
+    default:
+    case SolutionSource::RelaxToUnderPoses:
+        relaxToPoses(underPoses);
+        break;
+    case SolutionSource::RelaxToLimitCenterPoses:
+        relaxToPoses(_limitCenterPoses);
+        break;
+    case SolutionSource::PreviousSolution:
+        // do nothing... _relativePoses is already the previous solution
+        break;
+    case SolutionSource::UnderPoses:
+        _relativePoses = underPoses;
+        break;
+    case SolutionSource::LimitCenterPoses:
+        _relativePoses = _limitCenterPoses;
+        break;
+    }
+}
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index b40f025ecd..9b7c095e6b 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -43,12 +43,24 @@ public:
 
     float getMaxErrorOnLastSolve() { return _maxErrorOnLastSolve; }
 
+    enum class SolutionSource {
+        RelaxToUnderPoses = 0,
+        RelaxToLimitCenterPoses,
+        PreviousSolution,
+        UnderPoses,
+        LimitCenterPoses
+    };
+
+    void setSolutionSource(SolutionSource solutionSource) { _solutionSource = solutionSource; }
+
 protected:
     void computeTargets(const AnimVariantMap& animVars, std::vector<IKTarget>& targets, const AnimPoseVec& underPoses);
     void solveWithCyclicCoordinateDescent(const std::vector<IKTarget>& targets);
     int solveTargetWithCCD(const IKTarget& target, AnimPoseVec& absolutePoses);
     virtual void setSkeletonInternal(AnimSkeleton::ConstPointer skeleton) override;
     void debugDrawConstraints(const AnimContext& context) const;
+    void initRelativePosesFromSolutionSource(const AnimPoseVec& underPose);
+    void relaxToPoses(const AnimPoseVec& poses);
 
     // for AnimDebugDraw rendering
     virtual const AnimPoseVec& getPosesInternal() const override { return _relativePoses; }
@@ -103,6 +115,7 @@ protected:
 
     float _maxErrorOnLastSolve { FLT_MAX };
     bool _previousEnableDebugIKTargets { false };
+    SolutionSource _solutionSource { SolutionSource::RelaxToUnderPoses };
 };
 
 #endif // hifi_AnimInverseKinematics_h

From 84aa86b4645ed5437c970af80f6089e49459e7c1 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Mon, 8 May 2017 18:07:45 -0700
Subject: [PATCH 029/135] Added animVar support for IK solutionSource.

---
 .../resources/avatar/avatar-animation.json    |  2 +
 .../animation/src/AnimInverseKinematics.cpp   |  9 +++--
 .../animation/src/AnimInverseKinematics.h     |  7 +++-
 libraries/animation/src/AnimNodeLoader.cpp    | 37 +++++++++++++++++++
 libraries/animation/src/Rig.cpp               |  2 +
 5 files changed, 52 insertions(+), 5 deletions(-)

diff --git a/interface/resources/avatar/avatar-animation.json b/interface/resources/avatar/avatar-animation.json
index 9efe3dd29b..eb8403634a 100644
--- a/interface/resources/avatar/avatar-animation.json
+++ b/interface/resources/avatar/avatar-animation.json
@@ -49,6 +49,8 @@
                         "id": "ik",
                         "type": "inverseKinematics",
                         "data": {
+                            "solutionSource": "relaxToUnderPoses",
+                            "solutionSourceVar": "solutionSource",
                             "targets": [
                                 {
                                     "jointName": "Hips",
diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index bf05d9358c..513d770e64 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -399,6 +399,9 @@ const AnimPoseVec& AnimInverseKinematics::evaluate(const AnimVariantMap& animVar
 //virtual
 const AnimPoseVec& AnimInverseKinematics::overlay(const AnimVariantMap& animVars, const AnimContext& context, float dt, Triggers& triggersOut, const AnimPoseVec& underPoses) {
 
+    // allows solutionSource to be overridden by an animVar
+    auto solutionSource = animVars.lookup(_solutionSourceVar, (int)_solutionSource);
+
     if (context.getEnableDebugDrawIKConstraints()) {
         debugDrawConstraints(context);
     }
@@ -414,7 +417,7 @@ const AnimPoseVec& AnimInverseKinematics::overlay(const AnimVariantMap& animVars
 
         PROFILE_RANGE_EX(simulation_animation, "ik/relax", 0xffff00ff, 0);
 
-        initRelativePosesFromSolutionSource(underPoses);
+        initRelativePosesFromSolutionSource((SolutionSource)solutionSource, underPoses);
 
         if (!underPoses.empty()) {
             // Sometimes the underpose itself can violate the constraints.  Rather than
@@ -1135,8 +1138,8 @@ void AnimInverseKinematics::relaxToPoses(const AnimPoseVec& poses) {
     }
 }
 
-void AnimInverseKinematics::initRelativePosesFromSolutionSource(const AnimPoseVec& underPoses) {
-    switch (_solutionSource) {
+void AnimInverseKinematics::initRelativePosesFromSolutionSource(SolutionSource solutionSource, const AnimPoseVec& underPoses) {
+    switch (solutionSource) {
     default:
     case SolutionSource::RelaxToUnderPoses:
         relaxToPoses(underPoses);
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index 9b7c095e6b..a78662cbeb 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -48,10 +48,12 @@ public:
         RelaxToLimitCenterPoses,
         PreviousSolution,
         UnderPoses,
-        LimitCenterPoses
+        LimitCenterPoses,
+        NumSolutionSources,
     };
 
     void setSolutionSource(SolutionSource solutionSource) { _solutionSource = solutionSource; }
+    void setSolutionSourceVar(const QString& solutionSourceVar) { _solutionSourceVar = solutionSourceVar; }
 
 protected:
     void computeTargets(const AnimVariantMap& animVars, std::vector<IKTarget>& targets, const AnimPoseVec& underPoses);
@@ -59,7 +61,7 @@ protected:
     int solveTargetWithCCD(const IKTarget& target, AnimPoseVec& absolutePoses);
     virtual void setSkeletonInternal(AnimSkeleton::ConstPointer skeleton) override;
     void debugDrawConstraints(const AnimContext& context) const;
-    void initRelativePosesFromSolutionSource(const AnimPoseVec& underPose);
+    void initRelativePosesFromSolutionSource(SolutionSource solutionSource, const AnimPoseVec& underPose);
     void relaxToPoses(const AnimPoseVec& poses);
 
     // for AnimDebugDraw rendering
@@ -116,6 +118,7 @@ protected:
     float _maxErrorOnLastSolve { FLT_MAX };
     bool _previousEnableDebugIKTargets { false };
     SolutionSource _solutionSource { SolutionSource::RelaxToUnderPoses };
+    QString _solutionSourceVar;
 };
 
 #endif // hifi_AnimInverseKinematics_h
diff --git a/libraries/animation/src/AnimNodeLoader.cpp b/libraries/animation/src/AnimNodeLoader.cpp
index bda4541f36..592667bb72 100644
--- a/libraries/animation/src/AnimNodeLoader.cpp
+++ b/libraries/animation/src/AnimNodeLoader.cpp
@@ -352,6 +352,23 @@ static AnimOverlay::BoneSet stringToBoneSetEnum(const QString& str) {
     return AnimOverlay::NumBoneSets;
 }
 
+static const char* solutionSourceStrings[AnimInverseKinematics::SolutionSource::NumSolutionSources] = {
+    "relaxToUnderPoses",
+    "relaxToLimitCenterPoses",
+    "previousSolution",
+    "underPoses",
+    "limitCenterPoses"
+};
+
+static AnimInverseKinematics::SolutionSource stringToSolutionSourceEnum(const QString& str) {
+    for (int i = 0; i < (int)AnimInverseKinematics::SolutionSource::NumSolutionSources; i++) {
+        if (str == solutionSourceStrings[i]) {
+            return (AnimInverseKinematics::SolutionSource)i;
+        }
+    }
+    return AnimInverseKinematics::SolutionSource::NumSolutionSources;
+}
+
 static AnimNode::Pointer loadOverlayNode(const QJsonObject& jsonObj, const QString& id, const QUrl& jsonUrl) {
 
     READ_STRING(boneSet, jsonObj, id, jsonUrl, nullptr);
@@ -457,6 +474,26 @@ AnimNode::Pointer loadInverseKinematicsNode(const QJsonObject& jsonObj, const QS
         node->setTargetVars(jointName, positionVar, rotationVar, typeVar);
     };
 
+    READ_OPTIONAL_STRING(solutionSource, jsonObj);
+
+    if (!solutionSource.isEmpty()) {
+        qCDebug(animation) << "AJT: REMOVE solutionSource = " << solutionSource;
+
+        AnimInverseKinematics::SolutionSource solutionSourceType = stringToSolutionSourceEnum(solutionSource);
+        if (solutionSourceType != AnimInverseKinematics::SolutionSource::NumSolutionSources) {
+            node->setSolutionSource(solutionSourceType);
+        } else {
+            qCWarning(animation) << "AnimNodeLoader, bad solutionSourceType in \"solutionSource\", id = " << id << ", url = " << jsonUrl.toDisplayString();
+        }
+    }
+
+    READ_OPTIONAL_STRING(solutionSourceVar, jsonObj);
+
+    if (!solutionSourceVar.isEmpty()) {
+        qCDebug(animation) << "AJT: REMOVE solutionSourceVar = " << solutionSourceVar;
+        node->setSolutionSourceVar(solutionSourceVar);
+    }
+
     return node;
 }
 
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index 2bcd71d5c3..c1ef443684 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -1031,10 +1031,12 @@ void Rig::updateFromHeadParameters(const HeadParameters& params, float dt) {
     _animVars.set("notIsTalking", !params.isTalking);
 
     if (params.hipsEnabled) {
+        _animVars.set("solutionSource", (int)AnimInverseKinematics::SolutionSource::RelaxToCenterJointLimits);
         _animVars.set("hipsType", (int)IKTarget::Type::RotationAndPosition);
         _animVars.set("hipsPosition", extractTranslation(params.hipsMatrix));
         _animVars.set("hipsRotation", glmExtractRotation(params.hipsMatrix));
     } else {
+        _animVars.set("solutionSource", (int)AnimInverseKinematics::SolutionSource::RelaxToUnderPoses);
         _animVars.set("hipsType", (int)IKTarget::Type::Unknown);
     }
 

From 5a4b21c0a9833911c3786e5b3d4195a669615323 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Mon, 8 May 2017 18:10:56 -0700
Subject: [PATCH 030/135] Removed debug code

---
 libraries/animation/src/AnimNodeLoader.cpp | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/libraries/animation/src/AnimNodeLoader.cpp b/libraries/animation/src/AnimNodeLoader.cpp
index 592667bb72..6e2c070ae5 100644
--- a/libraries/animation/src/AnimNodeLoader.cpp
+++ b/libraries/animation/src/AnimNodeLoader.cpp
@@ -477,8 +477,6 @@ AnimNode::Pointer loadInverseKinematicsNode(const QJsonObject& jsonObj, const QS
     READ_OPTIONAL_STRING(solutionSource, jsonObj);
 
     if (!solutionSource.isEmpty()) {
-        qCDebug(animation) << "AJT: REMOVE solutionSource = " << solutionSource;
-
         AnimInverseKinematics::SolutionSource solutionSourceType = stringToSolutionSourceEnum(solutionSource);
         if (solutionSourceType != AnimInverseKinematics::SolutionSource::NumSolutionSources) {
             node->setSolutionSource(solutionSourceType);
@@ -490,7 +488,6 @@ AnimNode::Pointer loadInverseKinematicsNode(const QJsonObject& jsonObj, const QS
     READ_OPTIONAL_STRING(solutionSourceVar, jsonObj);
 
     if (!solutionSourceVar.isEmpty()) {
-        qCDebug(animation) << "AJT: REMOVE solutionSourceVar = " << solutionSourceVar;
         node->setSolutionSourceVar(solutionSourceVar);
     }
 

From fe69f58174243438224fff7b88d779c1ae051966 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 9 May 2017 09:47:26 -0700
Subject: [PATCH 031/135] Bug fix centerLimit rot for LeftArm, also, lower arms
 in centerLimit pose

Lowering the arms in centerLimit poses will help keep the elbows relaxed on the side of the body.
---
 libraries/animation/src/AnimInverseKinematics.cpp | 13 +++++++++++++
 libraries/animation/src/Rig.cpp                   |  2 +-
 libraries/animation/src/SwingTwistConstraint.cpp  | 13 +++++++------
 3 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 513d770e64..9c3aaddcfa 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -955,6 +955,19 @@ void AnimInverseKinematics::initLimitCenterPoses() {
         }
         _limitCenterPoses.push_back(pose);
     }
+
+    // The limit center rotations for the LeftArm and RightArm form a t-pose.
+    // In order for the elbows to look more natural, we rotate them down by the avatar's sides
+    const float UPPER_ARM_THETA = 3.0f * PI / 8.0f;  // 67.5 deg
+    int leftArmIndex = _skeleton->nameToJointIndex("LeftArm");
+    const glm::quat armRot = glm::angleAxis(UPPER_ARM_THETA, Vectors::UNIT_X);
+    if (leftArmIndex >= 0 && leftArmIndex < _limitCenterPoses.size()) {
+        _limitCenterPoses[leftArmIndex].rot() = _limitCenterPoses[leftArmIndex].rot() * armRot;
+    }
+    int rightArmIndex = _skeleton->nameToJointIndex("RightArm");
+    if (rightArmIndex >= 0 && rightArmIndex < _limitCenterPoses.size()) {
+        _limitCenterPoses[rightArmIndex].rot() = _limitCenterPoses[rightArmIndex].rot() * armRot;
+    }
 }
 
 void AnimInverseKinematics::setSkeletonInternal(AnimSkeleton::ConstPointer skeleton) {
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index c1ef443684..f933002c2c 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -1031,7 +1031,7 @@ void Rig::updateFromHeadParameters(const HeadParameters& params, float dt) {
     _animVars.set("notIsTalking", !params.isTalking);
 
     if (params.hipsEnabled) {
-        _animVars.set("solutionSource", (int)AnimInverseKinematics::SolutionSource::RelaxToCenterJointLimits);
+        _animVars.set("solutionSource", (int)AnimInverseKinematics::SolutionSource::RelaxToLimitCenterPoses);
         _animVars.set("hipsType", (int)IKTarget::Type::RotationAndPosition);
         _animVars.set("hipsPosition", extractTranslation(params.hipsMatrix));
         _animVars.set("hipsRotation", glmExtractRotation(params.hipsMatrix));
diff --git a/libraries/animation/src/SwingTwistConstraint.cpp b/libraries/animation/src/SwingTwistConstraint.cpp
index aba0516b2a..212343d4eb 100644
--- a/libraries/animation/src/SwingTwistConstraint.cpp
+++ b/libraries/animation/src/SwingTwistConstraint.cpp
@@ -433,15 +433,16 @@ void SwingTwistConstraint::clearHistory() {
 }
 
 glm::quat SwingTwistConstraint::computeCenterRotation() const {
+    const size_t NUM_TWIST_LIMITS = 2;
     const size_t NUM_MIN_DOTS = getMinDots().size();
-    const size_t NUM_LIMITS = 2 * NUM_MIN_DOTS;
     std::vector<glm::quat> swingLimits;
-    swingLimits.reserve(NUM_LIMITS);
+    swingLimits.reserve(NUM_MIN_DOTS);
 
-    glm::quat twistLimits[2];
+    glm::quat twistLimits[NUM_TWIST_LIMITS];
     if (_minTwist != _maxTwist) {
-        twistLimits[0] = glm::angleAxis(_minTwist, _referenceRotation * Vectors::UNIT_Y);
-        twistLimits[1] = glm::angleAxis(_maxTwist, _referenceRotation * Vectors::UNIT_Y);
+        // to ensure that twists do not flip the center rotation, we devide twist angle by 2.
+        twistLimits[0] = glm::angleAxis(_minTwist / 2.0f, _referenceRotation * Vectors::UNIT_Y);
+        twistLimits[1] = glm::angleAxis(_maxTwist / 2.0f, _referenceRotation * Vectors::UNIT_Y);
     }
     const float D_THETA = TWO_PI / (NUM_MIN_DOTS - 1);
     float theta = 0.0f;
@@ -450,7 +451,7 @@ glm::quat SwingTwistConstraint::computeCenterRotation() const {
         float phi = acos(getMinDots()[i]);
         float cos_phi = getMinDots()[i];
         float sin_phi = sinf(phi);
-        glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, sin_phi * sinf(theta));
+        glm::vec3 swungAxis(sin_phi * cosf(theta), cos_phi, -sin_phi * sinf(theta));
 
         // to ensure that swings > 90 degrees do not flip the center rotation, we devide phi / 2
         glm::quat swing = glm::angleAxis(phi / 2, glm::normalize(glm::cross(Vectors::UNIT_Y, swungAxis)));

From 7faed38bb52cde987cddf19845c1a79d78a09314 Mon Sep 17 00:00:00 2001
From: trent <trent@joy-machine.com>
Date: Tue, 9 May 2017 12:51:25 -0400
Subject: [PATCH 032/135] Just use the smooth time constant instead of a
 variable.

---
 interface/src/avatar/MyAvatar.h | 1 -
 1 file changed, 1 deletion(-)

diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index afe7fd017a..fee27729da 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -632,7 +632,6 @@ private:
     const float SMOOTH_TIME_ORIENTATION = 0.5f;
 
     // Smoothing data for blending from one position/orientation to another on remote agents.
-    float _smoothOrientationTime;
     float _smoothOrientationTimer;
     glm::quat _smoothOrientationInitial;
     glm::quat _smoothOrientationTarget;

From 7b35e8c7fd6141b1e3797387e25ed48adee1d9bf Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 9 May 2017 11:57:41 -0700
Subject: [PATCH 033/135] Bug fix for hands, reduced elbow angle to 60 degrees
 from horizontal.

---
 .../animation/src/AnimInverseKinematics.cpp   | 29 +++++++++++--------
 .../animation/src/AnimInverseKinematics.h     |  2 +-
 2 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 9c3aaddcfa..11c14d8899 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -958,7 +958,7 @@ void AnimInverseKinematics::initLimitCenterPoses() {
 
     // The limit center rotations for the LeftArm and RightArm form a t-pose.
     // In order for the elbows to look more natural, we rotate them down by the avatar's sides
-    const float UPPER_ARM_THETA = 3.0f * PI / 8.0f;  // 67.5 deg
+    const float UPPER_ARM_THETA = PI / 3.0f;  // 60 deg
     int leftArmIndex = _skeleton->nameToJointIndex("LeftArm");
     const glm::quat armRot = glm::angleAxis(UPPER_ARM_THETA, Vectors::UNIT_X);
     if (leftArmIndex >= 0 && leftArmIndex < _limitCenterPoses.size()) {
@@ -1134,31 +1134,35 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
     }
 }
 
-void AnimInverseKinematics::relaxToPoses(const AnimPoseVec& poses) {
+// for bones under IK, blend between previous solution (_relativePoses) to targetPoses
+// for bones NOT under IK, copy directly from underPoses.
+// mutates _relativePoses.
+void AnimInverseKinematics::blendToPoses(const AnimPoseVec& targetPoses, const AnimPoseVec& underPoses, float blendFactor) {
     // relax toward poses
-    const float blend = (1.0f / 60.0f) / (0.25f);
     int numJoints = (int)_relativePoses.size();
     for (int i = 0; i < numJoints; ++i) {
-        float dotSign = copysignf(1.0f, glm::dot(_relativePoses[i].rot(), poses[i].rot()));
+        float dotSign = copysignf(1.0f, glm::dot(_relativePoses[i].rot(), targetPoses[i].rot()));
         if (_accumulators[i].isDirty()) {
-            // this joint is affected by IK --> blend toward each pose rotation
-            _relativePoses[i].rot() = glm::normalize(glm::lerp(_relativePoses[i].rot(), dotSign * poses[i].rot(), blend));
+            // this joint is affected by IK --> blend toward the targetPoses rotation
+            _relativePoses[i].rot() = glm::normalize(glm::lerp(_relativePoses[i].rot(), dotSign * targetPoses[i].rot(), blendFactor));
         } else {
-            // this joint is NOT affected by IK --> slam to underPose rotation
-            _relativePoses[i].rot() = poses[i].rot();
+            // this joint is NOT affected by IK --> slam to underPoses rotation
+            _relativePoses[i].rot() = underPoses[i].rot();
         }
-        _relativePoses[i].trans() = poses[i].trans();
+        _relativePoses[i].trans() = underPoses[i].trans();
     }
 }
 
 void AnimInverseKinematics::initRelativePosesFromSolutionSource(SolutionSource solutionSource, const AnimPoseVec& underPoses) {
+    const float RELAX_BLEND_FACTOR = (1.0f / 16.0f);
+    const float COPY_BLEND_FACTOR = 1.0f;
     switch (solutionSource) {
     default:
     case SolutionSource::RelaxToUnderPoses:
-        relaxToPoses(underPoses);
+        blendToPoses(underPoses, underPoses, RELAX_BLEND_FACTOR);
         break;
     case SolutionSource::RelaxToLimitCenterPoses:
-        relaxToPoses(_limitCenterPoses);
+        blendToPoses(_limitCenterPoses, underPoses, RELAX_BLEND_FACTOR);
         break;
     case SolutionSource::PreviousSolution:
         // do nothing... _relativePoses is already the previous solution
@@ -1167,7 +1171,8 @@ void AnimInverseKinematics::initRelativePosesFromSolutionSource(SolutionSource s
         _relativePoses = underPoses;
         break;
     case SolutionSource::LimitCenterPoses:
-        _relativePoses = _limitCenterPoses;
+        // essentially copy limitCenterPoses over to _relativePoses.
+        blendToPoses(_limitCenterPoses, underPoses, COPY_BLEND_FACTOR);
         break;
     }
 }
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index a78662cbeb..f73ed95935 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -62,7 +62,7 @@ protected:
     virtual void setSkeletonInternal(AnimSkeleton::ConstPointer skeleton) override;
     void debugDrawConstraints(const AnimContext& context) const;
     void initRelativePosesFromSolutionSource(SolutionSource solutionSource, const AnimPoseVec& underPose);
-    void relaxToPoses(const AnimPoseVec& poses);
+    void blendToPoses(const AnimPoseVec& targetPoses, const AnimPoseVec& underPose, float blendFactor);
 
     // for AnimDebugDraw rendering
     virtual const AnimPoseVec& getPosesInternal() const override { return _relativePoses; }

From 0bcc3c023efdf8fc57bf0846d998f1e4369a61b2 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 9 May 2017 13:07:06 -0700
Subject: [PATCH 034/135] warning fixes

---
 libraries/animation/src/AnimInverseKinematics.cpp | 10 +++++-----
 libraries/animation/src/Rig.h                     |  2 +-
 libraries/animation/src/SwingTwistConstraint.h    |  4 ++--
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 11c14d8899..6ece8cdc3d 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -751,7 +751,7 @@ void AnimInverseKinematics::initConstraints() {
             swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta)));
 
             std::vector<float> minDots;
-            for (int i = 0; i < swungDirections.size(); i++) {
+            for (size_t i = 0; i < swungDirections.size(); i++) {
                 minDots.push_back(glm::dot(glm::normalize(swungDirections[i]), Vectors::UNIT_Y));
             }
             stConstraint->setSwingLimits(minDots);
@@ -961,11 +961,11 @@ void AnimInverseKinematics::initLimitCenterPoses() {
     const float UPPER_ARM_THETA = PI / 3.0f;  // 60 deg
     int leftArmIndex = _skeleton->nameToJointIndex("LeftArm");
     const glm::quat armRot = glm::angleAxis(UPPER_ARM_THETA, Vectors::UNIT_X);
-    if (leftArmIndex >= 0 && leftArmIndex < _limitCenterPoses.size()) {
+    if (leftArmIndex >= 0 && leftArmIndex < (int)_limitCenterPoses.size()) {
         _limitCenterPoses[leftArmIndex].rot() = _limitCenterPoses[leftArmIndex].rot() * armRot;
     }
     int rightArmIndex = _skeleton->nameToJointIndex("RightArm");
-    if (rightArmIndex >= 0 && rightArmIndex < _limitCenterPoses.size()) {
+    if (rightArmIndex >= 0 && rightArmIndex < (int)_limitCenterPoses.size()) {
         _limitCenterPoses[rightArmIndex].rot() = _limitCenterPoses[rightArmIndex].rot() * armRot;
     }
 }
@@ -1027,7 +1027,7 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
         AnimPoseVec poses = _skeleton->getRelativeDefaultPoses();
 
         // copy reference rotations into the relative poses
-        for (int i = 0; i < poses.size(); i++) {
+        for (int i = 0; i < (int)poses.size(); i++) {
             const RotationConstraint* constraint = getConstraint(i);
             if (constraint) {
                 poses[i].rot() = constraint->getReferenceRotation();
@@ -1040,7 +1040,7 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
         mat4 geomToWorldMatrix = context.getRigToWorldMatrix() * context.getGeometryToRigMatrix();
 
         // draw each pose and constraint
-        for (int i = 0; i < poses.size(); i++) {
+        for (int i = 0; i < (int)poses.size(); i++) {
             // transform local axes into world space.
             auto pose = poses[i];
             glm::vec3 xAxis = transformVectorFast(geomToWorldMatrix, pose.rot() * Vectors::UNIT_X);
diff --git a/libraries/animation/src/Rig.h b/libraries/animation/src/Rig.h
index 396e68d633..bee6518557 100644
--- a/libraries/animation/src/Rig.h
+++ b/libraries/animation/src/Rig.h
@@ -112,7 +112,7 @@ public:
     void clearJointStates();
     void clearJointAnimationPriority(int index);
 
-    std::shared_ptr<AnimInverseKinematics> Rig::getAnimInverseKinematicsNode() const;
+    std::shared_ptr<AnimInverseKinematics> getAnimInverseKinematicsNode() const;
 
     void clearIKJointLimitHistory();
     void setMaxHipsOffsetLength(float maxLength);
diff --git a/libraries/animation/src/SwingTwistConstraint.h b/libraries/animation/src/SwingTwistConstraint.h
index ffe9a1d800..a41664d353 100644
--- a/libraries/animation/src/SwingTwistConstraint.h
+++ b/libraries/animation/src/SwingTwistConstraint.h
@@ -101,8 +101,8 @@ public:
 
     virtual glm::quat computeCenterRotation() const override;
 
-    const float getMinTwist() const { return _minTwist; }
-    const float getMaxTwist() const { return _maxTwist; }
+    float getMinTwist() const { return _minTwist; }
+    float getMaxTwist() const { return _maxTwist; }
 
 private:
     float handleTwistBoundaryConditions(float twistAngle) const;

From d7f195bc42cd48fae022797240c936114cdebd07 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 9 May 2017 13:17:06 -0700
Subject: [PATCH 035/135] warning fix

---
 libraries/animation/src/AnimNodeLoader.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/animation/src/AnimNodeLoader.cpp b/libraries/animation/src/AnimNodeLoader.cpp
index 6e2c070ae5..6bc7342d7f 100644
--- a/libraries/animation/src/AnimNodeLoader.cpp
+++ b/libraries/animation/src/AnimNodeLoader.cpp
@@ -352,7 +352,7 @@ static AnimOverlay::BoneSet stringToBoneSetEnum(const QString& str) {
     return AnimOverlay::NumBoneSets;
 }
 
-static const char* solutionSourceStrings[AnimInverseKinematics::SolutionSource::NumSolutionSources] = {
+static const char* solutionSourceStrings[(int)AnimInverseKinematics::SolutionSource::NumSolutionSources] = {
     "relaxToUnderPoses",
     "relaxToLimitCenterPoses",
     "previousSolution",

From e63dc52ec9a2574926b573866846a70d807447a1 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 9 May 2017 13:59:07 -0700
Subject: [PATCH 036/135] moar warning fixes

---
 libraries/animation/src/AnimInverseKinematics.cpp | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 6ece8cdc3d..92c74b1793 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -1075,9 +1075,6 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
                     glm::quat minRot = glm::angleAxis(elbowConstraint->getMinAngle(), elbowConstraint->getHingeAxis());
                     glm::quat maxRot = glm::angleAxis(elbowConstraint->getMaxAngle(), elbowConstraint->getHingeAxis());
 
-                    glm::vec3 minYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * minRot * refRot * Vectors::UNIT_Y);
-                    glm::vec3 maxYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * maxRot * refRot * Vectors::UNIT_Y);
-
                     const int NUM_SWING_STEPS = 10;
                     for (int i = 0; i < NUM_SWING_STEPS + 1; i++) {
                         glm::quat rot = glm::normalize(glm::lerp(minRot, maxRot, i * (1.0f / NUM_SWING_STEPS)));
@@ -1096,9 +1093,6 @@ void AnimInverseKinematics::debugDrawConstraints(const AnimContext& context) con
                         glm::quat minRot = glm::angleAxis(swingTwistConstraint->getMinTwist(), Vectors::UNIT_Y);
                         glm::quat maxRot = glm::angleAxis(swingTwistConstraint->getMaxTwist(), Vectors::UNIT_Y);
 
-                        glm::vec3 minTwistYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * minRot * refRot * Vectors::UNIT_X);
-                        glm::vec3 maxTwistYAxis = transformVectorFast(geomToWorldMatrix, parentAbsRot * maxRot * refRot * Vectors::UNIT_X);
-
                         const int NUM_SWING_STEPS = 10;
                         for (int i = 0; i < NUM_SWING_STEPS + 1; i++) {
                             glm::quat rot = glm::normalize(glm::lerp(minRot, maxRot, i * (1.0f / NUM_SWING_STEPS)));

From a7cc58245993bfdc3c3cbd6c0b3e54a610fb3711 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Wed, 10 May 2017 10:32:43 +1200
Subject: [PATCH 037/135] Don't multiply heartbeats

---
 scripts/system/playRecordingAC.js | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index b4fae9a2e3..6c7a5eb8b1 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -368,13 +368,16 @@
         };
     }());
 
-    function sendHeartbeat() {
+    function sendHeartbeat(isOneShot) {
         Messages.sendMessage(HIFI_RECORDER_CHANNEL, JSON.stringify({
             playing: Player.isPlaying(),
             recording: Player.recording(),
             entity: Entity.id()
         }));
-        heartbeatTimer = Script.setTimeout(sendHeartbeat, HEARTBEAT_INTERVAL);
+
+        if (!isOneShot) {
+            heartbeatTimer = Script.setTimeout(sendHeartbeat, HEARTBEAT_INTERVAL);
+        }
     }
 
     function stopHeartbeat() {
@@ -398,12 +401,12 @@
                 } else {
                     log("Didn't start playing " + message.recording + " because already playing " + Player.recording());
                 }
-                sendHeartbeat();
+                sendHeartbeat(true);
                 break;
             case PLAYER_COMMAND_STOP:
                 Player.stop();
                 Player.autoPlay();  // There may be another recording to play.
-                sendHeartbeat();
+                sendHeartbeat(true);
                 break;
             }
         }

From 771b76690cff33cfac07f0fbcf4ec72b3c80086b Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Wed, 10 May 2017 10:56:23 +1200
Subject: [PATCH 038/135] Clear timeout that checks recording started when stop
 recording

---
 scripts/system/record.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/scripts/system/record.js b/scripts/system/record.js
index 3db82696ef..f612fea80d 100644
--- a/scripts/system/record.js
+++ b/scripts/system/record.js
@@ -350,7 +350,7 @@
             // Cancel check that recording started playing.
             index = playerIDs.indexOf(playerID);
             if (index !== -1 && playerStartupTimeouts[index] !== null) {
-                // Cannot clearTimeout() without program log error, so just set null.
+                Script.clearTimeout(playerStartupTimeouts[index]);
                 playerStartupTimeouts[index] = null;
             }
 
@@ -374,6 +374,7 @@
             if (index === -1) {
                 index = playerIDs.length;
                 playerIDs[index] = sender;
+                playerStartupTimeouts[index] = null;
             }
             playerIsPlayings[index] = message.playing;
             playerRecordings[index] = message.recording;

From c2d22a1246248e49b9454449df84a6483e02bbf3 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Wed, 10 May 2017 10:57:53 +1200
Subject: [PATCH 039/135] Log stopping playing recording

---
 scripts/system/record.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/scripts/system/record.js b/scripts/system/record.js
index f612fea80d..4d5427c874 100644
--- a/scripts/system/record.js
+++ b/scripts/system/record.js
@@ -524,6 +524,7 @@
                     break;
                 case STOP_PLAYING_RECORDING_ACTION:
                     // Stop the specified player.
+                    log("Unload recording " + message.value);
                     Player.stopPlayingRecording(message.value);
                     break;
                 case LOAD_RECORDING_ACTION:

From 5a11911e1d49bfa7e6b23ea3dd555b1f5c0c2aab Mon Sep 17 00:00:00 2001
From: Zach Pomerantz <zmp@umich.edu>
Date: Tue, 9 May 2017 19:38:52 -0400
Subject: [PATCH 040/135] close audio device when switching

---
 libraries/audio-client/src/AudioClient.cpp | 1 +
 libraries/audio-client/src/AudioClient.h   | 1 -
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/audio-client/src/AudioClient.cpp b/libraries/audio-client/src/AudioClient.cpp
index dae37ffc4b..440bfefe28 100644
--- a/libraries/audio-client/src/AudioClient.cpp
+++ b/libraries/audio-client/src/AudioClient.cpp
@@ -1504,6 +1504,7 @@ bool AudioClient::switchOutputToAudioDevice(const QAudioDeviceInfo& outputDevice
 
     // cleanup any previously initialized device
     if (_audioOutput) {
+        _audioOutputIODevice.close();
         _audioOutput->stop();
 
         delete _audioOutput;
diff --git a/libraries/audio-client/src/AudioClient.h b/libraries/audio-client/src/AudioClient.h
index 0e5363e0ff..9bdf55504c 100644
--- a/libraries/audio-client/src/AudioClient.h
+++ b/libraries/audio-client/src/AudioClient.h
@@ -94,7 +94,6 @@ public:
             _audio(audio), _unfulfilledReads(0) {}
 
         void start() { open(QIODevice::ReadOnly | QIODevice::Unbuffered); }
-        void stop() { close(); }
         qint64 readData(char * data, qint64 maxSize) override;
         qint64 writeData(const char * data, qint64 maxSize) override { return 0; }
         int getRecentUnfulfilledReads() { int unfulfilledReads = _unfulfilledReads; _unfulfilledReads = 0; return unfulfilledReads; }

From a15c5999b5ae6845457ec386c9fbb8a496ea0bf1 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Wed, 10 May 2017 16:58:51 -0700
Subject: [PATCH 041/135] first cut at octree storage of Triangle Set

---
 interface/src/Application.cpp        |   2 +-
 libraries/render-utils/src/Model.cpp |   4 +-
 libraries/shared/src/AABox.cpp       |  41 +++++++
 libraries/shared/src/AABox.h         |  15 +++
 libraries/shared/src/TriangleSet.cpp | 159 ++++++++++++++++++++++++++-
 libraries/shared/src/TriangleSet.h   |  66 ++++++++++-
 6 files changed, 274 insertions(+), 13 deletions(-)

diff --git a/interface/src/Application.cpp b/interface/src/Application.cpp
index 8220b3e891..01b855bb73 100644
--- a/interface/src/Application.cpp
+++ b/interface/src/Application.cpp
@@ -336,7 +336,7 @@ public:
 
                 // Don't actually crash in debug builds, in case this apparent deadlock is simply from
                 // the developer actively debugging code
-                #ifdef NDEBUG
+                #if 0 //def NDEBUG
                     deadlockDetectionCrash();
                 #endif
             }
diff --git a/libraries/render-utils/src/Model.cpp b/libraries/render-utils/src/Model.cpp
index acc84646c5..2c338674eb 100644
--- a/libraries/render-utils/src/Model.cpp
+++ b/libraries/render-utils/src/Model.cpp
@@ -376,7 +376,7 @@ bool Model::findRayIntersectionAgainstSubMeshes(const glm::vec3& origin, const g
         glm::vec3 meshFrameOrigin = glm::vec3(worldToMeshMatrix * glm::vec4(origin, 1.0f));
         glm::vec3 meshFrameDirection = glm::vec3(worldToMeshMatrix * glm::vec4(direction, 0.0f));
 
-        for (const auto& triangleSet : _modelSpaceMeshTriangleSets) {
+        for (auto& triangleSet : _modelSpaceMeshTriangleSets) {
             float triangleSetDistance = 0.0f;
             BoxFace triangleSetFace;
             glm::vec3 triangleSetNormal;
@@ -462,6 +462,8 @@ bool Model::convexHullContains(glm::vec3 point) {
 void Model::calculateTriangleSets() {
     PROFILE_RANGE(render, __FUNCTION__);
 
+    qDebug() << __FUNCTION__ << "url:" << _url;
+
     const FBXGeometry& geometry = getFBXGeometry();
     int numberOfMeshes = geometry.meshes.size();
 
diff --git a/libraries/shared/src/AABox.cpp b/libraries/shared/src/AABox.cpp
index 3f3146cc04..cea0a83d52 100644
--- a/libraries/shared/src/AABox.cpp
+++ b/libraries/shared/src/AABox.cpp
@@ -114,6 +114,10 @@ static bool isWithin(float value, float corner, float size) {
     return value >= corner && value <= corner + size;
 }
 
+bool AABox::contains(const Triangle& triangle) const {
+    return contains(triangle.v0) && contains(triangle.v1) && contains(triangle.v2);
+}
+
 bool AABox::contains(const glm::vec3& point) const {
     return isWithin(point.x, _corner.x, _scale.x) &&
         isWithin(point.y, _corner.y, _scale.y) &&
@@ -622,3 +626,40 @@ void AABox::transform(const glm::mat4& matrix) {
     _corner = newCenter - newDir;
     _scale = newDir * 2.0f;
 }
+
+AABox AABox::getOctreeChild(OctreeChild child) const {
+    AABox result(*this); // self
+    switch (child) {
+        case topLeftNear:
+            result._corner.y += _scale.y / 2.0f;
+            break;
+        case topLeftFar:
+            result._corner.y += _scale.y / 2.0f;
+            result._corner.z += _scale.z / 2.0f;
+            break;
+        case topRightNear:
+            result._corner.y += _scale.y / 2.0f;
+            result._corner.x += _scale.x / 2.0f;
+            break;
+        case topRightFar:
+            result._corner.y += _scale.y / 2.0f;
+            result._corner.x += _scale.x / 2.0f;
+            result._corner.z += _scale.z / 2.0f;
+            break;
+        case bottomLeftNear:
+            // _corner = same as parent
+            break;
+        case bottomLeftFar:
+            result._corner.z += _scale.z / 2.0f;
+            break;
+        case bottomRightNear:
+            result._corner.x += _scale.x / 2.0f;
+            break;
+        case bottomRightFar:
+            result._corner.x += _scale.x / 2.0f;
+            result._corner.z += _scale.z / 2.0f;
+            break;
+    }
+    result._scale /= 2.0f; // everything is half the scale
+    return result;
+}
diff --git a/libraries/shared/src/AABox.h b/libraries/shared/src/AABox.h
index a53cc26163..eef83974ea 100644
--- a/libraries/shared/src/AABox.h
+++ b/libraries/shared/src/AABox.h
@@ -20,6 +20,7 @@
 #include <QDebug>
 
 #include "BoxBase.h"
+#include "GeometryUtil.h"
 #include "StreamUtils.h"
 
 class AACube;
@@ -58,6 +59,7 @@ public:
     const glm::vec3& getMinimumPoint() const { return _corner; }
     glm::vec3 getMaximumPoint() const { return calcTopFarLeft(); }
 
+    bool contains(const Triangle& triangle) const;
     bool contains(const glm::vec3& point) const;
     bool contains(const AABox& otherBox) const;
     bool touches(const AABox& otherBox) const;
@@ -112,6 +114,19 @@ public:
 
     void clear() { _corner = INFINITY_VECTOR; _scale = glm::vec3(0.0f); }
 
+    typedef enum {
+        topLeftNear,
+        topLeftFar,
+        topRightNear,
+        topRightFar,
+        bottomLeftNear,
+        bottomLeftFar,
+        bottomRightNear,
+        bottomRightFar
+    } OctreeChild;
+
+    AABox getOctreeChild(OctreeChild child) const; // returns the AABox of the would be octree child of this AABox
+
 private:
     glm::vec3 getClosestPointOnFace(const glm::vec3& point, BoxFace face) const;
     glm::vec3 getClosestPointOnFace(const glm::vec4& origin, const glm::vec4& direction, BoxFace face) const;
diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index cdb3fd6b2c..e13d8b126f 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -12,7 +12,22 @@
 #include "GLMHelpers.h"
 #include "TriangleSet.h"
 
-void TriangleSet::insert(const Triangle& t) {
+
+
+bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+    float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision) {
+
+    if (!_isBalanced) {
+        balanceOctree();
+    }
+
+    int trianglesTouched = 0;
+    auto result = _triangleOctree.findRayIntersection(origin, direction, distance, face, surfaceNormal, precision, trianglesTouched);
+    qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
+    return result;
+}
+
+void InternalTriangleSet::insert(const Triangle& t) {
     _triangles.push_back(t);
 
     _bounds += t.v0;
@@ -20,15 +35,15 @@ void TriangleSet::insert(const Triangle& t) {
     _bounds += t.v2;
 }
 
-void TriangleSet::clear() {
+void InternalTriangleSet::clear() {
     _triangles.clear();
     _bounds.clear();
 }
 
 // Determine of the given ray (origin/direction) in model space intersects with any triangles
 // in the set. If an intersection occurs, the distance and surface normal will be provided.
-bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
-                    float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision) const {
+bool InternalTriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+            float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
 
     bool intersectedSomething = false;
     float boxDistance = std::numeric_limits<float>::max();
@@ -38,6 +53,7 @@ bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3&
         if (precision) {
             for (const auto& triangle : _triangles) {
                 float thisTriangleDistance;
+                trianglesTouched++;
                 if (findRayTriangleIntersection(origin, direction, triangle, thisTriangleDistance)) {
                     if (thisTriangleDistance < bestDistance) {
                         bestDistance = thisTriangleDistance;
@@ -57,7 +73,7 @@ bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3&
 }
 
 
-bool TriangleSet::convexHullContains(const glm::vec3& point) const {
+bool InternalTriangleSet::convexHullContains(const glm::vec3& point) const {
     if (!_bounds.contains(point)) {
         return false;
     }
@@ -74,3 +90,136 @@ bool TriangleSet::convexHullContains(const glm::vec3& point) const {
     return insideMesh;
 }
 
+void TriangleSet::debugDump() {
+    qDebug() << __FUNCTION__;
+    qDebug() << "bounds:" << getBounds();
+    qDebug() << "triangles:" << size() << "at top level....";
+    qDebug() << "----- _triangleOctree -----";
+    _triangleOctree.debugDump();
+}
+
+void TriangleSet::balanceOctree() {
+    _triangleOctree.reset(_bounds, 0);
+    for (const auto& triangle : _triangles) {
+        _triangleOctree.insert(triangle);
+    }
+    _isBalanced = true;
+}
+
+static const int MAX_DEPTH = 3; // for now
+static const int MAX_CHILDREN = 8;
+
+TriangleOctreeCell::TriangleOctreeCell(const AABox& bounds, int depth) {
+    reset(bounds, depth);
+}
+
+void TriangleOctreeCell::clear() {
+    _triangleSet.clear();
+    _population = 0;
+}
+
+void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
+    //qDebug() << __FUNCTION__ << "bounds:" << bounds << "depth:" << depth;
+    clear();
+    _triangleSet._bounds = bounds;
+    _depth = depth;
+    if (depth <= MAX_DEPTH) {
+        int childDepth = depth + 1;
+        _children.clear();
+        for (int child = 0; child < MAX_CHILDREN; child++) {
+            AABox childBounds = getBounds().getOctreeChild((AABox::OctreeChild)child);
+            /*
+            qDebug() << __FUNCTION__ << "bounds:" << bounds << "depth:" << depth 
+                        << "child:" << child << "childBounds:" << childBounds << "childDepth:" << childDepth;
+            */
+
+            _children.push_back(TriangleOctreeCell(childBounds, childDepth));
+        }
+    }
+}
+
+void TriangleOctreeCell::debugDump() {
+    qDebug() << __FUNCTION__;
+    qDebug() << "bounds:" << getBounds();
+    qDebug() << "depth:" << _depth;
+    qDebug() << "triangleSet:" << _triangleSet.size() << "at this level";
+    qDebug() << "population:" << _population << "this level or below";
+    if (_depth < MAX_DEPTH) {
+        int childNum = 0;
+        for (auto& child : _children) {
+            qDebug() << "child:" << childNum;
+            child.debugDump();
+            childNum++;
+        }
+    }
+}
+
+void TriangleOctreeCell::insert(const Triangle& t) {
+    _population++;
+    // if we're not yet at the max depth, then check which child the triangle fits in
+    if (_depth < MAX_DEPTH) {
+        for (auto& child : _children) {
+            if (child.getBounds().contains(t)) {
+                child.insert(t);
+                return;
+            }
+        }
+    }
+    // either we're at max depth, or the triangle doesn't fit in one of our
+    // children and so we want to just record it here
+    _triangleSet.insert(t);
+}
+
+bool TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+                float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
+
+    if (_population < 1) {
+        return false; // no triangles below here, so we can't intersect
+    }
+
+    float bestLocalDistance = std::numeric_limits<float>::max();
+    BoxFace bestLocalFace;
+    glm::vec3 bestLocalNormal;
+    bool intersects = false;
+
+    // if the ray intersects our bounding box, then continue
+    if (getBounds().findRayIntersection(origin, direction, bestLocalDistance, bestLocalFace, bestLocalNormal)) {
+        bestLocalDistance = std::numeric_limits<float>::max();
+
+        float childDistance = std::numeric_limits<float>::max();
+        BoxFace childFace;
+        glm::vec3 childNormal;
+
+        // if we're not yet at the max depth, then check which child the triangle fits in
+        if (_depth < MAX_DEPTH) {
+            for (auto& child : _children) {
+                // check each child, if there's an intersection, it will return some distance that we need
+                // to compare against the other results, because there might be multiple intersections and
+                // we will always choose the best (shortest) intersection
+                if (child.findRayIntersection(origin, direction, childDistance, childFace, childNormal, precision, trianglesTouched)) {
+                    if (childDistance < bestLocalDistance) {
+                        bestLocalDistance = childDistance;
+                        bestLocalFace = childFace;
+                        bestLocalNormal = childNormal;
+                        intersects = true;
+                    }
+                }
+            }
+        }
+        // also check our local triangle set
+        if (_triangleSet.findRayIntersection(origin, direction, childDistance, childFace, childNormal, precision, trianglesTouched)) {
+            if (childDistance < bestLocalDistance) {
+                bestLocalDistance = childDistance;
+                bestLocalFace = childFace;
+                bestLocalNormal = childNormal;
+                intersects = true;
+            }
+        }
+    }
+    if (intersects) {
+        distance = bestLocalDistance;
+        face = bestLocalFace;
+        surfaceNormal = bestLocalNormal;
+    }
+    return intersects;
+}
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index b54f1a642a..c8703c6445 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -14,20 +14,21 @@
 #include "AABox.h"
 #include "GeometryUtil.h"
 
-class TriangleSet {
+class InternalTriangleSet {
 public:
+    InternalTriangleSet() { }
+
     void reserve(size_t size) { _triangles.reserve(size); } // reserve space in the datastructure for size number of triangles
     size_t size() const { return _triangles.size(); } 
 
-    const Triangle& getTriangle(size_t t) const { return _triangles[t]; }
-
-    void insert(const Triangle& t);
+    virtual void insert(const Triangle& t);
     void clear();
 
     // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
     // intersection occurs, the distance and surface normal will be provided.
+    // note: this might side-effect internal structures
     bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction, 
-        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision) const;
+        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
 
     // Determine if a point is "inside" all the triangles of a convex hull. It is the responsibility of the caller to
     // determine that the triangle set is indeed a convex hull. If the triangles added to this set are not in fact a 
@@ -35,7 +36,60 @@ public:
     bool convexHullContains(const glm::vec3& point) const;
     const AABox& getBounds() const { return _bounds; }
 
-private:
+protected:
     std::vector<Triangle> _triangles;
     AABox _bounds;
+
+    friend class TriangleOctreeCell;
+};
+
+class TriangleOctreeCell {
+public:
+    TriangleOctreeCell() { }
+
+    void insert(const Triangle& t);
+    void reset(const AABox& bounds, int depth = 0);
+    void clear();
+
+    // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
+    // intersection occurs, the distance and surface normal will be provided.
+    bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
+
+    const AABox& getBounds() const { return _triangleSet.getBounds(); }
+
+    void debugDump();
+
+protected:
+    TriangleOctreeCell(const AABox& bounds, int depth);
+
+    InternalTriangleSet _triangleSet;
+    std::vector<TriangleOctreeCell> _children;
+    int _depth { 0 };
+    int _population { 0 };
+
+    friend class TriangleSet;
+};
+
+class TriangleSet : public InternalTriangleSet {
+    // pass through public implementation all the features of InternalTriangleSet
+public:
+    TriangleSet() { }
+
+    void debugDump();
+
+    virtual void insert(const Triangle& t) {
+        _isBalanced = false;
+        InternalTriangleSet::insert(t);
+    }
+
+    bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision);
+
+    void balanceOctree();
+
+protected:
+
+    bool _isBalanced { false };
+    TriangleOctreeCell _triangleOctree;
 };

From f98c3556fd0011150e35dc20275434b6321ac014 Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Thu, 11 May 2017 01:08:04 +0100
Subject: [PATCH 042/135] create a wispy smoke texture

---
 interface/resources/images/Smoke.png       | Bin 131940 -> 0 bytes
 interface/resources/images/wispy-smoke.png | Bin 0 -> 79835 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 interface/resources/images/Smoke.png
 create mode 100644 interface/resources/images/wispy-smoke.png

diff --git a/interface/resources/images/Smoke.png b/interface/resources/images/Smoke.png
deleted file mode 100644
index d1b4d8cac9be3a6c7e0bf3f935e09c74d2df2703..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 131940
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
O0000<MNUMnLSTaF9Fffc

diff --git a/interface/resources/images/wispy-smoke.png b/interface/resources/images/wispy-smoke.png
new file mode 100644
index 0000000000000000000000000000000000000000..6c781c824befad6e069574c51eecc309f06047d6
GIT binary patch
literal 79835
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

literal 0
HcmV?d00001


From 7edda8733027c4df9340edd76570141659e13298 Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Thu, 11 May 2017 01:21:42 +0100
Subject: [PATCH 043/135] change default particle to wispy smoke

---
 scripts/system/edit.js | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/scripts/system/edit.js b/scripts/system/edit.js
index 28d7b89209..b06aeb2320 100644
--- a/scripts/system/edit.js
+++ b/scripts/system/edit.js
@@ -504,30 +504,30 @@ var toolBar = (function () {
                     blue: 0
                 },
                 emitAcceleration: {
-                    x: 0.5,
-                    y: 1.5,
-                    z: 0.5
+                    x: 0,
+                    y: 5,
+                    z: 0
                 },
                 accelerationSpread: {
-                    x: 1.0,
-                    y: 0.0,
-                    z: 1.0
+                    x: 1,
+                    y: 0,
+                    z: 1
                 },
-                emitRate: 10,
-                emitSpeed: 2,
+                emitRate: 3,
+                emitSpeed: 0,
                 speedSpread: 0,
                 lifespan: 1,
-                maxParticles: 100,
+                maxParticles: 10,
                 particleRadius: 0.25,
-                radiusStart: 0.05,
-                radiusFinish: 0.25,
-                radiusSpread: 0.5,
+                radiusStart: 0,
+                radiusFinish: 0.1,
+                radiusSpread: 0,
                 alpha: 0,
-                alphaStart: 0.5,
+                alphaStart: 0.1,
                 alphaFinish: 0,
                 polarStart: 0,
                 polarFinish: 0,
-                textures: "https://hifi-content.s3.amazonaws.com/DomainContent/production/Particles/Smoke.png"
+                textures: "https://raw.githubusercontent.com/Triplelexx/hifi/f98c3556fd0011150e35dc20275434b6321ac014/interface/resources/images/wispy-smoke.png"
             });
         });
 

From 90432562df729c8961ab297bacc698562309ba0b Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Thu, 11 May 2017 01:23:21 +0100
Subject: [PATCH 044/135] remove unapproved texture

---
 interface/resources/images/wispy-smoke.png | Bin 79835 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 interface/resources/images/wispy-smoke.png

diff --git a/interface/resources/images/wispy-smoke.png b/interface/resources/images/wispy-smoke.png
deleted file mode 100644
index 6c781c824befad6e069574c51eecc309f06047d6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 79835
zcmXt8bx<43(+&jp0EOTXtf4IyC@#gFqNPwAg1ZEFcPkL2NO6jl;$Eyku;MPE&_c1|
z{>}TF`EF+ayW5$)eQuxU?l$(Vh9WTmEdc-kAXZkA(*^)A0RI^t4gdi7;9da-001}^
zs)}-e|BV~jj$i-)fbXjG-U9$2r1;M;06BSJ004mNsjM!KyM;|a%^@iI@yQ$j05I6;
z8hFaOI5}B6d;V{|th=?jr?nL`!p_r{Sy5U2trfR5E&#v`P?me6>$Chfa3zU;$?Y&M
zrVCcxo=aIdoxp5VPqN8*Fh^D>bVqS-Ci{pToUnCF2A8w~^oN)O{dgUFB~#dyzDB|5
z(~Lj*D-QTBHpDNDp!Ua7WS1qeUCTP!xn5Lrp_?rR3BLQcw}}lVWA(=V*w}J#>m-R$
zvZ)J3)9>zW9jVDR3op#A{1q8PUo6yL)_Zq81^WxNXi7a~1YP$tZJ$j_4f6!wsCN3C
zhIQZn8@su3Lw{WqotO-MJZoIoo(#H#wU416#a4d@cKZlrBdqVo(38Ohbl0n!?-Iac
z8|a&FTY!1)X2j9XqY&-gf35-^Z}zTlCWDWHuMokC1;LLuZ3q50UDvCd$M&-iZdY#L
z;~5-DA6(Z0p~u&fU#ta8#q_1>e%&~AJ$|=CeeO}*S?K6qxC`PqKIrf%SU}kn1V&9t
z-u*RMxE4+lW=yt8eB!3*+qfU!AOpnU4Y>_$JRWX5ws`OV0Y1l=FbOakx(->$2_CWe
z?Dn)`OzaKP+Z{SSWZ6@Vx$*Zm9eQFB%e%4Mi+VycJ%M|!2YK`hJlx#g)R}bsbH0CQ
zUO99Xrhm<Pn<Jb3R9giA!1~iUH6K^9u+F;^o-l^IST7{6?ghg)RDNyD-5I_BJ#xxz
zUgf_Ey8ToB%@gb4a%Y4h;O1A>;_=n_?`c+gl4zaT<R^b&Twd5J1CMF<Ksu-9<`FL}
z;NfBcAzA+DN7@H^Tz~@*iLV`)w<Hovq@r8s*9_x=H`1(vOwRV!7qXA{SJz8f+f;qe
z*CBJL>)_LP)6Hn9dzPeOR*c@`per$ebj`E72gakMy~%=&nDd9%NvtTMeqL!gS1+$f
zH+r|gz`(eZI+HF@f9{QkBLoYieBt4Vy;q{=#|piSP}y}ZkQvc~U^7;p)b#Shy?0ja
znWULr(OB6Sa_j!Xx85>caM$TS`*e*?Zp*-gE7UxD_wF4ptkdUo+cVpZo{tFFCZ+;i
zJid}70va0|hsH?DarXCgcYA~Swp>G&auahNf|A|nSs>RB$HAm}k;wc(QptyNo!jc3
z+iFrt!osT?c^=k{S9`v|&>qEyAE)9*z<-jnvv);;|K`v9-k(bvrMBd)yvIFnEO<x=
zx<@n3{1<gjS#0<1{tMIz)n9M1);s7grl>yo2yK-K6f@*$Ctb5*e!pXl1eKsoz(9g4
zMNdKo`ftyJ#2NY2DZYoA(GSlY&j^IZ@Tya2tN1+L-_#u6$ns!c2LeORVuGn{E&#pz
zR$v!ay{D<s(x%}&-%nSQMN+#fn1BTnmmtPH=e6se>+N`w-sxYz*fCPpoD~5-P)c&Y
z|NTpIpJ0QCC$SnE8&3}oVs~G49sf5c@cwkTbLG$nj6)9E$%F2x4WmyzB}Huf?yva*
z&!-jHAm28Qp^Tc;)YRwUO!pz)9Sn?8K?&8>)r|_lM$ucrf;g@PevfpR_D@c|O?Tc{
znaS@RjMg*tx{^)K|B1F9egGbpCrdqEW36NKZn-i8GPL;tX7Kj*c1#$0f1dynW)7}j
zIdt{)Rla-pWYXpL>nO>v`sz0~M1TkwWexys?eCASF+c?=prruY!ydbw6px|mcXb+d
zvT|gpMyyZKnQlL$UHdl586|Yk=npSWS*WiAXHH0=)dnFIxf&<N1qT~X4;wR@LI2X#
zfdzqCVMEzipjQqD>vLNl51O+8-7AMF+L$n%31n?;?a8zvlX=UEFLcmjLYxR#TUS?;
zv0b%4jGnHmtLsDU9JwNnC#+jmd{yx4OuD|G`e4B<TUN|lR<?Y^{c4^?_ZK}SWsr08
z@SO5I{o~0^+6<%!mdqwMV}IzFZttiWN4%4nBzIW!IW%IJY8&Qxx^ya^GumT(ax}lc
zclvao8T60B6nZv43Sfmi{cW85J)<f0>*Imvp*VC;?e5`|w#vWjQ%m3T-=M=Q|Mu3_
z!uWVXZ$wU6EH@92FBqqysyyR)sT^AP=ingr;gvsQ6h>B7mJ-w)j8l@~Dop>|N8AF8
z<9C03I?{V}C-Gk*^I+WE+<x!fM*)xblTY`=(kB=+%TJx;n?#lqyIS@n=QROJo>^bb
zSO-h2B?59ey9s0WoD^o8JVa&1Ot5t(KUj&wI0AFEem_0lJ(Wt`N(JvA?vFw*eDUx9
zW%ZQoO%|Zbr5>PVcHiTvd43D^+z>M)D}L%hAUHwhpf@V`9cv_L;joz2jIgmWRShTz
z<g22Lq=D~3+3AxNCq?>Ey{OjiZUrcIDWwpsB;&2hpHd(N2t|~YmBkC|X>b3Z+t108
zm;mwM$JNkznfpVR;CP$KPisEMW6r&u1O6NAeRn?qenkSwYC=BC2&@WQLhuLLJLBvS
z#5lpa!qAEO{#IM6i?Pz#OB-(uyUV~8rzKVKf;EZ3r%AX*@Okj#kAmO}!7iW2wA#8l
zJN(O6C)vKD#}5JjRg1^_v&n~aP02paf&dx7_2*>CG;{FvNIIvdudgzcogB1ueC6)u
z*4MGdZES2@T3!8uaX8g|f_`XH#Af->o8k9a26+sghz&0+%Dh)VeE_BFAYb!wwM)^P
zDJs-`V)4-1)5~j+DexTh-+@i73PbX#Q=k&GRlcnp{)g4AQ}i$|Ea3ih_^KQJIBW@U
zWBGBf+M}B9H`aCwTrYQ_IdoD8m|OyMz9KR|Y$AzfjpcQp=-&Ptpk-<a_i1+RRUMXY
zbnF9UclaNtmS->y3>(}}oH=aPJ>Aw}0D@1cgIS&~OrL&feiCN^oL8GZ#PwWn6N)e<
zQ)%f(nQ!L7+QjzqQnmjnCNsW~(-<BT(NP)U;o*@e-GRgVd0VS)1=Np@vdi#!OuNsi
zc}&PaZAf20V3(JYoE!$(^57u$>RR~o9hBOPz#F;yc%E+QO+s$S^?y0sczV3L{-YTj
zCv}r9)fdz=T=1||uy$a0{W?$9uYyGi>uo%f7c0>1i{_>|tIi25sylD_>>20D(Cj(`
z<T^IRlj-QYtiz49qS<3>|CaO-&hB|sxck+w1}FFwy@mlg$S}j)VAba6sFd>CkA;Ad
zi!p~~)1$!g#l58wBr>_J@wDfDtf$2A#qpK@BU<Xw^6B9?cq1J9@~(>vgruphtAk2Q
z(hR2#yJ5lZoLj<?AW$f>VdI!MWG~M@D<nn<NrNKN^Foxn(c9&43_R3U?HqxlLZi&3
zq1Z=9C^b|<d^}-H%z|O%eB7g-#6MFL6B#`*aBT2hOR%iU9|570=C5HbgS3Guz-t_y
zc7eDcb7z{1`D3G~1B8-<%WRQH)E3V38|Hwm+KAj&GPB~(3i3@g-}j;R@_uv*{KJmx
z&ZT)w>|=+a4Xa~g5DC4g6pu@up8GWK4vB1<;R9B_)0*tT999E2@5d#Zf@z+hQ^MPw
zbj_3VKRUPj)pb}QQvR1OvE!5FBTTvj{`B)s{rY9C0o5wG&hUte$&PUaZ^ZuXM;#r#
zgqWzX=+#saAUNS1Fj+Zo3J}SM5V?rr53T^ly1f~J|M*6ICc-Y~-bcK>YF+8(KL~yJ
z@L_7ET(fH?HTa_1G!V_~w~(}8tn4heb4-u5T8OsT!g{UgYX0F-y1en1`0MCI{jX{1
z!1ov~`bN$hJF4rw&&f8k3U0o%`hOQzCIi7!3#cb*%D0{2-mQ|Z4pDt;MD}r}Px}kH
zWtgcEd9a51J(fG#=OUADzsKMM{?n9A&y@-SFKIrB`+ldUrq1xl%!5h!{)_kz?H{?h
zxwB(#8`w&Bwur1+R!)O@_TuB?B@g$8(bMh|o^Ec_!}Zlwet;07UTu|Ct-Fe={FprC
zo<@H0002M@N+ywc+U`UB5JB(nSHZ}P<u;H0lU=Q1*~nt-SgGr9scU`vr@OS(pDnic
zt>Hy=evQ5={wrrxSJMpi{Z1Y@-H{Am<Qwk_Z_kj?9fA6<AcKQVRPX)cNc98}t#}k5
zFZ8hj&x<u`cZ8btKf~${5p0892qq}hs5%$Xc)EP!|99w<2OQvY`Im+#57WD2Epc*t
zB%Sj<`RO|O{QQs3%{4mt#z(xYuIEuS@ab*?7dCUYH)#&nbr|F&a)e`rT-|m3z4DL2
z%WhLV5M@QDRH;<ce-WvDEw%||ui%oys@e~wuIMmA#W2$kj_@U*m8$lm`!Sm4X9Tu>
z{bDDH?#HM63j;1JEP$i>kjS9(&rH59)ZK}?k4_d?e^?YAxQA?eMmFXRqhP~sbk3Vb
zmCy+_&^nHab0x?rz|Aw40t2vnVM}*LQch)B^9=B13EM4T5|epS+MwX0DNe7<&UXjB
zQIQ*7qQ6IM&^OunF%SFGr3@ra1e0@>On>I89V8h^$&^>?zfoL<tS13CO@nUOy*n5f
zNN}IZgKs%+4_$&)rLOx(f6kO^Mk1F`KheX<OKZw{zC9Zq$W&w>>L1EZ70gw1iXpIv
zIy!37SDP6Su_4n6CbF;5ko&0`E?l1UJ|#xrBJ=fMOSJH(c1%F$yb6F<okG-scR7kt
zJVeKP-Y5ZZzrBr_%qSs)NYN~iG|p%4(#!}pq7OS)PdLxxY$q)4o~FM1=y|Iz?ercv
znefz{1X#m-zTRZ{Pa(GcqSPsXO0sTkf$Z#ALI@R90>})~f~5l*Kv7adSLy)!d(%6&
zSiB=<JywW<O04!60PpB%UUFJ?_GzYp9PfE4#I`9zn@W%Pvputm5EsBuWh<{yF@NH}
z!un@0o*G)3A%~TfmE|57INqcmJDiG~-f~qE*(*Xb_l;=2Sw2-7&PVFh%-PVWD?@$#
zU7Y(a8+`&tMP7j3f4i^+<0MT+K&qJ`|0EyYsklM*!xb1wc6G^l&noAX<bnbN6BUyg
zxBNHm);}cTO@5N_e@hlf{hcqsbkbvi7R~5!Ii{p~#T&GI9i3?TlOgGBYI0xUz=@l?
z{bzdl$17i>vc4B}3p#g<TVenx1hQ&~h5oz2>n}decw7~y&A|!zI|M?>nDY({sJ(h9
z)aJ6+<7x`Y4p_7<7?pF)(zg)<uJ;LWKt5TDXvK2^e0w%jRiKC79i1zOI510uCcIgw
zagCR#e{OE>_Ypd%XR>3>Sttpe;<3J$hk%xbB0W@M<=H5-7>C`!Q7rLz(KAYNY)79U
zx1=I_`qX@?-;^Sekw!mu!Q_4qgShIgns_)In~?2P!D$E1{WY5ZXc;^Vdb*!{A_81T
z2VY0G=x+p9JN0^`I*crLBqsNe`?|y*wa`c%O;L4{hP1Np$I1^|yfEIYIco(r{AvCh
z_L}}jPGdT<AsNux^pE%_!7mDsqMn;Lqf-t+EM6MkD!QvZy&YTTsJ5)a5W_?KZd+9a
zD#(c&aoWEn4VD}ig{|?CgBp<2b-@n@_xp1%Dx1n4f=D67+N1R=hwd)JbA~tn{_zK1
z%)KkAs+_m)=T!>vcZ5^D>Y@N=Ywxp1$kRGc-yVpPDa#3jOs-#*Uk@Lx+mPRi_*(Is
z!96dFVy;hp*z_by#Y-t;@QjU(Z!RvHp0=1CS-82mPc9Zr(V9=^n$xO)0Opo+vPqA!
zId6w{e*gO%7N<}|xB2xq3;OPg8>VIX6I|hx=vnJ(@E}b{DisZ&ZdI!8#zXU}hR^rs
zUw=-(2L}la9dkrh2EQEGHM*LPPmHgjvb{qDz%PhEki&IrPy?7U?q_hR9f><P*o;XI
z%K5S2>88LDo<=L(+cck{O%7jgY8ER;pDN7=Xw`hg_*-W8&#)T1>s|H|WZ6%p@{HCo
zGgb>MOp$t3!Dv=Mk(!KN#CWqm9ZW*7VAypA#Jp|<D2P2Qpig7wi!^6Ex#B-b_+Qq5
z?_?X=T7F^+M{jQcTZOB?_>+GA>~95HjJa%?VA{-02G2xk75HzQsagHOtMA3!Eo6dw
zNy$T}oOEMj<Rey@T{(ppiS^a>dU*v4M&(HA9U7hB?p`+D7U7(jc+75j-IjzqW{;Bn
zxS^<*T|TE_QRZZz5ojqriMiP>%as2+J++x{9#?tV`vNAwsrMlZQ1&CXf^|M#7$+og
zma>asF|<!QMofPIv{vZ>0Qf+$^9ex#m;@w!m5Ja@tDYe@amJCgnggu=E};L>lWF{;
z3&nWwZ@!;_5-2Cmz)2x_8^}|eZUC`RYqj|bkocl@bIW)%ZpAgxgCsSxaD!;tG!xLZ
zUJGE;HvH6rxkm3y!a>EV+N4{j2kn*9*UK<mH8pyTaa484EktJMMr;8Qj*+G$opc)q
zhwPJJeh5Cx-Pp02{KT%OjuNlh&-NJNB@)w9hoprE+E(pXaf$4)l(IF=OAhLN#uQEs
z*8R9=@DVxUa80fzH;>WoDkCSy4O!1uw<0Y+e!iUa8ySi$n%~dI2EQ88@trbCi0;Su
z?_q&2=`*nK={ou8gz4e8qL3&C(|0A;+cK?37KSh}Ikbn?(uCZ7+w>yR^5zwe1|4`X
zkm!bm2Hz=<dK_|-L$Qhd_D5sSg{9IS$v|M!LN9=Aj~>Xkzh2DQL082UlRZAGrw(ap
z$<93%5F=;N)>}Tj8jurD0AftTfi!qnDNG~_-oo^0Rd7U>IoP{t-Vt70B?d~pUb3&D
zWe6bzY!lm_E43KwN%Ts2ArdDm$Wv81w45Zgl0}VCUl2f1ZV&#yF|M5bq$l&^DEX2r
z8Nc@{1*%=o3{>8raQ>5I2$|N_*8jzJP3CgNg)tFp`H3#xxTx~hsp}H^w>Js#hDwq3
zCG8$ga^_yIO?^~H<}*^?RoX=*n|7McimScJW3O)DTSQ^YFSwKRi&C!50m%0507?my
zkR-LLN?4kAtVx&uojZcN)DX#`4f`}|rADOuU76e-`a^a|K>hVjsI)D`>m;n!kJ=^k
zIrcSn;HZ3LA|S1U6oqQiPwEz3Fk~+k;BU;({#xaS7ij1yYVRrLtwl9ki^-s|g$2HJ
zXM?nR$|mjk3M&#Y0<QiRW|6NgB0BP~D*J4Swci2TySp!I75>vLYBO>hHxr0}o{gSU
zc`5(P1W7F3la(?|%l?%4{Vi+CjvDXvs`L$mSvQXTf5`I{CbEa)l{ATkpC1ly>Ixsr
z&yvH$xE()f-uu4N3xD+`q;J+>4mF#NoI|A}<0?}-Y*Ju(owI57HM(;p^WRrB`q%O(
z?MwBo&26X(MzKP;Kwy%<oBh&&i#d<m+k-j^(3t>31k!&c8F0c&6t=J&X$Oufn&*PZ
zU<@>LEc{;B<MrbyEn)0Jw&D1v#y&SlUBAF$`^p&aOYDXqRWNs1$%(oCBHrrOH2~&|
ziD~~4Qw7-zD8`M)OGL-y!6a{X(pSDtxjf7t@^>9j`v4s5h*y_ozGsDG7hoLzCSk{M
zI)8Xj%RO}pNd1=9&6A(=a{Wc!?A_Tg7*<{NI;2ise4%Q#QUVoWyTHleJyWSLBHsFf
zp*;4RJwzrG$IYlFvbK)YqN<}R2g4_=M5UsiHzjw@uu8?=lCWu>d`NqxI0-1nramJF
z&&>7}N<t^a80b}At?4ys?pwnrKwj}x?!V9TacaXVSYNG(xRE{o>62&@JT8)6b*Zcr
z>!9=5`&jE?V4rY!lZD@cVJZ1bs2rB@r%p6MpnhQ;N&Gxpmo?y~e+<wZC6lRP7Fm5v
z2g-kKA1tK<+sJgvvwUzWee~uqw4C>APxd%VM4#d~_u5S8PzeKW1FME)oD{le>@ZTA
z<37YJ%8T=jZCVYfp_ujbyjxpoI_Pp)1X<lVI4kU5x8%3Xu2t!&q;bKhA><xHFDRyL
zN1*omv=tH`wJS2x>S}8h^wvPr*f5V13f<4<q-HVg#<V1y`4#Bt$t!J@x~IEkZl<U=
zDo_px!*AJ%w(!C(n3?&P)g}zl?x}q1NdV^N!Ape#5f-|rzB}PlUZU#>M0dCweQeDA
zDSB9vdzV8p!>FbIoSP(IxVEp&q<a<fq(<Jqzuh~pPB^F3?UZ0*)21Cm^?c2(BO5=z
zPs;We{lrI+v9oMCDI^BU%rCG-QPi<&-~7Y&y8liH1_}aAL`kYYH>BXp{@B{ij@V{C
zaaB>CO?VS$s0*O>DA6WtbiFVn`yy(YiP_2<Z*1BV*0F#-eU26;fqVZs3Xfp}h&e+E
zQEEUZCWsd`eEx_z=J{~KBPDA${b~?LvDNtgEB-jiTNGR&A8ZAuI()-bx?{_F$sHOS
zBmeaDO{pZ=JeoPKqXPjqW12j2`hFa+CkBoxa=;0yubTa1?4K>T>B?8pNafW+7T8_N
z<O17kfD4QbpKWi5P%^%#xHAqx)sS0$TIPW<_WQ;OxR|kFg=FViLcIG9+FP0~l~A<Y
zid7m%&${&VRje_m8z@PJ^Lt<NQp|~l;LW|v&CNz;>$i4P@Kf~BXQ)C^FJG!Lb6D@1
z9i~!%7PN<Xe~!75i$V6SO8NF(37C1+XLe9|-|JQIoMwM;D}X97rrh?>utuy$b0|AO
zh)ay^#tnueT;Jgt?5q&`$|2KVml~uBWogBsY6NucZ9w}4h{B^&eh^2Wvdlj2DargX
zE~i1r{rE#f)=UN6OVb}q>($STaRQ@P3#|v0Pmt#u6T)>K?ERgvz85q<s3iMd_y8=8
z<VWC^y>(JzIDfPb4U#gn|MeFYD#Ahx9AHOwRdQI|GpQI>RGEgV+Ir5iq7z4Ekb0y_
z4KLzjo{l<x+0aX@TD@mSaI4*;B|2jtqKRPlD@S<vH%X%;$@X)7qlg1a(3-BE5$7@6
z(npVp4-WZJ=9|6bw-;Jr;Zt@am1pEAqGgVP=Y|36ZJ4&-{%8<4yK*rymtK1IlwSqr
z)Mt@(tdTV7?~_|H$+Y))1>cfQxUjc7g}NJQEm51TiSsYx)VEwL8##%r{8n<@B5jcm
zGKt+iquT8(N&Tpe5uaw~8zlZhs~5#9m{Fx$^R;UG_O=kh=?rj~({=cmflCwRxUjGg
zj%+{@R+m-@=F$i%)W_$>=V)jB1QJ31!tI?M(?w~g6yxG_9i9PLL5CPbZ;IAHTJBf$
z7m|Z)pL1xMSW0EgPd3Yx=V=1)iRnXPcJg3NsBVOiVXg~Hb!Hf1$_7VVA*N;=w;|$P
zgY!vW=HKg(fe#@<qhZLHO&@U?Iop<%3+&P;((~8De}1lrE&|`He*^uxR>L|s+V?Q*
zqaZ>QV14MOa_J0WVvrc|8mF<ME8PCa@q*b@Do8ZF<|M9h`<YsCen+^pD-~RV@!Ch+
z4?3s{6;S7e^SyiK!HU2uvf_0+h_Zeyk%Ysfqv9&aTv}pi$N#Kx;!end5i<b6)uc@h
zf`CEk_P=)3UM?6Sv=)-z9MSZj3}rJ&XW-N0sKLDxhHb$;SQ6BsOzs(^8ghbP3moB1
zPmG^?DUHK2w5!bT>AfUK`#0rg1+hAq@h~b-e~ouo_X8(HI*`*d<(h%?iki@^?d|Ww
zZY8k3?>$i5&E~$24z>O6XJjYb?YDIOat=e2bd^$d;KGe<wao9-1{i;BLDmb>!tZ_8
zgtQ-#f9I*3>vwp*Sd%*Znz$DSuXz6U^<@!~9A?ItGi=lUZ1^He+bPH14dw=;848t)
zh>eXkD6<<q5^Xio);S%TVd^WvREBeikXAG)!ARW9$q_^-0X~ZGUN!Rg_py3<NyDGz
zzHx$RRG~;DMf4SOaY>b-${(k8F35CbFAKeN^t`I=qX+mtTbmqFcNFA#MgB!fUvJ<3
z4d2}+#C;Ti$;<|zCzNkO&~0~IWN72!mWD@c@w)o@RyMc}yzAX-sqGG2(7M0E!Cc?6
z3W!_`OT5e6Ty#2=Hrd4PR{E7?9r>kXzB!C#O68#^v%wL==i4+I(OEeY{VdwenQf8!
z*yBBBgP1n-;~L0`8}3!AU9C#R!C{`&_XQ4NTs6ka@R%6s9N$+>>swQHPy6HJ3DSVS
z_U`|kihTca==ahZ;ieT_miqj+2G^cAnHFTbs2WH9T=94T_tpi%&)b-b^z?IHz;s0j
zHuBRA*P8dzHns6J+Bwh+lq##qEwiH_23}ga@fxx{Np~8U1pUV{oZ?BJuV~_L4E|B!
zvQy=Bd+F75Ozd^ek#Ew?GC6?Wz9tHGzV}uXH%F3R^^|{nY4)dx_@IRKixp{$HERIJ
zwk2@jb0pu`D~;aCO`@G6adjO@dXmZv*_<-va<rTdlu{<gU0mZsbsDlfKAw==+>I%U
z4RVxXm%~rX^1PagyEKjsxd=tFz;xo`-vSnF^JV9VPROz7K&i6>3V5MFHqa7<mIb`7
z>2f)LIx5zFc18BvzAyx#4t)>4EUaqEG7I!(>SdwVc#>>Oei*`Q@a!7NJ`x-G%-1;H
z`m`=DW6@K1IlU<fEUfbM_5IVN?|1XBG+N+h`D%%MY(rT+c;fZ^H=Ye@Jf#;P&!y$<
zkC*w*a!<d&FY_x`?7UwZZINA%9!$VOJ(Rj!05K6~Gw}{2=85}a2pK!#yXU1!g-czJ
znk4nPr22`Gky|@@iL^Lx|BYqwq{o=GtenmLD$Ta5ZNfYnK@J(}8T3}=kVe}{qn3c+
zY!OfZ+b*SqKkv*YNvmvZMJqbu8JU|iYs=v&fFDNcQ!_49)Nt;%vj_fNl%c)vB^jcK
z5|8`w0)em#ll*)1(<t=l(^^*)f!4y6CbaY?zI5pI)q9LX);?pR0hG8xN~H~?X<p;3
zl#KQdeF%5T&yUILKlC@SpPrH&SM=VjTs6?SR!i=}oTQCnGabNTsGq*55YaDIR1dA~
z?({30^j~Q1^dFL73c++<NNVf2JPa<)tB=|SbQ151^D|fb$|mM_24>uHP~%(nCH6~d
z@8{Uq&5MVwJ<fEEh$XM7TR{Kc3n2Wm!xwjUQEl2V<mlClOpF9MES%@SPZ$%gzIR}L
z(sROewH@L-m7rLC<)Eh_@<vX3Z#Vu286_Mi#ll3Ib(>T!WBg0h8&MDgvHqIj0t-KY
zSnlfqrT48fCy^UjnD`H^2im6RG`H(-AP~mkh6yD(CFnG-0P;Hk)2U^p24kirb)dT@
z^KKtK)4_k9XxHmOvdQfa$Vv^Ynd}yTm{cb38O8Z|j?)QV{EU71Mza4fPQeIC`syU=
z7kRSpj%iw+1~`&NsmZlQFHHUg=%bRsfbmEbf%NiXw;cSxKgExu0$TQ87x|Mc!~CnN
z(7Yt!xttI-));$`NBTS$D+|Gv+SEkl!M;|~>y41tB{~+2b_9EAhCNJ<WsY!GzC+O%
z+G+o2j>|q4w1k4^Yk<y#NRitk4Dc*fS4Cvv_QAx#8ls}bMI<r$xdD$I(z#$LvK;x^
zXy@nq$e-8>+A6dcJ-E={CB)zW4Ak4;;mg(7p0Q28+Krxzyz`{u`(^y;S7vKe*^wWq
zHs((!LLJYPL>0$o2(+T#;fXo?6<>+j-Sb|l6Ty1lIa!kwQ!9*T3&rZbd6cD>)zw2K
zs3%r&ebiQWcr%?NXJAVY-HXVBae_u<o!J<g*p%fWumM>=u_UL!UJ?vcI_U-!0_0lW
zXMc|@Y66ZFvN{YDz$V;-3h;H04weXILETXI@*NxrAJ?l-&F?@ot3@G9Ytz_r_9g$m
zqiA1s^6_J5Xy4Xr9BNy`%eI8Yv!h-@Xb%-4oSCspv$a*$RZ5Kun&nn|P#O!n`u9#{
zPpW3eMgO*sJ@|eY9tS}?ixxjk^%J;v3x4frrq`jGUYHO@w)-4W{Y?Id!dj%Fb8{rc
zb0U7T=ELwR%3j+3+|*^pWdNntq-!rj9|9~f9RFZ$*4?@YgMp9o{z><zu$7Bv8xc55
zQm|B3wfbYGXsb{keF}45nTI$2`jpvm7nz#gfz-PygYF9!H^s8CVh#>%^{qvBpYenU
z?T0ZJbqzmw=?e1kHJ*^ka^S*8jxyI${l~alF&Mpk+!6T1eceXA)FJNVp!hW4YJI}b
zH{E%SdwJt)9RPgwnH|V>#~MkMeRO|Octp4Py-U|+&%tfo3V#%WpXgfya_`(@!N6!%
zshRxHnw7ThV!6R>W0`HOQ?^$KQr%*({HKhtyqL~Oy1*@TT^RT3bs_855z!A6%zBPv
zp<WBUP0z(PXNpq%ykM-LLVea~vCwbxDm83oX>u9HXBX9?B^eQbzdYVAAtNYq`uv<+
zfKrW~s8MpvPzvqwz6f)1C{htZi;-~j5hKTfmikm2$XmizRVC8f*<eoTZ0@5b7v7-?
zjSNR0AJszHNr%yIo@$gAQR-9Y#2qIUd>+K#lLx%uS~xyG!sA~@rcB&6_R<LWJsN`t
zmTi13(Y)Vj@=JPdZCxkXnp?RhKS`j=H4B!FM??|o7d?OW+gyNH0kYlx9O{C&=;p5g
zBfCSIX2nQr?7?BoRkXa}gXmhB<lFu;50kI>BV9ZgzJc84_d*b_nsN*Ve&BEkqo2R;
zFY!rrto7#<M7<Zf_jA>C&{XEc#Lw$Q>(E&{eBRcM=0Bn_NDjy-Q9@eD@dO2o&Qd|D
z(w?B+k;pUH^@<@UMB&|fDet2(_+65T7=o>*{GZkn>q%@;_3t48vu7auXkM~uI}bO9
z7h!kJYx<4pEz{P{8iZi<lMWzQ=L@zNc4Bta&f*d4wA=6ZQC`Puky0K1To&#$q3<V_
zbmwkWzM6yQiGq{?Ibxyd1XHq!OmuWrF6qCX=3}HC9NOz^pN{FUX!Bxs$GR@|qC$7n
zs$G2@-&^4b4}&V^-a7E@Mwq7v{S46Q9bcnoqrdi{BRi`MS(Jui@HOqdXvLc+3JRKl
zpJ)>xn*`^$0WWk8l*Noqdo19)a^HuQk>J?(i&Y$O4c{N(df@`PCNiOltAThHnnyV6
z41kc;tPC9Cp$1ph$&%LRcyAa*{SW;w6;5Km#eFyT6gk`>Vfo4u(n;TIoVCjj*O2oh
zQ^xTjPz%WxQGC%;wcIccSp+9Zf3D@>W1GF(szl(6+A!~uYAiVI-67nPyG<OyIHu>P
z_(Jd2fqU<!13!!QoKZD<3LV|i9;=aVlC*fR)+C%2GaK*)nXr)5;M>&F%qRY?oijU9
zid~5#^vjp0Cs9m5Z$d2Nem~*t_G0n_k)o>rI7FlH?L2#3B;~gF3HineEW7WI2S0GZ
zt{ClEn8jn7)?ZV_&*567lxK*W7*m?_wU0fWNGD&;VDVe&wK9LWMsfC9b~N*@lJFUe
z--RWf$9dWa%8|J^A88F5$;YRb6;zXZuSZBhnzytnu2+qe=5*IMSOA6`-oEUKDV)#g
z-}1cpK*&#4xhyAVX?yt$9;R=DU@|?Hw<0wT5p_7$+N7Zkm)DRJwC!coiOGM91uDvG
z{FUcKuc!`vKeo>`IJq}q)_e^KGU^p?QM+^kKin~6I(?n3mk5oPm-;kuzMFM+|4p02
zQ7d`x7e+CW>nm(HIYGk&T38sC;&G{+kn6d2%b%v5_hGGxOAnzEE5ZT-vDuKhd+W8*
znBi#r`Qm;;SDHX|qWi+sG%J&Z?zv5oxox`RuqAscTh+(aSN*9dKJwV!Hv<`lv_vu$
zE0^5Lb$duUb55Tt*}7l;Wg!Y5$K8mPt?&cCQE6#Br${E#g@w0S1GZfYQzODI6qoYT
zt1d4-Q2xS*5k|mGtezz-Sa#v*71}%V&d>)pPEr0Il`?)Pw|OoBe7=R15F>C&aH+IX
z{#001j?EU2@~ECXrrW7k2L{<PJ>{;i(~xdb@uM;^C%$@bf6UCS+XOgN`WbEkU%qKt
zAQ==hA)zq;5k&3uc^<Mo4~K!u0B6n8OjInCtQJ~I*hmqi9!B0OMO0{KMzexSyu~81
zKvF{DQEy^$Gkszl7f=Q@(8M@GB$<R9C$H9kvcu<8W^^L~d<%W56xi-xclPbTIFKS;
z2Z>m-Zww*jKa>F6G0zp_HkRC8TTYf{&+T=O+pN#C6~|`xPKYGvp*~nh^bH&~v5n&X
zS-mwF4-D6$ZqCL0ToL*k!Br<vY6geB@{xF|%de!?iT>R$(KXbPD@5?{boAk6Gszv%
z$$?SKxf)J=smX;|h)cK3qtg+ElFQO>w<t0+-4Ag%(@sF#apG)1XbR7}4|Nw7E-(8Q
ze}HrNX7GO%1h=YSVHtGi$#23_PA;>(^NLUM-h`xLycMd)SXjV8B*t_1qgpdK8l)Hq
z+!^}<!gJJKfbrwFDsz}jy3)`MF<kX@iZ6zhf11q>8ACOPEpt?qiQpFXzLB)7r2|l6
zUc{Ml=+M$0@5`j~u7w^)IFR<&0<d9^SCYWW1Y)G*F~zNYBL4YEg@Wvlk-wQ7Dv{Dk
zBK-GsU}e=z&+zPs2;7@U&3wVgpKm7l2Q!&dZ}<0VkNeOvN?lgM6CHB~RIl`{pg~x<
zu9RWA$K`KhqG=`z#k~Y^`dy><FaL4#hpc1<{lrOkR!8*<#fTU{DgLT8H{@X(05K<D
zkvGhVPB7zuDc*i-I{fiQ9V-j}t&osAph<&-j4xazRzBCc-Y^6!=;q(=tgO$l4M4`S
zKYt2_fO=GA#hdZEx;lBU{nX5OE`|bA82cL)no`k@aJKk&HDz=7BiM2l`q)_1R5liB
zO`^WAZtiFXyC9~~KlwerR}siI4}dlx*e>%S|MFPg=`c|wdvVboc>T@0^6PV$DD$5#
zim5CwIXO<)3)fjN0j=IeFDkr)$!430${(ld^^T^WUD!-5mee22iIiZ6!=NS-h&Qi}
zo<!-+n=4~@NVz<V4bjuYkYBF(q(MBB1`aPPhof)ruirH&zk~KL(wBF~M(GGujD*tc
z=zI*Cto(?YrF(XbsmF;zH!M_0f00sdfaPf0h<vVy&^F<7_?~RuPvs_IvvPE`hNODJ
z8h1fn7R`qyLc{Olx_Al%>>4sU?5vPB$qzcv=$$01=(JEMarh5jq5-u$k;)Z0EV5Pd
zMqxaBITD5C!>FW$J>G5SmsDq0<?~fl?wc5lY`L{PlWW;xF;t~t*e{ZieNF<VAem3H
zS=jvtg6qbkxuU{CM#u6+E0fCPx$nKN##$c*zF|5I?JZ*C{RTY<j$$6iOZgeSDg(Z1
zCf3OyT($1Esc~3~8QmjV+i1=Yd_l6wZ5cI2v7D`Dh;BJ6jxy9Zctz~CbYL34*xc7_
z6c+1|)JHor@ecCzQ#lU;fbk|Rl`HEIO6F6TdFF9IM1Bndu#RxT%Ld5z%5jv^t6rTN
zI;FlU-4RzmsvWJODuJXM68;iD{~<rjstskwP(o+xOo-s~rPsGr!;V|WfdT@b$I*V6
z1^|^+`#_wnSwBMEp5%c``GVEyJDRhke&zF0#;!&)H-_=g$6)`5_P2IDBzHEWfyVDu
zVl`Lf=<0383-TkRpslzgC}E=J@f+38ZPB}ChYP!3Op{!NGqq))zs|d^G!!_2gLm?H
zagJ_}lci6HoTnbyohy&*J|hHx&hY75X57n#(7KAp%irRt1UKjei*ViXalBF|3h$>1
zN4*!LS1QJru3-@j+YuB6*uF{Ol7-(}N1OF^ZmawSCOPj^%t37&7Hh~7*L#*$B_2)!
zI}8$GOacWAcg9rm4|KJIA^mEV^J$BHRq4DDdW22VW6(V|bhZyYjF1pXQ~f5}n0cF-
z5^U|VQ#dey3{g|dw}@wc;|0_aa2rp0yi==<2jXr@YD&e=3dHa7uN1C)3=zb87h~y}
zv0>xqw<-!E{>lu&lx1Z<#{5J%0qO81-by1XJU@N`@!w-A>7^RYo0*!dv3V(Cb8Jyy
zj4w<T_z8IHoL<;NjptJ<*h<uV>?wAlpc{<thDn<}iA<WzP%$%3LNN5{v8af;1+}Ns
zu&e+EbIK9(nJ$jXt~~gRV`q*_z;LiDq@IkTbl|U(D9`I5fpE8I8iTD0g5J6D&3?c;
zL5m4Md=w4|vdt!SroEjd(N(GeA3s}|SQf6=CaGcj6@fx4NfIsb@LaM%tI2*<38o@@
z1Lbm;?f8Av35e`-vY+>X(`fw|KRozyyKIs9A*aRw-dD3N{}eKr;|Z^#P6q==*2IE0
z!oxni5k9?PE!M${+<kjE57@pX;31X_&2AHZ&rxm#7aR(?+tefp>YKt1#gp5eA5mg_
zr8$82H4-x=CgviOZKAHUai#b%a2LaQtUGJWi*X;1F$`lBv1BdON&f^s2=M7sXOQam
zo%{4FtD)rP(<e?D2Xaf{bf+)YfbM_dyHUV_V-!4bKR`TAO^1b#oz<iFM?xjGP#BRK
z!RO|WyPMEoKbpaEfJR{$ALu#pVJAO7VeIixU($?V(lGvTv36WqOiIjb^~1A6ZUxNe
zl{xJYLLX0WZ((i5FY{Hgsd`(s{+DbMlSoa8z)$%3#XvjZLq_2y0?j1vGT|9LUx{`?
z@}wd{Z`Y{^iTRNC8za<~t(?*=2o6z$y<G)0$V*orf*liNs5jp6keSCz^Jd-%4BI&Z
zxTF(l+!Y&NVoVA_br&{G0N@+3oe-c$2>hk-P^R^jbphScymyUJf?v9UC$-JV)WxP}
zylgh<S>BM6P0zvh@tB93V?4Z8*>oj}uMYaV_7r!1KzujDa?RDzpfhWNTAC4=t!N(s
zQDnD4IH5~<$#Kd?Lg)Q2^Kdcgi$uq2K3<nW-ZHNE)RutMbGgsnO?GdODc%V%aBLVS
z&3bRr2wEgsA*^v@kq$BLDlmiRAnM*Xa<O#Brr*K4c3lWcscd&UjBUe^m@^YWxHYC%
z+vXz!YNrdzPvDJEP3tUvt-<#LHIAQ=TgwcNASxuI$j(MNn(e-u#{X7G>QSS2H+uYj
z?8_OZun#F2l?D`lxj6Or6=BSx&S>WHmxv2JGuYbqneIXBw}vBBu5{@xfAC&EzgTo9
zJG(n-jE6}uvlkgH2RaZ6MZG_C@zJ>o8vmU&)J=8Kl7R4K{0ew%)sUurJ*Y?{q!?=l
ze8@i_LdB{M0c3ltFhS3C$MJuVag}8+C$z=Kn3|Zpoj`g7$(ov}Uza5B{+!b*uImYi
ztyawX*0Z=0)Pn|0FV1DZq51w{ZO|dqemr7m+{Rq_<qqeqyHWO=LUN#p;IajI4->2L
zF^x=ey|L0@7?)aptdLP#V$!$CVhPCMkw)(}f?6s4z@3cVq{e%n&qB8V;4Yljp;^Oo
zWbEBZ5ign@qp|<z4oj@17iExk?uZ3tuhRR7Oi8QgFsJA71V`24i7#{r4=)FxMcZCI
zJaL$<3n2-8lyK^;&sA>@KmAPh>8cCD&wi=%mp$>SIdi*)S<TC*n2sT8=u*|?M|7Pv
z_u7edWc{~68Sz(FW;mokF}z(xFi_wbHlHOxOpZ5643Ez}$P!Ifm#6t%eW~&M_ekma
zxfs}`wrbq52Iw|)q+!T_rJ5$c3b1rg7-EK{wPuh0-98czCkIP2)qGq!(X2al(&u-z
z0^o5XWbI!tF4zr1XQNjzNy-+MF#AR-L@4dq=!+j|T18!n=89-v^h1|Z@jjZxz23E}
z;2b3%6Uj38SJcnzLyhYe9arC!XbYbam`=eZe73ElgC?@s`2uToun)@pdzIj_HMVh#
zrequio+Nta!l}8&e?CSyO#~aJ1Z0NfzFPKoAmnvE|L32J3(!{TVyH{z=GT@BB<pcI
zQbmPPYcOL7=k(DqpU@G=Hve^|Pj;P?f&9EYyf|!v%Ch;Zq-5je*|2yG(u_A&esj&^
zOmqPKiFo#+w7&mM(o571DmIeR%)-?_2z{~hx-LdwX3_(ogSw^&v78EJzdg_aH^_A)
zd<W3<?i^WK;V>7|Ms<Jic6T35wZl>`fEorf#LQme+Q}+08YQhhhXnC8T2e5+@oFJg
zFa^v;k@CjS9=&y#<0XlG4<N&Xvez|PfWKm#<fSL}+d?c#sdmf@f2jCfh6{!nToIT1
z-f^&a({6P+SecZa(;Z$4`ipvv%vTI-C_VGpvTN3M?rY{h*7xg~yTff>h`=~F7_3<c
z1XO6?c(Hnwy8*IBp7V*73Qaw+>$u{B?LQX}oe^Pnv+#9uDA<SMPdVHE^e&}T$xDqE
z5+IpBiS(T<mnYPt+FMN(jZ17ELg5odVwC90Ut@-lQK(7u)s*iEO-OKOBrRGt>r&`d
z^Noq`d(L*&ogeAH4X0Wi5i{m1oiXr#Z-y~@G25y6SIY+bG9w?acurScWH-dGL<lpr
zrL=SeWr9&5LW*-;OMGiv+0-s*CbLDR{70#9-!;5XXH;Q!LMk&(g=Yq@UYnpi<1gFS
zozsHr`@4t6D+0jS<yN@%ZPU`z;KqFGi{k|R>!HY&ik7T<|K;D4b=DMKrRs|DRLuJP
zz-$rP9`;tVkV^eYG&35!03(`(t5dGzA~NfQ3K*t%-9r0VDOyKhycN&{bKaQYLQ-JD
zn)3%V`%9X{uf5b()9k+C*_6<>N_ztBv8iA6)2+v!KaY0-HJGUez`UvliNKKh6wCQh
z2WpYNJ`!9CLPK)4zNagi$af$a=KMNFfNS!68|nSIhU_N6Dz*W9`%}!nLNO|0(YlWo
zHIFV#ecX`822I?ducjKxWQC^A*;q{^F(t8)K-~lrO9y4`3Q8Rne6({33+WC(Ov6!0
zY^!)ZBu3#<9F*VQZSH|z5+u$DV%|3DaBA9Z8BJ{IVz~ZL;@#QSuR&$^qNebMb|=wS
zDtKwZbpB3A6o5M9;?}tk=a8c3Na#TEwM+t1qU7QwpA5bEgydfCpDb*%1oW?T&x5Ua
zfw8a`CI|Rs*s&ugyWLVNwmScY&>Bh5pC=RB4(+!uOW-)IWa)cs+8>LYu?)icTaCf&
zL|OFfu>v8(%I)E;<}M`fgato*p0*M*SIDJsc8oG3BdOaXcs?!}y|a#|-H6{$VE|?a
z4DxBNbkMTk)7Eql$wG=Bi1Gs7t4Q!tuq)@e$0aEMpN%J^vz6pI3LR;T>ZV0la6TvQ
zH%s*BbA&rPv!&fa(uSmX-*wK%@WRB1qsa^j->Mhc;{{@_>JkN~xNStT@*ewi<`S7{
z`8(DeoBRy24lN^`r*?aZ(blB9@s2-)?md>Wz1@|wSwxk?d3_*I?He)eDJ_h5a)i$V
z*J}QUs4e(SaK10WMt(duKl_sO(_R4s{7Lf#J)zt~67wz@pNLq4yu;+`pmAieHLi?D
z5*7!i_Pa{Mwz?DBpBt1>$_kW+vOesbNqH^7IP=q2LC)sAvhkbVmVlSNo$J~ip!fbv
z5~FeC6u!1KN?b>2s|+{?@$w479EkEV+N9a&Xc@x~*=+*Myi39)l0=`~fLyVW;|wEe
zoDf%y_hJ<8IdO;HAI4Xa;PF!oym6hg=2uG^ft^TUwkB(qg@px4v`&B}`Bdf>PvR4|
zv|0NBeoYGHJqZma54Y<l49`yH$GmjxVFEtew%*SN=WZ%>td=!(Suz$z!7k7#yBC75
zYeFJLh2(az^{(NWso&oc&bKh#ZHuM8A3vu1H9C@7#pOk=Hv9MRzVh_x%ZL|+A(v|1
z-4ZWudU~o}w7$bDQS;-t&cxx*QM+n6UwPhcm1jI;gnCk$^Qgj0XmX7M1QxcEFHEU^
z2iolV0(`py6?Zkhf3NwhSTs+$&%jKf%s%uW__ttc_lmRglSav!b9BZs%Db{O(W@<2
z$zpEQwPa@`+Wak~><6CNx-CA8Gm>A=C1=bP6GYgLYMWp7WREz-4L%8P83c5O-tvfg
z7<q_vmK;u+9+=SdDvUR98N?Esk418RNc!U)K0z3Fw7R*QA7;LO>wz$bL<9BKmcQy3
z*;Ppr*{RC9)&w@bPEN)iRf%5@NdD_PJ@LT;a%LFxXZB|p)vLu!s$k1?767kkths2D
zUr%LPYJJH2P3I;p^Ep%sp3<(yZrp1t8wwaZrU*zCh()s-*X@{2Lra~F;aPR;f8atT
zyt!`nLzvp-l?-Valh+<Er(V8FuNn4tl(=A-iL;vW?$lYuk#HzNogi^>MOcqmu^3uP
zYZPqPvSJNqT<sL?tf+E@c}9lo=`lEeK2&QRH;qWB20nMzV06;-VAYZBSHyGdnycW|
zQA?LnBHH2hZdDjG9RW;m6Lle|&H6!(4ZpDtxP*k1L|**4$|)Kj0~*st(!6!>f`n4B
zBhUx$RFWA@ucs*C^WUDbzHO9}H<%k2)R$ADUyj}p4g7_Xz6J_fD@4}%c>J5DlID7C
zkQF9$h3i)jUrAHFaE#mW#9SzuS3#xG6V#0R;6qL<_MJm0Jji<`=1mo)7-43K;|v-R
zv;Y%11Si4*ap2TD`!krp^=H=>?<xmNc=H0j@N{n01ZAEG@aWs736%hgc6|p8s8YWs
zBo}XZ?+xErU3is-)}4b2KIFTIO;Ua+QeN$z&CsHhvK9DpHK}GU6ib_*V2X9(^B=tI
z8_zs5_*+;sowgD4ekmnNKT?XVONukCqe=Gr@$yqo*2`;}w_y_i{V<`H(=Sb3nJ$^s
zLuQ0QeR-)1v<EmjBou&aT~fy;ercck9RjW7x{<_boJ(HQz9vV$QOpFRZ35L|4dV=~
zG4w7Hresh>S!1Jp_N8*+F27q<gw)DHKfe9-O^xxFJ^tu<?F^%y5@X<DIJ2Ihck8!H
zYF{)ZINQ8Q*Si&&`dXF)W!p0g5YBkrA?>3+`o~KQ@x2IHgr($@hMC*aa4TQ}+cBBz
z%^t}Ok7@c`_<bM>OMPIOgTM~U%y2F*dvjm!LQiEIvdsdV@1#p5J5AB%I;y244waG5
z7U3LO&WO`$9SaAR=#6aYmQ@X-`7%;b7&1@_*FamY?;?F`E`?8ZCSApnn)Oku1^8cD
zMB?bWp6;wD{)A3HH5&(e{2XobGI6k=cPOSe8m^lunKMR4ByL%yYcnd^BD0aZ3RUs#
zLF%nqLfJ76ui6Cn%vwd}gbM-&AQmfs#SChnnxDJijm=q64cq#J$HySr4i*ZM(>n-Y
zkt9W&As^z~kqepJE&NEled)A}5*}PZFHB0fs}6e#9g*XaZECZr11GTN2<Iw^=7iqh
zkhRNi`>Z7?d_vi*Z{;{Uq-n6&iA2g3hc#^2M@Eb)l~A>S<nL<amnt#9!g`*(BLjR)
zM3v}X4f4He6f1=e><C>hRf4ig_f^e_mp2=XOe^6U#xGRWpmpPNY3yIQB8d8@BIH&w
zJ;*?h4;xS6-W?2OXsp86ezw%0NGCp%g&*EVp*l<|FCIC-0H<%2^U_V$p4NFAc`7!-
z^By=XoaXf9_R1*+5w*3oZ0uoo^;D&yLh>@9LW;qY4fHKIu~w&N_gy?jA?@0t<C8+>
zfytraEO3C)RCSvODa=wRt13s&0iL#cdF8vX2i#OpsBJ2)q5)PKda-ChMm3ZM_(N75
z^aR8E^elK6Ee@M=MTTu%Ar@4pR^GseV@MGvxn9BPG4v@x;Y0tFY27Rd5$I$IQ<tz`
zh~ERd!d<L<eY6F9QEEV-f<d0yi|NRX^HVpN_BmHxRaKZY{y-79ggfoFxiCpKJ5xpn
zit#O{MKoCEGXbp3PR3C*%%09(CGD-sn}sX{ZVHSI|8+ai6F2U(rH9(Al+wV+%9nbd
zx2FD@^5EcW)~k*iEHew1rDH|oZzGQ0MX%n)iL8GRZ7;>Ge`#&?dZGTFoYIAx@Zy>4
zH##5V%3r={NOl&}Kw>DbFiYQ7%_K26L)OAUz!uJ#yxzn_I{2pI&Hn)zK<2+;A-JXL
z?gTQApsi+vTHDxg603D`BASRiiwF^<&lTh@10Hq1^{Ky(w9lQOnYT=%vt?o*2pmjc
z0?LY<82|tv07*naRQZXo9|J+^t=VR(+B2M(?Bfb(F;fK-U_f67)<8w}Qi`|DK<Mke
zA<^e=j)kmk5au>S<R;7ncXDY1OE5LcSul>{349NM6qqZ+*fg{P)f8}`R)ssfMmv_7
z$z$0RF~Q^coh_J5AR?y`<6G)`+Q^nq+2lhu1-%V=($<LZ9OagkXndn45B)b<q}Q^D
zmdnjRwgDXGj@YiG@i=2-SRnOFJR{Abxhxz=Ki89DabE+rV%YP}fp2gr-uRsRR<U@0
zBRRy$qZHuK%Ai<0M&4wyUEHk>L$c@3uW7fJ>h6M+jMR*U+3iH>RfiWd=jm8t%(p3b
zhpMKzV=(hEYW@B><k%576A@`&t2XQKFg!3**9J(AMxtw)00t4ZFnSPyR2yJu=GqL@
zotX?EFO&X1-oCXruH?w_oQTX@MM-UMW4wd;|37UP`(Xz&w!0;gRW~!@?1#u(ELD^J
z*clr}1BOKLQLLL8ah^hRtt}*%`fx@ypjzqsdq}C)nuBF#I-O2!j$lSqMH5|_<x~PB
zqb*p3>0Yaa5LkVKm=O(Pj<Hixq|!2#b50!g<3cG^MvpsDg*`nXA~?p*N*u0QwqC&D
zeeU4zdDi&BMf!(Wh5zabU>{%sdG{bZJ}B?SgCBe2V^-gzQN|xe<#+%L`OZ!Mc;o9G
zx-uVDi;uuedjRYnCClHf6L&_R$J7{qm>ldK73FuBKxTCd!qCmoVdxNijmnxMv5#rn
z)-mS-1xO<y((H1%rWw~*p6I>h#2hJ|0EM}aF{V;E>Nz6_wzA7xJHj#NoG_!7oywLq
z*Lg#rt7`<%SfN6BSg-CJgeywypa{Wwu-|CW5(N+{Fe5=YmSZqNPIqN$cgLX_NP;Vw
znPW+PQ*yH6)H-A%X0{>&dV($>L&}_U1Zhl`J+d_-W{75q1ZPY}q|KTROj5>7gOEyL
z)vs$Ee<X;JLA{pGVX3N0zLY6)M{Au2X0Y@MxYMkBgb(odfP?>SAmFbAeDXKIyLh-!
z@xdGYUQri#Km7CYVa$hzN$)(6ct=EJ@30a6j&KQhKcDb1)%bC$c(3d5-XUlYf}h6;
z0uO7(?VwxNbNlXfD1Jk8NaH&B>B||JiQeB5n%AD~?#=tAFf-q_W^-ott>??jbpY9z
zRAfepXslXCNO-Fjoh8<>mEglV1a8`nk$GzfDukk_zaZ@}8@UmN<9#XS+6dO`LISdg
zECsF<D7x`Rudb37M$9Q;y7Soo13=E0$dp=l&4Ap^i;}c7^KftL$6_<HX=XV?5s|rH
zccc`(dwlxzIhwaD(^M)VG$U-znI*VNMFb*syX{LPl!!(98x15V6XzIwets^rbZ+Rq
z9{ifph|EAl;OXfJ%M$q!1^m14fIku&-u?@6MB)9~>POJ;QO2ux1U~#uOaIHm!yk6?
zxD(yvI}^oYV$gfOe>~8OzjnykJBI|{(G9!@Hu8b0(Zj)|cfid@5m3T_eqjG^Q;MV-
z_|KoW<+3wmPDLo)nJc>c*rS~^no+0C_4<0z`MgEMwAa_`sDxdnnN2rOkY^G{S;zq&
zEb|Y&Zu%O@kLOf^FIp_EB7I6aK*M_Yc{`W{7+Gq>viAzmq8iI<0PyGrP-bLhky|D*
z0E(hjzn_w{31!a6?5(m-GSS@aS`ll=l53i!cA>fu5HqHE12Q5LQ_7e#RDndq>*dul
zqF!6&!JiUHq|#D?(NNV8V%gCoqr>WhImW>Aw{IHzmfPusjB1aC1Qk`tF~;G1e4L0s
zTDL!{CHt?f03S$ye@m?JQKui?dHAuq+wsAJ_E_KbsC^fJGrsQ>5Pq2p*dDNmN7K(e
zu=kNnm=8)ldl>a~hd11>FOM4j$9VF`)FC}63+<g(`xhs>5gO&-DR6B8VK2`wIzMf<
zN<1@P|Cx{L*xTlK`gG2S(5mQCMAF@Jzm71s<K3K#Udu!HRLSA>`(wdeD!aZGLJyTb
z9uU+45=yIgJhGH~a@OBVNge53hoP@PQWKGoFqc6{fEZ;TOrxo7ElTVY1{t<fSEkY{
zY{)|Uj941z?K}YsDd23L%FKu)Eqh~_Z#l*k-~w$#q+VaY*}jj6Ijyw@fojc3x007c
z*kUGV#zo3Nps9{Y<C>bZFa)zXv5!59x=8d4#V!4u2OjX~Amj)B8{q#leB?tZ@UO&y
z{}yG(4=BP%$>L#Jc&`h9@8AXgaQpYW?`1sT1HYi<GLdT^e^lG)9RSfjU^)DQkI4rn
zBOV@bf9C<`!}p92*pA2MqI=-;CW!&8D#A;T!pmjnibXiaNw#J_r>u9*gm8V`v7P%3
z|5y=V#saJ}Bh8z~QLM3S{7GuSV3vkr12{<;Q(6;2)cc<-aFKwrWr8B(O+^SLvMIwQ
zszN<+T%O1fgg|R;&nzo&M9^q*qrA665CnjYXcDs>?!@kvp%~Y_rff9sV~l({pJPl+
zx(!5@S+ev5qi=mm7IW?Z94{}=+V`tvq<{kY+?^Rb3X>FbR$3`RFMk2&j0C6}XmFIJ
zC{sDczJis~B&lcD7&}g<6Wk3E3AenNHTbdU?om<uT~gQYO&$8J6@b6vVgE>(WFLrJ
zjt)4yBZ_(4!yo@V-jV6z9d_Vehi@yy<MF{{jykX-61^J%*cf2%-!T__I9%?rihJPd
zu>Q{5&yZ_V{~lB550e*vWu@Z7Dx*VMoPl*~EG{esN!Hy6kmvIgzkPdQYaO3IpRM->
zcTt(ub=WF)Z%KM>tqCzk35YUNCWE^zV-38xc80`C+`LUiT1GGW+ZvKMDh4tcVs?Ng
z;kx7iG%`c%1Y3oINCZPbEKMNF$M28;cbkdP{A85`vPO6kFgLK$dfeSiAY;m!+nkYt
zkOrSAT+IA3=RPBHkJLP!&buOF&Iwh9{G4;=oU<+*lJ3pddZZ;M&VAo2D8&e8DHp+-
z0hSF|k->5ZR^_~clx9&kDa4%IwvAigiX|c8t-*}q$H;%K02Lj-h9gelzeNY|Q4t7!
zU)LYs0kUrY-N$u3?8@=ML-$zBaSy7^hnw^<MyuYSiJ^qk!JNRzVZFOW!eR_}?;Hcx
zJJ1Vu)cPuqkzn)THpe?kEPFUC?hmNbIso3oO%fl6t3K)}iW?gtSONYy)7w_4*bhIP
z?d#WXB+aW-<ec?jP%`Se4@haJ(@Ayv+EJ$+&(E*S3|kbUEoWXVr)2?K$_c^=>d*wd
zmF-|P2`$4hj%kkpC?$B^rb_bGBbGW|GeHrV66SKAXJ&Y7HY5<~8j)PqWFCb>B-6cd
zwHsr38US;YsgV*>83~&0?!ISa^xg)LL2t-$MdYLsjL>2`n)hz(y@wesGt$hEk%kqP
zR6;{DH|8=(a`hObgri9HcHu2b6H@*8;o`K#6x`((es|g4eV*kyJ~+njpU1m+_TO9s
z+V9{T-%H`e2TDJC;L!b1RC9F59kI~(rG3^P#_LC%!2s-Q^pAHGhHpr_&;-~%Mwe2U
z2*PmMy1zVMY~<kibhgWW(fRxdcM{ut$FOw0^CCP>9PjlG^6t^)J5;5;Gfn-HCau(&
zB|8mlTcZ*-BQ!IBq$0u$XmJT9lD#)(!sblt+s%&4#lP$6>Eu8E{9>8c@#)ifu1%aT
zFIOY!y`OqSuCbM~5`bWUx&()?nOR?=BS%H09nxYhps;6VD-cg;-cp&`Bd{t1$`Ax2
zh*-cOvrIOT%9RgbZpKk@2BAdC9loA}S!z3zSrG`$JTf&U4AOS*ZC02^4@o0(PD2A#
z$?2{6$dn=m=A3N3F=v<veE$4{%)~i$s~g|<U~9R&$fnjBn06BiSu=C=SXrdD(#}`>
zS-tHuL#;b{?{IhBbq%Pr&I!pu)<eHA1j8}T9>EjGzj-Th`OsJJSR8U34DDBLe|>Ne
z;2i|~Jw1Tq0}JbV`0ZD?c)YU)yw~S<uZ8Xpx2cy=TP{T@!0Mjy>psjoiO~tdx8Ae&
zUmSq>0jptnKhfwTmErOIws-UmA1S|n@t;=Q*%)b*E&Crd_Mn;k)8{Aq`t_?nJw37a
zrqgM|oYVgH*Poa(?aP->FgKDsuK>+5+>e3Yd(;~^(7iKa)@@Xw7VD4`qpChmf=<;d
zs5^j`S|7_2;-DLus#@?QxhLUfR75HQ=}v*z%LJ%n007O>j+&IJ@XAFmlGH3Ye{wxp
zQN^GXV6)=EuxI8@;#z-(aA#yft(|6OG9YbRo7c;A%-G@H6cL<bcq(;1e?sp)=iISc
zrSfvwt#tnt_F4Ih(@O9ZFf(h`P`!lx5I|-9o5{P8ohhYR9RhvZ(#$j?H0EH7CW2_a
z9S%?4_Y&Uyf80@qw@3I9!+Yo9zrA<c@09%7?^Fc7r(b{1N^1`jg55nJ_&_%N_~0KS
zx!%FbdkUnfuU*{C9ih>T5a~|1pFZ1trr&$sgyS$752Bs+fb8>Os(Qo>j&<cxEW{7g
ziEj`7`m;!B&It(?qYU<SjfO?SFPB#%%_@Pm{PC}^ul(`HKefzkU%x%u7*pn6fgV|Y
z*X#8XKm72ywbs`g3JGfy$PSpV#w=v2A$2O@5KaIcKrh1)qsladh_rS1-T>c~@-0X^
zpfon)a>`btZ=z}v-hR(!O+ZE^a|H-fYO0c*O4aM+ob^N<QsO8oUPH<uVMuu?3vy#?
z9&?7wESmQ{axgM%-{<9g_Sm+QBEnu@Uy=kfqN>?b%IY1!68DLuwyksDugk+gIo+zU
z2y(aM_u!coX&w<c{0>XMAQsxs*88G6kz))1Fn7OOX>NXq1dw+t0^b3n-+hiBFZT~w
zfQJ$g{sDWUy(6R5JBNe6V<LLw#<eg5U&4lwnQk=Q<+1rY3O;6{fw#6=dUuNuL{kcC
z4y%ZOchS_u_h~=zaBH_ax8D8kem^C2{4!VY-UDC{VkiFv@~@?xT{myUw9~2U^>rc?
z2E-x-b4^v7|L{Zim5;}lmy4dCU-9~UHEYHnzI@i#ct&yaSv}Y(e|kFm^Ycr7{`{E{
zbz!?fpapLE|LU1I3;BbfvxJRAC#{hN1G^|F<*VbbMuG(-A4%iu1qvFHH;sHfD6QSh
zJlT6s2s^EX8Dk8#iXY?Z7BH8PQyG~Nqy<6HGXTzt3Xha9=9~@SW!o?^m6;Q*wY~MW
zZ|GM&eHk=UZ`(8j=cvxo%Ki#Z2(gq&nSwj4Is|Iv>Ah>tAfa0(rTftezpTuJC79A%
z({X+NRPzQi%L+JgNf~2ILFHp;*6!oJa%CoHB|qQRyJa!{)nd`(_i-;2`n^(M{fch>
zF%JBQzOoPW0S9omy>l=;-oQOmB6VHrEx&sp$NC&NV7sg|m)@H*g$BVv^aGSSpHHhN
z{$1Mgy|&<ZM{<0hPK1X8;=R}G`>emjSX0L%uzE8XRRO3l_MkU1X0_MOnT(jo9M-)d
zluVY2Zrl2;mTQd3pMLtPfBn~g;otxIv;OoyzQj*IeU+4H*8PVczVPRtzhU2B`O{B7
z^K?4#>rY?Vx2;9&Gt*(LCeciustknZg(0j5L^N{(W~!tQEz7U1a8Uy2%8bagMOo4e
zE#j!ul91Yu{?xh<3DUw0*Q~!=Q*fFT%w(G7kW?Jr0t=T$A{PcWNP7ixw&p^u0K2(g
z-2Bx{7iH{boZfAGYF|dqsX3;BK=0M^Hm70Ef#x2RC{31br+YaSX_Z9XK%}LTR1g6f
zOXEXZz2+Ib1695ECij*L1YGZZ<rsrzrNL-pimX_%yLRPca$0915E(Z>@WD^;-J$SK
zm%!Tr@PXjxv2DjbF#q5kAk5ym9q+%Xd9P@@yV2wB_N5um6||1ILMV^ZtKUx;k#Y%S
zvdu9m%35n3K#P$uH$@;<=bqki>)rpn@j&^-10Nsn{JVURDL?ul8WJ-BS>BESeusA?
zECY-LV&64u^Y`8xuh--l6H>_Cpp=aWfZ(U6jf;w7X4>WDqD<xM>y`Tq`|DqSo<M};
z-1mV`pVGd3dBW@KE1lMV{P9mgnq>qcvp+w-gy=B3MNE|HPrhxfjS+tE?*%>`nuM&M
zx!(9znFGMG4$smMl;f`6h<W4)aFuqh_cjH@%)H%F%#`K~Wh$hMBL)#tR7j|hnWIEL
zBLL1Z#*{EA?biC$y<dCpS3y$|J6KJPEbl@uB6XT%%oL>P5em`+1bTCsolTVzEHiNI
z<B;`o&e`T1P?kf(yp<aa)nHr?f6*7))<IHp4x6oIo1yRtFSeqTP!YLbuc#Hw(OUa1
zASW{w88_?kEq&$9k@;Rf>F*B(eHa@arM(}e_2xVDSN_W1jl0qKEkAF;b*!Mp083+@
zq3OKs?QMC?OsvuslMx#|29Y^^>~*3igzino??AZ6JwM)gc=G{!z{6{y4<x|4;RQ!x
z^g0sl?jX&CN7QbIGR3HSeGq%sr;T>G?D_JtGh?g|G2}=-eL3+us}}F;w^x4s_Dldg
zoi=`ZegQ!K^wYOxw1hG-&8C0;{E6Sby(kmed$WC?e0{z4zO@;1%FHom`cuWJYo+42
znYBX0jZz-j|DIU}m`F@gNtWBFXv4Hci`miu1dt*z4_a|acvqPN#!3^qu08<O{w`(4
z%=#KDd;|b=C2bxft(2pbh`LC*o7pbeAaOC;RSJ;h{(-8<ouFOEj=Asa4PSjGlG0uJ
z^yw+*44Bb+ubHK_lCrec)yLp<zxE7zZw(PCW0RSo)Rgj-J0N#QF@3J3q>M54l0zHO
zTLpzISih>tuDi}p=U*7`mOC*Iy#Y|bWbgeq3rT<V062hyd*tv}!a((~KgYu!{hlcy
z?;d<#|Nm)y))hHNWya(ZTxRAJFq`=ytSL&dw4#hSIN@omuG>nF85t270buMyPoGcm
z!13RY@bhjBi0?3gM6M11dv6+AtjzMhuXNyCmf%1$$76ArGT?zkMP6qjO*D^4FzW-7
zY%T#Y1~ZZY(LD_iuGd|P!1<}`<#inGI(T`R{PD*><8OcaIZ5V<)UMW$G(|*w`t*d$
z<%&6hfBBam?LYqGuTbgE%HQkOuKUho?IO@6^~37A_FQEmBW4~7zJrdcU!y|MT<cdJ
z0QF&$&P1@Rz$&^6$jp7||3wx{0cmELZnDDPu*^m&pu#>11kB7pg4|Q{O7q>_M+uMe
za=l)oZ*2ew_qJCih;Vs*MP$W%K}^7sG#WERlUdWY!A_@7tf{5Mm1fkpZ_g0qN+BZ5
zjIuf!6J#1`SZ8nb4Vs&o+{`nXM<S4<G#ZY8wiQ{n#{0w^Q>`=(0-!l(W@biI=}0*=
z4S)H|U;fa;kGe(QMuuOT27V(E_z~?k{4!GevHWx1iGKzF2SKH56+}XzTqT#~3Oh<Z
zR}gcioTMYG{VFrm+@;Leud}92qZkvRhB0#XZjXrj{r3_8;(E<Eo$QSPu<w$5eEIx!
zsPkha>|_Sj-{s5{AxG_F8DIcJz^cA4SpuEq7?YuVCWE8Cir~oS=c{54eg5HzfB)Mz
z3Tbm%0!i#Z!twO!iI?kMp?(IN6ZX?jKL;R1D6DvKThqsUdD(kaWU0Bg{Q2jvpgWn<
z>Ws3(jmzG<R&T&8D=q+ukfPp%FcNJkjw!7-d@4x@;;e(w=P~6kBwK)z#!$i*TE3Wn
z$gKGDf<loL_PRZ(awS3$m;f&oSW+p6i5W^vfRn@?5z(7Zv1P=}+?iXqU7?gAFR#}a
zbF8n$N>znT30awbX2{9Y`JBEq{h5+`XUr+Dh##7pZ>LSlid3)HK1@a#K~`irdhcAc
z3ZrNbGqVHbm+}@m!b3)Nq$))O45p*|0ZU1Ey<V~JJD#4N@Y7E}@y~z$^B+<Jw*N{k
z@x#N<cMbr5hcjOQt?VuwabGIA^-F-0oS}$iu}VSASb}pMx{5TR0^}+T!!%Y(?97?H
zclKs{jTx0{IU{q!U4H-lgPobs7!Vm616k5+%hnLotp+U2piH<~S>bNZJOC?RgAf=>
zuC&?;oJMAhKvYp~L=5Y_S&oD`r9_Mw)rwmW0wR-t|NFOzO3<keJp?Kh3;NIh{9Cnl
zBw(<kn;?Kl05fx;cIGssWkrJ8@g@a;W<<#0$P!DaxW9cL>dgfj%wj15)3Zu3)&a_8
zYdvmwl2ibgD>GzpB@IgnGgwW(hV|gbnqFdI2V6AUG$SR2H&Mya+@_h$6w??JzyNtI
zr(>vA3|<xxmH;A^F-H!%%|;HANlT5X5X9EHB2uSQ$G%4%G#`$~IGm-<D|KP-&7{nI
zTn!{!tDBjmEvs_Q$^)d+OS|YLklK2ud(nhhNH5&oGLt349#l%Lw<9IUr1BtuObZGG
z+#7+U>N`Ztz{~Rs_I>}u4{!SeVFJGvON{UK-Zy?;cue-y(Vv8)Ryyk4fB|AV#_*h)
zAR=bUjA8WRTM3za&KU?H3AH8ksW|9R%o*c!>NIfaB<l?kvp6lZMZ+#|m4p<vgS$sa
zOe7)_0n601q<<eR7I7;WwnA!-DW}#qgVpB;ydHk2)&frgIrd?ZgP%X2`Sp6Kl|iAn
zx!$0<nFMzrZd}7urC!_`5EuGeN-(>1)G+~#h^!qulX5l!vue8J5>Csf%hsp}%Rm45
zvrFk;zrM;09vRLR;+vU4aLIPxGXHDnufcyg2v-7->Vz;rDIP0?5vh8exGKW5JR&q>
z(p-dkJsaqdt}+?c7}$HuS=##<GYrn_y1B!RWBno$$c#ydP&2QogFg2$1UOeCuugr`
z)=%8`pI5k1KxqjOGq1T{o1M<}Ge%5B1l^o|G6#XY2Fw^_wNDwVJQdPi`x2Me-_?4D
zn+a9JrZL717hBbAN+p?A8h=u&)fBCigcxI>#{a<OdWD(6#`y0!0Dj}Pe{T)22O#hs
zC0_yxBLs{&j>Z`8tsh59M#MOrDRairu?m_c0nJ152}H)Nfk`kVVNlkM)3=r+!<)62
z=U0J{8@=_)&J11UIzh@KG(!8HLPbZ(-C~SL)lHuf5sAo?_cy^$0?jZp;Uh*m-44;!
z@tTNlR<$+vpg`<oMh%Jv=;xoG>;0OEtc1Hjq-yX9x!WrL%wx*X$^p=A-@fh4M_g|S
zdJ2872+=}V=_DGZOtdEws#WHQu^B0)M+sK|XlCXxvMF<{n4p8Qvf9DbGu4-7X<Y(b
zhZx0j&1wmXVx7jqjR>sg3{~J=96BlYHY<c6=g}n~)yHIpxiiQnG|dLj!HAeKK+fJh
zGex9lFn3BpXg_UzF5oPyDXxM?&!0{iAzN7nS;0ohRHPLakr2&k0;%ok)JWoby~w=*
zDU1lXLvEJVoXsnUxpWIP)tH;kr?cGKk%FW#=Aq_4;@Ii#G`9oY&pBr%4SnmHF_oFR
zUaq)auZTIzfDy4+hd+1#{GQ-|hx+074g=x)NbT=D`bW6IjCtccYu&Gus)Zjpl>0~(
zx!epHnOw^mqI48Vq`8SQYN5E9id06mQA2%mEh<GJm^;~fhay2^ZLxwfM`ZRa;8}`X
zofER`W;r6`cz{;7fQ~`8sES1F>64+eZ#qI>0oLx2H`HGdk=}^sOCWQs)yQB+qof%u
z3k!owl>r3KnQ?pF4P;UV&pJ{9WRnz#2pXU@jUW?3;ufxP(^p$ZX`!@6?K+;!7-rpH
zUM?Z9uSj)M+THJ7sDz(98i{!;@wnY~%yk&nvaw3EZ?olFhc*Qm%_bxkuy!-Tj4~*#
z&=1-y-d(Z^9#}`{L~FhSHffx|sZ@cH)geg5X8k(m%x&A!-Q#k338I{Kt+yyms3T&a
zQhwJ&D9_XOggT5I-i+=Z6wKY?^|JfR%WF!aw+%6NH*0V+_U)wdW7o>YLinQhp6(8#
zS&=1>nQP8a#LU|2tADJqWeJ?HG)RfD?@9>~!8xa5=0VlLy@|$u=mfxbXfM8_dyfy+
zhH$T6Ub#$aswvK8#i-OBTM?`<^R`0cB5SpEOJzg>C6HCXRG2d<yS47BB;^JJ&%HB3
zIcCv2zFM>DVeOKJfZF{XL)I+`WQ46-%mg}e09N@!)sjbLjLFDIAPnj?c9#RrVvMAB
zq=L%SoYHpQG{%5e=zX}ukTAMS<x|Sl*->2;KxPJNO>)(?QS?;}3`pQ8sx=l_L6%6z
zWSa?j!%fy+3QZwM?(4xV)wBVlP;|H20$oCD-RyMQ7D{z^+rj<1D=KPC1hT?O>op^F
zM0`6?)m_D{rxkrz<IUpzDJb1N-F?zbR_VnkD)8117)SQsA~kx1_RMUj)9GStyBZ@k
zV^j=L^xj^!?J4bgodiM(o$4Tvx2DXLn`7=#XD2<X@(UmXlGD8ht@QWqj{Q1v&dGfr
zBFWx5vrV@CnWs}vH_JP%{!s)nmQ_+2WeaAe4q&sj!U()MBBn^oRLWGD0`=jcNYK5)
zMO2dOtX%Vsm8$Z`?ZAHk1k?vN|D$LqAJ&3<Nn#$o>NKjdCkPnm%k#}l%SdK~tPTv<
zElW99T7{$(%MPAXQY_Hqc!OZfsnfQxZ<}2%R~QZ3sbPN|+7)VzRa`ZNspQtXXk2;l
zt~rM2E(%Z#?8jh>t_s>r#+2L)0pyIR95^G#h}?(RF$f@I1V;?L{>KI0-0b$crC>Ks
zeD&&;O$~?Xe`(z7AxJ`&kq9UxtQH+oHJ2DO!_18C1mW<Li-PTQGBY%#LZRxo)ylTw
z7&4M=oxhMOmAAmV685Z7c75Y&yd_{Vmo)YO@$QIE`Xbj=42q)kE?x|S5Lj-$^>ZEy
zmH@byaY?ag!7TLGc0hAUXb;vQ%rS_TV@!N{I`8HdlCm{V06{R%Up5d6Y(*j^1Eo1a
z-g=rTDu6W<k=!=R^Z5j_T7|%&RO0ievqyGTiHKM%NwD`0qm_O&L#g0NUjP6g07*na
zRBBC&(#wn#nj2TPVJZ_Td2=kqqFQq-HUKfFt?7UZ7eJ<T+BTXyatum9?@hOb^B;);
zJRTMg)S%uG1%1yF=;%cd=9nNzZ>_iHhYFz7Xpu?6vJ{mBZy;L2Evpy?R0ag8d8Zkd
z4;|}9A2^*(7IQ|7AUD|@hJ9RtFi@M&NEsQ|5zQRtoy`IB6&!$AWgMpKb-=>ddq`3I
zY!)9_?L2!bO(`aypI=q|a0rxoSq5|4;O<=xDl!!EtkEKwDT}D5uf#yk%r49jtMR<F
zbwv?|<e3@kwRO42;*{M;n0x1XB25AsowH2p2Bbq2S?WYty$?<&$K{fT67CnN&-*?A
zV7Atoc|>%p7GtHY9sQQ?fB4szuB43e#1R}|O9PM*IqQ(QiDs}Ke6f&wk-U}w31g)c
zUCn%!3y&-_lBcA3+O|ADoram`%j*SBOCh2%`b$@I<SBM{%@j{3Lu-l}#Rpp3U`9SY
zo$>keCyg<9y<TNz*tSpDdJ{>new9-1l~K>R!Wwf%0*SQppcIcEBWZ4wr6NHZGg7U2
zeL%&VVT{Q+CnLh=oEl?f))s{8WnmA<$|EQMrR?GVr~}|P9{!IGf%_C5MTCr|C?Eq6
zTyJxwWoE?8vY-lhYm1Q;t;A&2Q`K2w3^&uFi;mz4#0;4^G8E4*7fPb8(DbX(I)u=O
zK%+xSY}=VI6C#LaRMzkjk*Q1@u_P%g+`-C-UJC+%h~@H(ofTV&$dRDA%^c|6Z0nuY
zJxDKu5<2#M$4DUt%vbI;T%tS9=W`mW_G?7&>8bPi`AQiQV*m|^IQC>q($l>}s3np)
z+=NbA$Urnem0$(ds9E%9_YGt0_VN<BXy*$31CcomIPrSjea;XG&N*Y1Y`D{rNH090
zRENdxGFPCdE!-z-eJR|)-D%_$lty?ex!Q$pVBuT2XsrYhF<Wb6NsHC{RtDviZJR@)
z=9uy6^V3|ohMjsB+2V3}#oGPk0z*_uddbF_t)DU?a|~j6fB0|z_OJZ<^_g={_1=!!
z@|E~Ym@y<Wi|+02#>zs>xN$;R#A(rl)1(R&wgMLf$(8_U=>yXCF*RfQJ_g4=V$O+(
z$<hGGoG$uE8r55)v1b{U@*mCud{hti5oYjRBageUOmwR)xQv~cW8TPDlBBx<dDJ^4
zR2kA<N%U9)?;4AVWdVgdHO5F~V(T53%M~m)*0e@nO|uqd9#!woa;}nA?UUNC)7s{%
z(~j7u5}5{+<aLZ71S$c#!ySsqim^d*&bj~tiiTMGj>G%r-Hk;YVI>f`jX_F5Yu#BY
zd-dKE@PwI+p^jB<14HCs#bNMHlAKWtfXm$z@D?#>fGL9|nNyg)Z&g~GmGArY00div
z)-Gi-6C~L4^UK0a3NTxv_yiQ9oK@t>)c|C*^XCE$iS@c4dEnEGgTyYZs;?uyrGUx1
zT)X<3OOniW5bUV^XG)pwe%-ddSC2?quif6H%xya*IR%FOj~{=~<#L52%}iMRib)`w
zZ&3$cCJDM3#@zMq|Nfu#Rs`|o%O^XZPrL=5W<~}uV<!Z<^`belz~_2DI#)E>8gQAy
z#F(hia4(}_bI)oQhUT2O?$@^OV}+e2QyDX&SXh-x#<M8ZG}D+9G;+@IkEsT`zx{uu
zDfm52KzlS49SJ7Id?@Fb^5&Vv?KE>+P_nZ`*hi5y-*SE^ne(Co2%QFIHOrJ`(;VhJ
z5`F|)8Xaz=xwDmK`#wye5N#vpRC<T)`_%c|X-<?5!&4$MlN4yJkqdV1y(-Dgy2v4~
zdAtcw@19nvHwgzafO50s`r@UpcklFGP^f`a3`F&F0)Sq=U0F6@0I|T|NM#)|X<*JB
zu&o|*Gqczy;Z)QX!C38C3(>c?z=%o<s@vJ*UOsk-2UzE|z$NA^-foq87-`d;x?H9m
zF2O45K}yUcP-H#KbKw@(;~-l2!d%}<u0!B3zWG}Oc`g)2$30;YnHA56Y~5ke@)}nk
zb7pJJ<_xsn=b}>a`SU0I{ck_BboVDuNfC2iuUAFRbaT)kb7`}V*4&Eqm>6TEyP>|F
z^(IsT$(%7wU^I6wnF~)(Cx7|&IwM6WRPUdVVg-r1Th27pvdKzAXO1y6$F$7E^?F?j
zPfD39{1Fw?RBu?20dGKzI1*z2u@k^=#E0P>9N^|29AiY(ysXSb4Fi-5zB<&T1OhWj
zCyY=^G`v<nJI3mRS96agsYJJCU{yD}n@A`lVQ#4O+T@Ixk+2Shd$ZQwLRaSu){RBc
z3;dFV>-Dm@=LFy;g(5&@@Z?qiW*V+z2h5Q<;EqE48%z8^S3h}nGa;anNvM=TIdW;g
zkJm^mL~|iJAq18O2v%sj1*;k`i;FBmjP)5KOUUAg7z`j0YHR)S0?@$BAlWEQui@dw
z%2P`F^y#wz=C^Mzz(VNDQ^1=Ke%XR^jJ?gtu>wNu=n7d6umB7ibN!Pr+A)3PA)30o
z<?*I5K$_Vs3a}c17d6?+l55$T&*h$TqYX5-4#-<iWuUj7ATVdeY|VLL-<o+<o#mKQ
z`yNP%F%#Adt#_PGXDEX+0+}JG-E#ZZ_YA8-14R^oO>k)yz&S&6zK#V}n>Dj9Up}|L
z{`K#d%$PH#M@+Qd>XX&#gBb&J4ne{k!y+c;3>4^0Dqun)BMhK=Yc|Fd&D8w=?@|8m
zIsov2J@!7*s^XB3%I5^7$!2aeHj@yVL^4UxyfRYT=2vBD!p%95QiM3m;}Rv5$dlRH
z&)t=ooMUPq6Dx~8nj56VzEAaDuDLa`(#+Rxn>d{suGax+YVHudvG;C;!5Ec0v49(q
zjF{MG5(t*H74Qn$htqLBcfg$Cu!Y)cROm!jmY*d6h6XU4=!OU=BcKZXSoJw6Gl(VX
z7e?s<W2V7CGgG16sff%7rIglaiW(OnrDxJ$PA^rS#rj=k<~Ra6zkYl6rQ8!>DlZlf
z7RSw~*4o_1sPSL4GH~)Pp6#alo4mzT2{bm9I0m`y^S9=q+P#l3O*7}3AXIFc&&*V7
zHj7hlG$XgZ(cQO9UR!e!tsXrHIdgHKd6V;6g$8Smiura@;l>2jT3ZdGhRi^wAcv||
z&5>Er0EGuQxK$*31&@L=f~{GU;!*4;*Y$PJ=Wj1#(W8v25DUv%L8d|^84+e~jkWO}
zfv6#Ax_L#vuTYQH8?$N$j@29$m+{ZT0Qdn0@Lq;qX0G4rGCLmsn~`J%AlMp}mnzB%
z?3ZQ=uj^{rNjib3Y2JmRjyegiO6z=)L~~=43-EKPtLhvYV_=LCnb|5lllb&$!@fga
za4O8G*oD)l6C-kE-KD8wh01+^&L}xDl*vTU&CSfLH#eu7cL(5AowJYQm(PSz5kihc
zK<Ue5fUwvDt#w2W7Av4i%~b|z>OBuJT}gmjJs_=Z#WfX4vE~LlS~|)RNJ~~t_DUwE
zQAqLd_1A~bS#Un{78o3oCWKBSA~G^}7b@8&nP~2ajD`D@#ovt6Op8}9<iETz_5IfY
zaSMr#W7T|%AxB^J-g0ls40tKzviCmST6$~MG#oIH)9J0qGR@53Qr1*rPh}J$C7Dva
z_o@-wCr2si*xfm1DCW?YFQ0L}TtxsgCZ4~2!*)6q?N(Du>A?xFf)&dmjp|T0Cttq3
z%(ni4n`6(Ns?t<%tsUjDoO2ZDUBA9`_mHkf_k%49)zZIM37Oih>TF5K`A?ew-fJiQ
z*eO`NGgZxwhwZC`Ep9Pq3<$k>72CS=`0Jt6B{OF&P!PdV0+vQPA#KHjBQx_75w$kf
zRV9G0ycJU7WM-`rU^4-_B6PLoHccS+RE&hRN_?I3!Z}qvR!%u9T4SF9QWV6{EN21D
zw(fOCtwN57092~L2(4Rh2uNkgY15D(I#EME&*#QaAY$;%a$H80Oiuun1{6W}jg3~W
zeE@T=2;s_7SoK<FMoU<%a!{zW213GW|D@%iC^e!fk%yhP=qdCv%&JbHRq6>t8kt}X
z6_B}>$Y%+6j)WU7;1KHsDAgC2^^Ld-x5Z&FIvO|zpb0SD8SXyZn*e7<Hkx@#*U}Q1
zH99Yspu|vSl^fOikmbxX_1<{Ny}qa$5CL~$%qf8S%m4g~K<M-5C;a^LS7a#X40>zo
zy(J*q_sKCvl@}4ram}2W$3&UJOn|YpCGHmH9;k^Sj+=WH?O;)^riv>rqn6bgWnr{P
zX0Fe3qzNYk<*YSkmKQ+(tQFu_8Gs|sc<t%ArkuqdQJIo?MM$|>^{hu`QFAyVqhEv^
zW|p%+j)X&VhMC)BU4<Dlu146AleUC!+Ir>xTwbrU!WDftQ}b%2xb|+mj?mcWxwO}n
z<CcQ9)-`9SwPq1v5tB#Fb!Hq<&vfJJrRe5PLnd(-*qD(Hh%vxG0t%H&54J!pCJ4(Q
zdv_-6`T125StT@aXm#FPi{(xT0&)^jLk5ZtJnAV`qLMjh$+0^u(~p3P0HTs78!7pM
z5oGRZnM|@$cva#ZEH)-t&Eu$)V$-1lLM*qBEnyH?y51W60$f!^ixym1LM!o)l}r=2
zz|5O)c(oN7P}`lvxfG>lj%${lM}pYvOR{K8nG&(^M_W09sAo)wnOM=|h(N^?)wlq2
z)7?8;U%q_Cx3AAMFA5-LRIZ<vuyl>5Go{GHTt%N%o+v0%Zni(aUXY~#R4F{kSzxr1
zi8;pd%S=|T1SiQ{)MHi!ys}>3)Yylr(ydzDwr$fta{|Ca2;p(s+Zy3H=S0lV0UTwG
z=!@%Hvs1l^(%GsBUXcich_UeNNg~ZGG6Q9k0-)?E21&GLEU<*<H8acH!`!g%BU12s
z;f)e5-u+ASj@Fv;Ol0I0)K>CPp>MUvCxTMt>qktB8HGib_ZZvO7?IXmGbcHw*qYN6
zh*Fag^1`-Ns9t8q0so`Mb$Y0wm*b#*c)-0=8nn_orB+(noTfw`yjUK+5=$1W_Qo`<
z_%OoQYIsD(oFh_6qldSpAuQTj07GdGQv$K3IJT8JXmd=aWF`4OqCOUeSbk|Q4Nn=O
zEAOMkEydj4c>NL^&~rKESa|>?B3i3J_5W2Tz$o88gMz$!)@oo$uPX0_1)&^_$(*v#
zG&5RE88lJZCdo0tZL_89ATon<PW0yKr~asZufD!*Lq|`dnxworyqUb6i`L!us(spe
z5U|!-f?$R;5c>A@TP~|sg#el#Oq7=I4Vh_~V$9(3hrwtvT9_L^kIc*&Q!dk-Q)M#%
zwyl>;@}G17{2~e~Gr#LLpJV2XSwLHDOQ0F4WMnKU1?z?Hed$#y@W32F*^rggiIoSa
z<&cV%RYk0hxg|Y?yFHgGD?dfV%n0mbqE1fO>+4Q;!|8N-&CD9E3}?w8Wj!ob!b3@x
zNnNkIWsdbGD!Zb)`KPBdT5tI2r*E`o7Fon*%mFmlP4An-jtFnWA!vpINOuSU3s4vd
zZiCQD5fPY6?p@uM2PZfVO}^G<l?Y{NepY2zrJ?F(@;So#>gAjU(w%8;sgy_9s`g4R
zfps>iSypyoC}jJ!#>=|ladZwUAz4idMkUt*&qGaoF#3uxRqOb%=X(*nJPw4dBEKvB
zc2SKhp{YQ^!W6u+RmyU-D8_m(T`xOda#}^01J=xqoG??Qns>|IPgZI}%*sWmb;f8o
zolZPIopHJBxLkHUJ)H;;V@&kkh+5pVq<%Qq?5wOY`_rHQq_01JQ!4Xv-H&cP_TF;)
zq4W9qSw5wtCn3z3m{E?;lKJK`!KPA*=3WI3&1>Sw8z`fF-&wlT1l=?vv3cV^a|O^{
zzPKcD&WYCAU6vrL|H$cW^-=*sMj|qaNYYpu_)1;go7)+%Jqw%C+T)U>T5odq!(Mr7
z0wzVkGol0_04@c%B`a_O;a;V20H>t5UWZ>X+WEX)dgtk=D=aZb1#q&gfgp^+C_hpW
zKq&ooLvv#6qk;-;x$puN@r+<rEVdome?Qt|Z&Q@y5UrPFcim9thzwyye&_MFs;oNn
z(I#(27s87suEQb;It&Iwi$vO5J;utJ;6l(9kunQg3PMl8Gs0(t%u^*@V#|c(&7cEQ
zE<xO3B|gIXmj>im>T_8J&3uJsS9<h1Cwv9*#1cABKn~DI#L^C|t?@0jDw8Rp(Ubr=
zM<AxC@;WI4o4L%$K^V<q+Pa*!ZG#zIQjRgKn30LrJk5)6@7<})dqL7IuFlMKxm?wI
zv(}ud)B*L@mb^G+bhPf=$1bTND^r;T3rJK#P`#}IMJ9Fdq%oD!G@yjuZ@phKGmWuJ
zN|2`1L`2Boiv_TMJP3Fv1p3Y#6cNWkkY1*4WmF@NS0#<1kWfudkVqOCkz?P-skOEX
z^n|^dfxUtg8B0iIU=WNq>_L=D+k?6t4pksCg-nE7iS`sh+q&Fs%o(~|cI^9z)>@dc
zwbowOVbaaO-W$w_>vacBoFhpZ#@Go5&)b<}pP7+sUd?3^?rN@Mwl^58L^yfGcVI4!
zJ!uQ&ujC-y%v~i)n#J_<h!<F+Gl~nZYvMqgm-SZV?Mnf$FfFmsEk~f7m+&A%Rp_zk
zIpHLzrPK(X%nV+#H75<Cj4(N}XI8q|$^~deB^W@(3invX80q-_7W89UeGyAQRSKwT
z3^tNUs=XDAavr6nZ=Yj@Y5*wxpjA3HEa=%7gy`t4ppFWVkTDB528qk%qE-eSBkAY!
z39qkLda)w`f#pr{TZ&bMlCIRC>#oY}7fz>5aIkL;67cf;jID2#E?7<%_02IOH1??<
z|K&$pv10hY|M%Y~#=tF6D$6ec5#Ah`X-uURUdqzVOcg*llPC?02*em@t>gM~`KPY{
zxPSQTn@r6)>-rZ=O3pd5VvK52bax~sqx=9(%Ilo7a{rwIEFgxti>AoQsJ7*b!&^6C
ztHLbI5@nVhZb`HVq-JEexoxKt-Azix>+1#kK6%=@PUr4RXwp_L;Q;V7=d7r#=Cq{s
z*7)-BLZI2x=`3#!0aikh<mq%`Yc2PE5-`Nvu`7`2E5kjM@X9ibd84`BVp9W%8?_f1
zLtuHuL-j^KB-NQ!JxwAqhxQ3LoZ43iDWdpbrUA|+2|fZ|(};w1%gE~5tM!SQ8i4v?
zXEv*(g3Ke_M!vHD+I<1cQu_!(Uw>Aoq1jCVx*l-h$hy04#vy!V796a=5e?r~0m+f^
zcU#V@L~~23R^Sq6hRl`Sx?Oj9gl2=7p)6WPGiIPQS48zEn$fqdtCf71M`iK)`!#Wu
zon?$25s~NfmQO%juY10}UMra|l~13ZipnqgQ)32uYbYqSY~07%WJdklzx}KK@Bj6G
zA~KkfEIx*6y%)yNJIY2r6J*XYunJa6GF)R&iLxc_afMmKKkEPh9(u^1zdduW7YWS|
zp0uWg1GtbtRAHiJxn@{hN_L_UW(<}QMdnOpWyZK$WjK&ph6;0UsYHS@R)Y{y$T_DX
zk1jc?_0H|oK@!iG7gWc42{yLWxa&!?b(qb}+$8OD#%b(Br}HMrbUHQk)5bXi6}Fo=
z)M0vag{_J#6{`m!k^*8G8z7Smh>{Z&{=<l&qu``~M&uZ?3IQ|iNP}LLGFl9q8>m3Y
z0Mff$_Y94gZyf|?s!X|RmzjYyr^!MYnd;RPoCHcqgRFFv<KiW`NpGq}E*lz-K*Z9)
zmj1fX>bZ(KT&V^k2;TJ!7d%9wEk=E9)r?h5Xe672(_zLYF@2*;Y5=8B05_SeM`oI}
zL1ZhXZ<Mk6{}K0oJ+^Jfb>A4H=3KkG&mk!)2m>Q<V#9AqkmS*U@+ky;PJW6A$)f`#
zd6O;0F(AkQseA7^-M!bGRh5UTwfm4EBT<q`0>r(%B>QytUTe<!GsbU7*zVakewqoN
zKYwCv1~w(ZOznfH&$SqPbz;pq^E?+TdMybY9exz~et!>l&p9VvKHad+og7Zz9`4a3
zv-}npZzSU<fAnMg?caWf@St%Ztxq)U8V=T>kzN4>X+~ryF?u9aY|W&UzMT>0?`H<^
zn-~HVvDU(QKXJP~Va`MC;3~vx0O6IMELjq;TBP%&bW~DRB%KxQ4sTBoGZdah%({|e
zN^8z$^H;B^h(4|(>7Lg-!uR&ReKV{7!w`YJ)*jP*@6sSkmXg+SOzd4%&6jgwtyNq(
zKILAEYj4zyAt90Hxj^og@CMvjUh@YoTx@SbMg$`Y#dU2=5TIkThJ2T|zjg0%4O_1$
zFqDw8DxnJ@@2D(2KIZF2RQr*1k6{qP0xXhx_{M;uC?ehZ)D9W|(lUxRGejjh$c|Z4
z_KuADW?^4hwwcVvfwA0x?KsS+mO&#?lfsrsB>4b~+STrMMR3KbUti;>0bo6|9WoNh
zWELhS+f7)cVw116hX?j?7>jaDj$!$uAH8HI^6l+@QA|0Gf^*dVJ#(!ZV5=68)xVgr
zwF;HQ6iIi)?e>Js#BrMy)bS*|etq*XM%pCzUU<2^Jldg)Z?VpW%(9<L;wbY_Mn;fz
zRIZ4NN|a22tm%J*U}FGXg{t`ve=sTVU;p)AmwQ9Cth@$+5y6B?J?q7^uME0se`L5R
z;y&iE8u)V=+J_do0~vG{X4`mWy+7s+wNuW0m6`p^%(w?j|Ghne8R2dk<MZcFa*sIA
z({{wz%aPcz*7h;%c)Hz?z$%56&f9I?-rwFCnb@{6O0z(B$KC~iXd5RA8Ev%*F!dW^
zm$8jm2#gOZafCr)AZ+jWHWx6nq^nm1Sre=4Kp`#xS*h;wSE9=5e_GDbyjc8j1mS`Z
z2?UEl+V{1f3b(yhbj+yANEL_4BzuBeSipX1!+K1WBrU<x$yVim34{X3(SCXFseb|X
zFLmIB2CBorKT?O8P3dgC07h38rEF#r3C7-X_gxYLA4KT^4D=uU^s{9~thJ+NQjhv0
zsvX!_4o7hBWtIPDIfmF+vb<m%K<3vkUop(6VWrS4mSLKV_xp+4?bfSp_&5fA`?twG
zy{RLC#Ce`DiL$!sfn;<)#kw7{2dO;?s@uIPP)85XIffyV7{>hb|K)$>pZw4NQ~ur$
zfG=OZV9d!+FE4pHIkRS+3`C9`7-r~JpkC5U`to;7v$X;?GD&dQESrs47ErcU|Mjrw
zf%9(UcAft2m1SKb6pUdiO-_l9+%svpt>PtgyWQmOdV7EG6d0x1u_zict&m%pa~^Xq
zhv&8qW^6lefhcO1ORROmu2!9>{L4af5`wZa1Jt)Zq6dB*79>EHxkvQWsie_Jn$%R|
zPDCi<RCfb*Y0@vB<b_mA4?>rZnC#UTcDRb4a3#!ax+@zZkXMy*4Hs*sYqQ7E25^dE
zeYTHEAWL!hSdK-rp0ct4GP?Bl58`p5wEHD*-vL_)gi`L-$z_~Wv4mj`nKwDzWbVGb
z%sv>&T@#gv6N!k7Au+#xy^k+n-r{FJ`_HTo7%zFT+?{c*%_q}v4|rR7pPp_}cXfe?
z_S$hVDm+8$zIOvWhy=%zVZYa2{vMGpFVFb$!<RbtGWE9KWB%mx<K=&Ue{Z1^Tc1+#
zXKSr;CaaViS+VV^dOx{VVFKMZym!yKMlYQFlRx>_@q4cT{>{Jn-`OT9w5#@k{%O^3
zdh;r!@<>M}vIGHGXFxXW0X001Aj$<+6-35$%C&K%oon@ciR7;2IA$Vk7{{2ANUpU}
zzdK;96`8pu&f4!TH&guZ!w>lBPk&lZvBxeyd9o<M`C2(~<EbkTTAkR+OziErJ>PJi
zXZc<C$}7h$6AI*v9agC@<(TW_Ad_GbG4>8-#@G?F%s&|b9g4#3TxrMw1}?q%hwBdE
zgdp!!BKK;;YhT}c_L?lPFp4?qP57ufywZtQMBFlC13Bt|Q4jriw2N<gCs*-$MvDiK
zNbG9MxNCR^BvPn7ZFI*U6r+py_6evrBL&g~sBY^94GRSvjGa{M`wc?4V;_epb}HcV
zh^Xi=oW*MmIx>Ipi|-^dfA+IKwnC?07U+yGU%tkVfBfTc_a^@)hmG9sQS=|foFgNc
zx2FT^+>kNH7>J1R{=Nd4+aoeOn9Nvfd4K*y0`-V1&BWKQZ~6T4q`h6QU*B?!QSD`9
zuC@ABugYzmD<m}&uuNvvmW0l;$iP*Q4MfyI5E1zEKmXtOCx7y<f4>y~o4?;~tH%$K
zmrN~7^k6U`0&A}_WXKSwQ#L{f?46Vh=ecs&K*j!DSz#s8^@<Hdx%=vrS!JY<XVrLn
zZya+<6m>gttsNbZ*FN?1EJ<dJVKl2>qPyq&`<)W=`T4nP=;WO9-243~ue=bEW6lCV
z?7c0@P7FywsBT-)vep0wU_^u!(KhVrRrgLsfSI8tA2D!+kR?=Z`m7SRQTL4~vru*)
zAdtvTi;nPe(c$WzYa>+&zDP$H{8ysL8Hk!S<bJRMdm^vQxVd8%$tcHFWL2#uXH~%q
z^&NPxt^A4$d&Gj(%bh(?4ArZ6Z2+=)g6$%NKIRA5AidlLQ4t%FK!%+s9F1|7xO_*4
zs!I@J(Dd?hV?#;yx0|cd)F}4eHCKXS9tVL;ir!eVXbf5&$D}>mw;YK$j={Z`F_e+O
z?RID_hYiJfF4Gt=XZYSZG)R%JU*Fp2A1q#LLq7XGF)4Qmf^e=A7f|Fp@7mj=W=PRC
zD!USatELRk4==^<@c{TA{>T45|Ih#9|AHu%#-gAOSN&5xO;or=M!Ne|I>FsNYSNsl
zU9e?lQ2fRS19<MHSd@f*rP3sB_ltv2l*}rNE<2jcET5lm{NaZ$X=ZqSdZvft?d@%U
z{rajg%2ZMCMYr=j_5A#l^@2Ly-{1N6024s$zka_x-KH;h%aiWDFMY;b%lY-~E|N%3
zj8Vg=*da*+&?GVPBR<{s_78POO+y~TKvXO)2kKTtz@w@`)U*HqAOJ~3K~(PNp58}5
zBWg<rA*4{UY2YB5e%HDS2h7Y=9&)P;`$&5F=ncp~#jJlD>)z=?h90v_(vO<fOGWj$
z^nP*>*;#*);Dxg8C1;}TlaDP&QLz{zH-dt7<ye)$>;qvV;58Ov!YGD7<?z~#GWJ47
z!Y@~SZHjsnG%_<}rkHc$>(^I%d3kAQX~KQ$<>f_nDX51f_2@PQC|jJA7jOU4v|pqi
z_w92Y`St6YYBOv&j-kDsW)^c8$1v#WmT&Lx7#f#gr(X6^0R}iPz<vJ!Qg&yAOt4mv
zfrvV32xYNon@fO9(Xv;Uf0!ZQfBWD4H~DY>;xFso0Iq;h#N(HS)<fkbO5xtCMoCd9
zq}%N#fUX{IN9Q+R<Fuwmv^k=h#xY0tZJ?RaB&bs#!UL&brts<03w?W@Yo+ha<GAJ5
zudisqN*QPBFc|>(e!s&c^gJOWS^6Gd<?t)Ne__Q$u5}U+*9x}D-<kn5%rucPBaEuY
zzX2r5iWiG^9G2H+NDVAe#P)zb@>e5}!mj)^k%<k27=Zz(WxolDQY`>2suEGbKybPF
zGIm!S_1_&x+yD#^bI3*%gi}PpJuBhYRcgJlN#7s?QFiWPZR$e9@5fR!!miJpq!_u$
z>||i3a@1DHu^>2*lhlqtc-9b+#74Rmr#%AcYkOR8$*vUR8~|n(_usaAeD~cK4v9NF
zKYe;hl6ZZ6;~0Zxvfc2}w(}Nlx_E!rBL|v(1#TLid9Iavdvg*yqAS90w@=JmdA_d<
zB#&d1Qo2<>HtbR~p)hI`a0JN6^NwCY)=%g=Ya3PH$`})SE!Zd-MkXp=K-J-mF`BLa
z2Lgi3iae_ARW_0#TNFhi1Mren5!FJcWQvG{^~ke!>#^3t81)ZJNXUl$*Af4~aPuQP
zkwlI$SrtIS!*zc>eNLm9<?GuU%qHeA?!9;%$7;uw%{hDV+*z3sAehfjw_D}`Gt1Z4
z_t+k^p#)KJB#}uZg`rfyWJTVs9)Co@(!(HV2#N~2kc8af+#7}n_PXz}2)lxULf5Y>
z@)0#&^SiPrtLK3T0VBQ23GNLw6u8WaMFNtfD;rQ=`*Ujr$qmE}s3`D2jH*~<U|iuX
zyUTM#csUA)Aoq1b=eH23S_!5B+VxJ>Il=^X#f0ZDYsQ*ZqMQcdxoho<%-jf1A#lL5
z<I;erm(iMjP`ivvrx2l42~s=L*YWa%KYDrgYl6Oa@a1J<ovT!5yM{#9G(N9@3VyRz
z`KSm)(J$X)t&f>=Os6FGy8X9p95&$F1160zAl8Q|iE~;Fkf}gbw-klt0k&A~ivBjU
zR6Ax%(p=)KO3=+P3PnXG{%%^|f5HRcpZ{0?W&YoP_5W}_T%dIT^ge^D;Gf?*D9hO-
z%LwP%aOq&5s_^}xZ_bCO|047z17VEX0#w<C7I7dm)Ap(Wzw_LXT)lsuoy@w;<h~=u
zv|MZ39F}}~>T{@W=?i0hzu%DvjA>lwLa!1XpvEyMfs$E7Sc!sq@13E2$@l9@))<Mk
zHX=aZyYdd8q^Xkg$_du(PbeZ*lX9<2z^i4b7hfv;2X-5e#E#@bBGfHW1^q;f8XL=4
z%<_qd37HT%AWR@f1V#-lWAt-U{qZAvL1;U2v4DEl&+7MfzeShCx9#!Oss$c71DQyx
z=r5^m`E(LHvg8AW$PZ5hu#4Juoi3y+0XLcL<xXO-m#i7#4FZVw_cPvJ-}3qSnF;cC
zJMhEzU-P&fg{a$ZHb<0Nk8z$GbJk3&d+NM~hZ0L%6lr4mJZ^TLXP);nC4&unOvcW0
zwJNg?d;-Iyf?BOmldNfG86Fs8GK0KVvJu7@l>yGj&Cr{P?yD}ETRJ$!^hp05(cr>A
z@xL-6i>95AerK&+7;V<EtoG|mEuLfTUNa)sTH$-~YRr0I+xk>S0X7~(#>~hZT~@g}
z*10o0dRT+lYp0}~bMpD+>3Dv6(mcjKj_H|+F~sATJdRQOSJLnI(_dfT*4{fvyhp@+
ztu2v;Oy2MBAfczH8!EUIL8E&OlB+(8oSsoVb^%;??uFtZ7Sp^OiT&^TFkHgbFSBvb
zl^9iNMsX$IcD!)u)ORTk`>jM=#K5Wm9>TpVIuHRv#FTJ@ct|$ufFe}!=O$qSm`EL$
z`nIR~k-f)9`T8dT%Y-tLnNU=yJFXoXzy)HFxK}voMP3ri6(lbs!$yR=uh_ox4d5$)
z_m@vkcTp=58yW6v!^5pawHSZ=$3K~1SYh+)C-2inqzxqOc6+kzPSb@LX0CGw$%rEG
zpwV?0!+J0OK%8A=Y?9<!JI}rG{PLpP?U0#S4IYz;(A(>qy}#cDfODAES_}_0;dku4
zrydy%fR}QN$ZSDRv9Ei0sr0a@_{we%O21^LED$M>JzOt^>K~2?h*D+}bf#Fw2lw)*
zUMi@X)3uDT81b!sNnW4{Nf<V)SfD6f@NN=7CdM2Y9wEER;p&}w1%r%;dCZ*0gxLUz
zeEs?wODkVKeY!*^*P<8q`-#1Gmz|zpzJ66i@TWihqkMjT($mvzNqRZYlQxFtoORi)
zJJ%UbBV*IeuHPw{jsfIQw<K|2z`SbY;E-~~NFh=b(E9m0AU;xpzcGc?4mf}ePZnUa
zBy^RsSlsk)Bg^wK<N_ZWep%KwVvd0>^>G+EGcg3*iUXk8x|B!k+QlHb%5YTc)r8>2
zca;gt%CX4+^6Y_DEio$Oqt|`f*%1UDaKIC(D3d570RQ^sJu}@(OHrQrXlxuK@i+hR
z7eM6b*}j9ZNY$xWGpPCb^UF#kzyJO##u&LH@^;LOD#?ombUMbcMt(g)ST6-n_;!(i
z4WqeZ?={SBaCfYI@@7w1%OlC-c1&}3|MK<gx*d~XYI~?+meZn;<|y9`O9HHv@10pW
zniU-|EK2$3kWsM^SFB+93Jej!)jaw?C=~QB{^H+u+3ZL+IQ;<&@miB1qCkccKSZwE
zOZZgS0Bm<?E5{fz8S~rJK-RE>A8SYM?FjcAV}REQ&+45rlV87n&8Md)JUu_h{rw*I
z`(4k^PgrZQ_VYEBeSLk!^UDjyJo5ABPx1Zt-`nfgSCq^+aLoChiO-^}v<y{gY)>dj
zqqWSp;?7iRHUg=B&~o{LP}(5CIaR@<l5FoQjRU376_Q0Yt{a?z5>rO|Z}AOLs2@~C
zu@y@!cnub5tYAUFtenec<qoU^pl_ox_((TUg8Qi7Jr^Dt<xm8!)L&jN|E2CDsYqBY
z@?&2V_{O<i@LY8cMtCGE15}L>4U&KdYGR6yW(S$-0?PWivOZHHpdqDSYlgz2l<wXg
zd+p8p`ywg5ce2i^WZk$hTu;wO^t3%Y=IwF*7Lc<(+vAv=bHd%Vx8weLcMah@?|D>T
zk@x#O=bRii)JiAya2v@)RQ#J=ZPJbv-s_C+ISlC$;k6wIR;-$-Q;^F2+Czyf+@XHw
zaFBoE3ZNVu5x~O29J9)55xE1)qfV@hhz+&vu}fTnG_fEOj7<3Ut*HTGwA;`nJ>sSM
zgUh`(Wnx6YXlSqmB=Pm@D@f`*PyOgepE>7Xe=Tzl?7fwl9ks;#;rs97kAC_``J>OD
ziA;Bo+d3Cs-`@1}bbEQa9R_gJhw15arbe3k1?**(YFBk`<ZiNWNf8R^ov9HVFa#Ws
zxO;Su2sJv!5ZG<!RSEq+9Kqhd?&Q_-B6he*Vkk6QmRK&#uo?vR2$iY2Kux6NzU-QC
z_n^QV&sBSPBqNdqzU`eo6bZLX$eYkC4HCgLStg>_f%WsMLX%J?9v6`r1t5u<bs9|B
zi^3+S_|@^(o-tb0kQtd#y8H%Dn1QAB%#oIcq&F+lGlIYT<##02x4UpV2F|s)*5=dG
zfr!ZaeSrkV7($`AGa_==WKJYFhFx*(aQ7g=RMM9#7(9+!-fjma+88q;VnjrkDUqH5
z?2M$DDcS<OeOIVlIKAV-L}sJ@LK0IM)xLn4SY)+<05QfyGRx@pJCcF_Ne_U3^{@VA
z{=0womynDF{qSUUPmg-aeIujNVrmO?*}lXvM%d^?57ws2-J=qC>xCX;SSHeawRvMR
zQEf(DZgnl08Sn3R%;Tsrc#$x0k$EL)PD8l(-S^*P&WYRYR+<_Q&H;Y<^eH_e3C=O>
zY3)5CF>J`fGs%JHXXRR3XP(TA&Uc1uU^fgj5uh{>5iH?}c%I-fAPwdfBOY+}uD>6$
zkIyF&UZWr7WhS`vANcr7Mg)fD<2FygidFm|?^tG0lxvq1L$bLehR~MVf?RmDB(?Y`
zH#bH<fHjQlj;u8E5D=D7!lS(SwX|5sSWH{)-T)9|1~Lefn2|w`a7C}dBZZF>FS>qc
zpAiCy)$9ReIR~>>_K+|#c~DotI+8|x{?TWC`Qc0P^MZVPKg+3MWJJ0d;Co}t(P=>S
zyuQ7@r<u`)p-UD~W$z7-T=z37hRz8mfB5bPjA{A#^XIm$7%Hs^&{4@)VPWUFA|hxu
zn*A@DRZM#E^DHomI9<C#z&&;WfJ<;)6>g1kGl^@H^#`2+{L6p&FY+({>fghLA)}Uh
zMbKA?PvffQ2~j!c#1&^<1`H}fUc3EBm#><}R&%@e<{U$vdR;z5N)aAo7|aGU6JNf3
z<rsrQCBN_RQ1%cFd+#8~_xHB|%4RGXh7DV5b1%<%44RoCF>F|_wPr-v9A<%xh+QRY
z2F*<O`xd~I<P|v`E23O<-&l^#BL)!T+~AM}qyXHy&}C2lOB*i?fux2yx%%1=WXXWU
z!Z7T@M2}i!R-cbS#6U<<Fi=StGR=&*{Ps5>4<jZqE#c<yxUYQ;B#S<?O&ACv+q@Gb
z6-cLt=k<BC2O$7CfDoB7dgYj3^QwF@D<N??wQ7kF#S_W$A|*2E6)kW{auAii6`iL1
zKxDTK8BU99Hc~X<M3C6`_l0>(r6)L5T#+bubg$%k9##7OD<3d3B%56sC3iT-MD7jz
z;+Nm~)9qG%pgHL4gmKgWq*mCBNM+{e^y6!-6l09(bo#EkzeJ*mb^2wZ%3>@VNP0wu
zgoyo^{h-vRhMHjvUiz6o=m7u#|Kh*?=lPd^_3t0+8u!3?o`{Tk@rR*$spA>|UTcra
zzlB$Y*GW@jsABJ1hZ-3jRh^yBl$W{WDx*3!ia_Sh2yRD=*+}h5na~)+Y>a$+d(#g;
ze8CvQ5}F=iiOl<XVwh%l+FI*#!9l~Ahd^Sj$aCG3s8WCQE#Y~|b`=_71=c8CQH#n9
zDMSRe07Y88)S=9+h^(n-v<FNubmVsJ^&=sL>f{J0TpFQ4m<_2`dh&>|eNU4FFW&($
z4gg2_A@Zn0fVWHxa947rZ+G{dS+2S<N;stE3_eDZrKm=Y4;I`bLvlF->6_$&&D9B9
zenprA0Y{h@==2JUAX(Y~P-%eg5`F}(Key6_vo!L%GvYG>`XG%`-V^*?8os>~7Gz-9
zl+(FZ&@O;*@0s`7#YoJ-`~6J!;QhRdV9JUY;A_L?%naa%FJGe9*dT>r%9dToq<DY7
zYt9KXs#BD+EX&a<%^G?~yA9o)5hZ5Lj2L4e`VH`m-jaDj%<FaV{h+}^vYgW(8UE&P
z{v&_(v;RE*U<bgp=BfRzXRWeo!r$2Fp7fU}szee+Kt=7W>oit*o*U_1FN`}-d~K3q
zO-KWm!b@W8?IMXzz|CPp7qE1#jr;wbW~17W2#6JKxqFiO^75P{^?pBXo%h?0_~gr#
z8F%*_BxNSLudG$IN5$7OlI*Hp0K&ThxJWsw$#hs5ZiZr)YY&il^cSfe7BfMMi@A9X
zjRIGi&_&;oWD&uV%9pawJuDD|z;ySKNzOT@WH$g$5qOfp2;3s#7TXC4;jsb5oHH(v
zNQb3(s|ZIO*to2ZX_n<EG;r@o5F6AIa|a@=et<F+g)2Kj^unxP^W932U?#%7ezskl
zz#W-zQo%}zPSc3S=G6cq0%G+>Wv6R9Dup>z^xq=P=n+p@3lkP*Jz)b}YiDL+ts3eS
zSHXLDM{7Jhj;C8@CeCwZ#Ex~kjcL5yo*;?$`-;6+K0VzyM$w}$O-n@JJQw!f*xMBz
zmo2IxI&A7dXE1J7D<h>UF)1?~HtP0QS1y%yT(jP8bAKbd<M(m^TuZD>z$j$DfD}`z
z)n6NEa2*0@dszb{y<U8(OV>)+%<!ws>EV65XM>V*@8Fy>nwo+8`<ZzZe-K_~lwJ$+
z?e&eXudi_&H<(#G-JUe&$Zp<_+6%iWVxO5H=M!5LQYB)8L|72v3gtvLw#+5tt|eF0
zetq})6Cy`;KRyB&h&_-k%LS;RYzr?REMZjj9qK70kg5{j5l{#)V0f$<zzq=xq-m5P
zW4P~mzu%vqpPz3MZ!8bM0rG%EU)!O}bATl%dSBm50A!6a;aBu`^8;XJ+&jw!NNo~l
zrdDRg-j0YE4P~wIUL=QEGn5h@Ni%wZ`A4*~a1*g3uqy@*yTuw=S?=k@f?$RRa?qHe
zy&M~vL*yJcBfzyobCl0`4%UG4@&z_@?S4N|B6C6Gq8FRSsB0XV`119Q<OY>m>r7I)
z*Ah!%neT7!4uUT)&(>?YEI6%tkX?w&_7h~UuQ`S(fxT7%6?P#(m8n)WWMj?i+?>Zz
z!$PrVUU~$qd>hx%o0<H*9{?s|twJ5sjLL+E<EpwSR?Jg*8Bq4#Vzie>+BhoqsRoMf
zX=Y@SV;J1CUy6r|ieuD|(+?bOw;OIxg`&QOZ|qsNneg;{%lo<T_WtG>uw%|7XIvPw
zh<GB)H13``=tv3YdG0p8L}o^8LdsB(0W5n^Uj(VL#WiHHtGd|{A!!0QYV8+!0X#`F
zn-HliyYSwD^eVq=*4E`jK)`@8kOQGaq+Br+xB+nhx)pCA2B|UUxS7RG;*+EU$O-Vs
zh@-wQhidn}#~33bwyY0xC58|Y>5mKBGb9-V`c7xPj2pnNRxNR!8$d<3*PM2;V)*JL
z^b!>H=aw!pn9H;9<(t4Z>5PPDBB+++1{~xf>!YHHJ2OV6LEue;9u6W9kVtN-5orPL
zjN&FU=vl$C9u8Xh*w_^-7!XFTv!lCW^LE_u_V!jvE2XIVhL8smnZDxzIjIY*px5pZ
z4b)XXi(!`Vbb=M2N-}9>fG()2LmH1uz@6DXw<s0i$l_uU?w(^DxDJJH4}srC^7>D5
z0Q`sl@Yi(rj*uq9y~?l5hrH5coO5D~!3qui*tw2jv<k6ejl#%b23!G?)n?^+y0-@a
zvN|-{XHlUerpNi-)Sj`{J$qV8Gt1j;!bEyxqT!8uZ+G|c`u2{}sxyb_B@!8>&daiz
z$!nD%UMhD55(byP$xaYN$~8i<h0%%~04~7dL7$b4AuAcKnr4)3FU}>YG_DTvl2w!v
zij_wy0hoc95jX-q4>Mz}00)Zrd*HhHF-Cn0lw^Lpl{zuj=HAOB<|PlDrbrZhCXiXK
z#Zq%)mjN@Sg@`-AO2y7gPR)#<YRC)9TJV$++Td=)b1ei%Akr~nlUOO9r1qpr@0f9c
zj~@!rj?c=0tW|Psq?A(wfyi`b#7g9-JAKfG3m%oV3nb39Xl9-uhb3Z{m24hQ*xTtl
zxak=l>9KWtdb0C88w1xmm+AX{UwVFi1~LoTg%8QTJGj=$Z!l3-RH0%;6;!2edb5Ok
zmGBaB?-i{Cg~>vu3JtN#50iNu6Jr?u_>X`3`zHcjr_9^i9l!kL-##2n5pfY!@mTqZ
zyoP?=7cs)KCYgEJdE4U}wWDu5v>G|qeH^<7=GFVuMATH?_?jhT1m--9gvJ<to=fgU
zZ@t}am~$!<I*vIy(J1!zz0Y;N?YD6pN673;to`J^Nis|o?VQ>SL=!JEC5sNWxX3zJ
zT~BvGid9swiri{QO2mi1-z1K`otd!k>&9i0iiVN0xCAnd53i)Gd?dRTNE3kxhqdx(
z4rxTBNi?%L46vQh-m4M|*IAKmDviM2K5DSUq>TaJktpOx3!b9QoPpdy*$G6boGJ}<
zGIXkOLAE5-6q{~TY;BBs18PVHPf^ayh~&<!HejpktMKXqD)qcqjcMJdYs`MW2+$DR
zNRL%IeF`w}CqMbo_~kEufbUgk&1jKRWm0EsBtRQw-F!%E_V!1*8QXm=5yB0b3y9=#
z+-O$YsFqJN!m-w-dvF&|(lTq%8xb48YE40L2P2YWB6BAhaL-mNe)RNSSfrkzmG0#@
z4*au!_Fv?0dq00;1@QBq|C|8ur+@mV`Hy+=uf6FNP#^^}_@JC*mcz-+@Ms+y1ZQT=
z2q;5D=cYZrX47qZdSBD?wN|D1$S{wYX2y$>(=Iq~nKb%kTzhW<$ko~F9jl}<l+~jJ
zQL@Y!W4M{EbG@JUdvZ*B_J~ze_HyM*<PI`D85RBD<1p99+V5LwZ;8%73>X>>2x$S3
zH@`RP5b{|yK^+S=MiSwjuh9w0gF}{O!7We_ARB@O!p4wUT|*j_Nz+OcRKb&80$dC$
zrLx(84A<A!oGmXV5PKnz5j)_yE6Ob{wOy=o9eZUJq$trMMvf5$>NOTFqO$<ZigsgG
zX1sWecB&zd1WaI-N+{vy<N4e><^D>uL7HfN2Re~^Ip$%3q{oV+7^a!-D?k7AbA0{s
z8sC5a1+hD=WlSO*ER=i!T*ZVejI*C<R|T<3z^n|)D`(gd<1l=FddXfLA|m*He<vy;
zEHjh$`<)S~z7&K=W=X^XM3`A#6>pFXk5mOT<`{Hf_?4K14BBx}R3)U0fudI#zW@FQ
z{`ki~%D)fD7auM!;O9U8`R{ZH<ZtmEUU(u&a5_xF+2z1>>t7u9i@9!<-JKs5f)(MX
zPxZD%cHqYaM6A6tFDy=9TUS-HOXkVUxX?;^f4{FPD1<p@F&T#G!)aGX>X@c;E!q%2
zefp8F<xg+#uiK;?$6?`NYpvcT7jYO+j5#o@rW&9)XGx#C6h=D&hk%L?rc8n&0vgTY
z3kV2|Aw>+Ug-OeE%0pb&PT{^42ybS1&N(ivzuF>TrRh&5VSyzitW3lqgTieBzEVVv
zVO0UN)*uj%uuTupeFsXan8h-J6Iy^O{Ie=sUAnJYHOfjTR9Ogl1>;yn2V`0(!gobG
zsK`T55n|w~WMaazFg<0@mo#l}rwWTBn#!P!3OnFX?-eSYOtSp$yVw4tDogE3)akr}
z9AipS9%gyEE141LsyN5aazM~`pm+vFE?jHxVZ&Zu-=+i~W8~Z0%C=tTUJLU$wD;Ll
zdivc9#x7Y_icV<P`?I6v$d`&-Y8mO3{zIXNS;(U-@i^whm=kjvey0lHAA9Tn>OZea
z{c=#&j;vMz-<JQi9!%Wtb$V4?Q`ulMgJaAKC6-0nm1+ohA(4y4Z#GaVE_fvB^o~DE
zP#TwY7;7yZ$Gi@rJ?Am^Ug`(jNLVKF_4S?i`<?5&n{4pu>6Tx<{=(ni&Lo3#M|Z1E
zv0gTIFD5bJRm+<YHMLE;$2Cf?d9u`-Kjftkia-|svu=cGh_%*`VAmuHfy?i29T7x9
zoO4EtBUBLu2{Y123*<nGEiEomXC&PBPK_))V<rmMU1!X8jOsPpbV5cA&6T0-Jjy13
z?hGicR-9!ys2<-x7y-49q!DD5WqX%vujt1~BqBWo<EZw`l8Nn-wU`H}R8uVvi5S%)
z`JjxsJ@z^&lg@Kr5E|7snLWl_LO`&=ImNw~GGJL2sw;+_3sCONGf!O(6d*Z4I;2cz
zq({Z72@yE%=RL=;T+0RQhu#DLpPp`vh<tv&89?6ecbBxwd`9kYw$7u58>s9s5;5l}
zzjy;lNoF%yDe<xs17ydBkH2&B|0@T;x0s`U%*%iMf$#5klEg0SEB0QOapgiOVOKsn
zuGH9uiKvr)<I<&fO~?<pAkxf01RrqaIu(0TA293PzLi`yN;8hz?Lemy*NcK&l08=$
z6}fjH-1+wQP7?O~@>y#yp6A-gx{3qBd7h{TlG0$1vX5S`SKe_Uy(`LyO)wUe-KJze
zB@S?_%sK4_eDptASn~qd0yGI}WnStz%4is5C&{X!(QPn_%WqZYT4RL6L$V#Q>W1Ho
zv@1`%J@4^B@~8k3mX<<>kWvAUcnFVKm4eTT2$8{x{-yz4WMu@%IorHc3*xmL(W`dU
zI&35`;9>RB#Q?{EuSt!|>DHS0W!uBdGy%zdx3N$e2_a$c?+a#34Tj&hY0yX;{mTpq
zImR3jp!=$<$w=<lSh>59LdYG%CSYVB&3#=R97u$Fs&D5lF|87vVvM1NvW~a6cPoV`
zGa}sGeQ)<_8EQ7rmTQ}HdKCihV~kxf<m}X~no~1?<Ct#s5In*n)B>Tu?>qZA03P|>
zf6q{mU;l#FKkJ(oJ<P!Ue(9~%OuNMWe&(E$9+5JG@2E~DSIjwBim1r^#`7HR7d}vC
zf@)BLwW=-Z7Xp_m&CDn=#vCvVWk$ZgpTRCcz33BzQsKkh-6L$y5x3)b^4J=~;)fr;
zJI*t5?+gqBA_mK>!%SgsV9W?&uoiw`A*V|?R(ceqY=j=$J2bXSGUM(eu*E>_U&kX)
zg@7v%7-)MBGHN@jY+XGd_z;#v??2;2+5yuDgdv=nX|w?pIC5nsX~_E3Ua{_}h(uL0
zb?5YSIwO(-0%B$UT@!#Ji8OvuR$>TPn-g{fqJ0Qn_dFuq!`IFofs2}?n({Vryf^dB
zQwVq0RR>21iYajxJg-)!b(sWwMNk}2&~V_VKlw?zJHCE>>$U_LU}D#~WPrw;3@GZ-
z0&PsWuViEZjO{B4V{emcT?@-$mS^l%m5Km-+{WJ9Ifmi={nYdGq4u!M`~7~l%zIyN
zPVp_ezZk<Ke4Ck@4Zq;pZ2J23f?xAv<XQj#AOJ~3K~#46mI*()*N6`x@ZYxz7y$Cm
z{_M|wrvc#gg|CC)`fDkh_G8tjdcn{oDR$9wAJh5pWaH#no`7m2+_#WO*+};SdRUp%
z+E`^5Ikl5z$`?(BH*39kW3@IS$!Lcb_uj<XGxOR;$ky6NsQ{58=G%EjRTPERt&Bjy
zv9*zdF3YScBpiSu1Bcqr-!|M$)4-TY$<hko@)!(Ob8n3D_@FZXKuJgaeoJD|fm`SU
z!p5MH3TYJJ^NI&CxMUvT3$ifao`@m1ios1w-@}33)ovj@ixbEW;$X+ieT4X-;amZR
zBGu_Lf*huzd`l`CQc4K6NFf4|j~Il0`S;%2ef#zurIHk7GL;1<GkrG<ArYPYjSDOi
z7rtzgvIrMBuiSMIf{l((>AA}<e(_zJ345=UEXyBt(vuXS6L6(;92RRuni=4WR&hpz
zjDYv~vN|Ho5Rps|zPvnPt=-=va;*g>`1W?sIV&`@O<-QX-P~i0*+}_NMFO;AK3qh)
zdnp%#c^vbyAu}R4DutMr9J{jtc>OuRM=Ag77xiyC6vp4@<^TJfChmdv_dD+Q`_=p8
zam)%*DBCUThp2e)l40&HKKRfGbUb?P^xORr5m_Q1WqTmadOt5RkK570if#&u=-kF5
zgv1nO9)7U|CaG9!WoAixEB)8uUdER5JTFsDygWVW_5B^BYzSPj$>MOaRy38GSw4Gu
zJ%SzKgNmGrhGKrZ*>K-`Z&$xum1(a6{Pj3IrATSENd+j9OhW<55>VJ>kM<O>5r`BP
zsI%g+qu`&uy~b}JI^1H;@p1_^`KMq0?AhyuBag}|ftV0nh1RZ+lQOF?c8v-k<hYb;
zm450G*b%urOZ487>OsOv{m6)z>AoU7y#q!{`FCZdFh)2m;3EPYI^*$dHaej;u|vn0
z7ZkN(+l#1<Kv0l8v0FL3A|j6CNC3Hak99kXru$R{V8<MMdw&mroO7C_G^=*3B<Q6D
z5@q3$w@=S=&WSHyzS?ojT)TokC1TDI5wSD!;)2(&k@9l;2^mNk>5j(Eu>lC1nb$D8
z?9rtCN+tj67xh0#2k`AJ|Lr00>t8e?u-C>q7axv4HV{=6xx6<rV%KQS;|lfwV2?lJ
zYWKJA2i<3w;RDooDWs5<<}+ISqYjmTqK7m6#n~Bwd4D~5945&~;<(?>@#)hGZ^sN#
z*uJ8vMWdxb??T>^Oi05@W3M@+9WYk%Hm{aY!=ie?0SFw|h_Nr#rr@!b=yv%eib|7p
zxOu`+s@^0Oa~^!a^$Q`Ey%Gpzr|=XKeFL^iND%>OoAET8MX6n`AZHdyrr3IkK!C8v
zFv%j^y4Oa2+$N#XE<`<kqKpnW31GW#z)RdjDu%c^Jk*QU=6fw)5wV!?IY)1PI)_+n
zE<h%1M3csY6)Blk*#?ZPH6RowNPCByS!hgLqt5!F0_R@JESC5jHm)^n>_otQ&Y{Dm
z+hGLEkshGA?~LtdLp&Z~o0P!&dCzuyA|i0VpQS@HVu*e}m)&lMZQmF+s{2vokAM6b
zYi;bkM`rHmtx6_N_N{-7ye?@AskCA3QtXJKDsi*gVJj}1Nyl+SUvB((MgQ)Ld;G(u
z{l8XPMA<h!CjIq{oon+lQk16rqJqWc&A*0$*9;+QSKkca46&?{D7__tWNxnjgiHEc
zri}abpR+dv>=d8NIK!u>8|sA5wfEML<=*=_3uAa+Ydgtf&gq$X8zb*`C)QdQrH5>f
zeIuDDF$hJm{1Ib}s0n{5jw>|>1coA9B`!_Gxy#c8gh_=%hNATVD*&6)=rW&C=|8OT
z)y4jXli1|&Og|BD7{bgbU_-^<Gv1PTZPx#_`c-s5Slz^$MPv~a;YP6xsTJl?=rPM?
z<z}ZG!$JV|L-j~fIYwD<YY+)X=8DJ@><IQ=UG+iUmu*<RRLlt9i8u+Ip0P!Fi8-L$
z{lf>~nSvOS(R#iD%ENaCQc=NE=>A-)f#c;baUjhT+s{Q{5vgtT?A`+pj2h*ctJZ!{
zNOhD*M*_eo+casGKl#a1zP{Zt=fV5^9e87We))v8SG>Q!X|1hj|8_?1%ruZ*T!rgS
zq^_-iD9996%1}^5$t|q+m!{jpRr|3P|7~--UzY`se~K00RmZo`r&WARxg*snxu%DZ
z=W;83JA5R|{Bj9>TFZsn%|3KBUcimOb%0z*Fl1J)x|C1PH+7rMULstjMkm4$dnb;k
zxd8f#9f^EuI_=w>_Eexq&N;8rjtRdq(Lo_cfFW7hIDE7}JvN{r8Y#$ldAB=AQ?UcZ
zyN@iX+<376%p#%~`y0~k+p6qd(6!ij&}ji}nr$N%?C?_f^c+IhFc4Q1053pBR}=}j
zix%ws0MtOn1mv)THR34M^YwFNMz;SB38bNhDJ^!|0&?&0F)UaP!WH4}5qD%PGx;|O
zJ<U%*C7^@7Il&@uX60SGdqnvnst&BxaxHU)E_-pgAwYQS43BMdj4|evL9Br>bR1Ja
z<lf<HLAnKzDhxEBow2`xt<-Jes|uoW2b6uYoY*v*7}G9sTD-j{+|P6;=A7Hae0_Tx
zd#wo1(dyM*T}=W>mpGz#<{ca%nk7J^YT;#OsYZpXtjCyhV$J~@Bh0LWTd$4IuZn+u
z)A0UxJ^+4eFVQdY7z1<8dO<~q!u@{7l?8aa9qoILhYhO*JXu4OONk|#jVt`K1}^D&
zSt@&qSahGg;Ssc=vWNut+Co<&O(H>CJVoNjOxxQr=eS99GtCGmX&$kkGV2PwpPQ0W
zhCKJ%c-(T(XsB@%p$7~wg~;Wb0ce1n-It=CVslRh5}x680|H|d*e`arVz9TP5za<W
z!O;ha3?fDi8=d4*rRCPk-+1ss%X$J9nZ6sMH(*$Rg#%K0lGCjlbgT7+6&G04EON0{
zcg$Abr@JDt;zDK_1zDy$Rc8l6foOfx?oGf#VijI2qPnTB0|X0TlxPThh_Rvi{|Flq
zy9SkMT^^TGk>imXRYojiRE|>Ax(y{^21Wpw)B0H|b5=Vq6XCngO)D;CTY%w8H(Z=;
z@1Zp)gp818wB4Qedoq0`$<#m&4W8Ta{=NpeFy|b5yCR%VPdDA~C(biMhKL;*NpC%X
zhKxz<VZs;|*UQUNv*C8k1S>L6W-_z9F4b?_|LYL=|J&rTlT?1E$^UOU2&x<}nM7V1
zkxaTO8hN{CXYXC5f41Wek}&5~|CQ=b?~?UamOyU}B1$@wAAd%cuqz{W${1#czz6+D
z5h-MNF~)L)XPR*|mYLT9b>4m3Bo4dfTERLH0)R1mjf?Y7#7tnwC_<Z5Prb{!JLK{e
zmMO)~oVO0&%+%h_-fHl68;`OXo^)S`y|ANJRg%ROiBJc_My7Dn^!fm6>Q7+XkTW0g
zTLK+ZhDgTSSwW2krfd!fAwbt*gNJl5-My4<*1{wS8I}WHHG+!Q8kFrp2D&P+3|y^)
zWJxGJmcu<Fatm0F=mVfC6p4f7h`cpC_2QRjEsf=XT9FVPnU)+PL!%DOdVqXyK=KQd
zYEi@9G3PN*hYQPG<>4Ma=S;w3)JF$t_AnIwfR7l%0C%X<>q=oD8(DF3N<WicE=`W(
z0KDqDw*PWY27tqTBO-OXJ@fwlenw_UboW|^g?kp>k=lFtaU5AK3ZsXm1|a7cN%1lC
ztc%pH#4KLnCD-Tr>ob7g^!MX;zU_Z)@OPavmB*+&bl{RL_NM9L?W4mqAAyFq+pRqU
z;>Be*Q~5q?L5&7@UZS9mM8Q?<s1WaXI1GD7s)#U>!##rJWX%(dhNt)YnHiCGJ6gTS
zFe~=^oFmTjHO+?BS^{0Gl4)jU9Hb5drdOD)1I1z0BU0~51PanN3;B-Rk@VcHH@`Ih
zhP6({PDNay9_1P6<ZxcJzluVQ-BCLUq`P~V&FZp^L`G4hKn4vSPD9qriwMecn#m&t
z-20WAnc;w-Vv-r$Gps{N;FJutZcC@Z)2ZydKLWApX>^!ufMww7wS08);bLgj;Uh?v
zCK#BVNvIOy0B6lK%8V0{*Hy-7#^FT-9$;XYM_?D0RG^1R)I5eEHTU*O!pNbuc92@P
zn?+Q*D+7@#1ITXeMH=XukL-n*#ya$x^!~_Z$V?b9cp0||J7(VR3&-ui_O#f$c34Gt
ziu9e4xg%mn<fy@Q?1)kodFdT^QLQth%t_(B!C<Pgu`a3mRq(U&8RP$B1^x%Q0e_Rw
z=eMo?)><6Rj4BF`vy-zQ1Hmi3^r2;LUqFQ!vj2WwiM82ze;Be%Kx?gR@+`|rujn1C
zfEx6f3>3{Ikr-w+y6UhB0RfE)3P~LK_I{R{Ph>+ED6_bfZ*}kx`&=f#Trk!{*s)<s
zXcW!A@_Dip_!3GC%goSPD;nyX2=HRJ6+iHV`(_|5c61;|*oE}o5#?5`Us3|{UT0-{
z0D?ri%}N9XkhwD4gk#lK9TBXZeZQtTObF<99pHk@2``Uzp_N%1MN%eM>B}qZ*aD1#
zvVO>YQ^;Uz3hmM+)G^1bg@ODEc#;5dC|QoU%s5&9?{|RfDgsN~0xOy_wBy1e0~*B~
ztci+}>1tJ!!edC9W)*7Et-=QO&J>ShrrF%*dG6T0-uK&ny4~XG=_#$;+5azV@3tLB
zlH}|HX6`|0X8!ko(cM*IxEru9%p;klR&`g`OdpoCBuXNg=^l0fKI};9$Ngggq3gQb
z{xADuekda>LRjly>15r4MoX}5GSiU4Fdfm8lvPzNtwJDT_v#-xGJPV$5;kk?*>f`K
ztoSfSuf1Dl+d$B#l|Da0YBc^c5d16Wdi<Ry|0CGxX=Y)q*7P@88wZA1PpN;T)aVq7
zmoTXN`!O;ylkF00Wz>`LcVd*z=ep61frvS0U%YMfX#oVmKKwmHXvw8`*jy7pMkmA<
z2Jrp+^-9fYgw(+2=Pi{C(2a(w?!VfmG*;d0GZ#KUE+Ui%*w8(5jDyPRf4e^i9YaTl
zL{*8}8#))7gdy(>!0a#)MN@>rRr_HD=o+Z1fR5n*1P1$jUyk|7U1={M5rX3omEoh&
zS3%57%nYs`(Q)Ri0#;!Gr4$*Nbi_C@-9d7-)!BZ&o(EkfC`yNBd~|Dm{@rdedQKC^
z4Vp=#Tm@`9OVTG<H;{LKFZIevj1zBoy(as4)QLKjFQD&djE1Pj1z<>+58gZ?+LAb;
z=A5;6-6L~h<i4)CzJFX&Q8~NI?Ds@G@@WHd^j)O2?uw@L8gN|Kh5fmCuN_YYYWvc_
zF#>y)vO%`0ez8PV_w_DR=_?=HFtTSJ(v7wtQnnni8=gP%nQuLS+n1C-!gxRb|4zC;
z{_61W=PKaPcv_!KJ<^c_)F|#<IF321ifgT>-|q>&<?e~=5uM?>E}tzz9E<Q*i*X*;
zO$p*j1oollq6dea(agq%w{m0*y7A$9t(>}YXkRK@BM@U0_O5Uzws5VT*LB5xujbV<
zL`C4x?D|SmsHNE>(Cpo>A<Rnz!-(o>_lUNGs*aIfEGhegBW-2%8`e>~+=)IiWJ~*V
zgY&4s#!2E_s}n@>xWpou0ecJH0cA|jD;?wN&sh+V!R$mbCUMO`GL*ntYgkzcB#a95
zj+(7t?p%gqiI|QMrNWa_6Ntw4AH);X3eEFG8iT1OmWvV!z-M0ssLEJ2?z6IRW`Azn
zKH|S)O42;<yLKu@=PCpdtd>0wfg>~W8vSiOi~~!>kNJVjxie-3Q5ik-)X|OJpH&%D
z$(^uPRAzP#Yo-zq*ePV0i8)Z~-Vik+64~s^s4n~4oHkNba+Pal3aIYox*k#{Ptx6i
zot$r<?eJdm5%|>Z&Dq7vBhydY{DjUtIR^hq+W+%5;P1KtQB|mFqs{qb@c=C!zy1Tn
z*lRt;pJpWW#Rneh^IMLbGt*56ZY%xXH>x(OzA#IV((s7|A7jKR_mP=it0}IMe5Suo
zu3(&LsgHn{WW?v^;uxv#->;|=?|VgAF&bRbeaOL-RW0-`xFg&o1cK2!_dsbQV?^|>
z{3z%UI4(Qs&@|2^N{0275BRDio@5O4+G!W0@aEdeRK$*6A4>2caGzMP=teNk9<&`}
zhQyr7f;-4g{V{Q(J<ngzqfVU}IWi#35~wO7Spn%f6ZI0aDzf%^WWz^*-8#aaP*0;Z
z_sna?vxp3!gp-Jn+9)nEs=JV$>x7|b*hQSMWX37Hp7-;(J}BYDqb!TG%SJ+b-(m)V
zaAs(X?*d%*!gYPux_4_)`s-C@)RQMENvq0v?(xWJX<^Q921@yQZ51&tVBd}~RA!6>
zcJ(b*9Ry@#-|8hnX@*D#O4Tr=N1sjjC}P=DXuGR~o_l?Jc$YnFdX@i=r{|F$NBr~9
z{&|SMKg`EpE&rb?;IZ7cRMv;#7l-)Mfv0;nY@?Ihk8iQ+6&l^Bu*Pqld*MMNe+e4S
zH{x}Z5o#6N*F|%}5nfSXe2}UgP#R@nv=tT+fpst0V0RG2-kTYSsxpbZ@8!?W4s{$6
zsj5871WN7EuL{Q#9^XT-?9x87^(g|pS!bpFMg_`o*4?{n__Ji*Afj;;<)iwmGo7Z-
zpjyz`#`EY64md!NLId|M#>otcNM#N-iBXcsIrAh1F?(hy5~0ZHUhged`P@zEnOOk5
z8cxX*=SfC7&gv5stM1I4w8Uy(hmXq8r!42pIN<w!jEgBmy)L>|EuNZy!5!Vt=9qP6
z1VY^@AQ1qzpXT6j79!;8&k!n)SlyBaA~Fu=pdz>rK-la4<h(AP(B>n*rhokS&3jw5
zw_5}}ttfnCy6-}HJtnWG$LW=mpC|%Jon1(WGX=t#FcsQ+DPXD+rfi6A2?EWAi7*jb
zLM9c_R?fEi#w!}z&$o+gmaZR=a6B6{|0@>Y^Lu|w2k`uOaNj4TCX6HH%}gw<^AGD}
zs7Gg;Ka)2A<aG$N=YMZLhEw5n>^Co*feT7<MpD{-_<wv<6>bxdthj$HjB6Y;`HRp9
zRnce#WzQm@%m~}L*7AK<y9pyAlbn;WK36gygx82M@J{#P=!Va`ReT2*^!QU=?Q9>K
zGtwu*t_>MqF<hC3g>fFoXZPJ4(4KA_c9q!jo;dGby@*3wBzIxX?txT=ZM1_ggU|K)
z<PacJc44hLIv^mKM&U6Dw{WMgjf@`OquRs%#Fiaz0-hjiM|OETGmmrj<Oh-_8avW0
zgz)k{9D>uRK;;t-E%)5$Dqy!KHo#EB_F)|hvV1^Zy5{(N+R7&SCL^#TVoBPWu}`Z}
z5!87Q>0sPF0>GG1EtloQrM1c#@rLID*S%V4$Uw2T%@M&`^$^vIM~c=OPO61v3n99m
z=kbwOcM;eXG;Qo^zF|gG3%t#$&HFa%M3F}v9RR~`T7Z8k1O8vP0MB&)x~}8xPxn*Z
zR&AbqtXJqk6Mj0ns2O-clTq!8bi)tmM^W_Lat}d>=kLQ8$Jr6-<NWJ?7v|dKdo8Y|
zW5LXmVhz_8=QYm3j@WyT=rth@xH85_T$elh&S1`t6<e##Be3H7NXlYBozKxglIG+G
zDxRUUPDw9tw9V&iND`q?>9&sSjfMhIvUbQsas-3XBBB9TXMg%(p`Sd(M)LN)zCr!$
z&C>!97^96%BZ@z?EAEBNsK#>}nHQ?=Zgs1G5@N;)?=TB3TRLA?5J?CuR0u^&v=trM
zI2mVcNd%JYp<^5rKkRTAi~}KAFRe!vD&dWW2(q8^LRANeRJqIUz}=Tk20{rT5{Y$a
zYU<DsWQ>~EXuqFLxEy)y0DcHqHt#uOx8%EaI~1Ez)3WR`R2n%Q!vcDMr2a&3U6Uwy
z<^&SBfBb+7u1BTRF9qC^b(=VRhJM+|&OK!liEI;f06@(fDR<Rbd@{pouTILU0I)bl
zdhDV88V1J5qpP9+ioO4DOM#!zk2$YrD(}b_S_w}aI7m0G?S!u!chhxUXB|jLE!YbN
zWI0d3rzFlXPEbNHD2_3?)^d<IE0gyA0WTOx!xd^|HVap>Mh7O~YQp0<*KCe4(y4O+
zv<h*~3!U*BkP6J8t(ddD@)e-ANDe!;5r|-Ppj+*pQe`KkM@Cq#Oh=X3dwio)gX#%K
zL-upDBoqm;mDGw<k}ddVB-8!yhtVmdEs!ZdKIWl@k^<gBaDP%d!J&}|nGtd+lr^g3
z)IOiQQC5|+TkI$oykSvww02Fei*mW1+(E8#qRm6uQgEQEyR^vmGj|11l}u$oNF43U
z%i_llj1NWTeuDYZ$Ws}y>WRUI5v5Q;XTlD$J{%{37j#K$FGL1DK89M=hlR|01b&3_
z2Z@zA){h_e0&oMdj~yFz4$&ABfRwz{5Sd>8#uz>H&WO)-Bh<-n^V<ia+6YGp$aI&1
zT~^T@VxTiTXEM%Z;3sPBtTZW?_bz0{3yUupSlbT-v`Ti%SUPaP!WhF<d~!DYS44e(
z^8)A}Umkw6#dqm$JcI?xUlV@`BL~M!JfR%NF=&+twoVl%;Gt~*Cnr)(>S-Oo3;l(v
z<!Jnm-C*Sd93|#VW)98~k>i8s(@cPuofCE#NSo6}Nb-Fzkry+EdBoT<VsB@3{-BWo
zwU}Q3I6J8GQQMOo43HJgo6c;mUZ8tI?Uvg;j-`C;%RsAe93m-3`#f51JPd0vh7qkk
z?Y&sOCXDrzd!h_ETck6}Vk-qUCc@G{sHBkErVT_4j{zQ*9M5VKB2@iNXG;#8DrDDB
ze_XGUF;9kr?VFNnRa68^&H694TwaNjeI>=ocJQO93LY?E%<hTdo>j1{16bQ?q+E23
z>xk?y;}!xN5iuj(-QFrYJx4AQpPx%VAguY31*v9c{kVUKeIn1WxF;()XHTJP0Sab@
zzx~%Y?E8)}E=a&^ho=z;X}y%Kh*b1W*zyh>??;OpLS-K?OM<KuI`jt%-*NS|o<?+Q
zu+Pw>huhG-d<fa1J=|Fs7bO1MHvWHE0q{K8`K1Z?LJ_=sZw{TOgFwhHZvSB>Q&vDm
zj=^BS;b(%+!};&<#Dl@wrJe+nY<65A5-~=SbbkBze>ty+L*U6bI`0JVL1KbDq8<(j
z7?H+>-R1Eh%P1}Y=Eoeak+|<0(c6SL045_^Iw}Rnj7N@%(S>_Yh@>b2QLvij<{oqR
zNCHg2tiy;cS=lrLMjX`}BGQn9Aw*9!j%%jX@6hfZpM842UMGsi=%**i%_@YHL>N~j
zggPtBq_iU1)KuqT=wos`zz~cx^vovQVgQk2#3YZl{+R)ETi#S4pu!L-%d+(fu_Ou4
znI`7Z6{Sya4);(pkC<n)rMkuc4-DPqp5b>y@R^*eot1!USJkdPuWM&SaYRK#o0e3~
zD0IP9gdH)4V@}T`R)>-I%EIE0-+lukgKK-0o3V_Srln=COn2y2zk<{RQvDRE=%L@1
zoeeLIKxZ7eBa=E0y`>fG@78G>NXyxF%+%h?>7?bTYF6gAZ{K{{%)j*Xx6QwE0q`7b
z{A>yCsN?%oaVLmA!qLWfw*TGd;Z9duz+PJBXmaFBEqK;<m~-NwydW)j4h%UCu$^O!
z3=%nJe0&5>@I`(RxVvCEZ{qp(dogFw-#;qi47NItE{Rkg^1rGBV2zE8$Zr0zk4mXH
zx!HMD=oIi652#o>_-IZ?>w2wDg*mnfR3_aEP0i%!eb>vt$AFY)e=Z(YfO;ZnWJDNA
zaHE;vJI>_sm@1zY9okLaA-eRi*;(g6gw`V9SmzQ?zUj%q0eS)$f)m21y0aUd(U?LY
z``&=1cyvJL@1lU*c6CK^s6pc)qnZJ3Ge^vhxH3S+mHhnNdBjp7DI114kU*93Q2tn2
z0Ecr>ox}@8<X&2U%4==XA|lzK8lIC@T=!y*CX)1kw0QT7pMkE9l7r>Ny^BI%W?y-=
z?uTdL<FwSvc?n|#xT_1$7~)yy9ZGU{aLqcP83glKIpvqTuQ`Z%gkD^G5$po;83H~*
zyK@d7M#aC}0{m}U0KZ=Z&rf@BCw3o=7wq$pdR{<}Ckt@z_2~9-P)8@a>x9p@R}wa&
z_vNQh%j|##z%BjHyspVHIzs#{i1XV^mWr29f1aPu_pjmlnElxnytfqz+nH6Wsv53x
z!daXnawV7n0~Phzc1}3X;<LZx275{%%SU`s?1-r7%1;c?dyKFEO|bDlJ>qm@s_7*~
zjy3`(2c$DJ%-~^@!my5|vN|SGOU}sb#Hk)dsUI^ff8v3OhRP9950mh*HdHTJgM<Q%
zOmG;EDvYW%C0w2U4MGa#Yrnt7V8argl`c}PLd@P?xHCJ-J>(0dfl}b%-NJEbP+f-m
z?79#E=4^t|iO*$cF*57)&^nncTdEcSA>(94WMr)SzGKd-Q$W>%p3!W@w&yuaEX->H
zm`!r05oXLeIWuF`vQ_~~&W|uaYxR*nNe<T8ou<%sKfu`&-*&V_*a6Eh0~jQB14&yd
zr|#=I+D<2X%H4oHkS5`2Jzn!Ob&nPA=k<M!|9_GU^q3KzO5lih+;E=27Z%xvY>S7|
zbD*K)b*nupKYWz~I+OY5cX{@LF-L=pVKc`_GC3!Y{1*9?`foq?+ePs4DAeCB1--}*
zF^XJh%8n3$bot?2x~k?Fb5uc9ixgXpAQtmg_eL4PB;<mCv^SpyFi+XrZq^sku~cBR
zyjvs+@+LE`5u_0A3AZBHAP@2BZNjSTa+2sj`UFLG(B&W^Vl=qrNUPh1ja1J-I=j5R
z`IgMq+&Ci}YS08rrgV=cCdEOPZ%CuJA}vBfb`^K}mm>`xy%3Webt|gpmCi`_YBAWk
z024s$znrbSx$m1Y!f=k6(H@ZO*O(cRYB;pK6;eI5GQut^X1>Vs5x~dC%==TgKUWak
z$}QVsLNl&j!2|U;0_T{Tx%^B303ZNKL_t)q)U}az2|;8qz%4Uk#P~?BDhEf;y@os)
z)-q#4Nm9FmE3?VJsK`V5FmMtd%W|~c%b7kD@ObKiZkW^Z-rQXo(9+=q7J8uDBvr}v
z;P9Ta`DZJ^UwQ%l3>@&Y67a1|KL<MAD})xmjBx})9c}d`T{IuvSOhWp*L~h-FV<(v
zjE&4RBar=k7~gooKuQ(SY8Spe{ZB9Y^sImIM*FAF@x7YK_ATXZb*qRv7@Uo0=|<=)
zDLT}+d*0E*ntmDwTI05B?-oCqr>$|7o8=wr8JYC=AY+Vx?IP-N&=tv@nP4L95Ch7f
z`?*6(E%w`+A=Q&?)TbW(RA{ASW;_;x!`yw~O^yFTI8aAe=JqQXW3;ZQO*@eoo>b1}
zC+u;&4V`8qBigyt)BYzRwh^(-Gj>7h;y_zXef~hrKCF0)g9=%ps+2U;3g~=ZBhWK2
zX>KiT0I{SUWVp3dCfC9k>4+|g*D`X1+rpe>vq;tq)?K?IQrArFUHX_)r9yOGkPYIz
zK0T(Od4flpoyO)LWPEdZIj@QS!(t3D+KI%f7iSSfug(=hLN4r%OjbC;m@{L`3?v&A
zM^*&swgo)=%zg+Dk%V?(?@j4Cew(ke_-EMvzdHncrTWAl5k&vg9vtJx^M*T)zLo%=
zK|kL%3q8?C6NKom!|KD#eo%t|m>6$lnb#A2JZq{m3wZy0-ap<yT?jg=wOo)@Q9!YY
zm)J0-6L&|9n>Ls^(pEcx1cAlg@wrqAm<58Pu{B(bhDi2CPg@&^NgL5CP~(+=&~Y_&
zUDsj%AB!!7#6S{pePos@0mt6`CqM>`d{mj)QrJ8I)ynX39RmV#1bhARx}=+>(9b#q
zgkdwuyfR~su`cZzh>>k~17tajLZp+~ewKb9L}nxq<Gxp^RznP>QJn>OI1jzYH^8ce
zQpH|1N;Q+X(8n#*n}`S?#2vO6NXXKN*$<TiOKpR0r%lZ{RaHHR99IRS*4~vFn}Pa%
zO*JAd-Kyz2UHs9j@k{B13v|)vLEM-{s4td;v7sP)%zWBFWg?b)!;<ZymHLy7fZY;*
z1C19T`fw*4)q@;dR||-UorPxRBeLU9jA-4Bzp(l(*JtLh2ZDdP1^A0@z(eijznT;9
zgkQpj_ul;C1(GM|kbeXi90GDn1^J8R<CzA(hI@QLFz}lCKRy2Sb`d;0JpFX&{niFN
zzkX##S!E7{?>f~X_K|KKphZs&+HBv*it+3yH(q`A7~E*7LynPoV$i}iQmp8MmT+W*
z$3Z-|B{kBv4reg2CB#SuI7kkH<2)H7lU@rkGNe-FXr)2xn<AKW<_zgL`jSk19jxPt
z?=d?QGa^b3g)>mo#;jTwff?k05qkA)+IFOXVilR>T04O_Ralj(gJNns$_iPcx2?o|
zfAwXS(m<AKmUJ=Z9EqXoJ#nN%P!JIk11RQ52dJ`e45Lrl5J=s%w#r)IFa>c&jc9vm
zj0efa<INyJGv}aWj1lhKPJ@F`C&VL3OK>I?nRVdpiiUX{#b&1=Yv0aD#$aw0Thl4H
zIho!sGmnf&?<&B7qJ3Dc4{k5XWv&&nq7#ooBa>~6t6om_3fYg_^;s?cpXmUeRp7t-
z&vW>nOXb7?@Z_5xDK4LlNmJPKU1$G#QsbvX{v7oBMFoJLE{K6=#CM+Z56|T7N4`F`
zA(saaMXCW&5Ko$Duj1jtZkucxC?v6u`I#J!!BJ-~@LV)krV%reqU(6WGa|qkRXfO-
z9evk^#$)J+b}|O$4Axd`?>y?tb_T}8kNb{m4w2Ec*u%?<h>^1=T)nRPzJR8(dMlC0
z1fv~)N4{z!k`x^j!bbL<yT?`y#bdfQk60^B6twat25!rSBIdYn4<Z)WKzBkQJBSp3
zKksc4%<ld|cBpD1VrImQ@Fg$>XO3XB(4_luZkHG{X@g7U0jsp#yzbF)V{V^F<-iWI
z7|?dv2#4&9ffgDSa?Cb|j}{R=K^&)Ibv8SVX9OdjfKNW2jjt7`&tR2-Vevo@`_AmF
zh7$Vg03xEKR$eBP?(|U}{C%7UE`t$2U{uMOq1PvN%s?IcR<07p@QE*fzJ`C!2^jwh
z{P9=W0AGNRYO>FZP|{|hqiQ<S{}x8o-q9hU&a;x)Z-<t@IMh4`|9Ttl@fRijQ_k0W
zLhsw}>lc3x5ONh>yuyAQ1iFrQJ{pk@!{#S?r(}09Z$Sqb*)2`70g}nbZgLWPc=CSj
zBpr;ADPaV~uGdGDHc@s&8*-%57#TQ@NdT1*6*&d0Kmh-9eY18`eyfBzC$2FfMug3L
z)S+z#YAR051Up3Kfo8CgT)jBx{{M?5YHw^)gzH4P#<5p-Xaj=KhC%OL0;)(Xm>JQ!
zdxK5fr7YQd7i?f;*GyH;k&#4Aa$Lx`dREAe=7E_bdG8f#Eo9EUsyK3JUQ?=t63Ic6
zc^CvJlFE?<Q%M>h-`(*B0~}A7X&&0tgP{MX*0$d?2~lvlO+Km?96!8fL2jGI^OZIg
zssjp@t*>Zqt2#c6$IBB{q@(YP4p8>V9ypaF+yI{5G(9+RJtCaP6<f8vclhJu<B1dJ
zuW|zZS4glw8xXd&&)8Kb54|7_JS)FoAm%WG`Sy>*+u?sN_g_ChZ{qp(>+j|J`=5C~
z?E0xHcz-eLX%lp6Y4xzmu&CWuOt=EVd>#J|ps2&OcR(n5XAIa17q$b;9GdgWqdeRZ
zOn1ONBWaaKCPyY&LDt@mAl4R3(wMYrd*r}1uUh*?N6t;55jaJ5oO%SwX{gHIKE5%d
zCCcouE!r4uV9paRDKTgwVK_J<pz0uAdAmwwL=SAm$iYc+SDouXCekgpcQmpdtjd5N
zFC+@!ENK~3$t%f<<bLt*NpEf3i|tf22ZJLJBgny0vN;L~B6m6Vsv|w8Xl0Js8KRcw
z^<O*oXEk?EGSiutK()%0LC)Z4!k?Rt^fd>vp^+i@MNsbUoUiwhkFo2Z*^W>;zAAtt
z3_3DrkO{hdb5Hy`2t{>nH4qVNw+1Cn)?HDKj&eKd*~c*S0_qld*2Xe3(=JiNCr3~(
ztMKo?|NhHaz<&e<{S^=3;qpIU>|@PcYai@)Bg1^0Ob6)kkf9#e-(wCOKb8LPQ~mLT
zC%#ny&&S?BRRiyT$IqJyzRd*+PZn?EY_}3blZ=7{s)OtjOd`r#rSK7VcQYs$CD_U6
ztatQN{lTOg<{Y!7L5&D#Jh+^q(AxwvbHtA--fIPeoH+t=1p_(9nT<>V)gWDRCwuA5
z%rQoy%J}~AfhP8L7>c}Qd-U3GoM;vLx-QDD0Nq&(VC3McLJ(GvsO=W5;2Ao3@PScA
zvk1<Psf9ocvI6W~Rv0oYQUzP~*cBELN36=O6&bx?>%BqpD+7n_^wyMgW(o}oNM?lw
zVzy;gvI4QL8S6%h!p`6t8Jkp<O0C;%YV`Fn`O|~K&l38jZ+{Lu|4>Q#?c-mGM8`L2
z<R2~ykU*6W4lY_<eNdWa2Qq7&s<WLj0eAfIDZc!~m+Rr-_a)*Ju;KGzL@NM~hGgLT
z_wWAk<CEXMefa;>3-IbU-Zj5JtqA+@>#Y3RCYl}U$v9b5dsiobAfrmr@mJ11?9A6L
z-v}8aPClOf`e&X4T|X-of12*+`|3{%yNmw5w>#k(qe^HDfV8*a+5{oEq9rCQxqLWO
z4y<MKM0G?*b;)ddI0*<D7b82=mB}KxC5?=Td#Ps=9g*dE4VIQNM}#9lp0ZLTLm9#L
zE)@b<h_SEH-~Z3g&;0nfbX^~o9NvCx0IMak1BaK`^C`mZb!z5(FI>gJkxej*B0H^k
z@5ZF@kdD}~JxIz0x|fYXTJwaABAB}GU5r+3_v#HB!tOU<i#Z~I;do${9U>kvM`p?n
zZ4qQjb(jo8nX@8THVaVIt_^q@-0Q{$xNNIbH-ii9B6sw5fDwalO`(3#CK~+1pxA%X
zTH+5?L5HnA>$g`G5J4(*{6@h8J!!P5<;X^zxt+#pAZk<`0Q&Q}WF#@5?(xecn{9EP
zrpKYnr|iG)#p{}XFB$01^Z-x9_s^RD=hu6c_2RibFDf&mwf;1744xoBMr0f+5L@-v
zFvz|L8i!2wlVR_ZnAJ2IX9hFgzD0j5>-E;}mxOV^4~Pk@1!2Jq5T&Rt1WT@LfMwx6
zayY36SONTK>1t83$szX7ntIm@QUlm+UGb3iAU}$c<C)F^QIT*e<`|Qtmj%x`!&X>`
zlI;h+g+4{#Y0_=v6;SPRjwBG@zJ0v1?I4s`w5=SWY6hbiNR{)*kDe_pe4aIRq-!HX
z#?cQJ&2BgPAy;OPE-P%fjm3>!V85EI4rz;d<!C1#ca=VYy5_uO3srViIU{tq_B=*{
z-0P;)_%t5ioa}C93T4+_5oMteC|fInD<W6PD-xB#J94f7Rxq~14kktp_ej4zY&gW^
zf1!ANf8y6qZRM8|et)T7|A@{$BG_Y@0ji5BHy&X>TFDHe0VmNy+G?w88w>c%)p%;S
zK2PMBa|9bHP6n^*>adVZydVBQlLi0B6+l&Ct%a)M7~=`sd;&n9e(*^E;sdK}W6#$c
z&(`tstG5Gv(1Pr#^P>|uQQp~4eq~kl?pL*K*f}{G$>ld1t=_7FeM<c2A78D%2dl}U
zvzP@V+6N8^$_~3jo!6QXWE05LW!Kpa^u&0aN>I+2YM}-lk-J|XM8`_BsMeA*Q^C2x
zCpihyTKn6#Z}I#8_xn^yRU1Ku;xekpFkwXGh$?ZfmDiliadFJo*Y907k7XJWL&4hU
zSjHeQ*wanQo!|1nOOhcP%RsGlJnRJL9B1ZXFv(qt=H9kXrR75~qZgo=XO!p+j?F3%
za%|_=tCGPFx3tfOcgfhbBildTUIU2L<gFkZp)!avahqPQ+8`>)&CJh;ag*LvlElw3
zVq043b)O<*N2jGciOaI^jKRO2=>BOm{OAAwY30>R|1BcVUr@WyA~5tAsM}4c9o{Mg
zhQO^df?exLC_myk^D#|5nHp8)2qI!~jFAU;8Y2@q2FDm|8!`Q7iQa#?1^BrNkou6{
z_x+kS_F*5`d%t+*lG)`w`SJ1bto_iF%%++=ZlP=<A{%9SVyu1CVpWt((GD`I+VZ(|
zZ<|G>?B>)*gxj6<z$oG8@IONv0PAx}@wJ+ZK&onCmFo!}0ZQ&LSdm#771i+3p0E%O
zD>^AJ5n-ZW9c+)u7x)B-Z6g?*BZFj`S1-MojWalv&lt_WYb61c8N>H|JF+xphA|>D
z`1_CFveq3rW=3X=+4GIs@O^(~1e_zCF^{G?P$gz$uG*esB#8{aTBCDyKp=K4R|il8
zQW2zKiq&dnG9ve`02{%V2#PL%!G6;UW&?#QE!uNlh!Y*m0JO=avzoBo%0f;cMnnY4
zq1qWSPKZgVHWnF6g#x{@vt5=;%ibce#~3%jl4_IOY`<-(IwB@bKbeHas|Enai}TDs
zEBkE})a?`g7{O<<W1;h_2w-Hk@$-;sBf?vcsn^QtrxBt({~chGAln4JcOfF1l--$t
zy?S9{UQ?O*UW#MRiP2MH{ky^bUrGl0#oq9B@Ku7d2YwNW@sj=WVF0`+zK>p{*By-w
zdx$wLjDO}xjz6sbdNb7RoUso$xpO3B1)=j)d};dQdC?l0$G7|3pPv{umO9g(8R0q}
z@~pM0D%CCdBExO3z=O50-78))<W~0xU~WD6K&)=sdTHIbDLOJ_19Rk)VEl(|2T$g1
z#)#j4|1Ch^<Kx5kz4YJz^IyF$Gd!>4Z$EyI`@XZ&W108oo%8xW0O0=ogditBoEh!2
zR|7a~aqVR?yh@6qBB&(hGvqR`N$i}gc5fnMFklWl=(R(35RqdbRAH*@gwVbZ<~WRq
zst{b|s>#_z*VV=e0L&RN874g?V=Hp4eO2vjpjf*$Ga|~OrM((DxFbW+L5c;an4@oy
z94etmmxUeifL5sNJiSAegIA|dpKwCJr&Nyt)W)e|;A3*=o&PhqI8o1UEv9QXB9D>u
z2FC!Z`q!LoP=4Hd-SUc&LNZX59j_>5KlNLCI0mq{UT5myz@uN=SLTM@PY*nq0MC2u
zUH<!L$zK1i1^7e8*xTXmwYOdh-e<LUfSusMgz?a)zy||JW>b7ksh-teM|hpYUHeNM
zNOtbafjOduFHx;NH%AWiunPWiw1KJ~m%l&Zn)6dfyo0W31G}4rOrSRX7=wiBMm$Q*
zp7QdU(yGYV0XfD5#LYAh;1m%&TapjF2!Q8if15hzA2uBZ=g9E)@A12TBME)`_@<_z
zEr5ZwHoe{92b}|+_qy}H@tqB>4SF~K{{U2W>#nL}#F@<!lR5?kyzuhzL(yr%`@E<R
zQ(=P0E^6WtWyg6Fk&&#@3DOpitBxD^3~Slm9c^KaOfLz+v?X(pnS<U%)EW^nR6DD7
zgZ$`N`v&oNU93_WNjHX_hq?ou@_rAxw!G(v1#mz161ZQ~o<A(X2Y22&ftH|-bJ?GR
zPP}adTFBeK-a}};RIE)C#6#!oIan~GZ`CSr<N#!BzqW;~3yA*xC-0<QDa$Ps9)qv;
zWX_4qu6B?6&m=XQ6zp^O-@!Tl8p{7V?B_q40lb>U<KOS=v|!nV;t?ynNVsEMuaB2R
z%kgrf5*%aji9Bz($C+@UsW1IcSXD)pBs(&52_b^YnbGe`11+{V1_j(Gj8g^pOFkTa
z_zuscwn`mwqnfR#KxDUb=v*5jlLJO|C8J6XtMht6dU23VV$SH8=V(SjBr+q$VE$BA
z#!teg1QASx?$Q%~mLqC__=G4eM+D{|7}ulCp}#7okvSvaj??W$FafO0&>0X^Pb$=a
zI~B5$WA@h5M4dI*^SKQJ<4Ht9Jjbc+0;h=XOmULn3yi#MZ-6^u$erm;&W`0YT=UyE
zwxEzr+$Z#p-+$1Z!P_KlTahHNkvV-L!)VFowm2}rYFz`1K*>=V-ZnRgf(z091jEb0
zAz<{GHXxhL6z%j4g6hl>)?=VL7r^WFJ96NI@BntXLy-)?i@`(%(X;LZ?(MbiMx8h1
z?eGr!5M~Y#MUEtQ(TP^m9e;-HvQ^Ikj|hx0#8Zv7=Hs8{^*vA|^|!VFzfwRw#NVg%
zIOiC<HWSIlOnsSz_TD&$yvcq(4m&<pSUrDFoax=kH|xQ4?X4<>>RhjkPaCy%`&l}K
z=XGO4h26OfxRAI{I!rY$6Ut7JKqeOIjQSCFtuiS@wugi;T;Xjok#y{~UR2B5Y-J=`
zg6$#(NM-MQ$VQT-uPfsxS@NTHyngZ{yo5^Mt`9)a5v|Bpr;YXO591^8`{$3UrN|k&
zKE6FViJ1vF$oh0i8nx<teX5x0^YGf1s1le_)fV&^5yg0|zxwbClU)Tw!-{)BFBb`p
zhzP-}5l1xOQfU$Rk>oP4%2f#JSb4i*XGE<nW~z~1+qN*rz}|ZVFl85ri}d0B1tP#c
zIDOJVtvNdh7%t1M3~Ug^{#G=YlsxJ*iYZ49v&S~DfzMU!&5s>K1-P|UVn26+;nAbh
z-m~Y|g>c`dw3~AEP@1Ak|ICTHH>$SCbRbZBXXhn=KEyS!7^4Fhoo<RlBOZ=|4?6jv
zyUlgUwmFX)83zAJ^?KswU-4o8cTB*i-{^|Z?qW2aKA-24dp<Ur({DKa@+Ut^rQ;am
z-kl!&^f#v+I9UO0ln8P+DS%bbqm1(VXI7He76P*}uvZ6Z?p0q!J_@eF-KWgf0Ze9|
z@V9336o4owQDjE{qMBs7U-Ki;k)zGQb5x!@i_9xV1l}Md&*6WcAdk06bG_yP34H(W
z5AAJK-P{{-VlSSJiz5aw%<td7;kxp5V4oa4S%I@-wTx8_tQ$=g%10>DB*oC)+sFYr
zFk2cpI<BlqRuS##&7*8{+Y?6*qzIYY_Gd8e7`!cg+H9{xZ&Tz}rZM|5?(+?--#>4W
z<i|CN)ZR5liMQ995DUP?QxU2NYq!4|p(J^K-prX5ppMwK<J=IAj8=4Y^17O7Ji2#D
zz#FJtt)Qn&uyTy*G^Pf3tICa3nU2O+9#7aycB_ENXw#4ZRTY!LeQ$ImMi&=u&t<vc
zmn1Q2S1=e=RXGxw>Do$?k*%k(-7WP~{<DWh%47l9D%BJF_LE4-Z&mv*QQ?2-0(ky#
z$9`?T27#?wWJGYzuE)<e=5hZuyYck@@2Ic-D;<Yk@)r3Gs><l>wbMm$ca#QQvPcmQ
z)-EZdAKXBwiuaN-<#Oma+fu*=iXAf9XCwga&mDyweK*8Ob?Dx2$<_IAkR4&G;5M@O
zK`yZ!_C33e$P5Liu8ZRw>USg3di#FYPr{RrKggj4h8ZQY6OX~njEvUHeSGvZ=9-aJ
z2yG12PUaY=0&A~T)w?)*@6{LqgMD$xTx++g(Z(1v+{Jt_pahH2S!geXT-&5lZ7)7^
zn=Zg?-4Xl|V|==_JBs^KJ;RhfjZc1_GID=>glw5$eq0|Lfwk_HY@RC30-4##$Gz|F
znM!oXAPAL(JfW_QH9?N(px2<;?}citc6&BLG>n#Ymkeg9+xKR^_bcn#<w&B`g!#Vv
z`qFr*`jS@lbg99d!(@g~s?`s=eQ$1?uE4w$B&H=+4|xi3kMoRV0CP?qP>yA7w?L-X
z$NfN*?S;VZ%co!LBl-0&s`p<)LH_L;@NH_yM*;XqexE5mzkI!XLk4i<AfGG>JPAN}
zwgv2i|6sme;h(3`YGQ0gR8L@hh?1Ld5aDvkzy1D$W27X<T1&(r)C|r!sR{@usm1O=
z;1~n<=k2vlf&()IZC90LIo0Sthe|&Ff5AQ~j#k7WnR<5K(HQidgK?hr?-u0eKkH4o
zs9$&<9%*SrfFJY9qgQ-)L&nEP4gh)IPT0Bk3d=z$4ZF(7WT^KCokb|;I&78BU337<
z=J5gU1(^2+=RB*f)3UIG0v{}M=)@pAE722>ElGm80k0fm%S$KbcSUA3*HQ}7V|KK6
zWLPEGU7CN-Z?X5z-+%k$y6^by$M2L>!AOFfW7>2hcl$ea8eVipgS$lUt05eWifDlA
zx+SZyWwm3Hf>B4Be6m(0s)Jiv&=JQeyuASvJXI-BtB%2khmy6d!+@C+ihwc#d*58E
zQTd>li$I24qAfErdN^4QhOar<9EtJFs_V$_Tlp``iDIxGM`A?kJV^a#^q>DY9{lYO
z{Xq-x1_ga3b(~o62NlNNNAkS~769+P9{S6ZCJZ-{%4=_T8%6G2wteD~s#C%EutB_`
z4&bu--7EX<QbQ@kicqWtA?&IO)FKk9g1>$HIMP0`6@bm~qwO(=fzaowFu0o%t?2NQ
zhW3!%yUc)Nj4zN4S_JigBwl`lw^ig%KR%Vfexn%i?XVN^)3)Fpc;e0rFFl)wRu6(4
zdo`*C*ePisP?U#6b@l|3#Bg7&MhL2noHO2D?x%X$VDInt#u5JZ+r-cga)EU79DUZL
ztjLgioVp1t(75J@KvpKUcL`>VIZS}HMF`HA{(t{H#y=vowQ4Ux+Q^YneSzq_2aN_~
zbu<o);Nf8ujDaJ)Z2fjb_LV4GwVQ*&u&Dx~R4$+#nTD(T{G|F>rDJkyOx0Gn9!Y#h
zn)LvH!2Y}+N|s^Zx8LusuyQ!)yzv=SA`k@A(dEftGc(z(K%AHY70HT-=Ekyf4u2~5
zf2MN%%V@uUI|KNI4EPK4b+~?yFF~cJGSJ>T9+uxx3i4+P&uJr`)r3x#AJ*PIaVbZR
z5a6((Dp^&EP~)A>icmh@4pkvP%+^w)q52h7+GMmi8|ZyMup!{bk56P~!?)VZ3tM!u
z^3lQGC8^G;=MgOc%n$f@W#XD~<-}HP5~HoajVM#W=YIPYv*6wEgrD@~4<GyEjbh9<
zw!r|9wUD+*$aAnth+T_zrH#l)x`Ff|I+HQ8F9{wiUGmHp9IVa-=<&Cme{guXeNpSB
zpX;}in1B_ZAb!|h2U;7gl@Zv3)f@IFgLNc7Bw|_Inb}zxCC3cp2%<@UgTeadtEB(g
zx|UZ%FnTpBD`p<WxDc65IAol$1fhOpx}7v|gGUc@i3h|<7U63BMsJJ^_`Yw?d6}ew
z)?Vc!#;`4;-(%QSjUhaHt5eNd0Dk=bJLWZC_`XAUYTf4sbC59uJs<!_Ya4hflSje2
zBcgh8g*t2i0I0V$<UbATe_r4Jt2SW##q$5n-9)}+llv*<*GT|A8-n)=A%4<SLuyPx
z8$3>j+K&@}M(rMEtEcMjAYW4|AK_SZI;J}bW8dvr3$)hTTK8?D_3Ah>_Y;lX`H|W!
zxi~9FCr}3TkKcZ%nXBzPz)QT{x$z^DV`O9fTXEH0&U0)6u~waV$ZLoD^BOSUR&D-i
z7>HkhO7i{Eun}cbuJb}urM-cUnMdyqbm~Re9&S+Y6&YqE$)us0BMaU1`%s%(h2mDU
zo?NfAI#c9`V3teSgR}S~`3Z3O84>iQwNH6^gS;D>)C#<4CUW7?O^ndqKIwQIkt`UR
z*Vx~ruqVhL>+|yynbfJJkpT;b$sf&I%Sa+#3_PDHnyZHckAqHqVr#GM3bJyhWR^-U
zl`^*uzFWJ>J@JOsi<MUjmY@06nLhMi(jB0F`~WzRNj9EQyz;_gsa3p;%<+<|ok;s4
z;ovCQTP>Nc2%67D_2pXpxk7(uUH;Q0@E^|rp5FiGEx=o!|8hCJeQe}O^!VwMp(O6T
zZ5ibSwR7%iDRcl6)q}&}h~VDqp;&fy`XL8a<2Nb;p>36R0O5WA{)BJyaB0Ivwe7Y9
zB&q;oIS}(;u&Qi%v!{;khgCG**hFHEINIS>gN#gA#>O%^BJA9DHW4>55<gF6-#LW!
zh9-{;wo11E03ZNKL_t(v5Q>fu0rwlxcml{OV6O^m(<fMG3+w3dyAKBwb@N4{?&)hB
zTl?89Q^8yS@6I9YY>hbhZTAJh2#h0-O+kkr0!!K;HmKF?!zhAn={f-Gh~e&_%8abu
z8Xj7ND5*3u-RZd$LGSHdTg;42B0s)efDq@&T~dV#?uh^qurhN;q{j$$B0&f8@uVyD
zXH;<649ai?sI|2L6pd2<SEXL~?A;)Q4zJaDi=X(8Qs<s^)!Fmm-agRGm;0v#<PbAQ
zb3bw*uK>l+7REIkz+R<*rS^3}5m{BL27^N++c<R+n}1<{|1%TQ->(3E6$bKd1%8(X
zx5T&CUgzw;^#AXQq+=rLIZbmaPegYRhPReZpko-0Q$_5P4bY`$nbqY&HC2i1Nda{%
zS@fY1wYDV+gh#MRt$@j*$|?4~OplV#XqkB%1Ia*vjXPgu&e;jb@FoD?%a~(C<mPGv
zkZdzDB@-%FcR`5H&(g<7{)%PzGx|(#I)P_<&{cywh>AEPZO}4GS}m%0VfF0hDr(vs
zaq<udXLqTTt+I*MFhq3*W0%Gaq{c}jz-Yw|M#RCRS?x`ScZ{s2BtNKU?98z&Z&>AC
zM>Y{E02dqjUQG~|jCO%TyZS&SvpQ3c`)E8mn(O+|y%rVKFbk&ZWDOE53&(s;Mt@=U
zE48BA^b<FrvbR-bxJs_X5Oh?N=fDAis}Dbe)_%~H2N%$n09+<fCpylDg_+6`o^!?+
z*`s|obtyBLv?F-__ETKj9OG&MReP=78KHVr-0$+^Umfy)Q^o%+D)1lBTVMSCz7mhX
zC&n1zLnS@15FXB)&qd*9Lir2{_ud)gfuS7&!^wHi4#{A@k)QRW!3>0?+G1PO&v>r4
z1Wg@!V$2H`HzQ+j9X|r<iCQ{&)qX_5ejp{SzY6`=fBm<vYvQ-xe&>A`wbh~TB=*|D
zn3PZORj{gBlm@#v#&HrPBxq#D=jV!#Yx>+Uz2JPTw8#DM8umR2gn<Qvoi^CX7o~mh
zW8G2p&QH@YGeezPhOo)@hF};<a*Xq4b4J`bbDUg}z==BT5iHJk>uVq>WAG8EGNg1#
z+8s@3+DbB3bdcYAs;-D+GzK}V!=ShOq7?fA6AM^-IY2k{uJvWFi;>_pCotMiw<|g{
zFj(=5r1OSRG8)!H%8zIf2M`J>CQIdQyTVxjs<3<A3wvIdRr21gyzDoF4x*l?+vsB`
zw)XRMdaM>JvsZQSbxq9CESqs<#{r(zUb~zXC^3?1qFT5K$8l&=eF5}8_=hLIf5E-*
zuLOMWPyM6b{p;C)Z^J<UqR%)bk2!L@^{0*}k>ZGgc>1o_opCk<`B;ZpIuK5vTDM;6
z!F<AKXyBY&>z3ux8SKHddP9Pv!6v2C%eK&y;8w4pod7D^ve$7s9nni<XV3IX=0L%O
zfBfTj{PvH3wErj)Tg4H>@T7^unheMa)bljAs^x07otuHuj);-L$-8wgo)?4vKXq@~
zBuA1X3#tO<kz^fxJXzWO|37Y5WaaJ5)N~zWh8v*!0WeQbXC#m6s_yqF(oM2RW@bdX
z!2pFGtmWEF$lI38*qeYRp~gNlp~#uL08^ykW+;hdWyvP$1ql?Cw(h}d>sh7E2Wg`v
zkZDdg!ZQ`6QnW$B$7maL9;?hQ{FNV2QG5s^1H@i37o<==`!iz}kCPaE_*?xD1ZJed
z+``flWKzODgI3f!dAmC_4}aI;^o{b-@}W^1h%j>2iY}GOAeZoI6)p`LlSNAEQc)%=
zk&xBXl5Fe4VkG);Mxyqp9BxPn!^>x|0!;~7iX2S!dq0D-5`5`?!~3Uq7{mFz&${`?
zXfiWZVKJ2G+6G0k+-E8=`D`tQ2ZkkYWn4V;^!!{z*w?B7`Do@?H}pAcZ;WAQJMIM<
zMhlwF%)EMgzil_TyUI4KZ)N!bUd$Qcqw>N`y6<}x<gpFh?|VvFE3rZq%jmK^RWg({
z^Lb&vgtepwal4raT4dG=(p5fF6eI2^uRJ!rSS8+0m9lZgTnKVEbbVyoLDieA28P@e
znN(>BT}4&ffJ96$Gd*LH@O_q@e6~^E!m&gKBAB5{U$zkpn4xm!%CHNgVW=>(QBekE
zU)>fWIN))B+wkr}O2d;{LbGGt_z9py1EQSuDnLxy-N#hMgczi9&N(AePHL3Vi<cAr
zinvp_*@Q4{5k`$PF$BSF<SJNMp806U-2+6u-5io*-e-19N6G4#9YxNg^Iw@$<u0be
zF_g0jtk7^G0)s>QlvHsI7;akAnd&}3N7hvjMB^}Tqtv<tLPEsH+&1HFY`Wbx`c|f-
zTZP7!KVU_EfoK9$MW<w0d=pIe2*=O0`23P^?|O-U6A$1Ed4OlKk3BH+yc&D9;K8f8
zYwx%6Ln`oZNg8W&liK&a-A=)XdB5Fm4d_-#VnuZpb2cJSh*Hb-=UxHhQD&?R5ou-1
zsZfIW_z^Ip+zlz1ck&i!s;d;yZ>P*12NNy<jM9T{oA(|n9SH_fl?zgs7cy*HLr38u
ziPNYTkx>@u?H65uwO2T$W%l=`IvYl0CdE#X3g1&+e_w8fh^Z+4en+a6a|k6Gy&dLR
zo`o|rZ`+o=W=iwb+#k5axXhXWpfM10FSv#Ez!J2i+pcD{6r-mUoyw(}1&T_{rrFj!
z-hnFc;u?!~4A@JTpKWb_dF~*(tKL{fWCmfgv`A~<FN=;EIbp0wAm%JhedjnS*|I;C
z(S|a?;TU7Xj7Ep7KI!nGRKoiWvli#LS*ZbYgD`Y^y1{JNfQca8J35R^iPqDqD!D0P
zG<9aUtfjsWZg^a_NWvfR<6DD4c(K&xTSS+LKpPh5B_xP;+GQUiLz08!o~e`~3;!(I
zZPt9*VI;%M6#IVnlrZ<1Qd;(UV0oltN^<1i{`MEolz#f@zwv(CoHp`)zZa@2ry|pb
zmmY&&ubl{jM)O?uLe&7S^-?BT9$hkegxFw`xerD?f>Z`~fMy|<fk9>*gQOLcjT|LO
zj+aoICbr0`amdW#oC+d#qN2GW43>I*DDiaAwYz<(fW{!37FU=`(jDo(rP1fuINLnp
zy0IA#){#AzhNoWE!G%dyhh^q+u);Bk6m@1iW`l6YI(WJ5@?~SfdF<7hw8M=zPI(ZA
z<a$QodrpfiKk^DSWp#LHt%3lUQ%qn&mI9e#c9B?gb+@6IfmG7np!+T!u~r6iL(B&4
zs%X)jg2*vkPw%@kwE8wkE9AKdvAOaSwI;;!#0M$!5-gd0Hf%?qiMrFb5P;q+01uEu
zexVp#4}TVd`hxy9cxV?Htj=t?(gh^UnC4dK>S~=O7293`rD5Al_q*K8%?Bf9-tYGW
zn77*v+JyW4UT!Qvit=~wpSW#<KmF8TBB9doM@oZen4+Q}r;30@L6hRZpeb`DzfvJZ
z+$X)Fgolrj5vqXRYV}i@BhzTi3~0~{R*{E`A($m%T1hLaJmE|OF_si`h3XzL)S9ML
z+gZ~J1+Q;gC}s5ankP%$Sd;*m(cRMBbK4jXY}3yVmtTAq3vlEHAZWCpA?@Wc$>FB^
ze$Py$li}w1$-`L}?rS$*cCL6k^>wct1&h3TPWf_cbpAS9mcfydLZR9`^hjDABPLOq
zXlBk_Y+s2;(VPbJ3WTilF2LktW8~B#V`hkLb=P_@QPHlv2Hb3`WR=tl5YZkLMku2L
zd+2Fi7RW8*J<^H3a<!*R+y5%&?n>nQ>Ji{8^2GVz;9om~r9jG#EpCnfvD&f=Gp=;^
zm0{J<*rkHH-|tv{0A{AAryC;zdB4l(2n1rEyA8*-ZM@x{@b|y})joW9)_?uyPyFq-
zU;7hr|Ih#YX}Hshv{PVRma%B<ZOfoc%d3MO%PN%&Da|yzdclZ5>=Tt2>vG>xkrjS9
zlfHTOf+P&M)fCJiF#v;AaJUH0Kz8D-xPm_jg_I^GvSPwi9J1)e0hpaiT#qF}ZT7Ju
zt};jOyb(0>K_o$Uzi}I{=*GGPsytdvzL-)xk-$JEGG>N=2{6m~5Xo>DgfTYyINkOy
zMdgJUrWVAPBOb~lqO|>8Nvm@{>~&v?fGQroDgUg`BPvmZ(v#0WinahHf+#T23FO?9
zBrLmT4|fc+GJRGsHB}+Cds%ZO%b6Ev*Z+E-xP~2e*{Wcbm3vt>Dite;%Kauv&VXha
z=Vz(BZ(wn{#M&Ka_v!$2KHKMlFup=Cpf?WtqjF^@1CT@hyHbBIRXiUM7PMT4w(S;k
zhGk}K+XgeYx$hcV2aG5%wr!3vP<GMIh`Ieg|M&lkJwht3cm9w6@%JRjpMLu9T>hl1
ziyS`k$G?2fh~%%o{#M<+84kx-KzRAmh4yJHau$7<Gc(|h^v#&}FdIzN;LU9~Lm5Oh
zc9{rwjRL4Mi&9E!245lj%qlsGXhc{jwl$Omk{9Dgt({~fG?8-_@j)@1DTR<0W-zB^
z#c*%7ZLfUr<8tet+ig2J7tPc6YhPj}ANHJO{t@(ATeZ!W+4#hl?gjf<+6RIvsdoEX
zFOvu)CUQ2XvA0Tc!))Itt|+dxN?jJ;_1`N(y}ZmzMi$4iomOF*qSb;@G$Dc&%3ZD}
ztQEIoY_8{fCj}V^r3_w<ifG{ti3rG8BujU)x&TnI!0q-C?03c8N`8)ol}MkV^<J|r
zu5JHkIRV#>;P?6gJgPo?@M}9sf6u=BXsK!}=b(#qx1F3!a^H8F5!?2(3=jl@zy10_
zGs<CR-zUw;`|~}Y_cHM=x=`TV`*-o(ci-vx`58a|<5!sjW?St81ve9Bq(47DYbBGH
zY`ped+ik#%x<Bs%onsi=?z|{7FYo3G73vLuWIov0V8&*@WyOGx7k3#2s8KOQumYxK
zM&pdotPHjFovIZjX<#~=qZm;t$@0dlL#ag2E!{kQ6rgCdq`BN)(TdNclDq_}@QpB)
zd;i_N?ZZCS&pg<UV;lgYN}>%Xk-g_*$E7WvLyu`f77sLwN{U&oJVNHI3EW3&r}=m}
z@We}U&vKFL9EyTswVbPvIRoZwlm#8FPOTgRw+=>KHoQi78t(TUZjK5sF*HX(T-so+
zIxJ)s*{9okl~Yzl%vApI3%I9xYILxS`R0EAYXEwEp>u!J=Kou@0Qv$Th)a7PmzL5W
z%rbT;&icU{!zpe2_%SMAMy7qA77=>B-?KzU>D%V)cp9(oslwe8LjLyK$9#U?=?42h
z|F8ce{`%J+?Wdpq5kLR@v(?N=1Cr0r)64)f%crOJkbsXLKj419hnex|=|-Ay&S|v{
z2h53*zG=C#CSafq-&WIOiy<P<R&kjj05(nfNN#0D5@mu__!X2S5E<5^WVz|`2&`8@
zOUfn50})ar=_w+H(ands*&+g*zeDHW`Nfs!b0fg&8lJloSU=Cp2H|BhM0gu(dS@e*
zZ+69LO(YUzW=>c|jWNrusgz#P{FvCyeQV3E_Ki%0gq^IqkCx2VR=7k<4X%(S6I`LT
z71nY9vaZO$a^Qf#oPm^NUMcC;S%0laO&Db;AAmMP28)r3)=RWBQ0*L{ZdYmwi5_&k
zWR=Pe6z!C(N9#RafLVP*k@$8kz#D2nJ-8_z;R5;Sf$EXqx@SJOm$5VkV+`B2TVxY^
z0K~pej@rT4?RG<r2q81i+l`7y{`lh$%#{7dfBZ+jdw0X%{`NP$d;eqr=8r#qpCtYH
z`OZusVg{7Vq`PH){P-+o6pBm=g7z6SOD-|Svf8DUA?D`8=)|01+vb%`Ev?ePBb=3N
zTc_f?R4pkNq~axU655u^%bX^-*J3TuLA3&zL<vU>@Tp?$l>_-LQA$PmZNuhU<tj8a
zYgsMy=a~33P5BW>%S)HAiuE&qkKGl_(?hwP{<qSb$^^ff;Pn_<gS2~nJ<d6!9V3f!
zy^5c}kOWgOV^rx*O(jCgS%jiC_RT=dEF@8^nDA=f!7>l5Fg=>uMMuL%mR4%jT1lAn
z+72uxMA7{UV<|iFdI-=-OBI*Y;q4HlHQbc2wIHQTv5NOG@>XKuu>sH*I_><%4&mF@
zfY;T*gLcCn%qMRF6MlKH?7<7UwxP>YQ19M7F(UKh$B%6y0z5svTVx}A`0xQ{rhR_~
zNq+a;5BcMdKd|)E)PMc-lm6%b{Qvm(zx~zz^4A|Z#=zhH_Ll%)zx@0w_c`(I={BD4
z_kHfkiUjV|-#RDN)`3B`OlILawKT4X0by*LbBwLx&~s+r{Mo#gj(vbjF;Mwh)`@BB
zC#htgRM}ay>@w>SX00WavX|tg;_Vx)3_HzP7Gd5_O_kW|17~uU9w^DS2f!@xb_~|J
z2<#{EQugn+mNPFYv-;L9N3hx{WM#s1qBd%~sscT4r8Vj`U`fAGv^}J924Iu4$ljIK
z#2`he?4zmH+gsss(b*;Dl^X19t2viBKzY$A0nR<S`IfoBmr}qS{RF|6?9jT=DI~-K
zkN5p`V%{<(=v$#4g%h?kHuB|L`jC5rhhZca^3Uhc{%<M(U-%$b>f!a*c~QRUVvmK>
zgW{I}hAYuX?q;{Ao3`6VrAAqe`|=c+A3l7vis^zreE6V${No=9GAOcj9sKpT54t_w
z`2PL7<0XFo!*}@Q=U?%UfBZbH(pOE9x%tpOXA_eEv*;?WR5Qb^0z4QqwGGOK$F|)z
z5;o_aF(X4kr_+Y3c?zx!Z%`POb_MfF%5}7Yy#ee^wI1-O)fH-US$21lY#1$};qXzb
z4Y;`*V3jg1jYzpWi+54ZLg&@qb^-y<E&thUVqWaa&OsS*DF*uqK%D3AaVA`q&SW7V
zBiqS0Y88i$w__5LXM)NKjs?3d7APcUJkJ!vEcP*OQPyX>GF#ENHUO&LBbQoFTKjwr
zw{Ukk9p+0qS_f=S6d33ROLp#dao)7L(Z#T?H6nls^UC>anv$B?%FN`pmE1WSvP_Dj
zlF$x=L>fLv{;{{X{twph|9l7V1|dif_Kvy$NRPh2?9a3CfQgsHp0jn<!!Du>9-$8(
zK9U5+82RzzGu<8U-n}zP@$thmXH-;;k4+h2K3wm7X_12e@t^;hfB)NG?fdV)7XbY7
z%WwJXZ@;nnW3<Z(n?zHJ9y8;NR3&Yf4A?mIeE-0hQ|^N{Ot+^E5O}}eweK^HN*}{o
z)h3eGEal8dH#f2e!%R1#%oSDXFq-!~9<n39G*T7HG2Cn#pv_>L%DQ`V_rWS8CedfW
z2Iyw)5ouP|$azBIS66UtDd!38pO<aTyx5#QYEREUui~>=t9QNZRhThJD+s-9$IGMx
zR;IC$bcaVus2F8273C-wcMJ<jVP?u;2{~zb5UAPEY0fh3ppvqx1T2YnHf_WFC031D
zNr`Rs2v^a-YKdQkn=f&SMN(rKGSn?X0m-FLfuwmac9@&V%n|vLXis~S;;YN}b^iHt
z&fVYC1$>Jf_-oWhkH|rGSvQ?mP<YTad}4Rh_QtvI`+Rx=_I+o$x2Z$WN(f+MU>m0A
z$}iNm4FQhWcfiUCXpD{9wt<w)EZxRx&~q5MM-*kz2at((x9#8<x^H-XentU;eM+7u
z-o1Mw3El5|miPN6bDO=<7&L@ZoHLVUHNCNfi^axwS|$xhBg}m(o4$xl8)nRALQPl-
zM%e)I1mFf`IRZy+W{VvNtFTSE5;iIp)f5=?S7X`vHqX=VUjRNKa)P$K`u^cFE8TO5
zW_1a5hG32-0)8{*z7Mv?YQ51lv6swvv6yR9$jC6D#6JZ0l)?%CloJY;FJG4OSgn|@
z3l}bEk7fVmZecc}Rd+8$rC!wApq719FXkG1aisQQQxwi)<%VvJ3u3L2SdOMhAI9<x
ztiryQP0qv0@DY%wH+cP@^8i>`96E=9d`%%3-*EW(8TQ{J21CA~Tx!jF3wK_VPx7q-
zQ$Yw!GxMjXC%HS^JwJT-z=(<Aj_3Pbb5h@Z_g*t1KYsXF3u8*Raf6xRx8FX<?8CU-
zp76sD-{<}QY(_=~=)=>7W8P<R)$1fuGizlXdmF=0AWVSm`(4QI0f)BR(7tEd=uokK
zT}6z9Sj^w@ur&(w4WKQuOD8GAILdGsNP<k0kkt$sWtrwcI-mjIMq<kduL7`nQLD{H
zC4v|NPQymSXr~`tcmUVK{}I5m68G4(S2)Lk56lble|<#r(jhJ&5HA8TaN8I;!3db>
z9seeg%w$djGG?|egLJp4(B$Ag%yalCsUHBR14E#)R2^9#jDTX!pb_q_ZH(B)7GqeX
z%Cr+JvU5fCyy#pDv?;gya{qxb%lf-)lbZ&q3aTjq3Y-<c6v#d0W=SnpLfs@U=Gd<g
z{`|~ge+%)~2{ZfSv;ddN@wqCJr<=qsFTzf@yq{XjvtM~!I)rQbsuq9X-Me=zyD{cc
z4obrP?)H4YOAy|@drC?AShuvAwU>YW>t6r>&(C+gfB&A}efKW6ZL=kYk$~Gae4o3X
zKURVZjC5m}>tHGsGE!rZw2`aRMENtrLAh@*MtjSu1R^MBjl!bKPBWA<r-s=cR!I*l
z8k<~*a-(9ISp~<IA${`j8VjLvwy>GoAbp5(2pfQr#Z$4e(C!o>esYsv$F<Bv<ize9
zo^9}c8rjyry`MUVD5_oUzb_APJ{TPrwm=%hbVw1I+9PxNqRk2uaJWN0hCof*JOShw
z%wr)ZD2Ktz4PBAh`G^^qir#!++qQVR-NL-SW?Ro0kF+23#Z)$5D`l?SirVy}SXB+A
z7QLsw7g^C%E88k%aA_eoN)0-aS@bV^yM=$_zv~Sxz_)S+zFYv#RKW)v0A5KumoDMj
z;;&hAe}mP82Xo^mf`<bAV&$Ge68C-A{a&L0+b@G;npeu=a|JHs`}gl<W_W(yWoCSO
zcf+Uv%f6k;Da(gf$M<BIbFU1biu%IsHcHr$z|+m~@%|BWPmawvwx`8o!|i6aPgCCS
z8IjDGs#NooZ(g}3<t)n*JCIEzg3$(0G?}6eAv0ubd!CXz*#Vi9je)G35YwSDDu_tC
zl|h4}LX|l~J_c(w_xhH`eWq^1YH3!7A(Yqw>`Lq;o*N*WOSD)%0R25{INW%|Zm*oi
zvuf?kA_OXbusM04U^2yw#M}{bdbn9|Q-z=aIf~z*-n^L>3!{>wAqP4<S1h7vY@1E9
zt<s!ns~E)PSxaSA)wu`E9EsFYQUFBEwI6KUPDff%DY)AXOR35nSE|AtoCVyt%+Vk3
zvj_cizt;ow|Ib+ip83QN_yBl-*y8~(XqVeOFIHG@brg@N$C`7hS6c$84<9~OTeoe@
zO#S@x2c?&<+Vk@>%`CRthNq`ZX2$pLpYZE1zv3VN{onZU$G_<5>9%(L$P7Mz6vl8q
zJ#8ABbKiqzmBzF0f&IQ~yA30mW8CN#wrw|V+l}6m`#G^pIXVbsP?;7f%X^~JvFb5h
z>_)TP_i!JoNO2{R$#y0MvxHOx;0|UIV8xvFg00eIOM>g}@Pu3uPBV|3WjqNUcH(p9
z9HUulZRB--z5{f*SsIvhOe5~F1MN>FC}1iuttNMv9dmx&hJ;g1^LfcLP#^xiu3IFD
zkqL?jCik+3ELJ|9VZ+mC;f7qv61|vlmT_ho`A?>G-h0NbNcDlXX+B~&gQlc0UfkP}
zTI*1qn1rk>0CrJEXJ1x;Fp0`FDuPJ#t6dxnfwHnhE=ghq2@}p{#EYMM@;?PszXjp{
zq!@fH5cn-yfVU8Sdt-LL?)T5;m{$oZ9*9z2=>yDIzH%K2_Se7u1#?dQ^2@KfmuwS%
z`RiZ!{rBJLmtTHWtzR}p1A?SsY#Sm1F{eIcGE*8p*dG^>Y0^;4q=Ae*7-g=h+tbFP
zgcdqLY_^SpqVGExb59$?=ZsRHx+!K9T~I-;o4T>3&P>eveI{~dYS^|F{kZ&h&_n^T
zl!;b`*~^En>?zkY&@R}M#?8&J?Q@RXHr#CZ7%e%g3$8hYHEKjm?6a28PwsKw??D@L
zGu!*{*H{pMIU;uKR_Z;!w6fK`w{y>n;P*KEaUO9%q*YAQE~@C^lFdMjV%?Qg-;qnv
zOM=RNZi-oxLQ=3SpTfmBD90i<W^YgnTAUs6ZR@qyqQ4QEW%ycN%Gs6#Wg?CwVC4^4
za!|y2B}lD7ql$CUJhQh-g1`ci)G<nLukgNhz4yft{cE=Y<68v;4?2Q;KpEwwFyw<5
zdRB(zgO7Ro)a1K&@2+1T+#TP4|Gma|#{Q2Tzx?tG=A3x<?%h!=?swpqUw&x;hQr-7
zBaE5({@pwH807>8FT)0k+xr_^YNI(5w_)ox>-@tqHhA8{kSf2za(Yl^G7}s|E7#)~
z$n+4nPnGoBO(h*JGfY8~5y;IkXZRQ{w_(cZDv)s5F(1*@%ka8%_FV0yBB$qbRFWv*
z4YYDjVD5Lldw1gu#cd-XRA7b=ZRQC_aANwv-5mRQJTtEq;MiUj@+*hn<@fe#w41NG
zKX$@En+a^riH*qZRzzGOBW8k@(SdqipVxTyDomJ_;X?8lr!2hv2-(|*h`Qw6S*AaL
zVydy4fSGBy)12)@W%Y%XsU$jZgq1e(B0VadN1BS;*Zz`~dxp+8FLQ@>2=-5azprup
z`6l<D^BMh`BJkB>pf@@Koq)Wz+LCKKGaqac_&|V?%S_altngGs77*Au0r>9y`!*uY
zoOAMadta7?oQ7jDY$p!_A|gRcwoiSj%nIR;mW}9kGhPHsw069KT74s!yJdu|BDu*u
z<mEjNrTX4d?T4FBQc(p`E5<T;zpLDjSpR|^0X{du$jYE1EeIM+k&#g(p;RJZnUtm3
zP~^1Cpj8yFXUZixK+o7oLw4}S1hId7zE9sQw$1kpJd^lfHhz;1kZ+#AzIg(2td)fC
z001BWNkl<Z$7LgQl@;6N@Xt?LTPvbd+lD28up=1}B8TmfLaMwsvZEPF?Oec{y~uEr
zNTX#a1rtPJ&Rk;dIvnZXICP#;W<O-YL}+lxN@_tV)RA<kB?y%XL*b8=4%NWZ5`*-@
zps#{vU7`XfPKW>Z{2)Fb{_!df>@DHXHy40wMLGTc5g5VG>@;!VoyTVg4SZP_F}y_5
zdHJ(!pFxZ<_`?rB6p6Q@efi<T2mbckZ~6WA-*b$iAAbCSzy9(eo58E{^&@6v#RYf)
zbY4c6{7g|ge#||~0G{AB%reA?9ho`Gl+-E37LgETB`C2DG^h)vX?+p29HX=W5eYN9
znR#S}6=X;#!vdl@K8bEow=9z_kA@(lSEZA-EGBXlEgyh1GjWIU4q$iR0?_{aeE;zD
zbo&Ls$L+~Ju6g~`y2ptWWDg7}{PbsM=HNUPf%Deq&>plVVLv`r%Y5kw7mF&aYS&|z
z+IG480E|;YnS+X1#sX!~Bm$u*4F{3tx5eOXWpy-X2*s_en0t`kTbR-Xwe#Fj0ZI-q
zTEikN+rr9HVbr9rCU=#$;Y;+#7x(@AjN!-EbPj(U2JluPc(5Y;97E~);{1(S|Ed#s
zROLPa21_Pf!n~4Gh#x;b<F^kV^y3ddtU6U`!;rSEqWj8BXXEhI>ZudTWY*LA1A@{L
zuq-f2scd!!F_n%=JGRALN7?5W7E~EUla*tIj){`{Nb~9-%ZP+l<eNztql%Vn4@fbw
z3_sUO&_+2glTL6Jw~W3r3N0ecII=wU6?5jZk-HLe8{9uW@4Nf>4Ztr={<*(V0P?~2
z@*IGAWvrdG0r|!_c<vtO1uF^=y(xjRO!=$n28sflnC_Mp4cX5VEB!a4bjAU~&6t_8
zQCWT6k7X#4iL#4SBt-al)%BKB$x`w0AOp@~7Pq*l8W&{^A~Jf>iFIfJR->XXP<kId
z@1LXH|8550@9_h;ZU<idQ74x?s$Tto68O}B;;KHwg-5^(#_+1RtdCo5b@A=pJ%0H9
z2i$Hq`}pw#o}cfENDd!O;6nRJtY~BF4Npy^nf;xxhhis5z}$lwv-5(*dm=g_szXiS
znR`lYOi`VMby|sly4}s{4J*Kl21!<<PsLG1ITj%WBe<iCNXj@g-9T4r&^Ul_g5G8&
za32`H#TY~8a06yc?#!4e+au%IZR}6m?S7y82f&_Bhh7&wz;*8T%h;y}-JafPWzTtt
zN0Dur)kJSR>p-(_V=c#wi0c0{!5}>|keM0H&99<CgvtjkP0V(t&j=_<EttNn08*JD
z%4A+72<zk8z7ORQR<hq}7fR9{t@)#sE_-=Mb`hvYYuQwO0odag=Kinw{XfS8_`MaR
z58|s|TwP83^xJ2cPjBH1OH}cyu*^9%#(1d!OIDd}*a_&r{_7`_CTRh^lxG<^wz!@Y
zFy};O*-iUkW`}kx2ghY(fkL3Q7(1;Evw%$6`$g2G)K<~nQIP5u;<y15aCCCfwhgp-
z^>IL|2cWjCLpt5bpiAij1`s!t#oCR)R*t1`l({O*9d0&#SoxhNqD=vIn(Y}mAw56u
zA3uEm!@G}`zMsfF`JnB`8+gt2X7|hY*d9>9&kV#852@_ez2$h>p}Vc$&(3B&BFA9;
zo9rZr*jurQiE7KjRI%kGWX?2N#d~IDHk9vIy9oCUV0{^+5=b6}0Ie2kH~95m92j&n
zW!aatMLhNDcKZAp?~(7q?;-a5Za%>H7T)k%fS@FeG4z?gt1EbSxk2K=jdBJz__`A@
zJMo@1=R6v*h&*h?hC5TlZM(_bwBL7Z+km@UW@4X#%|<1T#SZCatDbbcTV=~Gp^7Sh
zDsmpiwdHI+EFvhRnV0;xOuxu6mhW4pmk)Vywuj4nhz?eWw#-LIOq=1hF=>^TXErc(
zw|7rZ<N0~NMaC1rcL3gjd<Wqvl$*P``$l(*A`qF_5L-Q<*dyXOQ@f<!Zcn!l06uP;
z>2&j70l!BNYrMfii#N7De1!`Ln!DiJk#wtm0F{E}%0xm3@|Hla{rw=&I$0<YGqBH@
z1hUOwrVpmOw{M!sZAd0zuQ1}Qf|HdE12|n);oQXvY89z$*)%)c3z;?e5k*y#SgHGq
zIP_xG)|WwEOn%?O0)8*S=d0X+zSseL>p%Wd*uWd>#3Nn!@&fDuhVa=pq0JLl{-CyP
zTf!@52DWYR`|rPFL}JdFQQuL%|L%R?B!%ycF)C69z>UuPzQb*_nJYw;pKmCcA(KQ!
zmasKxFq*r3pV_)Y7(gGHUXIX)iYZb5+Um(Rz^vLtg^X@Cj52e=E2)=GxOD_{rLYs=
zNMJL=lY!sOneWZ*X2wnM;WijKm3t(%q0unK$=u+c((Yq>j(Pui+wA!w>(z<tk2km)
z@t~E*XU4UoaI`DN+$YjU#dl=Lr8GC^40$S4K`!u05Uwe*NOmfBp?aV)A~I%Vu|Yfb
zJE4TjU7{eGlnOD*J}Cv{%obPF2lF=atn9VWj7ei9r5t%61S718kQAWFN)MF;M@g~;
zvlNi-2dMdoNsBMw0bd#y^yz5&?H4%!jNe;19{szBpu2y~$9v>7b0!t(f(7KGH|H#X
zSP?|G+YJ$^`+b*GG~)N~-%}|)-|w<^hN<Kg5oQ=Bn-Oq05?KMKMj&7%Sd-;UPVFQI
zy<mBtA#XN$r|-(m%$K&u+5a9S3_&`~Qk95HH?!rHr!j6e2CYXJyF4so*ciWk{J24J
z^X+zvx%<2KPn$BH5@y5AA`_XJMwa>FoV!152_WzHy9~Gw+wMO2>+q-FP6r)F0Z@+%
zpMH;Yn*Z}82739sI_9944j|iyw^%?aA<F2vhZ0gW;~tZ-Pot43%#!wTSY;z-i!UbH
zT`P-!k(o0iGTbbnNYE6qD`UuvS!sLS9}>t&g{G`oe^x8IVhEL|WFh*;0Ao~&**4%^
z5jp~<O+gQH<92f@qW01myv6j(Z*1!y`2rCCBprC*5BRaVfvX}ZGucL<IL-5X@M7}P
z3FvaG5RV;DKixbOxT7C__#Qw1{7bpi8Z{*x!KNZ+Oc|}>n+Qcc0@ipSYv)UAs;yFT
zs{LXa7LlWvJYnv%m~sM!%#96P(?%uddNKEk(dG(;ZsRFXrv5S?>cj6RfNdNzwBTkO
zPq(psh};Nmw{i0XECrgIRYMzXFK3EC61me51Y-EeR6e`&IdhqL9_u$Aaa4Q==si-X
z?Epr{cs1SVbolELxAHo!zZ20ynF7sbE!r!`J0o*Oz*NmwMY~Xv&1KS6c5N;)8>?WJ
zWl|T2N_?#Ln=>PkI;<!lD@*|G1B$Y2%UT`glGJuKJxW|yvY^?Cg|_0+9kd-UhK*I)
z%zQ<9r4YtXovtpp$?xR?JX8n%>05xW*$%vd@y)JwMPCv(*c-e6VHx>LsDv>-YOAn3
z+~!QU5A6HI$`b2yg3Mq8@N}a!0AK2kgKbuH11UW#<roQ>Nr-^AQmC@05-U`|>e7cu
zi<YN^fN3_e{3~2z+~n@=ZW@Ev!{!&HeQO&{M5GBZQg9nKJZV8=#x8TOa6z-|G=tR1
zsb{-cD(z0gv%PluX>t=+0UlRIrvgU*BngTDICo*(Sma+jeZNW#peR%2?!TuZ6S6TC
znKMJ?Ad)jeH_|dwn}pG9`x%H>=DR5cFlFXBoUv^dF%c^la*xbX=QGVHrzy1)^fGwy
z^5XY)>{%<}s83NF05=X=)BdX{bj!bpf9$}BjlfRAAsBp_#8wU&_}LWSw{QS{fe&!K
z0QJut{y(e${EkZYhzP+4BBM_#T;Jkq4B&{UI*$Si7_8hjKk^zX7DT0?b#Ki+nJOD|
z2~IPkT96NVVcWG$AU1$$$T%Ea2^*Cp86=^|gmK%=5Scj*BPuaoK{ITd%YE>6^YiOH
z%ci#nNcu*rFx6Rv07gJXFwM!e_PZILKi+33<c8d~+kQg!lU4?vb7GEx%vo)5i*3$E
zA=`N)P#MiwGd9dHl(^9<$g~RJC#ud;?hGPAj7UPTIR*DAhiMFt+^3G1_aly>w-0QO
zo(eq7cKC{{Fotkr!hJ@j<}8dbSt~;dN>+P8WG6`{e6{Op;a1x&XgzL1p%1Udnx*@1
z!f`z-AUKNt&m+OOx6+*=@roBQzhahu$aneN&HsB3{x=nXw?YN}$s+Kox*e>Y3cXjS
z3YE8fs)I)Cm1ki8`O0XiY`k8lZQIr>z6zW*x8e*W=x%M^D`tEB*Df8)+a+1M>4d>d
zFf%El%<S2#q70*33DH3>6+1A2P^M4X2msUER8H88F`lfg!_Ub3y78meapyhz(H;3l
z{qVzgd7pd4+~<AIN>zo+y`683;o5L}_g>rWp}#_mQN&4BUU!<z{Ut4EI}w0hMzqR5
zHdfnjo%2_D7sm4_S1Lia`(*;D!rT*D)(3*K%vUW{tv6HP^l}9A0@+HOW42{4*)pR{
z!lEO<0Hjy?i84we=`8p3<@G~nQNg<}%2Y`P)gP8dGly-ROfJ<)uRzn4GT4u2HE3ol
zv!Two`%C>eo#JcMT3k6YUpOE7O#A<boW=34I{Xj(1zu&*k+0&A*NU$N8+jfdKIsl3
zGPS~H1Ej!G)*1JGU*m|iRJU<msFGpW>Ek$J9!zE}`h=M=Dx<?%K3kMr!HQ672~<Em
zfjyyVgv8t_BxvbnMFq2soy>D3!kmBH`}?xGfips%GjdW^EM^-5Ft^R%zL^>I^yKNJ
z`R()`l{7aaVD3E>mw<ORui?tiID*H!xjNQ<ETYY*4h(c>mQeUbq}1K?G#214AwWeb
zc&T2MAr(5-4C+oumSlPT7bc@-|6{sY7?d+r5{guMDF?NgM}R7Omd?jZA=D(Ih8*kA
z6Iv|J=J{9|D_5o>7w@k`n9fQ71qpXnZh)4jf3Zo|G41v7i}e5HiM?th_yzPIZ?ydS
z125u#ZUp$9tA`^v^m3^A#^1xqrwQt;sP$%*wb)rcaF|wf{E`={Ujrt#ZIob!w#l-(
z!<REar!g{@YqLvWq*#o6KqjNy+_T&8WJIb1DrSegg`3A1Ov%!nFxza5Pi_IbXe7=a
z3UQ&+J_EpZD?!uk-TREd>;rwuUU*eVbKYwuVWSD_OSW4#ZAteN$q8~C{&<1X+*7kT
zFova#0ZL5d?F9fN0{w5BbTkFUoQzNciZrtsiK$FvhVMcu)63D3P5QGq(7AF?i8lQ}
z+3YD`mR^D;wCr9qOCOuoqA%vGUA<YF5;OLCRIBLMf$dLBr>wGC*!c`RKoQz10%bI^
zNTLo|uGHbz2bH|ouD@mhF3R$Hf<HMoN~kU5-<<dV$RFcN`}{X#!1!9V(OZI_(~bX-
z2e3u}_pu^XPpZCG93)Co$Bpq?Ll^0&zg{yV&4x*^igzl9vLz%3S%%Vtr9yL`7Lj%s
z6bs&NaWE63TGGklt54DsL~PD5-}1<gB%&XTJhj?>*{S2ftaldKJf8~0ll!qX*e;uc
z+DQf2zD7&lz7<Z6Z6#WnQ8RWUw`3w4Ak>VIjY_fYq?_j2w=ZD*YUFGcUlWKTQ=}!q
z8Hz+%WeY$MN;3*+NafHHNt9D>x<QdFufE>E)!rb?=n<(jT2>AZDjvD)P~d|wIp!oP
zl(=&`Sc`@VCO{bsyLBUorO9T+5qOC~%~AOQ?b5io<4pqSa(z7j!VB&9QKHg1_@B=6
z>kY2=?yctle`M?b%{+iV;*(xzy^p}abHebEtXgs2uL{O_4x-sBY(SD25k=arr+)y*
z^37k4e;DotxUuZUxa7TQq^06mTN*%FsqV8_X+tjteL2VkmE-m#K;h<d+}_P?;{wfI
z)1Y-^OPtrA*Ulg>A{;+4CYQ(JDQ5gABHO`}7~rkn_WM0sjKT4;>eDn>&>VEc+$E!C
z*;O0&kGtp$3A)_|VhWLprzf+S(kMGDg%FO48*dx;JAl0op8{F>DVkL#_aHrZ5d3JS
z3h>NuGKflMDjnbi3sez|N+5?B#L7_51-YS!Rb!BIj?A1Wj}gKw(Vl;=c=;V)&!rj?
zD-VDj)MqQ=t3pT5$o|7!ec#^eNz6Bjz^4cMWy`V9!$1At|I;JDx3B@%`tDQ!-l}qH
zH{C_@ITL;!h9>l%9bH639N=Mx!VN$e!>^HKuCo5`>@2R<v$pj%K&B#+?q*pCv>{+X
zr2BvwZ0>WyEGoca%cq+MXmi^N%rtui;y9L}#|tX#C(v!2x`J#x;87f#@Y+=6>ef6|
z!JPCGEr+sm1Sv0AI|H=XbElD*yFe=`ohVri&B#5%-Q#{w-rN9!^Pb^u143H8&Ym|E
z1VYHEWEA0^+1~kSWJsXf;LIt}vb){PA}oi5uyz5WfUyl#b|Ro;QYl8Id7{3~tlXZ`
z<WwkkF39g74<9U^9_>5krJhSvnCC+DSMzWFBJjXt#p~-cVaF<Cbqt5;Xm1^4R&2#0
zv)8yP2oV7v4hdSqx);w2{weMMKaByLfxWlB$P0-0rPbiU?rYodN2Vdy5YqEp4XeHp
zV~j&@(7Tzlo6G><{o&nf?GtPLb!5G%J|0+6pjp~cizpxa4CT|)yNdQOLn^~<gbzz3
z0`}_R@yji6ZtGY3el}9QzV`hD3XcB$?X<VQEx<5m0d(~+p?P-%5vHOyd-3viOIxAM
zD)k|u?RLxi^F2bLr`wb6^KMVKccLTRDNPvtg+#O(<L30IplO4_a2PBjBYTWXf?kLz
zF-ox`mTEF2rm+)x$ux5qOd9p&WriZvE}(_t1;mV~_!p2qYJRK8?jS0DY|Z8c6qi{q
z?Xa7J+}zAfW(FU`vLSl_*gcBIYv`{Jbit4~j308Dx-Kh?BUnu9%})urPnp>QUXR27
zPYCt?d>+6zj1X_)0gurA?ijLX|9tSq6R(qOmMXBjcG%J8L8c70T={ldy8*9r3;EKt
z)K}5*(FPba_i}l+!K}r<1chjUQj?_*Mno;PI(Wjrfb6bx-}~wNvD*9FiF$ih=Upwj
zH=L}yYlMZA$h~1SBT8T(!Hm5MEBd=D1MXR`*AX%4PEaERY4ag-3lNAYG<oTTNK_2Q
zH1AtfW-!b$3S|zAtYV~Sr6b|i&I;?69LXZ$sw{j=ZWV;U6r#Sfa*z6|txrE%-`^Fx
zGZ@e+US!*OfjsT$D#h2GG;<7hm@~}`W7v625Z(?+#an!q49F<viY7MFftWL}?*%@L
z(ab6{L`=4z4(%0zMO6B;TK_+V3jFBj&#X7_ISk-ZG<XUU0UpbVuX|PN>Y5D@3ZJIo
zj?>M2Tg8Mm^I6B!utx<LZ#HdqW0}WI<5rf{ASX#|8_z88^LouMg$8(W!MVEXoMp7^
zgZ?^l>$Ta&O6GlPpw8&9QDy{IZn{PycX117uQnP9B;{tsZ3jwKY~W@tm^22DkkB!B
zExg<MUNm~0Cn)wPTn(m)s+&C{D<DHTrBXfut`5tMCTCVOXs_X|!MxS?tJQaX*;daV
zb47dg?oaLYS9r|9*y*tM;SM*4`9On<XAS?=iOL?4b(R{w?dd2;krgtRX>fnpe66t2
z`#s=hm32WXblmtyM}59Cf3Mi*PhSH*G9rAiCHR(&L4$NWKm1o5ARe?}{PY{uneLAZ
z4lbj_ISF?Gja#*j_1^nnrra`PH+mQ?%q{1f0uZ+`7Gn+vR{VPBf40Orr|&vGb<+`E
z=l7jK!SxzGKKOY1D>k;n%?x|UYX<d{5bz;~2xPB4Jq)VZ+nC#CM-Vbz3xf0jkMYaa
z;+zd}(2m_G1yCBA9&t-^D^+Ko5b_Ah)JwE5R=}=QK7Q*gwID~Di%^zOWk{F~mR=Lb
zD$38iY~kF!KtEgP9;L^L*Ka)kMS3bug9=ND$iqRXqK@Hi%d`d&wY8{Uhw9IYS#{}>
zc_sb)&duAu1_St--Tzm9SX;!M^Nrmd06s&RJSugGylC$BmeE3|P?488&riVIyd2*8
z1M+TTWZPDEQq3p{%Zii>$o$O}=+!R$8jf0Ry|5iCx9U!C;smUNb~`$OGS{4|Xk=oV
zVKMm4%P=G6#5Bi_TxKbBx3LS*7^Q+VJE*^Q*}9w!LK2U2AAwK9H{$3F3`8JD(Fa)(
z>R66F2`Gm~a!_<wMnYuUy7A!aW=JyvE2p!bMWpet`4^g-dwKv_yBxyI;O0d*`vjb)
zUgrY7`oqeO4>7bnK?}1AMe#DtK{J^#`(tSyiPH(GqQ-!1-$8@jOc(zk{WHM(zZ3(w
zvIRd=6uvYDTmil-IC!1M9?fV4;eKlB`D$BmS+$&7yK(yU9hcxztNC}HZ{&ic5LlLR
z_E6|_)j1dd?1`)_&{wxOJADVI8+EPs=B0Qnt8fQ!&k1i{LJ3!E1({}L#NmbsVwzPh
zA7LqkRlt(T6A53z)kiTLr%lE6;XL2?XAi+pB51EVt4iG}gPks)>IiPd>ZViWrl3~f
z78X=tC>`6SO4vOL!pkE^^j@z}c{}!UYKX2V(`G9`e1$92=LD=Bhj6S8j;pvx%o$m{
z5rdTxZ1?sh4>r&&y*T2vd#TrOyl2HA1k7A5K<bvCe>m0mUxERA!x#KDoxs^6@a#AL
z>Oopv)*Im9D-QkX<M?I%KkwMDt?V`A1o$-hHk&b*Ck_4eJ@~9)>Q<x|DoS$JQPp-i
zYy+>&H_vnUkH^;~d|U^klLEZIw$9(J^s0<(enoh-qY8ov%}9(Wp!0ZNaCz;x0I$U3
zl;M|QNGm|M_%5_!<c8XjODPnAN~2C8%Mz@v+FIG6yb)Vr>cf#Cq@vDcowPpiozGE+
zs%;cAm*rQDLTt=pP5phzcz>_r*c+9ffLI2CN>+%tTK*>~laW#p*F0O#QkoW}9Mx^8
zRAVHm+wE4JOoqnrV@x>dD*iM+&L3U?)~&zVlQ+5meWnxO8*}*;eLZH;l?T8V?e3!k
zcfMKu)H0vv^Yez`Ty)~}>vh=P3PO1+GVKv};Z>nglwk(#xOI8KI{b3@uDpP?Iz+0-
zHw8ZBD3%>!&8n){D@gFn;1OU|r_?+7W;O&{#ZpHL{PKEr0GC9q8q<p*k<hV5&6SlA
zGi312?<>D8Xh{II@^!j(Dnl97*SCCBn`OsE4Fg4(Lpc{@-e#|*=+NTuwJmr#zi@Fg
zq;e_g*KSs~Z$~kKAe`tx7M4L#yO6=8$_1-_fzCjM8>3cui_g-Qg;kC_aHwd_R@xAf
z%B+B!KYQQ*r*{D7Fa8U-z$3E>;%zOoPJ8lvuqAi|+N=Y+onGev@N_x&x^xHp0yy`j
z0suTV&?x!x1Z)6vB1duO87U4Y9u%Of?Ur9T1QIs##fPu_Kq=*l!zxd_MM0G?GoocX
z<%Vq#hn2B9I`2}VXQ2tSh3I#WBf{s5VEbhoJPFJ!8gVWThr3~RQfAgzk%$uGwM0|x
zozvfpL~niTHqW3+*I!8;Mk11(f6!|`sLWhk%gMR*e73S=dIQM5mHU*dd>abWc{Sq;
zYnQ(OfU2yith$xKGF|CV;3n}%$~i;Tp;X~ABi)Cz){euJy}B&d;6u>$Z~HO+Op?J@
zwEEXyKU%YV8awsrF4i9W8@t?;+v(;#8(i9H47diIUO(Tw{JAb0iMP^^Ym?D3V1Hqk
zX>5EHhI)QK&a29E0lc+?P;CnOa#4-Fn;W_I<V8Fy5{?>-V_R+;9V~yWO~?-h8|=hf
zfDEOC^116lmtbxP?iH^$gS0Rf`N<rjnfB5vM%|Q30FfCzs-#fa;9@(tFe|B53Umcq
zy05I;zeq!hv{vQROL2pR2s0HS+}J=M+>Pt4X8FFH-|C~&G9DvO-Csv6V9AFo00_tm
z{gsIRg)&o!Of`^+ecx5K?2b-0W<*s%cY}{ghC0a#7Jud6QV9NVLy)iB3cQKnztI&q
z9=oPo=X|^TnV)X|ar!%sPYp<}?f-e#eSgpaBwpK<=|PMB`n9fS(O=#0*LbbB{yp(&
z!0JovcDV+P_A#IlUQ|~Mik51-a;sdVlZ88_9F10+z}r;rkgA~<1?Ii1He}fyyA`*f
zChE)*NV_XzrHLxNhW<cl2C`s>nXH_o<q@SO{S$|&V7Z`5mDB<fQH^yi^beVG1$tT`
ze=WPJy6MJcV`MO9`8Kk&2*$YJEOp!G>5Xo7(b>zrCZ^s%CNyIzq9|1>8?f+TTj8&m
zGukOG;m+0?2Be3h@&Dch;ClE!GZqMMhaEghKGCHcum?Bgm8fy{*K@qq*!yL^KX(-K
za^s(O@Ylm`mmUALlR0+}b^<U-eu7gx!bJQ6_{D=RV_rVr;m$)VU%S;IEEg0rW(r=B
zc2a{{?aC4LTokY!0`6`0C4yc+7?H)h_kt7!v(cG{rT=G}BxD8*rim&5DDVGP<sT?J
zS!`I7a@qQ|P0yM^Wa?gC9UNd)9Rx=dj_95AR3pz4`?r~2@)+<d!T1$oyIOt$ZC%K<
zOKN9wMkq;P&U(voPGzRte02c_9u|?Sa0r;q?6WoNcaY$}_wWO)2K=MOfX_sTUDt#8
zpl!z+V}Ly(M!eB6d_pMdgTM99w^K2&%NpzIlQ$oHZE-13fluSn-%7_hnK^tm92IzN
z464gc{R()ViBZp2<i1e%{+zW|3lK1IC^01kSzzBGfPk84TWitvchr^xfbOIvRE{SN
z_17?6a>=aXl9?eT=5pGq8x$tBuCfU@ZR3%J7cMeAt#|n_fwZ2wOS?gJJp)1a;_<JM
zqLzR<I9aLH+=~T#oNoSg>915MEO$siRo*%jhUE%Xp`xiM-f?+P*pd7WWn$m&%G}l)
z+5m68#oIRi?FauA2JnXu_YaE68(RUs@ld~IQ2B_|b3HtECmVH$000)#Nkl<Zxe@(>
zAFKkfe!qXRQ~%VwF+Rgv(50C03*!#o`1^s^wBc)r>KkmwSMS$~_PPW3zPo@|=|0U{
zX}7H!n#(_wb%J}Lvli?Xb^&KaFEx@bsl^iO0F)0v2{Lt<acM#L+1vJ#<f~G(t5r!A
z(>u8q=8fd(n337gUK?{A&J7)$STnS(Ir`wC<0Z&Di;l~TS-c;!M?{-e>=j_4wu@Vx
z4Kx8oVn*HkQfiEWMJ&pUMFmDiVFcT@b^AZcbkzKRnZti{0RK|t?{!d!9<bu<vIcuJ
z8a#>^djtgf8-$f>nC1D<?{AC-kH!*S2t;w|TCSswy-_&gjg{$s!7Kdo9-V_a7AJps
z3Vyhdi=xRwwlp%W<4Y{t`{J%vh-oonQ&QB*9G*r<`mn}eSjlsj%U0cTT$I}i0wKjp
zEMC#P&DB#&Vu{t#*S&3rt?-MKx-B2-@AS5!5~7zQd9#5IkA@{AZP%isgYxmXD_g7O
z9utat(73}&dn;bglC~#KgFNeV8t?bLS1!HQ><HqjOQw>m^K;7Be?129X9*3y0w>Ue
zb{3y$?H@4#@dj4#D2|*DqRFn@^*nVE^TC7S4?2!>5ddC0{o(;maZP&7OR;(#rS&Pe
zc}-ScMdWrWYD*<}{x~likzyK>KoIS&QTe-3&NM5`wJfm{oaMtGQ$&_uN0Iel2Y^<$
zaDn*kDcGVGtwXM5)X64f_j1mfC1W(UXr3@Od&Ufq98eS(P~J`@6;+#PsPXkAeH<AF
zSMc_1%z_Kew_?E>#n0Ro^-7jo7-)_GaWCbRVkT-;*|ZAO{6B_wM^Ya;8WiYEOOR~q
zdix^z=U)Z_{+TPmNBF=3qA!O#FE<>&fDt_E77TB2?@yIi514(6b$7?>bYh$iKQ251
z;;~$Ldw}Zmg5Y1H)z88nU4X}Hr*xJAufKOYVHsyb5qq#n=yY3{3J?>-&>Dc19akRN
zJ$XPm1<umiK_~~D%oU$lAXmy#=uO{(&>Br^4t6DTi7p}N_L8GTS^;Ek$e3m2M=MpG
zRkabR$}wmU{sk(~V1*gP>F~d~nJJ0h!3R2@gXINL*^?1S5ha!^w6NS}3@KsXr+A2Y
z2=^DR|KcNzG2rH_0AlVF=KgOz{6_(Jgx3Enx`7@C9<|nSVdp(66mPBG&TFzIq&aT|
z{B(fN8hbw2<zLfoc_{{0AkZGn=;yENDiO*nf`9tl`9=}*%j=w%j^Voo1J564obZ(M
zcr<&1mg~P-F2lXmSQ7#!sR`ID(lU3X0uFVYa>}?GXJmBGyS%x1um=kbXhaN(R*ohs
zHf<r5i_CXC0xC1N+Q8S0Ush|8i~c7YrRUWpkW+5}$a-xL)=4lV_PJA9fS=&Q>(|}-
z=gH9H#iLdW3s5`Ht#o6Iv2|b*;qX>8Cd%0S-^Rmv4FbNE?(;{t{|`R?Tl#=}qusw!
zZ?AM)!wWCnFP*_F+v`gQa6T|si7hU?0KZ@lXO!OX*wN=vE*vi(kC&pN%j-H9FTcEZ
z=UbnR0q|4+Zl`U?*?MfEGz0ZM8N@8-O`;-Aj0MyQ41%+V-yoS`6}(3@M@C4trU#u-
z*gV?$OKWz|g+b!5y(sZdE+bExQJI0Ik}Fnjn4(^P28$sm)8?JglLx!`T6{lsq!F0q
z=*;8JuQ5c~CLQkHvBX-2Ba)Kl<qK>!v;dDveJUKYsJ`{F%m}j$8Hr%PtZbN;?brVj
zYruaM0Qdzg;0p2yU)E>mgMWKI<mWy9e%b9`XG6o|AP2v+;S;Z&es(-IjJOu6M+T8+
zFM{hRbX_UtgO1<~JkCoo(Sxt|{iVaQ6OdJ?ck^m`)o#FGWR$89$dK+JRe=rbYgYCI
z-G{IRekjkr@?c(4-cDdF%?@d+5ziOr4ibX**TlMi>!8Kj<11y9g$>l<uk@oT{(5Ch
za!oE?X00+a?E9?C$)q_e<hDpihZLfu=mZ_ozQ@x4VT>X7tyq3u4W=aQ``$%?FS~y?
zlmTshi=UpJ{{1|Fe^tAG?E)^v0G~nE_2B1xgEXYep+C>|=S17{3~ra3_|c4iHNN2K
zrVl)3Fy@1U{W*{KtES-5#^6!>c3$`b6EEQ+XFO$j9@?d2IIka#MAP^&Tb>&gc*Op{
zY*PGjajqf1^SOIRr^C@kom40kSho7*+7z~Xk1-0q6D(I@Pz6I3O`v{LmX9fdNjI1o
z-Cw<@vo{{Eo+Sy)1iZrDmRW0ppbtmPfYA{8|J%E^-Z+lz{GF=mo*^mGTv-$)8;Pyh
z2`mKrmIZ>fA0)v3*B0bFu8@}`fCT|bM0>rFEn2cHac*68&X<R(YBrlQl6;p0H$aHg
zOwXlf>eRV>mjvg8nojik(96`B!7SgdnpK4)%X^jQfcLK8hA7UvB5$8#Z;Tz<wnbKr
zYF>(Q;BVm#c&g8^K|X9#-L@`c*tC#z@H1?%an0DVf^On7`VCkUKsG(Mjh>rp=Kfq$
zVmuFHut}mSmDiteS~e`<G>p2AIVTtxhYorpEPa9OB?u%C(X!l5A~X^XLUWmANH_;2
zMM*Q9sC1b)kV>Tp9l=DS%j$$Iy|Xf2(Cp4z${H;a@a9ONQk+i}*;v0LPJA`%fDdZ}
zs}8mWp9PyxwG782-r_6ZOX{BI_0r^Emhn-gZz-UPfGLV(mtd$WQW9h@N{7j$MeqS_
z+j6#;qX_{`(?B(0GMN-iz{`UL2rsf*{}PRganIoeD8!rm(Xpn}UjJULsm(d6-z(~_
z8(o*-4vzuQMsQY>f1JAOnhatcb8sC9>RCOH;km;;!LT722IY&6%7W@Wm^PFieNd2+
zNf@~lAc9mv5@0Zz6~2y|iNP2lRM16(CFVON%LD=><{_bybQxw}>;9ZJWQ&&m8h9_2
z*{cG?Ory=>&Qcw_2`3(gA)|Sixe1`jJR#;Fl)S#REcjEi|CAJFEYxA?ZRwIF1n*hr
z`pyfi>-ychP79XHB>+K6D>O|5X#^S#JKNh(Rj4YOra9%7{YnIYUt%=)EV%G<7XNtE
z2dsBemBCJjQM$j0hCIgQ8_vRobr2*Jo1I;4O%G$tFx&(e#)gbx96*K*Jh!HySbH65
z@c-Q)FmP}mKLR7w;I<?Y0a+4^85(Rff@WfQ=59(l1FSPc5@-ToVoZumnaw+WuKJ54
zk7nQz^Cs@-3<fCSol`k6%@QM0wg`kbTH)<i;()0o!h5f-@c*s%{VlTs=hT!?Ktj$+
ztmwqD)aFHRKwy?&28IxdW}l*>{CoxhAgil8q?F*CplMpB6vcZFRl{V`_D#&KttnI$
ztJMm#*{sUc<CO{kzhrM<-D8ghM#uLVAPCQ#I@%dugr(=Oo_RR*2nd6Pm<GG*crlJM
z3*ankZxfF}*6j2$dd#sN{kZpGgJ94Ng24FtEO1)qVECGc0W*<UkWe#?q(w7EWNAAG
zF#Dr}Dvm}n<=7wzBGG}G8~TL6wD4@C7zCM!n1h4C94a4x=9sa*YFe%TG9WO!KV>h!
zEIS~Ut=O!nbO@XiQ`J1)b0Q%$mT?CVR}4FZwf4_-x)l?dlAvT3Q;raDndgM2X?l)g
z?Uc4{Q}O)(z^?10>mnwTmT$iKCJXRKx~@Zv5!2}ui^T$u9z7B>!^Mji`O0Jfzs0dB
z@T{34Y$_3+*CQB?+SW;uyHY+Rtmgx8O~A1=cm&;$>W{%WT+>q+2b1A$&1VF;It^Ii
ztdyA!%7i*9+!{Pj2LNVSZoC+H7)>lYb2E`@Bw{X*sbJ0QB>_|#lV*>Onr`RzUq$EF
zep=PQ%*wq*P?ZpPmYHN``YH%VP3j~|c?S_DXwezaND#`5#>)*z4{xMp;m@3<Gb@e?
zop<O>r<^+>Mii8yW~~!KdUF{#muq|gT&<Qu5<5FP5E0Dhb6GBz2qEzD<;y3!f8LkC
z&|yBGLsc=n{r3RyGxrtOq{=UH|8+IDY#7CDs^dk~hK??4z1#;@+x=}t5Z2Z_|G2B|
zaF#c~5pG~u|Hn0>PB+MEtTX}v;20-p!bN>P%lN-&W-BvY6}_!QU<op*Sy}irtHO9P
zY>-Mq@#`}IptNe?=mbtRAus*>r(~CR?=lI%1da-dcOscr9AV}p1SuAdG@~+U77EQ4
z-yWd}nSE5`xSTj>D$rY17zyvC%;^Qy7jj_5#hg)8>Td5+1y#lN_V%gim2-}vG!BoB
zj%0s-zrVe0TOJ=D%Y_RUcyx3mFXO^_WdpzlOu@#*zrp2rt>55yKE9^I-wQZb(%H!P
zG;iVA;TVM&3+GRQ1hdCHJ>*#>jjRb&;}V8AtK07f^?qdsPDg!|IBFzH>7FmlXoFX>
zBoR$%gfTd$1}-2(N>O4|SFVN?++YO>LBt^{#X$>ZIB&LDGlaf01C#SkD?cMyuCtwY
zNkn{>CsPt+Xd2hWE`yC+W-6tWkmvCp*(;QVm1huXDLy*~tFn-I@>?!cV#ytO7Cb+s
zer5upYJOSX`+lxpZRcW)2q9o+X9vSYe|UH(DJ8uB{`&-g`Fsul*x%ph;o+gY`|i6h
zRTdzx#rD4e$n>lp#^4;;Fiki!RVcf7-)btgBSZwM2A}-_OWK&VIW$=>|3r}9JD5U9
z6(2%TqkW;z$>A&sNpKcLI2J*vyo4!EV9`U?<FH@g0W8fBRn45ZsAf)6R8>nXvvBV{
zMZo!NVO{K8k-If7Vl*nmQN)F6K~}04HPhi|<4iS=0!0e553W*xt7cvn1uAj{E^7eD
ziS9oOXa~-DHcjZc9!=BGdtbWm0#za#w&m|dc8%5^tKYW|!GhzjeB%u7RaG&wS_;5>
zkK^NGT)1#y<9BR6pUYyg07<lMi|@bx9{c<I^){$#A0Xa&=N<l@0sIVE!HaSkMueni
z-S-rie(-y*8ezub4r5itw(J%%aLr_al;)IDoD8Jmi!7e8NMNlE&SUI?4rcws`;T!C
z9;ac#81xgWaO%(lVO8%>WKC`}dU0Z!k~-(TnTeUH^I{TVmIrLsk<JU4#lkG*^(F%G
zDEgo<B{X}3W<d=i!+o<#&WU?g<^V%-q9jez&^e*8D(^V>5MY*_!$T<Pc&JFc4rZaS
z?Lw8~V)YEHJNxPH1p0}9s`bI6W^-fk&UfEEe&z<cy}ixFVj;8H3|-e@e}5m|dpv&p
zcz7Q?di3b`4B#cpCWb~Q_B^Qcpn(Jt*DJm(7hRD`?>84zCp#$+QSW`JVKWQPIVnYM
zFCu!9oe-i*@j;&V8IIY74Ng#iZV(W{pbSX$tpJEAs#eF17^A5srkJE{TWAKecr%MB
zC0j0+Osa6=3S1_;^>`o9G(iAiN*z=+r`1I_oK!3qOQcj(I(lg_E7!93%R}%XyRVqh
zJBOxe;e#*!21MIV*fdS4<@5M$I-TPD`CUvV?F;ko>lC2s4c7C1>_n^vfQJtsqHSAT
zy?T{LM@O=^x7P=P{r!FZnk2l}HUsz>dkd%f3(w<A)GujS#QnL`t@cb$Vm4c3AiG(=
zvt-yxf;b0Xno20zbJgBVRWl4m90wf>!FqTw1_8hic6&G2?dw>uXB3jTM5u0@v?R`X
zWV}4Z2X8S(bKWB*Rgql0sHW<r4r=x3BihM?z6n{w-w9%jC-yyN5ZA!@h`3x<X>9;2
zl9rWoOIyV`N03;qmNJ=4WP5uDq3DeR)dL_K$ma7-uB~c<SpbP1viq!K&<s4YG5nat
zxwW;$Z@&3P-g@gTeEH><c<|tX?C<aM!Gi}fpU)v8I669#*G3iir(CR8rRn%n-s8^B
z78i?^XiV7MJx2g|^8GQYJ}*6cZUjLwm71GomM#>qVrY4m_Bzf8*2$UIao<=o0ePgC
zo1dBJ<10;;)5!$Rdr2_?nKH}Rb=IX7#Cg8+cW?3j{jY@{K59|l69)(HAb|H`W-7+O
zx}X7yTM0vG;JugGY=%Go`CkbDpMCak*~zoCEK*X0;HgT45F~^kP8?J<vv_DAU1{Qh
zP1E*cJTp55#7QY3gq&&A?5&z}m|5Sv9eGjy=+At2cNb5dJi+$%Hg<P+ad>zrHT}PI
z>C&sA3OsQAeJ-T&by@t+`@nzvt}q#~pImnBA#r{;kC_(prBsC(?}sLq1qxS1wNFe^
ziXbJ60_G{*y9y3Eg@q@xb(ktCC)0>j7J$T*2(Z@5PLpQCOMz=b$hCWyXY2rQ<;rFL
z^>1G*jWTH`XqzCVgo2qmz**Be2q3YGAi&9V3n8=;V-z#vU;c7i7K?c?(F92?JGqsT
z$sxwbCN$Z-r*!WGA~9wrv`9hl`MmR2>TTWCz4ryXFIX;@@ILg5J*9-%Y=+5Xf)E1Q
zwmntq6|fP^49CaEc>44y4h{~`G!440!xvwCaq6657V!4lZ`Z#;5_j+3{msAQ?uYJx
zl5MBtc^&xIY1d!(9><KvpK`qM#x}ikcw_He|9D&5QyTN=(0PZZ^=#X~ruAfL7{;WC
z(W)R`Wxc_B;b8L`3ZD%BHIYo3kzTw4)Ux<<mag<Zu*}ApR4u32RT9u~x;4dgI>lFC
z-Ix3KAIPMc;*B@<FrBs{;tNf-8hnD9w901#B!X|`+_`hIy}ixd-ScSMRwk2)oI7_;
z+BVnp`6u^C7K=H$uET6L<9t3ZtUO=so>825`_e3>*zf8^po6(tnD@T6ZBZ?{YvyHU
zc>MVBTCV<VHbaaNUDv^TkI7`xmw*7Ux3`DMWP;^#+5g<Rb4O}#;r8v@xO?|54h{}#
z3G-?MfcgcCG1j73UgyRCYaeyzug8-oGdXu|o6~8_ra8?X3qh>wI?<SNv&^0NF=oTA
z({9a!KwyKwRXqyKj8rq4LEF}=bI=fkP16#9#FVgDEYvy2A_C4XCYl+7^UTh@#FZ<T
zc<Is}#R;3X<=)<or4%J4<;9DCu>JiD1RyCXMI2Ofy}nqiPRuzoppUcJj30gU5o>Rt
z0&!NW6`nqQg6|$b!hAl1s=|`u-FN?<WCk9II9$Gbz}ak8sJOstwSxDaMZUlE1OnT(
zrHE8b0C?}Qv$KN>7cQJB0ZKa0!^1;-{`u#)bLS2Y4i4&La5|mx;NXDw?%l(+Yu9+~
z+BJUr?YDUJ=n?MSyN9-I8DoU^9=C4Yl9z!W@Pl8$z@{6UvVhmU{{J<O;mmw}x7wf}
zYagNS0?27hgDFpO<wl>CiGvGH*vQF<%LrM_Gm)}snxc&_qMAtNg{VmZ2fq1--BZ`*
z@#C4uP<T<qCT(+K!{t0o6<4lY>|x6Pd+!S;Du_wBy|p9D#gf;rU(fEzO@j~`q!f`-
z!Y7}6!cRZ_R6+>ox)tVg2b<=Hx_b2;e)ZS?lbABBVYyu5?YH0JxXT}7lCC=;f7bC{
zN=dx;2nC<9sWbn<2OsdW&pwm-8i&WNTeqa^I^4Q-ONOOD{XYQs@WT&Zn)Ts+=n3Q5
z>2ED*^tv8<d%MrPuu1jw;s=ni1>i8VlmX>wgY27)gSi>#1bG^f)o>^x*xNgwMKW^3
zAKrU;^zCC00QbLnC=b8;UX%%`OFXx;WdLwt?>u*QrZx<06+iLy*AL~(FaPH1cj%w~
z@jV_NKP4czef!@f*UQ_|G(o%%GMP+p^X5(Y_~Vax{rYvLl<=oN{R{v2$A9L3{>OjG
z|NQqoQL{dHzW3fg@N5b{N7DpOr)Sl8G80g^uFSi6^X92dt}gz%sE5DbxN(DR+xBat
i>pI-HapR?2DE|*TvSYzVE)fF&0000<MNUMnLSTa1<}$Vb


From 89d93ee56db5022b6caa860ab0715f3b9c5ec915 Mon Sep 17 00:00:00 2001
From: Mike Moody <amvmoody@gmail.com>
Date: Thu, 11 May 2017 04:16:22 -0700
Subject: [PATCH 045/135] Updated HMD grab Clone to work with all entity types.

---
 scripts/system/libraries/entitySelectionTool.js | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/scripts/system/libraries/entitySelectionTool.js b/scripts/system/libraries/entitySelectionTool.js
index 3e4b8d8518..3389ab0836 100644
--- a/scripts/system/libraries/entitySelectionTool.js
+++ b/scripts/system/libraries/entitySelectionTool.js
@@ -2162,6 +2162,12 @@ SelectionDisplay = (function() {
             position: FAR
         });
 
+        Overlays.editOverlay(grabberCloner, {
+            visible: true,
+            rotation: rotation,
+            position: EdgeTR
+        });
+
         var boxPosition = Vec3.multiplyQbyV(rotation, center);
         boxPosition = Vec3.sum(position, boxPosition);
         Overlays.editOverlay(selectionBox, {
@@ -2318,11 +2324,6 @@ SelectionDisplay = (function() {
             },
             rotation: Quat.fromPitchYawRollDegrees(90, 0, 0),
         });
-        Overlays.editOverlay(grabberCloner, {
-            visible: stretchHandlesVisible,
-            rotation: rotation,
-            position: RIGHT
-        });
 
     };
 

From a14fa5dab9f3da5942a8f1d08f263a5c909821dd Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Thu, 11 May 2017 10:54:15 -0700
Subject: [PATCH 046/135] code review feedback

---
 .../animation/src/AnimInverseKinematics.cpp      | 16 ++++++++--------
 libraries/animation/src/AnimUtil.cpp             |  7 +++----
 libraries/animation/src/Rig.cpp                  |  2 +-
 libraries/animation/src/Rig.h                    |  2 +-
 4 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 92c74b1793..5e6927afcb 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -734,21 +734,21 @@ void AnimInverseKinematics::initConstraints() {
             std::vector<glm::vec3> swungDirections;
             float deltaTheta = PI / 4.0f;
             float theta = 0.0f;
-            swungDirections.push_back(glm::vec3(cosf(theta), -0.25f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), -0.25f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), 0.0f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.0f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), 0.25f, sinf(theta))); // posterior
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.25f, sinf(theta))); // posterior
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), 0.0f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), 0.0f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), -0.25f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), -0.25f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), -0.5f, sinf(theta)));
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta))); // anterior
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), -0.5f, sinf(theta))); // anterior
             theta += deltaTheta;
-            swungDirections.push_back(glm::vec3(cosf(theta), -0.5f, sinf(theta)));
+            swungDirections.push_back(glm::vec3(mirror * cosf(theta), -0.5f, sinf(theta)));
 
             std::vector<float> minDots;
             for (size_t i = 0; i < swungDirections.size(); i++) {
diff --git a/libraries/animation/src/AnimUtil.cpp b/libraries/animation/src/AnimUtil.cpp
index 314f4a1c3a..a4659f1e76 100644
--- a/libraries/animation/src/AnimUtil.cpp
+++ b/libraries/animation/src/AnimUtil.cpp
@@ -37,16 +37,15 @@ glm::quat averageQuats(size_t numQuats, const glm::quat* quats) {
     if (numQuats == 0) {
         return glm::quat();
     }
-    float alpha = 1.0f / (float)numQuats;
-    glm::quat accum(0, 0, 0, 0);
+    glm::quat accum = quats[0];
     glm::quat firstRot = quats[0];
-    for (size_t i = 0; i < numQuats; i++) {
+    for (size_t i = 1; i < numQuats; i++) {
         glm::quat rot = quats[i];
         float dot = glm::dot(firstRot, rot);
         if (dot < 0.0f) {
             rot = -rot;
         }
-        accum += alpha * rot;
+        accum += rot;
     }
     return glm::normalize(accum);
 }
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index f933002c2c..cb5aebe930 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -941,7 +941,7 @@ void Rig::updateAnimationStateHandlers() { // called on avatar update thread (wh
     }
 }
 
-void Rig::updateAnimations(float deltaTime, glm::mat4 rootTransform, glm::mat4 rigToWorldTransform) {
+void Rig::updateAnimations(float deltaTime, const glm::mat4& rootTransform, const glm::mat4& rigToWorldTransform) {
 
     PROFILE_RANGE_EX(simulation_animation_detail, __FUNCTION__, 0xffff00ff, 0);
     PerformanceTimer perfTimer("updateAnimations");
diff --git a/libraries/animation/src/Rig.h b/libraries/animation/src/Rig.h
index bee6518557..33b66f91ea 100644
--- a/libraries/animation/src/Rig.h
+++ b/libraries/animation/src/Rig.h
@@ -162,7 +162,7 @@ public:
     void computeMotionAnimationState(float deltaTime, const glm::vec3& worldPosition, const glm::vec3& worldVelocity, const glm::quat& worldRotation, CharacterControllerState ccState);
 
     // Regardless of who started the animations or how many, update the joints.
-    void updateAnimations(float deltaTime, glm::mat4 rootTransform, glm::mat4 rigToWorldTransform);
+    void updateAnimations(float deltaTime, const glm::mat4& rootTransform, const glm::mat4& rigToWorldTransform);
 
     // legacy
     void inverseKinematics(int endIndex, glm::vec3 targetPosition, const glm::quat& targetRotation, float priority,

From 5d457eaa3951b9b19fa9762506f85fb9c3850756 Mon Sep 17 00:00:00 2001
From: Dante Ruiz <dante@highfidelity.io>
Date: Thu, 11 May 2017 20:44:08 +0100
Subject: [PATCH 047/135] better handling of when lost tracking of pucks

---
 plugins/openvr/src/ViveControllerManager.cpp | 30 ++++++++++++++++----
 plugins/openvr/src/ViveControllerManager.h   |  2 ++
 2 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/plugins/openvr/src/ViveControllerManager.cpp b/plugins/openvr/src/ViveControllerManager.cpp
index 6e5697730b..411cac3d2b 100644
--- a/plugins/openvr/src/ViveControllerManager.cpp
+++ b/plugins/openvr/src/ViveControllerManager.cpp
@@ -32,8 +32,6 @@
 
 #include <controllers/StandardControls.h>
 
-#include "OpenVrHelpers.h"
-
 extern PoseData _nextSimPoseData;
 
 vr::IVRSystem* acquireOpenVrSystem();
@@ -207,6 +205,7 @@ void ViveControllerManager::InputDevice::update(float deltaTime, const controlle
     }
 
     updateCalibratedLimbs();
+    _lastSimPoseData = _nextSimPoseData;
 }
 
 void ViveControllerManager::InputDevice::handleTrackedObject(uint32_t deviceIndex, const controller::InputCalibrationData& inputCalibrationData) {
@@ -217,11 +216,30 @@ void ViveControllerManager::InputDevice::handleTrackedObject(uint32_t deviceInde
         _nextSimPoseData.vrPoses[deviceIndex].bPoseIsValid &&
         poseIndex <= controller::TRACKED_OBJECT_15) {
 
-        // process pose
-        const mat4& mat = _nextSimPoseData.poses[deviceIndex];
-        const vec3 linearVelocity = _nextSimPoseData.linearVelocities[deviceIndex];
-        const vec3 angularVelocity = _nextSimPoseData.angularVelocities[deviceIndex];
+        mat4& mat = mat4();
+        vec3 linearVelocity = vec3();
+        vec3 angularVelocity = vec3();
+        // check if the device is tracking out of range, then process the correct pose depending on the result.
+        if (_nextSimPoseData.vrPoses[deviceIndex].eTrackingResult != vr::TrackingResult_Running_OutOfRange) { 
+            mat = _nextSimPoseData.poses[deviceIndex];
+            linearVelocity = _nextSimPoseData.linearVelocities[deviceIndex];
+            angularVelocity = _nextSimPoseData.angularVelocities[deviceIndex];
+        } else {
+            mat = _lastSimPoseData.poses[deviceIndex];
+            linearVelocity = _lastSimPoseData.linearVelocities[deviceIndex];
+            angularVelocity = _lastSimPoseData.angularVelocities[deviceIndex];
 
+            // make sure that we do not overwrite the pose in the _lastSimPose with incorrect data.
+            _nextSimPoseData.poses[deviceIndex] = _lastSimPoseData.poses[deviceIndex];
+            _nextSimPoseData.linearVelocities[deviceIndex] = _lastSimPoseData.linearVelocities[deviceIndex];
+            _nextSimPoseData.angularVelocities[deviceIndex] = _lastSimPoseData.angularVelocities[deviceIndex];
+            
+        }
+
+/*        const mat4& mat;
+        const vec3 linearVelocity;
+        const vec3 angularVelocity;*/
+            
         controller::Pose pose(extractTranslation(mat), glmExtractRotation(mat), linearVelocity, angularVelocity);
 
         // transform into avatar frame
diff --git a/plugins/openvr/src/ViveControllerManager.h b/plugins/openvr/src/ViveControllerManager.h
index 4e8b2b3a04..ca78fd0b37 100644
--- a/plugins/openvr/src/ViveControllerManager.h
+++ b/plugins/openvr/src/ViveControllerManager.h
@@ -25,6 +25,7 @@
 #include <plugins/InputPlugin.h>
 #include <RenderArgs.h>
 #include <render/Scene.h>
+#include "OpenVrHelpers.h"
 
 namespace vr {
     class IVRSystem;
@@ -108,6 +109,7 @@ private:
         std::vector<std::pair<uint32_t, controller::Pose>> _validTrackedObjects;
         std::map<uint32_t, glm::mat4> _pucksOffset;
         std::map<int, uint32_t> _jointToPuckMap;
+        PoseData _lastSimPoseData;
         // perform an action when the InputDevice mutex is acquired.
         using Locker = std::unique_lock<std::recursive_mutex>;
         template <typename F>

From f4df223d2337870dbb14177c9561d403c13432d5 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Tue, 9 May 2017 14:48:42 -0700
Subject: [PATCH 048/135] cleanup Head::simulation() code

---
 interface/src/avatar/MyHead.cpp               |  27 ++-
 .../src/avatars-renderer/Head.cpp             | 199 +++++++++---------
 .../src/avatars-renderer/Head.h               |   5 +-
 libraries/avatars/src/HeadData.cpp            |   6 -
 libraries/avatars/src/HeadData.h              |  14 +-
 5 files changed, 127 insertions(+), 124 deletions(-)

diff --git a/interface/src/avatar/MyHead.cpp b/interface/src/avatar/MyHead.cpp
index 34a75c5461..793fbb79c4 100644
--- a/interface/src/avatar/MyHead.cpp
+++ b/interface/src/avatar/MyHead.cpp
@@ -44,14 +44,17 @@ glm::quat MyHead::getCameraOrientation() const {
 void MyHead::simulate(float deltaTime) {
     auto player = DependencyManager::get<recording::Deck>();
     // Only use face trackers when not playing back a recording.
-    if (!player->isPlaying()) {
+    if (player->isPlaying()) {
+        Parent::simulate(deltaTime);
+    } else {
+        computeAudioLoudness(deltaTime);
+
         FaceTracker* faceTracker = qApp->getActiveFaceTracker();
-        _isFaceTrackerConnected = faceTracker != NULL && !faceTracker->isMuted();
+        _isFaceTrackerConnected = faceTracker && !faceTracker->isMuted();
         if (_isFaceTrackerConnected) {
             _transientBlendshapeCoefficients = faceTracker->getBlendshapeCoefficients();
 
             if (typeid(*faceTracker) == typeid(DdeFaceTracker)) {
-
                 if (Menu::getInstance()->isOptionChecked(MenuOption::UseAudioForMouth)) {
                     calculateMouthShapes(deltaTime);
 
@@ -68,9 +71,19 @@ void MyHead::simulate(float deltaTime) {
                 }
                 applyEyelidOffset(getFinalOrientationInWorldFrame());
             }
-        }
+        } else {
+            computeFaceMovement(deltaTime);
+		}
+
         auto eyeTracker = DependencyManager::get<EyeTracker>();
-        _isEyeTrackerConnected = eyeTracker->isTracking();
+        _isEyeTrackerConnected = eyeTracker && eyeTracker->isTracking();
+        if (_isEyeTrackerConnected) {
+            // TODO? figure out where EyeTracker data harvested. Move it here?
+            _saccade = glm::vec3();
+        } else {
+            computeEyeMovement(deltaTime);
+        }
+
     }
-    Parent::simulate(deltaTime);
-}
\ No newline at end of file
+    computeEyePosition();
+}
diff --git a/libraries/avatars-renderer/src/avatars-renderer/Head.cpp b/libraries/avatars-renderer/src/avatars-renderer/Head.cpp
index 93fe246266..b4b0929c0c 100644
--- a/libraries/avatars-renderer/src/avatars-renderer/Head.cpp
+++ b/libraries/avatars-renderer/src/avatars-renderer/Head.cpp
@@ -23,9 +23,10 @@
 
 #include "Avatar.h"
 
+const float NORMAL_HZ = 60.0f; // the update rate the constant values were tuned for
+
 using namespace std;
 
-static bool fixGaze { false };
 static bool disableEyelidAdjustment { false };
 
 Head::Head(Avatar* owningAvatar) :
@@ -42,17 +43,11 @@ void Head::reset() {
     _baseYaw = _basePitch = _baseRoll = 0.0f;
 }
 
-void Head::simulate(float deltaTime) {
-    const float NORMAL_HZ = 60.0f; // the update rate the constant values were tuned for
-
+void Head::computeAudioLoudness(float deltaTime) {
     // grab the audio loudness from the owning avatar, if we have one
-    float audioLoudness = 0.0f;
+    float audioLoudness = _owningAvatar ? _owningAvatar->getAudioLoudness() : 0.0f;
 
-    if (_owningAvatar) {
-        audioLoudness = _owningAvatar->getAudioLoudness();
-    }
-
-    //  Update audio trailing average for rendering facial animations
+    // Update audio trailing average for rendering facial animations
     const float AUDIO_AVERAGING_SECS = 0.05f;
     const float AUDIO_LONG_TERM_AVERAGING_SECS = 30.0f;
     _averageLoudness = glm::mix(_averageLoudness, audioLoudness, glm::min(deltaTime / AUDIO_AVERAGING_SECS, 1.0f));
@@ -63,116 +58,114 @@ void Head::simulate(float deltaTime) {
         _longTermAverageLoudness = glm::mix(_longTermAverageLoudness, _averageLoudness, glm::min(deltaTime / AUDIO_LONG_TERM_AVERAGING_SECS, 1.0f));
     }
 
-    if (!_isFaceTrackerConnected) {
-        if (!_isEyeTrackerConnected) {
-            // Update eye saccades
-            const float AVERAGE_MICROSACCADE_INTERVAL = 1.0f;
-            const float AVERAGE_SACCADE_INTERVAL = 6.0f;
-            const float MICROSACCADE_MAGNITUDE = 0.002f;
-            const float SACCADE_MAGNITUDE = 0.04f;
-            const float NOMINAL_FRAME_RATE = 60.0f;
+    float audioAttackAveragingRate = (10.0f - deltaTime * NORMAL_HZ) / 10.0f; // --> 0.9 at 60 Hz
+    _audioAttack = audioAttackAveragingRate * _audioAttack +
+        (1.0f - audioAttackAveragingRate) * fabs((audioLoudness - _longTermAverageLoudness) - _lastLoudness);
+    _lastLoudness = (audioLoudness - _longTermAverageLoudness);
+}
 
-            if (randFloat() < deltaTime / AVERAGE_MICROSACCADE_INTERVAL) {
-                _saccadeTarget = MICROSACCADE_MAGNITUDE * randVector();
-            } else if (randFloat() < deltaTime / AVERAGE_SACCADE_INTERVAL) {
-                _saccadeTarget = SACCADE_MAGNITUDE * randVector();
-            }
-            _saccade += (_saccadeTarget - _saccade) * pow(0.5f, NOMINAL_FRAME_RATE * deltaTime);
-        } else {
-            _saccade = glm::vec3();
-        }
+void Head::computeEyeMovement(float deltaTime) {
+    // Update eye saccades
+    const float AVERAGE_MICROSACCADE_INTERVAL = 1.0f;
+    const float AVERAGE_SACCADE_INTERVAL = 6.0f;
+    const float MICROSACCADE_MAGNITUDE = 0.002f;
+    const float SACCADE_MAGNITUDE = 0.04f;
+    const float NOMINAL_FRAME_RATE = 60.0f;
 
-        //  Detect transition from talking to not; force blink after that and a delay
-        bool forceBlink = false;
-        const float TALKING_LOUDNESS = 100.0f;
-        const float BLINK_AFTER_TALKING = 0.25f;
-        _timeWithoutTalking += deltaTime;
-        if ((_averageLoudness - _longTermAverageLoudness) > TALKING_LOUDNESS) {
-            _timeWithoutTalking = 0.0f;
-        } else if (_timeWithoutTalking - deltaTime < BLINK_AFTER_TALKING && _timeWithoutTalking >= BLINK_AFTER_TALKING) {
-            forceBlink = true;
-        }
+    if (randFloat() < deltaTime / AVERAGE_MICROSACCADE_INTERVAL) {
+        _saccadeTarget = MICROSACCADE_MAGNITUDE * randVector();
+    } else if (randFloat() < deltaTime / AVERAGE_SACCADE_INTERVAL) {
+        _saccadeTarget = SACCADE_MAGNITUDE * randVector();
+    }
+    _saccade += (_saccadeTarget - _saccade) * pow(0.5f, NOMINAL_FRAME_RATE * deltaTime);
 
-        //  Update audio attack data for facial animation (eyebrows and mouth)
-        float audioAttackAveragingRate = (10.0f - deltaTime * NORMAL_HZ) / 10.0f; // --> 0.9 at 60 Hz
-        _audioAttack = audioAttackAveragingRate * _audioAttack +
-            (1.0f - audioAttackAveragingRate) * fabs((audioLoudness - _longTermAverageLoudness) - _lastLoudness);
-        _lastLoudness = (audioLoudness - _longTermAverageLoudness);
+    // Detect transition from talking to not; force blink after that and a delay
+    bool forceBlink = false;
+    const float TALKING_LOUDNESS = 100.0f;
+    const float BLINK_AFTER_TALKING = 0.25f;
+    _timeWithoutTalking += deltaTime;
+    if ((_averageLoudness - _longTermAverageLoudness) > TALKING_LOUDNESS) {
+        _timeWithoutTalking = 0.0f;
+    } else if (_timeWithoutTalking - deltaTime < BLINK_AFTER_TALKING && _timeWithoutTalking >= BLINK_AFTER_TALKING) {
+        forceBlink = true;
+    }
 
-        const float BROW_LIFT_THRESHOLD = 100.0f;
-        if (_audioAttack > BROW_LIFT_THRESHOLD) {
-            _browAudioLift += sqrtf(_audioAttack) * 0.01f;
-        }
-        _browAudioLift = glm::clamp(_browAudioLift *= 0.7f, 0.0f, 1.0f);
-
-        const float BLINK_SPEED = 10.0f;
-        const float BLINK_SPEED_VARIABILITY = 1.0f;
-        const float BLINK_START_VARIABILITY = 0.25f;
-        const float FULLY_OPEN = 0.0f;
-        const float FULLY_CLOSED = 1.0f;
-        if (_leftEyeBlinkVelocity == 0.0f && _rightEyeBlinkVelocity == 0.0f) {
-            // no blinking when brows are raised; blink less with increasing loudness
-            const float BASE_BLINK_RATE = 15.0f / 60.0f;
-            const float ROOT_LOUDNESS_TO_BLINK_INTERVAL = 0.25f;
-            if (forceBlink || (_browAudioLift < EPSILON && shouldDo(glm::max(1.0f, sqrt(fabs(_averageLoudness - _longTermAverageLoudness)) *
-                    ROOT_LOUDNESS_TO_BLINK_INTERVAL) / BASE_BLINK_RATE, deltaTime))) {
-                _leftEyeBlinkVelocity = BLINK_SPEED + randFloat() * BLINK_SPEED_VARIABILITY;
-                _rightEyeBlinkVelocity = BLINK_SPEED + randFloat() * BLINK_SPEED_VARIABILITY;
-                if (randFloat() < 0.5f) {
-                    _leftEyeBlink = BLINK_START_VARIABILITY;
-                } else {
-                    _rightEyeBlink = BLINK_START_VARIABILITY;
-                }
-            }
-        } else {
-            _leftEyeBlink = glm::clamp(_leftEyeBlink + _leftEyeBlinkVelocity * deltaTime, FULLY_OPEN, FULLY_CLOSED);
-            _rightEyeBlink = glm::clamp(_rightEyeBlink + _rightEyeBlinkVelocity * deltaTime, FULLY_OPEN, FULLY_CLOSED);
-
-            if (_leftEyeBlink == FULLY_CLOSED) {
-                _leftEyeBlinkVelocity = -BLINK_SPEED;
-
-            } else if (_leftEyeBlink == FULLY_OPEN) {
-                _leftEyeBlinkVelocity = 0.0f;
-            }
-            if (_rightEyeBlink == FULLY_CLOSED) {
-                _rightEyeBlinkVelocity = -BLINK_SPEED;
-
-            } else if (_rightEyeBlink == FULLY_OPEN) {
-                _rightEyeBlinkVelocity = 0.0f;
+    const float BLINK_SPEED = 10.0f;
+    const float BLINK_SPEED_VARIABILITY = 1.0f;
+    const float BLINK_START_VARIABILITY = 0.25f;
+    const float FULLY_OPEN = 0.0f;
+    const float FULLY_CLOSED = 1.0f;
+    if (_leftEyeBlinkVelocity == 0.0f && _rightEyeBlinkVelocity == 0.0f) {
+        // no blinking when brows are raised; blink less with increasing loudness
+        const float BASE_BLINK_RATE = 15.0f / 60.0f;
+        const float ROOT_LOUDNESS_TO_BLINK_INTERVAL = 0.25f;
+        if (forceBlink || (_browAudioLift < EPSILON && shouldDo(glm::max(1.0f, sqrt(fabs(_averageLoudness - _longTermAverageLoudness)) *
+                ROOT_LOUDNESS_TO_BLINK_INTERVAL) / BASE_BLINK_RATE, deltaTime))) {
+            _leftEyeBlinkVelocity = BLINK_SPEED + randFloat() * BLINK_SPEED_VARIABILITY;
+            _rightEyeBlinkVelocity = BLINK_SPEED + randFloat() * BLINK_SPEED_VARIABILITY;
+            if (randFloat() < 0.5f) {
+                _leftEyeBlink = BLINK_START_VARIABILITY;
+            } else {
+                _rightEyeBlink = BLINK_START_VARIABILITY;
             }
         }
-
-        // use data to update fake Faceshift blendshape coefficients
-        calculateMouthShapes(deltaTime);
-        FaceTracker::updateFakeCoefficients(_leftEyeBlink,
-                                            _rightEyeBlink,
-                                            _browAudioLift,
-                                            _audioJawOpen,
-                                            _mouth2,
-                                            _mouth3,
-                                            _mouth4,
-                                            _transientBlendshapeCoefficients);
-
-        applyEyelidOffset(getOrientation());
-
     } else {
-        _saccade = glm::vec3();
-    }
-    if (fixGaze) { // if debug menu turns off, use no saccade
-        _saccade = glm::vec3();
+        _leftEyeBlink = glm::clamp(_leftEyeBlink + _leftEyeBlinkVelocity * deltaTime, FULLY_OPEN, FULLY_CLOSED);
+        _rightEyeBlink = glm::clamp(_rightEyeBlink + _rightEyeBlinkVelocity * deltaTime, FULLY_OPEN, FULLY_CLOSED);
+
+        if (_leftEyeBlink == FULLY_CLOSED) {
+            _leftEyeBlinkVelocity = -BLINK_SPEED;
+
+        } else if (_leftEyeBlink == FULLY_OPEN) {
+            _leftEyeBlinkVelocity = 0.0f;
+        }
+        if (_rightEyeBlink == FULLY_CLOSED) {
+            _rightEyeBlinkVelocity = -BLINK_SPEED;
+
+        } else if (_rightEyeBlink == FULLY_OPEN) {
+            _rightEyeBlinkVelocity = 0.0f;
+        }
     }
 
+    applyEyelidOffset(getOrientation());
+}
+
+void Head::computeFaceMovement(float deltaTime) {
+    // Update audio attack data for facial animation (eyebrows and mouth)
+    const float BROW_LIFT_THRESHOLD = 100.0f;
+    if (_audioAttack > BROW_LIFT_THRESHOLD) {
+        _browAudioLift += sqrtf(_audioAttack) * 0.01f;
+    }
+    _browAudioLift = glm::clamp(_browAudioLift *= 0.7f, 0.0f, 1.0f);
+
+    // use data to update fake Faceshift blendshape coefficients
+    calculateMouthShapes(deltaTime);
+    FaceTracker::updateFakeCoefficients(_leftEyeBlink,
+                                        _rightEyeBlink,
+                                        _browAudioLift,
+                                        _audioJawOpen,
+                                        _mouth2,
+                                        _mouth3,
+                                        _mouth4,
+                                        _transientBlendshapeCoefficients);
+}
+
+void Head::computeEyePosition() {
     _leftEyePosition = _rightEyePosition = getPosition();
-    _eyePosition = getPosition();
-
     if (_owningAvatar) {
         auto skeletonModel = static_cast<Avatar*>(_owningAvatar)->getSkeletonModel();
         if (skeletonModel) {
             skeletonModel->getEyePositions(_leftEyePosition, _rightEyePosition);
         }
     }
+    _eyePosition = 0.5f * (_leftEyePosition + _rightEyePosition);
+}
 
-    _eyePosition = calculateAverageEyePosition();
+void Head::simulate(float deltaTime) {
+    computeAudioLoudness(deltaTime);
+    computeFaceMovement(deltaTime);
+    computeEyeMovement(deltaTime);
+    computeEyePosition();
 }
 
 void Head::calculateMouthShapes(float deltaTime) {
diff --git a/libraries/avatars-renderer/src/avatars-renderer/Head.h b/libraries/avatars-renderer/src/avatars-renderer/Head.h
index aea6a41528..39331500b5 100644
--- a/libraries/avatars-renderer/src/avatars-renderer/Head.h
+++ b/libraries/avatars-renderer/src/avatars-renderer/Head.h
@@ -83,7 +83,10 @@ public:
     float getTimeWithoutTalking() const { return _timeWithoutTalking; }
 
 protected:
-    glm::vec3 calculateAverageEyePosition() const { return _leftEyePosition + (_rightEyePosition - _leftEyePosition ) * 0.5f; }
+    void computeAudioLoudness(float deltaTime);
+    void computeEyeMovement(float deltaTime);
+    void computeFaceMovement(float deltaTime);
+    void computeEyePosition();
 
     // disallow copies of the Head, copy of owning Avatar is disallowed too
     Head(const Head&);
diff --git a/libraries/avatars/src/HeadData.cpp b/libraries/avatars/src/HeadData.cpp
index 2e4eec73a8..2704b6539c 100644
--- a/libraries/avatars/src/HeadData.cpp
+++ b/libraries/avatars/src/HeadData.cpp
@@ -28,12 +28,6 @@ HeadData::HeadData(AvatarData* owningAvatar) :
     _basePitch(0.0f),
     _baseRoll(0.0f),
     _lookAtPosition(0.0f, 0.0f, 0.0f),
-    _isFaceTrackerConnected(false),
-    _isEyeTrackerConnected(false),
-    _leftEyeBlink(0.0f),
-    _rightEyeBlink(0.0f),
-    _averageLoudness(0.0f),
-    _browAudioLift(0.0f),
     _blendshapeCoefficients(QVector<float>(0, 0.0f)),
     _transientBlendshapeCoefficients(QVector<float>(0, 0.0f)),
     _summedBlendshapeCoefficients(QVector<float>(0, 0.0f)),
diff --git a/libraries/avatars/src/HeadData.h b/libraries/avatars/src/HeadData.h
index 9b28616b3f..be9d54e93e 100644
--- a/libraries/avatars/src/HeadData.h
+++ b/libraries/avatars/src/HeadData.h
@@ -63,7 +63,7 @@ public:
     void setBlendshapeCoefficients(const QVector<float>& blendshapeCoefficients) { _blendshapeCoefficients = blendshapeCoefficients; }
 
     const glm::vec3& getLookAtPosition() const { return _lookAtPosition; }
-    void setLookAtPosition(const glm::vec3& lookAtPosition) { 
+    void setLookAtPosition(const glm::vec3& lookAtPosition) {
         if (_lookAtPosition != lookAtPosition) {
             _lookAtPositionChanged = usecTimestampNow();
         }
@@ -85,12 +85,12 @@ protected:
     glm::vec3 _lookAtPosition;
     quint64 _lookAtPositionChanged { 0 };
 
-    bool _isFaceTrackerConnected;
-    bool _isEyeTrackerConnected;
-    float _leftEyeBlink;
-    float _rightEyeBlink;
-    float _averageLoudness;
-    float _browAudioLift;
+    bool _isFaceTrackerConnected { false };
+    bool _isEyeTrackerConnected { false };
+    float _leftEyeBlink { 0.0f };
+    float _rightEyeBlink { 0.0f };
+    float _averageLoudness { 0.0f };
+    float _browAudioLift { 0.0f };
 
     QVector<float> _blendshapeCoefficients;
     QVector<float> _transientBlendshapeCoefficients;

From 04827c3a2a39544cdddda68d0bde52d9beb2a512 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Thu, 11 May 2017 14:51:52 -0700
Subject: [PATCH 049/135] use const auto& where appropritate

---
 libraries/avatars/src/AvatarData.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 51b69711dc..e2188478ed 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -445,7 +445,7 @@ QByteArray AvatarData::toByteArray(AvatarDataDetail dataDetail, quint64 lastSent
     if (hasFaceTrackerInfo) {
         auto startSection = destinationBuffer;
         auto faceTrackerInfo = reinterpret_cast<AvatarDataPacket::FaceTrackerInfo*>(destinationBuffer);
-        auto blendshapeCoefficients = _headData->getSummedBlendshapeCoefficients();
+        const auto& blendshapeCoefficients = _headData->getSummedBlendshapeCoefficients();
 
         faceTrackerInfo->leftEyeBlink = _headData->_leftEyeBlink;
         faceTrackerInfo->rightEyeBlink = _headData->_rightEyeBlink;

From a43447310df5174942bc864bd1ed8333568ae2a9 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Thu, 11 May 2017 15:22:22 -0700
Subject: [PATCH 050/135] remove physics dependency from avatars-render lib

---
 interface/src/avatar/AvatarManager.h                            | 2 +-
 .../src/avatar}/AvatarMotionState.cpp                           | 0
 .../src/avatar}/AvatarMotionState.h                             | 2 +-
 libraries/avatars-renderer/CMakeLists.txt                       | 2 +-
 4 files changed, 3 insertions(+), 3 deletions(-)
 rename {libraries/avatars-renderer/src/avatars-renderer => interface/src/avatar}/AvatarMotionState.cpp (100%)
 rename {libraries/avatars-renderer/src/avatars-renderer => interface/src/avatar}/AvatarMotionState.h (98%)

diff --git a/interface/src/avatar/AvatarManager.h b/interface/src/avatar/AvatarManager.h
index 9df1639853..f1e71f7367 100644
--- a/interface/src/avatar/AvatarManager.h
+++ b/interface/src/avatar/AvatarManager.h
@@ -21,9 +21,9 @@
 #include <PIDController.h>
 #include <SimpleMovingAverage.h>
 #include <shared/RateCounter.h>
-#include <avatars-renderer/AvatarMotionState.h>
 #include <avatars-renderer/ScriptAvatar.h>
 
+#include "AvatarMotionState.h"
 #include "MyAvatar.h"
 
 class AudioInjector;
diff --git a/libraries/avatars-renderer/src/avatars-renderer/AvatarMotionState.cpp b/interface/src/avatar/AvatarMotionState.cpp
similarity index 100%
rename from libraries/avatars-renderer/src/avatars-renderer/AvatarMotionState.cpp
rename to interface/src/avatar/AvatarMotionState.cpp
diff --git a/libraries/avatars-renderer/src/avatars-renderer/AvatarMotionState.h b/interface/src/avatar/AvatarMotionState.h
similarity index 98%
rename from libraries/avatars-renderer/src/avatars-renderer/AvatarMotionState.h
rename to interface/src/avatar/AvatarMotionState.h
index f8801ddf2f..90bd2a60ac 100644
--- a/libraries/avatars-renderer/src/avatars-renderer/AvatarMotionState.h
+++ b/interface/src/avatar/AvatarMotionState.h
@@ -14,10 +14,10 @@
 
 #include <QSet>
 
+#include <avatars-renderer/Avatar.h>
 #include <ObjectMotionState.h>
 #include <BulletUtil.h>
 
-#include "Avatar.h"
 
 class AvatarMotionState : public ObjectMotionState {
 public:
diff --git a/libraries/avatars-renderer/CMakeLists.txt b/libraries/avatars-renderer/CMakeLists.txt
index b13bc0a4a6..2ac5e6766d 100644
--- a/libraries/avatars-renderer/CMakeLists.txt
+++ b/libraries/avatars-renderer/CMakeLists.txt
@@ -1,6 +1,6 @@
 set(TARGET_NAME avatars-renderer)
 AUTOSCRIBE_SHADER_LIB(gpu model render render-utils)
 setup_hifi_library(Widgets Network Script)
-link_hifi_libraries(shared gpu model animation physics model-networking script-engine render image render-utils)
+link_hifi_libraries(shared gpu model animation model-networking script-engine render image render-utils)
 
 target_bullet()

From 5042d4d3129b667992769f5dbd62699a608241d4 Mon Sep 17 00:00:00 2001
From: Dante Ruiz <dante@highfidelity.io>
Date: Fri, 12 May 2017 00:28:31 +0100
Subject: [PATCH 051/135] add print when device changes tracking result

---
 plugins/openvr/src/ViveControllerManager.cpp | 41 ++++++++++++++++----
 plugins/openvr/src/ViveControllerManager.h   |  1 +
 2 files changed, 34 insertions(+), 8 deletions(-)

diff --git a/plugins/openvr/src/ViveControllerManager.cpp b/plugins/openvr/src/ViveControllerManager.cpp
index 606cc38da2..a5b742c32c 100644
--- a/plugins/openvr/src/ViveControllerManager.cpp
+++ b/plugins/openvr/src/ViveControllerManager.cpp
@@ -29,7 +29,6 @@
 #include <glm/ext.hpp>
 #include <glm/gtc/quaternion.hpp>
 
-
 #include <controllers/UserInputMapper.h>
 
 #include <controllers/StandardControls.h>
@@ -67,6 +66,28 @@ static bool sortPucksYPosition(std::pair<uint32_t, controller::Pose> firstPuck,
     return (firstPuck.second.translation.y < firstPuck.second.translation.y);
 }
 
+static QString deviceTrackingResultToString(vr::ETrackingResult trackingResult) {
+    QString result;
+    switch (trackingResult) {
+        case vr::TrackingResult_Uninitialized:
+            result = "vr::TrackingResult_Uninitialized";
+            break;
+        case vr::TrackingResult_Calibrating_InProgress:
+            result = "vr::TrackingResult_Calibrating_InProgess";
+            break;
+        case vr::TrackingResult_Calibrating_OutOfRange:
+            result = "vr::TrackingResult_Calibrating_OutOfRange";
+            break;
+        case vr::TrackingResult_Running_OK:
+            result = "vr::TrackingResult_Running_OK";
+            break;
+        case vr::TrackingResult_Running_OutOfRange:
+            result = "vr::TrackingResult_Running_OutOfRange";
+            break;
+    }
+    return result;
+}
+
 bool ViveControllerManager::isSupported() const {
     return openVrSupported();
 }
@@ -212,7 +233,7 @@ void ViveControllerManager::InputDevice::update(float deltaTime, const controlle
 
 void ViveControllerManager::InputDevice::handleTrackedObject(uint32_t deviceIndex, const controller::InputCalibrationData& inputCalibrationData) {
     uint32_t poseIndex = controller::TRACKED_OBJECT_00 + deviceIndex;
-
+    printDeviceTrackingResultChange(deviceIndex);
     if (_system->IsTrackedDeviceConnected(deviceIndex) &&
         _system->GetTrackedDeviceClass(deviceIndex) == vr::TrackedDeviceClass_GenericTracker &&
         _nextSimPoseData.vrPoses[deviceIndex].bPoseIsValid &&
@@ -222,7 +243,7 @@ void ViveControllerManager::InputDevice::handleTrackedObject(uint32_t deviceInde
         vec3 linearVelocity = vec3();
         vec3 angularVelocity = vec3();
         // check if the device is tracking out of range, then process the correct pose depending on the result.
-        if (_nextSimPoseData.vrPoses[deviceIndex].eTrackingResult != vr::TrackingResult_Running_OutOfRange) { 
+        if (_nextSimPoseData.vrPoses[deviceIndex].eTrackingResult != vr::TrackingResult_Running_OutOfRange) {
             mat = _nextSimPoseData.poses[deviceIndex];
             linearVelocity = _nextSimPoseData.linearVelocities[deviceIndex];
             angularVelocity = _nextSimPoseData.angularVelocities[deviceIndex];
@@ -235,13 +256,9 @@ void ViveControllerManager::InputDevice::handleTrackedObject(uint32_t deviceInde
             _nextSimPoseData.poses[deviceIndex] = _lastSimPoseData.poses[deviceIndex];
             _nextSimPoseData.linearVelocities[deviceIndex] = _lastSimPoseData.linearVelocities[deviceIndex];
             _nextSimPoseData.angularVelocities[deviceIndex] = _lastSimPoseData.angularVelocities[deviceIndex];
-            
+
         }
 
-/*        const mat4& mat;
-        const vec3 linearVelocity;
-        const vec3 angularVelocity;*/
-            
         controller::Pose pose(extractTranslation(mat), glmExtractRotation(mat), linearVelocity, angularVelocity);
 
         // transform into avatar frame
@@ -466,6 +483,14 @@ enum ViveButtonChannel {
     RIGHT_APP_MENU
 };
 
+void ViveControllerManager::InputDevice::printDeviceTrackingResultChange(uint32_t deviceIndex) {
+    if (_nextSimPoseData.vrPoses[deviceIndex].eTrackingResult != _lastSimPoseData.vrPoses[deviceIndex].eTrackingResult) {
+        qDebug() << "OpenVR: Device" << deviceIndex << "Tracking Result changed from" <<
+            deviceTrackingResultToString(_lastSimPoseData.vrPoses[deviceIndex].eTrackingResult)
+                 << "to" << deviceTrackingResultToString(_nextSimPoseData.vrPoses[deviceIndex].eTrackingResult);
+    }
+}
+
 bool ViveControllerManager::InputDevice::checkForCalibrationEvent() {
     auto& endOfMap = _buttonPressedMap.end();
     auto& leftTrigger = _buttonPressedMap.find(controller::LT);
diff --git a/plugins/openvr/src/ViveControllerManager.h b/plugins/openvr/src/ViveControllerManager.h
index 30680ec264..c815506770 100644
--- a/plugins/openvr/src/ViveControllerManager.h
+++ b/plugins/openvr/src/ViveControllerManager.h
@@ -77,6 +77,7 @@ private:
         void handleHeadPoseEvent(const controller::InputCalibrationData& inputCalibrationData, const mat4& mat, const vec3& linearVelocity,
                                  const vec3& angularVelocity);
         void partitionTouchpad(int sButton, int xAxis, int yAxis, int centerPsuedoButton, int xPseudoButton, int yPseudoButton);
+        void printDeviceTrackingResultChange(uint32_t deviceIndex);
 
         class FilteredStick {
         public:

From f74e29e4b0f0546780082571e8819c84c7035ea6 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Fri, 12 May 2017 11:43:12 +1200
Subject: [PATCH 052/135] Code review

---
 scripts/system/playRecordingAC.js | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index 6c7a5eb8b1..8351d6f5e1 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -368,16 +368,21 @@
         };
     }());
 
-    function sendHeartbeat(isOneShot) {
+    function sendHeartbeat() {
         Messages.sendMessage(HIFI_RECORDER_CHANNEL, JSON.stringify({
             playing: Player.isPlaying(),
             recording: Player.recording(),
             entity: Entity.id()
         }));
+    }
 
-        if (!isOneShot) {
-            heartbeatTimer = Script.setTimeout(sendHeartbeat, HEARTBEAT_INTERVAL);
-        }
+    function onHeartbeatTimer() {
+        sendHeartbeat();
+        heartbeatTimer = Script.setTimeout(onHeartbeatTimer, HEARTBEAT_INTERVAL);
+    }
+
+    function startHeartbeat() {
+        onHeartbeatTimer();
     }
 
     function stopHeartbeat() {
@@ -401,12 +406,12 @@
                 } else {
                     log("Didn't start playing " + message.recording + " because already playing " + Player.recording());
                 }
-                sendHeartbeat(true);
+                sendHeartbeat();
                 break;
             case PLAYER_COMMAND_STOP:
                 Player.stop();
                 Player.autoPlay();  // There may be another recording to play.
-                sendHeartbeat(true);
+                sendHeartbeat();
                 break;
             }
         }
@@ -421,7 +426,7 @@
         Messages.subscribe(HIFI_PLAYER_CHANNEL);
 
         Player.autoPlay();
-        sendHeartbeat();
+        startHeartbeat();
 
         UserActivityLogger.logAction("playRecordingAC_script_load");
     }

From d7a4396daaf7010152c509a97b65c350c837cd09 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Fri, 12 May 2017 11:45:11 +1200
Subject: [PATCH 053/135] Improve log messages

---
 scripts/system/playRecordingAC.js | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index 8351d6f5e1..e738c01d32 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -83,7 +83,7 @@
             // Create a new persistence entity (even if already have one but that should never occur).
             var properties;
 
-            log("Create recording " + filename);
+            log("Create recording entity for " + filename);
 
             if (updateTimestampTimer !== null) {
                 Script.clearInterval(updateTimestampTimer);  // Just in case.
@@ -114,6 +114,7 @@
                 return true;
             }
 
+            log("Could not create recording entity for " + filename);
             return false;
         }
 
@@ -269,12 +270,12 @@
 
         function play(recording, position, orientation) {
             if (Entity.create(recording, position, orientation)) {
-                log("Play new recording " + recordingFilename);
+                log("Play recording " + recordingFilename);
                 isPlayingRecording = true;
                 recordingFilename = recording;
                 playRecording(recordingFilename, position, orientation);
             } else {
-                log("Could not create entity to play new recording " + recordingFilename);
+                log("Could not play recording " + recordingFilename);
             }
         }
 

From a4406906f3d25d34aac707e0c3bdd4540649802b Mon Sep 17 00:00:00 2001
From: hiflex <hiflex@users.noreply.github.com>
Date: Thu, 11 May 2017 20:12:10 -0500
Subject: [PATCH 054/135] Fix the Face Camera checkbox on the text entity
 properties tab.

The checkbox appeared unchecked even if the underlying property was true.
---
 scripts/system/html/js/entityProperties.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/system/html/js/entityProperties.js b/scripts/system/html/js/entityProperties.js
index 2f109597d7..e000e14aec 100644
--- a/scripts/system/html/js/entityProperties.js
+++ b/scripts/system/html/js/entityProperties.js
@@ -1020,7 +1020,7 @@ function loaded() {
 
                             elTextText.value = properties.text;
                             elTextLineHeight.value = properties.lineHeight.toFixed(4);
-                            elTextFaceCamera = properties.faceCamera;
+                            elTextFaceCamera.checked = properties.faceCamera;
                             elTextTextColor.style.backgroundColor = "rgb(" + properties.textColor.red + "," + properties.textColor.green + "," + properties.textColor.blue + ")";
                             elTextTextColorRed.value = properties.textColor.red;
                             elTextTextColorGreen.value = properties.textColor.green;

From 26672b475ff280bee0b32b13fa75238cf00a1ba9 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Fri, 12 May 2017 14:13:32 +1200
Subject: [PATCH 055/135] Clear timer value when timer stopped

---
 scripts/system/playRecordingAC.js | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index e738c01d32..cc4c0345a9 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -85,8 +85,9 @@
 
             log("Create recording entity for " + filename);
 
-            if (updateTimestampTimer !== null) {
-                Script.clearInterval(updateTimestampTimer);  // Just in case.
+            if (updateTimestampTimer !== null) {  // Just in case.
+                Script.clearInterval(updateTimestampTimer);
+                updateTimestampTimer = null;
             }
 
             searchState = SEARCH_IDLE;
@@ -234,6 +235,7 @@
             }
             if (updateTimestampTimer !== null) {  // Just in case.
                 Script.clearInterval(updateTimestampTimer);
+                updateTimestampTimer = null;
             }
         }
 

From 42aacb07ff4b0e4aaa2dacd671f68ef79ce2877e Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Fri, 12 May 2017 14:14:24 +1200
Subject: [PATCH 056/135] Remove check that recording has started playing

---
 scripts/system/record.js | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/scripts/system/record.js b/scripts/system/record.js
index 4d5427c874..f9936942fb 100644
--- a/scripts/system/record.js
+++ b/scripts/system/record.js
@@ -277,7 +277,6 @@
             playerIsPlayings = [],      // True if AC player script is playing a recording.
             playerRecordings = [],      // Assignment client mappings of recordings being played.
             playerTimestamps = [],      // Timestamps of last heartbeat update from player script.
-            playerStartupTimeouts = [], // Timers that check that recording has started playing.
 
             updateTimer,
             UPDATE_INTERVAL = 5000;  // Must be > player's HEARTBEAT_INTERVAL.
@@ -298,7 +297,6 @@
                     playerIsPlayings.splice(i, 1);
                     playerRecordings.splice(i, 1);
                     playerTimestamps.splice(i, 1);
-                    playerStartupTimeouts.splice(i, 1);
                 }
             }
 
@@ -309,8 +307,7 @@
         }
 
         function playRecording(recording, position, orientation) {
-            var index,
-                CHECK_PLAYING_TIMEOUT = 10000;
+            var index;
 
             // Optional function parameters.
             if (position === undefined) {
@@ -334,26 +331,9 @@
                 position: position,
                 orientation: orientation
             }));
-
-            playerStartupTimeouts[index] = Script.setTimeout(function () {
-                if ((!playerIsPlayings[index] || playerRecordings[index] !== recording) && playerStartupTimeouts[index]) {
-                    error("Didn't start playing recording "
-                        + recording.slice(4) + "!");  // Remove leading "atp:" from recording.
-                }
-                playerStartupTimeouts[index] = null;
-            }, CHECK_PLAYING_TIMEOUT);
         }
 
         function stopPlayingRecording(playerID) {
-            var index;
-
-            // Cancel check that recording started playing.
-            index = playerIDs.indexOf(playerID);
-            if (index !== -1 && playerStartupTimeouts[index] !== null) {
-                Script.clearTimeout(playerStartupTimeouts[index]);
-                playerStartupTimeouts[index] = null;
-            }
-
             Messages.sendMessage(HIFI_PLAYER_CHANNEL, JSON.stringify({
                 player: playerID,
                 command: PLAYER_COMMAND_STOP
@@ -374,7 +354,6 @@
             if (index === -1) {
                 index = playerIDs.length;
                 playerIDs[index] = sender;
-                playerStartupTimeouts[index] = null;
             }
             playerIsPlayings[index] = message.playing;
             playerRecordings[index] = message.recording;
@@ -387,7 +366,6 @@
             playerIsPlayings = [];
             playerRecordings = [];
             playerTimestamps = [];
-            playerStartupTimeouts = [];
             Dialog.updatePlayerDetails(playerIsPlayings, playerRecordings, playerIDs);
         }
 

From acd71caae273b973dc64b66072bb4afa3aae9efc Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Fri, 12 May 2017 14:53:38 +1200
Subject: [PATCH 057/135] Inform user when an AC error prevents a recording
 from playing

---
 scripts/system/playRecordingAC.js | 37 +++++++++++++++++++++++--------
 scripts/system/record.js          | 21 +++++++++++-------
 2 files changed, 41 insertions(+), 17 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index cc4c0345a9..5dab0c2ba0 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -14,6 +14,7 @@
 
     var APP_NAME = "PLAYBACK",
         HIFI_RECORDER_CHANNEL = "HiFi-Recorder-Channel",
+        RECORDER_COMMAND_ERROR = "error",
         HIFI_PLAYER_CHANNEL = "HiFi-Player-Channel",
         PLAYER_COMMAND_PLAY = "play",
         PLAYER_COMMAND_STOP = "stop",
@@ -69,12 +70,14 @@
 
             if (sender !== scriptUUID) {
                 message = JSON.parse(message);
-                index = otherPlayersPlaying.indexOf(message.entity);
-                if (index !== -1) {
-                    otherPlayersPlayingCounts[index] += 1;
-                } else {
-                    otherPlayersPlaying.push(message.entity);
-                    otherPlayersPlayingCounts.push(1);
+                if (message.playing !== undefined) {
+                    index = otherPlayersPlaying.indexOf(message.entity);
+                    if (index !== -1) {
+                        otherPlayersPlayingCounts[index] += 1;
+                    } else {
+                        otherPlayersPlaying.push(message.entity);
+                        otherPlayersPlayingCounts.push(1);
+                    }
                 }
             }
         }
@@ -270,14 +273,26 @@
 
             playRecording;
 
+        function error(message) {
+            // Send error message to user.
+            Messages.sendMessage(HIFI_RECORDER_CHANNEL, JSON.stringify({
+                command: RECORDER_COMMAND_ERROR,
+                message: message
+            }));
+        }
+
         function play(recording, position, orientation) {
+            var errorMessage;
+
             if (Entity.create(recording, position, orientation)) {
-                log("Play recording " + recordingFilename);
+                log("Play recording " + recording);
                 isPlayingRecording = true;
                 recordingFilename = recording;
                 playRecording(recordingFilename, position, orientation);
             } else {
-                log("Could not play recording " + recordingFilename);
+                errorMessage = "Could not play recording " + recording.slice(4);  // Remove leading "atp:".
+                log(errorMessage);
+                error(errorMessage);
             }
         }
 
@@ -299,6 +314,8 @@
 
         playRecording = function (recording, position, orientation) {
             Recording.loadRecording(recording, function (success) {
+                var errorMessage;
+
                 if (success) {
                     Users.disableIgnoreRadius();
 
@@ -321,7 +338,9 @@
 
                     UserActivityLogger.logAction("playRecordingAC_play_recording");
                 } else {
-                    log("Failed to load recording " + recording);
+                    errorMessage = "Could not load recording " + recording.slice(4);  // Remove leading "atp:".
+                    log(errorMessage);
+                    error(errorMessage);
                     autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_ERROR_INTERVAL);  // Try again later.
                 }
             });
diff --git a/scripts/system/record.js b/scripts/system/record.js
index f9936942fb..1c36a122b9 100644
--- a/scripts/system/record.js
+++ b/scripts/system/record.js
@@ -269,6 +269,7 @@
 
     Player = (function () {
         var HIFI_RECORDER_CHANNEL = "HiFi-Recorder-Channel",
+            RECORDER_COMMAND_ERROR = "error",
             HIFI_PLAYER_CHANNEL = "HiFi-Player-Channel",
             PLAYER_COMMAND_PLAY = "play",
             PLAYER_COMMAND_STOP = "stop",
@@ -350,15 +351,19 @@
 
             message = JSON.parse(message);
 
-            index = playerIDs.indexOf(sender);
-            if (index === -1) {
-                index = playerIDs.length;
-                playerIDs[index] = sender;
+            if (message.command === RECORDER_COMMAND_ERROR) {
+                error(message.message);
+            } else {
+                index = playerIDs.indexOf(sender);
+                if (index === -1) {
+                    index = playerIDs.length;
+                    playerIDs[index] = sender;
+                }
+                playerIsPlayings[index] = message.playing;
+                playerRecordings[index] = message.recording;
+                playerTimestamps[index] = Date.now();
+                Dialog.updatePlayerDetails(playerIsPlayings, playerRecordings, playerIDs);
             }
-            playerIsPlayings[index] = message.playing;
-            playerRecordings[index] = message.recording;
-            playerTimestamps[index] = Date.now();
-            Dialog.updatePlayerDetails(playerIsPlayings, playerRecordings, playerIDs);
         }
 
         function reset() {

From 2bed69cfea194ec1315861b458ad7f9d20518730 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Fri, 12 May 2017 15:18:25 +1200
Subject: [PATCH 058/135] Display playback errors only for user that initiated
 playback

---
 scripts/system/playRecordingAC.js | 11 ++++++++---
 scripts/system/record.js          |  4 +++-
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index 5dab0c2ba0..4cf65c7942 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -267,7 +267,8 @@
 
     Player = (function () {
         // Recording playback functions.
-        var isPlayingRecording = false,
+        var userID = null,
+            isPlayingRecording = false,
             recordingFilename = "",
             autoPlayTimer = null,
 
@@ -277,13 +278,16 @@
             // Send error message to user.
             Messages.sendMessage(HIFI_RECORDER_CHANNEL, JSON.stringify({
                 command: RECORDER_COMMAND_ERROR,
+                user: userID,
                 message: message
             }));
         }
 
-        function play(recording, position, orientation) {
+        function play(user, recording, position, orientation) {
             var errorMessage;
 
+            userID = user;
+
             if (Entity.create(recording, position, orientation)) {
                 log("Play recording " + recording);
                 isPlayingRecording = true;
@@ -305,6 +309,7 @@
                 recording = Entity.find();
                 if (recording) {
                     log("Play persisted recording " + recordingFilename);
+                    userID = null;
                     playRecording(recording.recording, recording.position, recording.orientation);
                 } else {
                     autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_SEARCH_INTERVAL);  // Try again soon.
@@ -424,7 +429,7 @@
             switch (message.command) {
             case PLAYER_COMMAND_PLAY:
                 if (!Player.isPlaying()) {
-                    Player.play(message.recording, message.position, message.orientation);
+                    Player.play(sender, message.recording, message.position, message.orientation);
                 } else {
                     log("Didn't start playing " + message.recording + " because already playing " + Player.recording());
                 }
diff --git a/scripts/system/record.js b/scripts/system/record.js
index 1c36a122b9..d5195d19cc 100644
--- a/scripts/system/record.js
+++ b/scripts/system/record.js
@@ -352,7 +352,9 @@
             message = JSON.parse(message);
 
             if (message.command === RECORDER_COMMAND_ERROR) {
-                error(message.message);
+                if (message.user === MyAvatar.sessionUUID) {
+                    error(message.message);
+                }
             } else {
                 index = playerIDs.indexOf(sender);
                 if (index === -1) {

From a12e8e34dbd5833b8013cfbcfbeac267a32538e1 Mon Sep 17 00:00:00 2001
From: Rob Kayson <rkayson@gmail.com>
Date: Fri, 12 May 2017 15:06:22 -0700
Subject: [PATCH 059/135] coding standard

---
 scripts/tutorials/createFloatingLanternBox.js |   7 +-
 .../entity_scripts/floatingLantern.js         | 168 +++++++++---------
 .../entity_scripts/floatingLanternBox.js      |  20 ++-
 3 files changed, 99 insertions(+), 96 deletions(-)

diff --git a/scripts/tutorials/createFloatingLanternBox.js b/scripts/tutorials/createFloatingLanternBox.js
index 611e995fcb..a925cfff22 100644
--- a/scripts/tutorials/createFloatingLanternBox.js
+++ b/scripts/tutorials/createFloatingLanternBox.js
@@ -19,6 +19,7 @@ var SCRIPT_URL = Script.resolvePath("./entity_scripts/floatingLanternBox.js?v="
 var START_POSITION = Vec3.sum(MyAvatar.position, Vec3.multiply(Quat.getFront(MyAvatar.orientation), 2));
 START_POSITION.y -= .6;
 var LIFETIME = 3600;
+var SCALE_FACTOR = 1;
 
 var lanternBox = {
   type: "Model",
@@ -31,9 +32,9 @@ var lanternBox = {
   position: START_POSITION,
   lifetime: LIFETIME,
   dimensions: {
-    x: 0.8696,
-    y: 0.58531,
-    z: 0.9264
+    x: 0.8696 * SCALE_FACTOR,
+    y: 0.58531 * SCALE_FACTOR,
+    z: 0.9264 * SCALE_FACTOR
   },
   owningAvatarID: MyAvatar.sessionUUID
 };
diff --git a/scripts/tutorials/entity_scripts/floatingLantern.js b/scripts/tutorials/entity_scripts/floatingLantern.js
index 8fa2828c90..aa25dc0003 100644
--- a/scripts/tutorials/entity_scripts/floatingLantern.js
+++ b/scripts/tutorials/entity_scripts/floatingLantern.js
@@ -14,93 +14,93 @@
 // See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
 
 (function() {
-  var _this;
+    var _this;
 
-  var SLOW_SPIN_THRESHOLD = 0.1;
-  var ROTATION_COMPLETE_THRESHOLD = 0.01;
-  var ROTATION_SPEED = 0.2;
-  var HOME_ROTATION = {x: 0, y: 0, z: 0, w: 0};
+    var SLOW_SPIN_THRESHOLD = 0.1;
+    var ROTATION_COMPLETE_THRESHOLD = 0.01;
+    var ROTATION_SPEED = 0.2;
+    var HOME_ROTATION = {x: 0, y: 0, z: 0, w: 0};
 
 
-  floatingLantern = function() {
-    _this = this;
-    this.updateConnected = false;
-  };
-
-  floatingLantern.prototype = {
-
-    preload: function(entityID) {
-      this.entityID = entityID;
-    },
-
-    unload: function(entityID) {
-      this.disconnectUpdate();
-    },
-
-    startNearGrab: function() {
-      this.disconnectUpdate();
-    },
-
-    startDistantGrab: function() {
-      this.disconnectUpdate();
-    },
-
-    releaseGrab: function() {
-      Entities.editEntity(this.entityID, {
-        gravity: {
-          x: 0,
-          y: 0.5,
-          z: 0
-        }
-      });
-    },
-
-    update: function(dt) {
-      var lanternProps = Entities.getEntityProperties(_this.entityID);
-
-      if(lanternProps && lanternProps.rotation && lanternProps.owningAvatarID === MyAvatar.sessionUUID) {
-
-        var spinningSlowly = (
-          Math.abs(lanternProps.angularVelocity.x) < SLOW_SPIN_THRESHOLD &&
-          Math.abs(lanternProps.angularVelocity.y) < SLOW_SPIN_THRESHOLD &&
-          Math.abs(lanternProps.angularVelocity.z) < SLOW_SPIN_THRESHOLD
-        );
-
-        var rotationComplete = (
-           Math.abs(lanternProps.rotation.x - HOME_ROTATION.x) < ROTATION_COMPLETE_THRESHOLD &&
-           Math.abs(lanternProps.rotation.y - HOME_ROTATION.y) < ROTATION_COMPLETE_THRESHOLD &&
-           Math.abs(lanternProps.rotation.z - HOME_ROTATION.z) < ROTATION_COMPLETE_THRESHOLD
-         );
-
-        if(spinningSlowly && !rotationComplete) {
-          var newRotation = Quat.slerp(lanternProps.rotation, HOME_ROTATION, ROTATION_SPEED * dt);
-
-          Entities.editEntity(_this.entityID, {
-            rotation: newRotation,
-            angularVelocity: {
-              x: 0,
-              y: 0,
-              z: 0
-            }
-          });
-        }
-      }
-    },
-
-    connectUpdate: function() {
-      if(!this.updateConnected) {
-        this.updateConnected = true;
-        Script.update.connect(this.update);
-      }
-    },
-
-    disconnectUpdate: function() {
-      if(this.updateConnected) {
+    floatingLantern = function() {
+        _this = this;
         this.updateConnected = false;
-        Script.update.disconnect(this.update);
-      }
-    }
-  };
+    };
 
-  return new floatingLantern();
+    floatingLantern.prototype = {
+
+        preload: function(entityID) {
+            this.entityID = entityID;
+        },
+
+        unload: function(entityID) {
+            this.disconnectUpdate();
+        },
+
+        startNearGrab: function() {
+            this.disconnectUpdate();
+        },
+
+        startDistantGrab: function() {
+            this.disconnectUpdate();
+        },
+
+        releaseGrab: function() {
+            Entities.editEntity(this.entityID, {
+                gravity: {
+                    x: 0,
+                    y: 0.5,
+                    z: 0
+                }
+            });
+        },
+
+        update: function(dt) {
+            var lanternProps = Entities.getEntityProperties(_this.entityID);
+
+            if (lanternProps && lanternProps.rotation && lanternProps.owningAvatarID === MyAvatar.sessionUUID) {
+
+                var spinningSlowly = (
+                    Math.abs(lanternProps.angularVelocity.x) < SLOW_SPIN_THRESHOLD &&
+                    Math.abs(lanternProps.angularVelocity.y) < SLOW_SPIN_THRESHOLD &&
+                    Math.abs(lanternProps.angularVelocity.z) < SLOW_SPIN_THRESHOLD
+                );
+
+                var rotationComplete = (
+                    Math.abs(lanternProps.rotation.x - HOME_ROTATION.x) < ROTATION_COMPLETE_THRESHOLD &&
+                    Math.abs(lanternProps.rotation.y - HOME_ROTATION.y) < ROTATION_COMPLETE_THRESHOLD &&
+                    Math.abs(lanternProps.rotation.z - HOME_ROTATION.z) < ROTATION_COMPLETE_THRESHOLD
+                );
+
+                if (spinningSlowly && !rotationComplete) {
+                    var newRotation = Quat.slerp(lanternProps.rotation, HOME_ROTATION, ROTATION_SPEED * dt);
+
+                    Entities.editEntity(_this.entityID, {
+                        rotation: newRotation,
+                        angularVelocity: {
+                            x: 0,
+                            y: 0,
+                            z: 0
+                        }
+                    });
+                }
+            }
+        },
+
+        connectUpdate: function() {
+            if (!this.updateConnected) {
+                this.updateConnected = true;
+                Script.update.connect(this.update);
+            }
+        },
+
+        disconnectUpdate: function() {
+            if (this.updateConnected) {
+                this.updateConnected = false;
+                Script.update.disconnect(this.update);
+            }
+        }
+    };
+
+    return new floatingLantern();
 });
diff --git a/scripts/tutorials/entity_scripts/floatingLanternBox.js b/scripts/tutorials/entity_scripts/floatingLanternBox.js
index 2c483f6129..ba44fbaa9d 100644
--- a/scripts/tutorials/entity_scripts/floatingLanternBox.js
+++ b/scripts/tutorials/entity_scripts/floatingLanternBox.js
@@ -21,6 +21,7 @@
   var LIFETIME = 120;
   var RESPAWN_INTERVAL = 1000;
   var MAX_LANTERNS = 4;
+  var SCALE_FACTOR = 1;
 
   var LANTERN = {
       type: "Model",
@@ -29,9 +30,9 @@
       modelURL: LANTERN_MODEL_URL,
       script: LANTERN_SCRIPT_URL,
       dimensions: {
-          x: 0.2049,
-          y: 0.4,
-          z: 0.2049
+          x: 0.2049 * SCALE_FACTOR,
+          y: 0.4 * SCALE_FACTOR,
+          z: 0.2049 * SCALE_FACTOR
       },
       gravity: {
           x: 0,
@@ -57,14 +58,15 @@
       this.entityID = entityID;
       var props = Entities.getEntityProperties(this.entityID);
 
-      if(props.owningAvatarID === MyAvatar.sessionUUID){
+      if (props.owningAvatarID === MyAvatar.sessionUUID) {
         this.respawnTimer = Script.setInterval(this.spawnAllLanterns.bind(this), RESPAWN_INTERVAL);
       }
     },
 
     unload: function(entityID) {
-      if(this.respawnTimer)
-        Script.clearInterval(this.respawnTimer);
+      if (this.respawnTimer) {
+          Script.clearInterval(this.respawnTimer);
+      }
     },
 
     spawnAllLanterns: function() {
@@ -72,14 +74,14 @@
       var lanternCount = 0;
       var nearbyEntities = Entities.findEntities(props.position, props.dimensions.x * 0.75);
 
-      for(var i = 0; i < nearbyEntities.length; i++) {
+      for (var i = 0; i < nearbyEntities.length; i++) {
         var name = Entities.getEntityProperties(nearbyEntities[i], ["name"]).name;
-        if(name === "Floating Lantern") {
+        if (name === "Floating Lantern") {
           lanternCount++;
         }
       }
 
-      while(lanternCount++ < MAX_LANTERNS) {
+      while (lanternCount++ < MAX_LANTERNS) {
         this.spawnLantern();
       }
     },

From f3d8d1641f62b36365671dcf8f085bbfc97aa40e Mon Sep 17 00:00:00 2001
From: Rob Kayson <rkayson@gmail.com>
Date: Fri, 12 May 2017 15:10:40 -0700
Subject: [PATCH 060/135] fix indent createFloatingLanternBox.js

---
 scripts/tutorials/createFloatingLanternBox.js | 30 +++++++++----------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/scripts/tutorials/createFloatingLanternBox.js b/scripts/tutorials/createFloatingLanternBox.js
index a925cfff22..c84214e295 100644
--- a/scripts/tutorials/createFloatingLanternBox.js
+++ b/scripts/tutorials/createFloatingLanternBox.js
@@ -22,21 +22,21 @@ var LIFETIME = 3600;
 var SCALE_FACTOR = 1;
 
 var lanternBox = {
-  type: "Model",
-  name: "Floating Lantern Box",
-  description: "Spawns Lanterns that float away when grabbed and released!",
-  script: SCRIPT_URL,
-  modelURL: MODEL_URL,
-  shapeType: "Compound",
-  compoundShapeURL: COMPOUND_SHAPE_URL,
-  position: START_POSITION,
-  lifetime: LIFETIME,
-  dimensions: {
-    x: 0.8696 * SCALE_FACTOR,
-    y: 0.58531 * SCALE_FACTOR,
-    z: 0.9264 * SCALE_FACTOR
-  },
-  owningAvatarID: MyAvatar.sessionUUID
+    type: "Model",
+    name: "Floating Lantern Box",
+    description: "Spawns Lanterns that float away when grabbed and released!",
+    script: SCRIPT_URL,
+    modelURL: MODEL_URL,
+    shapeType: "Compound",
+    compoundShapeURL: COMPOUND_SHAPE_URL,
+    position: START_POSITION,
+    lifetime: LIFETIME,
+    dimensions: {
+        x: 0.8696 * SCALE_FACTOR,
+        y: 0.58531 * SCALE_FACTOR,
+        z: 0.9264 * SCALE_FACTOR
+    },
+    owningAvatarID: MyAvatar.sessionUUID
 };
 
 Entities.addEntity(lanternBox);

From 9fc0ad0d28dc79aa258e82f7c9af0229163570a6 Mon Sep 17 00:00:00 2001
From: Rob Kayson <rkayson@gmail.com>
Date: Fri, 12 May 2017 15:12:43 -0700
Subject: [PATCH 061/135] fix indent floatingLanternBox

---
 .../entity_scripts/floatingLanternBox.js      | 150 +++++++++---------
 1 file changed, 75 insertions(+), 75 deletions(-)

diff --git a/scripts/tutorials/entity_scripts/floatingLanternBox.js b/scripts/tutorials/entity_scripts/floatingLanternBox.js
index ba44fbaa9d..b5fb0c27d9 100644
--- a/scripts/tutorials/entity_scripts/floatingLanternBox.js
+++ b/scripts/tutorials/entity_scripts/floatingLanternBox.js
@@ -15,89 +15,89 @@
 
 (function() {
 
-  var _this;
-  var LANTERN_MODEL_URL = "http://hifi-content.s3.amazonaws.com/DomainContent/Welcome%20Area/Models/chinaLantern_capsule.fbx";
-  var LANTERN_SCRIPT_URL = Script.resolvePath("floatingLantern.js?v=" + Date.now());
-  var LIFETIME = 120;
-  var RESPAWN_INTERVAL = 1000;
-  var MAX_LANTERNS = 4;
-  var SCALE_FACTOR = 1;
+    var _this;
+    var LANTERN_MODEL_URL = "http://hifi-content.s3.amazonaws.com/DomainContent/Welcome%20Area/Models/chinaLantern_capsule.fbx";
+    var LANTERN_SCRIPT_URL = Script.resolvePath("floatingLantern.js?v=" + Date.now());
+    var LIFETIME = 120;
+    var RESPAWN_INTERVAL = 1000;
+    var MAX_LANTERNS = 4;
+    var SCALE_FACTOR = 1;
 
-  var LANTERN = {
-      type: "Model",
-      name: "Floating Lantern",
-      description: "Spawns Lanterns that float away when grabbed and released!",
-      modelURL: LANTERN_MODEL_URL,
-      script: LANTERN_SCRIPT_URL,
-      dimensions: {
-          x: 0.2049 * SCALE_FACTOR,
-          y: 0.4 * SCALE_FACTOR,
-          z: 0.2049 * SCALE_FACTOR
-      },
-      gravity: {
-          x: 0,
-          y: -1,
-          z: 0
-      },
-      velocity: {
-        x: 0, y: .01, z: 0
-      },
-      linearDampening: 0,
-      shapeType: 'Box',
-      lifetime: LIFETIME,
-      dynamic: true
-  };
+    var LANTERN = {
+        type: "Model",
+        name: "Floating Lantern",
+        description: "Spawns Lanterns that float away when grabbed and released!",
+        modelURL: LANTERN_MODEL_URL,
+        script: LANTERN_SCRIPT_URL,
+        dimensions: {
+            x: 0.2049 * SCALE_FACTOR,
+            y: 0.4 * SCALE_FACTOR,
+            z: 0.2049 * SCALE_FACTOR
+        },
+        gravity: {
+            x: 0,
+            y: -1,
+            z: 0
+        },
+        velocity: {
+            x: 0, y: .01, z: 0
+        },
+        linearDampening: 0,
+        shapeType: 'Box',
+        lifetime: LIFETIME,
+        dynamic: true
+    };
 
-  lanternBox = function() {
-    _this = this;
-  };
+    lanternBox = function() {
+        _this = this;
+    };
 
-  lanternBox.prototype = {
+    lanternBox.prototype = {
 
-    preload: function(entityID) {
-      this.entityID = entityID;
-      var props = Entities.getEntityProperties(this.entityID);
+        preload: function(entityID) {
+            this.entityID = entityID;
+            var props = Entities.getEntityProperties(this.entityID);
 
-      if (props.owningAvatarID === MyAvatar.sessionUUID) {
-        this.respawnTimer = Script.setInterval(this.spawnAllLanterns.bind(this), RESPAWN_INTERVAL);
-      }
-    },
+            if (props.owningAvatarID === MyAvatar.sessionUUID) {
+                this.respawnTimer = Script.setInterval(this.spawnAllLanterns.bind(this), RESPAWN_INTERVAL);
+            }
+        },
 
-    unload: function(entityID) {
-      if (this.respawnTimer) {
-          Script.clearInterval(this.respawnTimer);
-      }
-    },
+        unload: function(entityID) {
+            if (this.respawnTimer) {
+                Script.clearInterval(this.respawnTimer);
+            }
+        },
 
-    spawnAllLanterns: function() {
-      var props = Entities.getEntityProperties(this.entityID);
-      var lanternCount = 0;
-      var nearbyEntities = Entities.findEntities(props.position, props.dimensions.x * 0.75);
+        spawnAllLanterns: function() {
+            var props = Entities.getEntityProperties(this.entityID);
+            var lanternCount = 0;
+            var nearbyEntities = Entities.findEntities(props.position, props.dimensions.x * 0.75);
 
-      for (var i = 0; i < nearbyEntities.length; i++) {
-        var name = Entities.getEntityProperties(nearbyEntities[i], ["name"]).name;
-        if (name === "Floating Lantern") {
-          lanternCount++;
+            for (var i = 0; i < nearbyEntities.length; i++) {
+                var name = Entities.getEntityProperties(nearbyEntities[i], ["name"]).name;
+                if (name === "Floating Lantern") {
+                    lanternCount++;
+                }
+            }
+
+            while (lanternCount++ < MAX_LANTERNS) {
+                this.spawnLantern();
+            }
+        },
+
+        spawnLantern: function() {
+            var boxProps = Entities.getEntityProperties(this.entityID);
+
+            LANTERN.position = boxProps.position;
+            LANTERN.position.x += Math.random() * .2 - .1;
+            LANTERN.position.y += Math.random() * .2 + .1;
+            LANTERN.position.z += Math.random() * .2 - .1;
+            LANTERN.owningAvatarID = boxProps.owningAvatarID;
+
+            return Entities.addEntity(LANTERN);
         }
-      }
+    };
 
-      while (lanternCount++ < MAX_LANTERNS) {
-        this.spawnLantern();
-      }
-    },
-
-    spawnLantern: function() {
-      var boxProps = Entities.getEntityProperties(this.entityID);
-
-      LANTERN.position = boxProps.position;
-      LANTERN.position.x += Math.random() * .2 - .1;
-      LANTERN.position.y += Math.random() * .2 + .1;
-      LANTERN.position.z += Math.random() * .2 - .1;
-      LANTERN.owningAvatarID = boxProps.owningAvatarID;
-
-      return Entities.addEntity(LANTERN);
-    }
-  };
-
-  return new lanternBox();
+    return new lanternBox();
 });

From e6020e0137ae2e9abd0d1b88c235efc62002b498 Mon Sep 17 00:00:00 2001
From: Dante Ruiz <dante@highfidelity.io>
Date: Sat, 13 May 2017 00:40:07 +0100
Subject: [PATCH 062/135] added lookup table for tracking result and configs

---
 plugins/openvr/src/ViveControllerManager.cpp | 59 ++++++++------------
 plugins/openvr/src/ViveControllerManager.h   |  3 +-
 2 files changed, 25 insertions(+), 37 deletions(-)

diff --git a/plugins/openvr/src/ViveControllerManager.cpp b/plugins/openvr/src/ViveControllerManager.cpp
index ccc843b5cc..5e22272dd6 100644
--- a/plugins/openvr/src/ViveControllerManager.cpp
+++ b/plugins/openvr/src/ViveControllerManager.cpp
@@ -56,6 +56,14 @@ static const int CHEST = 3;
 
 const char* ViveControllerManager::NAME { "OpenVR" };
 
+const std::map<vr::ETrackingResult, QString> TRACKING_RESULT_TO_STRING = {
+    {vr::TrackingResult_Uninitialized, QString("vr::TrackingResult_Uninitialized")},
+    {vr::TrackingResult_Calibrating_InProgress, QString("vr::TrackingResult_Calibrating_InProgess")},
+    {vr::TrackingResult_Calibrating_OutOfRange, QString("TrackingResult_Calibrating_OutOfRange")},
+    {vr::TrackingResult_Running_OK, QString("TrackingResult_Running_Ok")},
+    {vr::TrackingResult_Running_OutOfRange, QString("TrackingResult_Running_OutOfRange")}
+};
+
 static glm::mat4 computeOffset(glm::mat4 defaultToReferenceMat, glm::mat4 defaultJointMat, controller::Pose puckPose) {
     glm::mat4 poseMat = createMatFromQuatAndPos(puckPose.rotation, puckPose.translation);
     glm::mat4 referenceJointMat = defaultToReferenceMat * defaultJointMat;
@@ -68,22 +76,10 @@ static bool sortPucksYPosition(std::pair<uint32_t, controller::Pose> firstPuck,
 
 static QString deviceTrackingResultToString(vr::ETrackingResult trackingResult) {
     QString result;
-    switch (trackingResult) {
-        case vr::TrackingResult_Uninitialized:
-            result = "vr::TrackingResult_Uninitialized";
-            break;
-        case vr::TrackingResult_Calibrating_InProgress:
-            result = "vr::TrackingResult_Calibrating_InProgess";
-            break;
-        case vr::TrackingResult_Calibrating_OutOfRange:
-            result = "vr::TrackingResult_Calibrating_OutOfRange";
-            break;
-        case vr::TrackingResult_Running_OK:
-            result = "vr::TrackingResult_Running_OK";
-            break;
-        case vr::TrackingResult_Running_OutOfRange:
-            result = "vr::TrackingResult_Running_OutOfRange";
-            break;
+    auto iterator = TRACKING_RESULT_TO_STRING.find(trackingResult);
+
+    if (iterator != TRACKING_RESULT_TO_STRING.end()) {
+        return iterator->second;
     }
     return result;
 }
@@ -166,6 +162,15 @@ void ViveControllerManager::pluginUpdate(float deltaTime, const controller::Inpu
     }
 }
 
+ViveControllerManager::InputDevice::InputDevice(vr::IVRSystem*& system) : controller::InputDevice("Vive"), _system(system) {
+    createPreferences();
+
+    _configStringMap[Config::Auto] =  QString("Auto");
+    _configStringMap[Config::Feet] =  QString("Feet");
+    _configStringMap[Config::FeetAndHips] =  QString("FeetAndHips");
+    _configStringMap[Config::FeetHipsAndChest] =  QString("FeetHipsAndChest");
+}
+
 void ViveControllerManager::InputDevice::update(float deltaTime, const controller::InputCalibrationData& inputCalibrationData) {
     _poseStateMap.clear();
     _buttonPressedMap.clear();
@@ -626,25 +631,7 @@ void ViveControllerManager::InputDevice::saveSettings() const {
 }
 
 QString ViveControllerManager::InputDevice::configToString(Config config) {
-    QString currentConfig;
-    switch (config) {
-        case Config::Auto:
-            currentConfig = "Auto";
-            break;
-
-        case Config::Feet:
-            currentConfig = "Feet";
-            break;
-
-        case Config::FeetAndHips:
-            currentConfig = "FeetAndHips";
-            break;
-
-        case Config::FeetHipsAndChest:
-            currentConfig = "FeetHipsAndChest";
-            break;
-    }
-    return currentConfig;
+    return _configStringMap[config];
 }
 
 void ViveControllerManager::InputDevice::setConfigFromString(const QString& value) {
@@ -665,7 +652,7 @@ void ViveControllerManager::InputDevice::createPreferences() {
     static const QString VIVE_PUCKS_CONFIG = "Vive Pucks Configuration";
 
     {
-        auto getter = [this]()->QString { return configToString(_preferedConfig); };
+        auto getter = [this]()->QString { return _configStringMap[_preferedConfig]; };
         auto setter = [this](const QString& value) { setConfigFromString(value); saveSettings(); };
         auto preference = new ComboBoxPreference(VIVE_PUCKS_CONFIG, "Configuration", getter, setter);
         QStringList list = (QStringList() << "Auto" << "Feet" << "FeetAndHips" << "FeetHipsAndChest");
diff --git a/plugins/openvr/src/ViveControllerManager.h b/plugins/openvr/src/ViveControllerManager.h
index d7ab77ddbc..fa2566da45 100644
--- a/plugins/openvr/src/ViveControllerManager.h
+++ b/plugins/openvr/src/ViveControllerManager.h
@@ -51,7 +51,7 @@ public:
 private:
     class InputDevice : public controller::InputDevice {
     public:
-        InputDevice(vr::IVRSystem*& system) : controller::InputDevice("Vive"), _system(system) { createPreferences(); }
+        InputDevice(vr::IVRSystem*& system);
     private:
         // Device functions
         controller::Input::NamedVector getAvailableInputs() const override;
@@ -111,6 +111,7 @@ private:
         std::vector<std::pair<uint32_t, controller::Pose>> _validTrackedObjects;
         std::map<uint32_t, glm::mat4> _pucksOffset;
         std::map<int, uint32_t> _jointToPuckMap;
+        std::map<Config, QString> _configStringMap;
         PoseData _lastSimPoseData;
         // perform an action when the InputDevice mutex is acquired.
         using Locker = std::unique_lock<std::recursive_mutex>;

From 6d7e98274b0a18d8ca62d8cccc54cac29ed4c884 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Fri, 12 May 2017 17:07:00 -0700
Subject: [PATCH 063/135] revert debug change

---
 interface/src/Application.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/interface/src/Application.cpp b/interface/src/Application.cpp
index ded6d6b628..f4699009ac 100644
--- a/interface/src/Application.cpp
+++ b/interface/src/Application.cpp
@@ -336,7 +336,7 @@ public:
 
                 // Don't actually crash in debug builds, in case this apparent deadlock is simply from
                 // the developer actively debugging code
-                #if 0 //def NDEBUG
+                #ifdef NDEBUG
                     deadlockDetectionCrash();
                 #endif
             }

From eb3b27849c74e111e16cc831bfade32553c563aa Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Fri, 12 May 2017 17:07:47 -0700
Subject: [PATCH 064/135] only keep one copy of Triangles

---
 libraries/render-utils/src/Model.cpp |   2 -
 libraries/shared/src/TriangleSet.cpp | 153 ++++++++++++++++-----------
 libraries/shared/src/TriangleSet.h   |  61 +++++++----
 3 files changed, 132 insertions(+), 84 deletions(-)

diff --git a/libraries/render-utils/src/Model.cpp b/libraries/render-utils/src/Model.cpp
index 2c338674eb..9af1c6802e 100644
--- a/libraries/render-utils/src/Model.cpp
+++ b/libraries/render-utils/src/Model.cpp
@@ -462,8 +462,6 @@ bool Model::convexHullContains(glm::vec3 point) {
 void Model::calculateTriangleSets() {
     PROFILE_RANGE(render, __FUNCTION__);
 
-    qDebug() << __FUNCTION__ << "url:" << _url;
-
     const FBXGeometry& geometry = getFBXGeometry();
     int numberOfMeshes = geometry.meshes.size();
 
diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index e13d8b126f..ef8f3ab91e 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -13,6 +13,22 @@
 #include "TriangleSet.h"
 
 
+void TriangleSet::insert(const Triangle& t) {
+    _isBalanced = false;
+
+    _triangles.push_back(t);
+    _bounds += t.v0;
+    _bounds += t.v1;
+    _bounds += t.v2;
+}
+
+void TriangleSet::clear() {
+    _triangles.clear();
+    _bounds.clear();
+    _isBalanced = false;
+
+    // delete the octree?
+}
 
 bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
     float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision) {
@@ -27,53 +43,7 @@ bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3&
     return result;
 }
 
-void InternalTriangleSet::insert(const Triangle& t) {
-    _triangles.push_back(t);
-
-    _bounds += t.v0;
-    _bounds += t.v1;
-    _bounds += t.v2;
-}
-
-void InternalTriangleSet::clear() {
-    _triangles.clear();
-    _bounds.clear();
-}
-
-// Determine of the given ray (origin/direction) in model space intersects with any triangles
-// in the set. If an intersection occurs, the distance and surface normal will be provided.
-bool InternalTriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
-            float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
-
-    bool intersectedSomething = false;
-    float boxDistance = std::numeric_limits<float>::max();
-    float bestDistance = std::numeric_limits<float>::max();
-
-    if (_bounds.findRayIntersection(origin, direction, boxDistance, face, surfaceNormal)) {
-        if (precision) {
-            for (const auto& triangle : _triangles) {
-                float thisTriangleDistance;
-                trianglesTouched++;
-                if (findRayTriangleIntersection(origin, direction, triangle, thisTriangleDistance)) {
-                    if (thisTriangleDistance < bestDistance) {
-                        bestDistance = thisTriangleDistance;
-                        intersectedSomething = true;
-                        surfaceNormal = triangle.getNormal();
-                        distance = bestDistance;
-                    }
-                }
-            }
-        } else {
-            intersectedSomething = true;
-            distance = boxDistance;
-        }
-    }
-
-    return intersectedSomething;
-}
-
-
-bool InternalTriangleSet::convexHullContains(const glm::vec3& point) const {
+bool TriangleSet::convexHullContains(const glm::vec3& point) const {
     if (!_bounds.contains(point)) {
         return false;
     }
@@ -100,16 +70,76 @@ void TriangleSet::debugDump() {
 
 void TriangleSet::balanceOctree() {
     _triangleOctree.reset(_bounds, 0);
-    for (const auto& triangle : _triangles) {
-        _triangleOctree.insert(triangle);
+
+    // insert all the triangles
+
+    for (int i = 0; i < _triangles.size(); i++) {
+        _triangleOctree.insert(i);
     }
+
+    // prune the empty cells
+    _triangleOctree.prune();
+
     _isBalanced = true;
 }
 
+
+
+void InternalTriangleSet::insert(int triangleIndex) {
+    auto& triangle = _allTriangles[triangleIndex];
+
+    _triangleIndices.push_back(triangleIndex);
+
+    _bounds += triangle.v0;
+    _bounds += triangle.v1;
+    _bounds += triangle.v2;
+}
+
+void InternalTriangleSet::clear() {
+    _triangleIndices.clear();
+    _bounds.clear();
+}
+
+// Determine of the given ray (origin/direction) in model space intersects with any triangles
+// in the set. If an intersection occurs, the distance and surface normal will be provided.
+bool InternalTriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+            float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
+
+    bool intersectedSomething = false;
+    float boxDistance = std::numeric_limits<float>::max();
+    float bestDistance = std::numeric_limits<float>::max();
+
+    if (_bounds.findRayIntersection(origin, direction, boxDistance, face, surfaceNormal)) {
+        if (precision) {
+            for (const auto& triangleIndex : _triangleIndices) {
+                const auto& triangle = _allTriangles[triangleIndex];
+                float thisTriangleDistance;
+                trianglesTouched++;
+                if (findRayTriangleIntersection(origin, direction, triangle, thisTriangleDistance)) {
+                    if (thisTriangleDistance < bestDistance) {
+                        bestDistance = thisTriangleDistance;
+                        intersectedSomething = true;
+                        surfaceNormal = triangle.getNormal();
+                        distance = bestDistance;
+                    }
+                }
+            }
+        } else {
+            intersectedSomething = true;
+            distance = boxDistance;
+        }
+    }
+
+    return intersectedSomething;
+}
+
 static const int MAX_DEPTH = 3; // for now
 static const int MAX_CHILDREN = 8;
 
-TriangleOctreeCell::TriangleOctreeCell(const AABox& bounds, int depth) {
+TriangleOctreeCell::TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth) :
+    _allTriangles(allTriangles),
+    _triangleSet(allTriangles)
+{
     reset(bounds, depth);
 }
 
@@ -118,8 +148,11 @@ void TriangleOctreeCell::clear() {
     _population = 0;
 }
 
+void TriangleOctreeCell::prune() {
+    // do nothing yet...
+}
+
 void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
-    //qDebug() << __FUNCTION__ << "bounds:" << bounds << "depth:" << depth;
     clear();
     _triangleSet._bounds = bounds;
     _depth = depth;
@@ -128,12 +161,7 @@ void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
         _children.clear();
         for (int child = 0; child < MAX_CHILDREN; child++) {
             AABox childBounds = getBounds().getOctreeChild((AABox::OctreeChild)child);
-            /*
-            qDebug() << __FUNCTION__ << "bounds:" << bounds << "depth:" << depth 
-                        << "child:" << child << "childBounds:" << childBounds << "childDepth:" << childDepth;
-            */
-
-            _children.push_back(TriangleOctreeCell(childBounds, childDepth));
+            _children.push_back(TriangleOctreeCell(_allTriangles, childBounds, childDepth));
         }
     }
 }
@@ -142,7 +170,7 @@ void TriangleOctreeCell::debugDump() {
     qDebug() << __FUNCTION__;
     qDebug() << "bounds:" << getBounds();
     qDebug() << "depth:" << _depth;
-    qDebug() << "triangleSet:" << _triangleSet.size() << "at this level";
+    //qDebug() << "triangleSet:" << _triangleSet.size() << "at this level";
     qDebug() << "population:" << _population << "this level or below";
     if (_depth < MAX_DEPTH) {
         int childNum = 0;
@@ -154,20 +182,21 @@ void TriangleOctreeCell::debugDump() {
     }
 }
 
-void TriangleOctreeCell::insert(const Triangle& t) {
+void TriangleOctreeCell::insert(int triangleIndex) {
+    const Triangle& triangle = _allTriangles[triangleIndex];
     _population++;
     // if we're not yet at the max depth, then check which child the triangle fits in
     if (_depth < MAX_DEPTH) {
         for (auto& child : _children) {
-            if (child.getBounds().contains(t)) {
-                child.insert(t);
+            if (child.getBounds().contains(triangle)) {
+                child.insert(triangleIndex);
                 return;
             }
         }
     }
     // either we're at max depth, or the triangle doesn't fit in one of our
     // children and so we want to just record it here
-    _triangleSet.insert(t);
+    _triangleSet.insert(triangleIndex);
 }
 
 bool TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index c8703c6445..d98ba86cb5 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -14,14 +14,15 @@
 #include "AABox.h"
 #include "GeometryUtil.h"
 
+
+
 class InternalTriangleSet {
 public:
-    InternalTriangleSet() { }
+    InternalTriangleSet(std::vector<Triangle>& allTriangles) :
+        _allTriangles(allTriangles)
+    { }
 
-    void reserve(size_t size) { _triangles.reserve(size); } // reserve space in the datastructure for size number of triangles
-    size_t size() const { return _triangles.size(); } 
-
-    virtual void insert(const Triangle& t);
+    virtual void insert(int triangleIndex);
     void clear();
 
     // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
@@ -30,14 +31,11 @@ public:
     bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction, 
         float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
 
-    // Determine if a point is "inside" all the triangles of a convex hull. It is the responsibility of the caller to
-    // determine that the triangle set is indeed a convex hull. If the triangles added to this set are not in fact a 
-    // convex hull, the result of this method is meaningless and undetermined.
-    bool convexHullContains(const glm::vec3& point) const;
     const AABox& getBounds() const { return _bounds; }
 
 protected:
-    std::vector<Triangle> _triangles;
+    std::vector<Triangle>& _allTriangles;
+    std::vector<int> _triangleIndices;
     AABox _bounds;
 
     friend class TriangleOctreeCell;
@@ -45,11 +43,16 @@ protected:
 
 class TriangleOctreeCell {
 public:
-    TriangleOctreeCell() { }
+    TriangleOctreeCell(std::vector<Triangle>& allTriangles) :
+        _allTriangles(allTriangles),
+        _triangleSet(allTriangles)
+    { }
 
-    void insert(const Triangle& t);
+
+    void insert(int triangleIndex);
     void reset(const AABox& bounds, int depth = 0);
     void clear();
+    void prune();
 
     // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
     // intersection occurs, the distance and surface normal will be provided.
@@ -61,8 +64,9 @@ public:
     void debugDump();
 
 protected:
-    TriangleOctreeCell(const AABox& bounds, int depth);
+    TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth);
 
+    std::vector<Triangle>& _allTriangles;
     InternalTriangleSet _triangleSet;
     std::vector<TriangleOctreeCell> _children;
     int _depth { 0 };
@@ -71,25 +75,42 @@ protected:
     friend class TriangleSet;
 };
 
-class TriangleSet : public InternalTriangleSet {
+class TriangleSet {
     // pass through public implementation all the features of InternalTriangleSet
 public:
-    TriangleSet() { }
+    TriangleSet() :
+        _triangleOctree(_triangles)
+    {}
 
     void debugDump();
 
-    virtual void insert(const Triangle& t) {
-        _isBalanced = false;
-        InternalTriangleSet::insert(t);
-    }
+    void insert(const Triangle& t);
 
     bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
         float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision);
 
     void balanceOctree();
 
+    void reserve(size_t size) { _triangles.reserve(size); } // reserve space in the datastructure for size number of triangles
+    size_t size() const { return _triangles.size(); }
+    void clear();
+
+    // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
+    // intersection occurs, the distance and surface normal will be provided.
+    // note: this might side-effect internal structures
+    bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
+
+    // Determine if a point is "inside" all the triangles of a convex hull. It is the responsibility of the caller to
+    // determine that the triangle set is indeed a convex hull. If the triangles added to this set are not in fact a 
+    // convex hull, the result of this method is meaningless and undetermined.
+    bool convexHullContains(const glm::vec3& point) const;
+    const AABox& getBounds() const { return _bounds; }
+
 protected:
 
-    bool _isBalanced { false };
+    bool _isBalanced{ false };
     TriangleOctreeCell _triangleOctree;
+    std::vector<Triangle> _triangles;
+    AABox _bounds;
 };

From 89b6a79f6888e9e797c6dd2a9daa0f0a4f53c875 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Fri, 12 May 2017 17:56:45 -0700
Subject: [PATCH 065/135] make sure to exit early if box intersection is
 already larger than best triangle intersection

---
 libraries/shared/src/TriangleSet.cpp | 63 ++++++++++++++++++++--------
 libraries/shared/src/TriangleSet.h   |  3 +-
 2 files changed, 47 insertions(+), 19 deletions(-)

diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index ef8f3ab91e..f9dea7bcc6 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -33,13 +33,16 @@ void TriangleSet::clear() {
 bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
     float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision) {
 
+    // reset our distance to be the max possible, lower level tests will store best distance here
+    distance = std::numeric_limits<float>::max();
+
     if (!_isBalanced) {
         balanceOctree();
     }
 
     int trianglesTouched = 0;
     auto result = _triangleOctree.findRayIntersection(origin, direction, distance, face, surfaceNormal, precision, trianglesTouched);
-    qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
+    //qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
     return result;
 }
 
@@ -77,10 +80,9 @@ void TriangleSet::balanceOctree() {
         _triangleOctree.insert(i);
     }
 
-    // prune the empty cells
-    _triangleOctree.prune();
-
     _isBalanced = true;
+
+    //debugDump();
 }
 
 
@@ -106,10 +108,17 @@ bool InternalTriangleSet::findRayIntersection(const glm::vec3& origin, const glm
             float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
 
     bool intersectedSomething = false;
-    float boxDistance = std::numeric_limits<float>::max();
-    float bestDistance = std::numeric_limits<float>::max();
+    float boxDistance = distance; //  std::numeric_limits<float>::max();
+    float bestDistance = distance; //  std::numeric_limits<float>::max();
 
     if (_bounds.findRayIntersection(origin, direction, boxDistance, face, surfaceNormal)) {
+
+        // if our bounding box intersects at a distance greater than the current known
+        // best distance, than we can safely not check any of our triangles
+        if (boxDistance > bestDistance) {
+            return false;
+        }
+
         if (precision) {
             for (const auto& triangleIndex : _triangleIndices) {
                 const auto& triangle = _allTriangles[triangleIndex];
@@ -148,10 +157,6 @@ void TriangleOctreeCell::clear() {
     _population = 0;
 }
 
-void TriangleOctreeCell::prune() {
-    // do nothing yet...
-}
-
 void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
     clear();
     _triangleSet._bounds = bounds;
@@ -159,10 +164,6 @@ void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
     if (depth <= MAX_DEPTH) {
         int childDepth = depth + 1;
         _children.clear();
-        for (int child = 0; child < MAX_CHILDREN; child++) {
-            AABox childBounds = getBounds().getOctreeChild((AABox::OctreeChild)child);
-            _children.push_back(TriangleOctreeCell(_allTriangles, childBounds, childDepth));
-        }
     }
 }
 
@@ -170,8 +171,9 @@ void TriangleOctreeCell::debugDump() {
     qDebug() << __FUNCTION__;
     qDebug() << "bounds:" << getBounds();
     qDebug() << "depth:" << _depth;
-    //qDebug() << "triangleSet:" << _triangleSet.size() << "at this level";
     qDebug() << "population:" << _population << "this level or below";
+    qDebug() << "triangleSet:" << _triangleSet.size() << "in this cell";
+    qDebug() << "child cells:" << _children.size();
     if (_depth < MAX_DEPTH) {
         int childNum = 0;
         for (auto& child : _children) {
@@ -187,12 +189,30 @@ void TriangleOctreeCell::insert(int triangleIndex) {
     _population++;
     // if we're not yet at the max depth, then check which child the triangle fits in
     if (_depth < MAX_DEPTH) {
+
+        // check existing children to see if this triangle fits them...
         for (auto& child : _children) {
             if (child.getBounds().contains(triangle)) {
                 child.insert(triangleIndex);
                 return;
             }
         }
+
+        // if it doesn't exist in an existing child, then check for new possible children
+        // note: this will actually re-check the bounds of all the existing children as well, hmmm
+        for (int child = 0; child < MAX_CHILDREN; child++) {
+            AABox childBounds = getBounds().getOctreeChild((AABox::OctreeChild)child);
+            if (childBounds.contains(triangle)) {
+
+                // create a child node
+                auto child = TriangleOctreeCell(_allTriangles, childBounds, _depth + 1);
+                _children.push_back(child);
+
+                // insert this triangle into it
+                child.insert(triangleIndex);
+                return;
+            }
+        }
     }
     // either we're at max depth, or the triangle doesn't fit in one of our
     // children and so we want to just record it here
@@ -206,16 +226,23 @@ bool TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm:
         return false; // no triangles below here, so we can't intersect
     }
 
-    float bestLocalDistance = std::numeric_limits<float>::max();
+    float bestLocalDistance = distance; // std::numeric_limits<float>::max();
     BoxFace bestLocalFace;
     glm::vec3 bestLocalNormal;
     bool intersects = false;
 
     // if the ray intersects our bounding box, then continue
     if (getBounds().findRayIntersection(origin, direction, bestLocalDistance, bestLocalFace, bestLocalNormal)) {
-        bestLocalDistance = std::numeric_limits<float>::max();
 
-        float childDistance = std::numeric_limits<float>::max();
+        // if the intersection with our bounding box, is greater than the current best distance (the distance passed in)
+        // then we know that none of our triangles can represent a better intersection and we can return
+        if (bestLocalDistance > distance) {
+            return false;
+        }
+
+        bestLocalDistance = distance; // std::numeric_limits<float>::max();
+
+        float childDistance = distance; // std::numeric_limits<float>::max();
         BoxFace childFace;
         glm::vec3 childNormal;
 
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index d98ba86cb5..c5e4c719cf 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -33,6 +33,8 @@ public:
 
     const AABox& getBounds() const { return _bounds; }
 
+    size_t size() const { return _triangleIndices.size(); }
+
 protected:
     std::vector<Triangle>& _allTriangles;
     std::vector<int> _triangleIndices;
@@ -52,7 +54,6 @@ public:
     void insert(int triangleIndex);
     void reset(const AABox& bounds, int depth = 0);
     void clear();
-    void prune();
 
     // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
     // intersection occurs, the distance and surface normal will be provided.

From bdb0414add26b3b792d9c1d16c36a933069acabb Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Fri, 12 May 2017 18:04:22 -0700
Subject: [PATCH 066/135] Adding a validation step at runtime for the cached
 KTX file in order to regenerate them if anything seems wrong

---
 libraries/gpu/src/gpu/Texture.cpp             |  7 ++++++-
 libraries/gpu/src/gpu/Texture_ktx.cpp         |  7 +++++++
 libraries/ktx/src/ktx/KTX.cpp                 |  6 ++++++
 libraries/ktx/src/ktx/Reader.cpp              | 19 ++++++++++++++++++-
 libraries/ktx/src/ktx/Writer.cpp              |  3 ++-
 .../src/model-networking/KTXCache.cpp         |  2 +-
 .../src/model-networking/TextureCache.cpp     |  4 +++-
 libraries/networking/src/FileCache.cpp        | 11 ++++++++---
 libraries/networking/src/FileCache.h          |  2 +-
 libraries/shared/src/shared/Storage.cpp       |  4 ++++
 10 files changed, 56 insertions(+), 9 deletions(-)

diff --git a/libraries/gpu/src/gpu/Texture.cpp b/libraries/gpu/src/gpu/Texture.cpp
index 0f84d2a3c9..a94a0e1621 100755
--- a/libraries/gpu/src/gpu/Texture.cpp
+++ b/libraries/gpu/src/gpu/Texture.cpp
@@ -441,7 +441,10 @@ void Texture::assignStoredMip(uint16 level, storage::StoragePointer& storage) {
     // THen check that the mem texture passed make sense with its format
     Size expectedSize = evalStoredMipSize(level, getStoredMipFormat());
     auto size = storage->size();
-    if (storage->size() <= expectedSize) {
+    if (storage->size() < expectedSize) {
+        _storage->assignMipData(level, storage);
+        _stamp++;
+    } else if (size == expectedSize) {
         _storage->assignMipData(level, storage);
         _stamp++;
     } else if (size > expectedSize) {
@@ -469,6 +472,8 @@ void Texture::assignStoredMipFace(uint16 level, uint8 face, storage::StoragePoin
     Size expectedSize = evalStoredMipFaceSize(level, getStoredMipFormat());
     auto size = storage->size();
     if (size <= expectedSize) {
+        _stamp++;
+    } else if (size == expectedSize) {
         _storage->assignMipFaceData(level, face, storage);
         _stamp++;
     } else if (size > expectedSize) {
diff --git a/libraries/gpu/src/gpu/Texture_ktx.cpp b/libraries/gpu/src/gpu/Texture_ktx.cpp
index 3fc4e0d432..524fd0a88c 100644
--- a/libraries/gpu/src/gpu/Texture_ktx.cpp
+++ b/libraries/gpu/src/gpu/Texture_ktx.cpp
@@ -542,6 +542,13 @@ bool Texture::evalTextureFormat(const ktx::Header& header, Element& mipFormat, E
         } else {
             return false;
         }
+    } else if (header.getGLFormat() == ktx::GLFormat::RG && header.getGLType() == ktx::GLType::UNSIGNED_BYTE && header.getTypeSize() == 1) {
+        mipFormat = Format::VEC2NU8_XY;
+        if (header.getGLInternaFormat_Uncompressed() == ktx::GLInternalFormat_Uncompressed::RG8) {
+            texelFormat = Format::VEC2NU8_XY;
+        } else {
+            return false;
+        }
     } else if (header.getGLFormat() == ktx::GLFormat::COMPRESSED_FORMAT && header.getGLType() == ktx::GLType::COMPRESSED_TYPE) {
         if (header.getGLInternaFormat_Compressed() == ktx::GLInternalFormat_Compressed::COMPRESSED_SRGB_S3TC_DXT1_EXT) {
             mipFormat = Format::COLOR_COMPRESSED_SRGB;
diff --git a/libraries/ktx/src/ktx/KTX.cpp b/libraries/ktx/src/ktx/KTX.cpp
index 38bb91e5c2..ff80695280 100644
--- a/libraries/ktx/src/ktx/KTX.cpp
+++ b/libraries/ktx/src/ktx/KTX.cpp
@@ -114,6 +114,9 @@ size_t Header::evalFaceSize(uint32_t level) const {
 }
 size_t Header::evalImageSize(uint32_t level) const {
     auto faceSize = evalFaceSize(level);
+    if ((faceSize < 4) || ((faceSize & 0x3) != 0)) {
+        return 0;
+    }
     if (numberOfFaces == NUM_CUBEMAPFACES && numberOfArrayElements == 0) {
         return faceSize;
     } else {
@@ -139,6 +142,9 @@ ImageDescriptors Header::generateImageDescriptors() const {
     size_t imageOffset = 0;
     for (uint32_t level = 0; level < numberOfMipmapLevels; ++level) {
         auto imageSize = static_cast<uint32_t>(evalImageSize(level));
+        if ((imageSize < 4) || ((imageSize & 0x3) != 0)) {
+            return ImageDescriptors();
+        }
         if (imageSize == 0) {
             return ImageDescriptors();
         }
diff --git a/libraries/ktx/src/ktx/Reader.cpp b/libraries/ktx/src/ktx/Reader.cpp
index 440e2f048c..49fc8bac70 100644
--- a/libraries/ktx/src/ktx/Reader.cpp
+++ b/libraries/ktx/src/ktx/Reader.cpp
@@ -148,12 +148,24 @@ namespace ktx {
             size_t imageSize = *reinterpret_cast<const uint32_t*>(currentPtr);
             currentPtr += sizeof(uint32_t);
 
+            auto expectedImageSize = header.evalImageSize(images.size());
+            if (imageSize != expectedImageSize) {
+                break;
+            } else if ((imageSize < 4) || (imageSize & 0x3)) {
+                break;
+            }
+
+            // The image size is the face size, beware!
+            size_t faceSize = imageSize;
+            if (numFaces == NUM_CUBEMAPFACES) {
+                imageSize = NUM_CUBEMAPFACES * faceSize;
+            }
+
             // If enough data ahead then capture the pointer
             if ((currentPtr - srcBytes) + imageSize <= (srcSize)) {
                 auto padding = Header::evalPadding(imageSize);
 
                 if (numFaces == NUM_CUBEMAPFACES) {
-                    size_t faceSize = imageSize / NUM_CUBEMAPFACES;
                     Image::FaceBytes faces(NUM_CUBEMAPFACES);
                     for (uint32_t face = 0; face < NUM_CUBEMAPFACES; face++) {
                         faces[face] = currentPtr;
@@ -166,6 +178,7 @@ namespace ktx {
                     currentPtr += imageSize + padding;
                 }
             } else {
+                // Stop here
                 break;
             }
         }
@@ -190,6 +203,10 @@ namespace ktx {
 
         // populate image table
         result->_images = parseImages(result->getHeader(), result->getTexelsDataSize(), result->getTexelsData());
+        if (result->_images.size() != result->getHeader().getNumberOfLevels()) {
+            // Fail if the number of images produced doesn't match the header number of levels
+            return nullptr;
+        }
 
         return result;
     }
diff --git a/libraries/ktx/src/ktx/Writer.cpp b/libraries/ktx/src/ktx/Writer.cpp
index 4226b8fa84..50f63767a0 100644
--- a/libraries/ktx/src/ktx/Writer.cpp
+++ b/libraries/ktx/src/ktx/Writer.cpp
@@ -210,7 +210,8 @@ namespace ktx {
             if (currentDataSize + sizeof(uint32_t) < allocatedImagesDataSize) {
                 uint32_t imageOffset = currentPtr - destBytes;
                 size_t imageSize = srcImages[l]._imageSize;
-                *(reinterpret_cast<uint32_t*> (currentPtr)) = (uint32_t) imageSize;
+                size_t imageFaceSize = srcImages[l]._faceSize;
+                *(reinterpret_cast<uint32_t*> (currentPtr)) = (uint32_t)imageFaceSize; // the imageSize written in the ktx is the FACE size
                 currentPtr += sizeof(uint32_t);
                 currentDataSize += sizeof(uint32_t);
 
diff --git a/libraries/model-networking/src/model-networking/KTXCache.cpp b/libraries/model-networking/src/model-networking/KTXCache.cpp
index 8ec1c4e41c..e0447af8e6 100644
--- a/libraries/model-networking/src/model-networking/KTXCache.cpp
+++ b/libraries/model-networking/src/model-networking/KTXCache.cpp
@@ -22,7 +22,7 @@ KTXCache::KTXCache(const std::string& dir, const std::string& ext) :
 }
 
 KTXFilePointer KTXCache::writeFile(const char* data, Metadata&& metadata) {
-    FilePointer file = FileCache::writeFile(data, std::move(metadata));
+    FilePointer file = FileCache::writeFile(data, std::move(metadata), true);
     return std::static_pointer_cast<KTXFile>(file);
 }
 
diff --git a/libraries/model-networking/src/model-networking/TextureCache.cpp b/libraries/model-networking/src/model-networking/TextureCache.cpp
index 9653cde7d8..47fc62a9b5 100644
--- a/libraries/model-networking/src/model-networking/TextureCache.cpp
+++ b/libraries/model-networking/src/model-networking/TextureCache.cpp
@@ -792,6 +792,8 @@ void ImageReader::read() {
                 texture = gpu::Texture::unserialize(ktxFile->getFilepath());
                 if (texture) {
                     texture = textureCache->cacheTextureByHash(hash, texture);
+                } else {
+                    qCWarning(modelnetworking) << "Invalid cached KTX " << _url << " under hash " << hash.c_str() << ", recreating...";
                 }
             }
         }
@@ -835,7 +837,7 @@ void ImageReader::read() {
             const char* data = reinterpret_cast<const char*>(memKtx->_storage->data());
             size_t length = memKtx->_storage->size();
             auto& ktxCache = textureCache->_ktxCache;
-            networkTexture->_file = ktxCache.writeFile(data, KTXCache::Metadata(hash, length));
+            networkTexture->_file = ktxCache.writeFile(data, KTXCache::Metadata(hash, length)); // 
             if (!networkTexture->_file) {
                 qCWarning(modelnetworking) << _url << "file cache failed";
             } else {
diff --git a/libraries/networking/src/FileCache.cpp b/libraries/networking/src/FileCache.cpp
index 43055e7ed6..8f3509d8f3 100644
--- a/libraries/networking/src/FileCache.cpp
+++ b/libraries/networking/src/FileCache.cpp
@@ -97,7 +97,7 @@ FilePointer FileCache::addFile(Metadata&& metadata, const std::string& filepath)
     return file;
 }
 
-FilePointer FileCache::writeFile(const char* data, File::Metadata&& metadata) {
+FilePointer FileCache::writeFile(const char* data, File::Metadata&& metadata, bool overwrite) {
     assert(_initialized);
 
     std::string filepath = getFilepath(metadata.key);
@@ -107,8 +107,13 @@ FilePointer FileCache::writeFile(const char* data, File::Metadata&& metadata) {
     // if file already exists, return it
     FilePointer file = getFile(metadata.key);
     if (file) {
-        qCWarning(file_cache, "[%s] Attempted to overwrite %s", _dirname.c_str(), metadata.key.c_str());
-        return file;
+        if (!overwrite) {
+            qCWarning(file_cache, "[%s] Attempted to overwrite %s", _dirname.c_str(), metadata.key.c_str());
+            return file;
+        } else {
+            qCWarning(file_cache, "[%s] Overwriting %s", _dirname.c_str(), metadata.key.c_str());
+            file.reset();
+        }
     }
 
     QSaveFile saveFile(QString::fromStdString(filepath));
diff --git a/libraries/networking/src/FileCache.h b/libraries/networking/src/FileCache.h
index f77db555bc..908ddcd285 100644
--- a/libraries/networking/src/FileCache.h
+++ b/libraries/networking/src/FileCache.h
@@ -80,7 +80,7 @@ protected:
     /// must be called after construction to create the cache on the fs and restore persisted files
     void initialize();
 
-    FilePointer writeFile(const char* data, Metadata&& metadata);
+    FilePointer writeFile(const char* data, Metadata&& metadata, bool overwrite = false);
     FilePointer getFile(const Key& key);
 
     /// create a file
diff --git a/libraries/shared/src/shared/Storage.cpp b/libraries/shared/src/shared/Storage.cpp
index f6585e6ecb..7cff876aa0 100644
--- a/libraries/shared/src/shared/Storage.cpp
+++ b/libraries/shared/src/shared/Storage.cpp
@@ -21,6 +21,10 @@ ViewStorage::ViewStorage(const storage::StoragePointer& owner, size_t size, cons
 
 StoragePointer Storage::createView(size_t viewSize, size_t offset) const {
     auto selfSize = size();
+    if ((viewSize < 4) || ((viewSize & 0x3) != 0)) {
+        throw std::runtime_error("Invalid mapping range");
+    }
+
     if (0 == viewSize) {
         viewSize = selfSize;
     }

From 5bc8e098654bb0cbaa7897c02067278f38af4652 Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Fri, 12 May 2017 18:10:48 -0700
Subject: [PATCH 067/135] Fixing the test...

---
 libraries/gpu/src/gpu/Texture.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libraries/gpu/src/gpu/Texture.cpp b/libraries/gpu/src/gpu/Texture.cpp
index a94a0e1621..b027c25907 100755
--- a/libraries/gpu/src/gpu/Texture.cpp
+++ b/libraries/gpu/src/gpu/Texture.cpp
@@ -471,7 +471,8 @@ void Texture::assignStoredMipFace(uint16 level, uint8 face, storage::StoragePoin
     // THen check that the mem texture passed make sense with its format
     Size expectedSize = evalStoredMipFaceSize(level, getStoredMipFormat());
     auto size = storage->size();
-    if (size <= expectedSize) {
+    if (size < expectedSize) {
+        _storage->assignMipFaceData(level, face, storage);
         _stamp++;
     } else if (size == expectedSize) {
         _storage->assignMipFaceData(level, face, storage);

From d734358290cd4168591f1f4ac53d1471cb3b9e91 Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Fri, 12 May 2017 18:15:00 -0700
Subject: [PATCH 068/135] Adding a comment for debug sake

---
 libraries/gpu/src/gpu/Texture.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/libraries/gpu/src/gpu/Texture.cpp b/libraries/gpu/src/gpu/Texture.cpp
index b027c25907..a545be9088 100755
--- a/libraries/gpu/src/gpu/Texture.cpp
+++ b/libraries/gpu/src/gpu/Texture.cpp
@@ -441,6 +441,7 @@ void Texture::assignStoredMip(uint16 level, storage::StoragePointer& storage) {
     // THen check that the mem texture passed make sense with its format
     Size expectedSize = evalStoredMipSize(level, getStoredMipFormat());
     auto size = storage->size();
+    // NOTE: doing the same thing in all the next block but beeing able to breakpoint with more accuracy
     if (storage->size() < expectedSize) {
         _storage->assignMipData(level, storage);
         _stamp++;
@@ -471,6 +472,7 @@ void Texture::assignStoredMipFace(uint16 level, uint8 face, storage::StoragePoin
     // THen check that the mem texture passed make sense with its format
     Size expectedSize = evalStoredMipFaceSize(level, getStoredMipFormat());
     auto size = storage->size();
+    // NOTE: doing the same thing in all the next block but beeing able to breakpoint with more accuracy
     if (size < expectedSize) {
         _storage->assignMipFaceData(level, face, storage);
         _stamp++;

From f35b0297fa991ed2794500940aa53b69dbdda58f Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Fri, 12 May 2017 18:25:07 -0700
Subject: [PATCH 069/135] Replace the alignment test by a nice function

---
 libraries/ktx/src/ktx/KTX.cpp    | 7 +++++--
 libraries/ktx/src/ktx/KTX.h      | 1 +
 libraries/ktx/src/ktx/Reader.cpp | 2 +-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/libraries/ktx/src/ktx/KTX.cpp b/libraries/ktx/src/ktx/KTX.cpp
index ff80695280..b43d015d65 100644
--- a/libraries/ktx/src/ktx/KTX.cpp
+++ b/libraries/ktx/src/ktx/KTX.cpp
@@ -22,6 +22,9 @@ uint32_t Header::evalPadding(size_t byteSize) {
     return (uint32_t) (3 - (byteSize + 3) % PACKING_SIZE);// padding ? PACKING_SIZE - padding : 0);
 }
 
+bool Header::checkAlignment(size_t byteSize) {
+    return ((byteSize & 0x3) == 0);
+}
 
 const Header::Identifier ktx::Header::IDENTIFIER {{
     0xAB, 0x4B, 0x54, 0x58, 0x20, 0x31, 0x31, 0xBB, 0x0D, 0x0A, 0x1A, 0x0A
@@ -114,7 +117,7 @@ size_t Header::evalFaceSize(uint32_t level) const {
 }
 size_t Header::evalImageSize(uint32_t level) const {
     auto faceSize = evalFaceSize(level);
-    if ((faceSize < 4) || ((faceSize & 0x3) != 0)) {
+    if (!checkAlignment(faceSize)) {
         return 0;
     }
     if (numberOfFaces == NUM_CUBEMAPFACES && numberOfArrayElements == 0) {
@@ -142,7 +145,7 @@ ImageDescriptors Header::generateImageDescriptors() const {
     size_t imageOffset = 0;
     for (uint32_t level = 0; level < numberOfMipmapLevels; ++level) {
         auto imageSize = static_cast<uint32_t>(evalImageSize(level));
-        if ((imageSize < 4) || ((imageSize & 0x3) != 0)) {
+        if (!checkAlignment(imageSize)) {
             return ImageDescriptors();
         }
         if (imageSize == 0) {
diff --git a/libraries/ktx/src/ktx/KTX.h b/libraries/ktx/src/ktx/KTX.h
index e8fa019a07..656cf93f34 100644
--- a/libraries/ktx/src/ktx/KTX.h
+++ b/libraries/ktx/src/ktx/KTX.h
@@ -309,6 +309,7 @@ namespace ktx {
         static const uint32_t REVERSE_ENDIAN_TEST = 0x01020304;
 
         static uint32_t evalPadding(size_t byteSize);
+        static bool checkAlignment(size_t byteSize);
 
         Header();
 
diff --git a/libraries/ktx/src/ktx/Reader.cpp b/libraries/ktx/src/ktx/Reader.cpp
index 49fc8bac70..e69ce53551 100644
--- a/libraries/ktx/src/ktx/Reader.cpp
+++ b/libraries/ktx/src/ktx/Reader.cpp
@@ -151,7 +151,7 @@ namespace ktx {
             auto expectedImageSize = header.evalImageSize(images.size());
             if (imageSize != expectedImageSize) {
                 break;
-            } else if ((imageSize < 4) || (imageSize & 0x3)) {
+            } else if (!Header::checkAlignment(imageSize)) {
                 break;
             }
 

From c4e8885842ef82793227f1716887b20c41c28856 Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Fri, 12 May 2017 18:27:58 -0700
Subject: [PATCH 070/135] not testing in storage for alignment

---
 libraries/shared/src/shared/Storage.cpp | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/libraries/shared/src/shared/Storage.cpp b/libraries/shared/src/shared/Storage.cpp
index 7cff876aa0..f6585e6ecb 100644
--- a/libraries/shared/src/shared/Storage.cpp
+++ b/libraries/shared/src/shared/Storage.cpp
@@ -21,10 +21,6 @@ ViewStorage::ViewStorage(const storage::StoragePointer& owner, size_t size, cons
 
 StoragePointer Storage::createView(size_t viewSize, size_t offset) const {
     auto selfSize = size();
-    if ((viewSize < 4) || ((viewSize & 0x3) != 0)) {
-        throw std::runtime_error("Invalid mapping range");
-    }
-
     if (0 == viewSize) {
         viewSize = selfSize;
     }

From f1bd06cfa09f5065d4ea2d820242a9f068c67ce7 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Fri, 12 May 2017 18:33:28 -0700
Subject: [PATCH 071/135] cleanup some unneeded class

---
 libraries/shared/src/TriangleSet.cpp | 42 +++++++++++-----------------
 libraries/shared/src/TriangleSet.h   | 40 ++++++--------------------
 2 files changed, 24 insertions(+), 58 deletions(-)

diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index f9dea7bcc6..99b2e2fc79 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -42,7 +42,7 @@ bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3&
 
     int trianglesTouched = 0;
     auto result = _triangleOctree.findRayIntersection(origin, direction, distance, face, surfaceNormal, precision, trianglesTouched);
-    //qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
+    qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
     return result;
 }
 
@@ -82,29 +82,13 @@ void TriangleSet::balanceOctree() {
 
     _isBalanced = true;
 
-    //debugDump();
+    debugDump();
 }
 
 
-
-void InternalTriangleSet::insert(int triangleIndex) {
-    auto& triangle = _allTriangles[triangleIndex];
-
-    _triangleIndices.push_back(triangleIndex);
-
-    _bounds += triangle.v0;
-    _bounds += triangle.v1;
-    _bounds += triangle.v2;
-}
-
-void InternalTriangleSet::clear() {
-    _triangleIndices.clear();
-    _bounds.clear();
-}
-
 // Determine of the given ray (origin/direction) in model space intersects with any triangles
 // in the set. If an intersection occurs, the distance and surface normal will be provided.
-bool InternalTriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+bool TriangleOctreeCell::findRayIntersectionInternal(const glm::vec3& origin, const glm::vec3& direction,
             float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
 
     bool intersectedSomething = false;
@@ -146,20 +130,20 @@ static const int MAX_DEPTH = 3; // for now
 static const int MAX_CHILDREN = 8;
 
 TriangleOctreeCell::TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth) :
-    _allTriangles(allTriangles),
-    _triangleSet(allTriangles)
+    _allTriangles(allTriangles)
 {
     reset(bounds, depth);
 }
 
 void TriangleOctreeCell::clear() {
-    _triangleSet.clear();
     _population = 0;
+    _triangleIndices.clear();
+    _bounds.clear();
 }
 
 void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
     clear();
-    _triangleSet._bounds = bounds;
+    _bounds = bounds;
     _depth = depth;
     if (depth <= MAX_DEPTH) {
         int childDepth = depth + 1;
@@ -172,7 +156,7 @@ void TriangleOctreeCell::debugDump() {
     qDebug() << "bounds:" << getBounds();
     qDebug() << "depth:" << _depth;
     qDebug() << "population:" << _population << "this level or below";
-    qDebug() << "triangleSet:" << _triangleSet.size() << "in this cell";
+    qDebug() << "triangleIndices:" << _triangleIndices.size() << "in this cell";
     qDebug() << "child cells:" << _children.size();
     if (_depth < MAX_DEPTH) {
         int childNum = 0;
@@ -216,7 +200,13 @@ void TriangleOctreeCell::insert(int triangleIndex) {
     }
     // either we're at max depth, or the triangle doesn't fit in one of our
     // children and so we want to just record it here
-    _triangleSet.insert(triangleIndex);
+    _triangleIndices.push_back(triangleIndex);
+
+    /*
+    _bounds += triangle.v0;
+    _bounds += triangle.v1;
+    _bounds += triangle.v2;
+    */
 }
 
 bool TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
@@ -263,7 +253,7 @@ bool TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm:
             }
         }
         // also check our local triangle set
-        if (_triangleSet.findRayIntersection(origin, direction, childDistance, childFace, childNormal, precision, trianglesTouched)) {
+        if (findRayIntersectionInternal(origin, direction, childDistance, childFace, childNormal, precision, trianglesTouched)) {
             if (childDistance < bestLocalDistance) {
                 bestLocalDistance = childDistance;
                 bestLocalFace = childFace;
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index c5e4c719cf..65033976cf 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -16,38 +16,10 @@
 
 
 
-class InternalTriangleSet {
-public:
-    InternalTriangleSet(std::vector<Triangle>& allTriangles) :
-        _allTriangles(allTriangles)
-    { }
-
-    virtual void insert(int triangleIndex);
-    void clear();
-
-    // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
-    // intersection occurs, the distance and surface normal will be provided.
-    // note: this might side-effect internal structures
-    bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction, 
-        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
-
-    const AABox& getBounds() const { return _bounds; }
-
-    size_t size() const { return _triangleIndices.size(); }
-
-protected:
-    std::vector<Triangle>& _allTriangles;
-    std::vector<int> _triangleIndices;
-    AABox _bounds;
-
-    friend class TriangleOctreeCell;
-};
-
 class TriangleOctreeCell {
 public:
     TriangleOctreeCell(std::vector<Triangle>& allTriangles) :
-        _allTriangles(allTriangles),
-        _triangleSet(allTriangles)
+        _allTriangles(allTriangles)
     { }
 
 
@@ -60,24 +32,28 @@ public:
     bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
         float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
 
-    const AABox& getBounds() const { return _triangleSet.getBounds(); }
+    const AABox& getBounds() const { return _bounds; }
 
     void debugDump();
 
 protected:
     TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth);
 
+    // checks our internal list of triangles
+    bool findRayIntersectionInternal(const glm::vec3& origin, const glm::vec3& direction,
+        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
+
     std::vector<Triangle>& _allTriangles;
-    InternalTriangleSet _triangleSet;
     std::vector<TriangleOctreeCell> _children;
     int _depth { 0 };
     int _population { 0 };
+    AABox _bounds;
+    std::vector<int> _triangleIndices;
 
     friend class TriangleSet;
 };
 
 class TriangleSet {
-    // pass through public implementation all the features of InternalTriangleSet
 public:
     TriangleSet() :
         _triangleOctree(_triangles)

From 4af3c760e6c304fbabce613ab2a4a80a6f2eaf09 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Fri, 12 May 2017 18:57:33 -0700
Subject: [PATCH 072/135] more cleanup

---
 libraries/shared/src/TriangleSet.cpp | 34 +++++++------
 libraries/shared/src/TriangleSet.h   | 74 +++++++++++++---------------
 2 files changed, 53 insertions(+), 55 deletions(-)

diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index 99b2e2fc79..2b6e12f005 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -27,7 +27,7 @@ void TriangleSet::clear() {
     _bounds.clear();
     _isBalanced = false;
 
-    // delete the octree?
+    _triangleOctree.clear();
 }
 
 bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
@@ -42,7 +42,12 @@ bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3&
 
     int trianglesTouched = 0;
     auto result = _triangleOctree.findRayIntersection(origin, direction, distance, face, surfaceNormal, precision, trianglesTouched);
-    qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
+
+    #if WANT_DEBUGGING
+    if (precision) {
+        qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
+    }
+    #endif
     return result;
 }
 
@@ -82,13 +87,15 @@ void TriangleSet::balanceOctree() {
 
     _isBalanced = true;
 
+    #if WANT_DEBUGGING
     debugDump();
+    #endif
 }
 
 
 // Determine of the given ray (origin/direction) in model space intersects with any triangles
 // in the set. If an intersection occurs, the distance and surface normal will be provided.
-bool TriangleOctreeCell::findRayIntersectionInternal(const glm::vec3& origin, const glm::vec3& direction,
+bool TriangleSet::TriangleOctreeCell::findRayIntersectionInternal(const glm::vec3& origin, const glm::vec3& direction,
             float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
 
     bool intersectedSomething = false;
@@ -126,22 +133,23 @@ bool TriangleOctreeCell::findRayIntersectionInternal(const glm::vec3& origin, co
     return intersectedSomething;
 }
 
-static const int MAX_DEPTH = 3; // for now
+static const int MAX_DEPTH = 4; // for now
 static const int MAX_CHILDREN = 8;
 
-TriangleOctreeCell::TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth) :
+TriangleSet::TriangleOctreeCell::TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth) :
     _allTriangles(allTriangles)
 {
     reset(bounds, depth);
 }
 
-void TriangleOctreeCell::clear() {
+void TriangleSet::TriangleOctreeCell::clear() {
     _population = 0;
     _triangleIndices.clear();
     _bounds.clear();
+    _children.clear();
 }
 
-void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
+void TriangleSet::TriangleOctreeCell::reset(const AABox& bounds, int depth) {
     clear();
     _bounds = bounds;
     _depth = depth;
@@ -151,7 +159,7 @@ void TriangleOctreeCell::reset(const AABox& bounds, int depth) {
     }
 }
 
-void TriangleOctreeCell::debugDump() {
+void TriangleSet::TriangleOctreeCell::debugDump() {
     qDebug() << __FUNCTION__;
     qDebug() << "bounds:" << getBounds();
     qDebug() << "depth:" << _depth;
@@ -168,7 +176,7 @@ void TriangleOctreeCell::debugDump() {
     }
 }
 
-void TriangleOctreeCell::insert(int triangleIndex) {
+void TriangleSet::TriangleOctreeCell::insert(int triangleIndex) {
     const Triangle& triangle = _allTriangles[triangleIndex];
     _population++;
     // if we're not yet at the max depth, then check which child the triangle fits in
@@ -201,15 +209,9 @@ void TriangleOctreeCell::insert(int triangleIndex) {
     // either we're at max depth, or the triangle doesn't fit in one of our
     // children and so we want to just record it here
     _triangleIndices.push_back(triangleIndex);
-
-    /*
-    _bounds += triangle.v0;
-    _bounds += triangle.v1;
-    _bounds += triangle.v2;
-    */
 }
 
-bool TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+bool TriangleSet::TriangleOctreeCell::findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
                 float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
 
     if (_population < 1) {
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index 65033976cf..bedb038c58 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -14,46 +14,42 @@
 #include "AABox.h"
 #include "GeometryUtil.h"
 
-
-
-class TriangleOctreeCell {
-public:
-    TriangleOctreeCell(std::vector<Triangle>& allTriangles) :
-        _allTriangles(allTriangles)
-    { }
-
-
-    void insert(int triangleIndex);
-    void reset(const AABox& bounds, int depth = 0);
-    void clear();
-
-    // Determine if the given ray (origin/direction) in model space intersects with any triangles in the set. If an 
-    // intersection occurs, the distance and surface normal will be provided.
-    bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
-        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
-
-    const AABox& getBounds() const { return _bounds; }
-
-    void debugDump();
-
-protected:
-    TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth);
-
-    // checks our internal list of triangles
-    bool findRayIntersectionInternal(const glm::vec3& origin, const glm::vec3& direction,
-        float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
-
-    std::vector<Triangle>& _allTriangles;
-    std::vector<TriangleOctreeCell> _children;
-    int _depth { 0 };
-    int _population { 0 };
-    AABox _bounds;
-    std::vector<int> _triangleIndices;
-
-    friend class TriangleSet;
-};
-
 class TriangleSet {
+
+    class TriangleOctreeCell {
+    public:
+        TriangleOctreeCell(std::vector<Triangle>& allTriangles) :
+            _allTriangles(allTriangles)
+        { }
+
+        void insert(int triangleIndex);
+        void reset(const AABox& bounds, int depth = 0);
+        void clear();
+
+        bool findRayIntersection(const glm::vec3& origin, const glm::vec3& direction,
+            float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
+
+        const AABox& getBounds() const { return _bounds; }
+
+        void debugDump();
+
+    protected:
+        TriangleOctreeCell(std::vector<Triangle>& allTriangles, const AABox& bounds, int depth);
+
+        // checks our internal list of triangles
+        bool findRayIntersectionInternal(const glm::vec3& origin, const glm::vec3& direction,
+            float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
+
+        std::vector<Triangle>& _allTriangles;
+        std::vector<TriangleOctreeCell> _children;
+        int _depth{ 0 };
+        int _population{ 0 };
+        AABox _bounds;
+        std::vector<int> _triangleIndices;
+
+        friend class TriangleSet;
+    };
+
 public:
     TriangleSet() :
         _triangleOctree(_triangles)

From dcb70aa50467dbdf6264cb00f3f79dd7e8da0882 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Fri, 12 May 2017 19:03:08 -0700
Subject: [PATCH 073/135] more cleanup

---
 libraries/shared/src/TriangleSet.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index 2b6e12f005..cd3f829d93 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -99,8 +99,8 @@ bool TriangleSet::TriangleOctreeCell::findRayIntersectionInternal(const glm::vec
             float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched) {
 
     bool intersectedSomething = false;
-    float boxDistance = distance; //  std::numeric_limits<float>::max();
-    float bestDistance = distance; //  std::numeric_limits<float>::max();
+    float boxDistance = distance;
+    float bestDistance = distance;
 
     if (_bounds.findRayIntersection(origin, direction, boxDistance, face, surfaceNormal)) {
 
@@ -218,7 +218,7 @@ bool TriangleSet::TriangleOctreeCell::findRayIntersection(const glm::vec3& origi
         return false; // no triangles below here, so we can't intersect
     }
 
-    float bestLocalDistance = distance; // std::numeric_limits<float>::max();
+    float bestLocalDistance = distance;
     BoxFace bestLocalFace;
     glm::vec3 bestLocalNormal;
     bool intersects = false;
@@ -232,9 +232,9 @@ bool TriangleSet::TriangleOctreeCell::findRayIntersection(const glm::vec3& origi
             return false;
         }
 
-        bestLocalDistance = distance; // std::numeric_limits<float>::max();
+        bestLocalDistance = distance;
 
-        float childDistance = distance; // std::numeric_limits<float>::max();
+        float childDistance = distance;
         BoxFace childFace;
         glm::vec3 childNormal;
 

From b38be7e561f5a2b30a8179cab40fc8626ac74b65 Mon Sep 17 00:00:00 2001
From: Sam Cake <Sam Cake>
Date: Fri, 12 May 2017 20:20:03 -0700
Subject: [PATCH 074/135] warning -1

---
 libraries/ktx/src/ktx/Reader.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/ktx/src/ktx/Reader.cpp b/libraries/ktx/src/ktx/Reader.cpp
index e69ce53551..1b63af5262 100644
--- a/libraries/ktx/src/ktx/Reader.cpp
+++ b/libraries/ktx/src/ktx/Reader.cpp
@@ -148,7 +148,7 @@ namespace ktx {
             size_t imageSize = *reinterpret_cast<const uint32_t*>(currentPtr);
             currentPtr += sizeof(uint32_t);
 
-            auto expectedImageSize = header.evalImageSize(images.size());
+            auto expectedImageSize = header.evalImageSize((uint32_t) images.size());
             if (imageSize != expectedImageSize) {
                 break;
             } else if (!Header::checkAlignment(imageSize)) {

From 20c27fc1338593498cb851498ddb38d004337589 Mon Sep 17 00:00:00 2001
From: Vladyslav Stelmakhovskyi <vladstelmahovsky@gmail.com>
Date: Sat, 13 May 2017 14:20:28 +0200
Subject: [PATCH 075/135] Fix crash on save Map data settings from scripts

---
 libraries/shared/src/SettingHelpers.cpp | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/libraries/shared/src/SettingHelpers.cpp b/libraries/shared/src/SettingHelpers.cpp
index 9e2d15fcd0..cbda4e4096 100644
--- a/libraries/shared/src/SettingHelpers.cpp
+++ b/libraries/shared/src/SettingHelpers.cpp
@@ -126,7 +126,16 @@ QJsonDocument variantMapToJsonDocument(const QSettings::SettingsMap& map) {
         }
 
         switch (variantType) {
-            case QVariant::Map:
+            case QVariant::Map: {
+                auto varmap = variant.toMap();
+                for (auto mapit = varmap.cbegin(); mapit != varmap.cend(); ++mapit) {
+                    auto& mapkey = mapit.key();
+                    auto& mapvariant = mapit.value();
+                    object.insert(key + "/" + mapkey, QJsonValue::fromVariant(mapvariant));
+                }
+                break;
+            }
+
             case QVariant::List:
             case QVariant::Hash: {
                 qCritical() << "Unsupported variant type" << variant.typeName();

From da404ce2ce573358344e5efb253e8edcda1659ce Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Sat, 13 May 2017 09:29:32 -0700
Subject: [PATCH 076/135] fix warning

---
 libraries/shared/src/TriangleSet.cpp | 8 ++------
 libraries/shared/src/TriangleSet.h   | 2 +-
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index cd3f829d93..d880b43a20 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -81,7 +81,7 @@ void TriangleSet::balanceOctree() {
 
     // insert all the triangles
 
-    for (int i = 0; i < _triangles.size(); i++) {
+    for (size_t i = 0; i < _triangles.size(); i++) {
         _triangleOctree.insert(i);
     }
 
@@ -153,10 +153,6 @@ void TriangleSet::TriangleOctreeCell::reset(const AABox& bounds, int depth) {
     clear();
     _bounds = bounds;
     _depth = depth;
-    if (depth <= MAX_DEPTH) {
-        int childDepth = depth + 1;
-        _children.clear();
-    }
 }
 
 void TriangleSet::TriangleOctreeCell::debugDump() {
@@ -176,7 +172,7 @@ void TriangleSet::TriangleOctreeCell::debugDump() {
     }
 }
 
-void TriangleSet::TriangleOctreeCell::insert(int triangleIndex) {
+void TriangleSet::TriangleOctreeCell::insert(size_t triangleIndex) {
     const Triangle& triangle = _allTriangles[triangleIndex];
     _population++;
     // if we're not yet at the max depth, then check which child the triangle fits in
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index bedb038c58..18494d270e 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -22,7 +22,7 @@ class TriangleSet {
             _allTriangles(allTriangles)
         { }
 
-        void insert(int triangleIndex);
+        void insert(size_t triangleIndex);
         void reset(const AABox& bounds, int depth = 0);
         void clear();
 

From 5065c7c5c45712f058e5c7c3c762eab7f6bb9a1c Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Sat, 13 May 2017 10:17:59 -0700
Subject: [PATCH 077/135] more warning fixes

---
 libraries/shared/src/TriangleSet.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index 18494d270e..3b39b935af 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -45,7 +45,7 @@ class TriangleSet {
         int _depth{ 0 };
         int _population{ 0 };
         AABox _bounds;
-        std::vector<int> _triangleIndices;
+        std::vector<size_t> _triangleIndices;
 
         friend class TriangleSet;
     };

From cc10fc81b79cdd7139e683b3967dd844f30f2e7c Mon Sep 17 00:00:00 2001
From: Vladyslav Stelmakhovskyi <vladstelmahovsky@gmail.com>
Date: Sat, 13 May 2017 20:57:04 +0200
Subject: [PATCH 078/135] Fix crash in sit script

---
 interface/src/avatar/MyAvatar.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index fd547e39e0..3da9b8a214 100755
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -291,6 +291,11 @@ QByteArray MyAvatar::toByteArrayStateful(AvatarDataDetail dataDetail) {
 }
 
 void MyAvatar::resetSensorsAndBody() {
+    if (QThread::currentThread() != thread()) {
+        QMetaObject::invokeMethod(this, "resetSensorsAndBody");
+        return;
+    }
+
     qApp->getActiveDisplayPlugin()->resetSensors();
     reset(true, false, true);
 }

From 149750fe216b96f067287a1d908e4010e7362fe6 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Sun, 14 May 2017 08:36:54 -0700
Subject: [PATCH 079/135] make the octree sparse

---
 libraries/shared/src/TriangleSet.cpp | 40 +++++++++++++---------------
 libraries/shared/src/TriangleSet.h   |  2 +-
 2 files changed, 19 insertions(+), 23 deletions(-)

diff --git a/libraries/shared/src/TriangleSet.cpp b/libraries/shared/src/TriangleSet.cpp
index d880b43a20..aa21aa5cc0 100644
--- a/libraries/shared/src/TriangleSet.cpp
+++ b/libraries/shared/src/TriangleSet.cpp
@@ -45,7 +45,7 @@ bool TriangleSet::findRayIntersection(const glm::vec3& origin, const glm::vec3&
 
     #if WANT_DEBUGGING
     if (precision) {
-        qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population;
+        qDebug() << "trianglesTouched :" << trianglesTouched << "out of:" << _triangleOctree._population << "_triangles.size:" << _triangles.size();
     }
     #endif
     return result;
@@ -80,7 +80,6 @@ void TriangleSet::balanceOctree() {
     _triangleOctree.reset(_bounds, 0);
 
     // insert all the triangles
-
     for (size_t i = 0; i < _triangles.size(); i++) {
         _triangleOctree.insert(i);
     }
@@ -159,14 +158,15 @@ void TriangleSet::TriangleOctreeCell::debugDump() {
     qDebug() << __FUNCTION__;
     qDebug() << "bounds:" << getBounds();
     qDebug() << "depth:" << _depth;
-    qDebug() << "population:" << _population << "this level or below";
-    qDebug() << "triangleIndices:" << _triangleIndices.size() << "in this cell";
+    qDebug() << "population:" << _population << "this level or below" 
+             << " ---- triangleIndices:" << _triangleIndices.size() << "in this cell";
+
     qDebug() << "child cells:" << _children.size();
     if (_depth < MAX_DEPTH) {
         int childNum = 0;
         for (auto& child : _children) {
             qDebug() << "child:" << childNum;
-            child.debugDump();
+            child.second.debugDump();
             childNum++;
         }
     }
@@ -178,26 +178,21 @@ void TriangleSet::TriangleOctreeCell::insert(size_t triangleIndex) {
     // if we're not yet at the max depth, then check which child the triangle fits in
     if (_depth < MAX_DEPTH) {
 
-        // check existing children to see if this triangle fits them...
-        for (auto& child : _children) {
-            if (child.getBounds().contains(triangle)) {
-                child.insert(triangleIndex);
-                return;
-            }
-        }
-
-        // if it doesn't exist in an existing child, then check for new possible children
-        // note: this will actually re-check the bounds of all the existing children as well, hmmm
         for (int child = 0; child < MAX_CHILDREN; child++) {
             AABox childBounds = getBounds().getOctreeChild((AABox::OctreeChild)child);
+
+
+            // if the child AABox would contain the triangle...
             if (childBounds.contains(triangle)) {
+                // if the child cell doesn't yet exist, create it...
+                if (_children.find((AABox::OctreeChild)child) == _children.end()) {
+                    _children.insert(
+                        std::pair<AABox::OctreeChild, TriangleOctreeCell>
+                        ((AABox::OctreeChild)child, TriangleOctreeCell(_allTriangles, childBounds, _depth + 1)));
+                }
 
-                // create a child node
-                auto child = TriangleOctreeCell(_allTriangles, childBounds, _depth + 1);
-                _children.push_back(child);
-
-                // insert this triangle into it
-                child.insert(triangleIndex);
+                // insert the triangleIndex in the child cell
+                _children.at((AABox::OctreeChild)child).insert(triangleIndex);
                 return;
             }
         }
@@ -224,6 +219,7 @@ bool TriangleSet::TriangleOctreeCell::findRayIntersection(const glm::vec3& origi
 
         // if the intersection with our bounding box, is greater than the current best distance (the distance passed in)
         // then we know that none of our triangles can represent a better intersection and we can return
+
         if (bestLocalDistance > distance) {
             return false;
         }
@@ -240,7 +236,7 @@ bool TriangleSet::TriangleOctreeCell::findRayIntersection(const glm::vec3& origi
                 // check each child, if there's an intersection, it will return some distance that we need
                 // to compare against the other results, because there might be multiple intersections and
                 // we will always choose the best (shortest) intersection
-                if (child.findRayIntersection(origin, direction, childDistance, childFace, childNormal, precision, trianglesTouched)) {
+                if (child.second.findRayIntersection(origin, direction, childDistance, childFace, childNormal, precision, trianglesTouched)) {
                     if (childDistance < bestLocalDistance) {
                         bestLocalDistance = childDistance;
                         bestLocalFace = childFace;
diff --git a/libraries/shared/src/TriangleSet.h b/libraries/shared/src/TriangleSet.h
index 3b39b935af..6cedc4da7e 100644
--- a/libraries/shared/src/TriangleSet.h
+++ b/libraries/shared/src/TriangleSet.h
@@ -41,7 +41,7 @@ class TriangleSet {
             float& distance, BoxFace& face, glm::vec3& surfaceNormal, bool precision, int& trianglesTouched);
 
         std::vector<Triangle>& _allTriangles;
-        std::vector<TriangleOctreeCell> _children;
+        std::map<AABox::OctreeChild, TriangleOctreeCell> _children;
         int _depth{ 0 };
         int _population{ 0 };
         AABox _bounds;

From 9c81a89ac3e43b0adc671e3233593c233b2ddcb1 Mon Sep 17 00:00:00 2001
From: ZappoMan <brad@highfidelity.io>
Date: Sun, 14 May 2017 08:37:26 -0700
Subject: [PATCH 080/135] add test script

---
 .../tests/performance/rayPickPerformance.js   | 131 ++++++++++++++++++
 1 file changed, 131 insertions(+)
 create mode 100644 scripts/developer/tests/performance/rayPickPerformance.js

diff --git a/scripts/developer/tests/performance/rayPickPerformance.js b/scripts/developer/tests/performance/rayPickPerformance.js
new file mode 100644
index 0000000000..b4faf4c1be
--- /dev/null
+++ b/scripts/developer/tests/performance/rayPickPerformance.js
@@ -0,0 +1,131 @@
+//
+//  rayPickingPerformance.js
+//  examples
+//
+//  Created by Brad Hefta-Gaub on 5/13/2017
+//  Copyright 2017 High Fidelity, Inc.
+//
+//  Distributed under the Apache License, Version 2.0.
+//  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
+//
+
+
+
+var MIN_RANGE = -3;
+var MAX_RANGE = 3;
+var RANGE_DELTA = 0.5;
+var OUTER_LOOPS = 10;
+
+// NOTE: These expected results depend completely on the model, and the range settings above
+var EXPECTED_TESTS = 1385 * OUTER_LOOPS;
+var EXPECTED_INTERSECTIONS = 1286 * OUTER_LOOPS;
+
+
+var center = Vec3.sum(MyAvatar.position, Vec3.multiply(3, Quat.getFront(Camera.getOrientation())));
+var model_url = "http://hifi-content.s3.amazonaws.com/caitlyn/production/Scansite/buddhaReduced.fbx";
+
+var rayPickOverlays = Array();
+
+var modelEntity = Entities.addEntity({
+    type: "Model",
+    modelURL: model_url,
+    dimensions: {
+        x: 0.671,
+        y: 1.21,
+        z: 0.938
+    },
+    position: center
+});
+
+function rayCastTest() {
+    var tests = 0;
+    var intersections = 0;
+
+    var testStart = Date.now();
+    for (var t = 0; t < OUTER_LOOPS; t++) {
+        print("beginning loop:" + t);
+        for (var x = MIN_RANGE; x < MAX_RANGE; x += RANGE_DELTA) {
+            for (var y = MIN_RANGE; y < MAX_RANGE; y += RANGE_DELTA) {
+                for (var z = MIN_RANGE; z < MAX_RANGE; z += RANGE_DELTA) {
+                    if ((x <= -2 || x >= 2) || 
+                        (y <= -2 || y >= 2) || 
+                        (z <= -2 || z >= 2)) {
+
+                        tests++;
+
+                        var origin = { x: center.x + x,
+                                       y: center.y + y,
+                                       z: center.z + z };
+                        var direction = Vec3.subtract(center, origin);
+
+                        var pickRay = { 
+                            origin: origin,
+                            direction: direction
+                        };
+
+                        var pickResults = Entities.findRayIntersection(pickRay, true);
+
+                        var color;
+                        var visible;
+
+                        if (pickResults.intersects && pickResults.entityID == modelEntity) {
+                            intersections++;
+                            color = {
+                                red: 0,
+                                green: 255,
+                                blue: 0
+                            };
+                            visible = false;
+
+                        } else {
+                            /*
+                            print("NO INTERSECTION?");
+                            Vec3.print("origin:", origin);
+                            Vec3.print("direction:", direction);
+                            */
+
+                            color = {
+                                red: 255,
+                                green: 0,
+                                blue: 0
+                            };
+                            visible = true;
+                        }
+
+                        var overlayID = Overlays.addOverlay("line3d", {
+                            color: color,
+                            alpha: 1,
+                            visible: visible,
+                            lineWidth: 2,
+                            start: origin,
+                            end: Vec3.sum(origin,Vec3.multiply(5,direction))
+                        });
+
+                        rayPickOverlays.push(overlayID);
+
+                    }
+                }
+            }
+        }
+        print("ending loop:" + t);
+    }
+    var testEnd = Date.now();
+    var testElapsed = testEnd - testStart;
+
+
+    print("EXPECTED tests:" + EXPECTED_TESTS + " intersections:" + EXPECTED_INTERSECTIONS);
+    print("ACTUAL   tests:" + tests + " intersections:" + intersections);
+    print("ELAPSED TIME:" + testElapsed + " ms");
+
+}
+
+function cleanup() {
+    Entities.deleteEntity(modelEntity);
+    rayPickOverlays.forEach(function(item){
+        Overlays.deleteOverlay(item);
+    });
+}
+
+Script.scriptEnding.connect(cleanup);
+
+rayCastTest(); // run ray cast test immediately
\ No newline at end of file

From 67fbb15faab1e5547ae8899f1cce067760771005 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Wed, 10 May 2017 18:11:34 -0700
Subject: [PATCH 081/135] WIP: initial implementation of flexCoefficients

---
 .../resources/avatar/avatar-animation.json    | 21 ++++---
 .../animation/src/AnimInverseKinematics.cpp   | 61 ++++++++++++++-----
 .../animation/src/AnimInverseKinematics.h     | 19 +++---
 libraries/animation/src/AnimNodeLoader.cpp    | 13 +++-
 libraries/animation/src/IKTarget.cpp          | 16 +++++
 libraries/animation/src/IKTarget.h            |  6 +-
 libraries/animation/src/Rig.cpp               | 10 +--
 7 files changed, 107 insertions(+), 39 deletions(-)

diff --git a/interface/resources/avatar/avatar-animation.json b/interface/resources/avatar/avatar-animation.json
index eb8403634a..a402358478 100644
--- a/interface/resources/avatar/avatar-animation.json
+++ b/interface/resources/avatar/avatar-animation.json
@@ -56,43 +56,50 @@
                                     "jointName": "Hips",
                                     "positionVar": "hipsPosition",
                                     "rotationVar": "hipsRotation",
-                                    "typeVar": "hipsType"
+                                    "typeVar": "hipsType",
+                                    "flexCoefficients": [1]
                                 },
                                 {
                                     "jointName": "RightHand",
                                     "positionVar": "rightHandPosition",
                                     "rotationVar": "rightHandRotation",
-                                    "typeVar": "rightHandType"
+                                    "typeVar": "rightHandType",
+                                    "flexCoefficients": [1, 0.5, 0.5, 0.5, 0.25, 0.1, 0.1, 0.1, 0.1]
                                 },
                                 {
                                     "jointName": "LeftHand",
                                     "positionVar": "leftHandPosition",
                                     "rotationVar": "leftHandRotation",
-                                    "typeVar": "leftHandType"
+                                    "typeVar": "leftHandType",
+                                    "flexCoefficients": [1, 0.5, 0.5, 0.5, 0.25, 0.1, 0.1, 0.1, 0.1]
                                 },
                                 {
                                     "jointName": "RightFoot",
                                     "positionVar": "rightFootPosition",
                                     "rotationVar": "rightFootRotation",
-                                    "typeVar": "rightFootType"
+                                    "typeVar": "rightFootType",
+                                    "flexCoefficients": [1, 0.45, 0.45]
                                 },
                                 {
                                     "jointName": "LeftFoot",
                                     "positionVar": "leftFootPosition",
                                     "rotationVar": "leftFootRotation",
-                                    "typeVar": "leftFootType"
+                                    "typeVar": "leftFootType",
+                                    "flexCoefficients": [1, 0.45, 0.45]
                                 },
                                 {
                                     "jointName": "Spine2",
                                     "positionVar": "spine2Position",
                                     "rotationVar": "spine2Rotation",
-                                    "typeVar": "spine2Type"
+                                    "typeVar": "spine2Type",
+                                    "flexCoefficients": [0.45, 0.45]
                                 },
                                 {
                                     "jointName": "Head",
                                     "positionVar": "headPosition",
                                     "rotationVar": "headRotation",
-                                    "typeVar": "headType"
+                                    "typeVar": "headType",
+                                    "flexCoefficients": [1, 0.5, 0.25, 0.25, 0.25]
                                 }
                             ]
                         },
diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 5e6927afcb..2ab4282177 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -21,6 +21,35 @@
 #include "SwingTwistConstraint.h"
 #include "AnimationLogging.h"
 
+AnimInverseKinematics::IKTargetVar::IKTargetVar(const QString& jointNameIn, const QString& positionVarIn, const QString& rotationVarIn,
+                                                const QString& typeVarIn, const std::vector<float>& flexCoefficientsIn) :
+    positionVar(positionVarIn),
+    rotationVar(rotationVarIn),
+    typeVar(typeVarIn),
+    jointName(jointNameIn),
+    numFlexCoefficients(flexCoefficientsIn.size()),
+    jointIndex(-1)
+{
+    numFlexCoefficients = std::min(numFlexCoefficients, MAX_FLEX_COEFFICIENTS);
+    for (size_t i = 0; i < numFlexCoefficients; i++) {
+        flexCoefficients[i] = flexCoefficientsIn[i];
+    }
+}
+
+AnimInverseKinematics::IKTargetVar::IKTargetVar(const IKTargetVar& orig) :
+    positionVar(orig.positionVar),
+    rotationVar(orig.rotationVar),
+    typeVar(orig.typeVar),
+    jointName(orig.jointName),
+    numFlexCoefficients(orig.numFlexCoefficients),
+    jointIndex(orig.jointIndex)
+{
+    numFlexCoefficients = std::min(numFlexCoefficients, MAX_FLEX_COEFFICIENTS);
+    for (size_t i = 0; i < numFlexCoefficients; i++) {
+        flexCoefficients[i] = orig.flexCoefficients[i];
+    }
+}
+
 AnimInverseKinematics::AnimInverseKinematics(const QString& id) : AnimNode(AnimNode::Type::InverseKinematics, id) {
 }
 
@@ -60,26 +89,22 @@ void AnimInverseKinematics::computeAbsolutePoses(AnimPoseVec& absolutePoses) con
     }
 }
 
-void AnimInverseKinematics::setTargetVars(
-        const QString& jointName,
-        const QString& positionVar,
-        const QString& rotationVar,
-        const QString& typeVar) {
+void AnimInverseKinematics::setTargetVars(const QString& jointName, const QString& positionVar, const QString& rotationVar,
+                                          const QString& typeVar, const std::vector<float>& flexCoefficients) {
+    IKTargetVar targetVar(jointName, positionVar, rotationVar, typeVar, flexCoefficients);
+
     // if there are dups, last one wins.
     bool found = false;
-    for (auto& targetVar: _targetVarVec) {
-        if (targetVar.jointName == jointName) {
-            // update existing targetVar
-            targetVar.positionVar = positionVar;
-            targetVar.rotationVar = rotationVar;
-            targetVar.typeVar = typeVar;
+    for (auto& targetVarIter: _targetVarVec) {
+        if (targetVarIter.jointName == jointName) {
+            targetVarIter = targetVar;
             found = true;
             break;
         }
     }
     if (!found) {
         // create a new entry
-        _targetVarVec.push_back(IKTargetVar(jointName, positionVar, rotationVar, typeVar));
+        _targetVarVec.push_back(targetVar);
     }
 }
 
@@ -110,7 +135,10 @@ void AnimInverseKinematics::computeTargets(const AnimVariantMap& animVars, std::
 
                 target.setPose(rotation, translation);
                 target.setIndex(targetVar.jointIndex);
+                target.setFlexCoefficients(targetVar.numFlexCoefficients, targetVar.flexCoefficients);
+
                 targets.push_back(target);
+
                 if (targetVar.jointIndex > _maxTargetIndex) {
                     _maxTargetIndex = targetVar.jointIndex;
                 }
@@ -271,6 +299,8 @@ int AnimInverseKinematics::solveTargetWithCCD(const IKTarget& target, AnimPoseVe
     // cache tip absolute position
     glm::vec3 tipPosition = absolutePoses[tipIndex].trans();
 
+    int chainDepth = 1;
+
     // descend toward root, pivoting each joint to get tip closer to target position
     while (pivotIndex != _hipsIndex && pivotsParentIndex != -1) {
         // compute the two lines that should be aligned
@@ -312,9 +342,8 @@ int AnimInverseKinematics::solveTargetWithCCD(const IKTarget& target, AnimPoseVe
                 float angle = acosf(cosAngle);
                 const float MIN_ADJUSTMENT_ANGLE = 1.0e-4f;
                 if (angle > MIN_ADJUSTMENT_ANGLE) {
-                    // reduce angle by a fraction (for stability)
-                    const float STABILITY_FRACTION = 0.5f;
-                    angle *= STABILITY_FRACTION;
+                    // reduce angle by a flexCoefficient
+                    angle *= target.getFlexCoefficient(chainDepth);
                     deltaRotation = glm::angleAxis(angle, axis);
 
                     // The swing will re-orient the tip but there will tend to be be a non-zero delta between the tip's
@@ -385,6 +414,8 @@ int AnimInverseKinematics::solveTargetWithCCD(const IKTarget& target, AnimPoseVe
 
         pivotIndex = pivotsParentIndex;
         pivotsParentIndex = _skeleton->getParentIndex(pivotIndex);
+
+        chainDepth++;
     }
     return lowestMovedIndex;
 }
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index f73ed95935..ddbb420012 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -32,7 +32,8 @@ public:
     void loadPoses(const AnimPoseVec& poses);
     void computeAbsolutePoses(AnimPoseVec& absolutePoses) const;
 
-    void setTargetVars(const QString& jointName, const QString& positionVar, const QString& rotationVar, const QString& typeVar);
+    void setTargetVars(const QString& jointName, const QString& positionVar, const QString& rotationVar,
+                       const QString& typeVar, const std::vector<float>& flexCoefficients);
 
     virtual const AnimPoseVec& evaluate(const AnimVariantMap& animVars, const AnimContext& context, float dt, AnimNode::Triggers& triggersOut) override;
     virtual const AnimPoseVec& overlay(const AnimVariantMap& animVars, const AnimContext& context, float dt, Triggers& triggersOut, const AnimPoseVec& underPoses) override;
@@ -77,22 +78,18 @@ protected:
     AnimInverseKinematics(const AnimInverseKinematics&) = delete;
     AnimInverseKinematics& operator=(const AnimInverseKinematics&) = delete;
 
+    static const size_t MAX_FLEX_COEFFICIENTS = 10;
     struct IKTargetVar {
-        IKTargetVar(const QString& jointNameIn,
-                const QString& positionVarIn,
-                const QString& rotationVarIn,
-                const QString& typeVarIn) :
-            positionVar(positionVarIn),
-            rotationVar(rotationVarIn),
-            typeVar(typeVarIn),
-            jointName(jointNameIn),
-            jointIndex(-1)
-        {}
+        IKTargetVar(const QString& jointNameIn, const QString& positionVarIn, const QString& rotationVarIn,
+                    const QString& typeVarIn, const std::vector<float>& flexCoefficientsIn);
+        IKTargetVar(const IKTargetVar& orig);
 
         QString positionVar;
         QString rotationVar;
         QString typeVar;
         QString jointName;
+        float flexCoefficients[MAX_FLEX_COEFFICIENTS];
+        size_t numFlexCoefficients;
         int jointIndex; // cached joint index
     };
 
diff --git a/libraries/animation/src/AnimNodeLoader.cpp b/libraries/animation/src/AnimNodeLoader.cpp
index 6bc7342d7f..e4ffaec5b7 100644
--- a/libraries/animation/src/AnimNodeLoader.cpp
+++ b/libraries/animation/src/AnimNodeLoader.cpp
@@ -471,7 +471,18 @@ AnimNode::Pointer loadInverseKinematicsNode(const QJsonObject& jsonObj, const QS
         READ_STRING(rotationVar, targetObj, id, jsonUrl, nullptr);
         READ_OPTIONAL_STRING(typeVar, targetObj);
 
-        node->setTargetVars(jointName, positionVar, rotationVar, typeVar);
+        auto flexCoefficientsValue = targetObj.value("flexCoefficients");
+        if (!flexCoefficientsValue.isArray()) {
+            qCCritical(animation) << "AnimNodeLoader, bad or missing flexCoefficients array in \"targets\", id =" << id << ", url =" << jsonUrl.toDisplayString();
+            return nullptr;
+        }
+        auto flexCoefficientsArray = flexCoefficientsValue.toArray();
+        std::vector<float> flexCoefficients;
+        for (const auto& value : flexCoefficientsArray) {
+            flexCoefficients.push_back((float)value.toDouble());
+        }
+
+        node->setTargetVars(jointName, positionVar, rotationVar, typeVar, flexCoefficients);
     };
 
     READ_OPTIONAL_STRING(solutionSource, jsonObj);
diff --git a/libraries/animation/src/IKTarget.cpp b/libraries/animation/src/IKTarget.cpp
index fa4030ca6d..868293fdb8 100644
--- a/libraries/animation/src/IKTarget.cpp
+++ b/libraries/animation/src/IKTarget.cpp
@@ -14,6 +14,22 @@ void IKTarget::setPose(const glm::quat& rotation, const glm::vec3& translation)
     _pose.trans() = translation;
 }
 
+void IKTarget::setFlexCoefficients(size_t numFlexCoefficientsIn, const float* flexCoefficientsIn) {
+    _numFlexCoefficients = std::min(numFlexCoefficientsIn, MAX_FLEX_COEFFICIENTS);
+    for (size_t i = 0; i < _numFlexCoefficients; i++) {
+        _flexCoefficients[i] = flexCoefficientsIn[i];
+    }
+}
+
+float IKTarget::getFlexCoefficient(int chainDepth) const {
+    const float DEFAULT_FLEX_COEFFICIENT = 0.5f;
+    if (chainDepth >= 0 && chainDepth < _numFlexCoefficients) {
+        return _flexCoefficients[chainDepth];
+    } else {
+        return DEFAULT_FLEX_COEFFICIENT;
+    }
+}
+
 void IKTarget::setType(int type) {
     switch (type) {
         case (int)Type::RotationAndPosition:
diff --git a/libraries/animation/src/IKTarget.h b/libraries/animation/src/IKTarget.h
index acb01d9861..63a4b901a6 100644
--- a/libraries/animation/src/IKTarget.h
+++ b/libraries/animation/src/IKTarget.h
@@ -35,15 +35,19 @@ public:
     void setPose(const glm::quat& rotation, const glm::vec3& translation);
     void setIndex(int index) { _index = index; }
     void setType(int);
+    void setFlexCoefficients(size_t numFlexCoefficientsIn, const float* flexCoefficientsIn);
+    float getFlexCoefficient(int chainDepth) const;
 
     // HACK: give HmdHead targets more "weight" during IK algorithm
     float getWeight() const { return _type == Type::HmdHead ? HACK_HMD_TARGET_WEIGHT : 1.0f; }
 
+    static const size_t MAX_FLEX_COEFFICIENTS = 10;
 private:
     AnimPose _pose;
     int _index{-1};
     Type _type{Type::RotationAndPosition};
-
+    float _flexCoefficients[MAX_FLEX_COEFFICIENTS];
+    size_t _numFlexCoefficients;
 };
 
 #endif // hifi_IKTarget_h
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index cb5aebe930..f5a9008ce1 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -1400,22 +1400,24 @@ void Rig::computeAvatarBoundingCapsule(
 
     AnimInverseKinematics ikNode("boundingShape");
     ikNode.setSkeleton(_animSkeleton);
+
+    // AJT: FIX ME!!!!! ensure that empty weights vector does something reasonable....
     ikNode.setTargetVars("LeftHand",
                          "leftHandPosition",
                          "leftHandRotation",
-                         "leftHandType");
+                         "leftHandType", {});
     ikNode.setTargetVars("RightHand",
                          "rightHandPosition",
                          "rightHandRotation",
-                         "rightHandType");
+                         "rightHandType", {});
     ikNode.setTargetVars("LeftFoot",
                          "leftFootPosition",
                          "leftFootRotation",
-                         "leftFootType");
+                         "leftFootType", {});
     ikNode.setTargetVars("RightFoot",
                          "rightFootPosition",
                          "rightFootRotation",
-                         "rightFootType");
+                         "rightFootType", {});
 
     AnimPose geometryToRig = _modelOffset * _geometryOffset;
 

From 1e276d113cf792305df60607479a07307fd3daab Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Fri, 12 May 2017 11:45:22 -0700
Subject: [PATCH 082/135] Added support for weights per target

---
 .../resources/avatar/avatar-animation.json    | 20 ++++++++++++++++---
 .../animation/src/AnimInverseKinematics.cpp   | 14 +++++++++----
 .../animation/src/AnimInverseKinematics.h     |  6 ++++--
 libraries/animation/src/AnimNodeLoader.cpp    | 11 +++++++++-
 libraries/animation/src/IKTarget.cpp          |  1 +
 libraries/animation/src/IKTarget.h            |  5 +++--
 libraries/animation/src/Rig.cpp               | 10 ++++++----
 7 files changed, 51 insertions(+), 16 deletions(-)

diff --git a/interface/resources/avatar/avatar-animation.json b/interface/resources/avatar/avatar-animation.json
index a402358478..b18599d8a9 100644
--- a/interface/resources/avatar/avatar-animation.json
+++ b/interface/resources/avatar/avatar-animation.json
@@ -57,6 +57,8 @@
                                     "positionVar": "hipsPosition",
                                     "rotationVar": "hipsRotation",
                                     "typeVar": "hipsType",
+                                    "weightVar": "hipsWeight",
+                                    "weight": 1.0,
                                     "flexCoefficients": [1]
                                 },
                                 {
@@ -64,20 +66,26 @@
                                     "positionVar": "rightHandPosition",
                                     "rotationVar": "rightHandRotation",
                                     "typeVar": "rightHandType",
-                                    "flexCoefficients": [1, 0.5, 0.5, 0.5, 0.25, 0.1, 0.1, 0.1, 0.1]
+                                    "weightVar": "rightHandWeight",
+                                    "weight": 1.0,
+                                    "flexCoefficients": [1, 0.5, 0.5, 0.25, 0.1, 0.05, 0.01, 0.0, 0.0]
                                 },
                                 {
                                     "jointName": "LeftHand",
                                     "positionVar": "leftHandPosition",
                                     "rotationVar": "leftHandRotation",
                                     "typeVar": "leftHandType",
-                                    "flexCoefficients": [1, 0.5, 0.5, 0.5, 0.25, 0.1, 0.1, 0.1, 0.1]
+                                    "weightVar": "leftHandWeight",
+                                    "weight": 1.0,
+                                    "flexCoefficients": [1, 0.5, 0.5, 0.25, 0.1, 0.05, 0.01, 0.0, 0.0]
                                 },
                                 {
                                     "jointName": "RightFoot",
                                     "positionVar": "rightFootPosition",
                                     "rotationVar": "rightFootRotation",
                                     "typeVar": "rightFootType",
+                                    "weightVar": "rightFootWeight",
+                                    "weight": 1.0,
                                     "flexCoefficients": [1, 0.45, 0.45]
                                 },
                                 {
@@ -85,6 +93,8 @@
                                     "positionVar": "leftFootPosition",
                                     "rotationVar": "leftFootRotation",
                                     "typeVar": "leftFootType",
+                                    "weightVar": "leftFootWeight",
+                                    "weight": 1.0,
                                     "flexCoefficients": [1, 0.45, 0.45]
                                 },
                                 {
@@ -92,6 +102,8 @@
                                     "positionVar": "spine2Position",
                                     "rotationVar": "spine2Rotation",
                                     "typeVar": "spine2Type",
+                                    "weightVar": "spine2Weight",
+                                    "weight": 1.0,
                                     "flexCoefficients": [0.45, 0.45]
                                 },
                                 {
@@ -99,7 +111,9 @@
                                     "positionVar": "headPosition",
                                     "rotationVar": "headRotation",
                                     "typeVar": "headType",
-                                    "flexCoefficients": [1, 0.5, 0.25, 0.25, 0.25]
+                                    "weightVar": "headWeight",
+                                    "weight": 4.0,
+                                    "flexCoefficients": [1, 0.5, 0.5, 0.5, 0.5]
                                 }
                             ]
                         },
diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 2ab4282177..11c143db23 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -22,10 +22,12 @@
 #include "AnimationLogging.h"
 
 AnimInverseKinematics::IKTargetVar::IKTargetVar(const QString& jointNameIn, const QString& positionVarIn, const QString& rotationVarIn,
-                                                const QString& typeVarIn, const std::vector<float>& flexCoefficientsIn) :
+                                                const QString& typeVarIn, const QString& weightVarIn, float weightIn, const std::vector<float>& flexCoefficientsIn) :
     positionVar(positionVarIn),
     rotationVar(rotationVarIn),
     typeVar(typeVarIn),
+    weightVar(weightVarIn),
+    weight(weightIn),
     jointName(jointNameIn),
     numFlexCoefficients(flexCoefficientsIn.size()),
     jointIndex(-1)
@@ -40,6 +42,8 @@ AnimInverseKinematics::IKTargetVar::IKTargetVar(const IKTargetVar& orig) :
     positionVar(orig.positionVar),
     rotationVar(orig.rotationVar),
     typeVar(orig.typeVar),
+    weightVar(orig.weightVar),
+    weight(orig.weight),
     jointName(orig.jointName),
     numFlexCoefficients(orig.numFlexCoefficients),
     jointIndex(orig.jointIndex)
@@ -90,8 +94,8 @@ void AnimInverseKinematics::computeAbsolutePoses(AnimPoseVec& absolutePoses) con
 }
 
 void AnimInverseKinematics::setTargetVars(const QString& jointName, const QString& positionVar, const QString& rotationVar,
-                                          const QString& typeVar, const std::vector<float>& flexCoefficients) {
-    IKTargetVar targetVar(jointName, positionVar, rotationVar, typeVar, flexCoefficients);
+                                          const QString& typeVar, const QString& weightVar, float weight, const std::vector<float>& flexCoefficients) {
+    IKTargetVar targetVar(jointName, positionVar, rotationVar, typeVar, weightVar, weight, flexCoefficients);
 
     // if there are dups, last one wins.
     bool found = false;
@@ -132,9 +136,11 @@ void AnimInverseKinematics::computeTargets(const AnimVariantMap& animVars, std::
                 AnimPose defaultPose = _skeleton->getAbsolutePose(targetVar.jointIndex, underPoses);
                 glm::quat rotation = animVars.lookupRigToGeometry(targetVar.rotationVar, defaultPose.rot());
                 glm::vec3 translation = animVars.lookupRigToGeometry(targetVar.positionVar, defaultPose.trans());
+                float weight = animVars.lookup(targetVar.weightVar, targetVar.weight);
 
                 target.setPose(rotation, translation);
                 target.setIndex(targetVar.jointIndex);
+                target.setWeight(weight);
                 target.setFlexCoefficients(targetVar.numFlexCoefficients, targetVar.flexCoefficients);
 
                 targets.push_back(target);
@@ -837,7 +843,7 @@ void AnimInverseKinematics::initConstraints() {
             stConstraint->setTwistLimits(-MAX_SHOULDER_TWIST, MAX_SHOULDER_TWIST);
 
             std::vector<float> minDots;
-            const float MAX_SHOULDER_SWING = PI / 20.0f;
+            const float MAX_SHOULDER_SWING = PI / 16.0f;
             minDots.push_back(cosf(MAX_SHOULDER_SWING));
             stConstraint->setSwingLimits(minDots);
 
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index ddbb420012..b798319ca9 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -33,7 +33,7 @@ public:
     void computeAbsolutePoses(AnimPoseVec& absolutePoses) const;
 
     void setTargetVars(const QString& jointName, const QString& positionVar, const QString& rotationVar,
-                       const QString& typeVar, const std::vector<float>& flexCoefficients);
+                       const QString& typeVar, const QString& weightVar, float weight, const std::vector<float>& flexCoefficients);
 
     virtual const AnimPoseVec& evaluate(const AnimVariantMap& animVars, const AnimContext& context, float dt, AnimNode::Triggers& triggersOut) override;
     virtual const AnimPoseVec& overlay(const AnimVariantMap& animVars, const AnimContext& context, float dt, Triggers& triggersOut, const AnimPoseVec& underPoses) override;
@@ -81,13 +81,15 @@ protected:
     static const size_t MAX_FLEX_COEFFICIENTS = 10;
     struct IKTargetVar {
         IKTargetVar(const QString& jointNameIn, const QString& positionVarIn, const QString& rotationVarIn,
-                    const QString& typeVarIn, const std::vector<float>& flexCoefficientsIn);
+                    const QString& typeVarIn, const QString& weightVarIn, float weightIn, const std::vector<float>& flexCoefficientsIn);
         IKTargetVar(const IKTargetVar& orig);
 
         QString positionVar;
         QString rotationVar;
         QString typeVar;
+        QString weightVar;
         QString jointName;
+        float weight;
         float flexCoefficients[MAX_FLEX_COEFFICIENTS];
         size_t numFlexCoefficients;
         int jointIndex; // cached joint index
diff --git a/libraries/animation/src/AnimNodeLoader.cpp b/libraries/animation/src/AnimNodeLoader.cpp
index e4ffaec5b7..44ed8c6053 100644
--- a/libraries/animation/src/AnimNodeLoader.cpp
+++ b/libraries/animation/src/AnimNodeLoader.cpp
@@ -173,6 +173,13 @@ static NodeProcessFunc animNodeTypeToProcessFunc(AnimNode::Type type) {
     }                                                                   \
     float NAME = (float)NAME##_VAL.toDouble()
 
+#define READ_OPTIONAL_FLOAT(NAME, JSON_OBJ, DEFAULT)                    \
+    auto NAME##_VAL = JSON_OBJ.value(#NAME);                            \
+    float NAME = (float)DEFAULT;                                        \
+    if (NAME##_VAL.isDouble()) {                                        \
+        NAME = (float)NAME##_VAL.toDouble();                            \
+    }                                                                   \
+    do {} while (0)
 
 static AnimNode::Pointer loadNode(const QJsonObject& jsonObj, const QUrl& jsonUrl) {
     auto idVal = jsonObj.value("id");
@@ -470,6 +477,8 @@ AnimNode::Pointer loadInverseKinematicsNode(const QJsonObject& jsonObj, const QS
         READ_STRING(positionVar, targetObj, id, jsonUrl, nullptr);
         READ_STRING(rotationVar, targetObj, id, jsonUrl, nullptr);
         READ_OPTIONAL_STRING(typeVar, targetObj);
+        READ_OPTIONAL_STRING(weightVar, targetObj);
+        READ_OPTIONAL_FLOAT(weight, targetObj, 1.0f);
 
         auto flexCoefficientsValue = targetObj.value("flexCoefficients");
         if (!flexCoefficientsValue.isArray()) {
@@ -482,7 +491,7 @@ AnimNode::Pointer loadInverseKinematicsNode(const QJsonObject& jsonObj, const QS
             flexCoefficients.push_back((float)value.toDouble());
         }
 
-        node->setTargetVars(jointName, positionVar, rotationVar, typeVar, flexCoefficients);
+        node->setTargetVars(jointName, positionVar, rotationVar, typeVar, weightVar, weight, flexCoefficients);
     };
 
     READ_OPTIONAL_STRING(solutionSource, jsonObj);
diff --git a/libraries/animation/src/IKTarget.cpp b/libraries/animation/src/IKTarget.cpp
index 868293fdb8..ae23d9548f 100644
--- a/libraries/animation/src/IKTarget.cpp
+++ b/libraries/animation/src/IKTarget.cpp
@@ -23,6 +23,7 @@ void IKTarget::setFlexCoefficients(size_t numFlexCoefficientsIn, const float* fl
 
 float IKTarget::getFlexCoefficient(int chainDepth) const {
     const float DEFAULT_FLEX_COEFFICIENT = 0.5f;
+
     if (chainDepth >= 0 && chainDepth < _numFlexCoefficients) {
         return _flexCoefficients[chainDepth];
     } else {
diff --git a/libraries/animation/src/IKTarget.h b/libraries/animation/src/IKTarget.h
index 63a4b901a6..0e8bb614ea 100644
--- a/libraries/animation/src/IKTarget.h
+++ b/libraries/animation/src/IKTarget.h
@@ -38,14 +38,15 @@ public:
     void setFlexCoefficients(size_t numFlexCoefficientsIn, const float* flexCoefficientsIn);
     float getFlexCoefficient(int chainDepth) const;
 
-    // HACK: give HmdHead targets more "weight" during IK algorithm
-    float getWeight() const { return _type == Type::HmdHead ? HACK_HMD_TARGET_WEIGHT : 1.0f; }
+    void setWeight(float weight) { _weight = weight; }
+    float getWeight() const { return _weight; }
 
     static const size_t MAX_FLEX_COEFFICIENTS = 10;
 private:
     AnimPose _pose;
     int _index{-1};
     Type _type{Type::RotationAndPosition};
+    float _weight;
     float _flexCoefficients[MAX_FLEX_COEFFICIENTS];
     size_t _numFlexCoefficients;
 };
diff --git a/libraries/animation/src/Rig.cpp b/libraries/animation/src/Rig.cpp
index f5a9008ce1..23db05eb73 100644
--- a/libraries/animation/src/Rig.cpp
+++ b/libraries/animation/src/Rig.cpp
@@ -1088,10 +1088,12 @@ void Rig::updateHeadAnimVars(const HeadParameters& params) {
                 // Since there is an explicit hips ik target, switch the head to use the more generic RotationAndPosition IK chain type.
                 // this will allow the spine to bend more, ensuring that it can reach the head target position.
                 _animVars.set("headType", (int)IKTarget::Type::RotationAndPosition);
+                _animVars.unset("headWeight");  // use the default weight for this target.
             } else {
                 // When there is no hips IK target, use the HmdHead IK chain type.  This will make the spine very stiff,
                 // but because the IK _hipsOffset is enabled, the hips will naturally follow underneath the head.
                 _animVars.set("headType", (int)IKTarget::Type::HmdHead);
+                _animVars.set("headWeight", 8.0f);
             }
         } else {
             _animVars.unset("headPosition");
@@ -1405,19 +1407,19 @@ void Rig::computeAvatarBoundingCapsule(
     ikNode.setTargetVars("LeftHand",
                          "leftHandPosition",
                          "leftHandRotation",
-                         "leftHandType", {});
+                         "leftHandType", "leftHandWeight", 1.0f, {});
     ikNode.setTargetVars("RightHand",
                          "rightHandPosition",
                          "rightHandRotation",
-                         "rightHandType", {});
+                         "rightHandType", "rightHandWeight", 1.0f, {});
     ikNode.setTargetVars("LeftFoot",
                          "leftFootPosition",
                          "leftFootRotation",
-                         "leftFootType", {});
+                         "leftFootType", "leftFootWeight", 1.0f, {});
     ikNode.setTargetVars("RightFoot",
                          "rightFootPosition",
                          "rightFootRotation",
-                         "rightFootType", {});
+                         "rightFootType", "rightFootWeight", 1.0f, {});
 
     AnimPose geometryToRig = _modelOffset * _geometryOffset;
 

From b627fe463bbba979a6a8a3e9a519b51268a673d0 Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Mon, 15 May 2017 10:50:10 -0700
Subject: [PATCH 083/135] Generate correct KTX for the default Sky

---
 .../images/Default-Sky-9-cubemap.ktx          | Bin 33554432 -> 33554792 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/interface/resources/images/Default-Sky-9-cubemap.ktx b/interface/resources/images/Default-Sky-9-cubemap.ktx
index 95710d2c0847a77858299e34a499b0dc8178f328..476d381a8c00b8bc5934354e319e365c3cefa5e5 100644
GIT binary patch
delta 2810
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
ZZk-=DYtubWOXfE2l9|^f&T8Ky{tt-AWuyQA

delta 2610
zcmZ|Qdvw=x7zgn0=QpiU5|OFoo)AJ<+mcJ-U7GKNYE+vEZPipHw>IzCJ4L@Tg-O4L
zXh;%PD<*QO$faCDNx7t4qbM}zoxgp~d0yu{&pFRI&pFR?&Sx_#T2@q4w473wh@z<@
zJCu)(%A#F6^0Q}FF7Mi6Vlt;kG%5;fd)G6o-Qso`VM%dR7WH45lbyd{L;cwCQTC8%
zR5W{7QP!5u0~ZxcU9+%nR2*$9EYI4oW=Yp&n<i(MMSY@ab@Q_ahy2_wJ=f(9jYdQ>
zI+fHfotvJseMPUuMNx6obj0wS)jh}LRyXUG(JlJ#RkaTt6BS{6925sfLUBk_9QINi
znkWwGibGSyAwzN4TXEP&acHJEG*=w<RUBF<4*Mw%Eft6T6^8>9hgOQifr`UHibHF~
z;b6rfQ*k(?E)H#Wl~)Z48L64Or-#DS`bCu?C9sXawgTG;JXBzNfrkk^T;LG`j}&;6
zz@r5oBd~+OV+D2;c$~oF1)d<VlfV-No+R*Oft>}OBJfm!rwQyL@N|J^2s~3@mcXt8
zvjye|%oW&8;8_B@3p`ukIReiWc%Hx>0?!xNQ{V*xFBAxYy#)3ac#*(90`ml3EHD<B
zFYpq9eFa`B@G^my3+yMbzrX<k3j|&v@JfLL1r8E8SYV;RB7s*4EEagRz##&!5qPb@
z>jVxJSR$}g;4p#11&$C{Ch&TJBL$8UI9lKh0&f&JM&L~X#|pez;4K1g6?mJ#+Xapj
zST3+a;2i=faJ;}f1>PmFQlJD*5O}x1i2^4Hyhq@@0w)Vh3Y;Qvs=)gMRtdac;532L
z1wJ6~L4gkmtQPpNz!?G`5jazz?_!p~8i9`rd`#fu0%r?+Lg14E=LoD7_>{n>1wJEi
zuE1vn&J*~Y!1)577q~#+3j$vh_>#anfeQsL5?C*AvA`t)Ul#a^zy^V@3S27iHG!`S
zTqf`hfo}?YOW@lAmkV4WaHYU^1imY9mB9A|zAx|tfgcK7EpUy%j|6@!@DqWb3S2Aj
zGl8EA{6gS5f$If+DR6_puLN!sxJlsG0>2UXt-$XDZWj2xz%2r|3j9Ifj{<)Z__M%Y
z1pX>;o50@${w{F4z#Rhr5csFSodS0W{7c~90{;=XTVUfPFeJfX5+=>;Wty0D)6`^`
zz0E$RnQ3nJH7(43rlr~69AH|R1I<CEwK>>innO$*)7G>zhnn{0Fmt#$!W?OiGDn+Z
zOb2tU>1d8K$D0#OCv&1X$((FDn^VlG<}}mAoNmrAXPPY2)nuC-lWV$}vrKn$wmHX~
zYtA!0%=xCLxxid#V0xL}<|5O_<e7_2Z1T+|rmwlwTxKpe{Y-x|z!aD(%#~)K8Ds{V
zLQ`a}GR5X<GsIkDt~J-0p{B%?nqg+R8DYxI^=70QWk#DD%#CJ@xyg(*H=A3`t>!j!
zyBQZ6!155v6NS<Ld`xw5NKed4=G9b&WL}NT1ar5UXeOC^%)Mr^Nt!8Us=3cpnfuK&
zGu=F39yAY`YV)v}VIDCvP0GwNHRe(Cn0egHHcyx*%^Xu}o-$9HXUtslteIz?GxN>!
zW`TLZyl7rBb!MSiWa`agv&6h?UNH^kRkPH*W?nbT%p2xS^OkwrEH^96O7o6+*Q_${
znfJ{H=0mgEtT7*%kIg6MQ?u55W<EDxn001-n3q@cWhhK!dc}2d2#Gl<uQM|>uBI|{
zOs%S^3>nGl+OI;gx^|=4WWF}vm~YK@X0!R;Y%yES59UYnllj^FVtzH-%x~s*v)$|n
z4b`=OgoXVQ>Cu8XBue&-(>yh<)`OIk{uz=br8~_o^OyNMG?bM76ShuEs|b6V+9V6w
z?hXwFZ5u=5khH?c#XHg))~PX63`on|lQT4I+}Ie(Tc@Q*QB@oY8<y>C46~Yqid50g
N#?UG?wy`lx_!nFsBtifH


From 5c5eb298f5c50f4adb586e22ea3b31907242e00c Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Tue, 16 May 2017 09:20:58 +1200
Subject: [PATCH 084/135] Better error message

---
 scripts/system/playRecordingAC.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index 4cf65c7942..c1c70587c6 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -294,7 +294,7 @@
                 recordingFilename = recording;
                 playRecording(recordingFilename, position, orientation);
             } else {
-                errorMessage = "Could not play recording " + recording.slice(4);  // Remove leading "atp:".
+                errorMessage = "Could not persist recording " + recording.slice(4);  // Remove leading "atp:".
                 log(errorMessage);
                 error(errorMessage);
             }

From a2a24b22a8ba82b9f2637e7408a83a81c7e8d72f Mon Sep 17 00:00:00 2001
From: Zach Fox <fox@highfidelity.io>
Date: Mon, 15 May 2017 14:12:48 -0700
Subject: [PATCH 085/135] Force _identityUpdatedAt to stay above 0

---
 libraries/avatars/src/AvatarData.cpp | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 6992e66f0e..f839a99710 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -1538,7 +1538,14 @@ void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityC
 
     // use the timestamp from this identity, since we want to honor the updated times in "server clock"
     // this will overwrite any changes we made locally to this AvatarData's _identityUpdatedAt
-    _identityUpdatedAt = identity.updatedAt - clockSkew;
+    // Additionally, ensure that the timestamp that we try to record isn't negative, as
+    // "_identityUpdatedAt" is an *unsigned* 64-bit integer. Furthermore, negative timestamps
+    // wouldn't make sense.
+    if (identity.updatedAt - clockSkew >= 0) {
+        _identityUpdatedAt = identity.updatedAt - clockSkew;
+    } else {
+        _identityUpdatedAt = 0;
+    }
 }
 
 QByteArray AvatarData::identityByteArray() const {

From e492ca9364c8b9f8aae61b09ed5ae4acaa97d4aa Mon Sep 17 00:00:00 2001
From: Zach Fox <fox@highfidelity.io>
Date: Mon, 15 May 2017 14:55:05 -0700
Subject: [PATCH 086/135] Improve the test - thanks Dave!

---
 libraries/avatars/src/AvatarData.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index f839a99710..efd5158c7d 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -1541,7 +1541,7 @@ void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityC
     // Additionally, ensure that the timestamp that we try to record isn't negative, as
     // "_identityUpdatedAt" is an *unsigned* 64-bit integer. Furthermore, negative timestamps
     // wouldn't make sense.
-    if (identity.updatedAt - clockSkew >= 0) {
+    if (identity.updatedAt > clockSkew) {
         _identityUpdatedAt = identity.updatedAt - clockSkew;
     } else {
         _identityUpdatedAt = 0;

From 6bdd498ecfca598f73fbb2c0a23e331eabf5940e Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Tue, 16 May 2017 10:47:52 +1200
Subject: [PATCH 087/135] Cancel autoplay when manually playing

---
 scripts/system/playRecordingAC.js | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index c1c70587c6..f62451154b 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -286,6 +286,11 @@
         function play(user, recording, position, orientation) {
             var errorMessage;
 
+            if (autoPlayTimer) {  // Cancel autoplay.
+                Script.clearTimeout(autoPlayTimer);
+                autoPlayTimer = null;
+            }
+
             userID = user;
 
             if (Entity.create(recording, position, orientation)) {
@@ -297,6 +302,8 @@
                 errorMessage = "Could not persist recording " + recording.slice(4);  // Remove leading "atp:".
                 log(errorMessage);
                 error(errorMessage);
+
+                autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_ERROR_INTERVAL);  // Resume autoplay later.
             }
         }
 

From bc1e97032a1cd855b942d7b8e2ae5df274d31cab Mon Sep 17 00:00:00 2001
From: Zach Fox <fox@highfidelity.io>
Date: Mon, 15 May 2017 17:39:19 -0700
Subject: [PATCH 088/135] Thanks to Andrew!

---
 libraries/avatars/src/AvatarData.cpp | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 08e8774dfb..26afed152f 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -1496,13 +1496,18 @@ QUrl AvatarData::cannonicalSkeletonModelURL(const QUrl& emptyURL) const {
 }
 
 void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityChanged, bool& displayNameChanged, const qint64 clockSkew) {
+    quint64 identityPacketUpdatedAt = identity.updatedAt;
+
+    if (identityPacketUpdatedAt <= (uint64_t)(abs(clockSkew))) { // Incoming timestamp is bad - compute our own timestamp
+        identityPacketUpdatedAt = usecTimestampNow() + clockSkew;
+    }
 
     // Consider the case where this packet is being processed on Client A, and Client A is connected to Sandbox B.
     // If Client A's system clock is *ahead of* Sandbox B's system clock, "clockSkew" will be *negative*.
     // If Client A's system clock is *behind* Sandbox B's system clock, "clockSkew" will be *positive*.
-    if ((_identityUpdatedAt > identity.updatedAt - clockSkew) && (_identityUpdatedAt != 0)) {
+    if ((_identityUpdatedAt > identityPacketUpdatedAt - clockSkew) && (_identityUpdatedAt != 0)) {
         qCDebug(avatars) << "Ignoring late identity packet for avatar " << getSessionUUID() 
-            << "_identityUpdatedAt (" << _identityUpdatedAt << ") is greater than identity.updatedAt - clockSkew (" << identity.updatedAt << "-" << clockSkew << ")";
+            << "_identityUpdatedAt (" << _identityUpdatedAt << ") is greater than identityPacketUpdatedAt - clockSkew (" << identityPacketUpdatedAt << "-" << clockSkew << ")";
         return;
     }
 
@@ -1538,14 +1543,7 @@ void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityC
 
     // use the timestamp from this identity, since we want to honor the updated times in "server clock"
     // this will overwrite any changes we made locally to this AvatarData's _identityUpdatedAt
-    // Additionally, ensure that the timestamp that we try to record isn't negative, as
-    // "_identityUpdatedAt" is an *unsigned* 64-bit integer. Furthermore, negative timestamps
-    // wouldn't make sense.
-    if (identity.updatedAt > clockSkew) {
-        _identityUpdatedAt = identity.updatedAt - clockSkew;
-    } else {
-        _identityUpdatedAt = 0;
-    }
+    _identityUpdatedAt = identityPacketUpdatedAt - clockSkew;
 }
 
 QByteArray AvatarData::identityByteArray() const {

From cde7d6857018846c2b74b37faf12b3e48000cab7 Mon Sep 17 00:00:00 2001
From: Atlante45 <clement.brisset@gmail.com>
Date: Mon, 15 May 2017 18:11:30 -0700
Subject: [PATCH 089/135] Fix domain settings not getting cleared on
 re-assignment

---
 assignment-client/src/audio/AudioMixer.cpp | 22 +++++++++++++++++++---
 assignment-client/src/audio/AudioMixer.h   |  1 +
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/assignment-client/src/audio/AudioMixer.cpp b/assignment-client/src/audio/AudioMixer.cpp
index b95c429b2d..98eca60e85 100644
--- a/assignment-client/src/audio/AudioMixer.cpp
+++ b/assignment-client/src/audio/AudioMixer.cpp
@@ -38,13 +38,14 @@
 #include "AudioMixer.h"
 
 static const float DEFAULT_ATTENUATION_PER_DOUBLING_IN_DISTANCE = 0.5f;    // attenuation = -6dB * log2(distance)
+static const int DEFAULT_NUM_STATIC_JITTER_FRAMES = -1;
 static const float DEFAULT_NOISE_MUTING_THRESHOLD = 1.0f;
 static const QString AUDIO_MIXER_LOGGING_TARGET_NAME = "audio-mixer";
 static const QString AUDIO_ENV_GROUP_KEY = "audio_env";
 static const QString AUDIO_BUFFER_GROUP_KEY = "audio_buffer";
 static const QString AUDIO_THREADING_GROUP_KEY = "audio_threading";
 
-int AudioMixer::_numStaticJitterFrames{ -1 };
+int AudioMixer::_numStaticJitterFrames{ DEFAULT_NUM_STATIC_JITTER_FRAMES };
 float AudioMixer::_noiseMutingThreshold{ DEFAULT_NOISE_MUTING_THRESHOLD };
 float AudioMixer::_attenuationPerDoublingInDistance{ DEFAULT_ATTENUATION_PER_DOUBLING_IN_DISTANCE };
 std::map<QString, std::shared_ptr<CodecPlugin>> AudioMixer::_availableCodecs{ };
@@ -56,7 +57,12 @@ QVector<AudioMixer::ReverbSettings> AudioMixer::_zoneReverbSettings;
 AudioMixer::AudioMixer(ReceivedMessage& message) :
     ThreadedAssignment(message) {
 
+    // Always clear settings first
+    // This prevents previous assignment settings from sticking around
+    clearDomainSettings();
+
     // hash the available codecs (on the mixer)
+    _availableCodecs.clear(); // Make sure struct is clean
     auto codecPlugins = PluginManager::getInstance()->getCodecPlugins();
     std::for_each(codecPlugins.cbegin(), codecPlugins.cend(),
         [&](const CodecPluginPointer& codec) {
@@ -232,7 +238,7 @@ void AudioMixer::sendStatsPacket() {
     }
 
     // general stats
-    statsObject["useDynamicJitterBuffers"] = _numStaticJitterFrames == -1;
+    statsObject["useDynamicJitterBuffers"] = _numStaticJitterFrames == DEFAULT_NUM_STATIC_JITTER_FRAMES;
 
     statsObject["threads"] = _slavePool.numThreads();
 
@@ -490,6 +496,16 @@ int AudioMixer::prepareFrame(const SharedNodePointer& node, unsigned int frame)
     return data->checkBuffersBeforeFrameSend();
 }
 
+void AudioMixer::clearDomainSettings() {
+    _numStaticJitterFrames = DEFAULT_NUM_STATIC_JITTER_FRAMES;
+    _attenuationPerDoublingInDistance = DEFAULT_ATTENUATION_PER_DOUBLING_IN_DISTANCE;
+    _noiseMutingThreshold = DEFAULT_NOISE_MUTING_THRESHOLD;
+    _codecPreferenceOrder.clear();
+    _audioZones.clear();
+    _zoneSettings.clear();
+    _zoneReverbSettings.clear();
+}
+
 void AudioMixer::parseSettingsObject(const QJsonObject &settingsObject) {
     qDebug() << "AVX2 Support:" << (cpuSupportsAVX2() ? "enabled" : "disabled");
 
@@ -525,7 +541,7 @@ void AudioMixer::parseSettingsObject(const QJsonObject &settingsObject) {
             qDebug() << "Static desired jitter buffer frames:" << _numStaticJitterFrames;
         } else {
             qDebug() << "Disabling dynamic jitter buffers.";
-            _numStaticJitterFrames = -1;
+            _numStaticJitterFrames = DEFAULT_NUM_STATIC_JITTER_FRAMES;
         }
 
         // check for deprecated audio settings
diff --git a/assignment-client/src/audio/AudioMixer.h b/assignment-client/src/audio/AudioMixer.h
index 0641c04a6c..18e754016e 100644
--- a/assignment-client/src/audio/AudioMixer.h
+++ b/assignment-client/src/audio/AudioMixer.h
@@ -79,6 +79,7 @@ private:
     QString percentageForMixStats(int counter);
 
     void parseSettingsObject(const QJsonObject& settingsObject);
+    void clearDomainSettings();
 
     float _trailingMixRatio { 0.0f };
     float _throttlingRatio { 0.0f };

From 08eb6442b5c3ada5b4f07c8aa5b77260b7b79b29 Mon Sep 17 00:00:00 2001
From: Liv <liv@highfidelity.io>
Date: Mon, 15 May 2017 18:36:36 -0700
Subject: [PATCH 090/135] Add function findEntitiesByType
 EntityScriptingInterface

Updated EntityScriptingInterface.cpp and .h to create a new function for
the Entities API that can be called to filter out entities found by a
specific entity type.
---
 .../entities/src/EntityScriptingInterface.cpp | 20 +++++++++++++++++++
 .../entities/src/EntityScriptingInterface.h   |  7 +++++++
 2 files changed, 27 insertions(+)

diff --git a/libraries/entities/src/EntityScriptingInterface.cpp b/libraries/entities/src/EntityScriptingInterface.cpp
index ffb65a2dba..e2726dada2 100644
--- a/libraries/entities/src/EntityScriptingInterface.cpp
+++ b/libraries/entities/src/EntityScriptingInterface.cpp
@@ -662,6 +662,26 @@ QVector<QUuid> EntityScriptingInterface::findEntitiesInFrustum(QVariantMap frust
     return result;
 }
 
+QVector<QUuid> EntityScriptingInterface::findEntitiesByType(const QString entityType, const glm::vec3& center, float radius) const {
+	EntityTypes::EntityType type = EntityTypes::getEntityTypeFromName(entityType);
+
+	QVector<QUuid> result;
+	if (_entityTree) {
+		QVector<EntityItemPointer> entities;
+		_entityTree->withReadLock([&] {
+			_entityTree->findEntities(center, radius, entities);
+		});
+
+		foreach(EntityItemPointer entity, entities) {
+			if (entity->getType() == type)
+			{
+				result << entity->getEntityItemID();
+			}
+		}
+	}
+	return result;
+}
+
 RayToEntityIntersectionResult EntityScriptingInterface::findRayIntersection(const PickRay& ray, bool precisionPicking, 
                 const QScriptValue& entityIdsToInclude, const QScriptValue& entityIdsToDiscard, bool visibleOnly, bool collidableOnly) {
     PROFILE_RANGE(script_entities, __FUNCTION__);
diff --git a/libraries/entities/src/EntityScriptingInterface.h b/libraries/entities/src/EntityScriptingInterface.h
index f5656860e3..5e1d5ecf61 100644
--- a/libraries/entities/src/EntityScriptingInterface.h
+++ b/libraries/entities/src/EntityScriptingInterface.h
@@ -215,6 +215,13 @@ public slots:
     /// this function will not find any models in script engine contexts which don't have access to models
     Q_INVOKABLE QVector<QUuid> findEntitiesInFrustum(QVariantMap frustum) const;
 
+	/// finds models within a sphere given by the center point and radius
+	/// @param {QString} string representation of entity type
+	/// @param {vec3} center point
+	/// @param {float} radius to search
+	/// this function will not find any models in script engine contexts which don't have access to models
+	Q_INVOKABLE QVector<QUuid> findEntitiesByType(const QString entityType, const glm::vec3& center, float radius) const;
+
     /// If the scripting context has visible entities, this will determine a ray intersection, the results
     /// may be inaccurate if the engine is unable to access the visible entities, in which case result.accurate
     /// will be false.

From 6d9bf2b33eb5de7bfd81a313896e7b64610804e4 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Tue, 16 May 2017 13:58:42 +1200
Subject: [PATCH 091/135] Typos

---
 scripts/system/playRecordingAC.js | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index f62451154b..3d87e9a53f 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -286,7 +286,7 @@
         function play(user, recording, position, orientation) {
             var errorMessage;
 
-            if (autoPlayTimer) {  // Cancel autoplay.
+            if (autoPlayTimer) {  // Cancel auto-play.
                 Script.clearTimeout(autoPlayTimer);
                 autoPlayTimer = null;
             }
@@ -295,7 +295,7 @@
 
             if (Entity.create(recording, position, orientation)) {
                 log("Play recording " + recording);
-                isPlayingRecording = true;
+                isPlayingRecording = true;  // Immediate feedback.
                 recordingFilename = recording;
                 playRecording(recordingFilename, position, orientation);
             } else {
@@ -303,7 +303,7 @@
                 log(errorMessage);
                 error(errorMessage);
 
-                autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_ERROR_INTERVAL);  // Resume autoplay later.
+                autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_ERROR_INTERVAL);  // Resume auto-play later.
             }
         }
 
@@ -315,7 +315,7 @@
             Script.setTimeout(function () {
                 recording = Entity.find();
                 if (recording) {
-                    log("Play persisted recording " + recordingFilename);
+                    log("Play persisted recording " + recording.recording);
                     userID = null;
                     playRecording(recording.recording, recording.position, recording.orientation);
                 } else {

From a606f8a8d46810820f7b4ff6d9b695476ad7ac10 Mon Sep 17 00:00:00 2001
From: Liv Erickson <Liv Erickson>
Date: Mon, 15 May 2017 20:28:48 -0700
Subject: [PATCH 092/135] Fixing code style

---
 libraries/entities/src/EntityScriptingInterface.cpp | 3 +--
 libraries/entities/src/EntityScriptingInterface.h   | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/libraries/entities/src/EntityScriptingInterface.cpp b/libraries/entities/src/EntityScriptingInterface.cpp
index e2726dada2..ab2f342a12 100644
--- a/libraries/entities/src/EntityScriptingInterface.cpp
+++ b/libraries/entities/src/EntityScriptingInterface.cpp
@@ -673,8 +673,7 @@ QVector<QUuid> EntityScriptingInterface::findEntitiesByType(const QString entity
 		});
 
 		foreach(EntityItemPointer entity, entities) {
-			if (entity->getType() == type)
-			{
+			if (entity->getType() == type){
 				result << entity->getEntityItemID();
 			}
 		}
diff --git a/libraries/entities/src/EntityScriptingInterface.h b/libraries/entities/src/EntityScriptingInterface.h
index 5e1d5ecf61..ac176f6267 100644
--- a/libraries/entities/src/EntityScriptingInterface.h
+++ b/libraries/entities/src/EntityScriptingInterface.h
@@ -212,14 +212,14 @@ public slots:
     /// - orientation
     /// - projection
     /// - centerRadius
-    /// this function will not find any models in script engine contexts which don't have access to models
+    /// this function will not find any models in script engine contexts which don't have access to entities
     Q_INVOKABLE QVector<QUuid> findEntitiesInFrustum(QVariantMap frustum) const;
 
 	/// finds models within a sphere given by the center point and radius
 	/// @param {QString} string representation of entity type
 	/// @param {vec3} center point
 	/// @param {float} radius to search
-	/// this function will not find any models in script engine contexts which don't have access to models
+	/// this function will not find any entities in script engine contexts which don't have access to models
 	Q_INVOKABLE QVector<QUuid> findEntitiesByType(const QString entityType, const glm::vec3& center, float radius) const;
 
     /// If the scripting context has visible entities, this will determine a ray intersection, the results

From 4b175e98e953332d59ea5a279be93f33dd22eb00 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Tue, 16 May 2017 15:30:30 +1200
Subject: [PATCH 093/135] Delete persistence entity if recording fails to load
 for manual playback

---
 scripts/system/playRecordingAC.js | 38 ++++++++++++++++++++++++-------
 1 file changed, 30 insertions(+), 8 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index 3d87e9a53f..3eb36a2a24 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -48,9 +48,17 @@
             searchState = SEARCH_IDLE,
             otherPlayersPlaying,
             otherPlayersPlayingCounts,
-            pauseCount;
+            pauseCount,
+            isDestroyLater = false,
+
+            destroy;
 
         function onUpdateTimestamp() {
+            if (isDestroyLater) {
+                destroy();
+                return;
+            }
+
             userData.timestamp = Date.now();
             Entities.editEntity(entityID, { userData: JSON.stringify(userData) });
             EntityViewer.queryOctree();  // Keep up to date ready for find().
@@ -229,7 +237,7 @@
             return result;
         }
 
-        function destroy() {
+        destroy = function () {
             // Delete current persistence entity.
             if (entityID !== null) {  // Just in case.
                 Entities.deleteEntity(entityID);
@@ -240,6 +248,11 @@
                 Script.clearInterval(updateTimestampTimer);
                 updateTimestampTimer = null;
             }
+        };
+
+        function destroyLater() {
+            // Schedules a call to destroy() when timer threading suits.
+            isDestroyLater = true;
         }
 
         function setUp() {
@@ -260,6 +273,7 @@
             create: create,
             find: find,
             destroy: destroy,
+            destroyLater: destroyLater,
             setUp: setUp,
             tearDown: tearDown
         };
@@ -297,7 +311,7 @@
                 log("Play recording " + recording);
                 isPlayingRecording = true;  // Immediate feedback.
                 recordingFilename = recording;
-                playRecording(recordingFilename, position, orientation);
+                playRecording(recordingFilename, position, orientation, true);
             } else {
                 errorMessage = "Could not persist recording " + recording.slice(4);  // Remove leading "atp:".
                 log(errorMessage);
@@ -317,14 +331,17 @@
                 if (recording) {
                     log("Play persisted recording " + recording.recording);
                     userID = null;
-                    playRecording(recording.recording, recording.position, recording.orientation);
+                    autoPlayTimer = null;
+                    isPlayingRecording = true;  // Immediate feedback.
+                    recordingFilename = recording.recording;
+                    playRecording(recording.recording, recording.position, recording.orientation, false);
                 } else {
                     autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_SEARCH_INTERVAL);  // Try again soon.
                 }
             }, Math.random() * AUTOPLAY_SEARCH_DELTA);
         }
 
-        playRecording = function (recording, position, orientation) {
+        playRecording = function (recording, position, orientation, isManual) {
             Recording.loadRecording(recording, function (success) {
                 var errorMessage;
 
@@ -342,17 +359,22 @@
                     Recording.setPlayerLoop(true);
                     Recording.setPlayerUseSkeletonModel(true);
 
-                    isPlayingRecording = true;
-                    recordingFilename = recording;
-
                     Recording.setPlayerTime(0.0);
                     Recording.startPlaying();
 
                     UserActivityLogger.logAction("playRecordingAC_play_recording");
                 } else {
+                    if (isManual) {
+                        // Delete persistence entity if manual play request.
+                        Entity.destroyLater();  // Schedule for deletion; works around timer threading issues.
+                    }
+
                     errorMessage = "Could not load recording " + recording.slice(4);  // Remove leading "atp:".
                     log(errorMessage);
                     error(errorMessage);
+
+                    isPlayingRecording = false;
+                    recordingFilename = "";
                     autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_ERROR_INTERVAL);  // Try again later.
                 }
             });

From ae458dcbcfaf32f1c9da0a0a752e8fc8fa506935 Mon Sep 17 00:00:00 2001
From: Liv Erickson <liv@highfidelity.io>
Date: Mon, 15 May 2017 20:33:22 -0700
Subject: [PATCH 094/135] changing models to more generally reference entities
 in comment

---
 libraries/entities/src/EntityScriptingInterface.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libraries/entities/src/EntityScriptingInterface.h b/libraries/entities/src/EntityScriptingInterface.h
index ac176f6267..575528fa78 100644
--- a/libraries/entities/src/EntityScriptingInterface.h
+++ b/libraries/entities/src/EntityScriptingInterface.h
@@ -215,11 +215,11 @@ public slots:
     /// this function will not find any models in script engine contexts which don't have access to entities
     Q_INVOKABLE QVector<QUuid> findEntitiesInFrustum(QVariantMap frustum) const;
 
-	/// finds models within a sphere given by the center point and radius
+	/// finds entities of the indicated type within a sphere given by the center point and radius
 	/// @param {QString} string representation of entity type
 	/// @param {vec3} center point
 	/// @param {float} radius to search
-	/// this function will not find any entities in script engine contexts which don't have access to models
+	/// this function will not find any entities in script engine contexts which don't have access to entities
 	Q_INVOKABLE QVector<QUuid> findEntitiesByType(const QString entityType, const glm::vec3& center, float radius) const;
 
     /// If the scripting context has visible entities, this will determine a ray intersection, the results

From 32fd905918c5dd480e8e6378f63305a75864da9d Mon Sep 17 00:00:00 2001
From: Liv Erickson <liv@highfidelity.io>
Date: Mon, 15 May 2017 20:49:30 -0700
Subject: [PATCH 095/135] style pass

---
 libraries/entities/src/EntityScriptingInterface.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/entities/src/EntityScriptingInterface.cpp b/libraries/entities/src/EntityScriptingInterface.cpp
index ab2f342a12..b184d648da 100644
--- a/libraries/entities/src/EntityScriptingInterface.cpp
+++ b/libraries/entities/src/EntityScriptingInterface.cpp
@@ -673,7 +673,7 @@ QVector<QUuid> EntityScriptingInterface::findEntitiesByType(const QString entity
 		});
 
 		foreach(EntityItemPointer entity, entities) {
-			if (entity->getType() == type){
+			if (entity->getType() == type) {
 				result << entity->getEntityItemID();
 			}
 		}

From 8ab261d1b0a312c2cc151306b812a008aa6a4b5e Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Tue, 16 May 2017 15:52:34 +1200
Subject: [PATCH 096/135] Work around Script.clearTimeout() occasionally
 failing

---
 scripts/system/playRecordingAC.js | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index 3eb36a2a24..d1b931bc41 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -301,6 +301,8 @@
             var errorMessage;
 
             if (autoPlayTimer) {  // Cancel auto-play.
+                // FIXME: Once in a while Script.clearTimeout() fails.
+                // [DEBUG] [hifi.scriptengine] [3748] [agent] stopTimer -- not in _timerFunctionMap QObject(0x0)
                 Script.clearTimeout(autoPlayTimer);
                 autoPlayTimer = null;
             }
@@ -327,6 +329,11 @@
 
             // Random delay to help reduce collisions between AC scripts.
             Script.setTimeout(function () {
+                // Guard against Script.clearTimeout() in play() not always working.
+                if (isPlayingRecording) {
+                    return;
+                }
+
                 recording = Entity.find();
                 if (recording) {
                     log("Play persisted recording " + recording.recording);

From 0cd5fe35da64b1f83442864e580cac48c8069f71 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Tue, 16 May 2017 15:54:55 +1200
Subject: [PATCH 097/135] Lint

---
 scripts/system/playRecordingAC.js | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/scripts/system/playRecordingAC.js b/scripts/system/playRecordingAC.js
index d1b931bc41..98e5220c31 100644
--- a/scripts/system/playRecordingAC.js
+++ b/scripts/system/playRecordingAC.js
@@ -286,6 +286,7 @@
             recordingFilename = "",
             autoPlayTimer = null,
 
+            autoPlay,
             playRecording;
 
         function error(message) {
@@ -323,7 +324,7 @@
             }
         }
 
-        function autoPlay() {
+        autoPlay = function () {
             var recording,
                 AUTOPLAY_SEARCH_DELTA = 1000;
 
@@ -346,7 +347,7 @@
                     autoPlayTimer = Script.setTimeout(autoPlay, AUTOPLAY_SEARCH_INTERVAL);  // Try again soon.
                 }
             }, Math.random() * AUTOPLAY_SEARCH_DELTA);
-        }
+        };
 
         playRecording = function (recording, position, orientation, isManual) {
             Recording.loadRecording(recording, function (success) {

From 9e08dadaf40d05df5824935981b62406ef937474 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Mon, 15 May 2017 22:11:42 -0700
Subject: [PATCH 098/135] Remove ObjectActionSpring

---
 interface/src/InterfaceDynamicFactory.cpp     |   4 +-
 .../entities/src/EntityDynamicInterface.cpp   |   8 +-
 .../entities/src/EntityDynamicInterface.h     |   9 -
 libraries/physics/src/ObjectActionSpring.cpp  | 378 ------------------
 libraries/physics/src/ObjectActionSpring.h    |  56 ---
 5 files changed, 6 insertions(+), 449 deletions(-)
 delete mode 100644 libraries/physics/src/ObjectActionSpring.cpp
 delete mode 100644 libraries/physics/src/ObjectActionSpring.h

diff --git a/interface/src/InterfaceDynamicFactory.cpp b/interface/src/InterfaceDynamicFactory.cpp
index 49edaae90f..1bb33a7341 100644
--- a/interface/src/InterfaceDynamicFactory.cpp
+++ b/interface/src/InterfaceDynamicFactory.cpp
@@ -14,7 +14,6 @@
 #include <avatar/AvatarActionHold.h>
 #include <avatar/AvatarActionFarGrab.h>
 #include <ObjectActionOffset.h>
-#include <ObjectActionSpring.h>
 #include <ObjectActionTractor.h>
 #include <ObjectActionTravelOriented.h>
 #include <ObjectConstraintHinge.h>
@@ -33,7 +32,8 @@ EntityDynamicPointer interfaceDynamicFactory(EntityDynamicType type, const QUuid
         case DYNAMIC_TYPE_OFFSET:
             return std::make_shared<ObjectActionOffset>(id, ownerEntity);
         case DYNAMIC_TYPE_SPRING:
-            return std::make_shared<ObjectActionSpring>(id, ownerEntity);
+            // the old "Spring" action moved to "Tractor"
+            return std::make_shared<ObjectActionTractor>(id, ownerEntity);
         case DYNAMIC_TYPE_TRACTOR:
             return std::make_shared<ObjectActionTractor>(id, ownerEntity);
         case DYNAMIC_TYPE_HOLD:
diff --git a/libraries/entities/src/EntityDynamicInterface.cpp b/libraries/entities/src/EntityDynamicInterface.cpp
index 822ac1c9d6..4bcb0a6027 100644
--- a/libraries/entities/src/EntityDynamicInterface.cpp
+++ b/libraries/entities/src/EntityDynamicInterface.cpp
@@ -43,7 +43,7 @@
                          |                        |
               +--------------------+     +-----------------------+
               |                    |     |                       |
-              | ObjectActionSpring |     | ObjectConstraintHinge |
+              | ObjectActionTractor|     | ObjectConstraintHinge |
               |     (physics)      |     |       (physics)       |
               +--------------------+     +-----------------------+
 
@@ -60,7 +60,7 @@ script or when receiving information via an EntityTree data-stream (either over
 svo file).
 
 In the interface, if an EntityItem has dynamics, this EntityItem will have pointers to ObjectDynamic
-subclass (like ObjectDynamicSpring) instantiations.  Code in the entities library affects a dynamic-object
+subclass (like ObjectDynamicTractor) instantiations.  Code in the entities library affects a dynamic-object
 via the EntityDynamicInterface (which knows nothing about bullet).  When the ObjectDynamic subclass
 instance is created, it is registered as a dynamic with bullet.  Bullet will call into code in this
 instance with the btDynamicInterface every physics-simulation step.
@@ -75,11 +75,11 @@ right now the AssignmentDynamic class is a place-holder.
 
 The dynamic-objects are instantiated by singleton (dependecy) subclasses of EntityDynamicFactoryInterface.
 In the interface, the subclass is an InterfaceDynamicFactory and it will produce things like
-ObjectDynamicSpring.  In an entity-server the subclass is an AssignmentDynamicFactory and it always
+ObjectDynamicTractor.  In an entity-server the subclass is an AssignmentDynamicFactory and it always
 produces AssignmentDynamics.
 
 Depending on the dynamic's type, it will have various arguments.  When a script changes an argument of an
-dynamic, the argument-holding member-variables of ObjectDynamicSpring (in this example) are updated and
+dynamic, the argument-holding member-variables of ObjectDynamicTractor (in this example) are updated and
 also serialized into _dynamicData in the EntityItem.  Each subclass of ObjectDynamic knows how to serialize
 and deserialize its own arguments.  _dynamicData is what gets sent over the wire or saved in an svo file.
 When a packet-reader receives data for _dynamicData, it will save it in the EntityItem; this causes the
diff --git a/libraries/entities/src/EntityDynamicInterface.h b/libraries/entities/src/EntityDynamicInterface.h
index b27e600660..40e39eecf1 100644
--- a/libraries/entities/src/EntityDynamicInterface.h
+++ b/libraries/entities/src/EntityDynamicInterface.h
@@ -94,15 +94,6 @@ public:
                                        QString argumentName, bool& ok, bool required = true);
 
 protected:
-    virtual glm::vec3 getPosition() = 0;
-    // virtual void setPosition(glm::vec3 position) = 0;
-    virtual glm::quat getRotation() = 0;
-    // virtual void setRotation(glm::quat rotation) = 0;
-    virtual glm::vec3 getLinearVelocity() = 0;
-    virtual void setLinearVelocity(glm::vec3 linearVelocity) = 0;
-    virtual glm::vec3 getAngularVelocity() = 0;
-    virtual void setAngularVelocity(glm::vec3 angularVelocity) = 0;
-
     QUuid _id;
     EntityDynamicType _type;
     bool _active { false };
diff --git a/libraries/physics/src/ObjectActionSpring.cpp b/libraries/physics/src/ObjectActionSpring.cpp
deleted file mode 100644
index 0014d4e914..0000000000
--- a/libraries/physics/src/ObjectActionSpring.cpp
+++ /dev/null
@@ -1,378 +0,0 @@
-//
-//  ObjectActionSpring.cpp
-//  libraries/physics/src
-//
-//  Created by Seth Alves 2015-6-5
-//  Copyright 2015 High Fidelity, Inc.
-//
-//  Distributed under the Apache License, Version 2.0.
-//  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
-//
-
-#include "QVariantGLM.h"
-
-#include "ObjectActionSpring.h"
-
-#include "PhysicsLogging.h"
-
-const float SPRING_MAX_SPEED = 10.0f;
-const float MAX_SPRING_TIMESCALE = 600.0f; // 10 min is a long time
-
-const uint16_t ObjectActionSpring::springVersion = 1;
-
-
-ObjectActionSpring::ObjectActionSpring(const QUuid& id, EntityItemPointer ownerEntity) :
-    ObjectAction(DYNAMIC_TYPE_SPRING, id, ownerEntity),
-    _positionalTarget(glm::vec3(0.0f)),
-    _desiredPositionalTarget(glm::vec3(0.0f)),
-    _linearTimeScale(FLT_MAX),
-    _positionalTargetSet(true),
-    _rotationalTarget(glm::quat()),
-    _desiredRotationalTarget(glm::quat()),
-    _angularTimeScale(FLT_MAX),
-    _rotationalTargetSet(true) {
-    #if WANT_DEBUG
-    qCDebug(physics) << "ObjectActionSpring::ObjectActionSpring";
-    #endif
-}
-
-ObjectActionSpring::~ObjectActionSpring() {
-    #if WANT_DEBUG
-    qCDebug(physics) << "ObjectActionSpring::~ObjectActionSpring";
-    #endif
-}
-
-bool ObjectActionSpring::getTarget(float deltaTimeStep, glm::quat& rotation, glm::vec3& position,
-                                   glm::vec3& linearVelocity, glm::vec3& angularVelocity,
-                                   float& linearTimeScale, float& angularTimeScale) {
-    SpatiallyNestablePointer other = getOther();
-    withReadLock([&]{
-        linearTimeScale = _linearTimeScale;
-        angularTimeScale = _angularTimeScale;
-
-        if (!_otherID.isNull()) {
-            if (other) {
-                rotation = _desiredRotationalTarget * other->getRotation();
-                position = other->getRotation() * _desiredPositionalTarget + other->getPosition();
-            } else {
-                // we should have an "other" but can't find it, so disable the spring.
-                linearTimeScale = FLT_MAX;
-                angularTimeScale = FLT_MAX;
-            }
-        } else {
-            rotation = _desiredRotationalTarget;
-            position = _desiredPositionalTarget;
-        }
-        linearVelocity = glm::vec3();
-        angularVelocity = glm::vec3();
-    });
-    return true;
-}
-
-bool ObjectActionSpring::prepareForSpringUpdate(btScalar deltaTimeStep) {
-    auto ownerEntity = _ownerEntity.lock();
-    if (!ownerEntity) {
-        return false;
-    }
-
-    glm::quat rotation;
-    glm::vec3 position;
-    glm::vec3 linearVelocity;
-    glm::vec3 angularVelocity;
-
-    bool linearValid = false;
-    int linearSpringCount = 0;
-    bool angularValid = false;
-    int angularSpringCount = 0;
-
-    QList<EntityDynamicPointer> springDerivedActions;
-    springDerivedActions.append(ownerEntity->getActionsOfType(DYNAMIC_TYPE_SPRING));
-    springDerivedActions.append(ownerEntity->getActionsOfType(DYNAMIC_TYPE_FAR_GRAB));
-    springDerivedActions.append(ownerEntity->getActionsOfType(DYNAMIC_TYPE_HOLD));
-
-    foreach (EntityDynamicPointer action, springDerivedActions) {
-        std::shared_ptr<ObjectActionSpring> springAction = std::static_pointer_cast<ObjectActionSpring>(action);
-        glm::quat rotationForAction;
-        glm::vec3 positionForAction;
-        glm::vec3 linearVelocityForAction;
-        glm::vec3 angularVelocityForAction;
-        float linearTimeScale;
-        float angularTimeScale;
-        bool success = springAction->getTarget(deltaTimeStep,
-                                               rotationForAction, positionForAction,
-                                               linearVelocityForAction, angularVelocityForAction,
-                                               linearTimeScale, angularTimeScale);
-        if (success) {
-            if (angularTimeScale < MAX_SPRING_TIMESCALE) {
-                angularValid = true;
-                angularSpringCount++;
-                angularVelocity += angularVelocityForAction;
-                if (springAction.get() == this) {
-                    // only use the rotation for this action
-                    rotation = rotationForAction;
-                }
-            }
-
-            if (linearTimeScale < MAX_SPRING_TIMESCALE) {
-                linearValid = true;
-                linearSpringCount++;
-                position += positionForAction;
-                linearVelocity += linearVelocityForAction;
-            }
-        }
-    }
-
-    if ((angularValid && angularSpringCount > 0) || (linearValid && linearSpringCount > 0)) {
-        withWriteLock([&]{
-            if (linearValid && linearSpringCount > 0) {
-                position /= linearSpringCount;
-                linearVelocity /= linearSpringCount;
-                _positionalTarget = position;
-                _linearVelocityTarget = linearVelocity;
-                _positionalTargetSet = true;
-                _active = true;
-            }
-            if (angularValid && angularSpringCount > 0) {
-                angularVelocity /= angularSpringCount;
-                _rotationalTarget = rotation;
-                _angularVelocityTarget = angularVelocity;
-                _rotationalTargetSet = true;
-                _active = true;
-            }
-        });
-    }
-
-    return linearValid || angularValid;
-}
-
-
-void ObjectActionSpring::updateActionWorker(btScalar deltaTimeStep) {
-    if (!prepareForSpringUpdate(deltaTimeStep)) {
-        return;
-    }
-
-    withReadLock([&]{
-        auto ownerEntity = _ownerEntity.lock();
-        if (!ownerEntity) {
-            return;
-        }
-
-        void* physicsInfo = ownerEntity->getPhysicsInfo();
-        if (!physicsInfo) {
-            return;
-        }
-        ObjectMotionState* motionState = static_cast<ObjectMotionState*>(physicsInfo);
-        btRigidBody* rigidBody = motionState->getRigidBody();
-        if (!rigidBody) {
-            qCDebug(physics) << "ObjectActionSpring::updateActionWorker no rigidBody";
-            return;
-        }
-
-        if (_linearTimeScale < MAX_SPRING_TIMESCALE) {
-            btVector3 targetVelocity(0.0f, 0.0f, 0.0f);
-            btVector3 offset = rigidBody->getCenterOfMassPosition() - glmToBullet(_positionalTarget);
-            float offsetLength = offset.length();
-            if (offsetLength > FLT_EPSILON) {
-                float speed = glm::min(offsetLength / _linearTimeScale, SPRING_MAX_SPEED);
-                targetVelocity = (-speed / offsetLength) * offset;
-                if (speed > rigidBody->getLinearSleepingThreshold()) {
-                    forceBodyNonStatic();
-                    rigidBody->activate();
-                }
-            }
-            // this action is aggresively critically damped and defeats the current velocity
-            rigidBody->setLinearVelocity(targetVelocity);
-        }
-
-        if (_angularTimeScale < MAX_SPRING_TIMESCALE) {
-            btVector3 targetVelocity(0.0f, 0.0f, 0.0f);
-
-            btQuaternion bodyRotation = rigidBody->getOrientation();
-            auto alignmentDot = bodyRotation.dot(glmToBullet(_rotationalTarget));
-            const float ALMOST_ONE = 0.99999f;
-            if (glm::abs(alignmentDot) < ALMOST_ONE) {
-                btQuaternion target = glmToBullet(_rotationalTarget);
-                if (alignmentDot < 0.0f) {
-                    target = -target;
-                }
-                // if dQ is the incremental rotation that gets an object from Q0 to Q1 then:
-                //
-                //      Q1 = dQ * Q0
-                //
-                // solving for dQ gives:
-                //
-                //      dQ = Q1 * Q0^
-                btQuaternion deltaQ = target * bodyRotation.inverse();
-                float speed = deltaQ.getAngle() / _angularTimeScale;
-                targetVelocity = speed * deltaQ.getAxis();
-                if (speed > rigidBody->getAngularSleepingThreshold()) {
-                    rigidBody->activate();
-                }
-            }
-            // this action is aggresively critically damped and defeats the current velocity
-            rigidBody->setAngularVelocity(targetVelocity);
-        }
-    });
-}
-
-const float MIN_TIMESCALE = 0.1f;
-
-
-bool ObjectActionSpring::updateArguments(QVariantMap arguments) {
-    glm::vec3 positionalTarget;
-    float linearTimeScale;
-    glm::quat rotationalTarget;
-    float angularTimeScale;
-    QUuid otherID;
-
-
-    bool needUpdate = false;
-    bool somethingChanged = ObjectDynamic::updateArguments(arguments);
-    withReadLock([&]{
-        // targets are required, spring-constants are optional
-        bool ok = true;
-        positionalTarget = EntityDynamicInterface::extractVec3Argument("spring action", arguments, "targetPosition", ok, false);
-        if (!ok) {
-            positionalTarget = _desiredPositionalTarget;
-        }
-        ok = true;
-        linearTimeScale = EntityDynamicInterface::extractFloatArgument("spring action", arguments, "linearTimeScale", ok, false);
-        if (!ok || linearTimeScale <= 0.0f) {
-            linearTimeScale = _linearTimeScale;
-        }
-
-        ok = true;
-        rotationalTarget = EntityDynamicInterface::extractQuatArgument("spring action", arguments, "targetRotation", ok, false);
-        if (!ok) {
-            rotationalTarget = _desiredRotationalTarget;
-        }
-
-        ok = true;
-        angularTimeScale =
-            EntityDynamicInterface::extractFloatArgument("spring action", arguments, "angularTimeScale", ok, false);
-        if (!ok) {
-            angularTimeScale = _angularTimeScale;
-        }
-
-        ok = true;
-        otherID = QUuid(EntityDynamicInterface::extractStringArgument("spring action",
-                                                                            arguments, "otherID", ok, false));
-        if (!ok) {
-            otherID = _otherID;
-        }
-
-        if (somethingChanged ||
-            positionalTarget != _desiredPositionalTarget ||
-            linearTimeScale != _linearTimeScale ||
-            rotationalTarget != _desiredRotationalTarget ||
-            angularTimeScale != _angularTimeScale ||
-            otherID != _otherID) {
-            // something changed
-            needUpdate = true;
-        }
-    });
-
-    if (needUpdate) {
-        withWriteLock([&] {
-            _desiredPositionalTarget = positionalTarget;
-            _linearTimeScale = glm::max(MIN_TIMESCALE, glm::abs(linearTimeScale));
-            _desiredRotationalTarget = rotationalTarget;
-            _angularTimeScale = glm::max(MIN_TIMESCALE, glm::abs(angularTimeScale));
-            _otherID = otherID;
-            _active = true;
-
-            auto ownerEntity = _ownerEntity.lock();
-            if (ownerEntity) {
-                ownerEntity->setDynamicDataDirty(true);
-                ownerEntity->setDynamicDataNeedsTransmit(true);
-            }
-        });
-        activateBody();
-    }
-
-    return true;
-}
-
-QVariantMap ObjectActionSpring::getArguments() {
-    QVariantMap arguments = ObjectDynamic::getArguments();
-    withReadLock([&] {
-        arguments["linearTimeScale"] = _linearTimeScale;
-        arguments["targetPosition"] = glmToQMap(_desiredPositionalTarget);
-
-        arguments["targetRotation"] = glmToQMap(_desiredRotationalTarget);
-        arguments["angularTimeScale"] = _angularTimeScale;
-
-        arguments["otherID"] = _otherID;
-    });
-    return arguments;
-}
-
-void ObjectActionSpring::serializeParameters(QDataStream& dataStream) const {
-    withReadLock([&] {
-        dataStream << _desiredPositionalTarget;
-        dataStream << _linearTimeScale;
-        dataStream << _positionalTargetSet;
-        dataStream << _desiredRotationalTarget;
-        dataStream << _angularTimeScale;
-        dataStream << _rotationalTargetSet;
-        dataStream << localTimeToServerTime(_expires);
-        dataStream << _tag;
-        dataStream << _otherID;
-    });
-}
-
-QByteArray ObjectActionSpring::serialize() const {
-    QByteArray serializedActionArguments;
-    QDataStream dataStream(&serializedActionArguments, QIODevice::WriteOnly);
-
-    dataStream << DYNAMIC_TYPE_SPRING;
-    dataStream << getID();
-    dataStream << ObjectActionSpring::springVersion;
-
-    serializeParameters(dataStream);
-
-    return serializedActionArguments;
-}
-
-void ObjectActionSpring::deserializeParameters(QByteArray serializedArguments, QDataStream& dataStream) {
-    withWriteLock([&] {
-        dataStream >> _desiredPositionalTarget;
-        dataStream >> _linearTimeScale;
-        dataStream >> _positionalTargetSet;
-
-        dataStream >> _desiredRotationalTarget;
-        dataStream >> _angularTimeScale;
-        dataStream >> _rotationalTargetSet;
-
-        quint64 serverExpires;
-        dataStream >> serverExpires;
-        _expires = serverTimeToLocalTime(serverExpires);
-
-        dataStream >> _tag;
-
-        dataStream >> _otherID;
-
-        _active = true;
-    });
-}
-
-void ObjectActionSpring::deserialize(QByteArray serializedArguments) {
-    QDataStream dataStream(serializedArguments);
-
-    EntityDynamicType type;
-    dataStream >> type;
-    assert(type == getType());
-
-    QUuid id;
-    dataStream >> id;
-    assert(id == getID());
-
-    uint16_t serializationVersion;
-    dataStream >> serializationVersion;
-    if (serializationVersion != ObjectActionSpring::springVersion) {
-        assert(false);
-        return;
-    }
-
-    deserializeParameters(serializedArguments, dataStream);
-}
diff --git a/libraries/physics/src/ObjectActionSpring.h b/libraries/physics/src/ObjectActionSpring.h
deleted file mode 100644
index 83a65b36b4..0000000000
--- a/libraries/physics/src/ObjectActionSpring.h
+++ /dev/null
@@ -1,56 +0,0 @@
-//
-//  ObjectActionSpring.h
-//  libraries/physics/src
-//
-//  Created by Seth Alves 2015-6-5
-//  Copyright 2015 High Fidelity, Inc.
-//
-//  Distributed under the Apache License, Version 2.0.
-//  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
-//
-
-#ifndef hifi_ObjectActionSpring_h
-#define hifi_ObjectActionSpring_h
-
-#include "ObjectAction.h"
-
-class ObjectActionSpring : public ObjectAction {
-public:
-    ObjectActionSpring(const QUuid& id, EntityItemPointer ownerEntity);
-    virtual ~ObjectActionSpring();
-
-    virtual bool updateArguments(QVariantMap arguments) override;
-    virtual QVariantMap getArguments() override;
-
-    virtual void updateActionWorker(float deltaTimeStep) override;
-
-    virtual QByteArray serialize() const override;
-    virtual void deserialize(QByteArray serializedArguments) override;
-
-    virtual bool getTarget(float deltaTimeStep, glm::quat& rotation, glm::vec3& position,
-                           glm::vec3& linearVelocity, glm::vec3& angularVelocity,
-                           float& linearTimeScale, float& angularTimeScale);
-
-protected:
-    static const uint16_t springVersion;
-
-    glm::vec3 _positionalTarget;
-    glm::vec3 _desiredPositionalTarget;
-    float _linearTimeScale;
-    bool _positionalTargetSet;
-
-    glm::quat _rotationalTarget;
-    glm::quat _desiredRotationalTarget;
-    float _angularTimeScale;
-    bool _rotationalTargetSet;
-
-    glm::vec3 _linearVelocityTarget;
-    glm::vec3 _angularVelocityTarget;
-
-    virtual bool prepareForSpringUpdate(btScalar deltaTimeStep);
-
-    void serializeParameters(QDataStream& dataStream) const;
-    void deserializeParameters(QByteArray serializedArguments, QDataStream& dataStream);
-};
-
-#endif // hifi_ObjectActionSpring_h

From 9b3754c2ee1bbee14ec810447ad10ad56cefeab4 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Mon, 15 May 2017 22:13:03 -0700
Subject: [PATCH 099/135] remove unused API from ObjectDynamic and friends

---
 assignment-client/src/AssignmentDynamic.cpp | 28 ------------
 assignment-client/src/AssignmentDynamic.h   |  7 ---
 libraries/physics/src/ObjectDynamic.cpp     | 50 ---------------------
 libraries/physics/src/ObjectDynamic.h       |  6 ---
 4 files changed, 91 deletions(-)

diff --git a/assignment-client/src/AssignmentDynamic.cpp b/assignment-client/src/AssignmentDynamic.cpp
index 026bc120bb..7adbd55c39 100644
--- a/assignment-client/src/AssignmentDynamic.cpp
+++ b/assignment-client/src/AssignmentDynamic.cpp
@@ -53,31 +53,3 @@ QVariantMap AssignmentDynamic::getArguments() {
     qDebug() << "UNEXPECTED -- AssignmentDynamic::getArguments called in assignment-client.";
     return QVariantMap();
 }
-
-glm::vec3 AssignmentDynamic::getPosition() {
-    qDebug() << "UNEXPECTED -- AssignmentDynamic::getPosition called in assignment-client.";
-    return glm::vec3(0.0f);
-}
-
-glm::quat AssignmentDynamic::getRotation() {
-    qDebug() << "UNEXPECTED -- AssignmentDynamic::getRotation called in assignment-client.";
-    return glm::quat();
-}
-
-glm::vec3 AssignmentDynamic::getLinearVelocity() {
-    qDebug() << "UNEXPECTED -- AssignmentDynamic::getLinearVelocity called in assignment-client.";
-    return glm::vec3(0.0f);
-}
-
-void AssignmentDynamic::setLinearVelocity(glm::vec3 linearVelocity) {
-    qDebug() << "UNEXPECTED -- AssignmentDynamic::setLinearVelocity called in assignment-client.";
-}
-
-glm::vec3 AssignmentDynamic::getAngularVelocity() {
-    qDebug() << "UNEXPECTED -- AssignmentDynamic::getAngularVelocity called in assignment-client.";
-    return glm::vec3(0.0f);
-}
-
-void AssignmentDynamic::setAngularVelocity(glm::vec3 angularVelocity) {
-    qDebug() << "UNEXPECTED -- AssignmentDynamic::setAngularVelocity called in assignment-client.";
-}
diff --git a/assignment-client/src/AssignmentDynamic.h b/assignment-client/src/AssignmentDynamic.h
index 604c418c13..d0fd72533f 100644
--- a/assignment-client/src/AssignmentDynamic.h
+++ b/assignment-client/src/AssignmentDynamic.h
@@ -39,13 +39,6 @@ private:
     QByteArray _data;
 
 protected:
-    virtual glm::vec3 getPosition() override;
-    virtual glm::quat getRotation() override;
-    virtual glm::vec3 getLinearVelocity() override;
-    virtual void setLinearVelocity(glm::vec3 linearVelocity) override;
-    virtual glm::vec3 getAngularVelocity() override;
-    virtual void setAngularVelocity(glm::vec3 angularVelocity) override;
-
     bool _active;
     EntityItemWeakPointer _ownerEntity;
 };
diff --git a/libraries/physics/src/ObjectDynamic.cpp b/libraries/physics/src/ObjectDynamic.cpp
index 253739375a..3deadd6468 100644
--- a/libraries/physics/src/ObjectDynamic.cpp
+++ b/libraries/physics/src/ObjectDynamic.cpp
@@ -160,56 +160,6 @@ btRigidBody* ObjectDynamic::getRigidBody() {
     return nullptr;
 }
 
-glm::vec3 ObjectDynamic::getPosition() {
-    auto rigidBody = getRigidBody();
-    if (!rigidBody) {
-        return glm::vec3(0.0f);
-    }
-    return bulletToGLM(rigidBody->getCenterOfMassPosition());
-}
-
-glm::quat ObjectDynamic::getRotation() {
-    auto rigidBody = getRigidBody();
-    if (!rigidBody) {
-        return glm::quat(0.0f, 0.0f, 0.0f, 1.0f);
-    }
-    return bulletToGLM(rigidBody->getOrientation());
-}
-
-glm::vec3 ObjectDynamic::getLinearVelocity() {
-    auto rigidBody = getRigidBody();
-    if (!rigidBody) {
-        return glm::vec3(0.0f);
-    }
-    return bulletToGLM(rigidBody->getLinearVelocity());
-}
-
-void ObjectDynamic::setLinearVelocity(glm::vec3 linearVelocity) {
-    auto rigidBody = getRigidBody();
-    if (!rigidBody) {
-        return;
-    }
-    rigidBody->setLinearVelocity(glmToBullet(glm::vec3(0.0f)));
-    rigidBody->activate();
-}
-
-glm::vec3 ObjectDynamic::getAngularVelocity() {
-    auto rigidBody = getRigidBody();
-    if (!rigidBody) {
-        return glm::vec3(0.0f);
-    }
-    return bulletToGLM(rigidBody->getAngularVelocity());
-}
-
-void ObjectDynamic::setAngularVelocity(glm::vec3 angularVelocity) {
-    auto rigidBody = getRigidBody();
-    if (!rigidBody) {
-        return;
-    }
-    rigidBody->setAngularVelocity(glmToBullet(angularVelocity));
-    rigidBody->activate();
-}
-
 void ObjectDynamic::activateBody(bool forceActivation) {
     auto rigidBody = getRigidBody();
     if (rigidBody) {
diff --git a/libraries/physics/src/ObjectDynamic.h b/libraries/physics/src/ObjectDynamic.h
index 582f47db77..7fdf2e323a 100644
--- a/libraries/physics/src/ObjectDynamic.h
+++ b/libraries/physics/src/ObjectDynamic.h
@@ -56,12 +56,6 @@ protected:
     btRigidBody* getOtherRigidBody(EntityItemID otherEntityID);
     EntityItemPointer getEntityByID(EntityItemID entityID) const;
     virtual btRigidBody* getRigidBody();
-    virtual glm::vec3 getPosition() override;
-    virtual glm::quat getRotation() override;
-    virtual glm::vec3 getLinearVelocity() override;
-    virtual void setLinearVelocity(glm::vec3 linearVelocity) override;
-    virtual glm::vec3 getAngularVelocity() override;
-    virtual void setAngularVelocity(glm::vec3 angularVelocity) override;
     virtual void activateBody(bool forceActivation = false);
     virtual void forceBodyNonStatic();
 

From e6accb61b0e8ea69151f9e1fc3008c7315d1e5fe Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Tue, 16 May 2017 08:09:20 -0700
Subject: [PATCH 100/135] more purging of legacy 'Spring' action

---
 libraries/entities/src/EntityDynamicInterface.cpp | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/libraries/entities/src/EntityDynamicInterface.cpp b/libraries/entities/src/EntityDynamicInterface.cpp
index 4bcb0a6027..f424c02e6e 100644
--- a/libraries/entities/src/EntityDynamicInterface.cpp
+++ b/libraries/entities/src/EntityDynamicInterface.cpp
@@ -50,7 +50,7 @@
 
 
 A dynamic is a callback which is registered with bullet.  A dynamic is called-back every physics
-simulation step and can do whatever it wants with the various datastructures it has available.  An
+simulation step and can do whatever it wants with the various datastructures it has available.  A
 dynamic, for example, can pull an EntityItem toward a point as if that EntityItem were connected to that
 point by a spring.
 
@@ -103,7 +103,7 @@ EntityDynamicType EntityDynamicInterface::dynamicTypeFromString(QString dynamicT
         return DYNAMIC_TYPE_OFFSET;
     }
     if (normalizedDynamicTypeString == "spring") {
-        return DYNAMIC_TYPE_SPRING;
+        return DYNAMIC_TYPE_TRACTOR;
     }
     if (normalizedDynamicTypeString == "tractor") {
         return DYNAMIC_TYPE_TRACTOR;
@@ -142,7 +142,6 @@ QString EntityDynamicInterface::dynamicTypeToString(EntityDynamicType dynamicTyp
         case DYNAMIC_TYPE_OFFSET:
             return "offset";
         case DYNAMIC_TYPE_SPRING:
-            return "spring";
         case DYNAMIC_TYPE_TRACTOR:
             return "tractor";
         case DYNAMIC_TYPE_HOLD:

From d705f529a096edb1840c041e410a57c900028731 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Tue, 16 May 2017 08:35:54 -0700
Subject: [PATCH 101/135] use 'tractor' instead of 'spring' in JS files

---
 script-archive/vrShop/item/shopItemGrab.js    | 50 +++++++++----------
 .../developer/tests/dynamics/dynamicsTests.js | 12 ++---
 .../tutorials/entity_scripts/springHold.js    |  2 +-
 scripts/tutorials/entity_scripts/touch.js     | 18 +++----
 .../marketplace/boppo/lookAtEntity.js         |  2 +-
 5 files changed, 42 insertions(+), 42 deletions(-)

diff --git a/script-archive/vrShop/item/shopItemGrab.js b/script-archive/vrShop/item/shopItemGrab.js
index 2b63ca1b53..f0488cb497 100644
--- a/script-archive/vrShop/item/shopItemGrab.js
+++ b/script-archive/vrShop/item/shopItemGrab.js
@@ -1,6 +1,6 @@
 //  shopItemGrab.js
 //  
-//  Semplified and coarse version of handControllerGrab.js with the addition of the ownerID concept.
+//  Simplified and coarse version of handControllerGrab.js with the addition of the ownerID concept.
 //  This grab is the only one which should run in the vrShop. It allows only near grab and add the feature of checking the ownerID. (See shopGrapSwapperEntityScript.js)
 //  
 
@@ -63,8 +63,8 @@ var NEAR_GRABBING_KINEMATIC = true; // force objects to be kinematic when near-g
 // equip
 //
 
-var EQUIP_SPRING_SHUTOFF_DISTANCE = 0.05;
-var EQUIP_SPRING_TIMEFRAME = 0.4; // how quickly objects move to their new position
+var EQUIP_TRACTOR_SHUTOFF_DISTANCE = 0.05;
+var EQUIP_TRACTOR_TIMEFRAME = 0.4; // how quickly objects move to their new position
 
 //
 // other constants
@@ -121,7 +121,7 @@ var STATE_EQUIP_SEARCHING = 11;
 var STATE_EQUIP = 12
 var STATE_CONTINUE_EQUIP_BD = 13; // equip while bumper is still held down
 var STATE_CONTINUE_EQUIP = 14;
-var STATE_EQUIP_SPRING = 16;
+var STATE_EQUIP_TRACTOR = 16;
 
 
 function stateToName(state) {
@@ -152,8 +152,8 @@ function stateToName(state) {
             return "continue_equip_bd";
         case STATE_CONTINUE_EQUIP:
             return "continue_equip";
-        case STATE_EQUIP_SPRING:
-            return "state_equip_spring";
+        case STATE_EQUIP_TRACTOR:
+            return "state_equip_tractor";
     }
 
     return "unknown";
@@ -216,7 +216,7 @@ function MyController(hand) {
             case STATE_EQUIP:
                 this.nearGrabbing();
                 break;
-            case STATE_EQUIP_SPRING:
+            case STATE_EQUIP_TRACTOR:
                 this.pullTowardEquipPosition()
                 break;
             case STATE_CONTINUE_NEAR_GRABBING:
@@ -404,14 +404,14 @@ function MyController(hand) {
                         return;
                     } else if (!properties.locked) {
                         var ownerObj = getEntityCustomData('ownerKey', intersection.entityID, null);
-                        
+
                         if (ownerObj == null || ownerObj.ownerID === MyAvatar.sessionUUID) {    //I can only grab new or already mine items
                             this.grabbedEntity = intersection.entityID;
                             if (this.state == STATE_SEARCHING) {
                                 this.setState(STATE_NEAR_GRABBING);
                             } else { // equipping
                                 if (typeof grabbableData.spatialKey !== 'undefined') {
-                                    this.setState(STATE_EQUIP_SPRING);
+                                    this.setState(STATE_EQUIP_TRACTOR);
                                 } else {
                                     this.setState(STATE_EQUIP);
                                 }
@@ -558,7 +558,7 @@ function MyController(hand) {
         var grabbedProperties = Entities.getEntityProperties(this.grabbedEntity, GRABBABLE_PROPERTIES);
         var grabbableData = getEntityCustomData(GRABBABLE_DATA_KEY, this.grabbedEntity, DEFAULT_GRABBABLE_DATA);
 
-        // use a spring to pull the object to where it will be when equipped
+        // use a tractor to pull the object to where it will be when equipped
         var relativeRotation = {
             x: 0.0,
             y: 0.0,
@@ -582,34 +582,34 @@ function MyController(hand) {
         var offset = Vec3.multiplyQbyV(targetRotation, relativePosition);
         var targetPosition = Vec3.sum(handPosition, offset);
 
-        if (typeof this.equipSpringID === 'undefined' ||
-            this.equipSpringID === null ||
-            this.equipSpringID === NULL_ACTION_ID) {
-            this.equipSpringID = Entities.addAction("spring", this.grabbedEntity, {
+        if (typeof this.equipTractorID === 'undefined' ||
+            this.equipTractorID === null ||
+            this.equipTractorID === NULL_ACTION_ID) {
+            this.equipTractorID = Entities.addAction("tractor", this.grabbedEntity, {
                 targetPosition: targetPosition,
-                linearTimeScale: EQUIP_SPRING_TIMEFRAME,
+                linearTimeScale: EQUIP_TRACTOR_TIMEFRAME,
                 targetRotation: targetRotation,
-                angularTimeScale: EQUIP_SPRING_TIMEFRAME,
+                angularTimeScale: EQUIP_TRACTOR_TIMEFRAME,
                 ttl: ACTION_TTL
             });
-            if (this.equipSpringID === NULL_ACTION_ID) {
-                this.equipSpringID = null;
+            if (this.equipTractorID === NULL_ACTION_ID) {
+                this.equipTractorID = null;
                 this.setState(STATE_OFF);
                 return;
             }
         } else {
-            Entities.updateAction(this.grabbedEntity, this.equipSpringID, {
+            Entities.updateAction(this.grabbedEntity, this.equipTractorID, {
                 targetPosition: targetPosition,
-                linearTimeScale: EQUIP_SPRING_TIMEFRAME,
+                linearTimeScale: EQUIP_TRACTOR_TIMEFRAME,
                 targetRotation: targetRotation,
-                angularTimeScale: EQUIP_SPRING_TIMEFRAME,
+                angularTimeScale: EQUIP_TRACTOR_TIMEFRAME,
                 ttl: ACTION_TTL
             });
         }
 
-        if (Vec3.distance(grabbedProperties.position, targetPosition) < EQUIP_SPRING_SHUTOFF_DISTANCE) {
-            Entities.deleteAction(this.grabbedEntity, this.equipSpringID);
-            this.equipSpringID = null;
+        if (Vec3.distance(grabbedProperties.position, targetPosition) < EQUIP_TRACTOR_SHUTOFF_DISTANCE) {
+            Entities.deleteAction(this.grabbedEntity, this.equipTractorID);
+            this.equipTractorID = null;
             this.setState(STATE_EQUIP);
         }
     };
@@ -862,4 +862,4 @@ function cleanup() {
 }
 
 Script.scriptEnding.connect(cleanup);
-Script.update.connect(update);
\ No newline at end of file
+Script.update.connect(update);
diff --git a/scripts/developer/tests/dynamics/dynamicsTests.js b/scripts/developer/tests/dynamics/dynamicsTests.js
index 376eff182b..c0b001eab3 100644
--- a/scripts/developer/tests/dynamics/dynamicsTests.js
+++ b/scripts/developer/tests/dynamics/dynamicsTests.js
@@ -28,7 +28,7 @@
 
 
 
-    function coneTwistAndSpringLeverTest(params) {
+    function coneTwistAndTractorLeverTest(params) {
         var pos = Vec3.sum(MyAvatar.position, Vec3.multiplyQbyV(MyAvatar.orientation, {x: 0, y: -0.5, z: -2}));
         var lifetime = params.lifetime;
 
@@ -84,10 +84,10 @@
             tag: "cone-twist test"
         });
 
-        Entities.addAction("spring", leverID, {
+        Entities.addAction("tractor", leverID, {
             targetRotation: { x: 0, y: 0, z: 0, w: 1 },
             angularTimeScale: 0.2,
-            tag: "cone-twist test spring"
+            tag: "cone-twist test tractor"
         });
 
 
@@ -349,11 +349,11 @@
             userData: "{ \"grabbableKey\": { \"grabbable\": true, \"kinematic\": false } }"
         });
 
-        Entities.addAction("spring", headID, {
+        Entities.addAction("tractor", headID, {
             targetRotation: { x: 0, y: 0, z: 0, w: 1 },
             angularTimeScale: 2.0,
             otherID: bodyID,
-            tag: "cone-twist test spring"
+            tag: "cone-twist test tractor"
         });
 
 
@@ -705,7 +705,7 @@
 
             if (event["dynamics-tests-command"]) {
                 var commandToFunctionMap = {
-                    "cone-twist-and-spring-lever-test": coneTwistAndSpringLeverTest,
+                    "cone-twist-and-tractor-lever-test": coneTwistAndTractorLeverTest,
                     "door-vs-world-test": doorVSWorldTest,
                     "hinge-chain-test": hingeChainTest,
                     "slider-vs-world-test": sliderVSWorldTest,
diff --git a/scripts/tutorials/entity_scripts/springHold.js b/scripts/tutorials/entity_scripts/springHold.js
index 12b34381a6..059ea2cc6f 100644
--- a/scripts/tutorials/entity_scripts/springHold.js
+++ b/scripts/tutorials/entity_scripts/springHold.js
@@ -113,4 +113,4 @@
     };
 
     return new SpringHold();
-});
\ No newline at end of file
+});
diff --git a/scripts/tutorials/entity_scripts/touch.js b/scripts/tutorials/entity_scripts/touch.js
index d6a59aa167..1d0586b350 100644
--- a/scripts/tutorials/entity_scripts/touch.js
+++ b/scripts/tutorials/entity_scripts/touch.js
@@ -2,7 +2,7 @@
 
     //  touch.js 
     // 
-    //  Sample file using spring action, haptic vibration, and color change to demonstrate two spheres 
+    //  Sample file using tractor action, haptic vibration, and color change to demonstrate two spheres 
     //  That can give a sense of touch to the holders.  
     //  Create two standard spheres, make them grabbable, and attach this entity script.  Grab them and touch them together.
     //  
@@ -53,7 +53,7 @@
         _this = this;
     }
 
-    function updateSpringAction(timescale) {
+    function updateTractorAction(timescale) {
         var targetProps = Entities.getEntityProperties(_this.entityID);
         //
         //  Look for nearby entities to touch 
@@ -113,7 +113,7 @@
         var success = Entities.updateAction(_this.copy, _this.actionID, props);
     }
 
-    function createSpringAction(timescale) {
+    function createTractorAction(timescale) {
 
         var targetProps = Entities.getEntityProperties(_this.entityID);
         var props = {
@@ -123,7 +123,7 @@
             angularTimeScale: timescale,
             ttl: ACTION_TTL
         };
-        _this.actionID = Entities.addAction("spring", _this.copy, props);
+        _this.actionID = Entities.addAction("tractor", _this.copy, props);
         return;
     }
 
@@ -170,7 +170,7 @@
         });
     }
 
-    function deleteSpringAction() {
+    function deleteTractorAction() {
         Entities.deleteAction(_this.copy, _this.actionID);
     }
 
@@ -188,19 +188,19 @@
         },
         startNearGrab: function(entityID, data) {
             createCopy();
-            createSpringAction(TIMESCALE);
+            createTractorAction(TIMESCALE);
             makeOriginalInvisible();
             setHand(Entities.getEntityProperties(_this.entityID).position);
         },
         continueNearGrab: function() {
-            updateSpringAction(TIMESCALE);
+            updateTractorAction(TIMESCALE);
         },
         releaseGrab: function() {
-            deleteSpringAction();
+            deleteTractorAction();
             deleteCopy();
             makeOriginalVisible();
         }
     };
 
     return new TouchExample();
-});
\ No newline at end of file
+});
diff --git a/unpublishedScripts/marketplace/boppo/lookAtEntity.js b/unpublishedScripts/marketplace/boppo/lookAtEntity.js
index ba072814f2..a0e9274db3 100644
--- a/unpublishedScripts/marketplace/boppo/lookAtEntity.js
+++ b/unpublishedScripts/marketplace/boppo/lookAtEntity.js
@@ -89,7 +89,7 @@ LookAtTarget = function(sourceEntityID) {
                 }
             });
             if (!actionFound) {
-                Entities.addAction('spring', _sourceEntityID, getNewActionProperties());
+                Entities.addAction('tractor', _sourceEntityID, getNewActionProperties());
             }
         }
     };

From e9c703b14728b3043a3d9f0efc7e0e0e674f0f42 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Tue, 16 May 2017 10:34:39 -0700
Subject: [PATCH 102/135] add deprecation log for DYNAMIC_TYPE_SPRING

---
 interface/src/InterfaceDynamicFactory.cpp | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/interface/src/InterfaceDynamicFactory.cpp b/interface/src/InterfaceDynamicFactory.cpp
index 1bb33a7341..e51f63d01b 100644
--- a/interface/src/InterfaceDynamicFactory.cpp
+++ b/interface/src/InterfaceDynamicFactory.cpp
@@ -32,8 +32,7 @@ EntityDynamicPointer interfaceDynamicFactory(EntityDynamicType type, const QUuid
         case DYNAMIC_TYPE_OFFSET:
             return std::make_shared<ObjectActionOffset>(id, ownerEntity);
         case DYNAMIC_TYPE_SPRING:
-            // the old "Spring" action moved to "Tractor"
-            return std::make_shared<ObjectActionTractor>(id, ownerEntity);
+            qDebug() << "The 'spring' Action is deprecated.  Replacing with 'tractor' Action.";
         case DYNAMIC_TYPE_TRACTOR:
             return std::make_shared<ObjectActionTractor>(id, ownerEntity);
         case DYNAMIC_TYPE_HOLD:

From 8eacf0ad4b8579a5f6f2be561002a1020924a45c Mon Sep 17 00:00:00 2001
From: Ryan Huffman <ryanhuffman@gmail.com>
Date: Tue, 16 May 2017 10:56:33 -0700
Subject: [PATCH 103/135] Remove unnecessary assert in Model.cpp

This clause inside was not longer valid - it is a valid state for
part->_meshIndex < _modelMeshRenderItems.size(). A better check might be
to compare it to the size of _meshStates which we use below, but we use
_meshStates.at(...) which will do the bounds checking, which makes the
assert unnecessary.
---
 libraries/render-utils/src/Model.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/libraries/render-utils/src/Model.cpp b/libraries/render-utils/src/Model.cpp
index 766a584b85..3a4ec19d5c 100644
--- a/libraries/render-utils/src/Model.cpp
+++ b/libraries/render-utils/src/Model.cpp
@@ -1052,7 +1052,6 @@ void Model::updateRig(float deltaTime, glm::mat4 parentTransform) {
 
 void Model::computeMeshPartLocalBounds() {
     for (auto& part : _modelMeshRenderItems) {
-        assert(part->_meshIndex < _modelMeshRenderItems.size());
         const Model::MeshState& state = _meshStates.at(part->_meshIndex);
         part->computeAdjustedLocalBound(state.clusterMatrices);
     }

From be7a9a2383aaa1cc9b84537458750d53f48acd4f Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Tue, 16 May 2017 11:00:25 -0700
Subject: [PATCH 104/135] warning fixes

---
 libraries/animation/src/AnimInverseKinematics.cpp | 6 +++---
 libraries/animation/src/AnimInverseKinematics.h   | 2 +-
 libraries/animation/src/IKTarget.cpp              | 4 ++--
 libraries/animation/src/IKTarget.h                | 2 +-
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index 11c143db23..c43d7b76dd 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -23,12 +23,12 @@
 
 AnimInverseKinematics::IKTargetVar::IKTargetVar(const QString& jointNameIn, const QString& positionVarIn, const QString& rotationVarIn,
                                                 const QString& typeVarIn, const QString& weightVarIn, float weightIn, const std::vector<float>& flexCoefficientsIn) :
+    jointName(jointNameIn),
     positionVar(positionVarIn),
     rotationVar(rotationVarIn),
     typeVar(typeVarIn),
     weightVar(weightVarIn),
     weight(weightIn),
-    jointName(jointNameIn),
     numFlexCoefficients(flexCoefficientsIn.size()),
     jointIndex(-1)
 {
@@ -39,12 +39,12 @@ AnimInverseKinematics::IKTargetVar::IKTargetVar(const QString& jointNameIn, cons
 }
 
 AnimInverseKinematics::IKTargetVar::IKTargetVar(const IKTargetVar& orig) :
+    jointName(orig.jointName),
     positionVar(orig.positionVar),
     rotationVar(orig.rotationVar),
     typeVar(orig.typeVar),
     weightVar(orig.weightVar),
     weight(orig.weight),
-    jointName(orig.jointName),
     numFlexCoefficients(orig.numFlexCoefficients),
     jointIndex(orig.jointIndex)
 {
@@ -305,7 +305,7 @@ int AnimInverseKinematics::solveTargetWithCCD(const IKTarget& target, AnimPoseVe
     // cache tip absolute position
     glm::vec3 tipPosition = absolutePoses[tipIndex].trans();
 
-    int chainDepth = 1;
+    size_t chainDepth = 1;
 
     // descend toward root, pivoting each joint to get tip closer to target position
     while (pivotIndex != _hipsIndex && pivotsParentIndex != -1) {
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index b798319ca9..cf03005b68 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -84,11 +84,11 @@ protected:
                     const QString& typeVarIn, const QString& weightVarIn, float weightIn, const std::vector<float>& flexCoefficientsIn);
         IKTargetVar(const IKTargetVar& orig);
 
+        QString jointName;
         QString positionVar;
         QString rotationVar;
         QString typeVar;
         QString weightVar;
-        QString jointName;
         float weight;
         float flexCoefficients[MAX_FLEX_COEFFICIENTS];
         size_t numFlexCoefficients;
diff --git a/libraries/animation/src/IKTarget.cpp b/libraries/animation/src/IKTarget.cpp
index ae23d9548f..18e656f583 100644
--- a/libraries/animation/src/IKTarget.cpp
+++ b/libraries/animation/src/IKTarget.cpp
@@ -21,10 +21,10 @@ void IKTarget::setFlexCoefficients(size_t numFlexCoefficientsIn, const float* fl
     }
 }
 
-float IKTarget::getFlexCoefficient(int chainDepth) const {
+float IKTarget::getFlexCoefficient(size_t chainDepth) const {
     const float DEFAULT_FLEX_COEFFICIENT = 0.5f;
 
-    if (chainDepth >= 0 && chainDepth < _numFlexCoefficients) {
+    if (chainDepth < _numFlexCoefficients) {
         return _flexCoefficients[chainDepth];
     } else {
         return DEFAULT_FLEX_COEFFICIENT;
diff --git a/libraries/animation/src/IKTarget.h b/libraries/animation/src/IKTarget.h
index 0e8bb614ea..1951d3ba7b 100644
--- a/libraries/animation/src/IKTarget.h
+++ b/libraries/animation/src/IKTarget.h
@@ -36,7 +36,7 @@ public:
     void setIndex(int index) { _index = index; }
     void setType(int);
     void setFlexCoefficients(size_t numFlexCoefficientsIn, const float* flexCoefficientsIn);
-    float getFlexCoefficient(int chainDepth) const;
+    float getFlexCoefficient(size_t chainDepth) const;
 
     void setWeight(float weight) { _weight = weight; }
     float getWeight() const { return _weight; }

From aa0394c2ef289d160af9da7fceb1e70d6d11d710 Mon Sep 17 00:00:00 2001
From: Zach Fox <fox@highfidelity.io>
Date: Tue, 16 May 2017 10:54:24 -0700
Subject: [PATCH 105/135] Fix case when user stories would be incorrectly
 deleted

---
 scripts/system/html/js/SnapshotReview.js | 29 +++++++++++++++++-------
 scripts/system/snapshot.js               | 10 ++++++--
 2 files changed, 29 insertions(+), 10 deletions(-)

diff --git a/scripts/system/html/js/SnapshotReview.js b/scripts/system/html/js/SnapshotReview.js
index 946e04beef..f962c7b624 100644
--- a/scripts/system/html/js/SnapshotReview.js
+++ b/scripts/system/html/js/SnapshotReview.js
@@ -359,7 +359,7 @@ function showUploadingMessage(selectedID, destination) {
     shareBarHelp.classList.add("uploading");
     shareBarHelp.setAttribute("data-destination", destination);
 }
-function hideUploadingMessageAndShare(selectedID, storyID) {
+function hideUploadingMessageAndMaybeShare(selectedID, storyID) {
     if (selectedID.id) {
         selectedID = selectedID.id; // sometimes (?), `containerID` is passed as an HTML object to these functions; we just want the ID
     }
@@ -382,21 +382,28 @@ function hideUploadingMessageAndShare(selectedID, storyID) {
                 var facebookButton = document.getElementById(selectedID + "facebookButton");
                 window.open(facebookButton.getAttribute("href"), "_blank");
                 shareBarHelp.innerHTML = facebookShareText;
+                // This emitWebEvent() call isn't necessary in the "hifi" and "blast" cases
+                // because the "removeFromStoryIDsToMaybeDelete()" call happens
+                // in snapshot.js when sharing with that method.
+                EventBridge.emitWebEvent(JSON.stringify({
+                    type: "snapshot",
+                    action: "removeFromStoryIDsToMaybeDelete",
+                    story_id: storyID
+                }));
                 break;
             case 'twitter':
                 var twitterButton = document.getElementById(selectedID + "twitterButton");
                 window.open(twitterButton.getAttribute("href"), "_blank");
                 shareBarHelp.innerHTML = twitterShareText;
+                EventBridge.emitWebEvent(JSON.stringify({
+                    type: "snapshot",
+                    action: "removeFromStoryIDsToMaybeDelete",
+                    story_id: storyID
+                }));
                 break;
         }
 
         shareBarHelp.setAttribute("data-destination", "");
-
-        EventBridge.emitWebEvent(JSON.stringify({
-            type: "snapshot",
-            action: "removeFromStoryIDsToMaybeDelete",
-            story_id: storyID
-        }));
     }
 }
 function updateShareInfo(containerID, storyID) {
@@ -417,7 +424,7 @@ function updateShareInfo(containerID, storyID) {
     twitterButton.setAttribute("target", "_blank");
     twitterButton.setAttribute("href", 'https://twitter.com/intent/tweet?text=I%20just%20took%20a%20snapshot!&url=' + shareURL + '&via=highfidelityinc&hashtags=VR,HiFi');
 
-    hideUploadingMessageAndShare(containerID, storyID);
+    hideUploadingMessageAndMaybeShare(containerID, storyID);
 }
 function blastToConnections(selectedID, isGif) {
     if (selectedID.id) {
@@ -552,6 +559,12 @@ function shareButtonClicked(destination, selectedID) {
 
     if (!storyID) {
         showUploadingMessage(selectedID, destination);
+    } else {
+        EventBridge.emitWebEvent(JSON.stringify({
+            type: "snapshot",
+            action: "removeFromStoryIDsToMaybeDelete",
+            story_id: storyID
+        }));
     }
 }
 
diff --git a/scripts/system/snapshot.js b/scripts/system/snapshot.js
index 2a2e816d45..8b5ae3c9a7 100644
--- a/scripts/system/snapshot.js
+++ b/scripts/system/snapshot.js
@@ -51,6 +51,11 @@ function openLoginWindow() {
     }
 }
 
+function removeFromStoryIDsToMaybeDelete(story_id) {
+    storyIDsToMaybeDelete.splice(storyIDsToMaybeDelete.indexOf(story_id), 1);
+    print('storyIDsToMaybeDelete[] now:', JSON.stringify(storyIDsToMaybeDelete));
+}
+
 function onMessage(message) {
     // Receives message from the html dialog via the qwebchannel EventBridge. This is complicated by the following:
     // 1. Although we can send POJOs, we cannot receive a toplevel object. (Arrays of POJOs are fine, though.)
@@ -191,6 +196,7 @@ function onMessage(message) {
                                 return;
                             } else {
                                 print("SUCCESS uploading announcement story! Story ID:", response.user_story.id);
+                                removeFromStoryIDsToMaybeDelete(message.story_id); // Don't delete original "for_url" story
                             }
                         });
                     }
@@ -230,13 +236,13 @@ function onMessage(message) {
                         return;
                     } else {
                         print("SUCCESS changing audience" + (message.isAnnouncement ? " and posting announcement!" : "!"));
+                        removeFromStoryIDsToMaybeDelete(message.story_id);
                     }
                 });
             }
             break;
         case 'removeFromStoryIDsToMaybeDelete':
-            storyIDsToMaybeDelete.splice(storyIDsToMaybeDelete.indexOf(message.story_id), 1);
-            print('storyIDsToMaybeDelete[] now:', JSON.stringify(storyIDsToMaybeDelete));
+            removeFromStoryIDsToMaybeDelete(message.story_id);
             break;
         default:
             print('Unknown message action received by snapshot.js!');

From 733b0feabddacdb68e8f49a42476377f50472cf3 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Wed, 17 May 2017 08:17:33 +1200
Subject: [PATCH 106/135] Fix attachment data not getting cleared

---
 libraries/avatars/src/AvatarData.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 26afed152f..32fe4cfef7 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -2086,14 +2086,16 @@ void AvatarData::fromJson(const QJsonObject& json, bool useFrameSkeleton) {
         setTargetScale((float)json[JSON_AVATAR_SCALE].toDouble());
     }
 
+    QVector<AttachmentData> attachments;
     if (json.contains(JSON_AVATAR_ATTACHMENTS) && json[JSON_AVATAR_ATTACHMENTS].isArray()) {
         QJsonArray attachmentsJson = json[JSON_AVATAR_ATTACHMENTS].toArray();
-        QVector<AttachmentData> attachments;
         for (auto attachmentJson : attachmentsJson) {
             AttachmentData attachment;
             attachment.fromJson(attachmentJson.toObject());
             attachments.push_back(attachment);
         }
+    }
+    if (attachments != getAttachmentData()) {
         setAttachmentData(attachments);
     }
 

From 7897bf8aa873d32235d3f2669b24cf3d8374d7b5 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Wed, 17 May 2017 08:17:55 +1200
Subject: [PATCH 107/135] Fix display name not getting cleared

---
 libraries/avatars/src/AvatarData.cpp | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 32fe4cfef7..bee1168dcc 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -2052,11 +2052,13 @@ void AvatarData::fromJson(const QJsonObject& json, bool useFrameSkeleton) {
             setSkeletonModelURL(bodyModelURL);
         }
     }
+
+    QString newDisplayName = "";
     if (json.contains(JSON_AVATAR_DISPLAY_NAME)) {
-        auto newDisplayName = json[JSON_AVATAR_DISPLAY_NAME].toString();
-        if (newDisplayName != getDisplayName()) {
-            setDisplayName(newDisplayName);
-        }
+        newDisplayName = json[JSON_AVATAR_DISPLAY_NAME].toString();
+    }
+    if (newDisplayName != getDisplayName()) {
+        setDisplayName(newDisplayName);
     }
 
     auto currentBasis = getRecordingBasis();

From e3cd85bd22b653291e6be414e0985dc503b03fd3 Mon Sep 17 00:00:00 2001
From: Anshuman Dewangan <anshumand@berkeley.edu>
Date: Tue, 16 May 2017 13:55:04 -0700
Subject: [PATCH 108/135] Changed calibration time from 2 to 1 sec

---
 plugins/openvr/src/ViveControllerManager.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plugins/openvr/src/ViveControllerManager.cpp b/plugins/openvr/src/ViveControllerManager.cpp
index 5e22272dd6..3bda481243 100644
--- a/plugins/openvr/src/ViveControllerManager.cpp
+++ b/plugins/openvr/src/ViveControllerManager.cpp
@@ -40,7 +40,7 @@ void releaseOpenVrSystem();
 
 
 static const char* CONTROLLER_MODEL_STRING = "vr_controller_05_wireless_b";
-const quint64 CALIBRATION_TIMELAPSE = 2 * USECS_PER_SECOND;
+const quint64 CALIBRATION_TIMELAPSE = 1 * USECS_PER_SECOND;
 
 static const char* MENU_PARENT = "Avatar";
 static const char* MENU_NAME = "Vive Controllers";

From 201f81f20ad5b2bba3b05d6f9c007d74354d753c Mon Sep 17 00:00:00 2001
From: Atlante45 <clement.brisset@gmail.com>
Date: Wed, 10 May 2017 19:40:29 -0700
Subject: [PATCH 109/135] Don't wait on the sandbox

---
 interface/src/Application.cpp             | 261 ++++++++++------------
 interface/src/Application.h               |  14 +-
 interface/src/main.cpp                    |  70 +++---
 libraries/networking/src/SandboxUtils.cpp |  73 +++---
 libraries/networking/src/SandboxUtils.h   |  19 +-
 libraries/shared/src/RunningMarker.cpp    |   6 +-
 libraries/shared/src/RunningMarker.h      |   5 +-
 7 files changed, 204 insertions(+), 244 deletions(-)

diff --git a/interface/src/Application.cpp b/interface/src/Application.cpp
index f4699009ac..3a09a2181c 100644
--- a/interface/src/Application.cpp
+++ b/interface/src/Application.cpp
@@ -563,11 +563,8 @@ const bool DEFAULT_DESKTOP_TABLET_BECOMES_TOOLBAR = true;
 const bool DEFAULT_HMD_TABLET_BECOMES_TOOLBAR = false;
 const bool DEFAULT_PREFER_AVATAR_FINGER_OVER_STYLUS = false;
 
-Application::Application(int& argc, char** argv, QElapsedTimer& startupTimer, bool runServer, QString runServerPathOption) :
+Application::Application(int& argc, char** argv, QElapsedTimer& startupTimer) :
     QApplication(argc, argv),
-    _shouldRunServer(runServer),
-    _runServerPath(runServerPathOption),
-    _runningMarker(this, RUNNING_MARKER_FILENAME),
     _window(new MainWindow(desktop())),
     _sessionRunTimer(startupTimer),
     _previousSessionCrashed(setupEssentials(argc, argv)),
@@ -622,8 +619,6 @@ Application::Application(int& argc, char** argv, QElapsedTimer& startupTimer, bo
     // make sure the debug draw singleton is initialized on the main thread.
     DebugDraw::getInstance().removeMarker("");
 
-    _runningMarker.startRunningMarker();
-
     PluginContainer* pluginContainer = dynamic_cast<PluginContainer*>(this); // set the container for any plugins that care
     PluginManager::getInstance()->setContainer(pluginContainer);
 
@@ -675,38 +670,7 @@ Application::Application(int& argc, char** argv, QElapsedTimer& startupTimer, bo
     static const QString OCULUS_STORE_ARG = "--oculus-store";
     setProperty(hifi::properties::OCULUS_STORE, arguments().indexOf(OCULUS_STORE_ARG) != -1);
 
-    static const QString NO_UPDATER_ARG = "--no-updater";
-    static const bool noUpdater = arguments().indexOf(NO_UPDATER_ARG) != -1;
-    static const bool wantsSandboxRunning = shouldRunServer();
-    static bool determinedSandboxState = false;
-    static bool sandboxIsRunning = false;
-    SandboxUtils sandboxUtils;
-    // updateHeartbeat() because we are going to poll shortly...
     updateHeartbeat();
-    sandboxUtils.ifLocalSandboxRunningElse([&]() {
-        qCDebug(interfaceapp) << "Home sandbox appears to be running.....";
-        determinedSandboxState = true;
-        sandboxIsRunning = true;
-    }, [&]() {
-        qCDebug(interfaceapp) << "Home sandbox does not appear to be running....";
-        if (wantsSandboxRunning) {
-            QString contentPath = getRunServerPath();
-            SandboxUtils::runLocalSandbox(contentPath, true, RUNNING_MARKER_FILENAME, noUpdater);
-            sandboxIsRunning = true;
-        }
-        determinedSandboxState = true;
-    });
-
-    // SandboxUtils::runLocalSandbox currently has 2 sec delay after spawning sandbox, so 4
-    // sec here is ok I guess.  TODO: ping sandbox so we know it is up, perhaps?
-    quint64 MAX_WAIT_TIME = USECS_PER_SECOND * 4;
-    auto startWaiting = usecTimestampNow();
-    while (!determinedSandboxState && (usecTimestampNow() - startWaiting <= MAX_WAIT_TIME)) {
-        QCoreApplication::processEvents();
-        // updateHeartbeat() while polling so we don't scare the deadlock watchdog
-        updateHeartbeat();
-        usleep(USECS_PER_MSEC * 50); // 20hz
-    }
 
     // start the nodeThread so its event loop is running
     QThread* nodeThread = new QThread(this);
@@ -1223,6 +1187,8 @@ Application::Application(int& argc, char** argv, QElapsedTimer& startupTimer, bo
 #endif
 
     // If launched from Steam, let it handle updates
+    const QString HIFI_NO_UPDATER_COMMAND_LINE_KEY = "--no-updater";
+    bool noUpdater = arguments().indexOf(HIFI_NO_UPDATER_COMMAND_LINE_KEY) != -1;
     if (!noUpdater) {
         auto applicationUpdater = DependencyManager::get<AutoUpdater>();
         connect(applicationUpdater.data(), &AutoUpdater::newVersionIsAvailable, dialogsManager.data(), &DialogsManager::showUpdateDialog);
@@ -1465,110 +1431,11 @@ Application::Application(int& argc, char** argv, QElapsedTimer& startupTimer, bo
         const auto testScript = property(hifi::properties::TEST).toUrl();
         scriptEngines->loadScript(testScript, false);
     } else {
-        enum HandControllerType {
-            Vive,
-            Oculus
-        };
-        static const std::map<HandControllerType, int> MIN_CONTENT_VERSION = {
-            { Vive, 1 },
-            { Oculus, 27 }
-        };
-
-        // Get sandbox content set version
-        auto acDirPath = PathUtils::getAppDataPath() + "../../" + BuildInfo::MODIFIED_ORGANIZATION + "/assignment-client/";
-        auto contentVersionPath = acDirPath + "content-version.txt";
-        qCDebug(interfaceapp) << "Checking " << contentVersionPath << " for content version";
-        int contentVersion = 0;
-        QFile contentVersionFile(contentVersionPath);
-        if (contentVersionFile.open(QIODevice::ReadOnly | QIODevice::Text)) {
-            QString line = contentVersionFile.readAll();
-            contentVersion = line.toInt(); // returns 0 if conversion fails
-        }
-
-        // Get controller availability
-        bool hasHandControllers = false;
-        HandControllerType handControllerType = Vive;
-        if (PluginUtils::isViveControllerAvailable()) {
-            hasHandControllers = true;
-            handControllerType = Vive;
-        } else if (PluginUtils::isOculusTouchControllerAvailable()) {
-            hasHandControllers = true;
-            handControllerType = Oculus;
-        }
-
-        // Check tutorial content versioning
-        bool hasTutorialContent = contentVersion >= MIN_CONTENT_VERSION.at(handControllerType);
-
-        // Check HMD use (may be technically available without being in use)
-        bool hasHMD = PluginUtils::isHMDAvailable();
-        bool isUsingHMD = hasHMD && hasHandControllers && _displayPlugin->isHmd();
-
-        Setting::Handle<bool> tutorialComplete { "tutorialComplete", false };
-        Setting::Handle<bool> firstRun { Settings::firstRun, true };
-
-        bool isTutorialComplete = tutorialComplete.get();
-        bool shouldGoToTutorial = isUsingHMD && hasTutorialContent && !isTutorialComplete;
-
-        qCDebug(interfaceapp) << "HMD:" << hasHMD << ", Hand Controllers: " << hasHandControllers << ", Using HMD: " << isUsingHMD;
-        qCDebug(interfaceapp) << "Tutorial version:" << contentVersion << ", sufficient:" << hasTutorialContent <<
-            ", complete:" << isTutorialComplete << ", should go:" << shouldGoToTutorial;
-
-        // when --url in command line, teleport to location
-        const QString HIFI_URL_COMMAND_LINE_KEY = "--url";
-        int urlIndex = arguments().indexOf(HIFI_URL_COMMAND_LINE_KEY);
-        QString addressLookupString;
-        if (urlIndex != -1) {
-            addressLookupString = arguments().value(urlIndex + 1);
-        }
-
-        const QString TUTORIAL_PATH = "/tutorial_begin";
-
-        if (shouldGoToTutorial) {
-            if (sandboxIsRunning) {
-                qCDebug(interfaceapp) << "Home sandbox appears to be running, going to Home.";
-                DependencyManager::get<AddressManager>()->goToLocalSandbox(TUTORIAL_PATH);
-            } else {
-                qCDebug(interfaceapp) << "Home sandbox does not appear to be running, going to Entry.";
-                if (firstRun.get()) {
-                    showHelp();
-                }
-                if (addressLookupString.isEmpty()) {
-                    DependencyManager::get<AddressManager>()->goToEntry();
-                } else {
-                    DependencyManager::get<AddressManager>()->loadSettings(addressLookupString);
-                }
-            }
-        } else {
-
-            bool isFirstRun = firstRun.get();
-
-            if (isFirstRun) {
-                showHelp();
-            }
-
-            // If this is a first run we short-circuit the address passed in
-            if (isFirstRun) {
-                if (isUsingHMD) {
-                    if (sandboxIsRunning) {
-                        qCDebug(interfaceapp) << "Home sandbox appears to be running, going to Home.";
-                        DependencyManager::get<AddressManager>()->goToLocalSandbox();
-                    } else {
-                        qCDebug(interfaceapp) << "Home sandbox does not appear to be running, going to Entry.";
-                        DependencyManager::get<AddressManager>()->goToEntry();
-                    }
-                } else {
-                    DependencyManager::get<AddressManager>()->goToEntry();
-                }
-            } else {
-                qCDebug(interfaceapp) << "Not first run... going to" << qPrintable(addressLookupString.isEmpty() ? QString("previous location") : addressLookupString);
-                DependencyManager::get<AddressManager>()->loadSettings(addressLookupString);
-            }
-        }
-
-        _connectionMonitor.init();
-
-        // After all of the constructor is completed, then set firstRun to false.
-        firstRun.set(false);
+        PROFILE_RANGE(render, "GetSandboxStatus");
+        auto reply = SandboxUtils::getStatus();
+        connect(reply, &QNetworkReply::finished, this, [=] {
+            handleSandboxStatus(reply);
+        });
     }
 
     // Monitor model assets (e.g., from Clara.io) added to the world that may need resizing.
@@ -2474,6 +2341,118 @@ void Application::resizeGL() {
     }
 }
 
+void Application::handleSandboxStatus(QNetworkReply* reply) {
+    PROFILE_RANGE(render, "HandleSandboxStatus");
+
+    bool sandboxIsRunning = SandboxUtils::readStatus(reply->readAll());
+    qDebug() << "HandleSandboxStatus" << sandboxIsRunning;
+
+    enum HandControllerType {
+        Vive,
+        Oculus
+    };
+    static const std::map<HandControllerType, int> MIN_CONTENT_VERSION = {
+        { Vive, 1 },
+        { Oculus, 27 }
+    };
+
+    // Get sandbox content set version
+    auto acDirPath = PathUtils::getAppDataPath() + "../../" + BuildInfo::MODIFIED_ORGANIZATION + "/assignment-client/";
+    auto contentVersionPath = acDirPath + "content-version.txt";
+    qCDebug(interfaceapp) << "Checking " << contentVersionPath << " for content version";
+    int contentVersion = 0;
+    QFile contentVersionFile(contentVersionPath);
+    if (contentVersionFile.open(QIODevice::ReadOnly | QIODevice::Text)) {
+        QString line = contentVersionFile.readAll();
+        contentVersion = line.toInt(); // returns 0 if conversion fails
+    }
+
+    // Get controller availability
+    bool hasHandControllers = false;
+    HandControllerType handControllerType = Vive;
+    if (PluginUtils::isViveControllerAvailable()) {
+        hasHandControllers = true;
+        handControllerType = Vive;
+    } else if (PluginUtils::isOculusTouchControllerAvailable()) {
+        hasHandControllers = true;
+        handControllerType = Oculus;
+    }
+
+    // Check tutorial content versioning
+    bool hasTutorialContent = contentVersion >= MIN_CONTENT_VERSION.at(handControllerType);
+
+    // Check HMD use (may be technically available without being in use)
+    bool hasHMD = PluginUtils::isHMDAvailable();
+    bool isUsingHMD = hasHMD && hasHandControllers && _displayPlugin->isHmd();
+
+    Setting::Handle<bool> tutorialComplete{ "tutorialComplete", false };
+    Setting::Handle<bool> firstRun{ Settings::firstRun, true };
+
+    bool isTutorialComplete = tutorialComplete.get();
+    bool shouldGoToTutorial = isUsingHMD && hasTutorialContent && !isTutorialComplete;
+
+    qCDebug(interfaceapp) << "HMD:" << hasHMD << ", Hand Controllers: " << hasHandControllers << ", Using HMD: " << isUsingHMD;
+    qCDebug(interfaceapp) << "Tutorial version:" << contentVersion << ", sufficient:" << hasTutorialContent <<
+        ", complete:" << isTutorialComplete << ", should go:" << shouldGoToTutorial;
+
+    // when --url in command line, teleport to location
+    const QString HIFI_URL_COMMAND_LINE_KEY = "--url";
+    int urlIndex = arguments().indexOf(HIFI_URL_COMMAND_LINE_KEY);
+    QString addressLookupString;
+    if (urlIndex != -1) {
+        addressLookupString = arguments().value(urlIndex + 1);
+    }
+
+    const QString TUTORIAL_PATH = "/tutorial_begin";
+
+    if (shouldGoToTutorial) {
+        if (sandboxIsRunning) {
+            qCDebug(interfaceapp) << "Home sandbox appears to be running, going to Home.";
+            DependencyManager::get<AddressManager>()->goToLocalSandbox(TUTORIAL_PATH);
+        } else {
+            qCDebug(interfaceapp) << "Home sandbox does not appear to be running, going to Entry.";
+            if (firstRun.get()) {
+                showHelp();
+            }
+            if (addressLookupString.isEmpty()) {
+                DependencyManager::get<AddressManager>()->goToEntry();
+            } else {
+                DependencyManager::get<AddressManager>()->loadSettings(addressLookupString);
+            }
+        }
+    } else {
+
+        bool isFirstRun = firstRun.get();
+
+        if (isFirstRun) {
+            showHelp();
+        }
+
+        // If this is a first run we short-circuit the address passed in
+        if (isFirstRun) {
+            if (isUsingHMD) {
+                if (sandboxIsRunning) {
+                    qCDebug(interfaceapp) << "Home sandbox appears to be running, going to Home.";
+                    DependencyManager::get<AddressManager>()->goToLocalSandbox();
+                } else {
+                    qCDebug(interfaceapp) << "Home sandbox does not appear to be running, going to Entry.";
+                    DependencyManager::get<AddressManager>()->goToEntry();
+                }
+            } else {
+                DependencyManager::get<AddressManager>()->goToEntry();
+            }
+        } else {
+            qCDebug(interfaceapp) << "Not first run... going to" << qPrintable(addressLookupString.isEmpty() ? QString("previous location") : addressLookupString);
+            DependencyManager::get<AddressManager>()->loadSettings(addressLookupString);
+        }
+    }
+
+    _connectionMonitor.init();
+
+    // After all of the constructor is completed, then set firstRun to false.
+    firstRun.set(false);
+}
+
 bool Application::importJSONFromURL(const QString& urlString) {
     // we only load files that terminate in just .json (not .svo.json and not .ava.json)
     // if they come from the High Fidelity Marketplace Assets CDN
diff --git a/interface/src/Application.h b/interface/src/Application.h
index 5027c58349..5cf3580c09 100644
--- a/interface/src/Application.h
+++ b/interface/src/Application.h
@@ -112,17 +112,7 @@ class Application : public QApplication,
     // TODO? Get rid of those
     friend class OctreePacketProcessor;
 
-private:
-    bool _shouldRunServer { false };
-    QString _runServerPath;
-    RunningMarker _runningMarker;
-
 public:
-    // startup related getter/setters
-    bool shouldRunServer() const { return _shouldRunServer; }
-    bool hasRunServerPath() const { return !_runServerPath.isEmpty(); }
-    QString getRunServerPath() const { return _runServerPath; }
-
     // virtual functions required for PluginContainer
     virtual ui::Menu* getPrimaryMenu() override;
     virtual void requestReset() override { resetSensors(true); }
@@ -146,7 +136,7 @@ public:
     static void initPlugins(const QStringList& arguments);
     static void shutdownPlugins();
 
-    Application(int& argc, char** argv, QElapsedTimer& startup_time, bool runServer, QString runServerPathOption);
+    Application(int& argc, char** argv, QElapsedTimer& startup_time);
     ~Application();
 
     void postLambdaEvent(std::function<void()> f) override;
@@ -452,6 +442,8 @@ private slots:
     void addAssetToWorldInfoTimeout();
     void addAssetToWorldErrorTimeout();
 
+    void handleSandboxStatus(QNetworkReply* reply);
+
 private:
     static void initDisplay();
     void init();
diff --git a/interface/src/main.cpp b/interface/src/main.cpp
index 99dbb1a28e..3430ffbd15 100644
--- a/interface/src/main.cpp
+++ b/interface/src/main.cpp
@@ -11,6 +11,7 @@
 #include <thread>
 
 #include <QCommandLineParser>
+#include <QtCore/QProcess>
 #include <QDebug>
 #include <QDir>
 #include <QLocalSocket>
@@ -20,6 +21,7 @@
 
 #include <BuildInfo.h>
 #include <gl/OpenGLVersionChecker.h>
+#include <SandboxUtils.h>
 #include <SharedUtil.h>
 
 
@@ -28,7 +30,6 @@
 #include "InterfaceLogging.h"
 #include "UserActivityLogger.h"
 #include "MainWindow.h"
-#include <QtCore/QProcess>
 
 #ifdef HAS_BUGSPLAT
 #include <BugSplat.h>
@@ -50,50 +51,49 @@ int main(int argc, const char* argv[]) {
 
     disableQtBearerPoll(); // Fixes wifi ping spikes
 
+    QElapsedTimer startupTime;
+    startupTime.start();
+
     // Set application infos
     QCoreApplication::setApplicationName(BuildInfo::INTERFACE_NAME);
     QCoreApplication::setOrganizationName(BuildInfo::MODIFIED_ORGANIZATION);
     QCoreApplication::setOrganizationDomain(BuildInfo::ORGANIZATION_DOMAIN);
     QCoreApplication::setApplicationVersion(BuildInfo::VERSION);
 
-    const QString& applicationName = getInterfaceSharedMemoryName();
-
-    bool instanceMightBeRunning = true;
-
     QStringList arguments;
     for (int i = 0; i < argc; ++i) {
         arguments << argv[i];
     }
 
-
-#ifdef Q_OS_WIN
-    // Try to create a shared memory block - if it can't be created, there is an instance of
-    // interface already running. We only do this on Windows for now because of the potential
-    // for crashed instances to leave behind shared memory instances on unix.
-    QSharedMemory sharedMemory { applicationName };
-    instanceMightBeRunning = !sharedMemory.create(1, QSharedMemory::ReadOnly);
-#endif
-
-    // allow multiple interfaces to run if this environment variable is set.
-    if (QProcessEnvironment::systemEnvironment().contains("HIFI_ALLOW_MULTIPLE_INSTANCES")) {
-        instanceMightBeRunning = false;
-    }
-
     QCommandLineParser parser;
+    QCommandLineOption urlOption("url", "", "value");
+    QCommandLineOption noUpdaterOption("no-updater", "Do not show auto-updater");
     QCommandLineOption checkMinSpecOption("checkMinSpec", "Check if machine meets minimum specifications");
     QCommandLineOption runServerOption("runServer", "Whether to run the server");
     QCommandLineOption serverContentPathOption("serverContentPath", "Where to find server content", "serverContentPath");
     QCommandLineOption allowMultipleInstancesOption("allowMultipleInstances", "Allow multiple instances to run");
+    parser.addOption(urlOption);
+    parser.addOption(noUpdaterOption);
     parser.addOption(checkMinSpecOption);
     parser.addOption(runServerOption);
     parser.addOption(serverContentPathOption);
     parser.addOption(allowMultipleInstancesOption);
     parser.parse(arguments);
-    bool runServer = parser.isSet(runServerOption);
-    bool serverContentPathOptionIsSet = parser.isSet(serverContentPathOption);
-    QString serverContentPathOptionValue = serverContentPathOptionIsSet ? parser.value(serverContentPathOption) : QString();
-    bool allowMultipleInstances = parser.isSet(allowMultipleInstancesOption);
 
+    
+    const QString& applicationName = getInterfaceSharedMemoryName();
+    bool instanceMightBeRunning = true;
+#ifdef Q_OS_WIN
+    // Try to create a shared memory block - if it can't be created, there is an instance of
+    // interface already running. We only do this on Windows for now because of the potential
+    // for crashed instances to leave behind shared memory instances on unix.
+    QSharedMemory sharedMemory{ applicationName };
+    instanceMightBeRunning = !sharedMemory.create(1, QSharedMemory::ReadOnly);
+#endif
+
+    // allow multiple interfaces to run if this environment variable is set.
+    bool allowMultipleInstances = parser.isSet(allowMultipleInstancesOption) ||
+                                  QProcessEnvironment::systemEnvironment().contains("HIFI_ALLOW_MULTIPLE_INSTANCES");
     if (allowMultipleInstances) {
         instanceMightBeRunning = false;
     }
@@ -108,11 +108,6 @@ int main(int argc, const char* argv[]) {
 
         // Try to connect - if we can't connect, interface has probably just gone down
         if (socket.waitForConnected(LOCAL_SERVER_TIMEOUT_MS)) {
-            QCommandLineParser parser;
-            QCommandLineOption urlOption("url", "", "value");
-            parser.addOption(urlOption);
-            parser.process(arguments);
-
             if (parser.isSet(urlOption)) {
                 QUrl url = QUrl(parser.value(urlOption));
                 if (url.isValid() && url.scheme() == HIFI_URL_SCHEME) {
@@ -156,9 +151,6 @@ int main(int argc, const char* argv[]) {
         }
     }
 
-    QElapsedTimer startupTime;
-    startupTime.start();
-
     // Debug option to demonstrate that the client's local time does not
     // need to be in sync with any other network node. This forces clock
     // skew for the individual client
@@ -199,7 +191,21 @@ int main(int argc, const char* argv[]) {
 
     int exitCode;
     {
-        Application app(argc, const_cast<char**>(argv), startupTime, runServer, serverContentPathOptionValue);
+        RunningMarker runningMarker(nullptr, RUNNING_MARKER_FILENAME);
+        runningMarker.writeRunningMarkerFile();
+
+        bool noUpdater = parser.isSet(noUpdaterOption);
+        bool runServer = parser.isSet(runServerOption);
+        bool serverContentPathOptionIsSet = parser.isSet(serverContentPathOption);
+        QString serverContentPath = serverContentPathOptionIsSet ? parser.value(serverContentPathOption) : QString();
+        if (runServer) {
+            SandboxUtils::runLocalSandbox(serverContentPath, true, RUNNING_MARKER_FILENAME, noUpdater);
+        }
+
+        Application app(argc, const_cast<char**>(argv), startupTime);
+
+        // Now that the main event loop is setup, launch running marker thread
+        runningMarker.startRunningMarker();
 
         // If we failed the OpenGLVersion check, log it.
         if (override) {
diff --git a/libraries/networking/src/SandboxUtils.cpp b/libraries/networking/src/SandboxUtils.cpp
index bf17a0b1e4..d816f7ebee 100644
--- a/libraries/networking/src/SandboxUtils.cpp
+++ b/libraries/networking/src/SandboxUtils.cpp
@@ -9,63 +9,52 @@
 //  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
 //
 
-#include <QDataStream>
-#include <QDebug>
-#include <QFile>
-#include <QFileInfo>
+#include "SandboxUtils.h"
+
 #include <QJsonDocument>
 #include <QJsonObject>
 #include <QNetworkReply>
 #include <QProcess>
-#include <QStandardPaths>
-#include <QThread>
-#include <QTimer>
 
 #include <NumericalConstants.h>
 #include <SharedUtil.h>
 #include <RunningMarker.h>
 
-#include "SandboxUtils.h"
 #include "NetworkAccessManager.h"
 #include "NetworkLogging.h"
 
+namespace SandboxUtils {
 
-void SandboxUtils::ifLocalSandboxRunningElse(std::function<void()> localSandboxRunningDoThis,
-                                               std::function<void()> localSandboxNotRunningDoThat) {
-
-    QNetworkAccessManager& networkAccessManager = NetworkAccessManager::getInstance();
+QNetworkReply* getStatus() {
+    auto& networkAccessManager = NetworkAccessManager::getInstance();
     QNetworkRequest sandboxStatus(SANDBOX_STATUS_URL);
     sandboxStatus.setAttribute(QNetworkRequest::FollowRedirectsAttribute, true);
     sandboxStatus.setHeader(QNetworkRequest::UserAgentHeader, HIGH_FIDELITY_USER_AGENT);
-    QNetworkReply* reply = networkAccessManager.get(sandboxStatus);
-
-    connect(reply, &QNetworkReply::finished, this, [reply, localSandboxRunningDoThis, localSandboxNotRunningDoThat]() {
-        if (reply->error() == QNetworkReply::NoError) {
-            auto statusData = reply->readAll();
-            auto statusJson = QJsonDocument::fromJson(statusData);
-            if (!statusJson.isEmpty()) {
-                auto statusObject = statusJson.object();
-                auto serversValue = statusObject.value("servers");
-                if (!serversValue.isUndefined() && serversValue.isObject()) {
-                    auto serversObject = serversValue.toObject();
-                    auto serversCount = serversObject.size();
-                    const int MINIMUM_EXPECTED_SERVER_COUNT = 5;
-                    if (serversCount >= MINIMUM_EXPECTED_SERVER_COUNT) {
-                        localSandboxRunningDoThis();
-                        return;
-                    }
-                }
-            }
-        }
-        localSandboxNotRunningDoThat();
-    });
+    return networkAccessManager.get(sandboxStatus);
 }
 
+bool readStatus(QByteArray statusData) {
+    auto statusJson = QJsonDocument::fromJson(statusData);
 
-void SandboxUtils::runLocalSandbox(QString contentPath, bool autoShutdown, QString runningMarkerName, bool noUpdater) {
-    QString applicationDirPath = QFileInfo(QCoreApplication::applicationFilePath()).path();
-    QString serverPath = applicationDirPath + "/server-console/server-console.exe";
-    qCDebug(networking) << "Application dir path is: " << applicationDirPath;
+    if (!statusJson.isEmpty()) {
+        auto statusObject = statusJson.object();
+        auto serversValue = statusObject.value("servers");
+        if (!serversValue.isUndefined() && serversValue.isObject()) {
+            auto serversObject = serversValue.toObject();
+            auto serversCount = serversObject.size();
+            const int MINIMUM_EXPECTED_SERVER_COUNT = 5;
+            if (serversCount >= MINIMUM_EXPECTED_SERVER_COUNT) {
+                return true;
+            }
+        }
+    }
+
+    return false;
+}
+
+void runLocalSandbox(QString contentPath, bool autoShutdown, QString runningMarkerName, bool noUpdater) {
+    QString serverPath = "./server-console/server-console.exe";
+    qCDebug(networking) << "Running marker path is: " << runningMarkerName;
     qCDebug(networking) << "Server path is: " << serverPath;
     qCDebug(networking) << "autoShutdown: " << autoShutdown;
     qCDebug(networking) << "noUpdater: " << noUpdater;
@@ -80,7 +69,7 @@ void SandboxUtils::runLocalSandbox(QString contentPath, bool autoShutdown, QStri
     }
 
     if (hasContentPath) {
-        QString serverContentPath = applicationDirPath + "/" + contentPath;
+        QString serverContentPath = "./" + contentPath;
         args << "--contentPath" << serverContentPath;
     }
 
@@ -93,10 +82,8 @@ void SandboxUtils::runLocalSandbox(QString contentPath, bool autoShutdown, QStri
         args << "--noUpdater";
     }
 
-    qCDebug(networking) << applicationDirPath;
     qCDebug(networking) << "Launching sandbox with:" << args;
     qCDebug(networking) << QProcess::startDetached(serverPath, args);
-
-    // Sleep a short amount of time to give the server a chance to start
-    usleep(2000000); /// do we really need this??
+}
+
 }
diff --git a/libraries/networking/src/SandboxUtils.h b/libraries/networking/src/SandboxUtils.h
index aaceafb9ef..42484b8edf 100644
--- a/libraries/networking/src/SandboxUtils.h
+++ b/libraries/networking/src/SandboxUtils.h
@@ -12,21 +12,16 @@
 #ifndef hifi_SandboxUtils_h
 #define hifi_SandboxUtils_h
 
-#include <functional>
-#include <QtCore/QObject>
+#include <QtCore/QString>
 
+class QNetworkReply;
 
-const QString SANDBOX_STATUS_URL = "http://localhost:60332/status";
+namespace SandboxUtils {
+    const QString SANDBOX_STATUS_URL = "http://localhost:60332/status";
 
-class SandboxUtils : public QObject {
-    Q_OBJECT
-public:
-    /// determines if the local sandbox is likely running. It does not account for custom setups, and is only 
-    /// intended to detect the standard local sandbox install.
-    void ifLocalSandboxRunningElse(std::function<void()> localSandboxRunningDoThis,
-                                   std::function<void()> localSandboxNotRunningDoThat);
-
-    static void runLocalSandbox(QString contentPath, bool autoShutdown, QString runningMarkerName, bool noUpdater);
+    QNetworkReply* getStatus();
+    bool readStatus(QByteArray statusData);
+    void runLocalSandbox(QString contentPath, bool autoShutdown, QString runningMarkerName, bool noUpdater);
 };
 
 #endif // hifi_SandboxUtils_h
diff --git a/libraries/shared/src/RunningMarker.cpp b/libraries/shared/src/RunningMarker.cpp
index 89fb3ada23..f8aaee42df 100644
--- a/libraries/shared/src/RunningMarker.cpp
+++ b/libraries/shared/src/RunningMarker.cpp
@@ -33,11 +33,11 @@ void RunningMarker::startRunningMarker() {
     _runningMarkerThread->setObjectName("Running Marker Thread");
     _runningMarkerThread->start();
 
-    writeRunningMarkerFiler(); // write the first file, even before timer
+    writeRunningMarkerFile(); // write the first file, even before timer
 
     _runningMarkerTimer = new QTimer();
     QObject::connect(_runningMarkerTimer, &QTimer::timeout, [=](){
-        writeRunningMarkerFiler();
+        writeRunningMarkerFile();
     });
     _runningMarkerTimer->start(RUNNING_STATE_CHECK_IN_MSECS);
 
@@ -53,7 +53,7 @@ RunningMarker::~RunningMarker() {
     _runningMarkerThread->deleteLater();
 }
 
-void RunningMarker::writeRunningMarkerFiler() {
+void RunningMarker::writeRunningMarkerFile() {
     QFile runningMarkerFile(getFilePath());
 
     // always write, even it it exists, so that it touches the files
diff --git a/libraries/shared/src/RunningMarker.h b/libraries/shared/src/RunningMarker.h
index 16763d27e6..1137dbf5fa 100644
--- a/libraries/shared/src/RunningMarker.h
+++ b/libraries/shared/src/RunningMarker.h
@@ -27,10 +27,11 @@ public:
 
     QString getFilePath();
     static QString getMarkerFilePath(QString name);
-protected:
-    void writeRunningMarkerFiler();
+
+    void writeRunningMarkerFile();
     void deleteRunningMarkerFile();
 
+private:
     QObject* _parent { nullptr };
     QString _name;
     QThread* _runningMarkerThread { nullptr };

From c799ddc9276b207d14e778d12920076c1ebf349f Mon Sep 17 00:00:00 2001
From: Atlante45 <clement.brisset@gmail.com>
Date: Tue, 16 May 2017 14:53:54 -0700
Subject: [PATCH 110/135] CR

---
 assignment-client/src/audio/AudioMixer.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/assignment-client/src/audio/AudioMixer.cpp b/assignment-client/src/audio/AudioMixer.cpp
index 98eca60e85..bb03a6ec93 100644
--- a/assignment-client/src/audio/AudioMixer.cpp
+++ b/assignment-client/src/audio/AudioMixer.cpp
@@ -38,14 +38,14 @@
 #include "AudioMixer.h"
 
 static const float DEFAULT_ATTENUATION_PER_DOUBLING_IN_DISTANCE = 0.5f;    // attenuation = -6dB * log2(distance)
-static const int DEFAULT_NUM_STATIC_JITTER_FRAMES = -1;
+static const int DISABLE_STATIC_JITTER_FRAMES = -1;
 static const float DEFAULT_NOISE_MUTING_THRESHOLD = 1.0f;
 static const QString AUDIO_MIXER_LOGGING_TARGET_NAME = "audio-mixer";
 static const QString AUDIO_ENV_GROUP_KEY = "audio_env";
 static const QString AUDIO_BUFFER_GROUP_KEY = "audio_buffer";
 static const QString AUDIO_THREADING_GROUP_KEY = "audio_threading";
 
-int AudioMixer::_numStaticJitterFrames{ DEFAULT_NUM_STATIC_JITTER_FRAMES };
+int AudioMixer::_numStaticJitterFrames{ DISABLE_STATIC_JITTER_FRAMES };
 float AudioMixer::_noiseMutingThreshold{ DEFAULT_NOISE_MUTING_THRESHOLD };
 float AudioMixer::_attenuationPerDoublingInDistance{ DEFAULT_ATTENUATION_PER_DOUBLING_IN_DISTANCE };
 std::map<QString, std::shared_ptr<CodecPlugin>> AudioMixer::_availableCodecs{ };
@@ -238,7 +238,7 @@ void AudioMixer::sendStatsPacket() {
     }
 
     // general stats
-    statsObject["useDynamicJitterBuffers"] = _numStaticJitterFrames == DEFAULT_NUM_STATIC_JITTER_FRAMES;
+    statsObject["useDynamicJitterBuffers"] = _numStaticJitterFrames == DISABLE_STATIC_JITTER_FRAMES;
 
     statsObject["threads"] = _slavePool.numThreads();
 
@@ -497,7 +497,7 @@ int AudioMixer::prepareFrame(const SharedNodePointer& node, unsigned int frame)
 }
 
 void AudioMixer::clearDomainSettings() {
-    _numStaticJitterFrames = DEFAULT_NUM_STATIC_JITTER_FRAMES;
+    _numStaticJitterFrames = DISABLE_STATIC_JITTER_FRAMES;
     _attenuationPerDoublingInDistance = DEFAULT_ATTENUATION_PER_DOUBLING_IN_DISTANCE;
     _noiseMutingThreshold = DEFAULT_NOISE_MUTING_THRESHOLD;
     _codecPreferenceOrder.clear();
@@ -541,7 +541,7 @@ void AudioMixer::parseSettingsObject(const QJsonObject &settingsObject) {
             qDebug() << "Static desired jitter buffer frames:" << _numStaticJitterFrames;
         } else {
             qDebug() << "Disabling dynamic jitter buffers.";
-            _numStaticJitterFrames = DEFAULT_NUM_STATIC_JITTER_FRAMES;
+            _numStaticJitterFrames = DISABLE_STATIC_JITTER_FRAMES;
         }
 
         // check for deprecated audio settings

From bfd1274ed3ebbd7982683a013fa4177d5225f6e3 Mon Sep 17 00:00:00 2001
From: Ryan Huffman <ryanhuffman@gmail.com>
Date: Tue, 16 May 2017 10:10:11 -0700
Subject: [PATCH 111/135] Fix progressive loading of cubemaps

In various places we were using the KTX _imageSize as the size of the
entire mip level, when it is actually the size of the face for cubemaps.
---
 libraries/gpu/src/gpu/Texture_ktx.cpp         |  7 ++++---
 libraries/ktx/src/ktx/KTX.h                   | 19 +++++++++++--------
 libraries/ktx/src/ktx/Writer.cpp              |  9 ++++++---
 .../src/model-networking/TextureCache.cpp     |  8 ++++----
 4 files changed, 25 insertions(+), 18 deletions(-)

diff --git a/libraries/gpu/src/gpu/Texture_ktx.cpp b/libraries/gpu/src/gpu/Texture_ktx.cpp
index 524fd0a88c..85fd5f044c 100644
--- a/libraries/gpu/src/gpu/Texture_ktx.cpp
+++ b/libraries/gpu/src/gpu/Texture_ktx.cpp
@@ -238,8 +238,9 @@ void KtxStorage::assignMipData(uint16 level, const storage::StoragePointer& stor
         throw std::runtime_error("Invalid level");
     }
 
-    if (storage->size() != _ktxDescriptor->images[level]._imageSize) {
-        qWarning() << "Invalid image size: " << storage->size() << ", expected: " << _ktxDescriptor->images[level]._imageSize
+    auto& imageDesc = _ktxDescriptor->images[level];
+    if (storage->size() != imageDesc._fullImageSize) {
+        qWarning() << "Invalid image size: " << storage->size() << ", expected: " << imageDesc._fullImageSize
             << ", level: " << level << ", filename: " << QString::fromStdString(_filename);
         return;
     }
@@ -258,7 +259,7 @@ void KtxStorage::assignMipData(uint16 level, const storage::StoragePointer& stor
             return;
         }
 
-        memcpy(imageData, storage->data(), _ktxDescriptor->images[level]._imageSize);
+        memcpy(imageData, storage->data(), storage->size());
         _minMipLevelAvailable = level;
         if (_offsetToMinMipKV > 0) {
             auto minMipKeyData = file->mutableData() + ktx::KTX_HEADER_SIZE + _offsetToMinMipKV;
diff --git a/libraries/ktx/src/ktx/KTX.h b/libraries/ktx/src/ktx/KTX.h
index 656cf93f34..69a34d3507 100644
--- a/libraries/ktx/src/ktx/KTX.h
+++ b/libraries/ktx/src/ktx/KTX.h
@@ -38,15 +38,15 @@ UInt32 numberOfArrayElements
 UInt32 numberOfFaces
 UInt32 numberOfMipmapLevels
 UInt32 bytesOfKeyValueData
-  
+
 for each keyValuePair that fits in bytesOfKeyValueData
     UInt32   keyAndValueByteSize
     Byte     keyAndValue[keyAndValueByteSize]
     Byte     valuePadding[3 - ((keyAndValueByteSize + 3) % 4)]
 end
-  
+
 for each mipmap_level in numberOfMipmapLevels*
-    UInt32 imageSize; 
+    UInt32 imageSize;
     for each array_element in numberOfArrayElements*
        for each face in numberOfFaces
            for each z_slice in pixelDepth*
@@ -269,7 +269,7 @@ namespace ktx {
         COMPRESSED_RG11_EAC = 0x9272,
         COMPRESSED_SIGNED_RG11_EAC = 0x9273,
     };
- 
+
     enum class GLBaseInternalFormat : uint32_t {
         // GL 4.4 Table 8.11
         DEPTH_COMPONENT = 0x1902,
@@ -419,17 +419,20 @@ namespace ktx {
         using FaceOffsets = std::vector<size_t>;
         using FaceBytes = std::vector<const Byte*>;
 
+        const uint32_t _numFaces;
         // This is the byte offset from the _start_ of the image region. For example, level 0
         // will have a byte offset of 0.
-        const uint32_t _numFaces;
         const size_t _imageOffset;
         const uint32_t _imageSize;
+        // The full size of this image / mip level. This will be equivalent to _imageSize except when _numFaces > 1
+        const uint32_t _fullImageSize;
         const uint32_t _faceSize;
         const uint32_t _padding;
         ImageHeader(bool cube, size_t imageOffset, uint32_t imageSize, uint32_t padding) :
             _numFaces(cube ? NUM_CUBEMAPFACES : 1),
             _imageOffset(imageOffset),
-            _imageSize(imageSize * _numFaces),
+            _imageSize(imageSize),
+            _fullImageSize(imageSize * _numFaces),
             _faceSize(imageSize),
             _padding(padding) {
         }
@@ -466,7 +469,7 @@ namespace ktx {
 
     class KTX;
 
-    // A KTX descriptor is a lightweight container for all the information about a serialized KTX file, but without the 
+    // A KTX descriptor is a lightweight container for all the information about a serialized KTX file, but without the
     // actual image / face data available.
     struct KTXDescriptor {
         KTXDescriptor(const Header& header, const KeyValues& keyValues, const ImageDescriptors& imageDescriptors) : header(header), keyValues(keyValues), images(imageDescriptors) {}
@@ -495,7 +498,7 @@ namespace ktx {
         // Instead of creating a full Copy of the src data in a KTX object, the write serialization can be performed with the
         // following two functions
         //   size_t sizeNeeded = KTX::evalStorageSize(header, images);
-        //   
+        //
         //   //allocate a buffer of size "sizeNeeded" or map a file with enough capacity
         //   Byte* destBytes = new Byte[sizeNeeded];
         //
diff --git a/libraries/ktx/src/ktx/Writer.cpp b/libraries/ktx/src/ktx/Writer.cpp
index 50f63767a0..3afe705499 100644
--- a/libraries/ktx/src/ktx/Writer.cpp
+++ b/libraries/ktx/src/ktx/Writer.cpp
@@ -89,7 +89,7 @@ namespace ktx {
         for (uint32_t l = 0; l < numMips; l++) {
             if (imageDescriptors.size() > l) {
                 storageSize += sizeof(uint32_t);
-                storageSize += imageDescriptors[l]._imageSize;
+                storageSize += imageDescriptors[l]._fullImageSize;
                 storageSize += Header::evalPadding(imageDescriptors[l]._imageSize);
             }
         }
@@ -127,6 +127,7 @@ namespace ktx {
     size_t KTX::writeWithoutImages(Byte* destBytes, size_t destByteSize, const Header& header, const ImageDescriptors& descriptors, const KeyValues& keyValues) {
         // Check again that we have enough destination capacity
         if (!destBytes || (destByteSize < evalStorageSize(header, descriptors, keyValues))) {
+            qWarning() << "Destination capacity is insufficient to write KTX without images";
             return 0;
         }
 
@@ -149,13 +150,15 @@ namespace ktx {
         for (size_t i = 0; i < descriptors.size(); ++i) {
             auto ptr = reinterpret_cast<uint32_t*>(currentDestPtr);
             *ptr = descriptors[i]._imageSize;
-            ptr++;
+
 #ifdef DEBUG
+            ptr++;
             for (size_t k = 0; k < descriptors[i]._imageSize/4; k++) {
                 *(ptr + k) = 0xFFFFFFFF;
             }
 #endif
-            currentDestPtr += descriptors[i]._imageSize + sizeof(uint32_t);
+            currentDestPtr += sizeof(uint32_t);
+            currentDestPtr += descriptors[i]._fullImageSize;
         }
 
         return destByteSize;
diff --git a/libraries/model-networking/src/model-networking/TextureCache.cpp b/libraries/model-networking/src/model-networking/TextureCache.cpp
index 47fc62a9b5..79b179f3b9 100644
--- a/libraries/model-networking/src/model-networking/TextureCache.cpp
+++ b/libraries/model-networking/src/model-networking/TextureCache.cpp
@@ -648,13 +648,13 @@ void NetworkTexture::maybeHandleFinishedInitialLoad() {
                 // TODO Move image offset calculation to ktx ImageDescriptor
                 for (int level = static_cast<int>(images.size()) - 1; level >= 0; --level) {
                     auto& image = images[level];
-                    if (image._imageSize > imageSizeRemaining) {
+                    if (image._fullImageSize > imageSizeRemaining) {
                         break;
                     }
-                    ktxData -= image._imageSize;
-                    texture->assignStoredMip(static_cast<gpu::uint16>(level), image._imageSize, ktxData);
+                    ktxData -= image._fullImageSize;
+                    texture->assignStoredMip(static_cast<gpu::uint16>(level), image._fullImageSize, ktxData);
                     ktxData -= ktx::IMAGE_SIZE_WIDTH;
-                    imageSizeRemaining -= (image._imageSize + ktx::IMAGE_SIZE_WIDTH);
+                    imageSizeRemaining -= (image._fullImageSize + ktx::IMAGE_SIZE_WIDTH);
                 }
 
                 // We replace the texture with the one stored in the cache.  This deals with the possible race condition of two different 

From 7225326bfc0bce18993eac5f8f37ae4f98cc8855 Mon Sep 17 00:00:00 2001
From: Ryan Huffman <ryanhuffman@gmail.com>
Date: Tue, 16 May 2017 10:11:07 -0700
Subject: [PATCH 112/135] Fix failed mip insertions not being handled by
 TextureCache

---
 .../src/model-networking/TextureCache.cpp             | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/libraries/model-networking/src/model-networking/TextureCache.cpp b/libraries/model-networking/src/model-networking/TextureCache.cpp
index 79b179f3b9..2880762987 100644
--- a/libraries/model-networking/src/model-networking/TextureCache.cpp
+++ b/libraries/model-networking/src/model-networking/TextureCache.cpp
@@ -501,12 +501,19 @@ void NetworkTexture::ktxMipRequestFinished() {
             if (texture) {
                 texture->assignStoredMip(_ktxMipLevelRangeInFlight.first,
                     _ktxMipRequest->getData().size(), reinterpret_cast<uint8_t*>(_ktxMipRequest->getData().data()));
-                _lowestKnownPopulatedMip = _textureSource->getGPUTexture()->minAvailableMipLevel();
+
+                if (texture->minAvailableMipLevel() <= _ktxMipLevelRangeInFlight.first) {
+                    _lowestKnownPopulatedMip = texture->minAvailableMipLevel();
+                    _ktxResourceState = WAITING_FOR_MIP_REQUEST;
+                } else {
+                    qWarning(networking) << "Failed to load mip: " << _url << ":" << _ktxMipLevelRangeInFlight.first;
+                    _ktxResourceState = FAILED_TO_LOAD;
+                }
             } else {
+                _ktxResourceState = WAITING_FOR_MIP_REQUEST;
                 qWarning(networking) << "Trying to update mips but texture is null";
             }
             finishedLoading(true);
-            _ktxResourceState = WAITING_FOR_MIP_REQUEST;
         } else {
             finishedLoading(false);
             if (handleFailedRequest(_ktxMipRequest->getResult())) {

From 5a742002e26738023f1b41a4cea75a460eb53665 Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Tue, 16 May 2017 23:39:38 +0100
Subject: [PATCH 113/135] change default particle values

---
 scripts/system/edit.js | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/scripts/system/edit.js b/scripts/system/edit.js
index b06aeb2320..a6cbca008f 100644
--- a/scripts/system/edit.js
+++ b/scripts/system/edit.js
@@ -504,26 +504,26 @@ var toolBar = (function () {
                     blue: 0
                 },
                 emitAcceleration: {
-                    x: 0,
-                    y: 5,
-                    z: 0
+                    x: -0.5,
+                    y: 2.5,
+                    z: -0.5
                 },
                 accelerationSpread: {
-                    x: 1,
-                    y: 0,
-                    z: 1
+                    x: 0.5,
+                    y: 1,
+                    z: 0.5
                 },
-                emitRate: 3,
+                emitRate: 5.5,
                 emitSpeed: 0,
                 speedSpread: 0,
-                lifespan: 1,
+                lifespan: 1.5,
                 maxParticles: 10,
                 particleRadius: 0.25,
                 radiusStart: 0,
                 radiusFinish: 0.1,
                 radiusSpread: 0,
                 alpha: 0,
-                alphaStart: 0.1,
+                alphaStart: 1,
                 alphaFinish: 0,
                 polarStart: 0,
                 polarFinish: 0,

From e0212ac32bc824de8a2345f054b6e1b7a500695f Mon Sep 17 00:00:00 2001
From: Ryan Huffman <ryanhuffman@gmail.com>
Date: Tue, 16 May 2017 15:53:07 -0700
Subject: [PATCH 114/135] Remove _fullImageSize from ktx header

---
 libraries/gpu/src/gpu/Texture_ktx.cpp                     | 4 ++--
 libraries/ktx/src/ktx/KTX.h                               | 5 +----
 libraries/ktx/src/ktx/Writer.cpp                          | 4 ++--
 .../src/model-networking/TextureCache.cpp                 | 8 ++++----
 4 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/libraries/gpu/src/gpu/Texture_ktx.cpp b/libraries/gpu/src/gpu/Texture_ktx.cpp
index 85fd5f044c..e033355514 100644
--- a/libraries/gpu/src/gpu/Texture_ktx.cpp
+++ b/libraries/gpu/src/gpu/Texture_ktx.cpp
@@ -239,8 +239,8 @@ void KtxStorage::assignMipData(uint16 level, const storage::StoragePointer& stor
     }
 
     auto& imageDesc = _ktxDescriptor->images[level];
-    if (storage->size() != imageDesc._fullImageSize) {
-        qWarning() << "Invalid image size: " << storage->size() << ", expected: " << imageDesc._fullImageSize
+    if (storage->size() != imageDesc._imageSize) {
+        qWarning() << "Invalid image size: " << storage->size() << ", expected: " << imageDesc._imageSize
             << ", level: " << level << ", filename: " << QString::fromStdString(_filename);
         return;
     }
diff --git a/libraries/ktx/src/ktx/KTX.h b/libraries/ktx/src/ktx/KTX.h
index 69a34d3507..3f220abac3 100644
--- a/libraries/ktx/src/ktx/KTX.h
+++ b/libraries/ktx/src/ktx/KTX.h
@@ -424,15 +424,12 @@ namespace ktx {
         // will have a byte offset of 0.
         const size_t _imageOffset;
         const uint32_t _imageSize;
-        // The full size of this image / mip level. This will be equivalent to _imageSize except when _numFaces > 1
-        const uint32_t _fullImageSize;
         const uint32_t _faceSize;
         const uint32_t _padding;
         ImageHeader(bool cube, size_t imageOffset, uint32_t imageSize, uint32_t padding) :
             _numFaces(cube ? NUM_CUBEMAPFACES : 1),
             _imageOffset(imageOffset),
-            _imageSize(imageSize),
-            _fullImageSize(imageSize * _numFaces),
+            _imageSize(imageSize * _numFaces),
             _faceSize(imageSize),
             _padding(padding) {
         }
diff --git a/libraries/ktx/src/ktx/Writer.cpp b/libraries/ktx/src/ktx/Writer.cpp
index 3afe705499..2dcd0ea583 100644
--- a/libraries/ktx/src/ktx/Writer.cpp
+++ b/libraries/ktx/src/ktx/Writer.cpp
@@ -89,7 +89,7 @@ namespace ktx {
         for (uint32_t l = 0; l < numMips; l++) {
             if (imageDescriptors.size() > l) {
                 storageSize += sizeof(uint32_t);
-                storageSize += imageDescriptors[l]._fullImageSize;
+                storageSize += imageDescriptors[l]._imageSize;
                 storageSize += Header::evalPadding(imageDescriptors[l]._imageSize);
             }
         }
@@ -158,7 +158,7 @@ namespace ktx {
             }
 #endif
             currentDestPtr += sizeof(uint32_t);
-            currentDestPtr += descriptors[i]._fullImageSize;
+            currentDestPtr += descriptors[i]._imageSize;
         }
 
         return destByteSize;
diff --git a/libraries/model-networking/src/model-networking/TextureCache.cpp b/libraries/model-networking/src/model-networking/TextureCache.cpp
index 2880762987..8683d56b6b 100644
--- a/libraries/model-networking/src/model-networking/TextureCache.cpp
+++ b/libraries/model-networking/src/model-networking/TextureCache.cpp
@@ -655,13 +655,13 @@ void NetworkTexture::maybeHandleFinishedInitialLoad() {
                 // TODO Move image offset calculation to ktx ImageDescriptor
                 for (int level = static_cast<int>(images.size()) - 1; level >= 0; --level) {
                     auto& image = images[level];
-                    if (image._fullImageSize > imageSizeRemaining) {
+                    if (image._imageSize > imageSizeRemaining) {
                         break;
                     }
-                    ktxData -= image._fullImageSize;
-                    texture->assignStoredMip(static_cast<gpu::uint16>(level), image._fullImageSize, ktxData);
+                    ktxData -= image._imageSize;
+                    texture->assignStoredMip(static_cast<gpu::uint16>(level), image._imageSize, ktxData);
                     ktxData -= ktx::IMAGE_SIZE_WIDTH;
-                    imageSizeRemaining -= (image._fullImageSize + ktx::IMAGE_SIZE_WIDTH);
+                    imageSizeRemaining -= (image._imageSize + ktx::IMAGE_SIZE_WIDTH);
                 }
 
                 // We replace the texture with the one stored in the cache.  This deals with the possible race condition of two different 

From 805d23567dd17277c812a33f79377d881e817ced Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Tue, 16 May 2017 16:02:37 -0700
Subject: [PATCH 115/135] fix simple typo

---
 interface/src/avatar/MyAvatar.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/interface/src/avatar/MyAvatar.h b/interface/src/avatar/MyAvatar.h
index cbd51aaaf9..521d6e195c 100644
--- a/interface/src/avatar/MyAvatar.h
+++ b/interface/src/avatar/MyAvatar.h
@@ -125,7 +125,7 @@ class MyAvatar : public Avatar {
     Q_PROPERTY(controller::Pose rightHandTipPose READ getRightHandTipPose)
 
     Q_PROPERTY(float energy READ getEnergy WRITE setEnergy)
-    Q_PROPERTY(float isAway READ getIsAway WRITE setAway)
+    Q_PROPERTY(bool isAway READ getIsAway WRITE setAway)
 
     Q_PROPERTY(bool hmdLeanRecenterEnabled READ getHMDLeanRecenterEnabled WRITE setHMDLeanRecenterEnabled)
     Q_PROPERTY(bool collisionsEnabled READ getCollisionsEnabled WRITE setCollisionsEnabled)

From d065b569d388340ae9ff0df5902067c4b3994859 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Tue, 16 May 2017 16:03:13 -0700
Subject: [PATCH 116/135] support for variable avatar mass by size

---
 interface/src/avatar/AvatarManager.cpp        |  1 +
 interface/src/avatar/AvatarMotionState.cpp    |  3 --
 interface/src/avatar/MyAvatar.cpp             |  1 +
 .../src/avatar/MyCharacterController.cpp      | 30 +++++++++++---
 interface/src/avatar/MyCharacterController.h  |  4 ++
 .../src/avatars-renderer/Avatar.cpp           | 11 +++++
 .../src/avatars-renderer/Avatar.h             |  1 +
 libraries/avatars/src/AvatarData.cpp          |  4 +-
 libraries/avatars/src/AvatarData.h            |  3 ++
 libraries/physics/src/CharacterController.cpp |  7 +++-
 libraries/physics/src/CharacterController.h   |  1 +
 libraries/physics/src/ObjectMotionState.cpp   | 41 +++++++++++++++++--
 libraries/physics/src/ObjectMotionState.h     | 12 +++---
 13 files changed, 98 insertions(+), 21 deletions(-)

diff --git a/interface/src/avatar/AvatarManager.cpp b/interface/src/avatar/AvatarManager.cpp
index 1306ce03ea..d47e4cfd10 100644
--- a/interface/src/avatar/AvatarManager.cpp
+++ b/interface/src/avatar/AvatarManager.cpp
@@ -189,6 +189,7 @@ void AvatarManager::updateOtherAvatars(float deltaTime) {
             btCollisionShape* shape = const_cast<btCollisionShape*>(ObjectMotionState::getShapeManager()->getShape(shapeInfo));
             if (shape) {
                 AvatarMotionState* motionState = new AvatarMotionState(avatar, shape);
+                motionState->setMass(avatar->computeMass());
                 avatar->setPhysicsCallback([=] (uint32_t flags) { motionState->addDirtyFlags(flags); });
                 _motionStates.insert(avatar.get(), motionState);
                 _motionStatesToAddToPhysics.insert(motionState);
diff --git a/interface/src/avatar/AvatarMotionState.cpp b/interface/src/avatar/AvatarMotionState.cpp
index 0305634400..91c83afcbd 100644
--- a/interface/src/avatar/AvatarMotionState.cpp
+++ b/interface/src/avatar/AvatarMotionState.cpp
@@ -19,9 +19,6 @@
 AvatarMotionState::AvatarMotionState(AvatarSharedPointer avatar, const btCollisionShape* shape) : ObjectMotionState(shape), _avatar(avatar) {
     assert(_avatar);
     _type = MOTIONSTATE_TYPE_AVATAR;
-    if (_shape) {
-        _mass = 100.0f; // HACK
-    }
 }
 
 AvatarMotionState::~AvatarMotionState() {
diff --git a/interface/src/avatar/MyAvatar.cpp b/interface/src/avatar/MyAvatar.cpp
index 3da9b8a214..ec4da2c2a1 100755
--- a/interface/src/avatar/MyAvatar.cpp
+++ b/interface/src/avatar/MyAvatar.cpp
@@ -236,6 +236,7 @@ MyAvatar::MyAvatar(QThread* thread, RigPointer rig) :
     });
 
     connect(rig.get(), SIGNAL(onLoadComplete()), this, SIGNAL(onLoadComplete()));
+    _characterController.setDensity(_density);
 }
 
 MyAvatar::~MyAvatar() {
diff --git a/interface/src/avatar/MyCharacterController.cpp b/interface/src/avatar/MyCharacterController.cpp
index 0cdbc77626..3d98a0e604 100755
--- a/interface/src/avatar/MyCharacterController.cpp
+++ b/interface/src/avatar/MyCharacterController.cpp
@@ -49,12 +49,9 @@ void MyCharacterController::updateShapeIfNecessary() {
             // create RigidBody if it doesn't exist
             if (!_rigidBody) {
                 btCollisionShape* shape = computeShape();
-
-                // HACK: use some simple mass property defaults for now
-                const btScalar DEFAULT_AVATAR_MASS = 100.0f;
-                const btVector3 DEFAULT_AVATAR_INERTIA_TENSOR(30.0f, 8.0f, 30.0f);
-
-                _rigidBody = new btRigidBody(DEFAULT_AVATAR_MASS, nullptr, shape, DEFAULT_AVATAR_INERTIA_TENSOR);
+                btScalar mass = 1.0f;
+                btVector3 inertia(1.0f, 1.0f, 1.0f);
+                _rigidBody = new btRigidBody(mass, nullptr, shape, inertia);
             } else {
                 btCollisionShape* shape = _rigidBody->getCollisionShape();
                 if (shape) {
@@ -63,6 +60,7 @@ void MyCharacterController::updateShapeIfNecessary() {
                 shape = computeShape();
                 _rigidBody->setCollisionShape(shape);
             }
+            updateMassProperties();
 
             _rigidBody->setSleepingThresholds(0.0f, 0.0f);
             _rigidBody->setAngularFactor(0.0f);
@@ -331,3 +329,23 @@ void MyCharacterController::initRayShotgun(const btCollisionWorld* world) {
         }
     }
 }
+
+void MyCharacterController::updateMassProperties() {
+    assert(_rigidBody);
+    // the inertia tensor of a capsule with Y-axis of symmetry, radius R and cylinder height H is:
+    // Ix = density * (volumeCylinder * (H^2 / 12 + R^2 / 4) + volumeSphere * (2R^2 / 5 + H^2 / 2 + 3HR / 8))
+    // Iy = density * (volumeCylinder * (R^2 / 2) + volumeSphere * (2R^2 / 5)
+    btScalar r2 = _radius * _radius;
+    btScalar h2 = 4.0f * _halfHeight * _halfHeight;
+    btScalar volumeSphere = 4.0f * PI * r2 * _radius / 3.0f;
+    btScalar volumeCylinder = TWO_PI * r2 * 2.0f * _halfHeight;
+    btScalar cylinderXZ = volumeCylinder * (h2 / 12.0f + r2 / 4.0f);
+    btScalar capsXZ = volumeSphere * (2.0f * r2 / 5.0f + h2 / 2.0f + 6.0f * _halfHeight * _radius / 8.0f);
+    btScalar inertiaXZ = _density * (cylinderXZ + capsXZ);
+    btScalar inertiaY = _density * ((volumeCylinder * r2 / 2.0f) + volumeSphere * (2.0f * r2 / 5.0f));
+    btVector3 inertia(inertiaXZ, inertiaY, inertiaXZ);
+
+    btScalar mass = _density * (volumeCylinder + volumeSphere);
+
+    _rigidBody->setMassProps(mass, inertia);
+}
diff --git a/interface/src/avatar/MyCharacterController.h b/interface/src/avatar/MyCharacterController.h
index 6b38736352..fd9caface2 100644
--- a/interface/src/avatar/MyCharacterController.h
+++ b/interface/src/avatar/MyCharacterController.h
@@ -40,8 +40,11 @@ public:
     /// return true if RayShotgun hits anything
     bool testRayShotgun(const glm::vec3& position, const glm::vec3& step, RayShotgunResult& result);
 
+    void setDensity(btScalar density) { _density = density; }
+
 protected:
     void initRayShotgun(const btCollisionWorld* world);
+    void updateMassProperties() override;
 
 private:
     btConvexHullShape* computeShape() const;
@@ -52,6 +55,7 @@ protected:
     // shotgun scan data
     btAlignedObjectArray<btVector3> _topPoints;
     btAlignedObjectArray<btVector3> _bottomPoints;
+    btScalar _density { 1.0f };
 };
 
 #endif // hifi_MyCharacterController_h
diff --git a/libraries/avatars-renderer/src/avatars-renderer/Avatar.cpp b/libraries/avatars-renderer/src/avatars-renderer/Avatar.cpp
index 664b0094f4..82e571d0e8 100644
--- a/libraries/avatars-renderer/src/avatars-renderer/Avatar.cpp
+++ b/libraries/avatars-renderer/src/avatars-renderer/Avatar.cpp
@@ -1293,6 +1293,17 @@ void Avatar::getCapsule(glm::vec3& start, glm::vec3& end, float& radius) {
     radius = halfExtents.x;
 }
 
+float Avatar::computeMass() {
+    float radius;
+    glm::vec3 start, end;
+    getCapsule(start, end, radius);
+    // NOTE:
+    // volumeOfCapsule = volumeOfCylinder + volumeOfSphere
+    // volumeOfCapsule = (2PI * R^2 * H) + (4PI * R^3 / 3)
+    // volumeOfCapsule = 2PI * R^2 * (H + 2R/3)
+    return _density * TWO_PI * radius * radius * (glm::length(end - start) + 2.0f * radius / 3.0f);
+}
+
 // virtual
 void Avatar::rebuildCollisionShape() {
     addPhysicsFlags(Simulation::DIRTY_SHAPE);
diff --git a/libraries/avatars-renderer/src/avatars-renderer/Avatar.h b/libraries/avatars-renderer/src/avatars-renderer/Avatar.h
index 20704a08b2..148821db1e 100644
--- a/libraries/avatars-renderer/src/avatars-renderer/Avatar.h
+++ b/libraries/avatars-renderer/src/avatars-renderer/Avatar.h
@@ -196,6 +196,7 @@ public:
 
     virtual void computeShapeInfo(ShapeInfo& shapeInfo);
     void getCapsule(glm::vec3& start, glm::vec3& end, float& radius);
+    float computeMass();
 
     using SpatiallyNestable::setPosition;
     virtual void setPosition(const glm::vec3& position) override;
diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index 26afed152f..c23363e6b6 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -52,6 +52,7 @@ const QString AvatarData::FRAME_NAME = "com.highfidelity.recording.AvatarData";
 static const int TRANSLATION_COMPRESSION_RADIX = 12;
 static const int SENSOR_TO_WORLD_SCALE_RADIX = 10;
 static const float AUDIO_LOUDNESS_SCALE = 1024.0f;
+static const float DEFAULT_AVATAR_DENSITY = 1000.0f; // density of water
 
 #define ASSERT(COND)  do { if (!(COND)) { abort(); } } while(0)
 
@@ -65,7 +66,8 @@ AvatarData::AvatarData() :
     _headData(NULL),
     _errorLogExpiry(0),
     _owningAvatarMixer(),
-    _targetVelocity(0.0f)
+    _targetVelocity(0.0f),
+    _density(DEFAULT_AVATAR_DENSITY)
 {
     setBodyPitch(0.0f);
     setBodyYaw(-90.0f);
diff --git a/libraries/avatars/src/AvatarData.h b/libraries/avatars/src/AvatarData.h
index e6e0571878..c2bf98287a 100644
--- a/libraries/avatars/src/AvatarData.h
+++ b/libraries/avatars/src/AvatarData.h
@@ -626,6 +626,8 @@ public:
         _identityUpdatedAt = usecTimestampNow();
     }
 
+    float getDensity() const { return _density; }
+
 signals:
     void displayNameChanged();
 
@@ -782,6 +784,7 @@ protected:
 
     bool _identityDataChanged { false };
     quint64 _identityUpdatedAt { 0 };
+    float _density;
 
 private:
     friend void avatarStateFromFrame(const QByteArray& frameData, AvatarData* _avatar);
diff --git a/libraries/physics/src/CharacterController.cpp b/libraries/physics/src/CharacterController.cpp
index e4ff1b0b44..ee240a6aac 100755
--- a/libraries/physics/src/CharacterController.cpp
+++ b/libraries/physics/src/CharacterController.cpp
@@ -112,6 +112,9 @@ void CharacterController::setDynamicsWorld(btDynamicsWorld* world) {
             _dynamicsWorld = nullptr;
         }
         int16_t collisionGroup = computeCollisionGroup();
+        if (_rigidBody) {
+            updateMassProperties();
+        }
         if (world && _rigidBody) {
             // add to new world
             _dynamicsWorld = world;
@@ -127,7 +130,9 @@ void CharacterController::setDynamicsWorld(btDynamicsWorld* world) {
         _ghost.setCollisionGroupAndMask(collisionGroup, BULLET_COLLISION_MASK_MY_AVATAR & (~ collisionGroup));
         _ghost.setCollisionWorld(_dynamicsWorld);
         _ghost.setRadiusAndHalfHeight(_radius, _halfHeight);
-        _ghost.setWorldTransform(_rigidBody->getWorldTransform());
+        if (_rigidBody) {
+            _ghost.setWorldTransform(_rigidBody->getWorldTransform());
+        }
     }
     if (_dynamicsWorld) {
         if (_pendingFlags & PENDING_FLAG_UPDATE_SHAPE) {
diff --git a/libraries/physics/src/CharacterController.h b/libraries/physics/src/CharacterController.h
index 0a11fad0b7..6790495ff8 100644
--- a/libraries/physics/src/CharacterController.h
+++ b/libraries/physics/src/CharacterController.h
@@ -128,6 +128,7 @@ protected:
     void setState(State state);
 #endif
 
+    virtual void updateMassProperties() = 0;
     void updateGravity();
     void updateUpAxis(const glm::quat& rotation);
     bool checkForSupport(btCollisionWorld* collisionWorld);
diff --git a/libraries/physics/src/ObjectMotionState.cpp b/libraries/physics/src/ObjectMotionState.cpp
index 503b39dc1c..5a36d69035 100644
--- a/libraries/physics/src/ObjectMotionState.cpp
+++ b/libraries/physics/src/ObjectMotionState.cpp
@@ -63,10 +63,7 @@ ShapeManager* ObjectMotionState::getShapeManager() {
 }
 
 ObjectMotionState::ObjectMotionState(const btCollisionShape* shape) :
-    _motionType(MOTION_TYPE_STATIC),
     _shape(shape),
-    _body(nullptr),
-    _mass(0.0f),
     _lastKinematicStep(worldSimulationStep)
 {
 }
@@ -74,7 +71,43 @@ ObjectMotionState::ObjectMotionState(const btCollisionShape* shape) :
 ObjectMotionState::~ObjectMotionState() {
     assert(!_body);
     setShape(nullptr);
-    _type = MOTIONSTATE_TYPE_INVALID;
+}
+
+void ObjectMotionState::setMass(float mass) {
+    _density = 1.0f;
+    if (_shape) {
+        // we compute the density for the current shape's Aabb volume
+        // and save that instead of the total mass
+        btTransform transform;
+        transform.setIdentity();
+        btVector3 minCorner, maxCorner;
+        _shape->getAabb(transform, minCorner, maxCorner);
+        btVector3 diagonal = maxCorner - minCorner;
+        float volume = diagonal.getX() * diagonal.getY() * diagonal.getZ();
+        if (volume > EPSILON) {
+            _density = fabsf(mass) / volume;
+        }
+    }
+}
+
+float ObjectMotionState::getMass() const {
+    if (_shape) {
+        // scale the density by the current Aabb volume to get mass
+        btTransform transform;
+        transform.setIdentity();
+        btVector3 minCorner, maxCorner;
+        _shape->getAabb(transform, minCorner, maxCorner);
+        btVector3 diagonal = maxCorner - minCorner;
+        float volume = diagonal.getX() * diagonal.getY() * diagonal.getZ();
+
+        // cap the max mass for numerical stability
+        const float MIN_OBJECT_MASS = 0.0f;
+        const float MAX_OBJECT_DENSITY = 20000.0f; // kg/m^3 density of Tungsten
+        const float MAX_OBJECT_VOLUME = 1.0e6f;
+        const float MAX_OBJECT_MASS = MAX_OBJECT_DENSITY * MAX_OBJECT_VOLUME;
+        return glm::clamp(_density * volume, MIN_OBJECT_MASS, MAX_OBJECT_MASS);
+    }
+    return 0.0f;
 }
 
 void ObjectMotionState::setBodyLinearVelocity(const glm::vec3& velocity) const {
diff --git a/libraries/physics/src/ObjectMotionState.h b/libraries/physics/src/ObjectMotionState.h
index 645bd6fc14..1e582ea854 100644
--- a/libraries/physics/src/ObjectMotionState.h
+++ b/libraries/physics/src/ObjectMotionState.h
@@ -93,8 +93,8 @@ public:
     MotionStateType getType() const { return _type; }
     virtual PhysicsMotionType getMotionType() const { return _motionType; }
 
-    void setMass(float mass) { _mass = fabsf(mass); }
-    float getMass() { return _mass; }
+    void setMass(float mass);
+    float getMass() const;
 
     void setBodyLinearVelocity(const glm::vec3& velocity) const;
     void setBodyAngularVelocity(const glm::vec3& velocity) const;
@@ -159,12 +159,12 @@ protected:
     void setRigidBody(btRigidBody* body);
     virtual void setShape(const btCollisionShape* shape);
 
-    MotionStateType _type = MOTIONSTATE_TYPE_INVALID; // type of MotionState
-    PhysicsMotionType _motionType; // type of motion: KINEMATIC, DYNAMIC, or STATIC
+    MotionStateType _type { MOTIONSTATE_TYPE_INVALID }; // type of MotionState
+    PhysicsMotionType _motionType { MOTION_TYPE_STATIC }; // type of motion: KINEMATIC, DYNAMIC, or STATIC
 
     const btCollisionShape* _shape;
-    btRigidBody* _body;
-    float _mass;
+    btRigidBody* _body { nullptr };
+    float _density { 1.0f };
 
     uint32_t _lastKinematicStep;
     bool _hasInternalKinematicChanges { false };

From 1e4e2cc1b4810247bb26c36d2d393a64d249d8f7 Mon Sep 17 00:00:00 2001
From: Seth Alves <seth.alves@gmail.com>
Date: Tue, 16 May 2017 16:22:40 -0700
Subject: [PATCH 117/135] when a parent entity is deleted, delete its children
 in the local tree, rather than waiting for the server to tell us about it

---
 libraries/entities/src/EntityTree.cpp | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/libraries/entities/src/EntityTree.cpp b/libraries/entities/src/EntityTree.cpp
index 457b7c21f6..6975d017b0 100644
--- a/libraries/entities/src/EntityTree.cpp
+++ b/libraries/entities/src/EntityTree.cpp
@@ -452,6 +452,13 @@ void EntityTree::deleteEntity(const EntityItemID& entityID, bool force, bool ign
 
     // NOTE: callers must lock the tree before using this method
     DeleteEntityOperator theOperator(getThisPointer(), entityID);
+
+    existingEntity->forEachDescendant([&](SpatiallyNestablePointer descendant) {
+        auto descendantID = descendant->getID();
+        theOperator.addEntityIDToDeleteList(descendantID);
+        emit deletingEntity(descendantID);
+    });
+
     recurseTreeWithOperator(&theOperator);
     processRemovedEntities(theOperator);
     _isDirty = true;

From b9ddc3b19f5ada6d2e6a30e83914fdbc3e2950c5 Mon Sep 17 00:00:00 2001
From: Zach Fox <fox@highfidelity.io>
Date: Tue, 16 May 2017 16:25:22 -0700
Subject: [PATCH 118/135] Improve robustness of display name focus in PAL

---
 interface/resources/qml/hifi/NameCard.qml | 98 ++++++++++++-----------
 1 file changed, 50 insertions(+), 48 deletions(-)

diff --git a/interface/resources/qml/hifi/NameCard.qml b/interface/resources/qml/hifi/NameCard.qml
index 0927d46fdf..a86defdfd7 100644
--- a/interface/resources/qml/hifi/NameCard.qml
+++ b/interface/resources/qml/hifi/NameCard.qml
@@ -132,62 +132,16 @@ Item {
         color: hifi.colors.textFieldLightBackground
         border.color: hifi.colors.blueHighlight
         border.width: 0
-        TextInput {
-            id: myDisplayNameText
-            // Properties
-            text: thisNameCard.displayName
-            maximumLength: 256
-            clip: true
-            // Size
-            width: parent.width
-            height: parent.height
-            // Anchors
-            anchors.verticalCenter: parent.verticalCenter
-            anchors.left: parent.left
-            anchors.leftMargin: 10
-            anchors.right: parent.right
-            anchors.rightMargin: editGlyph.width + editGlyph.anchors.rightMargin
-            // Style
-            color: hifi.colors.darkGray
-            FontLoader { id: firaSansSemiBold; source: "../../fonts/FiraSans-SemiBold.ttf"; }
-            font.family: firaSansSemiBold.name
-            font.pixelSize: displayNameTextPixelSize
-            selectionColor: hifi.colors.blueAccent
-            selectedTextColor: "black"
-            // Text Positioning
-            verticalAlignment: TextInput.AlignVCenter
-            horizontalAlignment: TextInput.AlignLeft
-            autoScroll: false;
-            // Signals
-            onEditingFinished: {
-                if (MyAvatar.displayName !== text) {
-                    MyAvatar.displayName = text;
-                    UserActivityLogger.palAction("display_name_change", text);
-                }
-                cursorPosition = 0
-                focus = false
-                myDisplayName.border.width = 0
-                color = hifi.colors.darkGray
-                pal.currentlyEditingDisplayName = false
-                autoScroll = false;
-            }
-        }
         MouseArea {
             anchors.fill: parent
             hoverEnabled: true
             onClicked: {
-                myDisplayName.border.width = 1
-                myDisplayNameText.focus ? myDisplayNameText.cursorPosition = myDisplayNameText.positionAt(mouseX, mouseY, TextInput.CursorOnCharacter) : myDisplayNameText.selectAll();
-                myDisplayNameText.focus = true
-                myDisplayNameText.color = "black"
-                pal.currentlyEditingDisplayName = true
-                myDisplayNameText.autoScroll = true;
+                myDisplayNameText.focus = true;
+                myDisplayNameText.cursorPosition = myDisplayNameText.positionAt(mouseX - myDisplayNameText.anchors.leftMargin, mouseY, TextInput.CursorOnCharacter);
             }
             onDoubleClicked: {
                 myDisplayNameText.selectAll();
                 myDisplayNameText.focus = true;
-                pal.currentlyEditingDisplayName = true
-                myDisplayNameText.autoScroll = true;
             }
             onEntered: myDisplayName.color = hifi.colors.lightGrayText;
             onExited: myDisplayName.color = hifi.colors.textFieldLightBackground;
@@ -207,6 +161,54 @@ Item {
             verticalAlignment: Text.AlignVCenter
             color: hifi.colors.baseGray
         }
+        TextInput {
+            id: myDisplayNameText
+            // Properties
+            text: thisNameCard.displayName
+            maximumLength: 256
+            clip: true
+            // Size
+            width: parent.width
+            height: parent.height
+            // Anchors
+            anchors.verticalCenter: parent.verticalCenter
+            anchors.left: parent.left
+            anchors.leftMargin: 10
+            anchors.right: parent.right
+            anchors.rightMargin: editGlyph.width + editGlyph.anchors.rightMargin
+            // Style
+            FontLoader { id: firaSansSemiBold; source: "../../fonts/FiraSans-SemiBold.ttf"; }
+            font.family: firaSansSemiBold.name
+            font.pixelSize: displayNameTextPixelSize
+            selectionColor: hifi.colors.blueAccent
+            selectedTextColor: "black"
+            // Text Positioning
+            verticalAlignment: TextInput.AlignVCenter
+            horizontalAlignment: TextInput.AlignLeft
+            autoScroll: false;
+            // Signals
+            onEditingFinished: {
+                if (MyAvatar.displayName !== text) {
+                    MyAvatar.displayName = text;
+                    UserActivityLogger.palAction("display_name_change", text);
+                }
+                focus = false;
+            }
+            onFocusChanged: {
+                if (focus === true) {
+                    myDisplayName.border.width = 1
+                    color = "black"
+                    autoScroll = true;
+                    pal.currentlyEditingDisplayName = true
+                } else {
+                    myDisplayName.border.width = 0
+                    color: hifi.colors.darkGray
+                    cursorPosition = 0;
+                    autoScroll = false;
+                    pal.currentlyEditingDisplayName = false
+                }
+            }
+        }
     }
     // DisplayName container for others' cards
     Item {

From 04fcdfc4a2ccaa214bdba8ac71d17050c3cfaac0 Mon Sep 17 00:00:00 2001
From: David Rowe <david@ctrlaltstudio.com>
Date: Wed, 17 May 2017 12:23:53 +1200
Subject: [PATCH 119/135] Add domain to record script user activity logging

---
 scripts/system/record.js | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/scripts/system/record.js b/scripts/system/record.js
index 3db82696ef..acc81f2526 100644
--- a/scripts/system/record.js
+++ b/scripts/system/record.js
@@ -37,6 +37,12 @@
         Window.alert(message);
     }
 
+    function logDetails() {
+        return {
+            current_domain: location.placename
+        };
+    }
+
     RecordingIndicator = (function () {
         // Displays "recording" overlay.
 
@@ -181,7 +187,7 @@
 
             recordingState = IDLE;
             log("Finish recording");
-            UserActivityLogger.logAction("record_finish_recording");
+            UserActivityLogger.logAction("record_finish_recording", logDetails());
             playSound(finishRecordingSound);
             Recording.stopRecording();
             RecordingIndicator.hide();
@@ -519,7 +525,7 @@
                         value: Player.numberOfPlayers()
                     }));
                     updateRecordingStatus(!Recorder.isIdle());
-                    UserActivityLogger.logAction("record_open_dialog");
+                    UserActivityLogger.logAction("record_open_dialog", logDetails());
                     break;
                 case STOP_PLAYING_RECORDING_ACTION:
                     // Stop the specified player.
@@ -530,7 +536,7 @@
                     recording = Window.browseAssets("Select Recording to Play", "recordings", "*.hfr");
                     if (recording) {
                         log("Load recording " + recording);
-                        UserActivityLogger.logAction("record_load_recording");
+                        UserActivityLogger.logAction("record_load_recording", logDetails());
                         Player.playRecording("atp:" + recording, MyAvatar.position, MyAvatar.orientation);
                     }
                     break;
@@ -660,7 +666,7 @@
         isConnected = Window.location.isConnected;
         Script.update.connect(onUpdate);
 
-        UserActivityLogger.logAction("record_run_script");
+        UserActivityLogger.logAction("record_run_script", logDetails());
     }
 
     function tearDown() {

From c678fd67eddad7298342445c45fed4eb6c64c527 Mon Sep 17 00:00:00 2001
From: Triplelexx <mojolexx@gmail.com>
Date: Wed, 17 May 2017 14:52:11 +0100
Subject: [PATCH 120/135] change default particle texture to production

---
 scripts/system/edit.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/system/edit.js b/scripts/system/edit.js
index a6cbca008f..f39165f3df 100644
--- a/scripts/system/edit.js
+++ b/scripts/system/edit.js
@@ -527,7 +527,7 @@ var toolBar = (function () {
                 alphaFinish: 0,
                 polarStart: 0,
                 polarFinish: 0,
-                textures: "https://raw.githubusercontent.com/Triplelexx/hifi/f98c3556fd0011150e35dc20275434b6321ac014/interface/resources/images/wispy-smoke.png"
+                textures: "https://content.highfidelity.com/DomainContent/production/Particles/wispy-smoke.png"
             });
         });
 

From 97ed7195069c864544ff56daa97960b954779455 Mon Sep 17 00:00:00 2001
From: Andrew Meadows <andrew@highfidelity.io>
Date: Wed, 17 May 2017 10:40:45 -0700
Subject: [PATCH 121/135] cap scripted linear and angular velocity inputs

---
 libraries/entities/src/EntityItem.cpp | 52 ++++++++++++++++++---------
 1 file changed, 36 insertions(+), 16 deletions(-)

diff --git a/libraries/entities/src/EntityItem.cpp b/libraries/entities/src/EntityItem.cpp
index a6de541958..3e858f48be 100644
--- a/libraries/entities/src/EntityItem.cpp
+++ b/libraries/entities/src/EntityItem.cpp
@@ -1691,14 +1691,20 @@ void EntityItem::updateVelocity(const glm::vec3& value) {
                 setLocalVelocity(Vectors::ZERO);
             }
         } else {
-            const float MIN_LINEAR_SPEED = 0.001f;
-            if (glm::length(value) < MIN_LINEAR_SPEED) {
-                velocity = ENTITY_ITEM_ZERO_VEC3;
-            } else {
-                velocity = value;
+            float speed = glm::length(value);
+            if (!isnan(speed)) {
+                const float MIN_LINEAR_SPEED = 0.001f;
+                const float MAX_LINEAR_SPEED = 270.0f; // 3m per step at 90Hz
+                if (speed < MIN_LINEAR_SPEED) {
+                    velocity = ENTITY_ITEM_ZERO_VEC3;
+                } else if (speed > MAX_LINEAR_SPEED) {
+                    velocity = (MAX_LINEAR_SPEED / speed) * value;
+                } else {
+                    velocity = value;
+                }
+                setLocalVelocity(velocity);
+                _dirtyFlags |= Simulation::DIRTY_LINEAR_VELOCITY;
             }
-            setLocalVelocity(velocity);
-            _dirtyFlags |= Simulation::DIRTY_LINEAR_VELOCITY;
         }
     }
 }
@@ -1723,8 +1729,16 @@ void EntityItem::updateGravity(const glm::vec3& value) {
         if (getShapeType() == SHAPE_TYPE_STATIC_MESH) {
             _gravity = Vectors::ZERO;
         } else {
-            _gravity = value;
-            _dirtyFlags |= Simulation::DIRTY_LINEAR_VELOCITY;
+            float magnitude = glm::length(value);
+            if (!isnan(magnitude)) {
+                const float MAX_ACCELERATION_OF_GRAVITY = 10.0f * 9.8f; // 10g
+                if (magnitude > MAX_ACCELERATION_OF_GRAVITY) {
+                    _gravity = (MAX_ACCELERATION_OF_GRAVITY / magnitude) * value;
+                } else {
+                    _gravity = value;
+                }
+                _dirtyFlags |= Simulation::DIRTY_LINEAR_VELOCITY;
+            }
         }
     }
 }
@@ -1735,14 +1749,20 @@ void EntityItem::updateAngularVelocity(const glm::vec3& value) {
         if (getShapeType() == SHAPE_TYPE_STATIC_MESH) {
             setLocalAngularVelocity(Vectors::ZERO);
         } else {
-            const float MIN_ANGULAR_SPEED = 0.0002f;
-            if (glm::length(value) < MIN_ANGULAR_SPEED) {
-                angularVelocity = ENTITY_ITEM_ZERO_VEC3;
-            } else {
-                angularVelocity = value;
+            float speed = glm::length(value);
+            if (!isnan(speed)) {
+                const float MIN_ANGULAR_SPEED = 0.0002f;
+                const float MAX_ANGULAR_SPEED = 9.0f * TWO_PI; // 1/10 rotation per step at 90Hz
+                if (speed < MIN_ANGULAR_SPEED) {
+                    angularVelocity = ENTITY_ITEM_ZERO_VEC3;
+                } else if (speed > MAX_ANGULAR_SPEED) {
+                    angularVelocity = (MAX_ANGULAR_SPEED / speed) * value;
+                } else {
+                    angularVelocity = value;
+                }
+                setLocalAngularVelocity(angularVelocity);
+                _dirtyFlags |= Simulation::DIRTY_ANGULAR_VELOCITY;
             }
-            setLocalAngularVelocity(angularVelocity);
-            _dirtyFlags |= Simulation::DIRTY_ANGULAR_VELOCITY;
         }
     }
 }

From 3570bd905e6e48d5eec1d43abae2ce75c62a235d Mon Sep 17 00:00:00 2001
From: Seth Alves <seth.alves@gmail.com>
Date: Wed, 17 May 2017 11:55:23 -0700
Subject: [PATCH 122/135] update for spring to tractor name-change

---
 scripts/developer/tests/dynamics/dynamics-tests.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/scripts/developer/tests/dynamics/dynamics-tests.html b/scripts/developer/tests/dynamics/dynamics-tests.html
index 0f324e121c..6ef82c4b70 100644
--- a/scripts/developer/tests/dynamics/dynamics-tests.html
+++ b/scripts/developer/tests/dynamics/dynamics-tests.html
@@ -9,8 +9,8 @@
 
     lifetime: <input id="lifetime" type="text" size=6>
     <hr>
-    <input type="button" id="cone-twist-and-spring-lever-test" value="Cone-Twist and Spring-Action Lever"><br>
-    A platform with a lever.  The lever can be moved in a cone and rotated.  A spring brings it back to its neutral position.
+    <input type="button" id="cone-twist-and-tractor-lever-test" value="Cone-Twist and Tractor-Action Lever"><br>
+    A platform with a lever.  The lever can be moved in a cone and rotated.  A tractor brings it back to its neutral position.
     <hr>
     <input type="button" id="door-vs-world-test" value="Hinge Between Swinging Door and World"><br>
     A grabbable door with a hinge between it and world-space.
@@ -31,7 +31,7 @@
     A chain of spheres connected by ball-and-socket joints coincident-with the spheres.
     <hr>
     <input type="button" id="ragdoll-test" value="Ragdoll"><br>
-    A self-righting ragdoll.  The head is on a weak spring vs the body.
+    A self-righting ragdoll.  The head is on a weak tractor vs the body.
 
   </body>
 </html>

From 9b1fe60b7c3f3407f240a430dcf33ea8a437fb40 Mon Sep 17 00:00:00 2001
From: Seth Alves <seth.alves@gmail.com>
Date: Wed, 17 May 2017 11:55:31 -0700
Subject: [PATCH 123/135] suppress frequest log-spam from constraints.

---
 libraries/physics/src/ObjectConstraintBallSocket.cpp | 6 ++++++
 libraries/physics/src/ObjectConstraintConeTwist.cpp  | 6 ++++++
 libraries/physics/src/ObjectConstraintHinge.cpp      | 6 ++++++
 libraries/physics/src/ObjectConstraintSlider.cpp     | 6 ++++++
 4 files changed, 24 insertions(+)

diff --git a/libraries/physics/src/ObjectConstraintBallSocket.cpp b/libraries/physics/src/ObjectConstraintBallSocket.cpp
index fb36a49e92..9dd85954a3 100644
--- a/libraries/physics/src/ObjectConstraintBallSocket.cpp
+++ b/libraries/physics/src/ObjectConstraintBallSocket.cpp
@@ -9,6 +9,8 @@
 //  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
 //
 
+#include <LogHandler.h>
+
 #include "QVariantGLM.h"
 
 #include "EntityTree.h"
@@ -83,6 +85,9 @@ btTypedConstraint* ObjectConstraintBallSocket::getConstraint() {
         return constraint;
     }
 
+    static QString repeatedBallSocketNoRigidBody = LogHandler::getInstance().addRepeatedMessageRegex(
+        "ObjectConstraintBallSocket::getConstraint -- no rigidBody.*");
+
     btRigidBody* rigidBodyA = getRigidBody();
     if (!rigidBodyA) {
         qCDebug(physics) << "ObjectConstraintBallSocket::getConstraint -- no rigidBodyA";
@@ -94,6 +99,7 @@ btTypedConstraint* ObjectConstraintBallSocket::getConstraint() {
 
         btRigidBody* rigidBodyB = getOtherRigidBody(otherEntityID);
         if (!rigidBodyB) {
+            qCDebug(physics) << "ObjectConstraintBallSocket::getConstraint -- no rigidBodyB";
             return nullptr;
         }
 
diff --git a/libraries/physics/src/ObjectConstraintConeTwist.cpp b/libraries/physics/src/ObjectConstraintConeTwist.cpp
index 15d9378443..49f926af81 100644
--- a/libraries/physics/src/ObjectConstraintConeTwist.cpp
+++ b/libraries/physics/src/ObjectConstraintConeTwist.cpp
@@ -9,6 +9,8 @@
 //  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
 //
 
+#include <LogHandler.h>
+
 #include "QVariantGLM.h"
 
 #include "EntityTree.h"
@@ -94,6 +96,9 @@ btTypedConstraint* ObjectConstraintConeTwist::getConstraint() {
         return constraint;
     }
 
+    static QString repeatedConeTwistNoRigidBody = LogHandler::getInstance().addRepeatedMessageRegex(
+        "ObjectConstraintConeTwist::getConstraint -- no rigidBody.*");
+
     btRigidBody* rigidBodyA = getRigidBody();
     if (!rigidBodyA) {
         qCDebug(physics) << "ObjectConstraintConeTwist::getConstraint -- no rigidBodyA";
@@ -125,6 +130,7 @@ btTypedConstraint* ObjectConstraintConeTwist::getConstraint() {
 
         btRigidBody* rigidBodyB = getOtherRigidBody(otherEntityID);
         if (!rigidBodyB) {
+            qCDebug(physics) << "ObjectConstraintConeTwist::getConstraint -- no rigidBodyB";
             return nullptr;
         }
 
diff --git a/libraries/physics/src/ObjectConstraintHinge.cpp b/libraries/physics/src/ObjectConstraintHinge.cpp
index dbadf433c3..52be64796a 100644
--- a/libraries/physics/src/ObjectConstraintHinge.cpp
+++ b/libraries/physics/src/ObjectConstraintHinge.cpp
@@ -9,6 +9,8 @@
 //  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
 //
 
+#include <LogHandler.h>
+
 #include "QVariantGLM.h"
 
 #include "EntityTree.h"
@@ -93,6 +95,9 @@ btTypedConstraint* ObjectConstraintHinge::getConstraint() {
         return constraint;
     }
 
+    static QString repeatedHingeNoRigidBody = LogHandler::getInstance().addRepeatedMessageRegex(
+        "ObjectConstraintHinge::getConstraint -- no rigidBody.*");
+
     btRigidBody* rigidBodyA = getRigidBody();
     if (!rigidBodyA) {
         qCDebug(physics) << "ObjectConstraintHinge::getConstraint -- no rigidBodyA";
@@ -110,6 +115,7 @@ btTypedConstraint* ObjectConstraintHinge::getConstraint() {
         // This hinge is between two entities... find the other rigid body.
         btRigidBody* rigidBodyB = getOtherRigidBody(otherEntityID);
         if (!rigidBodyB) {
+            qCDebug(physics) << "ObjectConstraintHinge::getConstraint -- no rigidBodyB";
             return nullptr;
         }
 
diff --git a/libraries/physics/src/ObjectConstraintSlider.cpp b/libraries/physics/src/ObjectConstraintSlider.cpp
index 3716960a6e..ded9ad47e6 100644
--- a/libraries/physics/src/ObjectConstraintSlider.cpp
+++ b/libraries/physics/src/ObjectConstraintSlider.cpp
@@ -9,6 +9,8 @@
 //  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
 //
 
+#include <LogHandler.h>
+
 #include "QVariantGLM.h"
 
 #include "EntityTree.h"
@@ -85,6 +87,9 @@ btTypedConstraint* ObjectConstraintSlider::getConstraint() {
         return constraint;
     }
 
+    static QString repeatedSliderNoRigidBody = LogHandler::getInstance().addRepeatedMessageRegex(
+        "ObjectConstraintSlider::getConstraint -- no rigidBody.*");
+
     btRigidBody* rigidBodyA = getRigidBody();
     if (!rigidBodyA) {
         qCDebug(physics) << "ObjectConstraintSlider::getConstraint -- no rigidBodyA";
@@ -116,6 +121,7 @@ btTypedConstraint* ObjectConstraintSlider::getConstraint() {
 
         btRigidBody* rigidBodyB = getOtherRigidBody(otherEntityID);
         if (!rigidBodyB) {
+            qCDebug(physics) << "ObjectConstraintSlider::getConstraint -- no rigidBodyB";
             return nullptr;
         }
 

From 0d779779364606de02c30d6c9b085a968a148a22 Mon Sep 17 00:00:00 2001
From: Atlante45 <clement.brisset@gmail.com>
Date: Wed, 17 May 2017 12:11:15 -0700
Subject: [PATCH 124/135] Enable Map/List storage in the settings

---
 libraries/shared/src/SettingHelpers.cpp | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)

diff --git a/libraries/shared/src/SettingHelpers.cpp b/libraries/shared/src/SettingHelpers.cpp
index cbda4e4096..20d6170fc4 100644
--- a/libraries/shared/src/SettingHelpers.cpp
+++ b/libraries/shared/src/SettingHelpers.cpp
@@ -126,17 +126,6 @@ QJsonDocument variantMapToJsonDocument(const QSettings::SettingsMap& map) {
         }
 
         switch (variantType) {
-            case QVariant::Map: {
-                auto varmap = variant.toMap();
-                for (auto mapit = varmap.cbegin(); mapit != varmap.cend(); ++mapit) {
-                    auto& mapkey = mapit.key();
-                    auto& mapvariant = mapit.value();
-                    object.insert(key + "/" + mapkey, QJsonValue::fromVariant(mapvariant));
-                }
-                break;
-            }
-
-            case QVariant::List:
             case QVariant::Hash: {
                 qCritical() << "Unsupported variant type" << variant.typeName();
                 Q_ASSERT(false);
@@ -152,6 +141,8 @@ QJsonDocument variantMapToJsonDocument(const QSettings::SettingsMap& map) {
             case QVariant::UInt:
             case QVariant::Bool:
             case QVariant::Double:
+            case QVariant::Map:
+            case QVariant::List:
                 object.insert(key, QJsonValue::fromVariant(variant));
                 break;
 

From ab3ea65d5417a661bb561de88e3f62b099b1f7af Mon Sep 17 00:00:00 2001
From: samcake <samuel.gateau@gmail.com>
Date: Wed, 17 May 2017 12:36:12 -0700
Subject: [PATCH 125/135] Simply add protections when accessing the mip bytes
 of a texture when provided from a KtxStorage

---
 libraries/gpu/src/gpu/Texture_ktx.cpp   | 11 ++++++++++-
 libraries/shared/src/shared/Storage.cpp |  4 +++-
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/libraries/gpu/src/gpu/Texture_ktx.cpp b/libraries/gpu/src/gpu/Texture_ktx.cpp
index 524fd0a88c..27d92fecf2 100644
--- a/libraries/gpu/src/gpu/Texture_ktx.cpp
+++ b/libraries/gpu/src/gpu/Texture_ktx.cpp
@@ -210,7 +210,16 @@ PixelsPointer KtxStorage::getMipFace(uint16 level, uint8 face) const {
     auto faceSize = _ktxDescriptor->getMipFaceTexelsSize(level, face);
     if (faceSize != 0 && faceOffset != 0) {
         auto file = maybeOpenFile();
-        result = file->createView(faceSize, faceOffset)->toMemoryStorage();
+        if (file) {
+            auto storageView = file->createView(faceSize, faceOffset);
+            if (storageView) {
+                return storageView->toMemoryStorage();
+            } else {
+                qWarning() << "Failed to get a valid storageView for faceSize=" << faceSize << "  faceOffset=" << faceOffset << "out of valid file " << QString::fromStdString(_filename);
+            }
+        } else {
+            qWarning() << "Failed to get a valid file out of maybeOpenFile " << QString::fromStdString(_filename);
+        }
     }
     return result;
 }
diff --git a/libraries/shared/src/shared/Storage.cpp b/libraries/shared/src/shared/Storage.cpp
index f6585e6ecb..e479559e6a 100644
--- a/libraries/shared/src/shared/Storage.cpp
+++ b/libraries/shared/src/shared/Storage.cpp
@@ -25,7 +25,9 @@ StoragePointer Storage::createView(size_t viewSize, size_t offset) const {
         viewSize = selfSize;
     }
     if ((viewSize + offset) > selfSize) {
-        throw std::runtime_error("Invalid mapping range");
+        return StoragePointer();
+        //TODO: Disable te exception for now and return an empty storage instead.
+        //throw std::runtime_error("Invalid mapping range");
     }
     return std::make_shared<ViewStorage>(shared_from_this(), viewSize, data() + offset);
 }

From 0f0ad11344c50f9e6c2f09548318127556e9c982 Mon Sep 17 00:00:00 2001
From: howard-stearns <howard.stearns@gmail.com>
Date: Wed, 17 May 2017 13:47:24 -0700
Subject: [PATCH 126/135] Ensure avatar identity packet at mixer.

---
 assignment-client/src/avatars/AvatarMixerClientData.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/assignment-client/src/avatars/AvatarMixerClientData.h b/assignment-client/src/avatars/AvatarMixerClientData.h
index 1449005246..76519466b5 100644
--- a/assignment-client/src/avatars/AvatarMixerClientData.h
+++ b/assignment-client/src/avatars/AvatarMixerClientData.h
@@ -145,7 +145,7 @@ private:
     std::unordered_map<QUuid, QVector<JointData>> _lastOtherAvatarSentJoints;
 
     uint64_t _identityChangeTimestamp;
-    bool _avatarSessionDisplayNameMustChange{ false };
+    bool _avatarSessionDisplayNameMustChange{ true };
 
     int _numAvatarsSentLastFrame = 0;
     int _numFramesSinceAdjustment = 0;

From d4752926b8f35d6ff093d9702e6bda8082fba812 Mon Sep 17 00:00:00 2001
From: Zach Fox <fox@highfidelity.io>
Date: Wed, 17 May 2017 13:11:37 -0700
Subject: [PATCH 127/135] First pass - checking performance

---
 interface/src/Application.cpp        | 3 +--
 libraries/avatars/src/AvatarData.cpp | 2 --
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/interface/src/Application.cpp b/interface/src/Application.cpp
index 3a09a2181c..1d31a84ed4 100644
--- a/interface/src/Application.cpp
+++ b/interface/src/Application.cpp
@@ -5258,9 +5258,8 @@ void Application::nodeActivated(SharedNodePointer node) {
     }
 
     if (node->getType() == NodeType::AvatarMixer) {
-        // new avatar mixer, send off our identity packet right away
+        // new avatar mixer, send off our identity packet on next update loop
         getMyAvatar()->markIdentityDataChanged();
-        getMyAvatar()->sendIdentityPacket();
         getMyAvatar()->resetLastSent();
     }
 }
diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index eebb9c2633..7ea48db745 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -1588,8 +1588,6 @@ void AvatarData::setDisplayName(const QString& displayName) {
     _displayName = displayName;
     _sessionDisplayName = "";
 
-    sendIdentityPacket();
-
     qCDebug(avatars) << "Changing display name for avatar to" << displayName;
     markIdentityDataChanged();
 }

From 689a0b5badb2479b382aee3d783e68939fb99b6f Mon Sep 17 00:00:00 2001
From: David Kelly <david@highfidelity.io>
Date: Wed, 17 May 2017 14:22:36 -0700
Subject: [PATCH 128/135] Switch from timestamp to sequence id for avatar
 identity

---
 libraries/avatars/src/AvatarData.cpp         | 45 ++++++++------------
 libraries/avatars/src/AvatarData.h           | 36 ++++++++--------
 libraries/networking/src/udt/PacketHeaders.h |  3 +-
 3 files changed, 38 insertions(+), 46 deletions(-)

diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index eebb9c2633..d69af74c97 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -170,13 +170,13 @@ QByteArray AvatarData::toByteArrayStateful(AvatarDataDetail dataDetail) {
     AvatarDataPacket::HasFlags hasFlagsOut;
     auto lastSentTime = _lastToByteArray;
     _lastToByteArray = usecTimestampNow();
-    return AvatarData::toByteArray(dataDetail, lastSentTime, getLastSentJointData(), 
+    return AvatarData::toByteArray(dataDetail, lastSentTime, getLastSentJointData(),
                         hasFlagsOut, false, false, glm::vec3(0), nullptr,
                         &_outboundDataRate);
 }
 
 QByteArray AvatarData::toByteArray(AvatarDataDetail dataDetail, quint64 lastSentTime, const QVector<JointData>& lastSentJointData,
-    AvatarDataPacket::HasFlags& hasFlagsOut, bool dropFaceTracking, bool distanceAdjust, 
+    AvatarDataPacket::HasFlags& hasFlagsOut, bool dropFaceTracking, bool distanceAdjust,
     glm::vec3 viewerPosition, QVector<JointData>* sentJointDataOut, AvatarDataRate* outboundDataRateOut) const {
 
     bool cullSmallChanges = (dataDetail == CullSmallData);
@@ -199,7 +199,7 @@ QByteArray AvatarData::toByteArray(AvatarDataDetail dataDetail, quint64 lastSent
 
     // FIXME -
     //
-    //    BUG -- if you enter a space bubble, and then back away, the avatar has wrong orientation until "send all" happens... 
+    //    BUG -- if you enter a space bubble, and then back away, the avatar has wrong orientation until "send all" happens...
     //      this is an iFrame issue... what to do about that?
     //
     //    BUG -- Resizing avatar seems to "take too long"... the avatar doesn't redraw at smaller size right away
@@ -1471,13 +1471,13 @@ QStringList AvatarData::getJointNames() const {
 void AvatarData::parseAvatarIdentityPacket(const QByteArray& data, Identity& identityOut) {
     QDataStream packetStream(data);
 
-    packetStream >> identityOut.uuid 
-                 >> identityOut.skeletonModelURL 
+    packetStream >> identityOut.uuid
+                 >> identityOut.skeletonModelURL
                  >> identityOut.attachmentData
                  >> identityOut.displayName
                  >> identityOut.sessionDisplayName
                  >> identityOut.avatarEntityData
-                 >> identityOut.updatedAt;
+                 >> identityOut.sequenceId;
 
 #ifdef WANT_DEBUG
     qCDebug(avatars) << __FUNCTION__
@@ -1500,20 +1500,14 @@ QUrl AvatarData::cannonicalSkeletonModelURL(const QUrl& emptyURL) const {
 }
 
 void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityChanged, bool& displayNameChanged, const qint64 clockSkew) {
-    quint64 identityPacketUpdatedAt = identity.updatedAt;
 
-    if (identityPacketUpdatedAt <= (uint64_t)(abs(clockSkew))) { // Incoming timestamp is bad - compute our own timestamp
-        identityPacketUpdatedAt = usecTimestampNow() + clockSkew;
-    }
-
-    // Consider the case where this packet is being processed on Client A, and Client A is connected to Sandbox B.
-    // If Client A's system clock is *ahead of* Sandbox B's system clock, "clockSkew" will be *negative*.
-    // If Client A's system clock is *behind* Sandbox B's system clock, "clockSkew" will be *positive*.
-    if ((_identityUpdatedAt > identityPacketUpdatedAt - clockSkew) && (_identityUpdatedAt != 0)) {
-        qCDebug(avatars) << "Ignoring late identity packet for avatar " << getSessionUUID() 
-            << "_identityUpdatedAt (" << _identityUpdatedAt << ") is greater than identityPacketUpdatedAt - clockSkew (" << identityPacketUpdatedAt << "-" << clockSkew << ")";
+    if (identity.sequenceId < _identitySequenceId) {
+        qCDebug(avatars) << "Ignoring older identity packet for avatar" << getSessionUUID()
+            << "_identitySequenceId (" << _identitySequenceId << ") is greater than" << identity.sequenceId;
         return;
     }
+    // otherwise, set the identitySequenceId to match the incoming identity
+    _identitySequenceId = identity.sequenceId;
 
     if (_firstSkeletonCheck || (identity.skeletonModelURL != cannonicalSkeletonModelURL(emptyURL))) {
         setSkeletonModelURL(identity.skeletonModelURL);
@@ -1545,9 +1539,6 @@ void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityC
         identityChanged = true;
     }
 
-    // use the timestamp from this identity, since we want to honor the updated times in "server clock"
-    // this will overwrite any changes we made locally to this AvatarData's _identityUpdatedAt
-    _identityUpdatedAt = identityPacketUpdatedAt - clockSkew;
 }
 
 QByteArray AvatarData::identityByteArray() const {
@@ -1556,13 +1547,13 @@ QByteArray AvatarData::identityByteArray() const {
     const QUrl& urlToSend = cannonicalSkeletonModelURL(emptyURL); // depends on _skeletonModelURL
 
     _avatarEntitiesLock.withReadLock([&] {
-        identityStream << getSessionUUID() 
-                       << urlToSend 
+        identityStream << getSessionUUID()
+                       << urlToSend
                        << _attachmentData
                        << _displayName
                        << getSessionDisplayNameForTransport() // depends on _sessionDisplayName
                        << _avatarEntityData
-                       << _identityUpdatedAt;
+                       << _identitySequenceId;
     });
 
     return identityData;
@@ -2477,11 +2468,11 @@ QScriptValue AvatarEntityMapToScriptValue(QScriptEngine* engine, const AvatarEnt
         if (!jsonEntityProperties.isObject()) {
             qCDebug(avatars) << "bad AvatarEntityData in AvatarEntityMap" << QString(entityProperties.toHex());
         }
-        
+
         QVariant variantEntityProperties = jsonEntityProperties.toVariant();
         QVariantMap entityPropertiesMap = variantEntityProperties.toMap();
         QScriptValue scriptEntityProperties = variantMapToScriptValue(entityPropertiesMap, *engine);
-        
+
         QString key = entityID.toString();
         obj.setProperty(key, scriptEntityProperties);
     }
@@ -2493,12 +2484,12 @@ void AvatarEntityMapFromScriptValue(const QScriptValue& object, AvatarEntityMap&
     while (itr.hasNext()) {
         itr.next();
         QUuid EntityID = QUuid(itr.name());
-        
+
         QScriptValue scriptEntityProperties = itr.value();
         QVariant variantEntityProperties = scriptEntityProperties.toVariant();
         QJsonDocument jsonEntityProperties = QJsonDocument::fromVariant(variantEntityProperties);
         QByteArray binaryEntityProperties = jsonEntityProperties.toBinaryData();
-        
+
         value[EntityID] = binaryEntityProperties;
     }
 }
diff --git a/libraries/avatars/src/AvatarData.h b/libraries/avatars/src/AvatarData.h
index f248874943..b4836e3a2e 100644
--- a/libraries/avatars/src/AvatarData.h
+++ b/libraries/avatars/src/AvatarData.h
@@ -165,15 +165,15 @@ namespace AvatarDataPacket {
     const size_t AVATAR_ORIENTATION_SIZE = 6;
 
     PACKED_BEGIN struct AvatarScale {
-        SmallFloat scale;                 // avatar's scale, compressed by packFloatRatioToTwoByte() 
+        SmallFloat scale;                 // avatar's scale, compressed by packFloatRatioToTwoByte()
     } PACKED_END;
     const size_t AVATAR_SCALE_SIZE = 2;
 
     PACKED_BEGIN struct LookAtPosition {
         float lookAtPosition[3];          // world space position that eyes are focusing on.
-                                          // FIXME - unless the person has an eye tracker, this is simulated... 
+                                          // FIXME - unless the person has an eye tracker, this is simulated...
                                           //    a) maybe we can just have the client calculate this
-                                          //    b) at distance this will be hard to discern and can likely be 
+                                          //    b) at distance this will be hard to discern and can likely be
                                           //       descimated or dropped completely
                                           //
                                           // POTENTIAL SAVINGS - 12 bytes
@@ -376,10 +376,10 @@ public:
     glm::vec3 getHandPosition() const;
     void setHandPosition(const glm::vec3& handPosition);
 
-    typedef enum { 
+    typedef enum {
         NoData,
         PALMinimum,
-        MinimumData, 
+        MinimumData,
         CullSmallData,
         IncludeSmallData,
         SendAllData
@@ -388,7 +388,7 @@ public:
     virtual QByteArray toByteArrayStateful(AvatarDataDetail dataDetail);
 
     virtual QByteArray toByteArray(AvatarDataDetail dataDetail, quint64 lastSentTime, const QVector<JointData>& lastSentJointData,
-        AvatarDataPacket::HasFlags& hasFlagsOut, bool dropFaceTracking, bool distanceAdjust, glm::vec3 viewerPosition, 
+        AvatarDataPacket::HasFlags& hasFlagsOut, bool dropFaceTracking, bool distanceAdjust, glm::vec3 viewerPosition,
         QVector<JointData>* sentJointDataOut, AvatarDataRate* outboundDataRateOut = nullptr) const;
 
     virtual void doneEncoding(bool cullSmallChanges);
@@ -417,23 +417,23 @@ public:
     void nextAttitude(glm::vec3 position, glm::quat orientation); // Can be safely called at any time.
     virtual void updateAttitude() {} // Tell skeleton mesh about changes
 
-    glm::quat getHeadOrientation() const { 
+    glm::quat getHeadOrientation() const {
         lazyInitHeadData();
-        return _headData->getOrientation(); 
+        return _headData->getOrientation();
     }
-    void setHeadOrientation(const glm::quat& orientation) { 
+    void setHeadOrientation(const glm::quat& orientation) {
         if (_headData) {
             _headData->setOrientation(orientation);
         }
     }
 
-    void setLookAtPosition(const glm::vec3& lookAtPosition) { 
+    void setLookAtPosition(const glm::vec3& lookAtPosition) {
         if (_headData) {
-            _headData->setLookAtPosition(lookAtPosition); 
+            _headData->setLookAtPosition(lookAtPosition);
         }
     }
 
-    void setBlendshapeCoefficients(const QVector<float>& blendshapeCoefficients) { 
+    void setBlendshapeCoefficients(const QVector<float>& blendshapeCoefficients) {
         if (_headData) {
             _headData->setBlendshapeCoefficients(blendshapeCoefficients);
         }
@@ -470,7 +470,7 @@ public:
 
     void setDomainMinimumScale(float domainMinimumScale)
         { _domainMinimumScale = glm::clamp(domainMinimumScale, MIN_AVATAR_SCALE, MAX_AVATAR_SCALE); _scaleChanged = usecTimestampNow(); }
-    void setDomainMaximumScale(float domainMaximumScale) 
+    void setDomainMaximumScale(float domainMaximumScale)
         { _domainMaximumScale = glm::clamp(domainMaximumScale, MIN_AVATAR_SCALE, MAX_AVATAR_SCALE); _scaleChanged = usecTimestampNow(); }
 
     //  Hand State
@@ -531,7 +531,7 @@ public:
         QString displayName;
         QString sessionDisplayName;
         AvatarEntityMap avatarEntityData;
-        quint64 updatedAt;
+        quint64 sequenceId;
     };
 
     static void parseAvatarIdentityPacket(const QByteArray& data, Identity& identityOut);
@@ -548,8 +548,8 @@ public:
     virtual void setSkeletonModelURL(const QUrl& skeletonModelURL);
 
     virtual void setDisplayName(const QString& displayName);
-    virtual void setSessionDisplayName(const QString& sessionDisplayName) { 
-        _sessionDisplayName = sessionDisplayName; 
+    virtual void setSessionDisplayName(const QString& sessionDisplayName) {
+        _sessionDisplayName = sessionDisplayName;
         markIdentityDataChanged();
     }
 
@@ -626,7 +626,7 @@ public:
     bool getIdentityDataChanged() const { return _identityDataChanged; } // has the identity data changed since the last time sendIdentityPacket() was called
     void markIdentityDataChanged() {
         _identityDataChanged = true;
-        _identityUpdatedAt = usecTimestampNow();
+        _identitySequenceId++;
     }
 
 signals:
@@ -784,7 +784,7 @@ protected:
     float _audioAverageLoudness { 0.0f };
 
     bool _identityDataChanged { false };
-    quint64 _identityUpdatedAt { 0 };
+    quint64 _identitySequenceId { 0 };
 
 private:
     friend void avatarStateFromFrame(const QByteArray& frameData, AvatarData* _avatar);
diff --git a/libraries/networking/src/udt/PacketHeaders.h b/libraries/networking/src/udt/PacketHeaders.h
index 746ae80361..f88015a4e4 100644
--- a/libraries/networking/src/udt/PacketHeaders.h
+++ b/libraries/networking/src/udt/PacketHeaders.h
@@ -234,7 +234,8 @@ enum class AvatarMixerPacketVersion : PacketVersion {
     VariableAvatarData,
     AvatarAsChildFixes,
     StickAndBallDefaultAvatar,
-    IdentityPacketsIncludeUpdateTime
+    IdentityPacketsIncludeUpdateTime,
+    AvatarIdentitySequenceId
 };
 
 enum class DomainConnectRequestVersion : PacketVersion {

From 057718bde3c6d8aff13cfff755d54c6ded3106c5 Mon Sep 17 00:00:00 2001
From: David Kelly <david@highfidelity.io>
Date: Wed, 17 May 2017 15:14:56 -0700
Subject: [PATCH 129/135] remove clockSkew, reference new version for Avatar
 packets

---
 assignment-client/src/avatars/AvatarMixer.cpp  | 10 +++++-----
 libraries/avatars/src/AvatarData.cpp           |  2 +-
 libraries/avatars/src/AvatarData.h             |  2 +-
 libraries/avatars/src/AvatarHashMap.cpp        |  2 +-
 libraries/networking/src/udt/PacketHeaders.cpp |  2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/assignment-client/src/avatars/AvatarMixer.cpp b/assignment-client/src/avatars/AvatarMixer.cpp
index 998799f5e6..870149f1bc 100644
--- a/assignment-client/src/avatars/AvatarMixer.cpp
+++ b/assignment-client/src/avatars/AvatarMixer.cpp
@@ -402,7 +402,7 @@ void AvatarMixer::handleAvatarIdentityPacket(QSharedPointer<ReceivedMessage> mes
             AvatarData::parseAvatarIdentityPacket(message->getMessage(), identity);
             bool identityChanged = false;
             bool displayNameChanged = false;
-            avatar.processAvatarIdentity(identity, identityChanged, displayNameChanged, senderNode->getClockSkewUsec());
+            avatar.processAvatarIdentity(identity, identityChanged, displayNameChanged);
             if (identityChanged) {
                 QMutexLocker nodeDataLocker(&nodeData->getMutex());
                 nodeData->flagIdentityChange();
@@ -665,12 +665,12 @@ void AvatarMixer::sendStatsPacket() {
 
 void AvatarMixer::run() {
     qCDebug(avatars) << "Waiting for connection to domain to request settings from domain-server.";
-    
+
     // wait until we have the domain-server settings, otherwise we bail
     DomainHandler& domainHandler = DependencyManager::get<NodeList>()->getDomainHandler();
     connect(&domainHandler, &DomainHandler::settingsReceived, this, &AvatarMixer::domainSettingsRequestComplete);
     connect(&domainHandler, &DomainHandler::settingsReceiveFail, this, &AvatarMixer::domainSettingsRequestFailed);
-   
+
     ThreadedAssignment::commonInit(AVATAR_MIXER_LOGGING_NAME, NodeType::AvatarMixer);
 
 }
@@ -695,7 +695,7 @@ void AvatarMixer::domainSettingsRequestComplete() {
 
     // parse the settings to pull out the values we need
     parseDomainServerSettings(nodeList->getDomainHandler().getSettingsObject());
-    
+
     // start our tight loop...
     start();
 }
@@ -745,7 +745,7 @@ void AvatarMixer::parseDomainServerSettings(const QJsonObject& domainSettings) {
     } else {
         qCDebug(avatars) << "Avatar mixer will automatically determine number of threads to use. Using:" << _slavePool.numThreads() << "threads.";
     }
-    
+
     const QString AVATARS_SETTINGS_KEY = "avatars";
 
     static const QString MIN_SCALE_OPTION = "min_avatar_scale";
diff --git a/libraries/avatars/src/AvatarData.cpp b/libraries/avatars/src/AvatarData.cpp
index d69af74c97..57ef80000a 100644
--- a/libraries/avatars/src/AvatarData.cpp
+++ b/libraries/avatars/src/AvatarData.cpp
@@ -1499,7 +1499,7 @@ QUrl AvatarData::cannonicalSkeletonModelURL(const QUrl& emptyURL) const {
     return _skeletonModelURL.scheme() == "file" ? emptyURL : _skeletonModelURL;
 }
 
-void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityChanged, bool& displayNameChanged, const qint64 clockSkew) {
+void AvatarData::processAvatarIdentity(const Identity& identity, bool& identityChanged, bool& displayNameChanged) {
 
     if (identity.sequenceId < _identitySequenceId) {
         qCDebug(avatars) << "Ignoring older identity packet for avatar" << getSessionUUID()
diff --git a/libraries/avatars/src/AvatarData.h b/libraries/avatars/src/AvatarData.h
index b4836e3a2e..99a437b885 100644
--- a/libraries/avatars/src/AvatarData.h
+++ b/libraries/avatars/src/AvatarData.h
@@ -538,7 +538,7 @@ public:
 
     // identityChanged returns true if identity has changed, false otherwise.
     // displayNameChanged returns true if displayName has changed, false otherwise.
-    void processAvatarIdentity(const Identity& identity, bool& identityChanged, bool& displayNameChanged, const qint64 clockSkew);
+    void processAvatarIdentity(const Identity& identity, bool& identityChanged, bool& displayNameChanged);
 
     QByteArray identityByteArray() const;
 
diff --git a/libraries/avatars/src/AvatarHashMap.cpp b/libraries/avatars/src/AvatarHashMap.cpp
index 155ef9a0a2..2ccc64fee2 100644
--- a/libraries/avatars/src/AvatarHashMap.cpp
+++ b/libraries/avatars/src/AvatarHashMap.cpp
@@ -149,7 +149,7 @@ void AvatarHashMap::processAvatarIdentityPacket(QSharedPointer<ReceivedMessage>
         bool identityChanged = false;
         bool displayNameChanged = false;
         // In this case, the "sendingNode" is the Avatar Mixer.
-        avatar->processAvatarIdentity(identity, identityChanged, displayNameChanged, sendingNode->getClockSkewUsec());
+        avatar->processAvatarIdentity(identity, identityChanged, displayNameChanged);
     }
 }
 
diff --git a/libraries/networking/src/udt/PacketHeaders.cpp b/libraries/networking/src/udt/PacketHeaders.cpp
index 82b4bf703d..9d970fa318 100644
--- a/libraries/networking/src/udt/PacketHeaders.cpp
+++ b/libraries/networking/src/udt/PacketHeaders.cpp
@@ -56,7 +56,7 @@ PacketVersion versionForPacketType(PacketType packetType) {
         case PacketType::AvatarData:
         case PacketType::BulkAvatarData:
         case PacketType::KillAvatar:
-            return static_cast<PacketVersion>(AvatarMixerPacketVersion::IdentityPacketsIncludeUpdateTime);
+            return static_cast<PacketVersion>(AvatarMixerPacketVersion::AvatarIdentitySequenceId);
         case PacketType::MessagesData:
             return static_cast<PacketVersion>(MessageDataVersion::TextOrBinaryData);
         case PacketType::ICEServerHeartbeat:

From 78dd30f65636d42cb1766d2af299b1092e3adc28 Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Wed, 17 May 2017 15:22:39 -0700
Subject: [PATCH 130/135] macosx warning fix

---
 libraries/animation/src/IKTarget.cpp | 2 +-
 libraries/animation/src/IKTarget.h   | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/libraries/animation/src/IKTarget.cpp b/libraries/animation/src/IKTarget.cpp
index 18e656f583..c67c0621c3 100644
--- a/libraries/animation/src/IKTarget.cpp
+++ b/libraries/animation/src/IKTarget.cpp
@@ -15,7 +15,7 @@ void IKTarget::setPose(const glm::quat& rotation, const glm::vec3& translation)
 }
 
 void IKTarget::setFlexCoefficients(size_t numFlexCoefficientsIn, const float* flexCoefficientsIn) {
-    _numFlexCoefficients = std::min(numFlexCoefficientsIn, MAX_FLEX_COEFFICIENTS);
+    _numFlexCoefficients = std::min(numFlexCoefficientsIn, (size_t)MAX_FLEX_COEFFICIENTS);
     for (size_t i = 0; i < _numFlexCoefficients; i++) {
         _flexCoefficients[i] = flexCoefficientsIn[i];
     }
diff --git a/libraries/animation/src/IKTarget.h b/libraries/animation/src/IKTarget.h
index 1951d3ba7b..4f464c103c 100644
--- a/libraries/animation/src/IKTarget.h
+++ b/libraries/animation/src/IKTarget.h
@@ -41,7 +41,8 @@ public:
     void setWeight(float weight) { _weight = weight; }
     float getWeight() const { return _weight; }
 
-    static const size_t MAX_FLEX_COEFFICIENTS = 10;
+    enum FlexCoefficients { MAX_FLEX_COEFFICIENTS = 10 };
+
 private:
     AnimPose _pose;
     int _index{-1};

From 2ac5fbf91dda6e86de6b051835f0e0919fae503f Mon Sep 17 00:00:00 2001
From: Stephen Birarda <commit@birarda.com>
Date: Wed, 17 May 2017 15:26:29 -0700
Subject: [PATCH 131/135] set wireless scan interval to -1

---
 libraries/shared/src/SharedUtil.cpp | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/libraries/shared/src/SharedUtil.cpp b/libraries/shared/src/SharedUtil.cpp
index 81a0eed9f3..a68d27e620 100644
--- a/libraries/shared/src/SharedUtil.cpp
+++ b/libraries/shared/src/SharedUtil.cpp
@@ -768,9 +768,10 @@ bool similarStrings(const QString& stringA, const QString& stringB) {
 }
 
 void disableQtBearerPoll() {
-    // to work around the Qt constant wireless scanning, set the env for polling interval very high
-    const QByteArray EXTREME_BEARER_POLL_TIMEOUT = QString::number(INT16_MAX).toLocal8Bit();
-    qputenv("QT_BEARER_POLL_TIMEOUT", EXTREME_BEARER_POLL_TIMEOUT);
+    // to disable the Qt constant wireless scanning, set the env for polling interval
+    qDebug() << "Disabling Qt wireless polling by using a negative value for QTimer::setInterval";
+    const QByteArray DISABLE_BEARER_POLL_TIMEOUT = QString::number(-1).toLocal8Bit();
+    qputenv("QT_BEARER_POLL_TIMEOUT", DISABLE_BEARER_POLL_TIMEOUT);
 }
 
 void printSystemInformation() {

From 0018224fefb72e6c50041effe7b89e676fd2ef8b Mon Sep 17 00:00:00 2001
From: "Anthony J. Thibault" <tony@highfidelity.io>
Date: Wed, 17 May 2017 16:23:39 -0700
Subject: [PATCH 132/135] moar warning fixes

---
 libraries/animation/src/AnimInverseKinematics.cpp | 4 ++--
 libraries/animation/src/AnimInverseKinematics.h   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/libraries/animation/src/AnimInverseKinematics.cpp b/libraries/animation/src/AnimInverseKinematics.cpp
index c43d7b76dd..4471f11857 100644
--- a/libraries/animation/src/AnimInverseKinematics.cpp
+++ b/libraries/animation/src/AnimInverseKinematics.cpp
@@ -32,7 +32,7 @@ AnimInverseKinematics::IKTargetVar::IKTargetVar(const QString& jointNameIn, cons
     numFlexCoefficients(flexCoefficientsIn.size()),
     jointIndex(-1)
 {
-    numFlexCoefficients = std::min(numFlexCoefficients, MAX_FLEX_COEFFICIENTS);
+    numFlexCoefficients = std::min(numFlexCoefficients, (size_t)MAX_FLEX_COEFFICIENTS);
     for (size_t i = 0; i < numFlexCoefficients; i++) {
         flexCoefficients[i] = flexCoefficientsIn[i];
     }
@@ -48,7 +48,7 @@ AnimInverseKinematics::IKTargetVar::IKTargetVar(const IKTargetVar& orig) :
     numFlexCoefficients(orig.numFlexCoefficients),
     jointIndex(orig.jointIndex)
 {
-    numFlexCoefficients = std::min(numFlexCoefficients, MAX_FLEX_COEFFICIENTS);
+    numFlexCoefficients = std::min(numFlexCoefficients, (size_t)MAX_FLEX_COEFFICIENTS);
     for (size_t i = 0; i < numFlexCoefficients; i++) {
         flexCoefficients[i] = orig.flexCoefficients[i];
     }
diff --git a/libraries/animation/src/AnimInverseKinematics.h b/libraries/animation/src/AnimInverseKinematics.h
index cf03005b68..74face6d0b 100644
--- a/libraries/animation/src/AnimInverseKinematics.h
+++ b/libraries/animation/src/AnimInverseKinematics.h
@@ -78,7 +78,7 @@ protected:
     AnimInverseKinematics(const AnimInverseKinematics&) = delete;
     AnimInverseKinematics& operator=(const AnimInverseKinematics&) = delete;
 
-    static const size_t MAX_FLEX_COEFFICIENTS = 10;
+    enum FlexCoefficients { MAX_FLEX_COEFFICIENTS = 10 };
     struct IKTargetVar {
         IKTargetVar(const QString& jointNameIn, const QString& positionVarIn, const QString& rotationVarIn,
                     const QString& typeVarIn, const QString& weightVarIn, float weightIn, const std::vector<float>& flexCoefficientsIn);

From e8ab78089962c9150d0653cfad548f0d3ff0e995 Mon Sep 17 00:00:00 2001
From: Zach Pomerantz <zmp@umich.edu>
Date: Wed, 17 May 2017 21:32:13 -0400
Subject: [PATCH 133/135] include details in critical variantMap parsing error

---
 libraries/shared/src/SettingHelpers.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libraries/shared/src/SettingHelpers.cpp b/libraries/shared/src/SettingHelpers.cpp
index cbda4e4096..4690416446 100644
--- a/libraries/shared/src/SettingHelpers.cpp
+++ b/libraries/shared/src/SettingHelpers.cpp
@@ -138,7 +138,7 @@ QJsonDocument variantMapToJsonDocument(const QSettings::SettingsMap& map) {
 
             case QVariant::List:
             case QVariant::Hash: {
-                qCritical() << "Unsupported variant type" << variant.typeName();
+                qCritical() << "Unsupported variant type" << variant.typeName() << ";" << key << variant;
                 Q_ASSERT(false);
                 break;
             }

From b05cb4af3b05ffc0fae69808810c438b98265a36 Mon Sep 17 00:00:00 2001
From: Seth Alves <seth.alves@gmail.com>
Date: Wed, 17 May 2017 20:51:34 -0700
Subject: [PATCH 134/135] fix nan

---
 libraries/entities/src/EntityItem.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/libraries/entities/src/EntityItem.cpp b/libraries/entities/src/EntityItem.cpp
index 3e858f48be..14122594fe 100644
--- a/libraries/entities/src/EntityItem.cpp
+++ b/libraries/entities/src/EntityItem.cpp
@@ -1692,7 +1692,7 @@ void EntityItem::updateVelocity(const glm::vec3& value) {
             }
         } else {
             float speed = glm::length(value);
-            if (!isnan(speed)) {
+            if (!glm::isnan(speed)) {
                 const float MIN_LINEAR_SPEED = 0.001f;
                 const float MAX_LINEAR_SPEED = 270.0f; // 3m per step at 90Hz
                 if (speed < MIN_LINEAR_SPEED) {
@@ -1730,7 +1730,7 @@ void EntityItem::updateGravity(const glm::vec3& value) {
             _gravity = Vectors::ZERO;
         } else {
             float magnitude = glm::length(value);
-            if (!isnan(magnitude)) {
+            if (!glm::isnan(magnitude)) {
                 const float MAX_ACCELERATION_OF_GRAVITY = 10.0f * 9.8f; // 10g
                 if (magnitude > MAX_ACCELERATION_OF_GRAVITY) {
                     _gravity = (MAX_ACCELERATION_OF_GRAVITY / magnitude) * value;
@@ -1750,7 +1750,7 @@ void EntityItem::updateAngularVelocity(const glm::vec3& value) {
             setLocalAngularVelocity(Vectors::ZERO);
         } else {
             float speed = glm::length(value);
-            if (!isnan(speed)) {
+            if (!glm::isnan(speed)) {
                 const float MIN_ANGULAR_SPEED = 0.0002f;
                 const float MAX_ANGULAR_SPEED = 9.0f * TWO_PI; // 1/10 rotation per step at 90Hz
                 if (speed < MIN_ANGULAR_SPEED) {

From 6d2d838510e1ee6f10d4126ddac7a951ec379def Mon Sep 17 00:00:00 2001
From: Ryan Huffman <ryanhuffman@gmail.com>
Date: Thu, 18 May 2017 11:46:14 -0700
Subject: [PATCH 135/135] Fix ktx image size in progrssively loaded cubemaps

The size being written was the full image size (size of all faces), when
it should have been the face size.
---
 libraries/ktx/src/ktx/Writer.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libraries/ktx/src/ktx/Writer.cpp b/libraries/ktx/src/ktx/Writer.cpp
index 2dcd0ea583..23f9d05596 100644
--- a/libraries/ktx/src/ktx/Writer.cpp
+++ b/libraries/ktx/src/ktx/Writer.cpp
@@ -149,7 +149,8 @@ namespace ktx {
 
         for (size_t i = 0; i < descriptors.size(); ++i) {
             auto ptr = reinterpret_cast<uint32_t*>(currentDestPtr);
-            *ptr = descriptors[i]._imageSize;
+            uint32_t imageFaceSize = descriptors[i]._faceSize;
+            *ptr = imageFaceSize; // the imageSize written in the ktx is the FACE size
 
 #ifdef DEBUG
             ptr++;