BasicStroke (Java Platform SE 8 )

java.lang.Object
- java.awt.BasicStroke

All Implemented Interfaces:

Stroke
```
public class BasicStroke
extends Object
implements Stroke
```
的 BasicStroke类定义为图形元素的轮廓渲染属性的基本设置，呈现一 Graphics2D对象有其笔画属性设置为该 BasicStroke。渲染属性定义的 BasicStroke描述用钢笔绘制沿一个 Shape和装饰应用轮廓两端和 Shape路径段的加入使标志的形状。这些属性包括：

空宽度

笔的宽度，测量垂直于笔的轨迹。

空弹簧盒盖

装饰应用于闭合的子路径冲段的两端。子路径，在同一点的开始和结束都还没有考虑近段不。看到在近段的更多信息 SEG_CLOSE。三种不同的装饰： CAP_BUTT， CAP_ROUND，和 CAP_SQUARE。

空线连接

在两个路径段相交在一个子路径是封闭使用 SEG_CLOSE端点相交的装饰应用。三种不同的装饰： JOIN_BEVEL， JOIN_MITER，和 JOIN_ROUND。

空尖角限量

装饰线的加入，有join_miter装修极限。一条线连接修剪当斜接长度与笔划宽度的比值大于miterlimit价值。斜接长度是人字的对角线的长度，这是里面的角落和路口弯道外侧之间的距离。以两线段的夹角较小，较长的斜接长度和锐夹角。对10.0f默认miterlimit值导致所有角度小于11度的修剪。修剪成转换线装饰加入锥。

空短跑的属性

如何通过不透明和透明的部分交替进行划线模式的定义。

渲染所有属性指定的测量和距离控制返回的轮廓形状的测量在同一坐标系统作为原unstroked 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对象。当一条对角线是对角线时，精确的宽度取决于渲染管线如何选择哪个像素来填充，因为它可以追溯到理论加宽的轮廓。选择象素打开受抗锯齿属性因为抗锯齿渲染管线，可以选择部分覆盖的像素的颜色。
在用户空间坐标系统和渲染过程的更多信息，见Graphics2D类注释。

另请参见：

Graphics2D

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CAP_BUTT` 端未闭合的子路径冲段没有添加装饰。
`static int`	`CAP_ROUND` 端未闭合的子路径冲段与圆形装饰，有一个半径相等的钢笔宽度的一半。
`static int`	`CAP_SQUARE` 端未闭合的子路径冲段方形投影延伸段距离相等的线宽度一半的结束。
`static int`	`JOIN_BEVEL` 连接路径段通过连接其宽轮廓的外角与一个直线段。
`static int`	`JOIN_MITER` 通过将它们的外部边缘延伸，直到它们满足的路径段连接。
`static int`	`JOIN_ROUND` 通过在一个行宽的半径圆角处的圆角连接路径段。

构造方法摘要

构造方法
Constructor and Description
`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`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Shape`	`createStrokedShape(Shape s)` 返回一个 `Shape`其内部定义的抚摸轮廓指定 `Shape`。
`boolean`	`equals(Object obj)` 如果一个测试指定的对象是否等于这 `BasicStroke`首先通过测试它是否是一个 `BasicStroke`然后比较其宽度、加入、帽、斜接限制，短跑，并与这 `BasicStroke`冲刺阶段属性。
`float[]`	`getDashArray()` 返回表示虚线段的长度的数组。
`float`	`getDashPhase()` 返回当前的冲刺阶段。
`int`	`getEndCap()` 返回结束盖样式。
`int`	`getLineJoin()` 返回行连接样式。
`float`	`getLineWidth()` 返回行的宽度。
`float`	`getMiterLimit()` 返回斜接限制加入。
`int`	`hashCode()` 返回此行程hashCode。

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - JOIN_MITER
```
@Native
public static final int JOIN_MITER
```
    通过将它们的外部边缘延伸，直到它们满足的路径段连接。
    
    另请参见：
    
    Constant Field Values
  - JOIN_ROUND
```
@Native
public static final int JOIN_ROUND
```
    通过在一个行宽的半径圆角处的圆角连接路径段。
    
    另请参见：
    
    Constant Field Values
  - JOIN_BEVEL
```
@Native
public static final int JOIN_BEVEL
```
    连接路径段通过连接其宽轮廓的外角与一个直线段。
    
    另请参见：
    
    Constant Field Values
  - CAP_BUTT
```
@Native
public static final int CAP_BUTT
```
    端未闭合的子路径冲段没有添加装饰。
    
    另请参见：
    
    Constant Field Values
  - CAP_ROUND
```
@Native
public static final int CAP_ROUND
```
    端未闭合的子路径冲段与圆形装饰，有一个半径相等的钢笔宽度的一半。
    
    另请参见：
    
    Constant Field Values
  - CAP_SQUARE
```
@Native
public static final int CAP_SQUARE
```
    端未闭合的子路径冲段方形投影延伸段距离相等的线宽度一半的结束。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - 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 -一个 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 -一个 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 -一个 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，cap_square，join_miter，10个斜接限制。
- 方法详细信息
  - createStrokedShape
```
public Shape createStrokedShape(Shape s)
```
    返回一个 Shape其内部定义的抚摸轮廓指定 Shape。
    
    Specified by:
    
    createStrokedShape 接口 Stroke
    
    参数
    
    s - Shape边抚摸
    
    结果
    
    概述 Shape的抚摸。
  - getLineWidth
```
public float getLineWidth()
```
    返回行的宽度。线的宽度是在用户空间中的代表，这是由java 2D使用了默认的坐标空间，看到在用户空间坐标系统的更多信息， 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()
```
    返回当前的冲刺阶段。冲刺阶段是一个远程用户坐标表示的偏移到时髦的模式指定。换句话说，冲刺阶段定义在汹涌的模式，将对应的行程的起点。
    
    结果
    
    冲刺阶段作为一个 float价值。
  - hashCode
```
public int hashCode()
```
    返回此行程hashCode。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此行程的哈希代码。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    如果一个测试指定的对象是否等于这 BasicStroke首先通过测试它是否是一个 BasicStroke然后比较其宽度、加入、帽、斜接限制，短跑，并与这 BasicStroke冲刺阶段属性。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -指定的对象来比较这 BasicStroke
    
    结果
    
    true如果宽度、加入、帽、斜接限制，冲，冲相位是相同的两个对象； false否则。
    
    另请参见：
    
    Object.hashCode()， HashMap

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class BasicStroke

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

JOIN_MITER

JOIN_ROUND

JOIN_BEVEL

CAP_BUTT

CAP_ROUND

CAP_SQUARE

Constructor Detail

BasicStroke

BasicStroke

BasicStroke

BasicStroke

BasicStroke

方法详细信息

createStrokedShape

getLineWidth

getEndCap

getLineJoin

getMiterLimit

getDashArray

getDashPhase

hashCode

equals