ID2D1Geometry::Outline(constD2D1_MATRIX_3X2_F*,FLOAT,ID2D1SimplifiedGeometrySink*) メソッド (d2d1.h)

  • [アーティクル]

ジオメトリのアウトラインを計算し、結果を ID2D1SimplifiedGeometrySink に書き込みます。

構文

HRESULT Outline(
  [in, optional] const D2D1_MATRIX_3X2_F     *worldTransform,
                 FLOAT                       flatteningTolerance,
  [in]           ID2D1SimplifiedGeometrySink *geometrySink
);

パラメーター

[in, optional] worldTransform

型: const D2D1_MATRIX_3X2_F*

ジオメトリ アウトラインに適用する変換( NULL)。

flatteningTolerance

型: FLOAT

ジオメトリの多角形近似を構築するときに許容される最大誤差。 ポリゴン表現のポイントは、フラット化許容値を超える差によって元のジオメトリから分岐しません。 値が小さいほど、生成される結果の精度は高まりますが、実行速度が低下します。

[in] geometrySink

種類: ID2D1SimplifiedGeometrySink*

ジオメトリの変換されたアウトラインが追加される ID2D1SimplifiedGeometrySink 。

戻り値

型: HRESULT

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

解説

Outline メソッドを使用すると、呼び出し元は、次の追加プロパティを使用して、入力ジオメトリと同等の塗りつぶしを持つジオメトリを生成できます。

  • 出力ジオメトリには横方向の交差が含まれています。つまり、セグメントは触れることがありますが、交差することはありません。
  • 出力ジオメトリの最も外側の図形はすべて反時計回りに向きます。
  • 出力ジオメトリは、フィル モードインバリアントです。つまり、ジオメトリの塗りつぶしは、塗りつぶしモードの選択に依存しません。

    フィル モードの詳細については、「 D2D1_FILL_MODE」を参照してください。

さらに、 Outline メソッドは、複雑なジオメトリを簡略化するために、上記のジオメトリの冗長部分を削除する場合に役立ちます。 また、 ID2D1GeometryGroup と組み合わせて、複数のジオメトリ間で和集合を同時に作成する場合にも役立ちます。

要件

   
サポートされている最小のクライアント Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d2d1.h
Library D2d1.lib
[DLL] D2d1.dll

関連項目

Id2d1geometry