4.2 几何基元类

4.2.1 点

点几何元素描述笛卡尔坐标系中二维或者三维点的表达。点是几何表达中的最基本元素。

点的表达包括二维点类GePoint2d和三维点类GePoint3d，通过点的坐标创建点。基本功能包括点与点的、点与向量等基础运算，点与向量位置关系计算，还包括插值运算、旋转变换、投影计算、距离计算等等。

主要可以应用于二三维模型创建点对象，进行精准定位。模型坐标查询、坐标系创建等等。

表4-1 三维点常用接口

表4-2 二维点常用接口

4.2.2 三维向量

向量是计算几何中的基本概念，指一个同时具有大小和方向的几何对象。

向量的表达包括二维向量类GeVec2d和三维向量类GeVec3d，可直接通过各分量的值或者起点和终点创建向量。基本功能包括包括点与向量等、向量与向量等基础运算，还包括插值运算、旋转变换、投影计算、距离计算等等。

向量主要可应用于二三维模型进行精准定位。模型坐标查询、坐标系创建等等。

三维向量(GeVec3d)：三维空间的向量。

表4-3 三维向量常用接口

4.2.3基本曲线(IGeCurveBase)

基本曲线主要包括直线段(GeSegment3d)，弧线(GeEllipse3d)等类型。

基本曲线类IGeCurveBase主要用于整合线段、多线段、圆、椭圆、圆弧、椭圆弧、B样条曲线的概念。通过相应接口，可创建线段、多线段、圆、椭圆、圆弧、椭圆弧、B样条曲线。主要功能包括重心、法向、面积相关属性计算、与点、角度关系计算、插值计算、与平面、线段、椭圆线相交计算，投影计算等。

二三维应用场景，可单点绘制线段、两点绘制线段、连续绘制线段、三点绘弧、中心点半径绘弧、中心点半径绘圆、中心点长轴短轴绘制椭圆、弧与线段组合曲线、控制点绘制变样线等等。编辑中有属性修改半径、圆心、弧长、扫掠角度等修改圆弧及椭圆弧，修改定位点改变线段定位及长度，在位编辑（夹点）修改弧及线段定位信息及创建信息。

表4-4 基本曲线常用接口

线段是指直线上两点和它们之间的部分。线段不能向任何一方无限延伸，能度量长度，两点之间线段最短。

线段通过类GeSegment3d进行表达，可通过线段起点、终点，线段起点、方向向量进行创建。主要功能包括线段相关属性计算、线段与点关系计算、插值计算、线段与线段相交计算。椭圆线需求具体包括圆、椭圆、圆弧、椭圆弧四种类型，通过类GeEllipse3d进行表达，可通过弧上三点，弧的圆心和端点，弧所在圆的参数、弧的起点、扫掠角度等创建椭圆线。基本功能包括重心、法向、面积相关属性计算、与点、角度关系计算、插值计算、与平面、线段、椭圆线相交计算，投影计算等。

4.3.4 包围盒(GeRange3d/GeRange2d)

图素对象的空间范围称之为包围盒，包含三维包围盒（GeRange3d）和二维包围盒（GeRange2d）。三维包围盒是一个各边平行于坐标轴的六面体，用六面体对角线上的两个三维点来表示；二维包围盒是各边都平行于坐标轴的长方形，用长方形对角线上的两个二维点来定义。包围盒可应用于图形空间碰撞检查、图形搜索过滤等。

表4-5 包围盒常用接口

4.2.4 曲线组(GeCurveArray)

在几何表达上，既能表示一组曲线的集合，也能表示三维表面的区域，还可以用于描述截面，轮廓等参数。基本曲线和曲线组可以互相嵌套，曲线组主要包括以下几种类型：

None：对于数组中的曲线不做任何处理。

Open：自动连接数组中曲线。

Outer：曲线是逆时针方向加入曲线组中，自动连接数组中曲线，并最后做闭合处理，形成一个闭合的面域。

Inner：曲线是顺时针方向加入曲线组中，自动连接数组中曲线，并最后做闭合处理，形成一个闭合的面域。

ParityRegion：各个面域重叠部分会做处理，偶数重叠会裁剪，奇数重叠会合并。

UnionRegion：无论各个面域是否重叠，都不做处理。

表4-6 曲线组常用接口

4.2.5 几何实体类(IGeSolidBase)

三维实体，主要包括：圆管(GeTorusPipeInfo)，柱台锥(GeConeInfo)，盒体(GeBoxInfo)，球/椭球(GeSphereInfo)，拉伸体(GeExtrusionInfo)，旋转体（GeRotationalSweepInfo），扫掠体(GeRuledSweepInfo)，如图4-3所示。

图4-3 几何实体

盒体，也为六面体，就是有六个面的空间形体，共分为正六面体（也叫正方体）、平行六面体、不规则六面体三类。盒体通过类GeBoxInfo进行表达，主要功能包括盒体创建，求体积面积，获取几何点线面等计算。

球体为空间中到定点的距离等于定长的所有点组成的图形。球体通过类GeSphereInfo进行表达，主要功能包括球体创建，求体积面积，获取几何点线面等计算。

柱台锥包括圆柱、圆台、圆锥三类形体。柱台锥通过类GeConeInfo进行表达，主要功能包括柱台锥创建，求体积面积，获取几何点线面等计算。

圆环相当于一个空心的圆，空心圆拥有一个小半径(r)，整个圆有一个大半径（R)，整个圆的半径减去空心圆半径就是环宽。生活中的例子有空心钢管，甜甜圈，指环，游泳圈等，截取圆环一部分的叫扇环。圆环体通过类GeBoxInfo进行表达，主要功能包括盒体创建，扇环创建，求体积面积，获取几何点线面等计算。

拉伸体主要通过定义的截面沿向量方向拉伸形成的几何形体。拉伸体通过类GeExtrusionInfo进行表达，主要功能包括拉伸体创建，求体积面积，获取几何点线面等计算。

扫掠体主要通过定义的多个截面进行扫掠形成的几何形体。扫掠体通过类GeRuledSweepInfo进行表达，主要功能包括扫掠体创建，求体积面积，获取几何点线面等计算。

一条平面曲线绕着它所在的平面内的一条定直线旋转所形成的曲面叫作旋转面；该定直线叫做旋转体的轴；封闭的旋转面围成的几何体叫作旋转体。旋转体通过类GeRotationalSweepInfo进行表达，主要功能包括旋转体创建，求体积面积，获取几何点线面等计算。

表4-7 几何实体常用接口

4.2.6 网格实体(PolyfaceHandle)

网格实体用于描述三维面的形状，通过网格划分构建复杂几何形体，如图4-4所示。

图4-4 网格实体

主要功能包括网格实体创建，求体积面积，获取几何点线面等计算。满足网格实体创建及基本计算要求。

三维应用场景，创建中有通过网格面创建地形等复杂曲面。属性编辑中，通过修改控制点等修改已创建的网格实体。同时也可通过在位编辑（夹点）修改已创建体参数信息。

表4-8 网格常用接口

4.2.7 几何集合(BPGraphics)

几何集合（BPGraihics）用于构造各种几何图形，是各种几何对象的集合，可将线、组合线、面、三角面片、实体类、文字等集成为一个复杂图形。

表4-9 几何图素常用接口