ID2D1BitmapBrush

ビットマップで領域を塗りつぶします。(ID2D1BitmapBrush)

ビットマップブラシは、ジオメトリをビットマップで塗りつぶすために使用します。すべてのブラシと同様に、コンテンツの無限平面を定義します。ビットマップは有限であるため、ブラシは「extend mode(拡張モード)」を利用して、平面を水平方向および垂直方向にどのように塗りつぶすかを決定します。

ID2D1BitmapBrush オブジェクトの作成

ID2D1BitmapBrush はデバイス依存のリソースです。アプリケーションは、ビットマップブラシを使用するレンダーターゲットを初期化した後にビットマップブラシを作成し、レンダーターゲットの再作成が必要になるたびにビットマップブラシも再作成する必要があります。(リソースの詳細については、リソースの概要 を参照してください。)

例

ビットマップブラシの作成方法の例については、ビットマップブラシの作成方法 トピックを参照してください。

ブラシのビットマップを超えて広がる領域を、ブラシが水平方向にどのようにタイル配置するかを指定します。

ビットマップブラシのビットマップが、塗りつぶし対象の領域を完全には埋めきれない場合があります。そのような場合、Direct2D はブラシの水平方向(SetExtendModeX)および垂直方向(SetExtendModeY)の拡張モード設定を使用して、残りの領域をどのように塗りつぶすかを決定します。

次の図は、ID2D1BitmapBrush における拡張モードのすべての組み合わせによる結果を示しています。D2D1_EXTEND_MODE_CLAMP(CLAMP)、D2D1_EXTEND_MODE_WRAP(WRAP)、D2D1_EXTEND_MIRROR(MIRROR)です。

例

次の例は、ビットマップブラシの x 方向および y 方向の拡張モードを D2D1_EXTEND_MIRROR に設定する方法を示しています。その後、ID2D1BitmapBrush で四角形を塗りつぶします。

これにより、次の出力が生成されます。

m_pBitmapBrush->SetExtendModeX(D2D1_EXTEND_MODE_MIRROR);
m_pBitmapBrush->SetExtendModeY(D2D1_EXTEND_MODE_MIRROR);

m_pRenderTarget->FillRectangle(exampleRectangle, m_pBitmapBrush);

ブラシのビットマップを超えて広がる領域を、ブラシが垂直方向にどのようにタイル配置するかを指定します。

ビットマップブラシのビットマップが、塗りつぶし対象の領域を完全には埋めきれない場合があります。そのような場合、Direct2D はブラシの水平方向(SetExtendModeX)および垂直方向(SetExtendModeY)の拡張モード設定を使用して、残りの領域をどのように塗りつぶすかを決定します。

次の図は、ID2D1BitmapBrush における拡張モードのすべての組み合わせによる結果を示しています。D2D1_EXTEND_MODE_CLAMP(CLAMP)、D2D1_EXTEND_MODE_WRAP(WRAP)、D2D1_EXTEND_MIRROR(MIRROR)です。

例

次の例は、ビットマップブラシの x 方向および y 方向の拡張モードを D2D1_EXTEND_MIRROR に設定する方法を示しています。その後、ID2D1BitmapBrush で四角形を塗りつぶします。

これにより、次の出力が生成されます。

m_pBitmapBrush->SetExtendModeX(D2D1_EXTEND_MODE_MIRROR);
m_pBitmapBrush->SetExtendModeY(D2D1_EXTEND_MODE_MIRROR);

m_pRenderTarget->FillRectangle(exampleRectangle, m_pBitmapBrush);

ビットマップブラシの詳細については、ブラシの概要 を参照してください。

ブラシのビットマップが拡大縮小または回転されるときに使用される補間モードを指定します。

このメソッドは、ビットマップの補間モードを設定します。補間モードは D2D1_BITMAP_INTERPOLATION_MODE 列挙型で指定される列挙値です。D2D1_BITMAP_INTERPOLATION_MODE_NEAREST_NEIGHBOR は最近傍フィルタリングを表します。現在のレンダリングピクセルに最も近いビットマップピクセルを参照し、その正確な色を選択します。D2D1_BITMAP_INTERPOLATION_MODE_LINEAR は線形フィルタリングを表し、最も近い 4 つのビットマップピクセルから色を補間します。

ビットマップの補間モードは、サブピクセル単位の移動にも影響します。サブピクセル単位の移動では、バイリニア補間によってビットマップがアプリケーションの要求により正確に配置されますが、その過程でビットマップがぼやけます。

このブラシが描画に使用するビットマップソースを指定します。

このメソッドは、このブラシが描画に使用するビットマップソースを指定します。ビットマップは、塗りつぶし対象のジオメトリに合わせて自動的にサイズ変更や拡大縮小が行われることはありません。ビットマップはネイティブサイズのまま保持されます。ビットマップのサイズ変更や移動を行うには、SetTransform メソッドを使用してブラシに変換を適用します。

ビットマップのネイティブサイズは、ビットマップピクセル単位の幅と高さをビットマップの DPI で割った値です。このネイティブサイズがブラシの基本タイルを形成します。ビットマップの一部分をタイル配置するには、その部分を含む新しいビットマップを生成し、SetBitmap を使用してブラシに適用する必要があります。

ブラシのビットマップを超えて広がる領域を、ブラシが水平方向にタイル配置する方法を取得します。

型: D2D1_EXTEND_MODE

ブラシのビットマップを超えて広がる領域を、ブラシが水平方向にどのようにタイル配置するかを指定する値。

すべてのブラシと同様に、ID2D1BitmapBrush はコンテンツの無限平面を定義します。ビットマップは有限であるため、拡張モードを利用して、平面を水平方向および垂直方向にどのように塗りつぶすかを決定します。

ブラシのビットマップを超えて広がる領域を、ブラシが垂直方向にタイル配置する方法を取得します。

型: D2D1_EXTEND_MODE

ブラシのビットマップを超えて広がる領域を、ブラシが垂直方向にどのようにタイル配置するかを指定する値。

すべてのブラシと同様に、ID2D1BitmapBrush はコンテンツの無限平面を定義します。

ビットマップは有限であるため、拡張モードを利用して、平面を水平方向および垂直方向にどのように塗りつぶすかを決定します。

ブラシのビットマップが拡大縮小または回転されるときに使用される補間方法を取得します。

型: D2D1_BITMAP_INTERPOLATION_MODE

ブラシのビットマップが拡大縮小または回転されるときに使用される補間方法。

このメソッドは、ビットマップの補間モードを取得します。補間モードは D2D1_BITMAP_INTERPOLATION_MODE 列挙型で指定されます。D2D1_BITMAP_INTERPOLATION_MODE_NEAREST_NEIGHBOR は最近傍フィルタリングを表します。現在のレンダリングピクセルに最も近いビットマップピクセルを参照し、その正確な色を選択します。D2D1_BITMAP_INTERPOLATION_MODE_LINEAR は線形フィルタリングを表し、最も近い 4 つのビットマップピクセルから色を補間します。

ビットマップの補間モードは、サブピクセル単位の移動にも影響します。サブピクセル単位の移動では、線形補間によってビットマップがアプリケーションの要求により正確に配置されますが、その過程でビットマップがぼやけます。

このブラシが描画に使用するビットマップソースを取得します。