GetStyleTable
virtual OGRStyleTable *GetStyleTable ()
返回图层样式表
返回: 指向不应由调用方修改或释放的样式表的指针
// 假设图层对象为 poLayer
OGRStyleTable* poStyleTable = poLayer->GetStyleTable();
if (poStyleTable != nullptr) {// 处理样式表信息// ...
} else {// 图层没有关联样式表// ...
}
SetStyleTableDirect
virtual void SetStyleTableDirect(OGRStyleTable *poStyleTable )
设置图层样式表
参数:
poStyleTable -- 指向要设置的样式表的指针
// 假设图层对象为 poLayer,样式表对象为 poStyleTable
poLayer->SetStyleTableDirect(poStyleTable);
StartTransaction
Virtual OGRErr StartTransaction()
对于支持事务的数据源,StartTransaction 会创建一个事务
返回: OGRERR_NONE成功
// 假设图层对象为 poLayer
if (poLayer->StartTransaction() == OGRERR_NONE) {// 在事务中进行一系列操作// ...// 提交事务poLayer->CommitTransaction();
} else {// 处理事务启动失败的情况
}
在 OGR 中,图层可以支持事务,通过调用
StartTransaction()
可以在图层中开始一个事务。在事务中,可以进行一系列的图层操作,例如添加要素、修改要素、删除要素等。当所有的操作都执行完成后,可以调用CommitTransaction()
来提交事务,表示所有操作都成功执行。如果在事务过程中出现了错误,可以调用RollbackTransaction()
来回滚事务,表示撤销之前的所有操作
CommitTransaction
virtual OGRErr CommitTransaction()
对于支持事务的数据源,提交事务提交事务
返回: OGRERR_NONE成功
RollbackTransaction
Virtual OGRErr RollbackTransaction()
对于支持事务的数据源,RollbackTransaction 会将数据源回滚到当前事务开始之前的状态
返回: OGRERR_NONE成功
// 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 开始事务poDS->StartTransaction();// 创建新要素OGRFeature* poFeature = new OGRFeature(poLayer->GetLayerDefn());// 设置要素属性poFeature->SetField("name", "New Feature");poFeature->SetField("population", 10000);// 创建新几何图形并设置为要素的几何图形OGRPoint point(100, 200);poFeature->SetGeometry(&point);// 将新要素添加到图层中if (poLayer->CreateFeature(poFeature) != OGRERR_NONE) {printf("添加要素失败!\n");poDS->RollbackTransaction(); // 回滚事务,撤销之前的操作OGRDataSource::DestroyDataSource(poDS);delete poFeature;exit(1);}// 提交事务,保存更改poDS->CommitTransaction();
GetFIDColumn
virtual const char *GetFIDColumn()
此方法返回用作 FID 列的基础数据库列的名称,如果不支持,则返回 ""
返回: FID 列名称
// 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 获取用于唯一标识要素的字段的名称const char* fid_column = poLayer->GetFIDColumn();if (fid_column != nullptr) {printf("用于唯一标识要素的字段名称:%s\n", fid_column);} else {printf("图层中没有用于唯一标识要素的字段。\n");}
GetGeometryColumn
virtual const char *GetGeometryColumn()
此方法返回用作几何列的基础数据库列的名称,如果不支持,则返回 “”
对于具有多个几何字段的图层,此方法仅返回第一个几何列的名称
返回: 几何列名称
// 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 获取存储几何信息的字段的名称const char* geometry_column = poLayer->GetGeometryColumn();if (geometry_column != nullptr) {printf("存储几何信息的字段名称:%s\n", geometry_column);} else {printf("图层中没有存储几何信息的字段。\n");}
SetIgnoredFields
virtual OGRErr SetIgnoredFields(const char **papszFields)
设置从图层检索要素时可以省略的字段
参数:
papszFields -- 以 NULL 项结尾的字段名称数组。如果传递 NULL,则清除忽略的列表。
返回: OGRERR_NONE是否已解析所有字段名称(即使驱动程序不支持此方法)
// 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 定义要忽略的字段数组const char* papszFields[] = {"field1", "field2"};// 设置要忽略的字段OGRErr err = poLayer->SetIgnoredFields(papszFields);if (err != OGRERR_NONE) {// 处理设置忽略字段时发生的错误}// 其他处理代码...
GetIgnoredFields可以拿到忽略字段列表
// 获取当前设置的忽略字段列表char** papszIgnoredFields = poLayer->GetIgnoredFields();// 打印忽略字段列表for (int i = 0; papszIgnoredFields[i] != nullptr; i++) {printf("Ignored Field: %s\n", papszIgnoredFields[i]);}
GetGeometryTypes
virtual OGRGeometryTypeCounter *GetGeometryTypes(int iGeomField, int nFlagsGGT, int &nEntryCountOut, GDALProgressFunc pfnProgress, void *pProgressData)
获取在要素中找到的实际几何类型
参数:
-
iGeomField -- 几何字段索引。
-
nFlagsGGT -- 提示标志。0 或 OGR_GGT_COUNT_NOT_NEEDED、OGR_GGT_STOP_IF_MIXED、OGR_GGT_GEOMCOLLECTIONZ_TINZ的组合
-
nEntryCountOut -- [out] 返回数组中的条目数。
-
pfnProgress-- 取消回调。可能为空。
-
pProgressData -- 取消回调的用户数据。可能为空。
返回: 一个 nEntryCount 数组,如果出现错误,必须使用 CPLFree() 或 NULL 释放
Intersection
OGRErr Intersection(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions = nullptr, GDALProgressFunc pfnProgress = nullptr, void *pProgressArg = nullptr)
两层的交集
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回:
如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
Union
OGRErr Union(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions = nullptr, GDALProgressFunc pfnProgress = nullptr, void *pProgressArg = nullptr)
两层并集
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回:
如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Union(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();
SymDifference
OGRErr SymDifference(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions, GDALProgressFunc pfnProgress, void *pProgressArg)
两层对称差异(交集取反)
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回:
如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->SymDifference(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();
Identity
OGRErr Identity(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions = nullptr, GDALProgressFunc pfnProgress = nullptr, void *pProgressArg = nullptr)
将此图层的特征与标识层中的特征标识
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回:
如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("Identity_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的恒等并将结果写入输出图层
OGRErr err = pLayer1->Identity(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();
Update
OGRErr Update(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions = nullptr, GDALProgressFunc pfnProgress = nullptr, void *pProgressArg = nullptr)
使用更新图层中的要素更新此图层
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回:
如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Update(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();
Clip
OGRErr Clip(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions = nullptr, GDALProgressFunc pfnProgress = nullptr, void *pProgressArg = nullptr)
裁剪方法图层未覆盖的区域
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回:如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Clip(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();
Erase
OGRErr Erase(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions = nullptr, GDALProgressFunc pfnProgress = nullptr, void *pProgressArg = nullptr)
移除方法图层覆盖的区域
参数:
-
pLayerMethod -- 方法层。不应为 NULL。
-
pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。
-
papszOptions -- NULL 终止的选项列表(可能为 NULL)。
-
pfnProgress -- 一个与 GDALProgressFunc() 兼容的回调函数,用于报告进度或 NULL。
-
pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。
返回: 如果出现错误或执行中断,则为错误代码,否则OGRERR_NONE
// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Erase(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();
Reference
int Reference()
递增图层引用计数
返回:递增后的引用计数
Dereference
int Dereference()
递减图层参考计数
返回:递减后的引用计数
ReorderField
OGRErr ReorderField(int iOldFieldPos, int iNewFieldPos)
对图层上的现有字段重新排序
参数:
-
iOldFieldPos -- 要移动的字段的先前位置。必须在 [0,GetFieldCount()-1] 范围内。
-
iNewFieldPos -- 要移动的字段的新位置。必须在 [0,GetFieldCount()-1] 范围内。
返回: OGRERR_NONE成功
// 获取输入图层
OGRLayer* pLayer = poInputDS->GetLayer(0);// 获取字段总数
int fieldCount = pLayer->GetLayerDefn()->GetFieldCount();// 假设我们要将第1个字段移动到第3个位置
int oldFieldPos = 0; // 第1个字段的位置(索引从0开始)
int newFieldPos = 2; // 新的位置(索引从0开始)if (oldFieldPos < 0 || oldFieldPos >= fieldCount || newFieldPos < 0 || newFieldPos >= fieldCount) {// 检查字段位置是否有效// 可以根据需要添加其他错误处理逻辑return OGRERR_FAILURE;
}// 重新排列字段
OGRErr err = pLayer->ReorderField(oldFieldPos, newFieldPos);
if (err != OGRERR_NONE) {// 重新排列失败,可以根据需要添加错误处理逻辑return err;
}// 保存并关闭数据源
pLayer->SyncToDisk();