java.awt.geom

クラス Path2D.Float

java.lang.Object

java.awt.geom.Path2D

java.awt.geom.Path2D.Float

すべての実装されたインタフェース:

Shape、Serializable、Cloneable

直系の既知のサブクラス:

GeneralPath

含まれているクラス:

Path2D

public static class Path2D.Float
extends Path2D
implements Serializable

Float クラスは、座標が単精度浮動小数点で格納される幾何学的パスを定義します。

導入されたバージョン:

1.6

関連項目:

直列化された形式

ネストされたクラスのサマリー

クラス java.awt.geom.Path2D から継承されたネストされたクラス/インタフェース

Path2D.Double, Path2D.Float

フィールドのサマリー

クラス java.awt.geom.Path2D から継承されたフィールド

WIND_EVEN_ODD, WIND_NON_ZERO

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Path2D.Float() Path2D.WIND_NON_ZERO のデフォルトの屈曲規則を使用して、新しい空の単精度 Path2D オブジェクトを構築します。
Path2D.Float(int rule) パスの内部を定義する必要があるオペレーションを制御するために、指定された屈曲規則を指定して、新しい空の単精度 Path2D オブジェクトを構築します。
Path2D.Float(int rule, int initialCapacity) 指定された屈曲規則、およびパスセグメントを格納する指定された初期容量を指定して、新しい空の単精度 Path2D オブジェクトを構築します。
Path2D.Float(Shape s) 任意の Shape オブジェクトから、新しい単精度 Path2D を構築します。
Path2D.Float(Shape s, AffineTransform at) AffineTransform オブジェクトによって変換される、任意の Shape オブジェクトから新しい単精度 Path2D オブジェクトを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	append(PathIterator pi, boolean connect) 指定された PathIterator オブジェクトの幾何学的図形をパスに追加します。その新しい幾何学的図形をラインセグメントで既存のパスセグメントに接続することも可能です。
Object	clone() このオブジェクトと同じクラスの新しいオブジェクトを作成します。
void	curveTo(double x1, double y1, double x2, double y2, double x3, double y3) 3 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) と点 (x2,y2) をベジェ制御点として使用して、現在の座標と指定された座標 (x3,y3) の両方を通るベジェ曲線として描画します。
void	curveTo(float x1, float y1, float x2, float y2, float x3, float y3) 3 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) と点 (x2,y2) をベジェ制御点として使用して、現在の座標と指定された座標 (x3,y3) の両方を通るベジェ曲線として描画します。
Rectangle2D	getBounds2D() 高精度で、かつ getBounds メソッドより正確な Shape のバウンディングボックスを返します。
PathIterator	getPathIterator(AffineTransform at) Shape の境界に沿って反復し、Shape の輪郭の幾何学的図形へのアクセスを提供するイテレータオブジェクトを返します。
void	lineTo(double x, double y) 現在の座標から倍精度で新しく指定された座標まで直線を描画して点をパスに追加します。
void	lineTo(float x, float y) 現在の座標から float 精度で新しく指定された座標まで直線を描画して点をパスに追加します。
void	moveTo(double x, double y) 倍精度で指定された座標に移動して点をパスに追加します。
void	moveTo(float x, float y) float 精度で指定された座標に移動して点をパスに追加します。
void	quadTo(double x1, double y1, double x2, double y2) 2 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) を 2 次パラメトリック制御点として使用して、現在の座標と指定された座標 (x2,y2) を通る 2 次曲線として描画します。
void	quadTo(float x1, float y1, float x2, float y2) 2 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) を 2 次パラメトリック制御点として使用して、現在の座標と指定された座標 (x2,y2) を通る 2 次曲線として描画します。
void	transform(AffineTransform at) 指定された AffineTransform を使用して、このパスの幾何学的図形を変換します。

クラス java.awt.geom.Path2D から継承されたメソッド

append, closePath, contains, contains, contains, contains, contains, contains, contains, contains, createTransformedShape, getBounds, getCurrentPoint, getPathIterator, getWindingRule, intersects, intersects, intersects, intersects, reset, setWindingRule

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

Path2D.Float

public Path2D.Float()

Path2D.WIND_NON_ZERO のデフォルトの屈曲規則を使用して、新しい空の単精度 Path2D オブジェクトを構築します。

導入されたバージョン:

1.6

Path2D.Float

public Path2D.Float(int rule)

パスの内部を定義する必要があるオペレーションを制御するために、指定された屈曲規則を指定して、新しい空の単精度 Path2D オブジェクトを構築します。

パラメータ:

rule - 屈曲規則

導入されたバージョン:

1.6

関連項目:

Path2D.WIND_EVEN_ODD, Path2D.WIND_NON_ZERO

Path2D.Float

public Path2D.Float(int rule,
            int initialCapacity)

