IXpsOMGradientBrush インターフェイス (xpsobjectmodel.h)
このインターフェイスでは、グラデーションの分岐点で構成されるグラデーションについて説明します。 IXpsOMGradientBrush から継承するクラスは、グラデーションの分岐点を解釈するさまざまな方法を指定します。
IXpsOMGradientBrush は、 IXpsOMLinearGradientBrush インターフェイスと IXpsOMRadialGradientBrush インターフェイスの 基本インターフェイスです。
継承
IXpsOMGradientBrush インターフェイスは IXpsOMBrush から継承されます。 IXpsOMGradientBrush には、次の種類のメンバーもあります。
メソッド
IXpsOMGradientBrush インターフェイスには、これらのメソッドがあります。
| IXpsOMGradientBrush::GetColorInterpolationMode 色補間に使用するガンマ関数を取得します。 |
| IXpsOMGradientBrush::GetGradientStops グラデーションを定義する IXpsOMGradientStop インターフェイスのコレクションを含む IXpsOMGradientStopCollection インターフェイスへのポインターを取得します。 |
| IXpsOMGradientBrush::GetSpreadMethod グラデーション領域の外側の領域がどのようにレンダリングされるかを示すXPS_SPREAD_METHOD値を取得します。 |
| IXpsOMGradientBrush::GetTransform ブラシの解決されたマトリックス変換を含む IXpsOMMatrixTransform インターフェイスへのポインターを取得します。 (IXpsOMGradientBrush.GetTransform) |
| IXpsOMGradientBrush::GetTransformLocal ブラシのローカルで非共有の解決済みマトリックス変換を含む IXpsOMMatrixTransform インターフェイスへのポインターを取得します。 |
| IXpsOMGradientBrush::GetTransformLookup ブラシに使用する共有マトリックス変換インターフェイスの参照キーの名前を取得します。 |
| IXpsOMGradientBrush::SetColorInterpolationMode 色補間に使用するガンマ関数を記述するXPS_COLOR_INTERPOLATION値を設定します。 |
| IXpsOMGradientBrush::SetSpreadMethod XPS_SPREAD_METHOD値を設定します。この値は、グラデーション領域の外側の領域をレンダリングする方法を示します。 |
| IXpsOMGradientBrush::SetTransformLocal IXpsOMMatrixTransform インターフェイス ポインターを、ブラシに使用するローカルの非共有マトリックス変換に設定します。 |
| IXpsOMGradientBrush::SetTransformLookup ブラシに使用する共有マトリックス変換の参照キーの名前を設定します。 |
注釈
このインターフェイスのメソッドは、グラデーションの基本的なパラメーターを定義します。 線形または放射状のグラデーションの種類によって、これらのパラメーターの適用方法が決まります。
次の図に示すように、線形グラデーションの始点と終点は、グラデーション パスの終点をマークします。 グラデーション パスは、始点と終点を結ぶ直線です。 線形グラデーションのグラデーション領域は、始点と終点の間の領域 (それらの点を含む) で構成され、両方向に直角にグラデーション パスに拡張されます。 広がり領域は、グラデーション領域の外側の領域です。
グラデーションの停止は、グラデーション パスに沿って特定の場所で色を定義します。次の図に示すように、グラデーションの点間のグラデーション パスに沿って色が補間されます。
次の図に示すように、放射状グラデーションのグラデーション領域は、中心点と中心点から延びる x と y の半径で表される楕円で囲まれた領域です。 広がり領域は、その楕円の外側の領域です。 グラデーションパスは、グラデーションの原点からグラデーション領域を境界とする楕円にグラデーション領域全体をスイープする放射状の線です。 次の図では、グラデーションのパスは示されていません。
スプレッドメソッドは、スプレッドエリアがどのように塗りつぶされるかを記述します。 spread メソッドの実装は、グラデーションの種類 (線形または放射状) によって異なります。 次の図は、広がり領域を塗りつぶす方法のいくつかの例を示しています。 さまざまなスプレッド方法の詳細については、「 XPS_SPREAD_METHOD」を参照してください。
変換によって、結果として得られるグラデーションの変換方法が決まります。 イメージに最終的にレンダリングされるグラデーションの可視部分は、グラデーション ブラシを使用しているパス、ストローク、またはグリフによって決まります。
要件
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsobjectmodel.h |