@ccpc/math 0.1.0 → 0.1.7

package/types/geometry/coord_based_surface.d.ts

@@ -0,0 +1,25 @@
+import { Surface } from './surface';
+import { Coord3 } from '../base/coord3';
+import { types } from '../type_define/i_types';
+export declare abstract class CoordBasedSurface extends Surface {
+    protected _coord: Coord3;
+    /**
+     * 获取局部坐标系
+     */
+    getCoord(): Coord3;
+    /**
+     * 设置局部坐标系
+     */
+    setCoord(v: Coord3): void;
+    /**
+     * 平移，改变自己
+     */
+    translate(offset: types.IXYZ): this;
+    /**
+     * 绕坐标轴/点的旋转，改变自己
+     * @param angle 旋转的角度
+     * @param pivot 旋转轴上一点
+     * @param axis  绕哪个轴旋转
+     */
+    rotate(angle: number, pivot: types.IXYZ, axis?: types.IXYZ): this;
+}

package/types/geometry/curve.d.ts

@@ -0,0 +1,228 @@
+import { Interval } from '../base/interval';
+import { Vec } from '../base/vec';
+import { DiscreteParam } from '../base/discrete_param';
+import { types } from '../type_define/i_types';
+import { GeoElement } from '../base/geo_element';
+/**
+ * @author tiansk
+ * 参数曲线的基类
+ */
+declare abstract class Curve<PointType extends Vec> extends GeoElement {
+    protected _range: Interval;
+    constructor();
+    /**
+     * 获取某参数对应的点
+     */
+    abstract getPtAt(t: number): PointType;
+    /**
+     * 获取某点（点也可以不在曲线上）对应的参数t（不限参数域）
+     */
+    abstract getParamAt(point: types.IXY | PointType): number;
+    /**
+     * 获得曲线在参数域 rRange 上的切向锥
+     * @param range 参数域
+     * @param bApprox true = 近似切向锥；false = 精确切向锥
+     */
+    /**
+     * 获取某参数t处的几阶导数，例如 n = 2 时，会返回曲线在参数t处的坐标、1阶导、2阶导
+     * @param t 参数
+     * @param n 需要计算的导数的最大阶数
+     * @param snapToPreviousEnd 参数点在奇异点附近时，当输入为true时返回奇异点的前导数，false时返回奇异点的后导数。当 t === range.min 时，默认为 false，否则默认为 true。
+     */
+    abstract getDerivatives(t: number, n: number, snapToPreviousEnd?: boolean): PointType[];
+    /**
+     *  反向，改变自己
+     */
+    abstract reverse(): this;
+    /**
+     * 依据给定参数点，将曲线分割成多段。如果参数点都不在曲线上，则返回空的数组
+     * @param param
+     * @param tolerance
+     */
+    abstract split(params: number[], tolerance?: number): Curve<PointType>[];
+    /**
+     * 获取某点在曲线上的所有垂足点的参数t
+     * 备注：此外，在pt_to_curve3d_distance.ts文件中，包装了一个getFootPointInRange函数，直接计算range内最小距离垂足点的函数，比计算所有的比较垂足然后取最小效率更高
+     */
+    getAllFootParams(point: types.IXY | PointType, _lengthEps?: number): number[];
+    /**
+     * 计算给定点的参数
+     * @param thePt 要反求参数的point
+     * @param refT 给一个参考的参数
+     * @param lengthEps 反求参数的精度容差
+     * @param validLength 如果需要验证求到的参数是否距离给定参考的参数refT太远，如果距离太远可能是计算的参数不准，用其他方法计算所有的参数，选一个最近的参数
+     */
+    getParamNearT(thePt: types.IXY | PointType, refT: number, lengthEps?: number, angleEps?: number, validLength?: number): number;
+    /**
+     * 判断该曲线是否为周期曲线
+     */
+    isPeriodic(): boolean;
+    /**
+     * 判断该曲线是否为直线
+     * @returns
+     */
+    isLineLike(): boolean;
+    /**
+     * 反向，得到一个新的曲线对象
+     */
+    reversed(): Curve<PointType>;
+    /**
+     * 获取曲线起点
+     */
+    getStartPt(): PointType;
+    /**
+     * 获取曲线末点
+     */
+    getEndPt(): PointType;
+    /**
+     * 获取曲线中点
+     */
+    getMidPt(): PointType;
+    /**
+     *  获取曲线(给定参数域区间段的)长度
+     */
+    getLength(range?: Interval): number;
+    /**
+     * 离散成点集
+     */
+    discrete(params?: DiscreteParam): PointType[];
+    /**
+     * 获取曲线的domain
+     */
+    getDomain(): Interval;
+    /**
+     * 获取曲线起点处参数值
+     */
+    getStartParam(): number;
+    /**
+     * 获取曲线末点处参数值
+     */
+    getEndParam(): number;
+    /**
+     * 获取起点处的切线
+     */
+    getStartTangent(): PointType;
+    /**
+     * 获取末点处的切线
+     */
+    getEndTangent(): PointType;
+    /**
+     * 获取中点处的切线
+     */
+    getMidTangent(): PointType;
+    /**
+     *  获取某参数处的切线
+     * @param t 参数
+     * @param snapToPreviousEnd 参数点在奇异点附近时，当输入为true时返回奇异点前的切向量，false时返回奇异点后的切向量。当 t === range.min 时，默认为 false，否则默认为 true。
+     */
+    getTangentAt(t: number, snapToPreviousEnd?: boolean): PointType;
+    /**
+     * 获取奇异点
+     */
+    getSingularities(): number[];
+    /**
+     * 从几何上判断该点是否是起点
+     * @param point
+     */
+    isStartPt(point: types.IXY | PointType, tolerance?: number): boolean;
+    /**
+     * 从几何上判断该点是否是末点
+     * @param point
+     */
+    isEndPt(point: types.IXY | PointType, tolerance?: number): boolean;
+    /**
+     * point投影在curve上的点p是否在曲线上
+     * @param point
+     */
+    containsProjectedPt(point: types.IXY | PointType, tolerance?: number): boolean;
+    /**
+     * 是否包含某个点, 即某点是否在该曲线段上
+     */
+    containsPt(point: types.IXY | PointType, tolerance?: number): boolean;
+    /**
+     * 点到曲线的垂足
+     */
+    getProjectedPtBy(point: types.IXY | PointType): PointType;
+    /**
+     * 计算距离迭代方法函数：从给定参数出发，迭代求取最近的垂足的点；如果没有垂足点返回undefined。(二维三维曲线通用)
+     * @param point 目标点
+     * @param param0 迭代的初始参数
+     * @param paramEps 参数的迭代终止误差
+     */
+    getFootByIterate(point: types.IXY | PointType, param0?: number, distEps?: number, angleEps?: number, clampParam?: boolean): number | undefined;
+    /**
+     * 二分+迭代方法：从给定参数出发，迭代求取最近的垂足的点；如果没有垂足点返回undefined。(二维三维曲线通用)
+     * @param point 目标点
+     * @param param0 迭代的初始参数
+     * @param paramEps 参数的迭代终止误差
+     */
+    getFootByDichotomy(point: types.IXY | PointType, param1: number, param2: number, distEps?: number, angleEps?: number, clampParam?: boolean): number | undefined;
+    /**
+     * 延伸曲线,若曲线参数域为[0,1]
+     * > 从尾部增加1，参数域变为[0,2]
+     *
+     * > 从头部增加1，参数域变为[-1,1]
+     * @param howLong 延伸长度
+     * @param bTail 是否从尾部增加
+     */
+    extend(howLong: number, bTail?: boolean): this;
+    /**
+     * 从参数域的2端延伸曲线
+     * @param howLong 延伸长度
+     */
+    extendDouble(howLong: number): this;
+    /**
+     * 获取参数域的拷贝
+     */
+    getRange(): Interval;
+    /**
+     * 重设参数域
+     */
+    setRange(min: number, max: number): this;
+    /**
+     * 重设参数域
+     */
+    setRange(range: Interval): this;
+    /**
+     * 设置参数域为单向或双向无穷
+     * @param min
+     */
+    setRangeInfinit(min?: number): void;
+    /**
+     * 设置参数域为单向无穷
+     * @param min
+     */
+    setRangeMaxInfinit(): void;
+    /**
+     * 设置参数域为单向无穷
+     * @param min
+     */
+    setRangeMinInfinit(): void;
+    /**
+     * 2曲线是否在几何上相等
+     * > 返回值：
+     * - 0不相等
+     * - 1相等且方向相同
+     * - -1相等且方向相反
+     * @param another
+     * @param torlerance
+     */
+    equals(another: Curve<PointType>, torlerance?: number): 0 | 1 | -1;
+    clone(): Curve<PointType>;
+    /**
+     * 通过等分参数域来获得离散结果
+     * @param segmentCount
+     */
+    discreteBySegmentCount(segmentCount: number): PointType[];
+    /**
+     * 获取插值点
+     */
+    getInterpPts(lengthEps: number): {
+        params: number[];
+        pts: Vec[];
+    };
+    protected _tessellateByPoints(points: PointType[], name: string): types.IRenderEdge;
+    protected _getSnapToPrevious(t: number, snapPre?: boolean): boolean;
+    protected _refineDegerateTangent(_t: number, _snapPre: boolean, tan: PointType): PointType;
+}
+export { Curve };

