Класс FlatteningPathIterator

java.lang.Object

java.awt.geom.FlatteningPathIterator

Все реализуемые интерфейсы:: PathIterator

public class FlatteningPathIterator extends Object implements PathIterator

Класс FlatteningPathIterator возвращает уплощённый вид другого объекта PathIterator. Другие классы Shape могут использовать этот класс для обеспечения поведения уплощения для своих путей, без необходимости выполнения самих вычислений интерполяции.

Краткое описание полей

Поля, объявленные в интерфейсе java.awt.geom.PathIterator

SEG_CLOSE, SEG_CUBICTO, SEG_LINETO, SEG_MOVETO, SEG_QUADTO, WIND_EVEN_ODD, WIND_NON_ZERO

Краткое описание конструкторов

Конструктор	Описание
`FlatteningPathIterator(PathIterator src, double flatness)`	Создаёт новый объект `FlatteningPathIterator` , который уплощает путь во время итерации по нему.
`FlatteningPathIterator(PathIterator src, double flatness, int limit)`	Создаёт новый объект `FlatteningPathIterator` , который уплощает путь во время итерации по нему.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`currentSegment(double[] coords)`	Возвращает координаты и тип текущего сегмента пути в итерации.
`int`	`currentSegment(float[] coords)`	Возвращает координаты и тип текущего сегмента пути в итерации.
`double`	`getFlatness()`	Возвращает уплощение этого итератора.
`int`	`getRecursionLimit()`	Возвращает предел рекурсии этого итератора.
`int`	`getWindingRule()`	Возвращает правило обхода для определения внутренности пути.
`boolean`	`isDone()`	Проверяет, завершена ли итерация.
`void`	`next()`	Перемещает итератор к следующему сегменту пути вперёд по основному направлению обхода, пока есть больше точек в этом направлении.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

FlatteningPathIterator

public FlatteningPathIterator(PathIterator src, double flatness)

Создаёт новый объект FlatteningPathIterator , который уплощает путь во время итерации по нему. Итератор не делит ни одну кривую, считываемую из исходного итератора, более чем на 10 уровней подразделения, что даёт максимум 1024 линейных сегмента на кривую.

Параметры:: src - исходный неуплощённый путь, по которому выполняется итерация; flatness - максимальное допустимое расстояние между контрольными точками и уплощённой кривой

FlatteningPathIterator

public FlatteningPathIterator(PathIterator src, double flatness, int limit)

Создаёт новый объект FlatteningPathIterator , который уплощает путь во время итерации по нему. Параметр limit позволяет управлять максимальным числом рекурсивных подразделений, которые итератор может выполнить, прежде чем предположить, что кривая достаточно уплощена, не измеряя по параметру flatness. Поэтому уплощённая итерация никогда не генерирует более чем максимальное число (2^limit) линейных сегментов на кривую.

Параметры:: src - исходный неуплощённый путь, по которому выполняется итерация; flatness - максимальное допустимое расстояние между контрольными точками и уплощённой кривой; limit - максимальное количество рекурсивных подразделений, разрешённых для любого криволинейного сегмента
Исключения:: IllegalArgumentException - если flatness или limit меньше нуля

Подробное описание методов

getFlatness

public double getFlatness()

Возвращает уплощение этого итератора.

Возвращает:: уплощение этого FlatteningPathIterator.

getRecursionLimit

public int getRecursionLimit()

Возвращает предел рекурсии этого итератора.

Возвращает:: предел рекурсии этого FlatteningPathIterator.

getWindingRule

public int getWindingRule()

Возвращает правило обхода для определения внутренности пути.

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

getWindingRule в интерфейсе PathIterator

Возвращает:

правило обхода исходного неуплощённого пути, по которому выполняется итерация.

См. также:

isDone

public boolean isDone()

Проверяет, завершена ли итерация.

Определено в:: isDone в интерфейсе PathIterator
Возвращает:: true если все сегменты были прочитаны; false в противном случае.

public void next()

Перемещает итератор к следующему сегменту пути вперёд по основному направлению обхода, пока есть больше точек в этом направлении.

Определено в:: next в интерфейсе PathIterator

currentSegment

public int currentSegment(float[] coords)

Возвращает координаты и тип текущего сегмента пути в итерации. Возвращаемое значение — тип сегмента пути: SEG_MOVETO, SEG_LINETO или SEG_CLOSE. В качестве входного параметра необходимо передать массив float длиной 6, который может использоваться для хранения координат точки(точек). Каждая точка хранится как пара координат x, y типа float. Для типов SEG_MOVETO и SEG_LINETO возвращается одна точка, а SEG_CLOSE не возвращает никаких точек.

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

currentSegment в интерфейсе PathIterator

Параметры:

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

Возвращает:

тип сегмента пути текущего сегмента пути.

Исключения:

NoSuchElementException - если больше нет элементов в уплощённом пути, которые должны быть возвращены.

См. также:

currentSegment

public int currentSegment(double[] coords)

Возвращает координаты и тип текущего сегмента пути в итерации. Возвращаемое значение — тип сегмента пути: SEG_MOVETO, SEG_LINETO или SEG_CLOSE. В качестве входного параметра необходимо передать массив double длиной 6, который может использоваться для хранения координат точки(точек). Каждая точка хранится как пара координат x, y типа double. Для типов SEG_MOVETO и SEG_LINETO возвращается одна точка, а SEG_CLOSE не возвращает никаких точек.

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

currentSegment в интерфейсе PathIterator

Параметры:

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

Возвращает:

тип сегмента пути текущего сегмента пути.

Исключения:

NoSuchElementException - если больше нет элементов в уплощённом пути, которые должны быть возвращены.

См. также:

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/geom/FlatteningPathIterator.html