Класс Line2D

public abstract class Line2D
extends Object
implements Shape, Cloneable

Этот Line2D представляет отрезок прямой в (x,y) системе координат. Этот класс, как и все API Java 2D, использует стандартную систему координат, называемую пространством пользователя, в которой значения оси y увеличиваются вниз, а значения оси x увеличиваются вправо. Более подробную информацию о системе координат пространства пользователя см. в разделе «Системы координат» руководства разработчика Java 2D по адресу Coordinate Systems.

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

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

Line2D

protected Line2D()

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

С момента:

1.2

См. также:

Line2D.Float, Line2D.Double

Методы

getX1

public abstract double getX1()

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

Возвращает:

координату X начальной точки этого Line2D объекта.

С момента:

1.2

getY1

public abstract double getY1()

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

Возвращает:

координату Y начальной точки этого Line2D объекта.

С момента:

1.2

getP1

public abstract Point2D getP1()

Возвращает начальную Point2D этого Line2D.

Возвращает:

начальную Point2D этого Line2D.

С момента:

1.2

getX2

public abstract double getX2()

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

Возвращает:

координату X конечной точки этого Line2D объекта.

С момента:

1.2

getY2

public abstract double getY2()

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

Возвращает:

координату Y конечной точки этого Line2D объекта.

С момента:

1.2

getP2

public abstract Point2D getP2()

Возвращает конечную Point2D этого Line2D.

Возвращает:

конечную Point2D этого Line2D.

С момента:

1.2

setLine

public abstract void setLine(double x1,
                             double y1,
                             double x2,
                             double y2)

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

Параметры:

x1 - координата X начальной точки

y1 - координата Y начальной точки

x2 - координата X конечной точки

y2 - координата Y конечной точки

С момента:

1.2

setLine

public void setLine(Point2D p1,
                    Point2D p2)

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

Параметры:

p1 - начальная Point2D отрезка прямой

p2 - конечная Point2D отрезка прямой

С момента:

1.2

setLine

public void setLine(Line2D l)

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

Параметры:

l - указанный Line2D

С момента:

1.2

relativeCCW

public static int relativeCCW(double x1,
                              double y1,
                              double x2,
                              double y2,
                              double px,
                              double py)

Параметры:

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

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

x2 - координата X конечной точки указанного отрезка прямой

y2 - координата Y конечной точки указанного отрезка прямой

px - координата X указанной точки для сравнения с указанным отрезком прямой

py - координата Y указанной точки для сравнения с указанным отрезком прямой

Возвращает:

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

С момента:

1.2

relativeCCW

public int relativeCCW(double px,
                       double py)

Возвращает индикатор, где указанная точка (px,py) расположена относительно этого отрезка прямой. Обратитесь к комментариям к методу relativeCCW(double, double, double, double, double, double), чтобы интерпретировать возвращаемое значение.

Параметры:

px - координата X указанной точки для сравнения с этим Line2D

py - координата Y указанной точки для сравнения с этим Line2D

Возвращает:

целое число, которое указывает положение указанных координат относительно этого Line2D

С момента:

1.2

См. также:

relativeCCW(double, double, double, double, double, double)

relativeCCW

public int relativeCCW(Point2D p)

Возвращает индикатор, где указанная Point2D расположена относительно этого отрезка прямой. Обратитесь к комментариям к методу relativeCCW(double, double, double, double, double, double), чтобы интерпретировать возвращаемое значение.

Параметры:

p - указанная Point2D для сравнения с этим Line2D

Возвращает:

целое число, которое указывает положение указанной Point2D относительно этого Line2D

С момента:

1.2

См. также:

relativeCCW(double, double, double, double, double, double)

linesIntersect

public static boolean linesIntersect(double x1,
                                     double y1,
                                     double x2,
                                     double y2,
                                     double x3,
                                     double y3,
                                     double x4,
                                     double y4)

Проверяет, пересекается ли отрезок прямой от (x1,y1) до (x2,y2) с отрезком прямой от (x3,y3) до (x4,y4).

Параметры:

x1 - координата X начальной точки первого отрезка прямой

y1 - координата Y начальной точки первого отрезка прямой

x2 - координата X конечной точки первого отрезка прямой

y2 - координата Y конечной точки первого отрезка прямой

x3 - координата X начальной точки второго отрезка прямой

y3 - координата Y начальной точки второго отрезка прямой

x4 - координата X конечной точки второго отрезка прямой

y4 - координата Y конечной точки второго отрезка прямой

