Класс Line2D

protected Line2D()

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

public abstract double getX1()

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

public abstract double getY1()

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

public abstract Point2D getP1()

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

public abstract double getX2()

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

public abstract double getY2()

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

public abstract Point2D getP2()

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

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

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

public void setLine(Point2D p1, Point2D p2)

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

public void setLine(Line2D l)

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

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

Возвращает индикатор положения указанной точки (px,py) относительно отрезка прямой от (x1,y1) до (x2,y2). Возвращаемое значение может быть 1, -1 или 0 и указывает направление, в котором нужно повернуть указанную прямую вокруг её первой точки, (x1,y1), чтобы она указывала на указанную точку (px,py).

Возвращаемое значение 1 указывает, что отрезок прямой должен повернуться в направлении, в котором положительная ось X направлена к отрицательной оси Y. В стандартной системе координат, используемой Java 2D, это направление против часовой стрелки.

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

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

Если точка коллинеарна отрезку прямой, но не лежит между конечными точками, то значение будет -1, если точка лежит «за (x1,y1)», или 1, если точка лежит «за (x2,y2)».

public int relativeCCW(double px, double py)

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

public int relativeCCW(Point2D p)

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

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

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

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

public boolean intersectsLine(Line2D l)

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

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

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

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

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

public double ptSegDistSq(double px, double py)

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

public double ptSegDistSq(Point2D pt)

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

public double ptSegDist(double px, double py)

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

public double ptSegDist(Point2D pt)

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

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

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

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

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

public double ptLineDistSq(double px, double py)

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

public double ptLineDistSq(Point2D pt)

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

public double ptLineDist(double px, double py)

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

public double ptLineDist(Point2D pt)

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

public boolean contains(double x, double y)

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

public boolean contains(Point2D p)

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

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)

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

public boolean contains(Rectangle2D r)

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

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)

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

public PathIterator getPathIterator(AffineTransform at, double flatness)

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

public Object clone()

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