StencilAreas

演示示例： Maps with intensity series stencil; Chromaticity diagram, Silicon wafer map analysis （仅WinForms）

IntensityGridSeries、IntensityMeshSeries 和 Maps 具有 StencilArea 功能，可在绘制的数据区域内或外进行屏蔽。例如，如果数据显示在地图上，模板可以用来将可见数据限制在例如国家等特定的地图区域。通过创建一个新的StencilArea对象可以应用 StencilArea，然后通过AddPolygon（）定义其规格为PointDouble2D数组，或通过AddMapLayerIndex（）定义为一个地图图层，最后将它们添加到应该屏蔽的系列中。

StencilAreas有两种类型：

• AdditiveAreas 创建一种阳掩模板——仅绘制区域内部的数据，外部的则裁剪掉。

• SubtractiveAreas创建一种阴掩模板——区域内部的数据会被裁剪掉，而绘制外部的数据。注意，SubtractiveAreas只可与AdditiveAreas一起使用，没有二者不能进行裁剪。

每当向列表（AdditiveAreas或SubtractiveAreas）中添加一个 StencilArea 对象，应该为各系列分别调用InvalidateStencil（）或 InvalidateData（）。另外还建议将定义模板的点的数组按顺时针顺序设置。

AdditiveAreas

用 AdditiveAreas 来定义需要绘制的区域。外部的都会被剪裁掉。

// 为IntensityGrid定义一个累加的 StencilArea

PointDouble2D[] stencilPoints = new PointDouble2D[] {
		new PointDouble2D（30, 5）,
		new PointDouble2D（30, 95）,
		new PointDouble2D（195, 95）,
		new PointDouble2D（195, 5）
};
StencilArea stencilArea = new StencilArea（_intensityGrid.Stencil）;
stencilArea.AddPolygon（StencilPoints）;
_intensityGrid.Stencil.AdditiveAreas.Add（stencilArea）;
_intensityGrid.InvalidateStencil（）;

图：顶部位不带有任何模板的IntensityGrid；底部，同一个网格带有使用上述代码创建的AdditiveArea

SubstractiveAreas

用 SubstractiveAreas 来定义应绘制于AdditiveArea内部的区域

// 对IntensityGrid定义两个差减的StencilAreas

PointDouble2D[] pnt2 = new PointDouble2D[] {
		new PointDouble2D（130, 70）,
		new PointDouble2D（130, 90）,
		new PointDouble2D（160, 90）,
		new PointDouble2D（160, 70）,
};
StencilArea stencilArea2 = new StencilArea（_heatMap.Stencil）;
stencilArea2.AddPolygon（pnt2）;
_heatMap.Stencil.SubtractiveAreas.Add（stencilArea2）;
_heatMap.InvalidateStencil（）;

PointDouble2D[] pnt3 = new PointDouble2D[] {
		new PointDouble2D（50, 10）,
		new PointDouble2D（50, 25）,
		new PointDouble2D（90, 25）,
		new PointDouble2D（90, 10）,
};
StencilArea stencilArea3 = new StencilArea（_heatMap.Stencil）;
stencilArea3.AddPolygon（pnt3）;
_heatMap.Stencil.SubtractiveAreas.Add（stencilArea3）;
_heatMap.InvalidateStencil（）;

图：用上述代码设置带有两个SubstractiveAreas的 IntensityGrid。 注意，在使用SubstractiveAreas之前必须先设置一个AdditiveArea

多重StencilAreas

可以设置多重StencilAreas，累加和差减两种都有。如果有两个或两个以上的区域重叠，则将这些区域连接起来。

图：采用多重 StencilAreas；一些 SubstractiveAreas 重叠起来，这样区域便连接在一起。另外还绘制有带有可见边框的透明多边形来标记模板的位置。

关于StencilAreas图库简介章节就分享到这里了，如果在实际应用中遇到技术问题或需要帮助，可以扫描下方微信二维码 回复“学习”可免费领取一套全功能板LightningChart数据可视化控件。

后续我会不断更新LightingChart更详细的使用方法，写文不易，还望多多回复关注支持！谢谢！

最新版V10 LightningChart下载地址：猛击下载