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

インタフェースPathIterator

  • 既知のすべての実装クラス:
    FlatteningPathIterator
    public interface PathIterator
    PathIteratorインタフェースの提供するメカニズムを使用すると、Shapeインタフェースを実装するオブジェクトは、一度に1セグメント単位で境界のパスを取り出すことを呼出し側に許可することで、その境界の幾何学的図形を返すことができます。 このインタフェースでは、ラインおよび2次または3次ベジェ・スプラインである1次から3次までのベジェ曲線を使用することによって、これらのオブジェクトがその境界のパスを一度に1セグメントずつ取り出せるようにします。

    複数のサブパスは、「MOVETO」セグメントを使用して幾何学的図形を不連続にし、あるサブパスの最後から次のサブパスの先頭に移動することで表現できます。

    各サブパスは、サブパスの最後のセグメントをそのサブパスの先頭のMOVETOセグメントと同じ座標で終わらせるか、またはCLOSEセグメントを使用して最後の点から最初の点までライン・セグメントを追加することで手作業で終了することができます。 CLOSEセグメントを使用してパスを閉じる以外の方法で輪郭を手作業で閉じると、サブパスの終点で異なる線種装飾が使用される可能性があります。 たとえば、BasicStrokeオブジェクトはCLOSEセグメントが検出された場合、JOINを線の装飾として使用して最初の点と最後の点を結びます。これに対して、単純に最初の座標と同じ座標でパスを終わらせると、最後にCAPが線の装飾として使用されます。

    関連項目:
    Shape, BasicStroke

    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      static int SEG_CLOSE
      先行するサブパスがもっとも新しいSEG_MOVETOに対応する点までのライン・セグメントを追加することで閉じられなければならないことを指定するセグメント型定数です。
      static int SEG_CUBICTO
      もっとも新しく指定された点から描画される3次パラメトリック曲線を指定する3つの点のセットのセグメント型定数です。
      static int SEG_LINETO
      もっとも新しく指定された点から描画されるラインの終点を指定する点のセグメント型定数です。
      static int SEG_MOVETO
      新しいサブパスの開始位置を指定する点のセグメント型定数です。
      static int SEG_QUADTO
      もっとも新しく指定された点から描画される2次パラメトリック曲線を指定する点のペアのセグメント型定数です。
      static int WIND_EVEN_ODD
      パスの内部を決めるために偶奇規則を指定する屈曲規則定数です。
      static int WIND_NON_ZERO
      パスの内部を決めるために非ゼロ規則を指定する屈曲規則定数です。

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      int currentSegment​(double[] coords)
      繰返し処理の現在のパス・セグメントの座標および型を返します。
      int currentSegment​(float[] coords)
      繰返し処理の現在のパス・セグメントの座標および型を返します。
      int getWindingRule()
      パスの内部を決める屈曲規則を返します。
      boolean isDone()
      繰返し処理が完了したかどうかを判定します。
      void next()
      移動の順方向にまだ点がある場合に、その方向に沿ってパスの次のセグメントにイテレータを移動します。

    • フィールドの詳細

      • WIND_EVEN_ODD

        @Native
static final int WIND_EVEN_ODD
        パスの内部を決めるために偶奇規則を指定する屈曲規則定数です。 偶奇規則は、点から無限遠点に任意の方向に描画された光線がパス・セグメントによって奇数回横切られる場合にその点がパスの内側にあることを指定します。
        関連項目:
        定数フィールド値

      • WIND_NON_ZERO

        @Native
static final int WIND_NON_ZERO
        パスの内部を決めるために非ゼロ規則を指定する屈曲規則定数です。 非ゼロ規則は、点から無限遠点に描画された光線が、パス・セグメントによって時計方向とは異なる回数で、反時計方向に横切られる場合にその点がパスの内側にあることを指定します。
        関連項目:
        定数フィールド値

      • SEG_MOVETO

        @Native
static final int SEG_MOVETO
        新しいサブパスの開始位置を指定する点のセグメント型定数です。
        関連項目:
        定数フィールド値

      • SEG_LINETO

        @Native
static final int SEG_LINETO
        もっとも新しく指定された点から描画されるラインの終点を指定する点のセグメント型定数です。
        関連項目:
        定数フィールド値

      • SEG_QUADTO

        @Native
