PIE SDK图像裁剪

1.算法功能简介

图像裁剪的目的是获取选定的影像范围区域。图像裁切工具提供像素范围裁切、矢量裁切、栅格图像裁切和几何图元裁切四种方式。 像素范围裁切是基于像素坐标获取矩形裁切区域的裁切方式；矢量裁切是基于矢量地理坐标获取任意形状裁切区域的裁切方式； 栅格图像裁剪是基于栅格文件的坐标获取裁剪区域的裁剪方式； 几何图元裁切是基于交互方式在主视图上绘制多边形来获取裁切范围的裁切方式。

PIE支持算法功能的执行，下面对图像裁剪算法功能进行介绍。

2.算法功能实现说明

2.1. 实现步骤

第一步	算法参数设置
第二步	算法执行

2.2.  算法参数

算法名称	图像裁剪
C#算法DLL	PIE.CommonAlgo.dll
C#算法名称	PIE.CommonAlgo.ImageClipAlgo
参数结构体	DataPreImgClip_Exchange_Info
参数说明
InputFilePath	String	输入文件 (*.tif;*.tiff;*.bmp;*.img;*.jpg;*.ldf)
Type	Int	裁剪类型 0为以栅格来裁剪;1为用shp文件; 2为几何范围来裁剪
ShpFilePath	String	如果以shp文件裁剪，需要输入的shp文件路径
OutputFilePath	String	输出文件路径 (*.tif;*.tiff; *.img)
FileType	String	根据输出类型获得文件编码类型 .tif/.tiff——GTiff .img—————HFA 其他—————ENVI
XStart	Int	裁剪范围起始X
XEnd	Int	裁剪范围终点X
YStart	Int	裁剪范围起始Y
YEnd	Int	裁剪范围终点Y
bInvalidValue	bool	是否设置无效值
InvalidValue	double	无效值
FuncName	String	功能名称
ListBands	IList<Int>	输出裁剪影像的波段
Geometry	IGeometry	裁剪几何形状

2.3. 示例代码

