Flutter Engine
The Flutter Engine
|
#include "include/core/SkPoint.h"
#include "include/core/SkScalar.h"
#include "include/core/SkTypes.h"
#include "include/private/base/SkFloatingPoint.h"
#include "src/base/SkVx.h"
#include <cstring>
#include "include/private/base/SkTemplates.h"
Go to the source code of this file.
Classes | |
struct | SkConic |
class | SkAutoConicToQuads |
Enumerations | |
enum class | SkCubicType { kSerpentine , kLoop , kLocalCusp , kCuspAtInfinity , kQuadratic , kLineOrPoint } |
enum | SkRotationDirection { kCW_SkRotationDirection , kCCW_SkRotationDirection } |
|
strong |
Enumerator | |
---|---|
kSerpentine | |
kLoop | |
kLocalCusp | |
kCuspAtInfinity | |
kQuadratic | |
kLineOrPoint |
Definition at line 264 of file SkGeometry.h.
enum SkRotationDirection |
Enumerator | |
---|---|
kCW_SkRotationDirection | |
kCCW_SkRotationDirection |
Definition at line 321 of file SkGeometry.h.
|
inlinestatic |
Definition at line 22 of file SkGeometry.h.
Given a src cubic bezier, chop it at the specified t0 and t1 values, where 0 <= t0 <= t1 <= 1, and return the three new cubics in dst: dst[0..3], dst[3..6], and dst[6..9]
Definition at line 504 of file SkGeometry.cpp.
Given a src cubic bezier, chop it at the specified t value, where 0 <= t <= 1, and return the two new cubics in dst: dst[0..3] and dst[3..6]
Definition at line 473 of file SkGeometry.cpp.
Given a src cubic bezier, chop it at the specified t values, where 0 <= t0 <= t1 <= ... <= 1, and return the new cubics in dst: dst[0..3],dst[3..6],...,dst[3*t_count..3*(t_count+1)]
Definition at line 541 of file SkGeometry.cpp.
Given a src cubic bezier, chop it at the specified t == 1/2, The new cubics are returned in dst[0..3] and dst[3..6]
Definition at line 575 of file SkGeometry.cpp.
Return 1 for no chop, 2 for having chopped the cubic at a single inflection point, 3 for having chopped at 2 inflection points. dst will hold the resulting 1, 2, or 3 cubics.
Definition at line 755 of file SkGeometry.cpp.
int SkChopCubicAtMaxCurvature | ( | const SkPoint | src[4], |
SkPoint | dst[13], | ||
SkScalar | tValues[3] = nullptr |
||
) |
Definition at line 1060 of file SkGeometry.cpp.
Given a src cubic bezier, chop it at the tangent whose angle is halfway between the tangents at p0 and p3. The new cubics are returned in dst[0..3] and dst[3..6].
NOTE: 0- and 360-degree flat lines don't have single points of midtangent. (tangent == midtangent at every point on these curves except the cusp points.) If this is the case then we simply chop at a point which guarantees neither side rotates more than 180 degrees.
Definition at line 195 of file SkGeometry.h.
Definition at line 714 of file SkGeometry.cpp.
Given 4 points on a cubic bezier, chop it into 1, 2, 3 beziers such that the resulting beziers are monotonic in Y. This is called by the scan converter. Depending on what is returned, dst[] is treated as follows 0 dst[0..3] is the original cubic 1 dst[0..3] and dst[3..6] are the two new cubics 2 dst[0..3], dst[3..6], dst[6..9] are the three new cubics If dst == null, it is ignored and only the count is returned.
Given 4 points on a cubic bezier, chop it into 1, 2, 3 beziers such that the resulting beziers are monotonic in Y. This is called by the scan converter. Depending on what is returned, dst[] is treated as follows: 0 dst[0..3] is the original cubic 1 dst[0..3] and dst[3..6] are the two new cubics 2 dst[0..3], dst[3..6], dst[6..9] are the three new cubics If dst == null, it is ignored and only the count is returned.
Definition at line 698 of file SkGeometry.cpp.
Given a monotonically increasing or decreasing cubic bezier src, chop it where the X value is the specified value. The returned cubics will be in dst, sharing the middle point. That is, the first cubic is dst[0..3] and the second dst[3..6].
If the cubic provided is not monotone, it will be chopped at the first time the curve has the specified X value.
If the cubic never reaches the specified value, the function returns false.
Definition at line 1204 of file SkGeometry.cpp.
Given a monotonically increasing or decreasing cubic bezier src, chop it where the Y value is the specified value. The returned cubics will be in dst, sharing the middle point. That is, the first cubic is dst[0..3] and the second dst[3..6].
If the cubic provided is not monotone, it will be chopped at the first time the curve has the specified Y value.
If the cubic never reaches the specified value, the function returns false.
Definition at line 1188 of file SkGeometry.cpp.
Given a src quadratic bezier, chop it at the specified t value, where 0 < t < 1, and return the two new quadratics in dst: dst[0..2] and dst[2..4]
Definition at line 175 of file SkGeometry.cpp.
Given a src quadratic bezier, chop it at the specified t == 1/2, The new quads are returned in dst[0..2] and dst[2..4]
Definition at line 193 of file SkGeometry.cpp.
Given 3 points on a quadratic bezier, divide it into 2 quadratics if the point of maximum curvature exists on the quad segment. Depending on what is returned, dst[] is treated as follows 1 dst[0..2] is the original quad 2 dst[0..2] and dst[2..4] are the two new quads If dst == null, it is ignored and only the count is returned.
Definition at line 367 of file SkGeometry.cpp.
Given a src quadratic bezier, chop it at the tangent whose angle is halfway between the tangents at p0 and p2. The new quads are returned in dst[0..2] and dst[2..4].
Definition at line 91 of file SkGeometry.h.
Definition at line 307 of file SkGeometry.cpp.
Given 3 points on a quadratic bezier, chop it into 1, 2 beziers such that the resulting beziers are monotonic in Y. This is called by the scan converter. Depending on what is returned, dst[] is treated as follows 0 dst[0..2] is the original quad 1 dst[0..2] and dst[2..4] are the two new quads
Definition at line 279 of file SkGeometry.cpp.
SkCubicType SkClassifyCubic | ( | const SkPoint | p[4], |
double | t[2] = nullptr , |
||
double | s[2] = nullptr , |
||
double | d[4] = nullptr |
||
) |
Returns the cubic classification.
t[],s[] are set to the two homogeneous parameter values at which points the lines L & M intersect with K, sorted from smallest to largest and oriented so positive values of the implicit are on the "left" side. For a serpentine curve they are the inflection points. For a loop they are the double point. For a local cusp, they are both equal and denote the cusp point. For a cusp at an infinite parameter value, one will be the local inflection point and the other +inf (t,s = 1,0). If the curve is degenerate (i.e. quadratic or linear) they are both set to a parameter value of +inf (t,s = 1,0).
d[] is filled with the cubic inflection function coefficients. See "Resolution Independent Curve Rendering using Programmable Graphics Hardware", 4.2 Curve Categorization:
If the input points contain infinities or NaN, the return values are undefined.
https://www.microsoft.com/en-us/research/wp-content/uploads/2005/01/p1000-loop.pdf
Definition at line 809 of file SkGeometry.cpp.
Given 3 points on a quadratic bezier, use degree elevation to convert it into the cubic fitting the same curve. The new cubic curve is returned in dst[0..3].
Definition at line 378 of file SkGeometry.cpp.
|
inlinestatic |
Definition at line 273 of file SkGeometry.h.
|
inlinestatic |
Definition at line 287 of file SkGeometry.h.
void SkEvalCubicAt | ( | const SkPoint | src[4], |
SkScalar | t, | ||
SkPoint * | locOrNull, | ||
SkVector * | tangentOrNull, | ||
SkVector * | curvatureOrNull | ||
) |
Set pt to the point on the src cubic specified by t. t must be 0 <= t <= 1.0
Definition at line 418 of file SkGeometry.cpp.
Definition at line 144 of file SkGeometry.cpp.
Set pt to the point on the src quadratic specified by t. t must be 0 <= t <= 1.0
Definition at line 132 of file SkGeometry.cpp.
Definition at line 148 of file SkGeometry.cpp.
Returns a new, arbitrarily scaled vector that bisects the given vectors. The returned bisector will always point toward the interior of the provided vectors.
Definition at line 204 of file SkGeometry.cpp.
Returns t value of cusp if cubic has one; returns -1 otherwise.
Definition at line 1112 of file SkGeometry.cpp.
Given the 4 coefficients for a cubic bezier (either X or Y values), look for extrema, and return the number of t-values that are found that represent these extrema. If the cubic has no extrema betwee (0..1) exclusive, the function returns 0. Returned count tValues[] 0 ignored 1 0 < tValues[0] < 1 2 0 < tValues[0] < tValues[1] < 1
Cubic'(t) = At^2 + Bt + C, where A = 3(-a + 3(b - c) + d) B = 6(a - 2b + c) C = 3(b - a) Solve for t, keeping only those that fit betwee 0 < t < 1
Definition at line 454 of file SkGeometry.cpp.
Given a cubic bezier, return 0, 1, or 2 t-values that represent the inflection points.
http://www.faculty.idc.ac.il/arik/quality/appendixA.html
Inflection means that curvature is zero. Curvature is [F' x F''] / [F'^3] So we solve F'x X F''y - F'y X F''y == 0 After some canceling of the cubic term, we get A = b - a B = c - 2b + a C = d - 3c + 3b - a (BxCy - ByCx)t^2 + (AxCy - AyCx)t + AxBy - AyBx == 0
Definition at line 741 of file SkGeometry.cpp.
Definition at line 1043 of file SkGeometry.cpp.
float SkFindCubicMidTangent | ( | const SkPoint | src[4] | ) |
Given a src cubic bezier, returns the T value whose tangent angle is halfway between the tangents at p0 and p3.
Definition at line 620 of file SkGeometry.cpp.
Given the 3 coefficients for a quadratic bezier (either X or Y values), look for extrema, and return the number of t-values that are found that represent these extrema. If the quadratic has no extrema betwee (0..1) exclusive, the function returns 0. Returned count tValues[] 0 ignored 1 0 < tValues[0] < 1
Quad'(t) = At + B, where A = 2(a - 2b + c) B = 2(b - a) Solve for t, only if it fits between 0 < t < 1
Definition at line 265 of file SkGeometry.cpp.
Given 3 points on a quadratic bezier, if the point of maximum curvature exists on the segment, returns the t value for this point along the curve. Otherwise it will return a value of 0.
Definition at line 344 of file SkGeometry.cpp.
float SkFindQuadMidTangent | ( | const SkPoint | src[3] | ) |
Given a src quadratic bezier, returns the T value whose tangent angle is halfway between the tangents at p0 and p3.
Definition at line 231 of file SkGeometry.cpp.
Given a quadratic equation Ax^2 + Bx + C = 0, return 0, 1, 2 roots for the equation.
From Numerical Recipes in C.
Q = -1/2 (B + sign(B) sqrt[B*B - 4*A*C]) x1 = Q / A x2 = C / Q
Definition at line 95 of file SkGeometry.cpp.
Measures the angle between two vectors, in the range [0, pi].
Definition at line 197 of file SkGeometry.cpp.
float SkMeasureNonInflectCubicRotation | ( | const | SkPoint[4] | ) |
Given a cubic curve with no inflection points, this method measures the rotation in radians.
Rotation is perhaps easiest described via a driving analogy: If you drive your car along the curve from p0 to p3, then by the time you arrive at p3, how many radians will your car have rotated? This is not quite the same as the vector inside the tangents at the endpoints, even without inflection, because the curve might rotate around the outside of the tangents (>= 180 degrees) or the inside (<= 180 degrees).
Cubics can have rotations in the range [0, 2*pi].
NOTE: The caller must either call SkChopCubicAtInflections or otherwise prove that the provided cubic has no inflection points prior to calling this method.
Definition at line 579 of file SkGeometry.cpp.
|
inline |
Measures the rotation of the given quadratic curve in radians.
Rotation is perhaps easiest described via a driving analogy: If you drive your car along the curve from p0 to p2, then by the time you arrive at p2, how many radians will your car have rotated? For a quadratic this is the same as the vector inside the tangents at the endpoints.
Quadratics can have rotations in the range [0, pi].
Definition at line 79 of file SkGeometry.h.
|
static |
Definition at line 32 of file SkGeometry.h.
|
inlinestatic |
Definition at line 26 of file SkGeometry.h.