static final int SEG_QUADTO
        もっとも新しく指定された点から描画される2次パラメトリック曲線を指定する点のペアのセグメント型定数です。 曲線は、もっとも新しく指定された(現在の)点(CP)、最初の制御点(P1)、および最後の補間された制御点(P2)を使用して、範囲(t=[0..1])でパラメトリック・コントロール方程式を解くことで補間されます。 この曲線のパラメトリック・コントロール方程式は次のようになります。 
                  P(t) = B(2,0)*CP + B(2,1)*P1 + B(2,2)*P2
          0 <= t <= 1

        B(n,m) = mth coefficient of nth degree Bernstein polynomial
               = C(n,m) * t^(m) * (1 - t)^(n-m)
        C(n,m) = Combinations of n things, taken m at a time
               = n! / (m! * (n-m)!)
        関連項目:
        定数フィールド値

      • SEG_CUBICTO

        @Native
static final int SEG_CUBICTO
        もっとも新しく指定された点から描画される3次パラメトリック曲線を指定する3つの点のセットのセグメント型定数です。 曲線は、もっとも新しく指定された(現在の)点(CP)、最初の制御点(P1)、2番目の制御点(P2)、および最後の補間された制御点(P3)を使用して、範囲(t=[0..1])でパラメトリック・コントロール方程式を解くことで補間されます。 この曲線のパラメトリック・コントロール方程式は次のようになります。 
                  P(t) = B(3,0)*CP + B(3,1)*P1 + B(3,2)*P2 + B(3,3)*P3
          0 <= t <= 1

        B(n,m) = mth coefficient of nth degree Bernstein polynomial
               = C(n,m) * t^(m) * (1 - t)^(n-m)
        C(n,m) = Combinations of n things, taken m at a time
               = n! / (m! * (n-m)!)
        この形式の曲線は一般に、ベジェ曲線と呼ばれます。
        関連項目:
        定数フィールド値

      • SEG_CLOSE

        @Native
static final int SEG_CLOSE
        先行するサブパスがもっとも新しいSEG_MOVETOに対応する点までのライン・セグメントを追加することで閉じられなければならないことを指定するセグメント型定数です。
        関連項目:
        定数フィールド値

    • メソッドの詳細

      • getWindingRule

        int getWindingRule()
        パスの内部を決める屈曲規則を返します。
        戻り値:
        屈曲規則。
        関連項目:
        WIND_EVEN_ODD, WIND_NON_ZERO

      • isDone

        boolean isDone()
        繰返し処理が完了したかどうかを判定します。
        戻り値:
        すべてのセグメントが読み込まれている場合はtrue、そうでない場合はfalse。

      • next

        void next()
        移動の順方向にまだ点がある場合に、その方向に沿ってパスの次のセグメントにイテレータを移動します。

      • currentSegment

        int currentSegment​(float[] coords)
        繰返し処理の現在のパス・セグメントの座標および型を返します。 戻り値はパス・セグメントのタイプであり、SEG_MOVETO、SEG_LINETO、SEG_QUADTO、SEG_CUBICTO、SEG_CLOSEのいずれかです。 長さ6のfloat配列を渡さなければならず、それは点の座標を格納するために使用されます。 各点は、float x,y座標のペアとして格納されます。 SEG_MOVETO型およびSEG_LINETO型は1つの点を返し、SEG_QUADTOは2つの点を返し、SEG_CUBICTOは3つの点を返し、SEG_CLOSEは点を返しません。
        パラメータ:
        coords - このメソッドから返されるデータを保持する配列
        戻り値:
        現在のパス・セグメントの型。
        関連項目:
        SEG_MOVETO, SEG_LINETO, SEG_QUADTO, SEG_CUBICTO, SEG_CLOSE

      • currentSegment

        int currentSegment​(double[] coords)
        繰返し処理の現在のパス・セグメントの座標および型を返します。 戻り値はパス・セグメントのタイプであり、SEG_MOVETO、SEG_LINETO、SEG_QUADTO、SEG_CUBICTO、SEG_CLOSEのいずれかです。 長さ6のdouble配列を返さなければならず、それは点の座標を格納するために使用されます。 各点は、double x,y座標のペアとして格納されます。 SEG_MOVETO型およびSEG_LINETO型は1つの点を返し、SEG_QUADTOは2つの点を返し、SEG_CUBICTOは3つの点を返し、SEG_CLOSEは点を返しません。
        パラメータ:
        coords - このメソッドから返されるデータを保持する配列
        戻り値:
        現在のパス・セグメントの型。
        関連項目:
        SEG_MOVETO, SEG_LINETO, SEG_QUADTO, SEG_CUBICTO, SEG_CLOSE