GDAL C++ API 学习之路 OGRGeometry 圆弧类 OGRCircularString
OGRCircularString Class <ogrsf_frmts.h>
OGRCircularString 类是 OGR 几何库中的一个类，用于表示圆弧字符串（circular string）类型的几何图形。圆弧字符串是由一系列圆弧段组成的几何图形，每个圆弧段由三个点定义：起始点、中间点和终止点。这些圆弧段可以连接成一个闭合的圆弧字符串，也可以构成一个非闭合的曲线
Public Functions
OGRCircularString()
创建一个空的圆弧字符串
OGRCircularString（const OGRCircularString &other)
复制构造函数
OGRCircularString &operator=（const OGRCircularString &other)
赋值运算符
importFromWkb
virtual OGRErr importFromWkb(const unsigned char*, size_t, OGRwkbVariant, size_t &nBytesConsumedOut) override
从已知的二进制数据中指定几何图形
参数:
-
pabyData -- 二进制输入数据。
-
nSize -- pabyData 的大小（以字节为单位），如果不知道，则为 -1。
-
eWkbVariant -- 如果 wkbVariantPostGIS1，则对曲线几何代码进行特殊解释
-
nBytesConsumptiondOut -- 输出参数。消耗的字节数。
返回: OGRERR_NONE如果一切顺利，否则OGRERR_NOT_ENOUGH_DATA、OGRERR_UNSUPPORTED_GEOMETRY_TYPE或OGRERR_CORRUPT_DATA中的任何一个都可能被退回
exportToWkb
virtual OGRErr exportToWkb(OGRwkbByteOrder, unsigned char*, OGRwkbVariant = wkbVariantOldOgc) const override
将几何图形转换为众所周知的二进制格式
参数:
-
eByteOrder -- wkbXDR 或 wkbNDR 之一，分别表示 MSB 或 LSB 字节顺序。
-
pabyData -- 写入二进制表示的缓冲区。此缓冲区的大小必须至少为 OGRGeometry：：WkbSize（） 字节。
-
eWkbVariant -- 导出三维（或更多）几何图形时使用什么标准。默认的 wkbVariantOldOgc 是历史的 OGR 变体。wkbVariantIso 是 ISO SQL/MM 中定义的变体，并被 OGC 用于 SFSQL 1.2。
返回: 当前始终返回OGRERR_NONE
importFromWkt
virtual OGRErr importFromWkt（const char**） override
从已知文本数据中指定几何图形
参数:
ppszInput -- 指向源文本指针的指针。指针将更新为已使用文本之后的指针。
返回: OGRERR_NONE如果一切顺利，否则OGRERR_NOT_ENOUGH_DATA、OGRERR_UNSUPPORTED_GEOMETRY_TYPE或OGRERR_CORRUPT_DATA中的任何一个都可能被退回
exportToWkt
virtual std：：string exportToWkt（const OGRWktOptions &opts = OGRWktOptions（）， OGRErr *err = nullptr） const override
将循环字符串导出到 WKT
参数:
-
opts -- 输出选项。
-
err -- 指向错误代码的指针（如果需要）。
返回:
表示此循环字符串的 WKT 字符串
IsValid
virtual OGRBoolean IsValid（） const override
测试几何图形是否有效
返回: 如果几何图形没有点，则为 TRUE，否则为 FALSE
getEnvelope
virtual void getEnvelope（OGREnvelope *psEnvelope） const override
计算并返回传递的 psEnvelope 结构中此几何图形的边界包络
参数:
psEnvelope -- 放置结果的结构
// 创建一个圆弧几何对象OGRCircularString circularString;// 添加一些点到圆弧circularString.addPoint(0, 0);circularString.addPoint(1, 1);circularString.addPoint(2, 2);// 创建一个用于存储外包络矩形的结构体OGREnvelope envelope;// 获取圆弧的外包络矩形circularString.getEnvelope(&envelope);// 打印外包络矩形的坐标信息std::cout << "MinX: " << envelope.MinX << std::endl;std::cout << "MinY: " << envelope.MinY << std::endl;std::cout << "MaxX: " << envelope.MaxX << std::endl;std::cout << "MaxY: " << envelope.MaxY << std::endl;getEnvelope
virtual void getEnvelope（OGREnvelope3D *psEnvelope） const override
计算并返回传递的 psEnvelope 结构中此几何图形的边界包络 （3D）
参数:
psEnvelope -- 放置结果的结构
clone
virtual OGRCircularString *clone（） const override
创建此对象的副本
返回: 具有与原始对象相同的几何和空间参考系统的新对象实例
get_Length
virtual double get_Length() const override
返回曲线的长度
返回: 曲线的长度，如果曲线尚未初始化，则为零
CurveToLine
virtual OGRLineString *CurveToLine（double dfMaxAngleStepSizeDegrees = 0， const char *const *papszOptions = nullptr） const override
参数:
-
dfMaxAngleStepSizeDegrees -- 沿弧的最大步长（以度为单位），使用默认设置为零。
-
papszOptions -- 选项作为以 null 结尾的字符串列表或 NULL。
返回: 近似曲线的线串
Value
virtual void Value（double， OGRPoint*） const override
沿曲线在给定距离处获取点
参数:
-
dfDistance -- 沿采样位置的曲线的距离。对于此曲线，此距离应介于 0 和 get_Length（） 之间。
-
poPoint -- 要指定曲线位置的点
// 创建一个OGRPoint对象表示圆弧曲线的起点OGRPoint startPoint(0.0, 0.0);// 创建一个圆弧曲线对象，构建一个圆弧OGRCircularString circularString;circularString.addPoint(&startPoint);circularString.addCircularArc(10.0, 0.0, 20.0);// 调用Value函数计算圆弧上的点double Distance = 15.0; // 假设给定一个长度OGRPoint resultPoint;circularString.Value(Distance, &resultPoint);// 打印计算得到的点坐标std::cout << "Point on circular arc at angle " << angle << ": " << resultPoint.getX() << ", " << resultPoint.getY() << std::endl;get_Area
virtual double get_Area() const override
获取（闭合）曲线的面积
getGeometryType
virtual OGRwkbGeometryType getGeometryType() const override
获取几何类型
getGeometryName
Virtual const char *getGeometryName（） const override
获取几何类型的 WKT 名称
返回:用于此几何类型的名称，采用众所周知的文本格式。返回的指针指向静态内部字符串，不应修改或释放
segmentize
virtual void segmentize(double dfMaxLength) override
修改几何图形，使其没有比给定距离更长的线段
参数:
dfMaxLength -- 分割后 2 点之间的最大距离
// 创建一个圆弧几何对象OGRPoint point1(0, 0);OGRPoint point2(5, 0);OGRPoint point3(10, 0);OGRCircularString circularString;circularString.addPoint(&point1);circularString.addPoint(&point2);circularString.addPoint(&point3);// 打印原始的圆弧几何对象std::cout << "原始圆弧几何对象：" << std::endl;char* wkt;circularString.exportToWkt(&wkt);std::cout << wkt << std::endl;CPLFree(wkt);// 使用最大长度为2.0的线段对圆弧几何对象进行分段circularString.segmentize(2.0);// 打印分段后的圆弧几何对象std::cout << "分段后的圆弧几何对象：" << std::endl;circularString.exportToWkt(&wkt);std::cout << wkt << std::endl;CPLFree(wkt)hasCurveGeometry
virtual OGRBoolean hasCurveGeometry（int bLookForNonLinear = FALSE） const override
如果此几何图形是或具有曲线几何图形，则返回此几何图形
线性几何类型：
- OGRPoint：点几何类型，表示一个点。
- OGRLineString：线几何类型，表示一条折线，由一系列连续的线段组成。
- OGRRing：环几何类型，是线性几何类型的特殊类型，表示闭合的线。环几何类型可以用于表示简单多边形的外环或内环。
曲线几何类型：
- OGRCircularString：圆弧几何类型，表示一个圆弧。
- OGRCompoundCurve：复合曲线几何类型，由多个线段和圆弧组成的复杂曲线。
- OGRCurvePolygon：曲线多边形几何类型，表示由曲线组成的多边形。曲线多边形由外环和零个或多个内环组成，这些环可以是线性环或圆弧环。
- 当
bLookForNonLinear参数设置为FALSE时，表示只查找线性的子几何对象，不查找曲线类型的子几何对象（包括圆弧、复合曲线等）。- 当
bLookForNonLinear参数设置为TRUE时，表示同时查找曲线类型和线性类型的子几何对象
参数:
bLookForNonLinear -- 将其设置为 TRUE 以检查几何图形是否为 CIRCULARSTRING 或包含 CIRCULARSTRING。
返回: 如果此几何图形是或具有曲线几何图形，则为 TRUE
OGRPoint point(10.0, 20.0);//检查点是否具有曲线几何(非线性)。if (point.hasCurveGeometry()) {std::cout << "The point contains curve geometry." << std::endl;} else {std::cout << "The point does not contain curve geometry." << std::endl;}getLinearGeometry
virtual OGRGeometry *getLinearGeometry(double dfMaxAngleStepSizeDegrees = 0, const char *const *papszOptions = nullptr) const override
返回此几何图形的非曲线版本，可能是近似值
参数:
-
dfMaxAngleStepSizeDegrees -- 沿弧的最大步长（以度为单位），使用默认设置为零。
-
papszOptions -- 选项作为以 null 结尾的字符串列表。
返回: 新的几何图形
OGRPoint p1(0, 0);
OGRPoint p2(1, 1);
OGRPoint p3(2, 0);OGRCircularString cs;
cs.addPoint(&p1);
cs.addPoint(&p2);
cs.addPoint(&p3);// 转换为线性几何对象
OGRGeometry* linearGeom = cs.getLinearGeometry();在上面的例子中，一开始设置的点在 OGRCircularString 中表示一个圆弧段，可以用中心点、起始点、终止点和半径等信息来表示。但是当将 OGRCircularString 对象转换为线性几何对象时，圆弧段将被拆分成一组连续的直线段，这些直线段近似地组成了原始圆弧的形状。