1.算法功能简介
自定义滤波可以自由设置滤波模板，对数据进行处理，自定义滤波器的一般规则要求：
（ 1） 滤波器的大小应该是奇数，这样它才有一个中心，例如 3x3， 5x5 或者 7x7。有中心了，也有了半径的称呼，例如 5x5 大小的核的半径就是 2。
（ 2） 滤波器矩阵所有的元素之和应该要等于 1，这是为了保证滤波前后图像的亮度保持不变。当然了，这不是硬性要求了。
（ 3） 如果滤波器矩阵所有元素之和大于 1，那么滤波后的图像就会比原图像更亮，反之，如果小于 1，那么得到的图像就会变暗。如果和为 0，图像不会变黑，但也会非常暗。
（ 4） 对于滤波后的结构，可能会出现负数或者大于 255 的数值。对这种情况，我们将他们直接截断到 0 和 255 之间即可。对于负数，也可以取绝对值。
PIE支持算法功能的执行，下面对自定义滤波算法功能进行介绍。
2.算法功能实现说明
2.1. 实现步骤
| 第一步 | 算法参数设置 |
| 第二步 | 算法执行 |
| 第三步 | 结果显示 |
2.2. 算法参数
| 算法名称 | 自定义滤波 | |
| C#算法DLL | PIE.CommonAlgo.dll | |
| C#算法名称 | PIE.CommonAlgo.ImgProFiltCustomAlgo | |
| 参数结构体 | StImageFittleCustom | |
| 参数说明 | ||
| InputFilePath | String | 输入文件 (*.tif;*.tiff; *.img) |
| OutputFilePath | String | 输出文件路径 (*.tif;*.tiff; *.img) |
| XMLFile | String | XML文件路径 (*.xml) |
| LM | Int | 模板大小M（最小为3的奇数），最大为33 |
| LN | Int | 模板大小N（最小为3的奇数，和LM值一样） |
| FilterType | Int | 滤波类型 |
| Kernel | array<float> | 自定义滤波值数组（LM* LN大小的数组） |
| FuncName | String | 功能名称 |
| FileTypeCode | String | 根据输出类型获得文件编码类型 .tif/.tiff——GTiff .img—————HFA 其他—————ENVI |
| LowBands | IList<Int> | 输出影像的波段（至少选择一个波段，{ 0, 1, 2, 3 }） |
2.3. 示例代码
| 项目路径 | 百度云盘地址下/PIE示例程序/10.算法调用/图像处理/ ImageProcessing. ImgFiltCustomAlgo |
| 数据路径 | 百度云盘地址下/PIE示例数据/栅格数据/04.World/World.tif |
| 视频路径 | 百度云盘地址下/PIE视频教程/10.算法调用/图像处理/自定义滤波算法.avi |
| 示例代码 | |
1 /// <summary> 2 /// 自定义滤波算法测试,本算法实现了将World.tif进行自定义滤波，模板大小M和N均为3 3 /// 自定义滤波值数组为{ 1, 1, 1, 1, 1, 1, 1, 1, 1 } 4 /// </summary> 5 public override void OnClick() 6 { 7 #region 1、参数设置 8 PIE.CommonAlgo.StImageFittleCustom info = new PIE.CommonAlgo.StImageFittleCustom(); 9 10 info.InputFilePath = @"D:\Data\World.tif"; 11 info.OutputFilePath = @"D:\Data\ip_result18.tif"; 12 info.LM = 3; 13 info.LN = 3; 14 info.FilterType = 0; 15 info.Kernel = new float[] { 1, 1, 1, 1, 1, 1, 1, 1, 1 }; 16 info.FileTypeCode = "GTiff"; 17 info.LowBands = new List<int> { 0, 1, 2 }; 18 19 PIE.SystemAlgo.ISystemAlgo algo = PIE.SystemAlgo.AlgoFactory.Instance().CreateAlgo("PIE.CommonAlgo.dll", "PIE.CommonAlgo.ImgProFiltCustomAlgo"); 20 if (algo == null) return; 21 #endregion 22 23 //2、算法执行 24 PIE.SystemAlgo.ISystemAlgoEvents algoEvents = algo as PIE.SystemAlgo.ISystemAlgoEvents; 25 algo.Name = " 自定义滤波"; 26 algo.Params = info; 27 bool result = PIE.SystemAlgo.AlgoFactory.Instance().ExecuteAlgo(algo); 28 29 //3、结果显示 30 ILayer layer = PIE.Carto.LayerFactory.CreateDefaultLayer(@"D:\Data\ip_result18.tif"); 31 m_HookHelper.ActiveView.FocusMap.AddLayer(layer); m_HookHelper.ActiveView.PartialRefresh(ViewDrawPhaseType.ViewAll); 32 } | |
2.4.示例截图
