@ccpc/math 0.1.0 → 0.1.7

package/types/geometry/intersect_curve3.d.ts

@@ -0,0 +1,90 @@
+import { Surface } from './surface';
+import { Vec3 } from '../base/vec3';
+import { NurbsCurve3 } from './nurbs_curve3';
+import { Curve3 } from './curve3d';
+import { Box3 } from '../base/box3';
+import { types } from '../type_define/i_types';
+import { Interval } from '../base/interval';
+import { EN_GEO_TYPE } from '../type_define/i_element_type';
+import { ISurfaceSurfaceIntersectPointInfo } from '../algorithm/intersect/x_info';
+import { geom } from '../verb/verb';
+/**
+ * ****************************内部使用，用于计算中间形式表达，不让外部使用*****************************
+ */
+export declare class IntersectCurve3 extends Curve3 {
+    private _surface;
+    private _ptsChart;
+    private _knots;
+    private _domain;
+    constructor();
+    constructor(surface: Surface[], intPts?: ISurfaceSurfaceIntersectPointInfo[]);
+    toVerbNurbs(range?: Interval): geom.NurbsCurve;
+    updateKonts(): void;
+    getAllPoints(): Vec3[];
+    getIntersectPtsChart(): ISurfaceSurfaceIntersectPointInfo[];
+    getDomain(): Interval;
+    /**
+     * 判断该曲线是否为周期曲线
+     */
+    isPeriodic(): boolean;
+    /**
+     * 获取曲线起点
+     */
+    getStartPt(): Vec3;
+    /**
+     * 获取曲线末点
+     */
+    getEndPt(): Vec3;
+    getPtAt(param: number): Vec3;
+    getIntersectPtInfoAt(param: number): ISurfaceSurfaceIntersectPointInfo;
+    /**
+     * 计算曲线在给定参数区间的包围盒，如果没有传入参数域则计算曲线默认参数域的包围盒
+     */
+    getBBox(range?: Interval): Box3;
+    getTangentAt(t: number, useDefaultSnap?: boolean): Vec3;
+    /**
+     *  获取某点对应的参数，如果点在曲线外，离得比较远，可能会出问题
+     */
+    getParamAt(point: types.IXYZ): number;
+    getKontIndex(point: types.IXYZ): number;
+    /**
+     *  获取某参数t处的几阶导数
+     * t : 参数t
+     * n : 导数的阶数 // 譬如n = 2，会计算曲线在参数t处的0阶导(即曲线点)、1阶导、2阶导
+     */
+    getDerivatives(t: number, n: number): Vec3[];
+    getDerivativesAtPt(intersectPtInfo: ISurfaceSurfaceIntersectPointInfo, nth: number, useDefaultSnap?: boolean, refDir?: Vec3): Vec3[];
+    /**
+     *  获取曲线(给定参数域区间段的)长度
+     */
+    getLength(range?: Interval): number;
+    getType(): EN_GEO_TYPE;
+    /**
+     * 反向，改变自己
+     */
+    reverse(): this;
+    split(params: number[], tolerance?: number): IntersectCurve3[];
+    transform(m: types.IMatrix4 | types.numberArrs4X4): this;
+    /**
+     * 转nurbs
+     */
+    toSimpleCurve3d(degree?: number): Curve3;
+    /**
+     * 转nurbs
+     */
+    toNurbs(degree?: number, lengthEps?: number): NurbsCurve3;
+    /**
+     * 转nurbs
+     */
+    toNurbsBetweenPoints(rDegree: number | undefined, point1: Vec3, point2: Vec3, dir?: Vec3): Curve3;
+    getInsertPt(index: number, lambda: number, needInsert?: boolean): Vec3;
+    insertPt(index: number, lambda: number): boolean;
+    clone(): IntersectCurve3;
+    /**
+     * 抽取元数据，用于序列化
+     */
+    dump(): types.IDBLibGeo;
+    load(): this;
+    private _getDerivativesAtTangentialPoint;
+    private _getInsertPt;
+}

package/types/geometry/ln2.d.ts