Возвращает:

true если первый отрезок прямой и второй отрезок прямой пересекаются; false в противном случае.

С момента:

1.2

intersectsLine

public boolean intersectsLine(double x1,
                              double y1,
                              double x2,
                              double y2)

Проверяет, пересекается ли отрезок прямой от (x1,y1) до (x2,y2) с этим отрезком прямой.

Параметры:

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

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

x2 - координата X конечной точки указанного отрезка прямой

y2 - координата Y конечной точки указанного отрезка прямой

Возвращает:

<true> если этот отрезок прямой и указанный отрезок прямой пересекаются; false в противном случае.

С момента:

1.2

intersectsLine

public boolean intersectsLine(Line2D l)

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

Параметры:

l - указанный Line2D

Возвращает:

true если этот отрезок прямой и указанный отрезок прямой пересекаются; false в противном случае.

С момента:

1.2

ptSegDistSq

public static double ptSegDistSq(double x1,
                                 double y1,
                                 double x2,
                                 double y2,
                                 double px,
                                 double py)

Возвращает квадрат расстояния от точки до отрезка прямой. Измеряемое расстояние — это расстояние между указанной точкой и ближайшей точкой между указанными конечными точками. Если указанная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 0,0.

Параметры:

x1 - координата X начальной точки заданного отрезка прямой

y1 - координата Y начальной точки заданного отрезка прямой

x2 - координата X конечной точки заданного отрезка прямой

y2 - координата Y конечной точки заданного отрезка прямой

px - координата X заданной точки, относительно которой измеряется расстояние до заданного отрезка прямой

py - координата Y заданной точки, относительно которой измеряется расстояние до заданного отрезка прямой

Возвращает:

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

С момента:

1.2

См. также:

ptLineDistSq(double, double, double, double, double, double)

ptSegDist

public static double ptSegDist(double x1,
                               double y1,
                               double x2,
                               double y2,
                               double px,
                               double py)

Возвращает расстояние от точки до отрезка прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой между заданными конечными точками. Если заданная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 0,0.

Параметры:

x1 - координата X начальной точки заданного отрезка прямой

y1 - координата Y начальной точки заданного отрезка прямой

x2 - координата X конечной точки заданного отрезка прямой

y2 - координата Y конечной точки заданного отрезка прямой

px - координата X заданной точки, относительно которой измеряется расстояние до заданного отрезка прямой

py - координата Y заданной точки, относительно которой измеряется расстояние до заданного отрезка прямой

Возвращает:

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

С момента:

1.2

См. также:

ptLineDist(double, double, double, double, double, double)

ptSegDistSq

public double ptSegDistSq(double px,
                          double py)

Возвращает квадрат расстояния от точки до текущего отрезка прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой между конечными точками текущей прямой. Если заданная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 0,0.

Параметры:

px - координата X заданной точки, относительно которой измеряется расстояние до текущего отрезка прямой

py - координата Y заданной точки, относительно которой измеряется расстояние до текущего отрезка прямой

Возвращает:

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

С момента:

1.2

См. также:

ptLineDistSq(double, double)

ptSegDistSq

public double ptSegDistSq(Point2D pt)

Возвращает квадрат расстояния от точки до этого отрезка прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой между конечными точками текущей прямой. Если заданная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 0,0.

Параметры:

pt - заданная точка, относительно которой измеряется расстояние до этого отрезка прямой.

Возвращает:

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

С момента:

1.2

См. также:

ptLineDistSq(Point2D)

ptSegDist

public double ptSegDist(double px,
                        double py)

Возвращает расстояние от точки до этого отрезка прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой между конечными точками текущей прямой. Если заданная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 0,0.

Параметры:

px - координата X заданной точки, относительно которой измеряется расстояние до текущего отрезка прямой

py - координата Y заданной точки, относительно которой измеряется расстояние до текущего отрезка прямой

Возвращает:

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

С момента:

1.2

См. также:

ptLineDist(double, double)

ptSegDist

public double ptSegDist(Point2D pt)

Возвращает расстояние от точки до этого отрезка прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой между конечными точками текущей прямой. Если заданная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 0,0.

Параметры:

pt - заданная точка, относительно которой измеряется расстояние до этого отрезка прямой

Возвращает:

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

С момента:

1.2

См. также:

ptLineDist(Point2D)

ptLineDistSq

public static double ptLineDistSq(double x1,
                                  double y1,
                                  double x2,
                                  double y2,
                                  double px,
                                  double py)

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

