JUCE
|
A pair of (x, y) coordinates. More...
Public Types | |
using | FloatType = TypeHelpers::SmallestFloatType< ValueType > |
This type will be double if the Point's type is double, otherwise it will be float. More... | |
Public Member Functions | |
constexpr | Point ()=default |
Creates a point at the origin. More... | |
constexpr | Point (const Point &)=default |
Creates a copy of another point. More... | |
constexpr | Point (ValueType initialX, ValueType initialY) noexcept |
Creates a point from an (x, y) position. More... | |
Point & | operator= (const Point &)=default |
Copies this point from another one. More... | |
constexpr bool | operator== (Point other) const noexcept |
constexpr bool | operator!= (Point other) const noexcept |
constexpr bool | isOrigin () const noexcept |
Returns true if the point is (0, 0). More... | |
constexpr bool | isFinite () const noexcept |
Returns true if the coordinates are finite values. More... | |
constexpr ValueType | getX () const noexcept |
Returns the point's x coordinate. More... | |
constexpr ValueType | getY () const noexcept |
Returns the point's y coordinate. More... | |
void | setX (ValueType newX) noexcept |
Sets the point's x coordinate. More... | |
void | setY (ValueType newY) noexcept |
Sets the point's y coordinate. More... | |
constexpr Point | withX (ValueType newX) const noexcept |
Returns a point which has the same Y position as this one, but a new X. More... | |
constexpr Point | withY (ValueType newY) const noexcept |
Returns a point which has the same X position as this one, but a new Y. More... | |
void | setXY (ValueType newX, ValueType newY) noexcept |
Changes the point's x and y coordinates. More... | |
void | addXY (ValueType xToAdd, ValueType yToAdd) noexcept |
Adds a pair of coordinates to this value. More... | |
constexpr Point | translated (ValueType deltaX, ValueType deltaY) const noexcept |
Returns a point with a given offset from this one. More... | |
constexpr Point | operator+ (Point other) const noexcept |
Adds two points together. More... | |
Point & | operator+= (Point other) noexcept |
Adds another point's coordinates to this one. More... | |
constexpr Point | operator- (Point other) const noexcept |
Subtracts one points from another. More... | |
Point & | operator-= (Point other) noexcept |
Subtracts another point's coordinates to this one. More... | |
template<typename OtherType > | |
constexpr Point | operator* (Point< OtherType > other) const noexcept |
Multiplies two points together. More... | |
template<typename OtherType > | |
Point & | operator*= (Point< OtherType > other) noexcept |
Multiplies another point's coordinates to this one. More... | |
template<typename OtherType > | |
constexpr Point | operator/ (Point< OtherType > other) const noexcept |
Divides one point by another. More... | |
template<typename OtherType > | |
Point & | operator/= (Point< OtherType > other) noexcept |
Divides this point's coordinates by another. More... | |
template<typename OtherType > | |
constexpr Point | operator* (OtherType multiplier) const noexcept |
Returns a point whose coordinates are multiplied by a given scalar value. More... | |
template<typename OtherType > | |
constexpr Point | operator/ (OtherType divisor) const noexcept |
Returns a point whose coordinates are divided by a given scalar value. More... | |
template<typename FloatType > | |
Point & | operator*= (FloatType multiplier) noexcept |
Multiplies the point's coordinates by a scalar value. More... | |
template<typename FloatType > | |
Point & | operator/= (FloatType divisor) noexcept |
Divides the point's coordinates by a scalar value. More... | |
constexpr Point | operator- () const noexcept |
Returns the inverse of this point. More... | |
ValueType | getDistanceFromOrigin () const noexcept |
Returns the straight-line distance between this point and the origin. More... | |
ValueType | getDistanceFrom (Point other) const noexcept |
Returns the straight-line distance between this point and another one. More... | |
constexpr ValueType | getDistanceSquaredFromOrigin () const noexcept |
Returns the square of the straight-line distance between this point and the origin. More... | |
constexpr ValueType | getDistanceSquaredFrom (Point other) const noexcept |
Returns the square of the straight-line distance between this point and another one. More... | |
FloatType | getAngleToPoint (Point other) const noexcept |
Returns the angle from this point to another one. More... | |
Point | rotatedAboutOrigin (ValueType angleRadians) const noexcept |
Returns the point that would be reached by rotating this point clockwise about the origin by the specified angle. More... | |
Point< FloatType > | getPointOnCircumference (float radius, float angle) const noexcept |
Taking this point to be the centre of a circle, this returns a point on its circumference. More... | |
Point< FloatType > | getPointOnCircumference (float radiusX, float radiusY, float angle) const noexcept |
Taking this point to be the centre of an ellipse, this returns a point on its circumference. More... | |
constexpr FloatType | getDotProduct (Point other) const noexcept |
Returns the dot-product of two points (x1 * x2 + y1 * y2). More... | |
void | applyTransform (const AffineTransform &transform) noexcept |
Uses a transform to change the point's coordinates. More... | |
Point | transformedBy (const AffineTransform &transform) const noexcept |
Returns the position of this point, if it is transformed by a given AffineTransform. More... | |
constexpr Point< int > | toInt () const noexcept |
Casts this point to a Point<int> object. More... | |
constexpr Point< float > | toFloat () const noexcept |
Casts this point to a Point<float> object. More... | |
constexpr Point< double > | toDouble () const noexcept |
Casts this point to a Point<double> object. More... | |
constexpr Point< int > | roundToInt () const noexcept |
Casts this point to a Point<int> object using roundToInt() to convert the values. More... | |
String | toString () const |
Returns the point as a string in the form "x, y". More... | |
Public Attributes | |
ValueType | x {} |
The point's X coordinate. More... | |
ValueType | y {} |
The point's Y coordinate. More... | |
A pair of (x, y) coordinates.
The ValueType template should be a primitive type such as int, float, double, rather than a class.
using Point< ValueType >::FloatType = TypeHelpers::SmallestFloatType<ValueType> |
This type will be double if the Point's type is double, otherwise it will be float.
Creates a point at the origin.
Referenced by Point< ValueType >::operator*(), Point< ValueType >::operator+(), Point< ValueType >::operator-(), Point< ValueType >::operator/(), Point< ValueType >::rotatedAboutOrigin(), Point< ValueType >::transformedBy(), Point< ValueType >::translated(), Point< ValueType >::withX(), and Point< ValueType >::withY().
|
constexprdefault |
Creates a copy of another point.
|
constexprnoexcept |
Creates a point from an (x, y) position.
|
default |
Copies this point from another one.
|
constexprnoexcept |
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns true if the point is (0, 0).
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns true if the coordinates are finite values.
References juce_isfinite(), Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns the point's x coordinate.
References Point< ValueType >::x.
|
constexprnoexcept |
Returns the point's y coordinate.
References Point< ValueType >::y.
|
noexcept |
Sets the point's x coordinate.
References Point< ValueType >::x.
|
noexcept |
Sets the point's y coordinate.
References Point< ValueType >::y.
|
constexprnoexcept |
Returns a point which has the same Y position as this one, but a new X.
References Point< ValueType >::Point(), and Point< ValueType >::y.
|
constexprnoexcept |
Returns a point which has the same X position as this one, but a new Y.
References Point< ValueType >::Point(), and Point< ValueType >::x.
|
noexcept |
Changes the point's x and y coordinates.
References Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Adds a pair of coordinates to this value.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns a point with a given offset from this one.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Adds two points together.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Adds another point's coordinates to this one.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Subtracts one points from another.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Subtracts another point's coordinates to this one.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Multiplies two points together.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Multiplies another point's coordinates to this one.
|
constexprnoexcept |
Divides one point by another.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Divides this point's coordinates by another.
|
constexprnoexcept |
Returns a point whose coordinates are multiplied by a given scalar value.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns a point whose coordinates are divided by a given scalar value.
References gl::divisor, Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Multiplies the point's coordinates by a scalar value.
References Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Divides the point's coordinates by a scalar value.
References gl::divisor, Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns the inverse of this point.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Returns the straight-line distance between this point and the origin.
References juce_hypot(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Returns the straight-line distance between this point and another one.
References juce_hypot(), Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns the square of the straight-line distance between this point and the origin.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns the square of the straight-line distance between this point and another one.
|
noexcept |
Returns the angle from this point to another one.
Taking this point to be the centre of a circle, and the other point being a position on the circumference, the return value is the number of radians clockwise from the 12 o'clock direction. So 12 o'clock = 0, 3 o'clock = Pi/2, 6 o'clock = Pi, 9 o'clock = -Pi/2
References Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Returns the point that would be reached by rotating this point clockwise about the origin by the specified angle.
References Point< ValueType >::Point(), Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Taking this point to be the centre of a circle, this returns a point on its circumference.
radius | the radius of the circle. |
angle | the angle of the point, in radians clockwise from the 12 o'clock position. |
References gl::angle, Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Taking this point to be the centre of an ellipse, this returns a point on its circumference.
radiusX | the horizontal radius of the circle. |
radiusY | the vertical radius of the circle. |
angle | the angle of the point, in radians clockwise from the 12 o'clock position. |
References gl::angle, Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Returns the dot-product of two points (x1 * x2 + y1 * y2).
References Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Uses a transform to change the point's coordinates.
This will only compile if ValueType = float!
References gl::transform, Point< ValueType >::x, and Point< ValueType >::y.
|
noexcept |
Returns the position of this point, if it is transformed by a given AffineTransform.
References Point< ValueType >::Point(), gl::transform, Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Casts this point to a Point<int> object.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Casts this point to a Point<float> object.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Casts this point to a Point<double> object.
References Point< ValueType >::x, and Point< ValueType >::y.
|
constexprnoexcept |
Casts this point to a Point<int> object using roundToInt() to convert the values.
References roundToInt(), Point< ValueType >::x, and Point< ValueType >::y.
Returns the point as a string in the form "x, y".
References Point< ValueType >::x, and Point< ValueType >::y.
ValueType Point< ValueType >::x {} |
The point's X coordinate.
Referenced by Point< ValueType >::addXY(), Point< ValueType >::applyTransform(), Point< ValueType >::getAngleToPoint(), Point< ValueType >::getDistanceFrom(), Point< ValueType >::getDistanceFromOrigin(), Point< ValueType >::getDistanceSquaredFromOrigin(), Point< ValueType >::getDotProduct(), Point< ValueType >::getPointOnCircumference(), Point< ValueType >::getX(), Point< ValueType >::isFinite(), Point< ValueType >::isOrigin(), Point< ValueType >::operator!=(), Point< ValueType >::operator*(), Point< ValueType >::operator*=(), Point< ValueType >::operator+(), Point< ValueType >::operator+=(), Point< ValueType >::operator-(), Point< ValueType >::operator-=(), Point< ValueType >::operator/(), Point< ValueType >::operator/=(), Point< ValueType >::operator==(), Point< ValueType >::rotatedAboutOrigin(), Point< ValueType >::roundToInt(), Point< ValueType >::setX(), Point< ValueType >::setXY(), Point< ValueType >::toDouble(), Point< ValueType >::toFloat(), Point< ValueType >::toInt(), Point< ValueType >::toString(), Point< ValueType >::transformedBy(), Point< ValueType >::translated(), and Point< ValueType >::withY().
ValueType Point< ValueType >::y {} |
The point's Y coordinate.
Referenced by Point< ValueType >::addXY(), Point< ValueType >::applyTransform(), Point< ValueType >::getAngleToPoint(), Point< ValueType >::getDistanceFrom(), Point< ValueType >::getDistanceFromOrigin(), Point< ValueType >::getDistanceSquaredFromOrigin(), Point< ValueType >::getDotProduct(), Point< ValueType >::getPointOnCircumference(), Point< ValueType >::getY(), Point< ValueType >::isFinite(), Point< ValueType >::isOrigin(), Point< ValueType >::operator!=(), Point< ValueType >::operator*(), Point< ValueType >::operator*=(), Point< ValueType >::operator+(), Point< ValueType >::operator+=(), Point< ValueType >::operator-(), Point< ValueType >::operator-=(), Point< ValueType >::operator/(), Point< ValueType >::operator/=(), Point< ValueType >::operator==(), Point< ValueType >::rotatedAboutOrigin(), Point< ValueType >::roundToInt(), Point< ValueType >::setXY(), Point< ValueType >::setY(), Point< ValueType >::toDouble(), Point< ValueType >::toFloat(), Point< ValueType >::toInt(), Point< ValueType >::toString(), Point< ValueType >::transformedBy(), Point< ValueType >::translated(), and Point< ValueType >::withX().