Direct2D教程(七)单色画刷
概述
画刷是D2D中最重要的资源之一,无论绘制什么图形,都离不开画刷,它好比是画家手中的画笔。画刷由render target创建,是设备相关的资源,如果渲染设备重建了,那么需要重新建立画刷。Direct2D中有以下四种类型的画刷,这些画刷全部继承自ID2D1Brush,并且有一些共同特征(比如设置和获取opacity,以及transform)。
- ID2D1SolidColorBrush 单色画刷
- ID2D1LinearGradientBrush 线性梯度色画刷
- ID2D1RadialGradientBrush 放射梯度色画刷
- ID2D1BitmapBrush 位图画刷
下面是几种画刷及其对应的绘制效果
画刷属性
颜色
在使用除位图画刷以外的任何一种画刷绘制之前,你必须首先指定颜色。在Direct2D中,颜色用D2D1_COLOR_F结构体表示(实际上相当于Direct3D中的D3DCOLORVALUE,只不过换了个名字而已)。D2D1_COLOR_F使用sRGB编码,sRGB编码将颜色分成四部分:红色,绿色,蓝色以及Alpha(透明值)。每个部分都由一个浮点数表示,范围是0.0-1.0。数值越大表示颜色越深,0.0表示无此颜色,1.0表示满色。对于Alpha(透明值),0.0表示完全透明,1.0表示完全不透明。可以使用D2D1::ColorF类的构造函数来创建颜色,这个类有三个构造函数,所以有下面三种方法。
使用ColorF(knownColor, FLOAT),第一个参数是Direct2D预定义的一种颜色,第二个参数是Alpha值。
hr = m_pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF::Black, 1.0f),
&m_pBlackBrush
);
使用ColorF(FLOAT, FLOAT, FLOAT, FLOAT),参数分别是,红色值,绿色值,蓝色值和Alpha值。
ID2D1SolidColorBrush *pGridBrush = NULL;
hr = pCompatibleRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF(0.93f, 0.94f, 0.96f, 1.0f)),
&pGridBrush
);
使用ColorF(UINT32 rgb, FLOAT a),第一个参数是十六进制格式的颜色,是0xRRGGBB的形式,第二个参数是Alpha值。
hr = m_pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF(0x9ACD32, 1.0f)),
&m_pYellowGreenBrush
);
透明度
英文叫opacity,当opacity值为0时,图形完全透明,当opacity值为1时,图形无影响。
变换(Transform)
画刷的第三个属性是只对画刷所应用的变换,这通常是一个变换矩阵。注意这个属性目前只对位图画刷起作用,其他类型的画刷不受这个属性的影响。
设置属性
有两种方法设置画刷的属性,第一种是在定义画刷的时候指定属性,可以使用如下的结构体进行设置。
struct D2D1_BRUSH_PROPERTIES {
FLOAT opacity;
D2D1_MATRIX_3X2_F transform;
};
下面代码使用该结构体设置属性并创建画刷。
D2D1_BRUSH_PROPERTIES brushProperties = { 1.0f, D2D1::Matrix3x2F::Identity() } ;
// Create brush
hr = pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF::Black),
brushProperties,
&pStrokeBrush
) ;
D2D也提供了一个函数来快速常见属性,这个函数如下
D2D1_BRUSH_PROPERTIES BrushProperties(
__in FLOAT opacity = 1.0,
__in const D2D1_MATRIX_3X2_F &transform = D2D1::IdentityMatrix()
);
所以上面创建画刷的代码可以改写成
hr = pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF::Black),
D2D1::BrushProperties(),
&pStrokeBrush
) ;
第二种是先创建画刷,再设置属性。一般是在一个图形之前设置画刷的属性,在绘制另外一个图形之前再次设置其属性,这样同一个画刷可以绘制出不同的效果来。
// 先创建画刷
hr = pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF::Black),
&pStrokeBrush
) ;
// 再设置属性,注意SetTransform对于单色画刷是没有作用的,这里只做演示。
pStrokeBrush->SetOpacity(1.0f);
pStrokeBrush->SetColor(D2D1::ColorF(D2D1::ColorF::Green)) ;
pStrokeBrush->SetTransform(D2D1::Matrix3x2F::Rotation(45.0f, D2D1::Point2F(150.0f, 150.0f))) ;
使用单色画刷
下面以单色画刷为例,看看如何使用画刷。单色画刷并不影响性能,所以你可以在任何需要的时候创建它而不必考虑性能问题,但是梯度色画刷和位图画刷则不然。当我们创建了一个render target之后,就可以使用其成员函数CreateSolidColorBrush来创建单色画刷了。这个函数的定义如下。
HRESULT CreateSolidColorBrush(
[ref] const D2D1_COLOR_F &color,
[ref] const D2D1_BRUSH_PROPERTIES &brushProperties,
[out] ID2D1SolidColorBrush **solidColorBrush
);
看一下参数,第一个参数是画刷的颜色。第二个参数是画刷的属性,这个属性是一个结构体,上面已经提到过了。最后一个参数是一个ID2D1SolidColorBrush**类型的变量,用来接收创建后的画刷。
这个函数还有一个重载版本,省略了上面的第二个参数,我们一般情况下使用这个重载版本就足够用了。
HRESULT CreateSolidColorBrush(
[ref] const D2D1_COLOR_F &color,
[out] ID2D1SolidColorBrush **solidColorBrush
);
创建画刷
下面的代码创建了两个画刷,一个黑色的用来绘制矩形轮廓,一个黄色的用来填充矩形。
// Create a black brush to draw rectangle outline
hr = pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF::Black),
&pBlackBrush
) ;
// Create a yellow brush to fill in the rectangle
hr = pRenderTarget->CreateSolidColorBrush(
D2D1::ColorF(D2D1::ColorF(D2D1::ColorF::Yellow, 1.0f)),
&pYellowBrush
);
使用画刷
下面的代码先使用黑色画刷绘制矩形,然后使用黄色画刷填充之。
// Draw Rectangle
pRenderTarget->DrawRectangle(
&rectangle,
pBlackBrush
);
// Fill rectangle
pRenderTarget->FillRectangle(
&rectangle,
pYellowBrush
) ;
释放画刷
画刷使用完毕后要释放
pBlackBrush->Release() ;
pBlackBrush = NULL ;
pYellowBrush->Release() ;
pYellowBrush = NULL ;
Happy Coding!!!
== THE END ==
源文档 <http://www.cnblogs.com/graphics/archive/2011/06/03/1967193.html>