/* * Copyright 2015 Google Inc. * * Use of this source code is governed by a BSD-style license that can be * found in the LICENSE file. */ #ifndef SkPoint3_DEFINED #define SkPoint3_DEFINED #include "SkPoint.h" struct SK_API SkPoint3 { SkScalar fX, fY, fZ; static SkPoint3 Make(SkScalar x, SkScalar y, SkScalar z) { SkPoint3 pt; pt.set(x, y, z); return pt; } SkScalar x() const { return fX; } SkScalar y() const { return fY; } SkScalar z() const { return fZ; } void set(SkScalar x, SkScalar y, SkScalar z) { fX = x; fY = y; fZ = z; } friend bool operator==(const SkPoint3& a, const SkPoint3& b) { return a.fX == b.fX && a.fY == b.fY && a.fZ == b.fZ; } friend bool operator!=(const SkPoint3& a, const SkPoint3& b) { return !(a == b); } /** Returns the Euclidian distance from (0,0,0) to (x,y,z) */ static SkScalar Length(SkScalar x, SkScalar y, SkScalar z); /** Return the Euclidian distance from (0,0,0) to the point */ SkScalar length() const { return SkPoint3::Length(fX, fY, fZ); } /** Set the point (vector) to be unit-length in the same direction as it already points. If the point has a degenerate length (i.e., nearly 0) then set it to (0,0,0) and return false; otherwise return true. */ bool normalize(); /** Return a new point whose X, Y and Z coordinates are scaled. */ SkPoint3 makeScale(SkScalar scale) const { SkPoint3 p; p.set(scale * fX, scale * fY, scale * fZ); return p; } /** Scale the point's coordinates by scale. */ void scale(SkScalar value) { fX *= value; fY *= value; fZ *= value; } /** Return a new point whose X, Y and Z coordinates are the negative of the original point's */ SkPoint3 operator-() const { SkPoint3 neg; neg.fX = -fX; neg.fY = -fY; neg.fZ = -fZ; return neg; } /** Returns a new point whose coordinates are the difference between a and b (i.e., a - b) */ friend SkPoint3 operator-(const SkPoint3& a, const SkPoint3& b) { SkPoint3 v; v.set(a.fX - b.fX, a.fY - b.fY, a.fZ - b.fZ); return v; } /** Returns a new point whose coordinates are the sum of a and b (a + b) */ friend SkPoint3 operator+(const SkPoint3& a, const SkPoint3& b) { SkPoint3 v; v.set(a.fX + b.fX, a.fY + b.fY, a.fZ + b.fZ); return v; } /** Add v's coordinates to the point's */ void operator+=(const SkPoint3& v) { fX += v.fX; fY += v.fY; fZ += v.fZ; } /** Subtract v's coordinates from the point's */ void operator-=(const SkPoint3& v) { fX -= v.fX; fY -= v.fY; fZ -= v.fZ; } /** Returns true if fX, fY, and fZ are measurable values. @return true for values other than infinities and NaN */ bool isFinite() const { SkScalar accum = 0; accum *= fX; accum *= fY; accum *= fZ; // accum is either NaN or it is finite (zero). SkASSERT(0 == accum || SkScalarIsNaN(accum)); // value==value will be true iff value is not NaN // TODO: is it faster to say !accum or accum==accum? return !SkScalarIsNaN(accum); } /** Returns the dot product of a and b, treating them as 3D vectors */ static SkScalar DotProduct(const SkPoint3& a, const SkPoint3& b) { return a.fX * b.fX + a.fY * b.fY + a.fZ * b.fZ; } SkScalar dot(const SkPoint3& vec) const { return DotProduct(*this, vec); } }; typedef SkPoint3 SkVector3; typedef SkPoint3 SkColor3f; #endif