モジュール java.desktop
パッケージ java.awt.geom

クラスArc2D

java.lang.Object
java.awt.geom.RectangularShape
java.awt.geom.Arc2D
すべての実装されたインタフェース:
Shape, Cloneable
直系の既知のサブクラス:
Arc2D.Double, Arc2D.Float
public abstract class Arc2D
extends RectangularShape
Arc2Dは、表示枠の矩形、始角、角の大きさ(弧の長さ)、および閉じ方の種類(OPEN、CHORD、またはPIE)によって定義される2次元の弧を格納するすべてのオブジェクトの抽象スーパー・クラスです。

「弧は、親のフレーミング矩形に内接する完全な楕円の部分的な部分です」 RectangularShape。 角度は、45度が常に楕円の中心からフレーミング矩形の右上隅までの線になるように、非正方形のフレーミング矩形を基準にして指定されます。その結果、フレーミング矩形が他の軸よりも1つの軸に沿って著しく長い場合、弧セグメントの開始および終了に対する角度は、フレームのより長い軸に沿ってさらにずれます。

座標の実際の記憶域表現はサブクラスに委ねられます。

導入されたバージョン:
1.2

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

    ネストされたクラス
    修飾子と型 クラス 説明
    static class  Arc2D.Double
    このクラスは、double精度で指定された弧を定義します。
    static class  Arc2D.Float
    このクラスは、float精度で指定された弧を定義します。

  • フィールドのサマリー

    フィールド
    修飾子と型 フィールド 説明
    static int CHORD
    弧セグメントの始点と終点を結ぶ直線セグメントを描画することによって閉じられる弧の閉じ方の種類です。
    static int OPEN
    弧セグメントの両端を結ぶパス・セグメントを持たない開いた弧の閉じ方の種類です。
    static int PIE
    弧セグメントの始点から楕円の中心までの直線セグメントと、楕円の中心から弧セグメントの終点までの直線セグメントを描画することによって、閉じられる弧の閉じ方の種類です。

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

    コンストラクタ
    修飾子 コンストラクタ 説明
    protected Arc2D()
    これは、インスタンスを直接には生成できない抽象クラスです。
    protected Arc2D​(int type)
    これは、インスタンスを直接には生成できない抽象クラスです。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    boolean contains​(double x, double y)
    指定された点が弧の境界内にあるかどうかを判定します。
    boolean contains​(double x, double y, double w, double h)
    弧が、指定された矩形を内部に完全に包含しているかどうかを判定します。
    boolean contains​(Rectangle2D r)
    弧が、指定された矩形を内部に完全に包含しているかどうかを判定します。
    boolean containsAngle​(double angle)
    指定された角度が弧の角の大きさと同じまたはそれより小さいかどうかを判定します。
    boolean equals​(Object obj)
    指定されたObjectがこのArc2Dと等しいかどうかを判定します。
    abstract double getAngleExtent()
    弧の角の大きさを返します。
    abstract double getAngleStart()
    弧の始角を返します。
    int getArcType()
    弧の閉じ方の種類OPEN、CHORD、またはPIEを返します。
    Rectangle2D getBounds2D()
    弧の高精度表示枠矩形を返します。
    Point2D getEndPoint()
    孤の終点を返します。
    PathIterator getPathIterator​(AffineTransform at)
    孤の境界を定義する繰返しオブジェクトを返します。
    Point2D getStartPoint()
    孤の始点を返します。
    int hashCode()
    このArc2Dのハッシュ・コードを返します。
    boolean intersects​(double x, double y, double w, double h)
    弧の内部が、指定された矩形の内部と交差するかどうかを判定します。
    protected abstract Rectangle2D makeBounds​(double x, double y, double w, double h)
    この弧の表示枠矩形になるように計算されたパラメータを格納するために、適切な精度のRectangle2Dを作成します。
    abstract void setAngleExtent​(double angExt)
    この弧の角の大きさを、指定されたdouble値に設定します。
    void setAngles​(double x1, double y1, double x2, double y2)
    2組の座標を使用して、この孤の始角と角の大きさを設定します。
    void setAngles​(Point2D p1, Point2D p2)
    2つの点を使用して、この孤の始角と角の大きさを設定します。
    abstract void setAngleStart​(double angSt)
    この弧の始角を、指定されたdouble値に設定します。
    void setAngleStart​(Point2D p)
    この弧の始角を、指定された点によりこの弧の中心を基準に定義される角度に設定します。
    abstract void setArc​(double x, double y, double w, double h, double angSt, double angExt, int closure)
    この弧の位置、サイズ、角の大きさ、閉じ方の種類を、指定されたdouble値に設定します。
    void setArc​(Arc2D a)
    この弧を指定された弧と同じに設定します。
    void setArc​(Point2D loc, Dimension2D size, double angSt, double angExt, int closure)
    この弧の位置、サイズ、角の大きさ、閉じ方の種類を、指定された値に設定します。
    void setArc​(Rectangle2D rect, double angSt, double angExt, int closure)
    この弧の位置、サイズ、角の大きさ、閉じ方の種類を、指定された値に設定します。
    void setArcByCenter​(double x, double y, double radius, double angSt, double angExt, int closure)
    この孤の位置、境界、角の大きさ、閉じ方の種類を、指定された値に設定します。
    void setArcByTangent​(Point2D p1, Point2D p2, Point2D p3, double radius)
    この孤の位置、境界、角の大きさを、指定された値に設定します。
    void setArcType​(int type)
    この弧の閉じ方の種類を指定された値に設定します。OPEN、CHORD、またはPIE。
    void setFrame​(double x, double y, double w, double h)
    このShapeの表示枠矩形の位置とサイズを、指定された矩形値に設定します。

    クラス java.awt.geom.RectangularShapeで宣言されたメソッド

    clone, contains, getBounds, getCenterX, getCenterY, getFrame, getHeight, getMaxX, getMaxY, getMinX, getMinY, getPathIterator, getWidth, getX, getY, intersects, isEmpty, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

    クラス java.lang.Objectで宣言されたメソッド

    finalize, getClass, notify, notifyAll, toString, wait, wait, wait

  • フィールド詳細

    • OPEN

      public static final int OPEN
      弧セグメントの両端を結ぶパス・セグメントを持たない開いた弧の閉じ方の種類です。
      導入されたバージョン:
      1.2
      関連項目:
      定数フィールド値

    • CHORD

      public static final int CHORD
      弧セグメントの始点と終点を結ぶ直線セグメントを描画することによって閉じられる弧の閉じ方の種類です。
      導入されたバージョン:
      1.2
      関連項目:
      定数フィールド値

    • PIE

      public static final int PIE
      弧セグメントの始点から楕円の中心までの直線セグメントと、楕円の中心から弧セグメントの終点までの直線セグメントを描画することによって、閉じられる弧の閉じ方の種類です。
      導入されたバージョン:
      1.2
      関連項目:
      定数フィールド値

  • コンストラクタの詳細

    • Arc2D

      protected Arc2D()
      これは、インスタンスを直接には生成できない抽象クラスです。 インスタンス生成のためには型固有の実装サブクラスが用意されており、これらのサブクラスにより、下記の各種アクセス用メソッドに必要な情報を格納するための形式が多数提供されます。

      このコンストラクタは、閉じ方の種類のデフォルトであるOPENでオブジェクトを作成します。 これは、サブクラスの直列化を有効にするためにのみ提供されています。

      関連項目:
      Arc2D.Float、Arc2D.Double

    • Arc2D

      protected Arc2D​(int type)
      これは、インスタンスを直接には生成できない抽象クラスです。 インスタンス生成のためには型固有の実装サブクラスが用意されており、これらのサブクラスにより、下記の各種アクセス用メソッドに必要な情報を格納するための形式が多数提供されます。
      パラメータ:
      type - この弧の閉じ方の種類: OPEN、CHORD、またはPIE。
      導入されたバージョン:
      1.2
      関連項目:
      Arc2D.Float、Arc2D.Double

  • メソッドの詳細

    • getAngleStart

      public abstract double getAngleStart()
      弧の始角を返します。
      戻り値:
      弧の始角(度)を表すdouble値。
      導入されたバージョン:
      1.2
      関連項目:
      setAngleStart(double)

    • getAngleExtent

      public abstract double getAngleExtent()
      弧の角の大きさを返します。
      戻り値:
      弧の角の大きさ(度単位)を表すdouble値。
      導入されたバージョン:
      1.2
      関連項目:
      setAngleExtent(double)

    • getArcType

      public int getArcType()
      弧の閉じ方の種類OPEN、CHORD、またはPIEを返します。
      戻り値:
      このクラスで定義されている閉じ方の種類を表す。
      導入されたバージョン:
      1.2
      関連項目:
      setArcType(int)

    • getStartPoint

      public Point2D getStartPoint()
      孤の始点を返します。 この点は、弧の始角で定義される中心からの半径と、弧の楕円境界との交点です。
      戻り値:
      弧の始点のx,y座標を表すPoint2Dオブジェクト。
      導入されたバージョン:
      1.2

    • getEndPoint

      public Point2D getEndPoint()
      孤の終点を返します。 この点は、弧の始角にその角の大きさを加えることにより定義される中心からの半径と、弧の楕円境界との交点です。
      戻り値:
      弧の終点のx,y座標を表すPoint2Dオブジェクト。
      導入されたバージョン:
      1.2

    • setArc

      public abstract void setArc​(double x, double y, double w, double h, double angSt, double angExt, int closure)
      この弧の位置、サイズ、角の大きさ、閉じ方の種類を、指定されたdouble値に設定します。
      パラメータ:
      x - 弧の左上隅のX座標。
      y - 弧の左上隅のY座標。
      w - この弧が一部を構成する楕円の全体の幅。
      h - この弧が一部を構成する楕円の全体の高さ。
      angSt - 弧の始角(度単位)。
      angExt - 弧の角の大きさ(度単位)。
      closure - 弧の閉じ方の種類: OPEN、CHORD、またはPIE。
      導入されたバージョン:
      1.2

    • setArc

      public void setArc​(Point2D loc, Dimension2D size, double angSt, double angExt, int closure)
      この弧の位置、サイズ、角の大きさ、閉じ方の種類を、指定された値に設定します。
      パラメータ:
      loc - 弧の左上隅の座標を表すPoint2D。
      size - この弧が一部を構成する楕円の幅と高さを表すDimension2D。
      angSt - 弧の始角(度単位)。
      angExt - 弧の角の大きさ(度単位)。
      closure - 弧の閉じ方の種類: OPEN、CHORD、またはPIE。
      導入されたバージョン:
      1.2

    • setArc

      public void setArc​(Rectangle2D rect, double angSt, double angExt, int closure)
      この弧の位置、サイズ、角の大きさ、閉じ方の種類を、指定された値に設定します。
      パラメータ:
      rect - この弧が一部を構成する楕円の外部境界を定義する表示枠矩形。
      angSt - 弧の始角(度単位)。
      angExt - 弧の角の大きさ(度単位)。
      closure - 弧の閉じ方の種類: OPEN、CHORD、またはPIE。
      導入されたバージョン:
      1.2

    • setArc

      public void setArc​(Arc2D a)
      この弧を指定された弧と同じに設定します。
      パラメータ:
      a - 弧の値を設定するために使用するArc2D。
      導入されたバージョン:
      1.2

    • setArcByCenter

      public void setArcByCenter​(double x, double y, double radius, double angSt, double angExt, int closure)
      この孤の位置、境界、角の大きさ、閉じ方の種類を、指定された値に設定します。 弧は、楕円の表示枠矩形ではなく、中心と半径に基づいて定義されます。
      パラメータ:
      x - 弧の中心のX座標。
      y - 弧の中心のY座標。
      radius - 弧の半径。
      angSt - 弧の始角(度単位)。
      angExt - 弧の角の大きさ(度単位)。
      closure - 弧の閉じ方の種類: OPEN、CHORD、またはPIE。
      導入されたバージョン:
      1.2

    • setArcByTangent

      public void setArcByTangent​(Point2D p1, Point2D p2, Point2D p3, double radius)
      この孤の位置、境界、角の大きさを、指定された値に設定します。 弧の始角の接線は点(p1, p2)によって指定され、終角の接線は点(p2, p3)によって指定されます。弧は、指定された半径を持ちます。
      パラメータ:
      p1 - 弧を定義する第1の点。 弧の始角の接線は点(p1, p2)で指定される。
      p2 - 弧を定義する第2の点。 弧の始角の接線は点(p1, p2)で指定される。 弧の終角の接線は点(p2, p3)で指定される。
      p3 - 弧を定義する第3の点。 弧の終角の接線は点(p2, p3)で指定される。
      radius - 弧の半径。
      導入されたバージョン:
      1.2

    • setAngleStart

      public abstract void setAngleStart​(double angSt)
      この弧の始角を、指定されたdouble値に設定します。
      パラメータ:
      angSt - 弧の始角(度単位)。
      導入されたバージョン:
      1.2
      関連項目:
      getAngleStart()

    • setAngleExtent

      public abstract void setAngleExtent​(double angExt)
      この弧の角の大きさを、指定されたdouble値に設定します。
      パラメータ:
      angExt - 弧の角の大きさ(度単位)。
      導入されたバージョン:
      1.2
      関連項目:
      getAngleExtent()

    • setAngleStart

      public void setAngleStart​(Point2D p)
      この弧の始角を、指定された点によりこの弧の中心を基準に定義される角度に設定します。 孤の角の大きさに変更はありません。
      パラメータ:
      p - 始角を定義するPoint2D。
      導入されたバージョン:
      1.2
      関連項目:
      getAngleStart()

    • setAngles

      public void setAngles​(double x1, double y1, double x2, double y2)
      2組の座標を使用して、この孤の始角と角の大きさを設定します。 座標の第1の組は、孤の中心を基準に始点の角度を決めるために使用します。 第2の組は、孤の中心を基準に終点の角度を決めるために使用します。 孤は常に空ではなく、第1の点から第2の点へ反時計方向に伸びたものです。
      パラメータ:
      x1 - 弧の始点のX座標。
      y1 - 弧の始点のY座標。
      x2 - 弧の終点のX座標。
      y2 - 弧の終点のY座標。
      導入されたバージョン:
      1.2

    • setAngles

      public void setAngles​(Point2D p1, Point2D p2)
      2つの点を使用して、この孤の始角と角の大きさを設定します。 第1の点は、孤の中心を基準に始点の角度を決めるために使用します。 第2の点は、孤の中心を基準に終点の角度を決めるために使用します。 孤は常に空ではなく、第1の点から第2の点へ反時計方向に伸びたものです。
      パラメータ:
      p1 - 弧の始点を定義するPoint2D。
      p2 - 弧の終点を定義するPoint2D。
      導入されたバージョン:
      1.2

    • setArcType

      public void setArcType​(int type)
      この弧の閉じ方の種類を指定された値に設定します。OPEN、CHORD、またはPIE。
      パラメータ:
      type - この弧の閉じ方の種類を表す整定数。OPEN、CHORD、またはPIE。
      例外:
      IllegalArgumentException - typeが0、1、2のいずれでもない場合。
      導入されたバージョン:
      1.2
      関連項目:
      getArcType()

    • setFrame

      public void setFrame​(double x, double y, double w, double h)
      このShapeの表示枠矩形の位置とサイズを、指定された矩形値に設定します。 弧はこのRectangularShapeの表示枠矩形と部分的に内接しています。
      定義:
      setFrame、クラス: RectangularShape
      パラメータ:
      x - 指定された矩形形状の左上隅のX座標
      y - 指定された矩形形状の左上隅のY座標
      w - 指定された矩形形状の幅
      h - 指定された矩形形状の高さ
      導入されたバージョン:
      1.2
      関連項目:
      RectangularShape.getFrame()

    • getBounds2D

      public Rectangle2D getBounds2D()
      弧の高精度表示枠矩形を返します。 このArc2Dの閉じ方の種類がPIEの場合、表示枠矩形には、このArc2Dのうち始角と終角の間にある部分のみが含まれるほか、パイ・ウエッジ(pie wedge)が含まれます。

      このメソッドは、getBoundsとは異なります。getBoundsメソッドの場合は、このArc2Dの始角と終角を考慮せずに、このArc2Dの楕円を囲む境界のみを返します。

      戻り値:
      弧の表示枠矩形を表すRectangle2D。
      導入されたバージョン:
      1.2
      関連項目:
      Shape.getBounds()

    • makeBounds

      protected abstract Rectangle2D makeBounds​(double x, double y, double w, double h)
      この弧の表示枠矩形になるように計算されたパラメータを格納するために、適切な精度のRectangle2Dを作成します。
      パラメータ:
      x - 表示枠矩形の左上隅のX座標。
      y - 表示枠矩形の左上隅のY座標。
      w - 表示枠矩形の幅。
      h - 表示枠矩形の高さ。
      戻り値:
      この弧の表示枠矩形であるRectangle2D。
      導入されたバージョン:
      1.2

    • containsAngle

      public boolean containsAngle​(double angle)
      指定された角度が弧の角の大きさと同じまたはそれより小さいかどうかを判定します。
      パラメータ:
      angle - テストする角度。
      戻り値:
      角度が弧に収まる場合はtrue。角度が弧に収まらない場合はfalse。
      導入されたバージョン:
      1.2

    • contains

      public boolean contains​(double x, double y)
      指定された点が弧の境界内にあるかどうかを判定します。
      パラメータ:
      x - テストする点のX座標。
      y - テストする点のY座標。
      戻り値:
      点が弧の境界の内側にある場合はtrue、点が弧の境界の外側にある場合はfalse。
      導入されたバージョン:
      1.2

    • intersects

      public boolean intersects​(double x, double y, double w, double h)
      弧の内部が、指定された矩形の内部と交差するかどうかを判定します。
      パラメータ:
      x - 矩形の左上隅のX座標。
      y - 矩形の左上隅のY座標。
      w - 矩形の幅。
      h - 矩形の高さ。
      戻り値:
      弧が矩形と交差する場合はtrue、弧が矩形と交差しない場合はfalse。
      導入されたバージョン:
      1.2
      関連項目:
      Area

    • contains

      public boolean contains​(double x, double y, double w, double h)
      弧が、指定された矩形を内部に完全に包含しているかどうかを判定します。
      パラメータ:
      x - 矩形の左上隅のX座標。
      y - 矩形の左上隅のY座標。
      w - 矩形の幅。
      h - 矩形の高さ。
      戻り値:
      矩形が弧に収まる場合はtrue、矩形が弧に収まらない場合はfalse。
      導入されたバージョン:
      1.2
      関連項目:
      Area、Shape.intersects(double, double, double, double)

    • contains

      public boolean contains​(Rectangle2D r)
      弧が、指定された矩形を内部に完全に包含しているかどうかを判定します。
      定義:
      contains、インタフェース: Shape
      オーバーライド:
      contains、クラス: RectangularShape
      パラメータ:
      r - テストするRectangle2D。
      戻り値:
      矩形が弧に収まる場合はtrue、矩形が弧に収まらない場合はfalse。
      導入されたバージョン:
      1.2
      関連項目:
      Shape.contains(double, double, double, double)

    • getPathIterator

      public PathIterator getPathIterator​(AffineTransform at)
      孤の境界を定義する繰返しオブジェクトを返します。 このイテレータは、マルチ・スレッドに対して安全です。 Arc2Dでは、弧の幾何学的図形への変更が、その幾何学的図形のすでに進行中のどの反復にも影響を与えないことが保証されます。
      パラメータ:
      at - 反復で返されるときに座標に適用されるオプションのAffineTransform。変換されていない座標が必要な場合はnull。
      戻り値:
      弧の境界を定義するPathIterator。
      導入されたバージョン:
      1.2

    • hashCode

      public int hashCode()
      このArc2Dのハッシュ・コードを返します。
      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このArc2Dのハッシュ・コード。
      導入されたバージョン:
      1.6
      関連項目:
      Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

    • equals

      public boolean equals​(Object obj)
      指定されたObjectがこのArc2Dと等しいかどうかを判定します。 指定されたObjectがこのArc2Dに等しいのは、それがArc2Dのインスタンスであり、かつその位置、サイズ、弧の展開、およびタイプがこのArc2Dと同じである場合です。
      オーバーライド:
      equals 、クラス:  Object
      パラメータ:
      obj - このArc2Dと比較されるObject。
      戻り値:
      objがArc2Dのインスタンスであり、同じ値を持つ場合はtrue、そうでない場合はfalse。
      導入されたバージョン:
      1.6
      関連項目:
      Object.hashCode()、HashMap