BasicStroke (Платформа Java SE 7)

java.lang. Объект
- java.awt. BasicStroke

Все Реализованные Интерфейсы:

Штрих
```
public class BasicStroke
extends Object
implements Stroke
```
BasicStroke класс определяет основной набор рендеринга атрибутов для схем графических примитивов, которые представляются с a Graphics2D объект, у которого есть его Штриховой набор атрибута к этому BasicStroke. Атрибуты рендеринга, определенные BasicStroke опишите форму метки, сделанной пером, оттянутым вдоль схемы a Shape и художественные оформления, примененные в концах и соединениях сегментов пути Shape. Эти атрибуты рендеринга включают:

ширина
Перьевая ширина, измеренная перпендикулярно к перьевой траектории.
заглушки
Художественное оформление, которому применяются к концы открытых подпутей и сегментов тире. Подпути, которые запускаются и заканчиваются на той же самой точке, все еще считают открытыми, если у них нет сегмента CLOSE. См. SEG_CLOSE для получения дополнительной информации о сегменте CLOSE. Три различных художественных оформления: CAP_BUTT, CAP_ROUND, и CAP_SQUARE.
соединения строки
Художественное оформление, примененное на пересечении двух сегментов пути и на пересечении конечных точек подпути, который закрывается, используя SEG_CLOSE. Три различных художественных оформления: JOIN_BEVEL, JOIN_MITER, и JOIN_ROUND.
предельный угол стыка
Предел, чтобы обрезать соединение строки, у которого есть художественное оформление JOIN_MITER. Соединение строки обрезается, когда отношение длины среза, чтобы перечеркнуть ширину больше чем значение miterlimit. Длина среза является диагональной длиной среза, который является расстоянием между внутренним углом и внешним углом пересечения. Чем меньший угол, сформированный двумя линейными сегментами, тем дольше длина среза и более резкое угол пересечения. Значение по умолчанию miterlimit значение 10.0f заставляет все углы меньше чем 11 градусов быть обрезанными. Обрезка срезов преобразовывает художественное оформление строки, соединяют со скосом.
атрибуты тире
Определение того, как сделать образец тире, чередуясь между непрозрачными и прозрачными разделами.
Все атрибуты, которые определяют измерения и расстояния, управляющие формой возвращенной схемы, измеряются в той же самой системе координат как неперечеркиваемый оригинал Shape параметр. Когда a Graphics2D возразите использует a Stroke объект пересмотреть путь во время выполнения одного из draw методы, геометрия предоставляется в ее исходной форме перед Graphics2D преобразуйте атрибут, применяется. Поэтому, атрибуты, такие как перьевая ширина интерпретируются в системе координат пространства пользователя Graphics2D возразите и подвергаются масштабированию, и сдвиг эффектов "пространства пользователя к пространству устройства" преобразовывают в ту деталь Graphics2D. Например, ширина схемы представленной формы определяется не только атрибутом ширины этого BasicStroke, но также и атрибутом преобразования Graphics2D объект. Рассмотрите этот код:
// sets the Graphics2D object's Tranform attribute g2d.scale(10, 10); // sets the Graphics2D object's Stroke attribute g2d.setStroke(new BasicStroke(1.5f));
Принятие там не является никакими другими преобразованиями масштабирования, добавленными к Graphics2D объект, получающаяся строка будет приблизительно 15 широкими пикселями. Поскольку пример кода демонстрирует, строка с плавающей точкой предлагает лучшую точность, особенно когда большой преобразования используются с a Graphics2D объект. Когда строка является диагональной, точная ширина зависит от того, как конвейер рендеринга выбирает, какие пиксели заполниться, поскольку это прослеживает теоретическую расширенную схему. Выбор которого на пиксели включить влияет сглаживающийся атрибут, потому что конвейер рендеринга сглаживания может хотеть красить частично покрытые пиксели.
Для получения дополнительной информации по системе координат пространства пользователя и процессу рендеринга, см. Graphics2D комментарии класса.

См. Также:
Graphics2D

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`CAP_BUTT` Концы открытые подпути и сегменты тире без добавленного художественного оформления.
`static int`	`CAP_ROUND` Открытые подпути концов и сегменты тире с круглым художественным оформлением, у которого есть радиус, равный половине ширины пера.
`static int`	`CAP_SQUARE` Открытые подпути концов и сегменты тире с квадратной проекцией, которая расширяется вне конца сегмента к расстоянию, равному половине ширины строки.
`static int`	`JOIN_BEVEL` Соединения соединяют сегменты каналом, соединяя внешние углы их широких схем с прямым сегментом.
`static int`	`JOIN_MITER` Соединения соединяют сегменты каналом, расширяя их внешние края, пока они не встречаются.
`static int`	`JOIN_ROUND` Соединения соединяют сегменты каналом, округляя угол в радиусе половины ширины строки.

Сводка конструктора

