| OLD | NEW |
| (Empty) |
| 1 // Copyright 2012 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CC_BASE_MATH_UTIL_H_ | |
| 6 #define CC_BASE_MATH_UTIL_H_ | |
| 7 | |
| 8 #include <algorithm> | |
| 9 #include <cmath> | |
| 10 #include <vector> | |
| 11 | |
| 12 #include "base/logging.h" | |
| 13 #include "base/memory/scoped_ptr.h" | |
| 14 #include "ui/gfx/geometry/box_f.h" | |
| 15 #include "ui/gfx/geometry/point3_f.h" | |
| 16 #include "ui/gfx/geometry/point_f.h" | |
| 17 #include "ui/gfx/geometry/scroll_offset.h" | |
| 18 #include "ui/gfx/geometry/size.h" | |
| 19 #include "ui/gfx/transform.h" | |
| 20 | |
| 21 namespace base { | |
| 22 class Value; | |
| 23 namespace trace_event { | |
| 24 class TracedValue; | |
| 25 } | |
| 26 } // namespace base | |
| 27 | |
| 28 namespace gfx { | |
| 29 class QuadF; | |
| 30 class Rect; | |
| 31 class RectF; | |
| 32 class Transform; | |
| 33 class Vector2dF; | |
| 34 class Vector2d; | |
| 35 } | |
| 36 | |
| 37 namespace cc { | |
| 38 | |
| 39 struct HomogeneousCoordinate { | |
| 40 HomogeneousCoordinate(SkMScalar x, SkMScalar y, SkMScalar z, SkMScalar w) { | |
| 41 vec[0] = x; | |
| 42 vec[1] = y; | |
| 43 vec[2] = z; | |
| 44 vec[3] = w; | |
| 45 } | |
| 46 | |
| 47 bool ShouldBeClipped() const { return w() <= 0.0; } | |
| 48 | |
| 49 gfx::PointF CartesianPoint2d() const { | |
| 50 if (w() == SK_MScalar1) | |
| 51 return gfx::PointF(x(), y()); | |
| 52 | |
| 53 // For now, because this code is used privately only by MathUtil, it should | |
| 54 // never be called when w == 0, and we do not yet need to handle that case. | |
| 55 DCHECK(w()); | |
| 56 SkMScalar inv_w = SK_MScalar1 / w(); | |
| 57 return gfx::PointF(x() * inv_w, y() * inv_w); | |
| 58 } | |
| 59 | |
| 60 gfx::Point3F CartesianPoint3d() const { | |
| 61 if (w() == SK_MScalar1) | |
| 62 return gfx::Point3F(x(), y(), z()); | |
| 63 | |
| 64 // For now, because this code is used privately only by MathUtil, it should | |
| 65 // never be called when w == 0, and we do not yet need to handle that case. | |
| 66 DCHECK(w()); | |
| 67 SkMScalar inv_w = SK_MScalar1 / w(); | |
| 68 return gfx::Point3F(x() * inv_w, y() * inv_w, z() * inv_w); | |
| 69 } | |
| 70 | |
| 71 SkMScalar x() const { return vec[0]; } | |
| 72 SkMScalar y() const { return vec[1]; } | |
| 73 SkMScalar z() const { return vec[2]; } | |
| 74 SkMScalar w() const { return vec[3]; } | |
| 75 | |
| 76 SkMScalar vec[4]; | |
| 77 }; | |
| 78 | |
| 79 class MathUtil { | |
| 80 public: | |
| 81 static const double kPiDouble; | |
| 82 static const float kPiFloat; | |
| 83 | |
| 84 static double Deg2Rad(double deg) { return deg * kPiDouble / 180.0; } | |
| 85 static double Rad2Deg(double rad) { return rad * 180.0 / kPiDouble; } | |
| 86 | |
| 87 static float Deg2Rad(float deg) { return deg * kPiFloat / 180.0f; } | |
| 88 static float Rad2Deg(float rad) { return rad * 180.0f / kPiFloat; } | |
| 89 | |
| 90 static float Round(float f) { | |
| 91 return (f > 0.f) ? std::floor(f + 0.5f) : std::ceil(f - 0.5f); | |
| 92 } | |
| 93 static double Round(double d) { | |
| 94 return (d > 0.0) ? std::floor(d + 0.5) : std::ceil(d - 0.5); | |
| 95 } | |
| 96 | |
| 97 template <typename T> static T ClampToRange(T value, T min, T max) { | |
| 98 return std::min(std::max(value, min), max); | |
| 99 } | |
| 100 | |
| 101 // Background: Existing transform code does not do the right thing in | |
| 102 // MapRect / MapQuad / ProjectQuad when there is a perspective projection that | |
| 103 // causes one of the transformed vertices to go to w < 0. In those cases, it | |
| 104 // is necessary to perform clipping in homogeneous coordinates, after applying | |
| 105 // the transform, before dividing-by-w to convert to cartesian coordinates. | |
| 106 // | |
| 107 // These functions return the axis-aligned rect that encloses the correctly | |
| 108 // clipped, transformed polygon. | |
| 109 static gfx::Rect MapEnclosingClippedRect(const gfx::Transform& transform, | |
| 110 const gfx::Rect& rect); | |
| 111 static gfx::RectF MapClippedRect(const gfx::Transform& transform, | |
| 112 const gfx::RectF& rect); | |
| 113 static gfx::Rect ProjectEnclosingClippedRect(const gfx::Transform& transform, | |
| 114 const gfx::Rect& rect); | |
| 115 static gfx::RectF ProjectClippedRect(const gfx::Transform& transform, | |
| 116 const gfx::RectF& rect); | |
| 117 | |
| 118 // This function is only valid when the transform preserves 2d axis | |
| 119 // alignment and the resulting rect will not be clipped. | |
| 120 static gfx::Rect MapEnclosedRectWith2dAxisAlignedTransform( | |
| 121 const gfx::Transform& transform, | |
| 122 const gfx::Rect& rect); | |
| 123 | |
| 124 // Returns an array of vertices that represent the clipped polygon. After | |
| 125 // returning, indexes from 0 to num_vertices_in_clipped_quad are valid in the | |
| 126 // clipped_quad array. Note that num_vertices_in_clipped_quad may be zero, | |
| 127 // which means the entire quad was clipped, and none of the vertices in the | |
| 128 // array are valid. | |
| 129 static void MapClippedQuad(const gfx::Transform& transform, | |
| 130 const gfx::QuadF& src_quad, | |
| 131 gfx::PointF clipped_quad[8], | |
| 132 int* num_vertices_in_clipped_quad); | |
| 133 static bool MapClippedQuad3d(const gfx::Transform& transform, | |
| 134 const gfx::QuadF& src_quad, | |
| 135 gfx::Point3F clipped_quad[8], | |
| 136 int* num_vertices_in_clipped_quad); | |
| 137 | |
| 138 static gfx::RectF ComputeEnclosingRectOfVertices(const gfx::PointF vertices[], | |
| 139 int num_vertices); | |
| 140 static gfx::RectF ComputeEnclosingClippedRect( | |
| 141 const HomogeneousCoordinate& h1, | |
| 142 const HomogeneousCoordinate& h2, | |
| 143 const HomogeneousCoordinate& h3, | |
| 144 const HomogeneousCoordinate& h4); | |
| 145 | |
| 146 // NOTE: These functions do not do correct clipping against w = 0 plane, but | |
| 147 // they correctly detect the clipped condition via the boolean clipped. | |
| 148 static gfx::QuadF MapQuad(const gfx::Transform& transform, | |
| 149 const gfx::QuadF& quad, | |
| 150 bool* clipped); | |
| 151 static gfx::QuadF MapQuad3d(const gfx::Transform& transform, | |
| 152 const gfx::QuadF& q, | |
| 153 gfx::Point3F* p, | |
| 154 bool* clipped); | |
| 155 static gfx::PointF MapPoint(const gfx::Transform& transform, | |
| 156 const gfx::PointF& point, | |
| 157 bool* clipped); | |
| 158 static gfx::Point3F MapPoint(const gfx::Transform&, | |
| 159 const gfx::Point3F&, | |
| 160 bool* clipped); | |
| 161 static gfx::QuadF ProjectQuad(const gfx::Transform& transform, | |
| 162 const gfx::QuadF& quad, | |
| 163 bool* clipped); | |
| 164 static gfx::PointF ProjectPoint(const gfx::Transform& transform, | |
| 165 const gfx::PointF& point, | |
| 166 bool* clipped); | |
| 167 // Identical to the above function, but coerces the homogeneous coordinate to | |
| 168 // a 3d rather than a 2d point. | |
| 169 static gfx::Point3F ProjectPoint3D(const gfx::Transform& transform, | |
| 170 const gfx::PointF& point, | |
| 171 bool* clipped); | |
| 172 | |
| 173 static gfx::Vector2dF ComputeTransform2dScaleComponents(const gfx::Transform&, | |
| 174 float fallbackValue); | |
| 175 | |
| 176 // Makes a rect that has the same relationship to input_outer_rect as | |
| 177 // scale_inner_rect has to scale_outer_rect. scale_inner_rect should be | |
| 178 // contained within scale_outer_rect, and likewise the rectangle that is | |
| 179 // returned will be within input_outer_rect at a similar relative, scaled | |
| 180 // position. | |
| 181 static gfx::RectF ScaleRectProportional(const gfx::RectF& input_outer_rect, | |
| 182 const gfx::RectF& scale_outer_rect, | |
| 183 const gfx::RectF& scale_inner_rect); | |
| 184 | |
| 185 // Returns the smallest angle between the given two vectors in degrees. | |
| 186 // Neither vector is assumed to be normalized. | |
| 187 static float SmallestAngleBetweenVectors(const gfx::Vector2dF& v1, | |
| 188 const gfx::Vector2dF& v2); | |
| 189 | |
| 190 // Projects the |source| vector onto |destination|. Neither vector is assumed | |
| 191 // to be normalized. | |
| 192 static gfx::Vector2dF ProjectVector(const gfx::Vector2dF& source, | |
| 193 const gfx::Vector2dF& destination); | |
| 194 | |
| 195 // Conversion to value. | |
| 196 static scoped_ptr<base::Value> AsValue(const gfx::Size& s); | |
| 197 static scoped_ptr<base::Value> AsValue(const gfx::Rect& r); | |
| 198 static bool FromValue(const base::Value*, gfx::Rect* out_rect); | |
| 199 static scoped_ptr<base::Value> AsValue(const gfx::PointF& q); | |
| 200 | |
| 201 static void AddToTracedValue(const char* name, | |
| 202 const gfx::Size& s, | |
| 203 base::trace_event::TracedValue* res); | |
| 204 static void AddToTracedValue(const char* name, | |
| 205 const gfx::SizeF& s, | |
| 206 base::trace_event::TracedValue* res); | |
| 207 static void AddToTracedValue(const char* name, | |
| 208 const gfx::Rect& r, | |
| 209 base::trace_event::TracedValue* res); | |
| 210 static void AddToTracedValue(const char* name, | |
| 211 const gfx::PointF& q, | |
| 212 base::trace_event::TracedValue* res); | |
| 213 static void AddToTracedValue(const char* name, | |
| 214 const gfx::Point3F&, | |
| 215 base::trace_event::TracedValue* res); | |
| 216 static void AddToTracedValue(const char* name, | |
| 217 const gfx::Vector2d& v, | |
| 218 base::trace_event::TracedValue* res); | |
| 219 static void AddToTracedValue(const char* name, | |
| 220 const gfx::Vector2dF& v, | |
| 221 base::trace_event::TracedValue* res); | |
| 222 static void AddToTracedValue(const char* name, | |
| 223 const gfx::ScrollOffset& v, | |
| 224 base::trace_event::TracedValue* res); | |
| 225 static void AddToTracedValue(const char* name, | |
| 226 const gfx::QuadF& q, | |
| 227 base::trace_event::TracedValue* res); | |
| 228 static void AddToTracedValue(const char* name, | |
| 229 const gfx::RectF& rect, | |
| 230 base::trace_event::TracedValue* res); | |
| 231 static void AddToTracedValue(const char* name, | |
| 232 const gfx::Transform& transform, | |
| 233 base::trace_event::TracedValue* res); | |
| 234 static void AddToTracedValue(const char* name, | |
| 235 const gfx::BoxF& box, | |
| 236 base::trace_event::TracedValue* res); | |
| 237 | |
| 238 // Returns a base::Value representation of the floating point value. | |
| 239 // If the value is inf, returns max double/float representation. | |
| 240 static double AsDoubleSafely(double value); | |
| 241 static float AsFloatSafely(float value); | |
| 242 }; | |
| 243 | |
| 244 } // namespace cc | |
| 245 | |
| 246 #endif // CC_BASE_MATH_UTIL_H_ | |
| OLD | NEW |