指定された屈曲規則、およびパスセグメントを格納する指定された初期容量を指定して、新しい空の単精度 Path2D オブジェクトを構築します。この数字は、パスに追加されるパスセグメントの数についての初期推定ですが、パスセグメントが追加されるときに、必要に応じて格納するためのストレージが拡張されます。

パラメータ:

rule - 屈曲規則

initialCapacity - パスにあるパスセグメントの数の推定値

導入されたバージョン:

1.6

関連項目:

Path2D.WIND_EVEN_ODD, Path2D.WIND_NON_ZERO

Path2D.Float

public Path2D.Float(Shape s)

任意の Shape オブジェクトから、新しい単精度 Path2D を構築します。このパスの初期幾何学的図形および屈曲規則はすべて、指定された Shape オブジェクトからとられます。

パラメータ:

s - 指定された Shape オブジェクト

導入されたバージョン:

1.6

Path2D.Float

public Path2D.Float(Shape s,
            AffineTransform at)

AffineTransform オブジェクトによって変換される、任意の Shape オブジェクトから新しい単精度 Path2D オブジェクトを構築します。このパスの初期幾何学的図形および屈曲規則はすべて、指定された Shape オブジェクトからとられ、指定された AffineTransform オブジェクトによって変換されます。

パラメータ:

s - 指定された Shape オブジェクト

at - 指定された AffineTransform オブジェクト

導入されたバージョン:

1.6

メソッドの詳細

moveTo

public final void moveTo(double x,
          double y)

倍精度で指定された座標に移動して点をパスに追加します。

定義:

moveTo、クラス: Path2D

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

導入されたバージョン:

1.6

moveTo

public final void moveTo(float x,
          float y)

float 精度で指定された座標に移動して点をパスに追加します。

このメソッドは、基底 Path2D クラスの倍精度 moveTo() メソッドの単精度バリアントです。

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

導入されたバージョン:

1.6

関連項目:

Path2D.moveTo(double, double)

lineTo

public final void lineTo(double x,
          double y)

現在の座標から倍精度で新しく指定された座標まで直線を描画して点をパスに追加します。

定義:

lineTo、クラス: Path2D

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

導入されたバージョン:

1.6

lineTo

public final void lineTo(float x,
          float y)

現在の座標から float 精度で新しく指定された座標まで直線を描画して点をパスに追加します。

このメソッドは、基底 Path2D クラスの倍精度 lineTo() メソッドの単精度バリアントです。

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

導入されたバージョン:

1.6

関連項目:

Path2D.lineTo(double, double)

quadTo

public final void quadTo(double x1,
          double y1,
          double x2,
          double y2)

2 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) を 2 次パラメトリック制御点として使用して、現在の座標と指定された座標 (x2,y2) を通る 2 次曲線として描画します。すべての座標は、倍精度で指定されます。

定義:

quadTo、クラス: Path2D

パラメータ:

x1 - 2 次制御点の X 座標

y1 - 2 次制御点の Y 座標

x2 - 最後の終点の X 座標

y2 - 最後の終点の Y 座標

導入されたバージョン:

1.6

quadTo

public final void quadTo(float x1,
          float y1,
          float x2,
          float y2)

2 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) を 2 次パラメトリック制御点として使用して、現在の座標と指定された座標 (x2,y2) を通る 2 次曲線として描画します。すべての座標は、float 精度で指定されます。

このメソッドは、基底 Path2D クラスの倍精度 quadTo() メソッドの単精度バリアントです。

パラメータ:

x1 - 2 次制御点の X 座標

y1 - 2 次制御点の Y 座標

x2 - 最後の終点の X 座標

y2 - 最後の終点の Y 座標

導入されたバージョン:

1.6

関連項目:

Path2D.quadTo(double, double, double, double)

curveTo

public final void curveTo(double x1,
           double y1,
           double x2,
           double y2,
           double x3,
           double y3)

3 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) と点 (x2,y2) をベジェ制御点として使用して、現在の座標と指定された座標 (x3,y3) の両方を通るベジェ曲線として描画します。すべての座標は、倍精度で指定されます。

定義:

curveTo、クラス: Path2D

パラメータ:

x1 - 最初のベジェ制御点の X 座標

y1 - 最初のベジェ制御点の Y 座標

x2 - 2 番目のベジェ制御点の X 座標

y2 - 2 番目のベジェ制御点の Y 座標

x3 - 最後の終点の X 座標

y3 - 最後の終点の Y 座標

導入されたバージョン:

1.6

curveTo

public final void curveTo(float x1,
           float y1,
           float x2,
           float y2,
           float x3,
           float y3)

3 つの新しい点によって定義される曲線セグメントをパスに追加します。曲線セグメントは、指定された点 (x1,y1) と点 (x2,y2) をベジェ制御点として使用して、現在の座標と指定された座標 (x3,y3) の両方を通るベジェ曲線として描画します。すべての座標は、float 精度で指定されます。

このメソッドは、基底 Path2D クラスの倍精度 curveTo() メソッドの単精度バリアントです。