@@ -0,0 +1,168 @@
+import { Curve2 } from './curve2';
+import { types } from '../type_define/i_types';
+import { Vec2 } from '../base/vec2';
+import { Box2 } from '../base/box2';
+import { EN_GEO_TYPE } from '../type_define/i_element_type';
+import { Interval } from '../base/interval';
+import { Coord3 } from '../base/coord3';
+import { Ln3 } from './ln3';
+import { ILine } from '../type_define/i_geometry';
+import { Vec } from '../base/vec';
+import { NurbsCurve2 } from './nurbs_curve2';
+/**
+ * 二维直线
+ */
+export declare class Ln2 extends Curve2 implements ILine<Vec2> {
+    protected _origin: Vec2;
+    private _dir;
+    constructor();
+    /**
+     * 两点构造直线（因需要用开方计算直线方向，较慢）
+     * @param startPt 起始点
+     * @param endPt 终止点
+     */
+    constructor(startPt: types.IXY, endPt: types.IXY);
+    /**
+     * 点和方向构造直线
+     * @param origin 起始点
+     * @param dir 方向
+     * @param range 参数域
+     */
+    constructor(origin: types.IXY, dir: types.IXY, range: types.IInterval);
+    /**
+     * 获取从起点到终点的向量
+     */
+    toVector2(): Vec2;
+    reset(start: types.IXY, end: types.IXY): void;
+    /**
+     * 获取直线的原点（参数为零的点）
+     */
+    getOrigin(): Vec2;
+    /**
+     * 设置直线的原点（参数为零的点）
+     */
+    setOrigin(origin: types.IXY): Vec2;
+    /**
+     *  获取方向向量
+     */
+    getDirection(): Vec2;
+    setDirection(dir: types.IXY): void;
+    /**
+     * 获取左侧的法向（为直线方向逆时针转90度）
+     */
+    getLeftNormal(): Vec2;
+    /**
+     * 获取右侧的法向（为直线方向顺时针转90度）
+     */
+    getRightNormal(): Vec2;
+    /**
+     * 判断该曲线是否为直线
+     * @returns
+     */
+    isLineLike(): boolean;
+    /**
+     * 是否和另一条直线平行
+     * @param another
+     * @param tol
+     */
+    isParallelTo(another: Ln2, tol?: number): boolean;
+    /**
+     * 是否和另一条直线共线，使用距离容差判断，
+     * @deprecated
+     * @param another
+     * @param torlerance
+     */
+    isColinearWith(another: Ln2, eps?: number): boolean;
+    /**
+     * 是否和另一条直线垂直
+     * @param another
+     * @param torlerance
+     */
+    isPerpendicularTo(another: Ln2, torlerance?: number): boolean;
+    /**
+     * 判断点在直线的哪一侧。-1:右侧, 1:左侧, 0:直线上.
+     * @param point
+     * @param tol
+     */
+    side(point: types.IXY, tol: number): 1 | 0 | -1;
+    /**
+     * 获取某参数对应的点
+     */
+    getPtAt(t: number): Vec2;
+    /**
+     *  获取某点（点也可以不在直线上）对应的参数t。如果点可以在直线外，则返回点在直线上最近点的参数t
+     */
+    getParamAt(point: types.IXY): number;
+    /**
+     * 获取离直线段最近的点
+     * @param point
+     * @param tol
+     */
+    getClosestPoint(point: types.IXY): Vec2;
+    /**
+     * 获取某点在曲线上的所有垂足点的参数t（直线只有一个垂足点）
+     */
+    getAllFootParams(point: Vec2, _lengthEps?: number): number[];
+    /**
+     * 计算距离迭代方法函数：从给定参数出发，迭代求取最近的垂足的点。// 直线没有迭代，此函数只为了覆盖curve的同名函数
+     * @param point 目标点
+     * @param t0 迭代的初始参数
+     * @param paramEps 参数的迭代终止误差
+     */
+    getFootByIterate(point: Vec, t0?: number): number | undefined;
+    /**
+     *  获取某参数t处的几阶导数
+     * t : 参数t
+     * n : 导数的阶数 // 譬如n = 2，会计算曲线在参数t处的0阶导(即曲线上的点)、1阶导、2阶导
+     */
+    getDerivatives(t: number, n: number): Vec2[];
+    /**
+     * 获取某参数处的切线
+     */
+    getTangentAt(t: number): Vec2;
+    /**
+     * 获取range参数域的切线锥
+     */
+    /**
+     *  获取曲线(给定参数域区间段的)长度
+     */
+    getLength(range?: Interval): number;
+    /**
+     * 反向
+     */
+    reverse(): this;
+    split(params: number[], tolerance?: number): Curve2[];
+    /**
+     * 拟合成nurbscurve2d
+     */
+    toNurbs(degree?: number, lengthEps?: number): NurbsCurve2;
+    /**
+     * 转换成三维直线
+     */
+    toCurve3d(ccs: Coord3): Ln3;
+    /**
+     * 转换成无限长直线，返回新对象
+     */
+    toInfiniteLine(): Ln2;
+    /**
+     *  Curve2
+     *  曲线按给定距离进行偏移
+     * @param dDist 等距量：>0 = 右侧；<0 = 左侧
+     * @returns 是否等距成功：true = 是；false = 否
+     * @deprecated 使用 OffsetCurve2.makeByCurve() 来代替
+     */
+    offset(dDist: number): boolean;
+    transform(m: types.IMatrix3 | types.numberArrs3X3): this;
+    /**
+     * 计算包围盒
+     */
+    getBBox(range?: Interval): Box2;
+    getType(): EN_GEO_TYPE.LN_2;
+    clone(): Ln2;
+    /**
+     * 抽取元数据，用于序列化
+     */
+    dump(): types.IDBLine2d;
+    load(json: types.IDBLine2d): this;
+    translate(offset: types.IXY): this;
+}

