Класс CubicCurve2D

protected CubicCurve2D()

Это абстрактный класс, который нельзя создать напрямую. Существуют подклассы конкретных типов, которые можно создать и предоставляют множество форматов для хранения информации, необходимой для удовлетворения различных методов доступа ниже.

public abstract double getX1()

Возвращает координату X начальной точки с двойной точностью.

public abstract double getY1()

Возвращает координату Y начальной точки с двойной точностью.

public abstract Point2D getP1()

Возвращает начальную точку.

public abstract double getCtrlX1()

Возвращает координату X первой контрольной точки с двойной точностью.

public abstract double getCtrlY1()

Возвращает координату Y первой контрольной точки с двойной точностью.

public abstract Point2D getCtrlP1()

Возвращает первую контрольную точку.

public abstract double getCtrlX2()

Возвращает координату X второй контрольной точки с двойной точностью.

public abstract double getCtrlY2()

Возвращает координату Y второй контрольной точки с двойной точностью.

public abstract Point2D getCtrlP2()

Возвращает вторую контрольную точку.

public abstract double getX2()

Возвращает координату X конечной точки с двойной точностью.

public abstract double getY2()

Возвращает координату Y конечной точки с двойной точностью.

public abstract Point2D getP2()

Возвращает конечную точку.

public abstract void setCurve(double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2)

Устанавливает положение конечных точек и контрольных точек этой кривой на указанные координаты с плавающей запятой.

public void setCurve(double[] coords, int offset)

Устанавливает положение конечных точек и контрольных точек этой кривой на координаты в указанном массиве по указанному смещению.

public void setCurve(Point2D p1, Point2D cp1, Point2D cp2, Point2D p2)

Устанавливает положение конечных точек и контрольных точек этой кривой на указанные координаты объектов Point2D.

public void setCurve(Point2D[] pts, int offset)

Устанавливает положение конечных точек и контрольных точек этой кривой на координаты объектов Point2D по указанному смещению в указанном массиве.

public void setCurve(CubicCurve2D c)

Устанавливает положение конечных точек и контрольных точек этой кривой на те же значения, что и в указанной кривой.

public static double getFlatnessSq(double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2)

Возвращает квадрат отклонения кубической кривой, заданной указанными контрольными точками. Отклонение — это максимальное расстояние от контрольной точки до линии, соединяющей конечные точки.

public static double getFlatness(double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2)

Возвращает степень кривизны кубической кривой, заданной указанными опорными точками. Степень кривизны — это максимальное расстояние опорной точки от прямой, соединяющей конечные точки.

public static double getFlatnessSq(double[] coords, int offset)

Возвращает квадрат степени кривизны кубической кривой, заданной опорными точками, хранящимися в указанном массиве по указанному индексу. Степень кривизны — это максимальное расстояние опорной точки от прямой, соединяющей конечные точки.

public static double getFlatness(double[] coords, int offset)

Возвращает степень кривизны кубической кривой, заданной опорными точками, хранящимися в указанном массиве по указанному индексу. Степень кривизны — это максимальное расстояние опорной точки от прямой, соединяющей конечные точки.

public double getFlatnessSq()

Возвращает квадрат степени кривизны этой кривой. Степень кривизны — это максимальное расстояние опорной точки от прямой, соединяющей конечные точки.

public double getFlatness()

Возвращает степень кривизны этой кривой. Степень кривизны — это максимальное расстояние опорной точки от прямой, соединяющей конечные точки.

public void subdivide(CubicCurve2D left, CubicCurve2D right)

Разделяет эту кубическую кривую и сохраняет полученные две разделенные кривые в параметрах левой и правой кривой. Левый и/или правый объекты могут быть такими же, как этот объект, или null.

public static void subdivide(CubicCurve2D src, CubicCurve2D left, CubicCurve2D right)

Разделяет кубическую кривую, заданную параметром src, и сохраняет полученные две разделенные кривые в параметрах кривых left и right. Левый и/или правый объекты могут быть такими же, как объект src, или null.

public static void subdivide(double[] src, int srcoff, double[] left, int leftoff, double[] right, int rightoff)

Разделяет кубическую кривую, заданную координатами, хранящимися в массиве src по индексам srcoff через (srcoff + 7), и сохраняет полученные две разделенные кривые в двух массивах результатов по соответствующим индексам. Массивы left и right могут быть null или ссылаться на тот же массив, что и массив src. Обратите внимание, что последняя точка первой разделенной кривой совпадает с первой точкой второй разделенной кривой. Поэтому можно передать один и тот же массив для left и right и использовать смещения, такие как rightoff равно (leftoff + 6), чтобы избежать выделения дополнительного места для этой общей точки.

public static int solveCubic(double[] eqn)

Решает кубическое уравнение, коэффициенты которого находятся в массиве eqn, и помещает действительные корни в тот же массив, возвращая количество корней. Решаемое кубическое уравнение представлено уравнением:

     eqn = {c, b, a, d}
     dx^3 + ax^2 + bx + c = 0
 

. Значение -1 используется для различения константного уравнения, которое может быть всегда 0 или никогда не 0, от уравнения, у которого нет нулей.

public static int solveCubic(double[] eqn, double[] res)

Решает кубическое уравнение, коэффициенты которого находятся в массиве eqn, и помещает действительные корни в массив res, возвращая количество корней. Решаемое кубическое уравнение представлено уравнением: eqn = {c, b, a, d} dx^3 + ax^2 + bx + c = 0. Значение -1 используется для различения константного уравнения, которое может быть всегда 0 или никогда не 0, от уравнения, у которого нет нулей.

public boolean contains(double x, double y)

Проверяет, находятся ли указанные координаты внутри границ Shape, как описано в определении внутри.

