Класс 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)

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

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 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()

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