Параметры:

x1 - координата X начальной точки заданной прямой

y1 - координата Y начальной точки заданной прямой

x2 - координата X конечной точки заданной прямой

y2 - координата Y конечной точки заданной прямой

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

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

Возвращает:

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

С момента:

1.2

См. также:

ptSegDistSq(double, double, double, double, double, double)

ptLineDist

public static double ptLineDist(double x1,
                                double y1,
                                double x2,
                                double y2,
                                double px,
                                double py)

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

Параметры:

x1 - координата X начальной точки заданной прямой

y1 - координата Y начальной точки заданной прямой

x2 - координата X конечной точки заданной прямой

y2 - координата Y конечной точки заданной прямой

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

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

Возвращает:

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

С момента:

1.2

См. также:

ptSegDist(double, double, double, double, double, double)

ptLineDistSq

public double ptLineDistSq(double px,
                           double py)

Возвращает квадрат расстояния от точки до этой прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой на бесконечно продолженной прямой, определенной этой Line2D. Если заданная точка пересекает прямую, этот метод возвращает 0,0.

Параметры:

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

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

Возвращает:

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

С момента:

1.2

См. также:

ptSegDistSq(double, double)

ptLineDistSq

public double ptLineDistSq(Point2D pt)

Возвращает квадрат расстояния от заданной точки до этой прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой на бесконечно продолженной прямой, определенной этой Line2D. Если заданная точка пересекает прямую, этот метод возвращает 0,0.

Параметры:

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

Возвращает:

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

С момента:

1.2

См. также:

ptSegDistSq(Point2D)

ptLineDist

public double ptLineDist(double px,
                         double py)

Возвращает расстояние от точки до этой прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой на бесконечно продолженной прямой, определенной этой Line2D. Если заданная точка пересекает прямую, этот метод возвращает 0,0.

Параметры:

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

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

Возвращает:

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

С момента:

1.2

См. также:

ptSegDist(double, double)

ptLineDist

public double ptLineDist(Point2D pt)

Возвращает расстояние от точки до этой прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой на бесконечно продолженной прямой, определенной этой Line2D. Если заданная точка пересекает прямую, этот метод возвращает 0,0.

Параметры:

pt - заданная точка, относительно которой измеряется расстояние

Возвращает:

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

С момента:

1.2

См. также:

ptSegDist(Point2D)

contains

public boolean contains(double x,
                        double y)

Проверяет, находится ли указанная координата внутри границ этой Line2D. Этот метод требуется для реализации интерфейса Shape, но в случае объектов Line2D он всегда возвращает false, поскольку прямая не имеет площади.

Указано в:

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

Параметры:

x - координата X проверяемой точки

y - координата Y проверяемой точки

Возвращает:

false потому что Line2D не имеет площади.

С:

1.2

contains

public boolean contains(Point2D p)

Проверяет, находится ли заданная Point2D внутри границ этой Line2D. Этот метод требуется для реализации интерфейса Shape, но в случае объектов Line2D он всегда возвращает false, поскольку прямая не имеет площади.

Указано в:

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

Параметры:

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

Возвращает:

false потому что Line2D не имеет площади.

С:

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)

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

Указано в:

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

Параметры:

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

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

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

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

Возвращает:

false потому что Line2D не имеет площади.

С:

1.2

См. также:

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

contains

public boolean contains(Rectangle2D r)

Проверяет, полностью ли внутренняя часть этой Line2D содержит указанный Rectangle2D. Этот метод требуется для реализации интерфейса Shape, но в случае объектов Line2D он всегда возвращает false, так как прямая не имеет площади.

Указано в:

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

Параметры:

r - указанный Rectangle2D для проверки

Возвращает:

false потому что Line2D не имеет площади.

С:

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)

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

Указано в:

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

Параметры:

at - указанный AffineTransform

Возвращает:

a PathIterator , определяющий границу этого Line2D.

С:

1.2

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)

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

Указано в:

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

Параметры:

at - указанный AffineTransform

flatness - максимальное отклонение от коллинеарности контрольных точек кривой, после которого кривая разбивается на прямую, соединяющую конечные точки. Так как объект Line2D всегда сглаженный, этот параметр игнорируется.

Возвращает:

a PathIterator , определяющий границу сглаженного Line2D

С:

1.2

clone

public Object clone()

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

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

clone в классе Object

Возвращает:

клонированный экземпляр.

Исключение:

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

С момента:

1.2

См. также:

Cloneable