package/types/geometry/curve2.d.ts

@@ -0,0 +1,62 @@
+import { Box2 } from '../base/box2';
+import { Curve } from './curve';
+import { types } from '../type_define/i_types';
+import { Vec2 } from '../base/vec2';
+import { ICurve2dTransformExtra, IGeometry2d } from '../type_define/i_geometry';
+import { Interval } from '../base/interval';
+/**
+ *  二维曲线的基类，所有二维曲线都是参数曲线，且是弧长参数化曲线
+ */
+declare abstract class Curve2 extends Curve<Vec2> implements IGeometry2d {
+    /**
+     *  曲线按给定距离进行偏移
+     * @param distance 等距量：>0 = 右侧；<0 = 左侧
+     * @returns 是否等距成功：true = 是；false = 否
+     * @deprecated 使用 OffsetCurve2.makeByCurve() 来代替
+     */
+    abstract offset(distance: number): boolean;
+    /**
+     * 乘上一个变换矩阵，改变自己（圆弧，暂时只支持等比例缩放）
+     */
+    abstract transform(m: types.IMatrix3 | types.numberArrs3X3, extra?: ICurve2dTransformExtra): this;
+    /**
+     * 计算曲线在给定参数区间的包围盒，计算效率更高，但是包的没有BoundingBox紧凑
+     * @param range
+     */
+    getBox(range?: Interval): Box2;
+    /**
+     *  计算曲线在给定参数区间的包围盒，如果没有传入参数域则计算曲线默认参数域的包围盒
+     */
+    getBBox(range?: Interval): Box2;
+    /**
+     * 依据给定参数点，将曲线分割成多段。如果参数点都不在曲线上，则返回空的数组
+     * @param param
+     * @param tolerance
+     */
+    split(params: number[], tolerance?: number): Curve2[];
+    /**
+     * 平移，改变自己
+     */
+    translate(offset: types.IXY): this;
+    /**
+     * 绕坐标轴/点的旋转，改变自己
+     * @param angle 旋转的角度
+     * @param pivot 旋转轴上一点
+     */
+    rotate(angle: number, pivot?: types.IXY): this;
+    /**
+     * 缩放，改变自己
+     * 直线支持非等比，其他情况都是等比例缩放
+     * @param factor 放大因子
+     * @param center 缩放中心
+     */
+    scale(factor: number, center?: types.IXY): this;
+    /**
+     * 变换，得到变换后新的曲线对象
+     * @param m
+     */
+    transformed(m: types.IMatrix3 | types.numberArrs3X3, extra?: ICurve2dTransformExtra): Curve2;
+    reversed(): Curve2;
+    clone(): Curve2;
+}
+export { Curve2 };

