ID2D1Brush：：SetTransform 方法

设置应用于画笔的转换。

重载列表

方法	说明
SetTransform (D2D1_MATRIX_3X2_F&)	设置应用于画笔的转换。
SetTransform (D2D1_MATRIX_3X2_F*)	设置应用于画笔的转换。

备注

使用画笔绘制时，它会在呈现目标的坐标空间中绘制。 画笔不会自动定位自身以与所绘制的对象对齐;默认情况下，它们在呈现目标的原点 (0， 0) 开始绘制。

可以通过设置 ID2D1LinearGradientBrush 定义的渐变“移动”到目标区域。 同样，可以通过更改 ID2D1RadialGradientBrush 定义的渐变的中心和半径来移动该渐变。

若要将 ID2D1BitmapBrush 的内容与要绘制的区域对齐，可以使用 SetTransform 方法将位图转换为所需位置。 此转换仅影响画笔;它不会影响呈现器目标绘制的任何其他内容。

下图显示了使用 ID2D1BitmapBrush 填充位于 (100， 100) 的矩形的效果。 左侧插图显示了在不转换画笔的情况下填充矩形的结果：位图在呈现目标的原点处绘制。 因此，矩形中只显示一部分位图。

右侧的插图显示了转换 ID2D1BitmapBrush 的结果，以便其内容向右移动 50 像素，向下移动 50 像素。 位图现在填充矩形。

示例

以下代码示例演示如何创建上图右图中显示的转换。 首先对 ID2D1BitmapBrush 应用平移，沿 x 轴向右移动画笔 50 像素，沿 y 轴向下移动 50 像素。 然后使用 ID2D1BitmapBrush 填充左上角位于 (100，100) ，右下角位于 (200， 200) 的矩形。

// Create the bitmap to be used by the bitmap brush.
if (SUCCEEDED(hr))
{
    hr = LoadResourceBitmap(
        m_pRenderTarget,
        m_pWICFactory,
        L"FERN",
        L"Image",
        &m_pBitmap
        );
   
}

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateBitmapBrush(
        m_pBitmap,
        &m_pBitmapBrush
        );
}

D2D1_RECT_F rcTransformedBrushRect = D2D1::RectF(100, 100, 200, 200);



 // Demonstrate the effect of transforming a bitmap brush.
 m_pBitmapBrush->SetTransform(
     D2D1::Matrix3x2F::Translation(D2D1::SizeF(50,50))
     );

 // To see the content of the rcTransformedBrushRect, comment
 // out this statement.
 m_pRenderTarget->FillRectangle(
     &rcTransformedBrushRect, 
     m_pBitmapBrush
     );

 m_pRenderTarget->DrawRectangle(rcTransformedBrushRect, m_pBlackBrush, 1, NULL);

要求

要求	值
标头	D2d1_1.h (包括 D2d1.h)
库	D2d1.lib
DLL	D2d1.dll

另请参阅

画笔概述

ID2D1Brush

�

