mxcad 1.0.272 → 1.0.273

package/dist/mxcad.d.ts

@@ -920,6 +920,13 @@ export declare class McGePoint3d {
  */
 export declare class McGeVector3d {
 	/**
+   * 0长度向量
+   * @example
+   * ```ts
+   * ```
+   * */
+	static kIdentity: McGeVector3d;
+	/**
 	 * X轴单位向量, 指向正 X 轴方向
 	 * @example
 	 * ```ts
@@ -1434,6 +1441,13 @@ export declare class McGeMatrix3d {
 	 * ```
 	 */
 	scale(): number;
+	/**
+	 * 获取矩阵在XY平面的旋转角度因子。
+	 * @returns旋转角度因子。
+	 * @example
+	 * ```
+	 */
+	angleXYPlane(): number;
 	/**
 	 * 获取矩阵中指定位置的元素值。
 	 * @param row 行索引。
@@ -1754,7 +1768,7 @@ export declare class McGePoint3dArray {
 	   const myArray2 = new McGePoint3dArray(initialValues);
 	 * ```
 	 */
-	constructor(imp?: object);
+	constructor(imp?: object, isDestroyImp?: boolean);
 	/**
 	 * 复制对象的值
 	 * @param val 三维点的数组
@@ -1895,7 +1909,7 @@ export declare class McGeDoubleArray {
 	   const array = new McGeDoubleArray();
 	 * ```
 	 */
-	constructor(imp?: object);
+	constructor(imp?: object, isDestroyImp?: boolean);
 	/**
 	 * 复制对象的值
 	 * @param val 双精度浮点数数组
@@ -4073,7 +4087,15 @@ export declare class McDbEntity extends McDbObject {
 	 * let ent:McDbEntity = id.getMcDbEntity();
 	 * if (ent === null) return;
 	 * // 打碎对象
-	 * let retExplode: MxCADResbuf = ent.explode();
+	 *       let retExplode: MxCADResbuf = ent.explode();
+	 *       if (retExplode.GetCount() == 0) return;
+	 *       let iExplodeConut = retExplode.GetCount();
+	 *       for (let j = 0; j < iExplodeConut; j++) {
+	 *           let tmpobj = retExplode.AtObject(j).val;
+	 *           if(tmpobj instanceof McDbEntity ){
+	 *               mxcad.drawEntity(tmpobj);
+	 *           }
+	 *       }
 	 * ```
 	 */
 	explode(): MxCADResbuf;
@@ -5534,13 +5556,14 @@ export declare class McDbAttribute extends McDbText {
 	 */
 	get isInvisible(): boolean;
 	/**
-	 * 设置块属性文字是否可见
+	 * 设置块属性文字是否不可见
 	 * @example
 	 * ```ts
 	 * import { McDbAttribute } from "mxcad";
 	 *
 	 * const attrib = new McDbAttribute();
-	 * attrib.isInvisible = true;
+	 * attrib.isInvisible = false;// 设置属性可见
+	 * attrib.isInvisible = true;// 设置属性不可见
 	 */
 	set isInvisible(val: boolean);
 }
@@ -5581,6 +5604,7 @@ export declare class McDbAttributeDefinition extends McDbText {
 	 *
 	 * const attribute = new McDbAttributeDefinition();
 	 * attribute.isInvisible = true; // 设置属性为不可见
+	 * attribute.isInvisible = false; // 设置属性为可见
 	 * console.log(attribute.isInvisible); // 获取属性是否可见
 	 * ```
 	 */
@@ -8275,6 +8299,76 @@ export declare class McDbBackgroundEntity extends McDbEntity {
 	*/
 	clearDwg(sDwgFile: string): boolean;
 }
+/**
+ * 样条线对象
+ */
+export declare class McDbSpline extends McDbCurve {
+	/**
+	 * 构造函数
+	 * @param imp 实现对象
+	 * @example
+	 * ```
+	 */
+	constructor(imp?: any);
+	/**
+	 * 得到样条线的数据.
+	 * @example
+	 * ```
+	 */
+	getNurbsData(): {
+		degree: number;
+		rational: boolean;
+		closed: boolean;
+		periodic: boolean;
+		controlPoints: McGePoint3dArray;
+		knots: McGeDoubleArray;
+		weights: McGeDoubleArray;
+		controlPtTol: number;
+		knotTol: number;
+	};
+	/**
+	 * 设置样条线的数据.
+	 * @example
+	 * ```
+	 */
+	setNurbsData(data: {
+		degree: number;
+		rational: boolean;
+		closed: boolean;
+		periodic: boolean;
+		controlPoints: McGePoint3dArray;
+		knots: McGeDoubleArray;
+		weights: McGeDoubleArray;
+		controlPtTol: number;
+		knotTol: number;
+	}): boolean;
+	/**
+	 * 得到样条线的拟合数据.
+	 * @example
+	 * ```
+	 */
+	getFitPoints(): {
+		degree: number;
+		fitTolerance: number;
+		tangentsExist: boolean;
+		startTangent: McGeVector3d;
+		endTangent: McGeVector3d;
+		fitPoints: McGePoint3dArray;
+	};
+	/**
+	 *设置样条线的拟合数据.
+	 * @example
+	 * ```
+	 */
+	setFitPoints(data: {
+		degree: number;
+		fitTolerance: number;
+		tangentsExist: boolean;
+		startTangent: McGeVector3d;
+		endTangent: McGeVector3d;
+		fitPoints: McGePoint3dArray;
+	}): boolean;
+}
 /**
  * Dxf组码
  * @public
@@ -9758,6 +9852,16 @@ export declare class McDbDatabase extends McRxObject {
 	 * @param imp 内部实现对象。
 	 */
 	constructor(imp?: any);
+	/**
+	 * 得到UCS用户坐标系变换矩阵
+	 * @example
+	 */
+	get ucsMatrix(): McGeMatrix3d;
+	/**
+	* 设置UCS用户坐标系变换矩阵
+	* @example
+	*/
+	set ucsMatrix(val: McGeMatrix3d);
 	/**
 	 * 获取层表。
 	 * @returns 层表。
@@ -11019,10 +11123,10 @@ export declare class McObject {
 	*/
 	protected creaeCallId(): number;
 	/**
-   * 设置对象的一些属性设置
-   * @param val 属性设置内容.
-   * 1. DisplayPrecision 显示精度设置，默认为0,可以取0 ~1000,1000为最高精度了
-   * 2. EnableUndo 启用undo功能，默认是没有启动的
+	 * 设置对象的一些属性设置
+	 * @param val 属性设置内容.
+	 * 1. DisplayPrecision 显示精度设置，默认为0,可以取0 ~1000,1000为最高精度了
+	 * 2. EnableUndo 启用undo功能，默认是没有启动的
 	 * @example
 	 * ```ts
 	 * 启用undo
@@ -11043,8 +11147,8 @@ export declare class McObject {
 	 */
 	getMxDrawObject(): MxDrawObject;
 	/**
-   * 返回与MxCAD对象绑定的MxDraw对象。
-   * @returns MxDraw对象
+	 * 返回与MxCAD对象绑定的MxDraw对象。
+	 * @returns MxDraw对象
 	 * @example
 	 * ```ts
 	 * import { McObject } from 'mxcad'
@@ -11052,7 +11156,7 @@ export declare class McObject {
 	 * const mxcad = new McObject()
 	 * const mxdraw = mxcad.mxdraw
 	 * ```
-   */
+	 */
 	get mxdraw(): MxDrawObject;
 	/**
 	 * 获取内部实现对象
@@ -11071,19 +11175,19 @@ export declare class McObject {
 	 * @example
 	 * ```ts
 	 * import { McObject } from "mxcad"
-
-		// 创建mxcad示例对象
-		const mxcad = new McObject()
-		mxcad.create({
-			// canvas元素的id
-			canvas: "#myCanvas",
-			// 获取加载wasm相关文件(wasm/js/worker.js)路径位置
-			locateFile: (fileName)=> new URL(`/node_modules/mxcad/dist/wasm/2d/${fileName}`, import.meta.url).href,
-			// 需要初始化打开的文件url路径
-			fileUrl: new URL("../src/assets/test.mxweb", import.meta.url).href,
-			// 提供加载字体的目录路径
-			fontspath:  new URL("node_modules/mxcad/dist/fonts", import.meta.url).href,
-		})
+	 *
+	 * // 创建mxcad示例对象
+	 *  const mxcad = new McObject()
+	 * mxcad.create({
+	 * // canvas元素的id
+	 * canvas: "#myCanvas",
+	 * // 获取加载wasm相关文件(wasm/js/worker.js)路径位置
+	 * locateFile: (fileName)=> new URL(`/node_modules/mxcad/dist/wasm/2d/${fileName}`, import.meta.url).href,
+	 * // 需要初始化打开的文件url路径
+	 * fileUrl: new URL("../src/assets/test.mxweb", import.meta.url).href,
+	 * // 提供加载字体的目录路径
+	 * fontspath:  new URL("node_modules/mxcad/dist/fonts", import.meta.url).href,
+	 * })
 	 * ```
 	 */
 	create(config: MxCadConfig): void;
@@ -11132,7 +11236,8 @@ export declare class McObject {
 	 * import { MxCpp, McObject } from "mxcad"
 	 *
 	 * const mxcad:McObject = MxCpp.getCurrentMxCAD();
-	 * mxcad.off("selectChange");
+	 * // e:事件函数,这里指代在mxcad.on("selectChange", e)中注册的函数
+	 * mxcad.off("selectChange", e);
 	 * ```
 	 */
 	off(name: string, fun?: Function): void;
@@ -11209,21 +11314,27 @@ export declare class McObject {
 	addCurrentSelect(id: McObjectId | McObjectId[], isDisplayGrid?: boolean): void;
 	/**
 	 * 清除当前所有选择
+	 * @example
+	 * ```ts
+	 * import { MxCpp, McObject } from "mxcad"
+	 *
+	 * const mxcad:McObject = MxCpp.getCurrentMxCAD()
+	 * mxcad.clearCurrentSelect();
 	 * ```
 	*/
 	clearMxCurrentSelect(): void;
 	/**
-  * 把当前显示范围移到指定的显示范围
-  * @param minPt 坐标1 McGePoint3d
-  * @param maxPt 坐标2 McGePoint3d
-  * @param isWorld 默认为felse DWG图纸坐标，设置为true是THREEJS坐标
-  * @returns void
-  * @example
-  * ```typescript
-  * import { MxApp, McGePoint3d, McObject } from "mxcad"
-  * const mxcad:McObject = MxCpp.getCurrentMxCAD()
-  * mxcad.zoomW(new McGePoint3d(0, 0), new McGePoint3d(30, 30))
-  * ```
+	  * 把当前显示范围移到指定的显示范围
+	  * @param minPt 坐标1 McGePoint3d
+	  * @param maxPt 坐标2 McGePoint3d
+	  * @param isWorld 默认为felse DWG图纸坐标，设置为true是THREEJS坐标
+	  * @returns void
+	  * @example
+	  * ```typescript
+	  * import { MxApp, McGePoint3d, McObject } from "mxcad"
+	  * const mxcad:McObject = MxCpp.getCurrentMxCAD()
+	  * mxcad.zoomW(new McGePoint3d(0, 0), new McGePoint3d(30, 30))
+	  * ```
   */
 	zoomW(minPt: McGePoint3d, maxPt: McGePoint3d): void;
 	/**
@@ -11899,7 +12010,7 @@ export declare class McObject {
 	 * @param dPosY 图片 Y 坐标
 	 * @param dWidth 图片宽度
 	 * @param dHeight 图片高度
-	 * @param dAng 图片角度
+	 * @param dAng 图片角度,单位是度
 	 * @param imageUrl 图片路径
 	 */
 	drawImage(dPosX: number, dPosY: number, dWidth: number, dHeight: number, dAng: number, imageUrl: string, isConvertBase64?: boolean, dwgImageSizeWidth?: number, dwgImageSizeHeight?: number): McObjectId;
@@ -12700,6 +12811,11 @@ export declare class McAppType {
 	 * ```
 	 */
 	getVersionString(): string;
+	/**
+	 * 得当前程序的数字日期版本信息
+	 * @return 数字日期版本信息
+	 */
+	GetVersionDateString(): string;
 }
 /**
  * MxCppType 类封装了一系列与 CAD 相关的操作，包括创建点、向量、获取当前对象等