Конструкторы
Конструктор и Описание
`BasicStroke()` Создает новое `BasicStroke` со значениями по умолчанию для всех атрибутов.
`BasicStroke(float width)` Создает тело `BasicStroke` с указанной шириной строки и со значениями по умолчанию для прописной буквы и стилей соединения.
`BasicStroke(float width, int cap, int join)` Создает тело `BasicStroke` с указанными атрибутами.
`BasicStroke(float width, int cap, int join, float miterlimit)` Создает тело `BasicStroke` с указанными атрибутами.
`BasicStroke(float width, int cap, int join, float miterlimit, float[] dash, float dash_phase)` Создает новое `BasicStroke` с указанными атрибутами.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Форма`	`createStrokedShape(Shape s)` Возвраты a `Shape` чья внутренняя часть определяет перечеркиваемую схему указанного `Shape`.
`boolean`	`equals(Object obj)` Тесты, если указанный объект равен этому `BasicStroke` первым тестированием, если это - a `BasicStroke` и затем сравнивая его ширину, соединение, прописную букву, предельный угол стыка, тире, и фазу тире приписывает с таковыми из этого `BasicStroke`.
`float[]`	`getDashArray()` Возвращает массив, представляющий длины сегментов тире.
`float`	`getDashPhase()` Возвращает текущую фазу тире.
`int`	`getEndCap()` Возвращает стиль заглушки.
`int`	`getLineJoin()` Возвращает стиль соединения строки.
`float`	`getLineWidth()` Возвращает ширину строки.
`float`	`getMiterLimit()` Возвращает предел соединений среза.
`int`	`hashCode()` Возвращает хэш-код для этого штриха.

Методы java.lang унаследованный от класса. Объект
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - JOIN_MITER
```
public static final int JOIN_MITER
```
    Соединения соединяют сегменты каналом, расширяя их внешние края, пока они не встречаются.
    
    См. Также:
    Постоянные Значения полей
  - JOIN_ROUND
```
public static final int JOIN_ROUND
```
    Соединения соединяют сегменты каналом, округляя угол в радиусе половины ширины строки.
    
    См. Также:
    Постоянные Значения полей
  - JOIN_BEVEL
```
public static final int JOIN_BEVEL
```
    Соединения соединяют сегменты каналом, соединяя внешние углы их широких схем с прямым сегментом.
    
    См. Также:
    Постоянные Значения полей
  - CAP_BUTT
```
public static final int CAP_BUTT
```
    Концы открытые подпути и сегменты тире без добавленного художественного оформления.
    
    См. Также:
    Постоянные Значения полей
  - CAP_ROUND
```
public static final int CAP_ROUND
```
    Открытые подпути концов и сегменты тире с круглым художественным оформлением, у которого есть радиус, равный половине ширины пера.
    
    См. Также:
    Постоянные Значения полей
  - CAP_SQUARE
```
public static final int CAP_SQUARE
```
    Открытые подпути концов и сегменты тире с квадратной проекцией, которая расширяется вне конца сегмента к расстоянию, равному половине ширины строки.
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - BasicStroke
```
@ConstructorProperties(value={"lineWidth","endCap","lineJoin","miterLimit","dashArray","dashPhase"})
public BasicStroke(float width,
                                      int cap,
                                      int join,
                                      float miterlimit,
                                      float[] dash,
                                      float dash_phase)
```
    Создает новое BasicStroke с указанными атрибутами.
    
    Параметры:
    width - ширина этого BasicStroke. Ширина должна быть больше чем или равной 0.0f. Если ширина устанавливается в 0.0f, штрих представляется как самая тонкая строка для целевого устройства и установки подсказки сглаживания.
    cap - художественное оформление концов a BasicStroke
    join - художественное оформление применялось, где сегменты пути встречаются
    miterlimit - предел, чтобы обрезать соединение среза. miterlimit должен быть больше чем или равным 1.0f.
    dash - массив, представляющий образец подчеркивания штриховой линией
    dash_phase - смещение, чтобы запустить образец подчеркивания штриховой линией
    
    Броски:
    
    IllegalArgumentException - если width отрицательно
    
    IllegalArgumentException - если cap не или CAP_BUTT, CAP_ROUND или CAP_SQUARE
    
    IllegalArgumentException - если miterlimit меньше чем 1 и join JOIN_MITER
    
    IllegalArgumentException - если join не или JOIN_ROUND, JOIN_BEVEL, или JOIN_MITER
    
    IllegalArgumentException - если dash_phase отрицательно и dash не null
    
    IllegalArgumentException - если длина dash нуль
    
    IllegalArgumentException - если длины тире являются всем нулем.
  - BasicStroke
```
public BasicStroke(float width,
           int cap,
           int join,
           float miterlimit)
```
    Создает тело BasicStroke с указанными атрибутами.
    
    Параметры:
    width - ширина BasicStroke
    cap - художественное оформление концов a BasicStroke
    join - художественное оформление применялось, где сегменты пути встречаются
    miterlimit - предел, чтобы обрезать соединение среза
    
    Броски:
    
    IllegalArgumentException - если width отрицательно
    
    IllegalArgumentException - если cap не или CAP_BUTT, CAP_ROUND или CAP_SQUARE
    
    IllegalArgumentException - если miterlimit меньше чем 1 и join JOIN_MITER
    
    IllegalArgumentException - если join не или JOIN_ROUND, JOIN_BEVEL, или JOIN_MITER
  - BasicStroke
```
public BasicStroke(float width,
           int cap,
           int join)