项目路径	百度云盘地址下/PIE示例程序/10.算法调用/图像预处理/ClipAlgoDemo.Form1
数据路径	百度云盘地址下/PIE示例数据/ 栅格数据/04.World/World.tif 百度云盘地址下/PIE示例数据/ 矢量数据/Shape/省级行政区.shp
视频路径	百度云盘地址下/PIE视频教程/10.算法调用/图像预处理/图像裁剪算法.avi
示例代码
//（一）通过栅格范围裁剪 /// <summary> ///图像裁剪算法测试,本算法实现了将World.tif根据起始点(0,0)到终止点（500,500）的矩形范围裁剪生成clip_xy.tif文件 /// </summary> private void button_xy_Click () { #region 1、参数设置 //Clip裁剪 PIE.CommonAlgo.DataPreImgClip_Exchange_Info info = new PIE.CommonAlgo.DataPreImgClip_Exchange_Info(); info.InputFilePath = @"D:\Data\World.tif"; //待裁剪影像 PIE.DataSource.IRasterDataset rDataset = PIE.DataSource.DatasetFactory.OpenRasterDataset(info.InputFilePath, PIE.DataSource.OpenMode.ReadOnly); if (rDataset == null) return; int count=rDataset.GetBandCount(); List<int> list = new List<int> { }; for (int i = ; i < count; i++) { list.Add(i); } info.listBands = list; info.XFactor = ; info.YFactor = ; info.bInvalidValue = false; info.OutputFilePath = @"D:\Data\clip_xy.tif"; //裁剪保存结果 info.Type = ; // (等于0表示通过栅格范围裁剪) info.XStart = ; info.XEnd = ; info.YStart = ; info.YEnd = ; info.FileType = "GTiff"; //Tiff数据的FileTypeCode为“GTiff”,IMG数据的FileTypeCode为"HFA",其他格式的为"ENVI"。; PIE.SystemAlgo.ISystemAlgo algo = PIE.SystemAlgo.AlgoFactory.Instance().CreateAlgo("PIE.CommonAlgo.dll", "PIE.CommonAlgo.ImageClipAlgo"); if (algo == null) return; #endregion //2、算法执行 PIE.SystemAlgo.ISystemAlgoEvents algoEvents = algo as PIE.SystemAlgo.ISystemAlgoEvents; algo.Name = "影像裁剪"; algo.Params = info; //PIE.SystemAlgo.AlgoFactory.Instance().AsynExecuteAlgo(algo); //bool OK = PIE.SystemAlgo.AlgoFactory.Instance().ExecuteAlgo(algo); bool OK = algo.Execute(); MessageBox.Show("裁剪成功！"); } //（二）使用shape文件裁剪 /// <summary> ///图像裁剪算法测试,本算法实现了将World.tif根据省级行政区.shp文件裁剪生成clip_shp.tif文件 /// </summary> private void button_shp_Click () { #region 1、参数设置 //Clip裁剪 PIE.CommonAlgo.DataPreImgClip_Exchange_Info info = new PIE.CommonAlgo.DataPreImgClip_Exchange_Info(); //参数设置 string featurePath = @"D:\Data\省级行政区.shp"; //裁剪的几何要素 info.InputFilePath = @"D:\Data\World.tif"; //待裁剪影像 PIE.DataSource.IRasterDataset rDataset = PIE.DataSource.DatasetFactory.OpenRasterDataset(info.InputFilePath, PIE.DataSource.OpenMode.ReadOnly); if (rDataset == null) return; int count = rDataset.GetBandCount(); List<int> list = new List<int> { }; for (int i = ; i < count; i++) { list.Add(i); } info.listBands = list; info.bInvalidValue = false; info.OutputFilePath = @"D:\Data\clip_shp.tif"; //裁剪保存结果 info.ShpFilePath = featurePath; info.Type = ; // (等于1表示使用shape文件裁剪) info.FileType = "GTiff"; //Tiff数据的FileTypeCode为“GTiff”,IMG数据的FileTypeCode为"HFA",其他格式的为"ENVI"。; PIE.SystemAlgo.ISystemAlgo algo = PIE.SystemAlgo.AlgoFactory.Instance().CreateAlgo("PIE.CommonAlgo.dll", "PIE.CommonAlgo.ImageClipAlgo"); if (algo == null) return; #endregion //2、算法执行 PIE.SystemAlgo.ISystemAlgoEvents algoEvents = algo as PIE.SystemAlgo.ISystemAlgoEvents; algo.Name = "影像裁剪"; algo.Params = info; PIE.SystemAlgo.AlgoFactory.Instance().AsynExecuteAlgo(algo); //bool OK = PIE.SystemAlgo.AlgoFactory.Instance().ExecuteAlgo(algo); //bool OK = algo.Execute(); MessageBox.Show("裁剪成功！"); } //（三）使用几何范围裁剪 /// <summary> ///图像裁剪算法测试,本算法实现了将World.tif根据省级行政区.shp文件中索引为0的geometry裁剪生成clip_shp.tif文件 /// </summary> private void button_geometry_Click () { #region 1、参数设置 //Clip裁剪 PIE.CommonAlgo.DataPreImgClip_Exchange_Info info = new PIE.CommonAlgo.DataPreImgClip_Exchange_Info(); //参数设置 string featurePath = @"D:\Data\省级行政区.shp"; //裁剪的几何要素 PIE.DataSource.IFeatureDataset fDataset = PIE.DataSource.DatasetFactory.OpenFeatureDataset(featurePath); PIE.DataSource.IFeature feature = fDataset.GetNextFeature(); fDataset.ResetReading(); PIE.Geometry.IGeometry geometryClip = null; while (feature != null) { geometryClip = feature.Geometry; feature = fDataset.GetNextFeature(); break; } info.InputFilePath = @"D:\Data\World.tif"; //待裁剪影像 PIE.DataSource.IRasterDataset rDataset = PIE.DataSource.DatasetFactory.OpenRasterDataset(info.InputFilePath, PIE.DataSource.OpenMode.ReadOnly); if (rDataset == null) return; int count = rDataset.GetBandCount(); List<int> list = new List<int> { }; for (int i = ; i < count; i++) { list.Add(i); } info.listBands = list; info.bInvalidValue = false; info.OutputFilePath = @"D:\Data\clip_geometry.tif"; //裁剪保存结果 info.Type = ; // (等于2表示使用几何范围裁剪) info.Geometry = geometryClip; info.FileType = "GTiff"; //Tiff数据的FileTypeCode为“GTiff”,IMG数据的FileTypeCode为"HFA",其他格式的为"ENVI"。; PIE.SystemAlgo.ISystemAlgo algo = PIE.SystemAlgo.AlgoFactory.Instance().CreateAlgo("PIE.CommonAlgo.dll", "PIE.CommonAlgo.ImageClipAlgo"); if (algo == null) return; #endregion //2、算法执行 PIE.SystemAlgo.ISystemAlgoEvents algoEvents = algo as PIE.SystemAlgo.ISystemAlgoEvents; algo.Name = "影像裁剪"; algo.Params = info; PIE.SystemAlgo.AlgoFactory.Instance().AsynExecuteAlgo(algo); //bool OK = PIE.SystemAlgo.AlgoFactory.Instance().ExecuteAlgo(algo); //bool OK = algo.Execute(); MessageBox.Show("裁剪成功！"); }

2.4. 示例截图

（一）通过栅格范围裁剪

（二）使用shape文件裁剪

（三）使用几何范围裁剪