Класс CubicCurve2D

public abstract class CubicCurve2D
extends Object
implements Shape, Cloneable

Класс CubicCurve2D определяет сегмент кубической параметрической кривой в (x,y) системе координат.

Этот класс является только абстрактным суперклассом для всех объектов, которые хранят сегмент 2D кубической кривой. Фактическое представление координат оставляется подклассу.

Конструкторы

CubicCurve2D

protected CubicCurve2D()

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

С момента:

1.2

См. также:

CubicCurve2D.Float, CubicCurve2D.Double

Методы

getX1

public abstract double getX1()

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

Возвращает:

координату X начальной точки CubicCurve2D.

С момента:

1.2

getY1

public abstract double getY1()

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

Возвращает:

координату Y начальной точки CubicCurve2D.

С момента:

1.2

getP1

public abstract Point2D getP1()

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

Возвращает:

объект Point2D, являющийся начальной точкой CubicCurve2D.

С момента:

1.2

getCtrlX1

public abstract double getCtrlX1()

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

Возвращает:

координату X первой контрольной точки CubicCurve2D.

С момента:

1.2

getCtrlY1

public abstract double getCtrlY1()

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

Возвращает:

координату Y первой контрольной точки CubicCurve2D.

С момента:

1.2

getCtrlP1

public abstract Point2D getCtrlP1()

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

Возвращает:

объект Point2D, являющийся первой контрольной точкой CubicCurve2D.

С момента:

1.2

getCtrlX2

public abstract double getCtrlX2()

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

Возвращает:

координату X второй контрольной точки CubicCurve2D.

С момента:

1.2

getCtrlY2

public abstract double getCtrlY2()

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

Возвращает:

координату Y второй контрольной точки CubicCurve2D.

С момента:

1.2

getCtrlP2

public abstract Point2D getCtrlP2()

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

Возвращает:

объект Point2D, являющийся второй контрольной точкой CubicCurve2D.

С момента:

1.2

getX2

public abstract double getX2()

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

Возвращает:

координату X конечной точки CubicCurve2D.

С момента:

1.2

getY2

public abstract double getY2()

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

Возвращает:

координату Y конечной точки CubicCurve2D.

С момента:

1.2

getP2

public abstract Point2D getP2()

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

Возвращает:

объект Point2D, являющийся конечной точкой CubicCurve2D.

С момента:

1.2

setCurve

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

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

Параметры:

x1 - координата X, используемая для задания начальной точки этой CubicCurve2D

y1 - координата Y, используемая для задания начальной точки этой CubicCurve2D

ctrlx1 - координата X, используемая для задания первой контрольной точки этой CubicCurve2D

ctrly1 - координата Y, используемая для задания первой контрольной точки этой CubicCurve2D

ctrlx2 - координата X, используемая для задания второй контрольной точки этой CubicCurve2D

ctrly2 - координата Y, используемая для задания второй контрольной точки этой CubicCurve2D

x2 - координата X, используемая для задания конечной точки этой CubicCurve2D

y2 - координата Y, используемая для задания конечной точки этой CubicCurve2D

С момента:

1.2

setCurve

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

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

Параметры:

coords - массив координат с плавающей запятой

offset - индекс coords, с которого начинать установку конечных точек и контрольных точек этой кривой до координат, содержащихся в coords

С момента:

1.2

setCurve

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

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

Параметры:

p1 - первая указанная Point2D для установки начальной точки этой кривой

cp1 - вторая указанная Point2D для установки первой контрольной точки этой кривой

cp2 - третья указанная Point2D для установки второй контрольной точки этой кривой

p2 - четвёртая указанная Point2D для установки конечной точки этой кривой

С момента:

1.2

setCurve

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

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

Параметры:

pts - массив объектов Point2D

offset - индекс pts, с которого начинать установку конечных точек и контрольных точек этой кривой до точек, содержащихся в pts

С момента:

1.2

setCurve

public void setCurve(CubicCurve2D c)

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

Параметры:

c - указанная CubicCurve2D

С момента:

1.2

getFlatnessSq

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

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

Параметры:

x1 - координата X, которая задаёт начальную точку CubicCurve2D

y1 - координата Y, которая задаёт начальную точку CubicCurve2D

ctrlx1 - координата X, которая задаёт первую контрольную точку CubicCurve2D

ctrly1 - координата Y, которая задаёт первую контрольную точку CubicCurve2D

ctrlx2 - координата X, которая задаёт вторую контрольную точку CubicCurve2D

ctrly2 - координата Y, которая задаёт вторую контрольную точку CubicCurve2D

x2 - координата X, которая задаёт конечную точку CubicCurve2D

y2 - координата Y, которая задаёт конечную точку CubicCurve2D

Возвращает:

квадрат отклонения CubicCurve2D, представленной указанными координатами.

С момента:

1.2

getFlatness

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

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

Параметры:

x1 - координата X, которая задаёт начальную точку CubicCurve2D

y1 - координата Y, которая задаёт начальную точку CubicCurve2D

ctrlx1 - координата X, которая задаёт первую контрольную точку CubicCurve2D

ctrly1 - координата Y, которая задаёт первую контрольную точку CubicCurve2D

ctrlx2 - координата X, которая задаёт вторую контрольную точку CubicCurve2D

ctrly2 - координата Y, которая задаёт вторую контрольную точку CubicCurve2D

x2 - координата X, которая задаёт конечную точку CubicCurve2D

y2 - координата Y, которая задаёт конечную точку CubicCurve2D

