java.awt
类 BasicStroke

java.lang.Object
  java.awt.BasicStroke

所有已实现的接口：

Stroke

public class BasicStroke
extends Object
implements Stroke

BasicStroke 类定义针对图形图元轮廓呈现属性的一个基本集合，这些图元使用 Graphics2D 对象呈现，而该对象的 Stroke 属性设置为此 BasicStroke。由 BasicStroke 定义的呈现属性描述了用画笔沿 Shape 的轮廓绘制的某个标记的形状，以及应用在 Shape 路径线段的末端和连接处的装饰。 这些呈现属性包括：

width

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

end caps

在未封闭子路径和虚线线段的末端应用的一些装饰。如果子路径没有 CLOSE 段，则在同一点上开始和结束的子路径仍被认为是未封闭的。关于 CLOSE 段的更多信息，请参阅 SEG_CLOSE。三个不同的装饰是：CAP_BUTT、CAP_ROUND 和 CAP_SQUARE。

line joins

在两个路径线段的交汇处，以及使用 SEG_CLOSE 封闭的子路径端点的交汇处应用的装饰。三个不同的装饰是：JOIN_BEVEL、JOIN_MITER 和 JOIN_ROUND。

miter limit

对剪裁具有 JOIN_MITER 装饰的线接合点的限制。当斜接长度与笔划宽度的比大于 miterlimit 值时，需要剪裁线接合点。斜接长度是斜接的对角线长度，即交汇处的内棱角和外棱角之间的距离。两条线段形成的角度越小，斜接长度就越长，交汇处的角度就越尖锐。默认 miterlimit 值为 10.0f，它会使所有小于 11 度的角都被剪裁。剪裁斜接会使线接合点的装饰变成斜角。

dash attributes

关于如何通过在不透明和透明部分之间交替形成一个虚线模式的定义。

// 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 类的注释。

另请参见：

Graphics2D

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

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 - 如果所有 dash 的长度都为零。

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。在允许使用默认值或线连接点未指定为 JOIN_MITER 的情况下，不需要 miterlimit 参数。

参数：

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)

构造一个具有指定线条宽度以及 cap 和 join 风格的默认值的实心 BasicStroke。

参数：

width - BasicStroke 的宽度

抛出：

IllegalArgumentException - 如果 width 为负

BasicStroke

public BasicStroke()

构造一个具有所有属性的默认值的新 BasicStroke。默认属性是宽度为 1.0 的实线、CAP_SQUARE、JOIN_MITER 和 10.0 的斜接限制。

createStrokedShape

public Shape createStrokedShape(Shape s)

返回一个 Shape，它在内部定义了指定 Shape 的笔划轮廓。

指定者：

接口 Stroke 中的 createStrokedShape

参数：

s - 要勾画的 Shape 边界

返回：

勾画了轮廓的 Shape。

getLineWidth

public float getLineWidth()

返回线条的宽度。线条的宽度是在用户空间中表示的，此空间是 Java 2D 使用的默认坐标空间。关于用户空间坐标系的更多信息，请参阅 Graphics2D 类的注释。

返回：

此 BasicStroke 的线条宽度。

另请参见：

Graphics2D

getEndCap

public int getEndCap()

返回端点的 cap 样式。

返回：

此 BasicStroke 端点的 cap 样式，它是定义可能的端点 cap 样式的静态 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()

返回此笔划的哈希码。

覆盖：

类 Object 中的 hashCode

返回：

此笔划的哈希码。

另请参见：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

测试指定对象与此 BasicStroke 是否相等，首先测试指定对象是否是一个 BasicStroke，然后将其宽度、连接、cap、斜接限制、虚线和虚线相位属性与 BasicStroke 的那些属性进行比较。

覆盖：

类 Object 中的 equals

参数：

obj - 与此 BasicStroke 进行比较的指定对象

返回：

如果两个对象的宽度、连接、cap、斜接限制、虚线和虚线相位相同，则返回 true；否则返回 false。

另请参见：

Object.hashCode(), Hashtable

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。