public boolean contains(Point2D p)

Проверяет, находится ли указанная точка Point2D внутри границ Shape, как описано в определении внутри.

public boolean intersects(double x, double y, double w, double h)

Проверяет, пересекается ли внутренняя область Shape с внутренней областью заданной прямоугольной области. Прямоугольная область считается пересекающейся с Shape , если хотя бы одна точка содержится как во внутренней области Shape, так и в заданной прямоугольной области.

Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в случаях:

• с высокой вероятностью пересечения прямоугольной области и Shape, но
• вычисления точного определения этого пересечения слишком затратны.

Это означает, что для некоторых Shapes этот метод может возвращать true даже если прямоугольная область не пересекает Shape. Класс Area выполняет более точные вычисления геометрического пересечения, чем большинство объектов Shape и поэтому может использоваться, если требуется более точный ответ.

public boolean intersects(Rectangle2D r)

Проверяет, пересекается ли внутренняя область Shape с внутренней областью заданного Rectangle2D. Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в случаях:

• с высокой вероятностью пересечения Rectangle2D и Shape, но
• вычисления точного определения этого пересечения слишком затратны.

Это означает, что для некоторых Shapes этот метод может возвращать true даже если Rectangle2D не пересекает Shape. Класс Area выполняет более точные вычисления геометрического пересечения, чем большинство объектов Shape и поэтому может использоваться, если требуется более точный ответ.

public boolean contains(double x, double y, double w, double h)

Проверяет, полностью ли внутренняя область Shape содержит заданную прямоугольную область. Все координаты, лежащие внутри прямоугольной области, должны лежать внутри Shape для того, чтобы вся прямоугольная область считалась содержащейся внутри Shape.

Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в случаях:

• метод intersect возвращает true и
• вычисления того, содержит ли Shape полностью прямоугольную область, слишком затратны.

Это означает, что для некоторых Shapes этот метод может возвращать false даже если Shape содержит прямоугольную область. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape и поэтому может использоваться, если требуется более точный ответ.

public boolean contains(Rectangle2D r)

Проверяет, полностью ли внутренняя область Shape содержит заданный Rectangle2D. Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в случаях:

• метод intersect возвращает true и
• вычисления того, содержит ли Shape полностью Rectangle2D, слишком затратны.

Это означает, что для некоторых Shapes этот метод может возвращать false даже если Shape содержит Rectangle2D. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape и поэтому может использоваться, если требуется более точный ответ.

public Rectangle2D getBounds2D()

Возвращает высокоточную и более точную ограничивающую прямоугольную область Shape по сравнению с методом getBounds. Обратите внимание, что нет гарантии, что возвращаемый Rectangle2D является наименьшей ограничивающей прямоугольной областью, охватывающей Shape, только что Shape полностью лежит внутри указанной Rectangle2D. Ограничивающая прямоугольная область, возвращаемая этим методом, обычно уже, чем возвращаемая методом getBounds, и никогда не выходит из строя из-за переполнения, так как значение возврата может быть экземпляром Rectangle2D, который использует значения с двойной точностью для хранения размеров.

Обратите внимание, что определение вложенности может привести к ситуациям, когда точки на определяющей контуре shape могут не считаться содержащимися в возвращенном объекте bounds, но только в тех случаях, когда эти точки также не считаются содержащимися в исходном shape.

Если point находится внутри shape в соответствии с методом contains(point), то она должна находиться внутри возвращаемой Rectangle2D ограничивающей прямоугольной области в соответствии с методом contains(point) объекта bounds. Конкретно:

shape.contains(p) требует bounds.contains(p)

Если point не находится внутри shape, то она может все еще находиться внутри объекта bounds:

bounds.contains(p) не подразумевает shape.contains(p)

public Rectangle getBounds()

Возвращает целое числовое Rectangle, которое полностью охватывает Shape. Обратите внимание, что нет гарантии, что возвращаемое Rectangle является наименьшей ограничивающей рамкой, охватывающей Shape, только то, что Shape целиком находится внутри указанной Rectangle. Возвращаемое Rectangle также может не полностью охватывать Shape, если Shape превышает ограниченный диапазон целочисленного типа данных. Метод getBounds2D обычно возвращает более тесную ограничивающую рамку из-за большей гибкости в представлении.

Обратите внимание, что определение принадлежности может привести к ситуациям, когда точки на определяющей контуре shape могут не считаться содержащимися в возвращаемом bounds объекте, но только в тех случаях, когда эти точки также не считаются содержащимися в исходном shape.

Если point находится внутри shape в соответствии с методом contains(point), то оно должно быть внутри возвращаемых границ Rectangle в соответствии с методом contains(point) объекта bounds. Конкретно:

shape.contains(x,y) требует bounds.contains(x,y)

Если point не находится внутри shape, то оно все еще может содержаться в объекте bounds:

bounds.contains(x,y) не подразумевает shape.contains(x,y)

public PathIterator getPathIterator(AffineTransform at)

Возвращает объект итерации, который определяет границу фигуры. Итератор для этого класса не потокобезопасен, что означает, что этот CubicCurve2D класс не гарантирует, что изменения геометрии этого CubicCurve2D объекта не повлияют на какие-либо итерации этой геометрии, которые уже находятся в процессе.

public PathIterator getPathIterator(AffineTransform at, double flatness)

Возвращает объект итерации, определяющий границу сглаженной фигуры. Итератор для этого класса не потокобезопасен, что означает, что этот CubicCurve2D класс не гарантирует, что изменения геометрии этого CubicCurve2D объекта не повлияют на любые итерации этой геометрии, которые уже находятся в процессе.

public Object clone()

Создает новый объект того же класса, что и этот объект.