package/types/geometry/ln3.d.ts

@@ -0,0 +1,152 @@
+import { Curve3 } from './curve3d';
+import { types } from '../type_define/i_types';
+import { Vec3 } from '../base/vec3';
+import { EN_GEO_TYPE } from '../type_define/i_element_type';
+import { Interval } from '../base/interval';
+import { Box3 } from '../base/box3';
+import { ILine } from '../type_define/i_geometry';
+import { TangentCone } from '../base/tangent_cone';
+import { NurbsCurve3 } from './nurbs_curve3';
+import { verb } from '../verb/export_verb';
+/**
+ * 三维直线
+ */
+export declare class Ln3 extends Curve3 implements ILine<Vec3> {
+    protected _origin: Vec3;
+    private _dir;
+    constructor();
+    /**
+     * 两点构造直线（因需要用开方计算直线方向，较慢）
+     * @param startPt 起始点
+     * @param endPt 终止点
+     */
+    constructor(startPt: types.IXYZ, endPt: types.IXYZ);
+    /**
+     * 点和方向构造直线
+     * @param origin 起始点
+     * @param dir 方向
+     * @param range 参数域
+     */
+    constructor(origin: types.IXYZ, dir: types.IXYZ, range: types.IInterval);
+    /**
+     * 获取直线的原点（参数为零的点）
+     */
+    getOrigin(): Vec3;
+    /**
+     * 设置直线的原点（参数为零的点）
+     */
+    setOrigin(origin: types.IXYZ): Vec3;
+    /**
+     * 获取从起点到终点的向量
+     */
+    toVector3(): Vec3;
+    /**
+     * 转换成无限长直线，返回新对象
+     */
+    toInfiniteLine(): Ln3;
+    reset(start: types.IXYZ, end: types.IXYZ): void;
+    /**
+     *  方向向量
+     */
+    getDirection(): Vec3;
+    setDirection(dir: types.IXYZ): void;
+    /**
+     * 判断该曲线是否为直线
+     * @returns
+     */
+    isLineLike(): boolean;
+    /**
+     * 是否和另一条直线平行
+     * @param another
+     * @param tol
+     */
+    isParallelTo(another: Ln3, tol?: number): boolean;
+    /**
+     * 是否和另一条直线共线，使用距离容差判断，
+     * @deprecated
+     * @param another
+     * @param torlerance
+     */
+    isColinearWith(another: Ln3, eps?: number): boolean;
+    /**
+     * 是否和另一条直线垂直
+     * @param another
+     * @param torlerance
+     */
+    isPerpendicularTo(another: Ln3, torlerance?: number): boolean;
+    /**
+     * 获取某参数对应的点
+     */
+    getPtAt(t: number): Vec3;
+    /**
+     *  获取某点对应的参数
+     */
+    getParamAt(point: types.IXYZ): number;
+    /**
+     * 获取离直线段最近的点
+     * @param point
+     * @param tol
+     */
+    getClosestPoint(point: types.IXYZ): Vec3;
+    /**
+     * 获取某点在曲线上的所有垂足点的参数t（直线只有一个垂足点）
+     */
+    getAllFootParams(point: Vec3, _lengthEps?: number): number[];
+    /**
+     * 计算距离迭代方法函数：从给定参数出发，迭代求取最近的垂足的点。(二维三维曲线通用)//直线没有迭代，此函数只为了覆盖curve的同名函数
+     * @param point 目标点
+     * @param t0 迭代的初始参数
+     * @param paramEps 参数的迭代终止误差
+     */
+    getFootByIterate(point: Vec3, t0?: number): number | undefined;
+    /**
+     * 获取某参数处的切线
+     */
+    getTangentAt(t: number): Vec3;
+    /**
+     * 获取range参数域的切线锥
+     */
+    getTangentCone(range?: Interval, bApprox?: boolean): TangentCone;
+    /**
+     *  获取某参数t处的几阶导数
+     * t : 参数t
+     * n : 导数的阶数 // 譬如n = 2，会计算曲线在参数t处的0阶导(即曲线点)、1阶导、2阶导
+     */
+    getDerivatives(t: number, n: number): Vec3[];
+    /**
+     *  获取曲线(给定参数域区间段的)长度
+     */
+    getLength(range?: Interval): number;
+    /**
+     * 获取曲线在完整参数域上的拷贝
+     */
+    getInfinitClone(): Ln3;
+    /**
+     * 判断Curve3d是否是平面曲线
+     * 如果是平面曲线：并且能构造一个平面，则返回平面的法向；不能构造平面的，例如是一条直线的，只返回true；如果不是平面曲线(即空间曲线)，返回false
+     */
+    isPlaneCurve3d(angleTol?: number): boolean | Vec3;
+    /**
+     * 反向
+     */
+    reverse(): this;
+    transform(m: types.IMatrix4 | types.numberArrs4X4): this;
+    split(params: number[], tolerance?: number): Curve3[];
+    toVerbNurbs(): verb.geom.NurbsCurve;
+    /**
+     * 拟合成nurbscurve3d
+     */
+    toNurbs(degree?: number, lengthEps?: number): NurbsCurve3;
+    /**
+     * 计算曲线在给定参数区间的包围盒，如果没有传入参数域则计算曲线默认参数域的包围盒
+     */
+    getBBox(range?: Interval): Box3;
+    getType(): EN_GEO_TYPE.LN_3;
+    clone(): Ln3;
+    /**
+     * 抽取元数据，用于序列化
+     */
+    dump(): types.IDBLine3d;
+    load(json: types.IDBLine3d): this;
+    translate(offset: types.IXYZ): this;
+}

