Класс BasicStroke

public class BasicStroke
extends Object
implements Stroke

Класс BasicStroke определяет базовый набор атрибутов отрисовки для контуров графических примитивов, которые отрисовываются с помощью объекта Graphics2D, у которого атрибут Stroke установлен на этот объект BasicStroke. Атрибуты отрисовки, определённые BasicStroke, описывают форму метки, создаваемой пером, проведенным по контуру Shape, и декорации, применяемые к концам и соединениям сегментов пути Shape. Эти атрибуты отрисовки включают:

толщина

Толщина пера, измеряемая перпендикулярно траектории пера.

заглушки

Декорация, применяемая к концам незамкнутых подпутей и сегментов пунктира. Подпути, которые начинаются и заканчиваются в одной точке, все еще считаются незамкнутыми, если у них нет сегмента CLOSE. Смотрите SEG_CLOSE для получения дополнительной информации о сегменте CLOSE. Три различных декорации: CAP_BUTT, CAP_ROUND и CAP_SQUARE.

соединения

Декорация, применяемая в точке пересечения двух сегментов пути и в точке пересечения конечных точек подпути, который закрыт с помощью SEG_CLOSE. Три различных декорации: JOIN_BEVEL, JOIN_MITER и JOIN_ROUND.

предел сжатия

Предел для обрезки соединения, имеющего декорацию JOIN_MITER. Соединение обрезается, когда отношение длины сжатия к ширине штриха больше значения miterlimit. Длина сжатия — это диагональная длина сжатия, равная расстоянию между внутренней и внешней вершинами пересечения. Чем меньше угол, образованный двумя сегментами линии, тем длиннее длина сжатия и острее угол пересечения. Значение митерлимита по умолчанию 10.0f приводит к обрезке всех углов меньше 11 градусов. Обрезка митер преобразует декорацию соединения в фаску.

атрибуты пунктира

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

Все атрибуты, определяющие измерения и расстояния, управляющие формой возвращаемого контура, измеряются в той же системе координат, что и исходный аргумент Shape. Когда объект Graphics2D использует объект Stroke для переопределения пути во время выполнения одного из его методов draw, геометрия предоставляется в исходной форме до применения атрибута трансформации Graphics2D. Следовательно, такие атрибуты, как ширина пера, интерпретируются в системе координат пространства пользователя объекта Graphics2D и подвержены масштабированию и сдвигу эффектов преобразования из пространства пользователя в пространство устройства в этом конкретном объекте Graphics2D. Например, ширина контура отрисованной фигуры определяется не только атрибутом ширины этого объекта BasicStroke, но и атрибутом преобразования объекта Graphics2D. Рассмотрим этот код:

// sets the Graphics2D object's Transform attribute
g2d.scale(10, 10);
// sets the Graphics2D object's Stroke attribute
g2d.setStroke(new BasicStroke(1.5f));

При условии, что к объекту Graphics2D не добавлены другие трансформации масштабирования, полученная линия будет примерно 15 пикселей в ширину. Как показывает пример кода, плавающая линия обеспечивает лучшую точность, особенно при использовании больших преобразований с объектом Graphics2D. Когда линия диагональная, точная ширина зависит от того, как отрисовка выбирает пиксели для заполнения при прослеживании теоретически расширенного контура. Выбор пикселей, которые нужно включить, зависит от атрибута сглаживания, поскольку pipeline сглаживания может выбрать цвет частично покрытых пикселей.

Дополнительную информацию о системе координат пространства пользователя и процессе отрисовки см. в комментариях к классу Graphics2D.