Direct2D教程（三）简单几何图形
从本章开始，我们介绍D2D几何图形。
D2D图形分类
Direct2D支持多种类型的几何图形，包括
Simple Geometry（简单几何图形）
- 矩形
- 圆角矩形
- 椭圆
Path Geometry（路径图形）
Composite Geometry（复合图形）
- Geometry Group（图形组）
- Transformed Geometry（变换的图形）
各种图形对应的D2D接口如下，所有接口都继承自ID2D1Geometry。
- 矩形-ID2D1RectangleGeometry
- 圆角矩形-ID2D1RoundedRectangleGeometry
- 椭圆-ID2D1EllipseGeometry
- 路径图形-ID2D1PathGeometry
- 图形组-ID2D1GeometryGroup
- 经过变换的图形-ID2D1TransformedGeometry
今天我们先来看一下简单几何图形，其他类型的图形将在后续章节中介绍，上面的简单图形有三种，其实还有一种，就是直线，所以D2D目前支持的简单图形有如下四种。
- Line - 直线
- Rectangle - 矩形
- Rounded Rectangle - 圆角矩形
- Ellipse - 椭圆
下面逐个介绍每种图形的绘制方法，绘制某种图形是通过Render target对象调用相应的绘图函数来完成的，所以下面的代码都假定Render target对象已经创建好了。
直线
绘制直线使用函数DrawLine，先看一下函数定义，前两个参数分别是直线的起点和终点，第三个参数是画刷。第四个参数是线的宽度，最后一个参数是线的样式，比如实线，虚线或是其他风格的线，你可以使用D2D提供的样式，也可以自己定义样式。由于最后两个参数有默认值，所以我们通常只提供前三个参数即可。最后两个参数在下面的绘图函数中都有出现。
virtual void DrawLine( D2D1_POINT_2F point0, D2D1_POINT_2F point1, [in] ID2D1Brush *brush, FLOAT strokeWidth = 1.0f, [in, optional] ID2D1StrokeStyle *strokeStyle = NULL ) = 0;
下面的代码绘制一条黑色直线，起点是（100, 100），终点是（500, 500）。
D2D1::Point2F(100.f, 100.f),
D2D1::Point2F(500.f, 500.f),
pBlackBrush);
矩形
矩形使用如下的结构体表示。
FLOAT left;
FLOAT top;
FLOAT right;
FLOAT bottom;
};
绘制矩形使用函数DrawRectangle，定义如下。第一个参数是D2D1_RECT_F结构，表示待绘制的矩形，它其他参数前面已经提到过，不再赘述。
[ref] const D2D1_RECT_F &rect,
[in] ID2D1Brush *brush,
FLOAT strokeWidth =1.0f,
[in, optional] ID2D1StrokeStyle *strokeStyle = NULL
);
下面的代码绘制一个矩形，该矩形的左上角坐标是（100, 100），右下角坐标是（500, 500）。
D2D1::RectF(100.f, 100.f, 500.f, 500.f),
pBlackBrush
);
圆角矩形
D2D支持圆角矩形，先看看什么是圆角矩形。
可见圆角矩形就是常规矩形的改版，将尖角用圆弧代替即可。所以一个圆角矩形可以由一个普通矩形加上两个半径构造而成，这两个半径分别表示椭圆的X轴和Y轴，而这个椭圆则用来取代矩形的尖角。圆角矩形的定义如下：第一个参数是一个常规矩形，上面已经介绍过，后两个参数分别是椭圆的X轴半径和Y轴半径。
__in const D2D1_RECT_F &rect,
FLOAT radiusX,
FLOAT radiusY
);
绘制圆角矩形的函数定义如下，第一个参数是一个圆角矩形，后面的参数不再赘述。
[ref] const D2D1_ROUNDED_RECT &roundedRect,
[in] ID2D1Brush *brush,
FLOAT strokeWidth =1.0f,
[in, optional] ID2D1StrokeStyle *strokeStyle = NULL
);
下面的代码绘制一个圆角矩形，其左上角坐标是（100, 100），右下角坐标是（500, 500）。圆角的X轴半径是30，Y轴半径是50。
D2D1::RectF(100.f, 100.f, 500.f, 500.f),
30.0f,
50.0f
pRenderTarget->DrawRoundedRectangle(roundedRect, pBlackBrush, 1.0f) ;
椭圆
椭圆由如下所示的结构体定义，第一个参数是椭圆的中心，后两个参数分别是X轴半径和Y轴半径。
D2D1_POINT_2F point;
FLOAT radiusX;
FLOAT radiusY;
};
绘制椭圆的函数定义如下
[ref] const D2D1_ELLIPSE &ellipse,
[in] ID2D1Brush *brush,
FLOAT strokeWidth =1.0f,
[in, optional] ID2D1StrokeStyle *strokeStyle = NULL
);
下面的代码绘制一个椭圆，中心在（100, 100），长轴半径100，短轴半径50。
pRenderTarget->DrawEllipse(ellipse, pBlackBrush) ;
三角形
D2D没有提供绘制三角形的函数，不过我们可以使用DrawLine函数自己实现一个，代码很简单，对于给定的三个顶点，在每两个顶点之间调用上面的DrawLine函数即可。
ID2D1HwndRenderTarget* pRenderTarget,
ID2D1Brush* brush,
FLOAT strokeWidth =1.0f,
ID2D1StrokeStyle *strokeStyle = NULL)
{
pRenderTarget->DrawLine(p0, p1, brush);
pRenderTarget->DrawLine(p1, p2, brush) ;
pRenderTarget->DrawLine(p2, p0, brush) ;
}
圆
D2D同样没有提供绘制圆的函数，因为圆是特殊的椭圆，可以通过绘制椭圆的函数来实现，只要使X轴半径和Y轴半径相等即可。
ID2D1HwndRenderTarget* pRenderTarget,
ID2D1Brush* brush,
FLOAT strokeWidth =1.0f,
ID2D1StrokeStyle *strokeStyle = NULL
{
D2D1_ELLIPSE ellipse = D2D1::Ellipse(center, radius, radius) ;
pRenderTarget->DrawEllipse(ellipse, brush) ;
}
线条的宽度
每个DrawXXX函数都有一个参数strokeWidth，代表的是线条的宽度，这个函数有个默认值1.0，所以通常情况下我们无需指定这个参数，但如果想让线条宽一些，那么可以设置成10.0，100.0等等，那么这个宽度是如何增长的呢？会影响图形的大小么？
通过实际绘图发现，这个宽度是向外增长的，也就是说线条的宽度不会影响图形的填充区域，比如一个10 x 10的矩形，当线条宽度是1.0时，它的填充面积是100，当线条宽度是10时，它的填充面积还是100。请看下图，黑色是线条颜色，黄色是填充色，可见无论线条多宽，黄色区域的面积始终不变。所以strokeWidth并不影响图形的填充区域。
Happy Coding!!!
== THE END ==