```
    Создает тело BasicStroke с указанными атрибутами. miterlimit параметр является ненужным в случаях, где значение по умолчанию допустимо, или соединения строки не определяются как JOIN_MITER.
    
    Параметры:
    width - ширина BasicStroke
    cap - художественное оформление концов a BasicStroke
    join - художественное оформление применялось, где сегменты пути встречаются
    
    Броски:
    
    IllegalArgumentException - если width отрицательно
    
    IllegalArgumentException - если cap не или CAP_BUTT, CAP_ROUND или CAP_SQUARE
    
    IllegalArgumentException - если join не или JOIN_ROUND, JOIN_BEVEL, или JOIN_MITER
  - BasicStroke
```
public BasicStroke(float width)
```
    Создает тело BasicStroke с указанной шириной строки и со значениями по умолчанию для прописной буквы и стилей соединения.
    
    Параметры:
    width - ширина BasicStroke
    
    Броски:
    
    IllegalArgumentException - если width отрицательно
  - BasicStroke
```
public BasicStroke()
```
    Создает новое BasicStroke со значениями по умолчанию для всех атрибутов. Атрибуты по умолчанию являются сплошной линией ширины 1.0, CAP_SQUARE, JOIN_MITER, предельного угла стыка 10.0.
- Деталь метода
  - createStrokedShape
```
public Shape createStrokedShape(Shape s)
```
    Возвраты a Shape чья внутренняя часть определяет перечеркиваемую схему указанного Shape.
    
    Определенный:
    
    createStrokedShape в интерфейсе Stroke
    
    Параметры:
    s - Shape граница перечеркнуться
    
    Возвраты:
    Shape из перечеркиваемой схемы.
  - getLineWidth
```
public float getLineWidth()
```
    Возвращает ширину строки. Ширина строки представляется в пространстве пользователя, которое является координатным пространством по умолчанию, используемым 2-D Java. См. Graphics2D класс комментирует для получения дополнительной информации о системе координат пространства пользователя.
    
    Возвраты:
    ширина строки этого BasicStroke.
    См. Также:
    Graphics2D
  - getEndCap
```
public int getEndCap()
```
    Возвращает стиль заглушки.
    
    Возвраты:
    стиль заглушки этого BasicStroke как одни из помех int значения, которые определяют возможные стили заглушки.
  - getLineJoin
```
public int getLineJoin()
```
    Возвращает стиль соединения строки.
    
    Возвраты:
    стиль соединения строки BasicStroke как одни из помех int значения, которые определяют возможные стили соединения строки.
  - getMiterLimit
```
public float getMiterLimit()
```
    Возвращает предел соединений среза.
    
    Возвраты:
    предел соединений среза BasicStroke.
  - getDashArray
```
public float[] getDashArray()
```
    Возвращает массив, представляющий длины сегментов тире. Альтернативные записи в массиве представляют длины пространства пользователя непрозрачных и прозрачных сегментов тире. Поскольку перо проходит схема Shape чтобы перечеркнуться, расстояние пространства пользователя, что перо перемещается, накапливается. Значение расстояния используется, чтобы индексировать в массив тире. Перо непрозрачно, когда его текущее совокупное расстояние отображается на даже элемент массива тире и прозрачный иначе.
    
    Возвраты:
    массив тире.
  - getDashPhase
```
public float getDashPhase()
```
    Возвращает текущую фазу тире. Фаза тире является расстоянием, определенным в пользовательских координатах, который представляет смещение в образец подчеркивания штриховой линией. Другими словами фаза тире определяет точку в образце подчеркивания штриховой линией, который будет соответствовать началу штриха.
    
    Возвраты:
    фаза тире как a float значение.
  - хэш-код
```
public int hashCode()
```
    Возвращает хэш-код для этого штриха.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    хэш-код для этого штриха.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - равняется
```
public boolean equals(Object obj)
```
    Тесты, если указанный объект равен этому BasicStroke первым тестированием, если это - a BasicStroke и затем сравнивая его ширину, соединение, прописную букву, предельный угол стыка, тире, и фазу тире приписывает с таковыми из этого BasicStroke.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    obj - указанный объект сравниться с этим BasicStroke
    
    Возвраты:
    true если ширина, соединение, прописная буква, предельный угол стыка, тире, и фаза тире являются тем же самым для обоих объектов; false иначе.
    См. Также:
    Object.hashCode(), HashMap

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BasicStroke

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

JOIN_MITER

JOIN_ROUND

JOIN_BEVEL

CAP_BUTT

CAP_ROUND

CAP_SQUARE

Деталь конструктора

BasicStroke

BasicStroke

BasicStroke

BasicStroke

BasicStroke

Деталь метода

createStrokedShape

getLineWidth

getEndCap

getLineJoin

getMiterLimit

getDashArray

getDashPhase

хэш-код

равняется