ID2D1SimplifiedGeometrySink

2次ベジエ曲線や円弧を含まないジオメトリパスを表します。

ジオメトリシンクは 1 つ以上のフィギュアで構成されます。各フィギュアは 1 つ以上の線分またはベジエ曲線セグメントで構成されます。フィギュアを作成するには、BeginFigure メソッドを呼び出してフィギュアの開始点を指定し、続いて AddLines および AddBeziers を使用して線分やベジエセグメントを追加します。セグメントの追加を終えたら、EndFigure メソッドを呼び出します。この一連の手順を繰り返すことで、さらにフィギュアを作成できます。フィギュアの作成をすべて終えたら、Close メソッドを呼び出します。

円弧や 2 次ベジエ曲線を含むことができるジオメトリパスを作成するには、ID2D1GeometrySink を使用してください。

このジオメトリシンクが表すジオメトリの内側にある点と外側にある点を判定するために使用する方法を指定します。

塗りつぶしモードの既定値は D2D1_FILL_MODE_ALTERNATE です。塗りつぶしモードを設定するには、最初の BeginFigure の呼び出しよりも前に SetFillMode を呼び出します。これに従わない場合、ジオメトリシンクはエラー状態になります。

ジオメトリシンクに新しく追加されるセグメントに適用する、ストロークおよび接合のオプションを指定します。

このメソッドを呼び出すと、以降シンクに追加される各セグメントに、指定したセグメントフラグが適用されます。セグメントフラグは、このメソッドが再度呼び出されて別のセグメントフラグが指定されるまで、追加されるすべてのセグメントに適用されます。

指定した点で新しいフィギュアを開始します。

フィギュアの作成中にこのメソッドを呼び出すと、インターフェイスは無効化され、以降のすべてのメソッドは失敗します。

例

次の例では、ID2D1PathGeometry を作成し、シンクを取得して、それを使用して砂時計形状を定義しています。

ID2D1GeometrySink *pSink = NULL;

// Create a path geometry.
if (SUCCEEDED(hr))
{
    hr = m_pD2DFactory->CreatePathGeometry(&m_pPathGeometry);

    if (SUCCEEDED(hr))
    {
        // Write to the path geometry using the geometry sink.
        hr = m_pPathGeometry->Open(&pSink);

        if (SUCCEEDED(hr))
        {
            pSink->BeginFigure(
                D2D1::Point2F(0, 0),
                D2D1_FIGURE_BEGIN_FILLED
                );

            pSink->AddLine(D2D1::Point2F(200, 0));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(150, 50),
                    D2D1::Point2F(150, 150),
                    D2D1::Point2F(200, 200))
                );

            pSink->AddLine(D2D1::Point2F(0, 200));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(50, 150),
                    D2D1::Point2F(50, 50),
                    D2D1::Point2F(0, 0))
                );

            pSink->EndFigure(D2D1_FIGURE_END_CLOSED);

            hr = pSink->Close();
        }
        SafeRelease(&pSink);
    }
}

指定した点の並びを使用して一連の線分を作成し、ジオメトリシンクに追加します。

一連の 3 次ベジエ曲線を作成し、ジオメトリシンクに追加します。

現在のフィギュアを終了します。必要に応じて閉じます。

対応する BeginFigure の呼び出しがない状態でこのメソッドを呼び出すと、ジオメトリシンクはエラー状態になります。以降の呼び出しは無視され、Close メソッドの呼び出し時に全体の失敗が返されます。

例

次の例では、ID2D1PathGeometry を作成し、シンクを取得して砂時計形状を定義し、続いて D2D1_FIGURE_END_CLOSED 値を指定して EndFigure を呼び出すことで砂時計の作成を終了しています。完全な例については、「How to Draw and Fill a Complex Shape」を参照してください。

ID2D1GeometrySink *pSink = NULL;

// Create a path geometry.
if (SUCCEEDED(hr))
{
    hr = m_pD2DFactory->CreatePathGeometry(&m_pPathGeometry);

    if (SUCCEEDED(hr))
    {
        // Write to the path geometry using the geometry sink.
        hr = m_pPathGeometry->Open(&pSink);

        if (SUCCEEDED(hr))
        {
            pSink->BeginFigure(
                D2D1::Point2F(0, 0),
                D2D1_FIGURE_BEGIN_FILLED
                );

            pSink->AddLine(D2D1::Point2F(200, 0));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(150, 50),
                    D2D1::Point2F(150, 150),
                    D2D1::Point2F(200, 200))
                );

            pSink->AddLine(D2D1::Point2F(0, 200));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(50, 150),
                    D2D1::Point2F(50, 50),
                    D2D1::Point2F(0, 0))
                );

            pSink->EndFigure(D2D1_FIGURE_END_CLOSED);

            hr = pSink->Close();
        }
        SafeRelease(&pSink);
    }
}

ジオメトリシンクを閉じ、エラー状態かどうかを示し、シンクのエラー状態をリセットします。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

フィギュアの作成中にジオメトリシンクを閉じないでください。閉じるとジオメトリシンクはエラー状態になります。クローズ操作を成功させるには、BeginFigure の各呼び出しに対して EndFigure の呼び出しが 1 回ずつ必要です。

このメソッドを呼び出した後、ジオメトリシンクは使用できなくなる場合があります。このインターフェイスの Direct2D 実装では、閉じた後にジオメトリシンクを変更することはできませんが、他の実装ではこの制限が課されない場合があります。

例

次の例では、ID2D1PathGeometry を作成し、シンクを取得して、それを使用して砂時計形状を定義しています。

ID2D1GeometrySink *pSink = NULL;

// Create a path geometry.
if (SUCCEEDED(hr))
{
    hr = m_pD2DFactory->CreatePathGeometry(&m_pPathGeometry);

    if (SUCCEEDED(hr))
    {
        // Write to the path geometry using the geometry sink.
        hr = m_pPathGeometry->Open(&pSink);

        if (SUCCEEDED(hr))
        {
            pSink->BeginFigure(
                D2D1::Point2F(0, 0),
                D2D1_FIGURE_BEGIN_FILLED
                );

            pSink->AddLine(D2D1::Point2F(200, 0));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(150, 50),
                    D2D1::Point2F(150, 150),
                    D2D1::Point2F(200, 200))
                );

            pSink->AddLine(D2D1::Point2F(0, 200));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(50, 150),
                    D2D1::Point2F(50, 50),
                    D2D1::Point2F(0, 0))
                );

            pSink->EndFigure(D2D1_FIGURE_END_CLOSED);

            hr = pSink->Close();
        }
        SafeRelease(&pSink);
    }
}