Возвращает:

отклонение CubicCurve2D, представленной указанными координатами.

С момента:

1.2

getFlatnessSq

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

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

Параметры:

coords - массив, содержащий координаты

offset - индекс coords, с которого начинать получение конечных точек и контрольных точек кривой

Возвращает:

квадрат отклонения CubicCurve2D, заданной координатами в coords по указанному смещению.

С момента:

1.2

getFlatness

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

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

Параметры:

coords - массив, содержащий координаты

offset - индекс coords в массиве, с которого начинать извлечение конечных точек и контрольных точек кривой

Возвращает:

плоскостность CubicCurve2D , заданную координатами в coords в указанном смещении.

С:

1.2

getFlatnessSq

public double getFlatnessSq()

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

Возвращает:

квадрат плоскостности этой кривой.

С:

1.2

getFlatness

public double getFlatness()

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

Возвращает:

плоскостность этой кривой.

С:

1.2

subdivide

public void subdivide(CubicCurve2D left,
                      CubicCurve2D right)

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

Параметры:

left - объект кубической кривой для хранения левой или первой половины подразделенной кривой

right - объект кубической кривой для хранения правой или второй половины подразделенной кривой

С:

1.2

subdivide

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

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

Параметры:

src - кубическая кривая для деления

left - объект кубической кривой для хранения левой или первой половины подразделенной кривой

right - объект кубической кривой для хранения правой или второй половины подразделенной кривой

С:

1.2

subdivide

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), чтобы избежать выделения дополнительной памяти для этой общей точки.

Параметры:

src - массив, содержащий координаты исходной кривой

srcoff - смещение в массиве начала 6 исходных координат

left - массив для хранения координат первой половины подразделенной кривой

leftoff - смещение в массиве начала 6 левых координат

right - массив для хранения координат второй половины подразделенной кривой

rightoff - смещение в массиве начала 6 правых координат

С:

1.2

solveCubic

public static int solveCubic(double[] eqn)

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

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

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

Параметры:

eqn - массив, содержащий коэффициенты кубического уравнения

Возвращает:

количество корней или -1, если уравнение является постоянным.

С:

1.2

solveCubic

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, от уравнения, у которого нет нулей.

Параметры:

eqn - указанный массив коэффициентов для решения кубического уравнения

res - массив, содержащий некомплексные корни, полученные в результате решения кубического уравнения

Возвращает:

количество корней или -1, если уравнение является постоянным

С:

1.3

contains

public boolean contains(double x,
                        double y)

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

Определено в:

contains в интерфейсе Shape

Параметры:

x - указанная координата X для проверки

y - указанная координата Y для проверки

Возвращает:

true , если указанные координаты находятся внутри границы Shape; false в противном случае.

С:

1.2

contains

public boolean contains(Point2D p)

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

Определено в:

contains в интерфейсе Shape

Параметры:

p - указанная Point2D для проверки

Возвращает:

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

С:

1.2

intersects

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

Определено в:

intersects в интерфейсе Shape

Параметры:

x - координата X верхнего левого угла заданной прямоугольной области

y - координата Y верхнего левого угла заданной прямоугольной области

w - ширина заданной прямоугольной области

h - высота заданной прямоугольной области

Возвращает:

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

С:

1.2

См. также:

Area

intersects

public boolean intersects(Rectangle2D r)

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

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

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

Определено в:

intersects в интерфейсе Shape

Параметры:

r - заданный Rectangle2D

Возвращает:

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

С:

1.2

См. также:

Shape.intersects(double, double, double, double)

contains

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

Определено в:

contains в интерфейсе Shape

Параметры:

x - координата X левого верхнего угла указанной прямоугольной области

y - координата Y левого верхнего угла указанной прямоугольной области

w - ширина указанной прямоугольной области

h - высота указанной прямоугольной области

Возвращает:

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

С:

1.2

См. также:

Area, Shape.intersects(double, double, double, double)

contains

public boolean contains(Rectangle2D r)

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

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

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

Определено в:

contains в интерфейсе Shape

Параметры:

r - Указанная Rectangle2D

Возвращает:

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

С:

1.2

См. также:

Shape.contains(double, double, double, double)

getBounds

public Rectangle getBounds()

Определено в:

getBounds в интерфейсе Shape

Возвращает:

целочисленный Rectangle, полностью охватывающий Shape.

С:

1.2

См. также:

Shape.getBounds2D()

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

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

Определено в:

getPathIterator в интерфейсе Shape

Параметры:

at - необязательный AffineTransform, который должен быть применён к координатам, возвращаемым в итерации, или null если желаемы не преобразованные координаты

Возвращает:

объект PathIterator, возвращающий геометрию контура этого CubicCurve2D, по одному сегменту за раз.

С:

1.2

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)

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

Определено в:

getPathIterator в интерфейсе Shape

Параметры:

at - необязательный AffineTransform, который должен быть применён к координатам, возвращаемым в итерации, или null если желаемы не преобразованные координаты

flatness - максимальное отклонение от коллинеарности контрольных точек кривой, при котором кривая заменяется прямой линией, соединяющей конечные точки

Возвращает:

объект PathIterator, возвращающий геометрию контура этого CubicCurve2D, по одному сегменту за раз.

С:

1.2

clone

public Object clone()

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

Переопределяет:

clone в классе Object

Возвращает:

клон этого экземпляра.

Исключения:

OutOfMemoryError - если памяти недостаточно.

С:

1.2

См. также:

Cloneable