package/types/geometry/curve3d.d.ts

@@ -0,0 +1,66 @@
+import { Curve } from './curve';
+import { types } from '../type_define/i_types';
+import { Box3 } from '../base/box3';
+import { ICurve3dTransformExtra, IGeometry3d } from '../type_define/i_geometry';
+import { Interval } from '../base/interval';
+import { Vec3 } from '../base/vec3';
+import { verb } from '../verb/export_verb';
+/**
+ * 三维参数曲线
+ */
+declare abstract class Curve3 extends Curve<Vec3> implements IGeometry3d {
+    /**
+     * 乘上一个变换矩阵，改变自己
+     */
+    abstract transform(m: types.IMatrix4 | types.numberArrs4X4, extra?: ICurve3dTransformExtra): this;
+    /**
+     * 转成nurbs曲线
+     */
+    abstract toVerbNurbs(range?: Interval): verb.geom.NurbsCurve;
+    /**
+     * 计算曲线在给定参数区间的包围盒，计算效率更高，但是包的没有BoundingBox紧凑
+     * @param range
+     */
+    getBox(range?: Interval): Box3;
+    /**
+     *  计算曲线在给定参数区间的紧包围盒，如果没有传入参数域则计算曲线默认参数域的包围盒
+     */
+    getBBox(range?: Interval): Box3;
+    /**
+     * 平移，改变自己
+     */
+    translate(offset: types.IXYZ): this;
+    /**
+     * 绕坐标轴/点的旋转，改变自己
+     * @param angle 旋转的角度
+     * @param pivot 旋转轴上一点
+     * @param axis  绕哪个轴旋转
+     */
+    rotate(angle: number, pivot: types.IXYZ, axis?: types.IXYZ): this;
+    /**
+     * 缩放，改变自己
+     * 直线支持非等比，其他情况都是等比例缩放
+     * @param factor 放大因子
+     * @param center 缩放中心
+     */
+    scale(factor: number, center: types.IXYZ): this;
+    /**
+     * 变换，得到变换后新的曲线对象
+     * @param m
+     */
+    transformed(m: types.IMatrix4 | types.numberArrs4X4, extra?: ICurve3dTransformExtra): Curve3;
+    /**
+     * 判断Curve3d是否是平面曲线
+     * 如果是平面曲线：并且能构造一个平面，则返回平面的法向；不能构造平面的，例如是一条直线的，只返回true；如果不是平面曲线(即空间曲线)，返回false
+     */
+    isPlaneCurve3d(angleTol?: number): boolean | Vec3;
+    /**
+     * 依据给定参数点，将曲线分割成多段。如果参数点都不在曲线上，则返回空的数组
+     * @param param
+     * @param tolerance
+     */
+    split(params: number[], tolerance?: number): Curve3[];
+    reversed(): Curve3;
+    clone(): Curve3;
+}
+export { Curve3 };

