ID2D1GeometrySink
COM公式ドキュメント
直線、円弧、3 次ベジェ曲線、2 次ベジェ曲線を含むことができる幾何学的パスを記述します。
解説(Remarks)
ID2D1GeometrySink インターフェイスは、ID2D1SimplifiedGeometrySink インターフェイスを拡張し、円弧と 2 次ベジェのサポート、および単一の直線と 3 次ベジェを追加する関数を追加します。
ジオメトリシンクは 1 つ以上のフィギュアで構成されます。各フィギュアは 1 つ以上の直線、曲線、または円弧のセグメントで構成されます。フィギュアを作成するには、BeginFigure メソッドを呼び出してフィギュアの開始点を指定し、その Add メソッド(AddLine や AddBezier など)を使用してセグメントを追加します。セグメントの追加が完了したら、EndFigure メソッドを呼び出します。このシーケンスを繰り返して追加のフィギュアを作成できます。フィギュアの作成が完了したら、Close メソッドを呼び出します。
例
次の例では、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);
}
}
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
現在の点と指定された終点との間に線分を作成し、ジオメトリシンクに追加します。
| point | D2D_POINT_2F | in | 描画する線の終点。 |
| bezier | D2D1_BEZIER_SEGMENT* | in | 2つの制御点と終点からなる3次ベジェ曲線セグメント定義へのポインタ。 |
| bezier | D2D1_QUADRATIC_BEZIER_SEGMENT* | in | 制御点1つと終点からなる2次ベジェ曲線セグメント定義へのポインタ。 |
2 次ベジェセグメントのシーケンスを配列として 1 回の呼び出しで追加します。
| beziers | D2D1_QUADRATIC_BEZIER_SEGMENT* | in | 2 次ベジェセグメントのシーケンスの配列。 |
| beziersCount | DWORD | in | beziers 内の 2 次ベジェセグメントの数を示す値。 |
| arc | D2D1_ARC_SEGMENT* | in | 終点・サイズ・回転角・掃引方向を含む円弧セグメント定義へのポインタ。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ID2D1GeometrySink "{2CD9069F-12E2-11DC-9FED-001143A055F9}" #usecom global ID2D1GeometrySink IID_ID2D1GeometrySink "{}" #comfunc global ID2D1GeometrySink_AddLine 10 int #comfunc global ID2D1GeometrySink_AddBezier 11 var #comfunc global ID2D1GeometrySink_AddQuadraticBezier 12 var #comfunc global ID2D1GeometrySink_AddQuadraticBeziers 13 var,int #comfunc global ID2D1GeometrySink_AddArc 14 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_ID2D1GeometrySink "{2CD9069F-12E2-11DC-9FED-001143A055F9}" #usecom global ID2D1GeometrySink IID_ID2D1GeometrySink "{}" #comfunc global ID2D1GeometrySink_AddLine 10 int #comfunc global ID2D1GeometrySink_AddBezier 11 sptr #comfunc global ID2D1GeometrySink_AddQuadraticBezier 12 sptr #comfunc global ID2D1GeometrySink_AddQuadraticBeziers 13 sptr,int #comfunc global ID2D1GeometrySink_AddArc 14 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。