c++ qgis二次开发 单波段渲染编辑

### C++ QGIS 插件开发中的单波段栅格渲染定制化实现 在 QGIS 的插件开发过程中，通过 C++ 可以灵活地扩展其功能。针对单波段栅格渲染的定制化实现，主要依赖于 `QgsRasterRenderer` 和其派生类的功能接口。 #### 单波段伪彩渲染器的核心概念 为了实现单波段伪彩渲染，通常会使用 `QgsSingleBandPseudoColorRenderer` 类。该类允许开发者定义一个颜色渐变表（color ramp），并将像素值映射到指定的颜色范围内[^1]。 以下是详细的实现流程及相关代码示例： --- #### 1. 创建栅格图层对象 首先需要创建或加载一个有效的栅格图层对象。这一步骤可以通过文件路径初始化完成。 ```cpp #include <qgsapplication.h> #include <qgsproject.h> #include <qgsrasterlayer.h> QString rasterFilePath = "/path/to/your/raster.tif"; QgsRasterLayer *rasterLayer = new QgsRasterLayer(rasterFilePath, "Sample Raster", "gdal"); if (!rasterLayer->isValid()) { qDebug() << "Error loading raster layer."; } else { QgsProject::instance()->addMapLayer(rasterLayer); } ``` 上述代码片段展示了如何从本地文件加载栅格数据，并将其添加至当前项目中。 --- #### 2. 配置单波段伪彩渲染器 接下来，配置用于渲染的 `QgsSingleBandPseudoColorRenderer` 对象。这里的关键是构建一个合理的颜色渐变表，并将其绑定到具体的波段上。 ```cpp #include <qgssinglebandpseudocolorrenderer.h> #include <qgscolormap.h> #include <qgsrastershader.h> int bandNumber = 1; // 假设我们操作的是第一个波段 // 构建颜色渐变条目列表 QList<QgsColorRampShader::ColorRampItem> colorRampItems; colorRampItems << QgsColorRampShader::ColorRampItem(0, QColor(Qt::blue), "Low Value"); colorRampItems << QgsColorRampShader::ColorRampItem(128, QColor(Qt::yellow), "Medium Value"); colorRampItems << QgsColorRampShader::ColorRampItem(255, QColor(Qt::red), "High Value"); // 初始化颜色渐变着色器 QgsColorRampShader colorRampShader(false, false); // 不启用分类模式 colorRampShader.setColorRampType(QgsColorRampShader::Interpolated); colorRampShader.setColorRampItemList(colorRampItems); // 将着色器封装入栅格着色器函数 QgsRasterShader *shader = new QgsRasterShader(); shader->setRasterShaderFunction(new QgsColorRampRasterShaderFunction(&colorRampShader)); // 创建单波段伪彩渲染器实例 QgsSingleBandPseudoColorRenderer *singleBandRenderer = new QgsSingleBandPseudoColorRenderer( rasterLayer->dataProvider(), bandNumber, *shader ); // 设置透明度参数 singleBandRenderer->setAlpha(255); // 应用渲染器到栅格图层 rasterLayer->setRenderer(singleBandRenderer); rasterLayer->triggerRepaint(); // 刷新视图以反映更改 ``` 这段代码实现了以下功能： - 定义了一个三阶段的颜色渐变表（蓝色 -> 黄色 -> 红色）。 - 使用 `QgsColorRampShader` 将颜色映射规则与实际像素值关联起来。 - 最终将渲染器应用于目标栅格图层，并触发界面刷新。 --- #### 3. 动态调整渲染属性 除了静态设定外，还可以提供交互式的控件供用户实时修改渲染参数。例如，允许用户拖动滑块改变最大最小值范围或者选择预定义的主题配色方案。 假设有一个 GUI 组件负责接收用户的输入信号，则可通过如下方式同步更新渲染状态： ```cpp void updateRendererRange(double minValue, double maxValue) { if (!rasterLayer || !singleBandRenderer) return; // 修改现有 Shader 函数的数值区间 QgsRasterShaderFunction *function = singleBandRenderer->shader()->rasterShaderFunction(); function->setValueRange(minValue, maxValue); // 提醒地图画布重绘 rasterLayer->triggerRepaint(); } ``` 调用此方法时传入新的上下限即可即时生效。 --- ### 总结 通过对 `QgsSingleBandPseudoColorRenderer` 的深入理解与实践运用，能够高效达成单波段栅格图像的个性化呈现需求。无论是基础版还是高级定制版本，均需围绕核心组件展开设计并注重用户体验优化。 ---