package/types/geometry/cylinder.d.ts

@@ -0,0 +1,73 @@
+import { Coord3 } from '../base/coord3';
+import { Vec2 } from '../base/vec2';
+import { Vec3 } from '../base/vec3';
+import { Curve2 } from './curve2';
+import { Curve3 } from './curve3d';
+import { types } from '../type_define/i_types';
+import { EN_GEO_TYPE } from '../type_define/i_element_type';
+import { Arc3 } from './arc3d';
+import { Tol } from '../base/tol';
+import { PeriodInterval } from '../base/period_inverval';
+import { CircularSurface } from './circular_surface';
+import { Surface } from './surface';
+/**
+ *
+ * 圆柱面, U向参数域[0, 2PI*r], V向参数域[-OO, +OO]
+ * 构造整跨周期 Brep 圆柱面时，需添加 Edge 连接上下两侧 Edge，从而形成外环
+ */
+declare class Cylinder extends CircularSurface {
+    static makeCylinderByArc3d(arc3: Arc3): Cylinder;
+    constructor();
+    constructor(coord: Coord3, a: number);
+    constructor(coord: Coord3, a: number, b: number);
+    getRadius(): number;
+    getCenterAxis(): Vec3;
+    getPtAt(uv: types.IXY): Vec3;
+    getNormAt(uv: Vec2): Vec3;
+    isRuled(): boolean;
+    /**
+     *  获取某参数t处的n阶偏导数
+     * t : 参数t
+     * n : 导数的阶数 // 譬如n = 2，会计算曲线在参数t处的0阶导(即曲线点)，1阶偏导（包含偏u、偏v），2阶偏导（包含偏uu、偏uv、偏vv）
+     */
+    getDerivatives(uv: types.IXY, n?: number): Vec3[];
+    /**
+     * 获取三维点处的uv值，（反求参数）
+     * @param uv
+     */
+    getUVAt(pt: types.IXYZ): Vec2;
+    isCoplanar(other: Surface, tol?: Tol): boolean;
+    containsCurve(curve: Curve3, eps?: number): boolean;
+    getDomainU(): PeriodInterval;
+    /**
+     * 获取等参曲线
+     * @param param 等参曲线处的参数
+     * @param useV true 时返回等 v 参数曲线，false 时返回等 u 参数曲线
+     */
+    getIsoCurve(param: number, useV: boolean): Curve3;
+    /**
+     * 将参数域中的二维曲线转成三维曲线
+     * 暂时只支持直线(横平竖直，斜的需要定义椭圆)
+     * @param curve
+     */
+    getCurve3d(curve: Curve2): Curve3;
+    /**
+     * 乘上一个变换矩阵
+     * 注意：柱面若是镜像，若想镜像后u参数不变，点正好镜像，则v参数一定会相反（z轴会反了）；反之，若想v参数不变，点正好镜像，则u参数一定会相反（x或者y轴会反了）
+     *      为了保持一致，统一让v参数不变。因为考虑到镜像锥面，如果做了yoz镜像之后，z轴反了，锥面会明显倒过来。而考虑到u向是周期的，直接反u参数会更好
+     *      【原来的点镜像之后到新的点，新的点和原来的点的v参数相同，但是u参数变成了-u。这个地方curve2d相关的处理时需要注意。】
+     */
+    transform(m: types.IMatrix4 | types.numberArrs4X4): this;
+    /**
+     *  深拷贝
+     */
+    clone(): Cylinder;
+    getType(): EN_GEO_TYPE.CYLINDER;
+    /**
+     * 抽取元数据，用于序列化
+     * @returns 返回js对象
+     */
+    dump(): types.IDBCylinder;
+    load(json: types.IDBCylinder): this;
+}
+export { Cylinder };