package/types/geometry/nurbs_curve2.d.ts

@@ -0,0 +1,106 @@
+import { Curve2 } from './curve2';
+import { Interval } from '../base/interval';
+import { types } from '../type_define/i_types';
+import { EN_GEO_TYPE } from '../type_define/i_element_type';
+import { DiscreteParam } from '../base/discrete_param';
+import { NurbsCurve3 } from './nurbs_curve3';
+import { INurbsCurve } from '../type_define/i_geometry';
+import { Vec2 } from '../base/vec2';
+import { Box2 } from '../base/box2';
+/**
+ * Nurbs曲线
+ */
+export declare class NurbsCurve2 extends Curve2 implements INurbsCurve<Vec2> {
+    /**
+     * 构造Bezier曲线，degree 为控制点数-1，最大度数为 8.
+     */
+    static makeBezier(controlPoints: types.IXY[], weights?: number[]): NurbsCurve2;
+    /**
+     * 通过控制点和次数构造准均匀nurbs curve
+     * 曲线默认为三次
+     */
+    static makeByControlPoints(controlPoints: types.IXY[], degree?: number, knots?: number[], weights?: number[], range?: types.IInterval): NurbsCurve2;
+    /**
+     * 插值构造nurbs curve
+     * 曲线将插值经过所有传入的点，曲线默认为三次
+     */
+    static makeByInterpolationPts(points: types.IXY[], degree?: number, closeSmooth?: boolean): NurbsCurve2;
+    /**
+     * 过滤重复点，只过滤连续的重复点
+     * @param pts 输入点列
+     */
+    private static _fiterCoPoint;
+    private _nurbsCurve3d;
+    constructor(nurbsCurve3d?: NurbsCurve3);
+    getDegree(): number;
+    getWeights(): number[];
+    getKnots(): number[];
+    getControlPoints(): Vec2[];
+    getDomain(): Interval;
+    isBezier(): boolean;
+    /**
+     * 获取所有垂足点
+     * @param point 求取垂足的点
+     * @param _lengthEps 容差
+     * @returns
+     */
+    getAllFootParams(point: types.IXY, _lengthEps?: number): number[];
+    /**
+     * 获取参数值对应的曲线上的点
+     * @param t 参数(弧长)
+     */
+    getPtAt(t: number): Vec2;
+    /**
+     * 获取点在曲线上的参数
+     * @param point
+     */
+    getParamAt(point: types.IXY): number;
+    /**
+     * 获取参数值对应的曲线上的点处的切向量
+     * @param t
+     * @returns 单位切向量
+     */
+    getTangentAt(t: number): Vec2;
+    /**
+     *  获取某参数t处的几阶导数
+     * t : 参数t
+     * n : 导数的阶数 // 譬如n = 2，会计算曲线在参数t处的0阶导(即曲线点)、1阶导、1阶导
+     */
+    getDerivatives(t: number, nth: number): Vec2[];
+    /**
+     * 获取曲线上的弧长等分点，返回的第一个和最后一个分别为曲线的起点和终点
+     * @param count 等分点数量，数目限制最小为3
+     * @returns 单位切向量
+     */
+    getEqualDiversionPts(count?: number): Vec2[];
+    /**
+     * 在参数 t 处将 Nurbs 曲线切分为两部分
+     * @param t 切分点处的参数
+     * @param useRange 若真，则根据原参数域进行同步切分；若假，则切分得到的曲线以定义域作为参数域
+     * @return 返回切分得到的参数曲线，并会根据原参数域设置新的参数域。若参数有误则返回空数组
+     */
+    splitCurve(t: number, useRange?: boolean): NurbsCurve2[];
+    reverse(): this;
+    offset(dist: number): boolean;
+    clone(): NurbsCurve2;
+    getRange(): Interval;
+    setRange(a: number | Interval, max?: number): this;
+    /**
+     * 获取曲线长度
+     */
+    getLength(range?: Interval): number;
+    /**
+     * 获取曲线包围盒（控制多边形的包围盒）
+     */
+    getBBox(range?: Interval): Box2;
+    transform(m: types.IMatrix3 | types.numberArrs3X3): this;
+    /**
+     * 离散曲线
+     * @param tolerance  相邻三点组成的三角形面积的最大值
+     * @returns 离散点
+     */
+    discrete(params?: DiscreteParam): Vec2[];
+    getType(): EN_GEO_TYPE;
+    dump(): types.IDBNurbsCurve2d;
+    load(json: types.IDBNurbsCurve2d): this;
+}