Класс QuadCurve2D

protected QuadCurve2D()

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

public abstract double getX1()

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

public abstract double getY1()

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

public abstract Point2D getP1()

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

public abstract double getCtrlX()

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

public abstract double getCtrlY()

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

public abstract Point2D getCtrlPt()

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

public abstract double getX2()

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

public abstract double getY2()

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

public abstract Point2D getP2()

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

public abstract void setCurve(double x1, double y1, double ctrlx, double ctrly, double x2, double y2)

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

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

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

public void setCurve(Point2D p1, Point2D cp, Point2D p2)

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

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

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

public void setCurve(QuadCurve2D c)

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

public static double getFlatnessSq(double x1, double y1, double ctrlx, double ctrly, double x2, double y2)

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

public static double getFlatness(double x1, double y1, double ctrlx, double ctrly, double x2, double y2)

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

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

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

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

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

public double getFlatnessSq()

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

public double getFlatness()

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

public void subdivide(QuadCurve2D left, QuadCurve2D right)

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

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

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

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

Делит квадратную кривую, заданную координатами, хранящимися в массиве src по индексам srcoff до srcoff + 5, и сохраняет полученные две разделенные кривые в двух массивах результатов по соответствующим индексам. Любой или оба массива left и right могут быть null или ссылкой на тот же массив и смещение, что и массив src. Обратите внимание, что последняя точка в первой разделенной кривой совпадает с первой точкой во второй разделенной кривой. Таким образом, можно передать один и тот же массив для left и right и использовать смещения таким образом, чтобы rightoff равнялось leftoff + 4, чтобы избежать выделения дополнительного хранилища для этой общей точки.

public static int solveQuadratic(double[] eqn)

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

     eqn = {C, B, A};
     ax^2 + bx + c = 0
 

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

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

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

     eqn = {C, B, A};
     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)

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

public PathIterator getPathIterator(AffineTransform at, double flatness)

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

public Object clone()

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