パラメータ:

x1 - 最初のベジェ制御点の X 座標

y1 - 最初のベジェ制御点の Y 座標

x2 - 2 番目のベジェ制御点の X 座標

y2 - 2 番目のベジェ制御点の Y 座標

x3 - 最後の終点の X 座標

y3 - 最後の終点の Y 座標

導入されたバージョン:

1.6

関連項目:

Path2D.curveTo(double, double, double, double, double, double)

append

public final void append(PathIterator pi,
          boolean connect)

指定された PathIterator オブジェクトの幾何学的図形をパスに追加します。その新しい幾何学的図形をラインセグメントで既存のパスセグメントに接続することも可能です。connect パラメータが true であり、パスが空でない場合、追加された Shape の幾何学的図形の初期 moveTo は lineTo セグメントに変わります。そのような接続 lineTo セグメントのデスティネーションの座標が現在開いているサブパスの終了座標と一致する場合、セグメントは不要なので省略されます。指定された Shape の屈曲規則は無視され、追加された幾何学的図形はこのパスに指定された屈曲規則に制御されます。

定義:

append、クラス: Path2D

パラメータ:

pi - このパスに幾何学的図形が追加される PathIterator

connect - 新しい幾何学的図形を既存のパスに接続するために初期 moveTo セグメントを lineTo セグメントに変えるかどうかを制御する boolean 値

導入されたバージョン:

1.6

transform

public final void transform(AffineTransform at)

指定された AffineTransform を使用して、このパスの幾何学的図形を変換します。幾何学的図形は適切に変換され、これにより、このオブジェクトによって定義される境界が永久的に変更されます。

定義:

transform、クラス: Path2D

パラメータ:

at - 領域を変換するのに使う AffineTransform

導入されたバージョン:

1.6

getBounds2D

public final Rectangle2D getBounds2D()

高精度で、かつ getBounds メソッドより正確な Shape のバウンディングボックスを返します。返された Rectangle2D が、Shape を囲む最小のバウンディングボックスであるという保証はありません。Shape が、示された Rectangle2D 内に完全に含まれるだけです。戻り値を、倍精度値を使用して寸法を格納する Rectangle2D のインスタンスにすることができるため、このメソッドによって返されたバウンディングボックスは通常、getBounds メソッドによって返されたものより厳密であり、オーバーフローの問題のために失敗することはありません。

内側の定義によって、shape の定義する輪郭上の点が、返された bounds オブジェクトに含まれていると見なされない状況が発生する場合があります。ただし、これは、これらの点が元の shape にも含まれていないと見なされる場合のみです。

point が contains(point) メソッドに従って shape の内側にある場合は、bounds の contains(point) メソッドに従って、返された Rectangle2D 境界オブジェクトの内側にある必要があります。具体的には、次のようになります。

shape.contains(p) には次が必要: bounds.contains(p)

point が shape の内側にない場合は、引き続き bounds オブジェクトに含まれている可能性があります。

bounds.contains(p) は次を示さない: shape.contains(p)

定義:

getBounds2D、インタフェース: Shape

戻り値:

Shape の高精度のバウンディングボックスである Rectangle2D のインスタンス。

導入されたバージョン:

1.6

関連項目:

Shape.getBounds()

getPathIterator

public final PathIterator getPathIterator(AffineTransform at)

Shape の境界に沿って反復し、Shape の輪郭の幾何学的図形へのアクセスを提供するイテレータオブジェクトを返します。オプションの AffineTransform が指定されると、反復処理で返される座標がそれに応じて変換されます。

このメソッドを呼び出すたびに、同時に使用されているほかのすべての PathIterator オブジェクトとは無関係に、Shape オブジェクトの幾何学的図形をトラバースする新しい PathIterator オブジェクトが返されます。

Shape インタフェースを実装するオブジェクトにより、進行中の反復が、このような反復中に発生する可能性のある元のオブジェクトの幾何学的図形へのどのような変更からも切り離されることを推奨しますが、これは保証されません。

このクラスのイテレータは、マルチスレッドに対して安全ではありません。つまりこの Path2D クラスでは、この Path2D オブジェクトの幾何学的図形を変更すると、この幾何学的図形についてすでに進行中の反復処理に影響を及ぼす場合があります。

定義:

getPathIterator、インタフェース: Shape

パラメータ:

at - 反復処理で返されるときに座標に適用されるオプションの AffineTransform、または変換されていない座標が必要な場合は null

戻り値:

Shape の幾何学的図形を独立してトラバースする新しい PathIterator オブジェクト。

導入されたバージョン:

1.6

clone

public final Object clone()

このオブジェクトと同じクラスの新しいオブジェクトを作成します。

定義:

clone、クラス: Path2D

戻り値:

このインスタンスの複製。

例外:

OutOfMemoryError - 十分なメモリーがない場合。

導入されたバージョン:

1.6

関連項目:

Cloneable