ui/gfx/geometry/vector2d.h

   1 // Copyright (c) 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 // Defines a simple integer vector class.  This class is used to indicate a
   6 // distance in two dimensions between two points. Subtracting two points should
   7 // produce a vector, and adding a vector to a point produces the point at the
   8 // vector's distance from the original point.
   9
  10 #ifndef UI_GFX_GEOMETRY_VECTOR2D_H_
  11 #define UI_GFX_GEOMETRY_VECTOR2D_H_
  12
  13 #include <iosfwd>
  14 #include <string>
  15
  16 #include "base/basictypes.h"
  17 #include "ui/gfx/geometry/vector2d_f.h"
  18 #include "ui/gfx/gfx_export.h"
  19
  20 namespace gfx {
  21
  22 class GFX_EXPORT Vector2d {
  23  public:
  24   Vector2d() : x_(0), y_(0) {}
  25   Vector2d(int x, int y) : x_(x), y_(y) {}
  26
  27   int x() const { return x_; }
  28   void set_x(int x) { x_ = x; }
  29
  30   int y() const { return y_; }
  31   void set_y(int y) { y_ = y; }
  32
  33   // True if both components of the vector are 0.
  34   bool IsZero() const;
  35
  36   // Add the components of the |other| vector to the current vector.
  37   void Add(const Vector2d& other);
  38   // Subtract the components of the |other| vector from the current vector.
  39   void Subtract(const Vector2d& other);
  40
  41   void operator+=(const Vector2d& other) { Add(other); }
  42   void operator-=(const Vector2d& other) { Subtract(other); }
  43
  44   void SetToMin(const Vector2d& other) {
  45     x_ = x_ <= other.x_ ? x_ : other.x_;
  46     y_ = y_ <= other.y_ ? y_ : other.y_;
  47   }
  48
  49   void SetToMax(const Vector2d& other) {
  50     x_ = x_ >= other.x_ ? x_ : other.x_;
  51     y_ = y_ >= other.y_ ? y_ : other.y_;
  52   }
  53
  54   // Gives the square of the diagonal length of the vector. Since this is
  55   // cheaper to compute than Length(), it is useful when you want to compare
  56   // relative lengths of different vectors without needing the actual lengths.
  57   int64 LengthSquared() const;
  58   // Gives the diagonal length of the vector.
  59   float Length() const;
  60
  61   std::string ToString() const;
  62
  63   operator Vector2dF() const {
  64     return Vector2dF(static_cast<float>(x()), static_cast<float>(y()));
  65   }
  66
  67  private:
  68   int x_;
  69   int y_;
  70 };
  71
  72 inline bool operator==(const Vector2d& lhs, const Vector2d& rhs) {
  73   return lhs.x() == rhs.x() && lhs.y() == rhs.y();
  74 }
  75
  76 inline Vector2d operator-(const Vector2d& v) {
  77   return Vector2d(-v.x(), -v.y());
  78 }
  79
  80 inline Vector2d operator+(const Vector2d& lhs, const Vector2d& rhs) {
  81   Vector2d result = lhs;
  82   result.Add(rhs);
  83   return result;
  84 }
  85
  86 inline Vector2d operator-(const Vector2d& lhs, const Vector2d& rhs) {
  87   Vector2d result = lhs;
  88   result.Add(-rhs);
  89   return result;
  90 }
  91
  92 // This is declared here for use in gtest-based unit tests but is defined in
  93 // the gfx_test_support target. Depend on that to use this in your unit test.
  94 // This should not be used in production code - call ToString() instead.
  95 void PrintTo(const Vector2d& vector, ::std::ostream* os);
  96
  97 }  // namespace gfx
  98
  99 #endif // UI_GFX_GEOMETRY_VECTOR2D_H_