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

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

public double ptSegDist(double px, double py)

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

public double ptSegDist(Point2D pt)

Возвращает расстояние от точки до этого отрезка прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой между конечными точками текущей прямой. Если заданная точка пересекает отрезок прямой между конечными точками, этот метод возвращает 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)

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

public double ptLineDistSq(Point2D pt)

Возвращает квадрат расстояния от заданной точки до этой прямой. Измеренное расстояние — это расстояние между заданной точкой и ближайшей точкой на бесконечно продолженной прямой, определяемой этой прямой. Если заданная точка пересекает прямую, этот метод возвращает 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()

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