137b874855
- formalize how aliases and substitutions work together - add constexpr, #define, typedef support - check for correct description order - write short enum, struct members R=caryclark@google.com Docs-Preview: https://skia.org/?cl=129455 Bug: skia:6898 Change-Id: Id60fc2ed02f38a7ba4e5cad5ef493d8c674e6183 Reviewed-on: https://skia-review.googlesource.com/129455 Commit-Queue: Cary Clark <caryclark@skia.org> Reviewed-by: Cary Clark <caryclark@skia.org> Auto-Submit: Cary Clark <caryclark@skia.org>
471 lines
11 KiB
Plaintext
471 lines
11 KiB
Plaintext
#Topic IPoint
|
|
#Alias IPoints ##
|
|
#Alias IPoint_Reference ##
|
|
|
|
#Struct SkIPoint
|
|
|
|
SkIPoint holds two 32-bit integer coordinates.
|
|
|
|
#Subtopic Overview
|
|
#Populate
|
|
##
|
|
|
|
#Subtopic Related_Function
|
|
#Populate
|
|
##
|
|
|
|
#Subtopic Member_Function
|
|
#Populate
|
|
##
|
|
|
|
#Subtopic Member
|
|
#Populate
|
|
|
|
#Member int32_t fX
|
|
#Line # x-axis value ##
|
|
x-axis value used by IPoint.
|
|
##
|
|
|
|
#Member int32_t fY
|
|
#Line # y-axis value ##
|
|
y-axis value used by IPoint.
|
|
##
|
|
|
|
#Subtopic Member ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Subtopic Constructor
|
|
#Populate
|
|
##
|
|
|
|
#Method static constexpr SkIPoint Make(int32_t x, int32_t y)
|
|
|
|
#In Constructor
|
|
#Line # constructs from integer inputs ##
|
|
Sets fX to x, fY to y.
|
|
|
|
#Param x integer x-axis value of constructed IPoint ##
|
|
#Param y integer y-axis value of constructed IPoint ##
|
|
|
|
#Return IPoint (x, y) ##
|
|
|
|
#Example
|
|
SkIPoint pt1 = {45, 66};
|
|
SkIPoint pt2 = SkIPoint::Make(45, 66);
|
|
SkDebugf("pt1 %c= pt2\n", pt1 == pt2 ? '=' : '!');
|
|
#StdOut
|
|
pt1 == pt2
|
|
##
|
|
##
|
|
|
|
#SeeAlso set() SkPoint::iset() SkPoint::Make
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Subtopic Property
|
|
#Line # member values ##
|
|
#Populate
|
|
##
|
|
|
|
#Method int32_t x() const
|
|
#In Property
|
|
#Line # returns fX ##
|
|
Returns x-axis value of IPoint.
|
|
|
|
#Return fX ##
|
|
|
|
#Example
|
|
SkIPoint pt1 = {45, 66};
|
|
SkDebugf("pt1.fX %c= pt1.x()\n", pt1.fX == pt1.x() ? '=' : '!');
|
|
#StdOut
|
|
pt1.fX == pt1.x()
|
|
##
|
|
##
|
|
|
|
#SeeAlso y() SkPoint::x()
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method int32_t y() const
|
|
#In Property
|
|
#Line # returns fY ##
|
|
Returns y-axis value of IPoint.
|
|
|
|
#Return fY ##
|
|
|
|
#Example
|
|
SkIPoint pt1 = {45, 66};
|
|
SkDebugf("pt1.fY %c= pt1.y()\n", pt1.fY == pt1.y() ? '=' : '!');
|
|
#StdOut
|
|
pt1.fY == pt1.y()
|
|
##
|
|
##
|
|
|
|
#SeeAlso x() SkPoint::y()
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method bool isZero() const
|
|
#In Property
|
|
#Line # returns true if both members equal zero ##
|
|
Returns true if fX and fY are both zero.
|
|
|
|
#Return true if fX is zero and fY is zero ##
|
|
|
|
#Example
|
|
SkIPoint pt = { 0, -0};
|
|
SkDebugf("pt.isZero() == %s\n", pt.isZero() ? "true" : "false");
|
|
#StdOut
|
|
pt.isZero() == true
|
|
##
|
|
##
|
|
|
|
#SeeAlso SkPoint::isZero
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Subtopic Set
|
|
#Populate
|
|
#Line # replaces all values ##
|
|
##
|
|
|
|
#Method void set(int32_t x, int32_t y)
|
|
#In Set
|
|
#Line # sets to integer input ##
|
|
Sets fX to x and fY to y.
|
|
|
|
#Param x new value for fX ##
|
|
#Param y new value for fY ##
|
|
|
|
#Example
|
|
SkIPoint pt1, pt2 = { SK_MinS32, SK_MaxS32 };
|
|
pt1.set(SK_MinS32, SK_MaxS32);
|
|
SkDebugf("pt1 %c= pt2\n", pt1 == pt2 ? '=' : '!');
|
|
#StdOut
|
|
pt1 == pt2
|
|
##
|
|
##
|
|
|
|
#SeeAlso Make
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
#Subtopic Operator
|
|
#Populate
|
|
##
|
|
|
|
#Method SkIPoint operator-()_const
|
|
|
|
#Line # reverses sign of IPoint ##
|
|
Returns IPoint changing the signs of fX and fY.
|
|
|
|
#Return IPoint as (-fX, -fY) ##
|
|
|
|
#Example
|
|
SkIPoint test[] = { {0, -0}, {-1, -2},
|
|
{ SK_MaxS32, SK_MinS32 },
|
|
{ SK_NaN32, SK_NaN32 } };
|
|
for (const SkIPoint& pt : test) {
|
|
SkIPoint negPt = -pt;
|
|
SkDebugf("pt: %d, %d negate: %d, %d\n", pt.fX, pt.fY, negPt.fX, negPt.fY);
|
|
}
|
|
#StdOut
|
|
pt: 0, 0 negate: 0, 0
|
|
pt: -1, -2 negate: 1, 2
|
|
pt: 2147483647, -2147483647 negate: -2147483647, 2147483647
|
|
pt: -2147483648, -2147483648 negate: -2147483648, -2147483648
|
|
##
|
|
##
|
|
|
|
#SeeAlso operator-(const SkIPoint& a, const SkIPoint& b) operator-=(const SkIVector& v) SkPoint::operator-()_const
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method void operator+=(const SkIVector& v)
|
|
|
|
#Line # adds IVector to IPoint ##
|
|
Offsets IPoint by IVector v. Sets IPoint to
|
|
#Formula
|
|
(fX + v.fX, fY + v.fY)
|
|
##
|
|
.
|
|
|
|
#Param v IVector to add ##
|
|
|
|
#Example
|
|
#Height 64
|
|
auto draw_lines = [=](const SkIPoint pts[], size_t count, SkPaint& paint) -> void {
|
|
for (size_t i = 0; i < count - 1; ++i) {
|
|
SkPoint p0, p1;
|
|
p0.iset(pts[i]);
|
|
p1.iset(pts[i + 1]);
|
|
canvas->drawLine(p0, p1, paint);
|
|
}
|
|
};
|
|
SkIPoint points[] = { { 3, 1 }, { 4, 2 }, { 5, 1 }, { 7, 3 } };
|
|
SkPaint paint;
|
|
paint.setAntiAlias(true);
|
|
paint.setStyle(SkPaint::kStroke_Style);
|
|
canvas->scale(30, 15);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
points[1] += {1, 1};
|
|
points[2] += {-1, -1};
|
|
paint.setColor(SK_ColorRED);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
##
|
|
|
|
#SeeAlso operator+(const SkIPoint& a, const SkIVector& b) SkPoint::operator+=(const SkVector& v)
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method void operator-=(const SkIVector& v)
|
|
|
|
#Line # subtracts IVector from IPoint ##
|
|
Subtracts IVector v from IPoint. Sets IPoint to:
|
|
#Formula
|
|
(fX - v.fX, fY - v.fY)
|
|
##
|
|
.
|
|
|
|
#Param v IVector to subtract ##
|
|
|
|
#Example
|
|
#Height 64
|
|
auto draw_lines = [=](const SkIPoint pts[], size_t count, SkPaint& paint) -> void {
|
|
for (size_t i = 0; i < count - 1; ++i) {
|
|
SkPoint p0, p1;
|
|
p0.iset(pts[i]);
|
|
p1.iset(pts[i + 1]);
|
|
canvas->drawLine(p0, p1, paint);
|
|
}
|
|
};
|
|
SkIPoint points[] = { { 3, 1 }, { 4, 2 }, { 5, 1 }, { 7, 3 } };
|
|
SkPaint paint;
|
|
paint.setAntiAlias(true);
|
|
paint.setStyle(SkPaint::kStroke_Style);
|
|
canvas->scale(30, 15);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
points[1] -= {1, 1};
|
|
points[2] -= {-1, -1};
|
|
paint.setColor(SK_ColorRED);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
##
|
|
|
|
#SeeAlso operator-(const SkIPoint& a, const SkIPoint& b) SkPoint::operator-=(const SkVector& v)
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method bool equals(int32_t x, int32_t y) const
|
|
#In Operator
|
|
#Line # returns true if members are equal ##
|
|
Returns true if IPoint is equivalent to IPoint constructed from (x, y).
|
|
|
|
#Param x value compared with fX ##
|
|
#Param y value compared with fY ##
|
|
|
|
#Return true if IPoint equals (x, y) ##
|
|
|
|
#Example
|
|
SkIPoint test[] = { {0, -0}, {-1, -2}, {SK_MaxS32, -1}, {SK_NaN32, -1} };
|
|
for (const SkIPoint& pt : test) {
|
|
SkDebugf("pt: %d, %d %c= pt\n", pt.fX, pt.fY, pt.equals(pt.fX, pt.fY) ? '=' : '!');
|
|
}
|
|
#StdOut
|
|
pt: 0, 0 == pt
|
|
pt: -1, -2 == pt
|
|
pt: 2147483647, -1 == pt
|
|
pt: -2147483648, -1 == pt
|
|
##
|
|
##
|
|
|
|
#SeeAlso operator==(const SkIPoint& a, const SkIPoint& b)
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method bool operator==(const SkIPoint& a, const SkIPoint& b)
|
|
|
|
#Line # returns true if IPoints are equal ##
|
|
Returns true if a is equivalent to b.
|
|
|
|
#Param a IPoint to compare ##
|
|
#Param b IPoint to compare ##
|
|
|
|
#Return true if a.fX == b.fX and a.fY == b.fY ##
|
|
|
|
#Example
|
|
SkIPoint test[] = { {0, -0}, {-1, -2}, {SK_MaxS32, -1}, {SK_NaN32, -1} };
|
|
for (const SkIPoint& pt : test) {
|
|
SkDebugf("pt: %d, %d %c= pt\n", pt.fX, pt.fY, pt == pt ? '=' : '!');
|
|
}
|
|
#StdOut
|
|
pt: 0, 0 == pt
|
|
pt: -1, -2 == pt
|
|
pt: 2147483647, -1 == pt
|
|
pt: -2147483648, -1 == pt
|
|
##
|
|
##
|
|
|
|
#SeeAlso equals() operator!=(const SkIPoint& a, const SkIPoint& b)
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method bool operator!=(const SkIPoint& a, const SkIPoint& b)
|
|
|
|
#Line # returns true if IPoints are unequal ##
|
|
Returns true if a is not equivalent to b.
|
|
|
|
#Param a IPoint to compare ##
|
|
#Param b IPoint to compare ##
|
|
|
|
#Return true if a.fX != b.fX or a.fY != b.fY ##
|
|
|
|
#Example
|
|
SkIPoint test[] = { {0, -0}, {-1, -2}, {SK_MaxS32, -1}, {SK_NaN32, -1} };
|
|
for (const SkIPoint& pt : test) {
|
|
SkDebugf("pt: %d, %d %c= pt\n", pt.fX, pt.fY, pt != pt ? '!' : '=');
|
|
}
|
|
#StdOut
|
|
pt: 0, 0 == pt
|
|
pt: -1, -2 == pt
|
|
pt: 2147483647, -1 == pt
|
|
pt: -2147483648, -1 == pt
|
|
##
|
|
##
|
|
|
|
#SeeAlso operator==(const SkIPoint& a, const SkIPoint& b) equals()
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method SkIVector operator-(const SkIPoint& a, const SkIPoint& b)
|
|
|
|
#Line # returns IVector between IPoints ##
|
|
Returns IVector from b to a; computed as
|
|
#Formula
|
|
(a.fX - b.fX, a.fY - b.fY)
|
|
##
|
|
.
|
|
|
|
Can also be used to subtract IVector from IVector, returning IVector.
|
|
|
|
#Param a IPoint or IVector to subtract from ##
|
|
#Param b IVector to subtract ##
|
|
|
|
#Return IVector from b to a ##
|
|
|
|
#Example
|
|
#Height 64
|
|
auto draw_lines = [=](const SkIPoint pts[], size_t count, SkPaint& paint) -> void {
|
|
for (size_t i = 0; i < count - 1; ++i) {
|
|
SkPoint p0, p1;
|
|
p0.iset(pts[i]);
|
|
p1.iset(pts[i + 1]);
|
|
canvas->drawLine(p0, p1, paint);
|
|
}
|
|
};
|
|
SkIPoint points[] = { { 3, 1 }, { 4, 2 }, { 5, 1 }, { 7, 3 } };
|
|
SkPaint paint;
|
|
paint.setAntiAlias(true);
|
|
paint.setStyle(SkPaint::kStroke_Style);
|
|
canvas->scale(30, 15);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
points[1] += points[0] - points[3];
|
|
points[2] -= points[1] - points[0];
|
|
paint.setColor(SK_ColorRED);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
##
|
|
|
|
#SeeAlso operator-=(const SkIVector& v)
|
|
|
|
#Method ##
|
|
|
|
# ------------------------------------------------------------------------------
|
|
|
|
#Method SkIPoint operator+(const SkIPoint& a, const SkIVector& b)
|
|
|
|
#Line # returns IPoint offset by IVector ##
|
|
Returns IPoint resulting from IPoint a offset by IVector b, computed as:
|
|
#Formula
|
|
(a.fX + b.fX, a.fY + b.fY)
|
|
##
|
|
.
|
|
|
|
Can also be used to offset IPoint b by IVector a, returning IPoint.
|
|
Can also be used to add IVector to IVector, returning IVector.
|
|
|
|
#Param a IPoint or IVector to add to ##
|
|
#Param b IPoint or IVector to add ##
|
|
|
|
#Return IPoint equal to a offset by b ##
|
|
|
|
#Example
|
|
#Height 128
|
|
auto draw_lines = [=](const SkIPoint pts[], size_t count, SkPaint& paint) -> void {
|
|
for (size_t i = 0; i < count - 1; ++i) {
|
|
SkPoint p0, p1;
|
|
p0.iset(pts[i]);
|
|
p1.iset(pts[i + 1]);
|
|
canvas->drawLine(p0, p1, paint);
|
|
}
|
|
};
|
|
SkIPoint points[] = { { 3, 1 }, { 4, 2 }, { 5, 1 }, { 7, 3 } };
|
|
SkPaint paint;
|
|
paint.setAntiAlias(true);
|
|
paint.setStyle(SkPaint::kStroke_Style);
|
|
canvas->scale(30, 15);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
SkIPoint mod = {4, 1};
|
|
for (auto& point : points) {
|
|
point = point + mod;
|
|
mod.fX -= 1;
|
|
mod.fY += 1;
|
|
}
|
|
paint.setColor(SK_ColorRED);
|
|
draw_lines(points, SK_ARRAY_COUNT(points), paint);
|
|
##
|
|
|
|
#SeeAlso operator+=(const SkIVector& v)
|
|
|
|
#Method ##
|
|
|
|
#Struct SkIPoint ##
|
|
|
|
|
|
#Subtopic IVector
|
|
#Line # alias for IPoint ##
|
|
#Alias IVector ##
|
|
#Alias IVectors ##
|
|
#Typedef SkIPoint SkIVector
|
|
#Line # alias for IPoint ##
|
|
#Code
|
|
typedef SkIPoint SkIVector;
|
|
##
|
|
SkIVector provides an alternative name for SkIPoint. SkIVector and SkIPoint
|
|
can be used interchangeably for all purposes.
|
|
#Typedef ##
|
|
##
|
|
|
|
#Topic IPoint ##
|
|
|