package/types/geometry/discrete_arrow.d.ts

@@ -0,0 +1,3 @@
+import { types } from '../type_define/i_types';
+export declare function discreteArrow(origin: types.IXY, direction: types.IXY, len: number): types.IXYZArr[];
+export declare function discreteArrow(origin: types.IXYZ, direction: types.IXYZ, len: number): types.IXYZArr[];

package/types/geometry/extend_curve2.d.ts

@@ -0,0 +1,75 @@
+import { Interval } from '../base/interval';
+import { DiscreteParam } from '../base/discrete_param';
+import { types } from '../type_define/i_types';
+import { EN_GEO_TYPE } from '../type_define/i_element_type';
+import { Curve2 } from './curve2';
+import { Vec2 } from '../base/vec2';
+import { Box2 } from '../base/box2';
+import { ICurve2dTransformExtra, IExtendCurve } from '../type_define/i_geometry';
+import { NurbsCurve2 } from './nurbs_curve2';
+/**
+ * 延长曲线，根据首尾切线向量生成，1阶连续。
+ * 仅作为中间表达式内部使用，目前仅用于扫掠面以及扫掠过程中部分曲线的延长线使用
+ */
+export declare class ExtendCurve2 extends Curve2 implements IExtendCurve<Vec2> {
+    /**
+     * 以 baseCurve 为基础，生成延长线
+     * @param baseCurve
+     * @param cloneCurve 为假时，将以 baseCurve 作为基线、或直接修改 baseCurve 作为返回结果
+     */
+    static makeByCurve(baseCurve: Curve2, cloneCurve?: boolean): Curve2;
+    private _baseCurve;
+    private _head;
+    private _tail;
+    constructor(baseCurve?: Curve2, range?: types.IInterval);
+    getBaseCurve(): Curve2;
+    setBaseCurve(curve: Curve2): void;
+    getSingularities(): number[];
+    getHeadScale(): number;
+    getTailScale(): number;
+    updateExtension(): void;
+    /**
+     * 判断该曲线是否为直线
+     * @returns
+     */
+    isLineLike(): boolean;
+    getPtAt(t: number): Vec2;
+    getParamAt(point: types.IXYZ): number;
+    getAllFootParams(point: types.IXY, lengthEps?: number): number[];
+    /**
+     *  获取某参数处的切线
+     * @param t 参数
+     * @param snapToPreviousEnd 参数点在奇异点附近时，当输入为true时返回奇异点前的切向量，false时返回奇异点后的切向量。当 t === range.min 时，默认为 false，否则默认为 true。
+     */
+    getTangentAt(t: number, snapToPreviousEnd?: boolean): Vec2;
+    /**
+     * 获取某参数t处的几阶导数，例如 n = 2 时，会返回曲线在参数t处的坐标、1阶导、2阶导
+     * @param t 参数
+     * @param n 需要计算的导数的最大阶数
+     * @param snapToPreviousEnd 参数点在奇异点附近时，当输入为true时返回奇异点的前导数，false时返回奇异点的后导数。当 t === range.min 时，默认为 false，否则默认为 true。
+     */
+    getDerivatives(t: number, nth: number, snapToPreviousEnd?: boolean): Vec2[];
+    getLength(range?: Interval): number;
+    /**
+     * split into simple curves
+     */
+    toSimpleCurves(): Curve2[];
+    offset(dist: number): boolean;
+    reverse(): this;
+    transform(m: types.IMatrix3 | types.numberArrs3X3, extra?: ICurve2dTransformExtra): this;
+    transformed(m: types.IMatrix3 | types.numberArrs3X3, extra?: ICurve2dTransformExtra): Curve2;
+    /**
+     * 拟合成nurbscurve2d
+     */
+    toNurbs(degree?: number, lengthEps?: number): NurbsCurve2;
+    /**
+     * 计算曲线在给定参数区间的包围盒，如果没有传入参数域则计算曲线默认参数域的包围盒
+     */
+    getBBox(range?: Interval): Box2;
+    discrete(params?: DiscreteParam): Vec2[];
+    getType(): EN_GEO_TYPE.EXTEND_CURVE_2D;
+    clone(): ExtendCurve2;
+    dump(): types.IDBExtendCurve2d;
+    load(json: types.IDBExtendCurve2d): this;
+    private _getBase;
+}

package/types/geometry/geometry2d.d.ts

@@ -0,0 +1,35 @@
+import { types } from '../type_define/i_types';
+import { Box2 } from '../base/box2';
+import { GeoElement } from '../base/geo_element';
+import { IGeometry2d, ITransformExtra } from '../type_define/i_geometry';
+/**
+ * @author tiansk
+ *  所有几何对象的基类
+ */
+export declare abstract class Geometry2d extends GeoElement implements IGeometry2d {
+    /**
+     * 乘上一个变换矩阵，改变自己
+     */
+    abstract transform(m: types.IMatrix3 | types.numberArrs3X3, extra?: ITransformExtra): this;
+    /**
+     * 计算包围盒
+     */
+    abstract getBBox(): Box2;
+    /**
+     * 平移，改变自己
+     */
+    translate(offset: types.IXY): this;
+    /**
+     * 绕坐标轴/点的旋转，改变自己
+     * @param angle 旋转的角度
+     * @param pivot 旋转轴上一点
+     */
+    rotate(angle: number, pivot: types.IXYZ): this;
+    /**
+     * 缩放，改变自己
+     * 直线支持非等比，其他情况都是等比例缩放
+     * @param factor 放大因子
+     * @param center 缩放中心
+     */
+    scale(factor: number, center: types.IXY): this;
+}

package/types/geometry/geometry3d.d.ts

@@ -0,0 +1,36 @@
+import { types } from '../type_define/i_types';
+import { Box3 } from '../base/box3';
+import { IGeometry3d, ITransformExtra } from '../type_define/i_geometry';
+import { GeoElement } from '../base/geo_element';
+/**
+ * @author tiansk
+ *  所有几何对象的基类
+ */
+export declare abstract class Geometry3d extends GeoElement implements IGeometry3d {
+    /**
+     * 乘上一个变换矩阵，改变自己
+     */
+    abstract transform(m: types.IMatrix4 | types.numberArrs4X4, extra?: ITransformExtra): this;
+    /**
+     * 计算包围盒
+     */
+    abstract getBBox(): Box3;
+    /**
+     * 平移，改变自己
+     */
+    translate(offset: types.IXYZ): this;
+    /**
+     * 绕坐标轴/点的旋转，改变自己
+     * @param angle 旋转的角度
+     * @param pivot 旋转轴上一点
+     * @param axis  绕哪个轴旋转
+     */
+    rotate(angle: number, pivot: types.IXYZ, axis?: types.IXYZ): this;
+    /**
+     * 缩放，改变自己
+     * 直线支持非等比，其他情况都是等比例缩放
+     * @param factor 放大因子
+     * @param center 缩放中心
+     */
+    scale(factor: number, center: types.IXYZ): this;
+}