[mxcad_2d API documentation] (../README. md)/[2d] (../modules/2d. md)/McDDbSplit

Class: McDbSpline ​

2d.McDbSpline

Spline object

Hierarchy ​

• McDbCurve

  ↳ McDbSpline

Table of contents ​

Constructors ​

• constructor

Properties ​

• imp

Accessors ​

• colorIndex
• drawOrder
• dxf0
• layer
• layerId
• linetype
• linetypeId
• linetypeScale
• lineweight
• normal
• objectName
• textStyle
• textStyleId
• trueColor
• visible

Methods ​

• IntersectWith
• assertObjectModification
• clone
• createExtensionDictionary
• deleteXData
• disableDisplay
• erase
• explode
• getAllAppName
• getArea
• getBoundingBox
• getClosestPointTo
• getDatabase
• getDatabaseIndexId
• getDistAtParam
• getDistAtPoint
• getEndParam
• getEndPoint
• getExtensionDictionary
• getFirstDeriv
• getFirstDerivFromParam
• getFitPoints
• getGripPoints
• getHandle
• getImp
• getJson
• getLength
• getNurbsData
• getObjectID
• getOwnerID
• getParamAtDist
• getParamAtPoint
• getPointAtDist
• getPointAtParam
• getSamplePoints
• getStartParam
• getStartPoint
• getxData
• getxDataDouble
• getxDataLong
• getxDataPoint
• getxDataString
• highlight
• initTempObject
• isErased
• isHaveExtensionDictionary
• isKindOf
• isNull
• mirror
• move
• moveGripPointsAt
• offsetCurves
• rotate
• scaleEntity
• setFitPoints
• setJson
• setNurbsData
• setxData
• setxDataDouble
• setxDataLong
• setxDataPoint
• setxDataString
• splitCurves
• splitCurvesFromParam
• syncData
• transformBy
• unErase
• updateDisplay

Constructors ​

constructor ​

• new McDbSpline(imp?)

Constructor function

Example

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `imp?` | ` Any | Implement object|

#### Overrides

[McDbCurve](2d.McDbCurve.md).[constructor](2d.McDbCurve.md#constructor)

## Properties

### imp

• **imp**: `any` = `0`

Internal implementation object.

#### Inherited from

[McDbCurve](2d.McDbCurve.md).[imp](2d.McDbCurve.md#imp)

## Accessors

### colorIndex

• `get` **colorIndex**(): `number`

Obtain object color index

**`Example`**

```ts
 import { McDbEntity, ColorIndexType } from 'mxcad'
 const ent = new McDbEntity();
 ent.colorIndex = ColorIndexType.kByblock;
 console.log(ent.colorIndex)

Returns ​

number

Inherited from ​

McDbCurve.colorIndex

• set colorIndex(val): void

Set object color index

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.colorIndex

drawOrder ​

• get drawOrder(): number

Display order of objects

Example

//Assuming ent is a valid instance object
const order = ent.drawOrder();

Returns ​

number

Inherited from ​

McDbCurve.drawOrder

• set drawOrder(order): void

Display order of objects

Example

import { MxCpp, MxCADSelectionSet } from "mxcad";

let ss = new MxCADSelectionSet();
If (! Await ss.userSelect) return;
//Obtain the maximum and minimum display order of objects on the current graph
let minmaxOrder = MxCpp.getCurrentDatabase().currentSpace.getMinMaxDrawOrder();
//Place the object at the top.
let lOrder = minmaxOrder.maxDrawOrder + 1;
ss.forEach((id) => {
  let ent = id.getMcDbEntity();
  if (ent) {
    ent.drawOrder = lOrder;
  }
})

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.drawOrder

dxf0 ​

• get dxf0(): string

Obtain the type name of the object's DXF group code, which is the same as the DXF group code in AutoCAD. For example, the type name of the line is McDbLine, and the group code value for DXF0 is: LINE and DXF0 group code values can be used for type filtering when constructing sets.

Returns ​

string

Inherited from ​

McDbCurve.dxf0

layer ​

• get layer(): string

Obtain the layer name of the object

Returns ​

string

Inherited from ​

McDbCurve.layer

• set layer(val): void

Set object layer name

Example

import { McDbEntity } from 'mxcad'
 const ent = new McDbEntity();
 ent.layer = "newLayerName";
 console.log(ent.layer)

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.layer

layerId ​

• get layerId(): McObjectId

Get layer ID object

Example

//Assuming ent is a valid instance object
const layerId = ent.layerId;

Returns ​

McObjectId

Inherited from ​

McDbCurve.layerId

• set layerId(id): void

Set Layer Id Object

Example

//Assuming ent is a valid instance object
const mxcad = MxCpp.getCurrentMxCAD();
Const layerId=mxcad. addLayer (Test Layer)
ent.layerId = layerId;

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.layerId

linetype ​

• get linetype(): string

Obtain the object line type name

Returns ​

string

Inherited from ​

McDbCurve.linetype

• set linetype(val): void

Set object line type name

Example

import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.linetype = "MyLineType";
console.log(ent.linetype)

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.linetype

linetypeId ​

• get linetypeId(): McObjectId

Get entity object line type ID

Example

//Assuming ent is a valid instance object
const linetypeId = ent.linetypeId;

Returns ​

McObjectId

Inherited from ​

McDbCurve.linetypeId

• set linetypeId(id): void

Set entity object line type ID

Example

//Assuming ent is a valid instance object
const mxcad = MxCpp.getCurrentMxCAD();
const lineId = mxcad.addLinetypeEx("TestMyLine", '25,-5');
ent.linetypeId = lineId;

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.linetypeId

linetypeScale ​

• get linetypeScale(): number

Obtain the proportion of object line types

Returns ​

number

Inherited from ​

McDbCurve.linetypeScale

• set linetypeScale(val): void

Set object line type scale

Example

import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.linetypeScale = 0.8;
console.log(ent.linetypeScale)

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.linetypeScale

lineweight ​

• get lineweight(): number

Obtain object line weight

Returns ​

number

Inherited from ​

McDbCurve.lineweight

• set lineweight(val): void

Set object line weight

Example

import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.lineweight = 20;
console.log(ent.lineweight)

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.lineweight

normal ​

• get normal(): McGeVector3d

Return the normal of the object

Example

Returns ​

McGeVector3d

Inherited from ​

McDbCurve.normal

• set normal(val): void

Set the normal of the object

Example

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.normal

objectName ​

• get objectName(): string

Get the object name.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
console.log(obj.objectName);

Returns ​

string

Return object name

Inherited from ​

McDbCurve.objectName

textStyle ​

• get textStyle(): string

Obtain the text style of the object

Returns ​

string

Inherited from ​

McDbCurve.textStyle

• set textStyle(val): void

Set object text style

Example

import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.textStyle = "st_style";

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.textStyle

textStyleId ​

• get textStyleId(): McObjectId

Get entity text style

Example

//Assuming ent is a valid instance object
const textStyleId = ent.textStyleId;

Returns ​

McObjectId

Inherited from ​

McDbCurve.textStyleId

• set textStyleId(id): void

Set the text style of the entity

Example

//Assuming ent is a valid instance object
const mxcad = MxCpp.getCurrentMxCAD();
const textStyleId = mxcad.addTextStyle("MyLineTypeTextStyle", "txt.shx", "hztxt.shx", 1);
ent.textStyleId = textStyleId;

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.textStyleId

trueColor ​

• get trueColor(): McCmColor

Obtain the color of the object

Example

import { McDbEntity, McCmColor} from 'mxcad'
 const ent = new McDbEntity();
 ent.trueColor = new McCmColor(255, 0, 0);
 console.log(ent.trueColor)

Returns ​

McCmColor

Inherited from ​

McDbCurve.trueColor

• set trueColor(val): void

Set object color

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.trueColor

visible ​

• get visible(): boolean

Is the object visible

Returns ​

boolean

Inherited from ​

McDbCurve.visible

• set visible(val): void

Set whether it is visible

Example

import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.visible = true;
console.log(ent.visible)

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.visible

Methods ​

IntersectWith ​

▸ IntersectWith(intersectObject, exOption): McGePoint3dArray

Intersection with other entities to obtain the intersection point

Example

import { McDbLine, McDb } from 'mxcad'
const line1 = new McDbLine(new McGePoint3d(0,0,0), new McGePoint3d(20,1,0));
const line2 = new McDbLine(new McGePoint3d(10,10,0), new McGePoint3d(11,1,0));
const ptArr = line1.IntersectWith(line2, McDb.Intersect.kExtendBoth)

Parameters ​

Returns ​

McGePoint3dArray

Obtain all intersection points

Inherited from ​

McDbCurve.IntersectWith

assertObjectModification ​

▸ assertObjectModification(autoUndo?): number

Setting the state of the object to be changed can automatically trigger the update display function to update the display. For example, if the block table record is updated and the block reference needs to be notified to update the display, this function can be called.

Example

//Assuming obj is a database object
obj.assertObjectModification()

Parameters ​

Returns ​

number

Inherited from ​

McDbCurve.assertObjectModification

clone ​

▸ clone(): null | McDbObject

Clone objects.

Example

//Assuming obj is a database object
const obj_clone = obj.clone();

Returns ​

null | McDbObject

The cloned object.

Inherited from ​

McDbCurve.clone

createExtensionDictionary ​

▸ createExtensionDictionary(): boolean

Create extended dictionary data for objects

Example

//Assuming obj is a database object
const res = obj.createExtensionDictionary();

Returns ​

boolean

Inherited from ​

McDbCurve.createExtensionDictionary

deleteXData ​

▸ deleteXData(appName): boolean

Delete data related to entity specified application name

Example

import { MxCADUiPrEntity, McDbEntity } from "mxcad";

let selEntity = new MxCADUiPrEntity();
SelEntity. setMessage ("Select Object");
let id = await selEntity.go();
if (!id.isValid()) return;
let ent:McDbEntity = id.getMcDbEntity();
if (ent === null) return;
const res = ent.deleteXData("DataName");
if(res){
//Delete successfully
}else
//Delete failed
}

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.deleteXData

disableDisplay ​

▸ disableDisplay(isDisable): void

Disable automatic update display of objects

Example

import { McDbLine } from 'mxcad'
const line1 = new McDbLine(new McGePoint3d(0,0,0), new McGePoint3d(20,1,0));
line1.disableDisplay(true)

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.disableDisplay

erase ​

▸ erase(): boolean

Delete object.

Example

//Assuming obj is a database object
const res = obj.erase();
console.log(res);

Returns ​

boolean

Whether the deletion was successful.

Inherited from ​

McDbCurve.erase

explode ​

▸ explode(): MxCADResbuf

Break the object and return the linked list of the object's data after being broken

Example

import { McDbEntity, MxCADResbuf } from "mxcad";
//Obtain the target object
let getEnt = new MxCADUiPrEntity();
GetEnt.setMessage ("Select object to break: ");
let id = await getEnt.go();
let ent:McDbEntity = id.getMcDbEntity();
if (ent === null) return;
//Smash objects
      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);
          }
      }

Returns ​

MxCADResbuf

Rebuf data

Inherited from ​

McDbCurve.explode

getAllAppName ​

▸ getAllAppName(): McGeStringArray

Get the application name (AppName) of all XData records contained in the entity

Example

//Assuming ent is a valid instance object
const appNames = ent.getAllAppName();
console.log(appNames);

Returns ​

McGeStringArray

Inherited from ​

McDbCurve.getAllAppName

getArea ​

▸ getArea(): Object

Calculate Area

Example

import { McGePoint3d, McDbCircle } from "mxcad"

const center = new McGePoint3d(0,0,0);
const circle = new McDbCircle(center, 20);
const area = circle.getArea();
Console.log ("Circle area: ", area)

Returns ​

Object

Is the val area value | ret successfully obtained

Inherited from ​

McDbCurve.getArea

getBoundingBox ​

▸ getBoundingBox(): Object

Obtain the minimum outsourcing of the object

Example

import { McDbText, McGePoint3d } from 'mxcad'
const text = new McDbText();
Text.textString="Test Test";
text.height = 20;
text.position = text.alignmentPoint = new McGePoint3d(0,0,0);
const { minPt, maxPt, ret } = text.getBoundingBox()

Returns ​

Object

Inherited from ​

McDbCurve.getBoundingBox

getClosestPointTo ​

▸ getClosestPointTo(givenPnt, isExtend): Object

Obtain the closest point from a point to the curve

Example

import { McGePoint3d, McDbCircle, MxCADUiPrPoint, MxCpp } from "mxcad"

const center = new McGePoint3d(0,0,0);
const circle = new McDbCircle(center, 20);
const mxcad = MxCpp.getCurrentMxCAD();
mxcad.drawEntity(circle);

const getPoint = new MxCADUiPrPoint();
getPoint.setUserDraw((pt,pw)=>{
//Get pt to the nearest point on the circle
  const point = circle.getClosestPointTo(pt);
  console.log(point)
})
const point = await getPoint.go();

Parameters ​

Returns ​

Object

Point objects and execution results.

Inherited from ​

McDbCurve.getClosestPointTo

getDatabase ​

▸ getDatabase(): McDbDatabase

Get the database where the object is located

Example

//Assuming obj is a database object
const data = obj.getDatabase();

Returns ​

McDbDatabase

Return to database

Inherited from ​

McDbCurve.getDatabase

getDatabaseIndexId ​

▸ getDatabaseIndexId(): number

Get the index ID of the object

Example

//Assuming obj is a database object
const id = obj.getDatabaseIndexId();

Returns ​

number

Inherited from ​

McDbCurve.getDatabaseIndexId

getDistAtParam ​

▸ getDistAtParam(param): Object

Get the distance at the parameter location.

Example

//Assuming curve is an effective curve instance object
const res = curve.getDistAtParam(2);
if(res.ret){
  console.log(res.val)
}

Parameters ​

Returns ​

Object

Distance and execution results.

Inherited from ​

McDbCurve.getDistAtParam

getDistAtPoint ​

▸ getDistAtPoint(pt): Object

Obtain the distance and position of points on the curve.

Example

import { McGePoint3d, McDbLine } from "mxcad"

const pt1 = new McGePoint3d(0,0,0);
const pt2 = new McGePoint3d(20,0,0);
const line = new McDbLine(pt1, pt2)
const res = line.getDistAtPoint(pt2);
if(res.ret){
  const dist = res.val;
  console.log(dist);//20
}

Parameters ​

Returns ​

Object

Points and execution results.

Inherited from ​

McDbCurve.getDistAtPoint

getEndParam ​

▸ getEndParam(): Object

Get the end parameter.

Example

//Assuming curve is an effective curve instance object
const endPa = curve.getEndParam();
if(endPa.ret){
  console.log(endPa.val)
}

Returns ​

Object

End parameters and execution results.

Inherited from ​

McDbCurve.getEndParam

getEndPoint ​

▸ getEndPoint(): Object

Obtain the endpoint of the curve

Example

import { McGePoint3d, McDbLine } from "mxcad"

const pt1 = new McGePoint3d(0,0,0);
const pt2 = new McGePoint3d(20,0,0);
const line = new McDbLine(pt1, pt2)
const res = line.getEndPoint();
if(res.ret){
  const point = res.val;
  console.log(point);//(20, 0, 0)
}

Returns ​

Object

The endpoint and execution result of the curve.

Inherited from ​

McDbCurve.getEndPoint

getExtensionDictionary ​

▸ getExtensionDictionary(): McDbDictionary

Obtain the extended dictionary data of the object

Example

//Assuming obj is a database object
const id = obj.getOwnerID();

Returns ​

McDbDictionary

Expand dictionary data

Inherited from ​

McDbCurve.getExtensionDictionary

getFirstDeriv ​

▸ getFirstDeriv(pt): Object

Obtain the first derivative of the curve through a certain point on the curve

Example

import { McGePoint3d, McDbCircle } from "mxcad"

const center = new McGePoint3d(0,0,0);
const circle = new McDbCircle(center, 20);
const vec = circle.getFirstDeriv(new McGePoint3d(20,0,0));// Target point tangent vector
if(vec.ret){
 const val = vec.val;
}

Parameters ​

Returns ​

Object

The first derivative of the curve and its execution result.

Inherited from ​

McDbCurve.getFirstDeriv

getFirstDerivFromParam ​

▸ getFirstDerivFromParam(param): Object

Obtain the first derivative of the curve through curve parameters

Example

//Assuming curve is an effective curve instance object
const res = curve.getFirstDerivFromParam(5);
if(res.ret){
  console.log(res.val)
}

Parameters ​

Returns ​

Object

The first derivative of the curve and its execution result.

Inherited from ​

McDbCurve.getFirstDerivFromParam

getFitPoints ​

▸ getFitPoints(): Object

Obtain the fitting data of the spline

Example

#### Returns

`Object`

| Name | Type |
| :------ | :------ |
| `degree` | `number` |
| `endTangent` | [`McGeVector3d`](2d.McGeVector3d.md) |
| `fitPoints` | [`McGePoint3dArray`](2d.McGePoint3dArray.md) |
| `fitTolerance` | `number` |
| `startTangent` | [`McGeVector3d`](2d.McGeVector3d.md) |
| `tangentsExist` | `boolean` |

___

### getGripPoints

▸ **getGripPoints**(): [`McGePoint3dArray`](2d.McGePoint3dArray.md)

Get the control points of the object

**`Example`**

```ts
//Assuming obj is a database object
const ptArr = obj.getGripPoints();

Returns ​

McGePoint3dArray

Inherited from ​

McDbCurve.getGripPoints

getHandle ​

▸ getHandle(): string

Obtain object handle

Example

//Assuming obj is a database object
const handle = obj.getHandle();

Returns ​

string

Return object handle

Inherited from ​

McDbCurve.getHandle

getImp ​

▸ getImp(): any

Retrieve internal implementation objects.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
let imp = obj.getImp();

Returns ​

any

Internal implementation object.

Inherited from ​

McDbCurve.getImp

getJson ​

▸ getJson(): string

Retrieve a string in JSON format.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
const json = obj.getJson()

Returns ​

string

A string in JSON format.

Inherited from ​

McDbCurve.getJson

getLength ​

▸ getLength(): Object

Obtain the length of the curve

Example

import { MxCpp, MxCADResbuf, MxCADUtility, MxCADUiPrPoint} from "mxcad"

 const mxcad = MxCpp.App.getCurrentMxCAD();
   let filter = new MxCADResbuf();
   filter.AddMcDbEntityTypes("CIRCLE,ARC,LINE,LWPOLYLINE,ELLIPSE");
Let aryId=await MxCADUtility. userSelect ("Select target curve", filter);
   if (aryId.length == 0)  return;
   aryId.forEach(async (id) => {
       let event = id.getMcDbEntity() as McDbCurve;
       let length = event.getLength().val;
       console.log(length)
   });

Returns ​

Object

Inherited from ​

McDbCurve.getLength

getNurbsData ​

▸ getNurbsData(): Object

Obtain spline data

Example

#### Returns

`Object`

| Name | Type |
| :------ | :------ |
| `closed` | `boolean` |
| `controlPoints` | [`McGePoint3dArray`](2d.McGePoint3dArray.md) |
| `controlPtTol` | `number` |
| `degree` | `number` |
| `knotTol` | `number` |
| `knots` | [`McGeDoubleArray`](2d.McGeDoubleArray.md) |
| `periodic` | `boolean` |
| `rational` | `boolean` |
| `weights` | [`McGeDoubleArray`](2d.McGeDoubleArray.md) |

___

### getObjectID

▸ **getObjectID**(): [`McObjectId`](2d.McObjectId.md)

Get the object ID.

**`Example`**

```ts
import { McDbObject } from "mxcad";
const id = obj.getObjectID();

Returns ​

McObjectId

Object ID.

Inherited from ​

McDbCurve.getObjectID

getOwnerID ​

▸ getOwnerID(): number

Obtain the ID of the object owner

Example

//Assuming obj is a database object
const id = obj.getOwnerID();

Returns ​

number

Inherited from ​

McDbCurve.getOwnerID

getParamAtDist ​

▸ getParamAtDist(dist): Object

Obtain parameters at the distance position.

Example

//Assuming curve is an effective curve instance object
const res = curve.getParamAtDist(0);
if(res.ret){
  console.log(res.val)
}

Parameters ​

Returns ​

Object

Parameters and execution results.

Inherited from ​

McDbCurve.getParamAtDist

getParamAtPoint ​

▸ getParamAtPoint(pt): Object

Obtain the curve parameters at a certain point on the curve

Example

import { McGePoint3d, McDbLine } from "mxcad"

const pt1 = new McGePoint3d(0,0,0);
const pt2 = new McGePoint3d(20,0,0);
const line = new McDbLine(pt1, pt2)
const res = line.getParamAtPoint(pt1);
if(res.ret){
  const val = res.val;
  console.log(val);
}

Parameters ​

Returns ​

Object

Curve parameters and execution results.

Inherited from ​

McDbCurve.getParamAtPoint

getPointAtDist ​

▸ getPointAtDist(dist): Object

Obtain the point at the distance position.

Example

import { McGePoint3d, McDbLine } from "mxcad"

const pt1 = new McGePoint3d(0,0,0);
const pt2 = new McGePoint3d(20,0,0);
const line = new McDbLine(pt1, pt2)
const res = line.getPointAtDist(10);
if(res.ret){
  const point = res.val;
  console.log(point);//(10, 0, 0)
}

Parameters ​

Returns ​

Object

Points and execution results.

Inherited from ​

McDbCurve.getPointAtDist

getPointAtParam ​

▸ getPointAtParam(param): Object

Obtain the coordinates of the point where the curve parameters are located

Example

//Assuming curve is an effective curve instance object
const res = curve.getPointAtParam(5);
if(res.ret){
  console.log(res.val)
}

Parameters ​

Returns ​

Object

Point objects and execution results.

Inherited from ​

McDbCurve.getPointAtParam

getSamplePoints ​

▸ getSamplePoints(dApproxEps?): MxCADResbuf

Discretize the curve into a pile of points

Example

import { McGePoint3d, McDbLine } from "mxcad"

const pt1 = new McGePoint3d(0,0,0);
const pt2 = new McGePoint3d(20,0,0);
const line = new McDbLine(pt1, pt2);
const resBuf = line.getSamplePoints(0.1);

Parameters ​

Returns ​

MxCADResbuf

Rebuf data

Inherited from ​

McDbCurve.getSamplePoints

getStartParam ​

▸ getStartParam(): Object

Get the starting parameters.

Example

//Assuming curve is an effective curve instance object
const startPa = curve.getStartParam();
if(startPa.ret){
  console.log(startPa.val)
}

Returns ​

Object

Initial parameters and execution results.

Inherited from ​

McDbCurve.getStartParam

getStartPoint ​

▸ getStartPoint(): Object

Obtain the starting point of the curve

Example

import { McGePoint3d, McDbLine } from "mxcad"

const pt1 = new McGePoint3d(0,0,0);
const pt2 = new McGePoint3d(20,0,0);
const line = new McDbLine(pt1, pt2)
const res = line.getStartPoint();
if(res.ret){
  const point = res.val;
  console.log(point);//(0, 0, 0)
}

Returns ​

Object

The starting point and execution result of the curve.

Inherited from ​

McDbCurve.getStartPoint

getxData ​

▸ getxData(appName?): MxCADResbuf

Obtain the extended data of the object

Example

//Assuming ent is a valid instance object
const xData = ent.getXData();

Parameters ​

Returns ​

MxCADResbuf

Inherited from ​

McDbCurve.getxData

getxDataDouble ​

▸ getxDataDouble(appName): Object

Retrieve the double value from the specified XData type of the entity

Example

//Assuming ent is a valid instance object
let data = ent.getxDataDouble("DataName");
if(data.ret){
  console.log(data.val)
}

Parameters ​

Returns ​

Object

Double value

Inherited from ​

McDbCurve.getxDataDouble

getxDataLong ​

▸ getxDataLong(appName): Object

Retrieve the long (integer) value from the specified XData type of the entity

Example

//Assuming ent is a valid instance object
let data = ent.getxDataLong("DataName");
if(data.ret){
  console.log(data.val)
}

Parameters ​

Returns ​

Object

Long value

Inherited from ​

McDbCurve.getxDataLong

getxDataPoint ​

▸ getxDataPoint(appName): Object

Retrieve point objects from the specified XData type of entity

Parameters ​

Returns ​

Object

Obtain results and 3D point objects

Inherited from ​

McDbCurve.getxDataPoint

getxDataString ​

▸ getxDataString(appName): Object

Retrieve XData information associated with a specific entity and return it in string form

Example

//Assuming ent is a valid instance object
let data = ent.getxDataString("DataName");
if(data.ret){
  console.log(data.val)
}

Parameters ​

Returns ​

Object

Val XData information | whether ret returns success

Inherited from ​

McDbCurve.getxDataString

highlight ​

▸ highlight(isHighlight): void

Set whether the object is highlighted

Example

import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.highlight(true);

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.highlight

initTempObject ​

▸ initTempObject(imp): void

Initialize temporary objects.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
obj.initTempObject()

Parameters ​

Returns ​

void

Inherited from ​

McDbCurve.initTempObject

isErased ​

▸ isErased(): boolean

Has the object been deleted

Example

//Assuming obj is a database object
const res = obj.isErased();
console.log(res);

Returns ​

boolean

Inherited from ​

McDbCurve.isErased

isHaveExtensionDictionary ​

▸ isHaveExtensionDictionary(): boolean

Is there any extended dictionary data available

Example

//Assuming obj is a database object
const res = obj.isHaveExtensionDictionary();

Returns ​

boolean

Inherited from ​

McDbCurve.isHaveExtensionDictionary

isKindOf ​

▸ isKindOf(sObjectName): boolean

Determine object type

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
let isKind = obj.isKindOf('SomeObjectType');
console.log(isKind); //  Output: True or false

Parameters ​

Returns ​

boolean

Return whether the object is of the target type

Inherited from ​

McDbCurve.isKindOf

isNull ​

▸ isNull(): any

Determine if it is an empty object

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
console.log(obj.isNull()); //  Output: True or false

Returns ​

any

Inherited from ​

McDbCurve.isNull

mirror ​

▸ mirror(point1, point2): boolean

Mirror oriented object

Example

import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.mirror(new McGePoint3d(0,0,0), new McGePoint3d(20,10,0))

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.mirror

move ​

▸ move(fromPoint, toPoint): boolean

move objects

Example

import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.move(new McGePoint3d(0,0,0), new McGePoint3d(20,0,0))

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.move

moveGripPointsAt ​

▸ moveGripPointsAt(iIndex, dXOffset, dYOffset, dZOffset): any

Control points for moving objects

Example

//Assuming obj is a database object
obj.moveGripPointsAt(1,10,10,10);

Parameters ​

Returns ​

any

Inherited from ​

McDbCurve.moveGripPointsAt

offsetCurves ​

▸ offsetCurves(dOffsetDist, ptOffsetRef): McDbObjectArray

Obtain offset curve

Example

import { MxCADUiPrPoint, MxCpp } from 'mxcad'
   let getFristPoint = new MxCADUiPrPoint();
   let offsetDist = 10 ;
   let getEvent = new MxCADUiPrEntity();
GetEvent.setMessage ('Specify offset object ');
   let event_id = await getEvent.go();
   if (!event_id) return;
   let event = (await event_id.getMcDbEntity()) as McDbCurve;
   let getoOffPt = new MxCADUiPrPoint();
GetoOffPt.setMessage ('specify offset point ');
   let offPt = await getoOffPt.go();
   if (!offPt) return;
   let objArr = event.offsetCurves(offsetDist, offPt);
   if (objArr.length() === 0) return;
   objArr.forEach((obj: McDbObject) => {
       MxCpp.getCurrentCAD().drawEntity(obj as McDbEntity);
   });

Parameters ​

Returns ​

McDbObjectArray

Offset object array.

Inherited from ​

McDbCurve.offsetCurves

rotate ​

▸ rotate(basePoint, dRotationAngle): boolean

Rotate object

Example

import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.rotate(new McGePoint3d(0,0,0), Math.PI)

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.rotate

scaleEntity ​

▸ scaleEntity(basePoint, dScaleFactor): boolean

Scaling objects

Example

import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.scaleEntity(new McGePoint3d(0,0,0), 0.5)

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.scaleEntity

setFitPoints ​

▸ setFitPoints(data): boolean

Set the fitting data for spline lines

Example

#### Parameters

| Name | Type |
| :------ | :------ |
| `data` | `Object` |
| `data.degree` | `number` |
| `data.endTangent` | [`McGeVector3d`](2d.McGeVector3d.md) |
| `data.fitPoints` | [`McGePoint3dArray`](2d.McGePoint3dArray.md) |
| `data.fitTolerance` | `number` |
| `data.startTangent` | [`McGeVector3d`](2d.McGeVector3d.md) |
| `data.tangentsExist` | `boolean` |

#### Returns

`boolean`

___

### setJson

▸ **setJson**(`str`): `boolean`

Set a string in JSON format.

**`Example`**

```ts
import { McRxObject } from 'mxcad';

let obj = new McRxObject();
const res = obj.setJson('{"key": "value"}');
console.log(res)

Parameters ​

Returns ​

boolean

Is the setting successful.

Inherited from ​

McDbCurve.setJson

setNurbsData ​

▸ setNurbsData(data): boolean

Set spline data

Example

#### Parameters

| Name | Type |
| :------ | :------ |
| `data` | `Object` |
| `data.closed` | `boolean` |
| `data.controlPoints` | [`McGePoint3dArray`](2d.McGePoint3dArray.md) |
| `data.controlPtTol` | `number` |
| `data.degree` | `number` |
| `data.knotTol` | `number` |
| `data.knots` | [`McGeDoubleArray`](2d.McGeDoubleArray.md) |
| `data.periodic` | `boolean` |
| `data.rational` | `boolean` |
| `data.weights` | [`McGeDoubleArray`](2d.McGeDoubleArray.md) |

#### Returns

`boolean`

___

### setxData

▸ **setxData**(`xdata`): `boolean`

Set extended data for objects

**`Example`**

```ts
import { MxCADUiPrEntity, McDbEntity } from "mxcad";

//Set extended data
let selEntity = new MxCADUiPrEntity();
SelEntity. setMessage ("Select Object");
let id = await selEntity.go();
if (!id.isValid()) return;
let ent:McDbEntity = id.getMcDbEntity();
if (ent === null) return;
ent.setxData(new MxCADResbuf([{type:DxfCode.kExDataName,val:"DataName"},{type:DxfCode.kString,val:"yyyyy"}]));

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.setxData

setxDataDouble ​

▸ setxDataDouble(appName, val): boolean

Set the double value in the specified XData type of the entity

Example

import { MxCADUiPrEntity, McDbEntity } from "mxcad";
let selEntity = new MxCADUiPrEntity();
SelEntity. setMessage ("Select Object");
let id = await selEntity.go();
if (!id.isValid()) return;
let ent:McDbEntity = id.getMcDbEntity();
if (ent === null) return;
const res = ent.setxDataDouble("DataName", 0);
if(res){
//Setting successful
}else{
//Setting failed
}

Parameters ​

Returns ​

boolean

Boolean value

Inherited from ​

McDbCurve.setxDataDouble

setxDataLong ​

▸ setxDataLong(appName, val): boolean

Set the long (integer) value in the specified XData type of the entity

Example

import { MxCADUiPrEntity, McDbEntity } from "mxcad";

let selEntity = new MxCADUiPrEntity();
SelEntity. setMessage ("Select Object");
let id = await selEntity.go();
if (!id.isValid()) return;
let ent:McDbEntity = id.getMcDbEntity();
if (ent === null) return;
const res = ent.setxDataLong("DataName", 123456);
if(res){
//Setting successful
}else{
//Setting failed
}

Parameters ​

Returns ​

boolean

Long value

Inherited from ​

McDbCurve.setxDataLong

setxDataPoint ​

▸ setxDataPoint(appName, val): boolean

Set the point object in the specified XData type of the entity

Parameters ​

Returns ​

boolean

Obtain results and 3D point objects

Inherited from ​

McDbCurve.setxDataPoint

setxDataString ​

▸ setxDataString(appName, val): boolean

Set XData information associated with a specific entity and set it in string form

Example

import { MxCADUiPrEntity, McDbEntity } from "mxcad";
let selEntity = new MxCADUiPrEntity();
SelEntity. setMessage ("Select Object");
let id = await selEntity.go();
if (!id.isValid()) return;
let ent:McDbEntity = id.getMcDbEntity();
if (ent === null) return;
const res = ent.setxDataString("DataName", "xxxxx");
if(res){
//Setting successful
}else{
//Setting failed
}

Parameters ​

Returns ​

boolean

Is the setting successful

Inherited from ​

McDbCurve.setxDataString

splitCurves ​

▸ splitCurves(pts): McDbObjectArray

Detach Curves

Example

import { MxCpp } from "mxcad"
//PointsArr: breakpoint array event: McDbCurve
   event.splitCurves(PointsArr).forEach((e:McDbCurve, index:number) => {
       if(index % 2 === 0){
           MxCpp.getCurrentCAD().drawEntity(e as McDbEntity)
       }
   })

Parameters ​

Returns ​

McDbObjectArray

Interrupted curve array.

Inherited from ​

McDbCurve.splitCurves

splitCurvesFromParam ​

▸ splitCurvesFromParam(params): McDbObjectArray

Break the curve based on the curve parameters

Parameters ​

Returns ​

McDbObjectArray

Interrupted curve array.

Inherited from ​

McDbCurve.splitCurvesFromParam

syncData ​

▸ syncData(_toCpp?): boolean

Synchronize entity data. This method may be called after modifying the entity's attributes or attaching new data to ensure that all changes are correctly saved to the entity's database records.

Example

//Assuming ent is a valid instance object
const res = ent.syncData(true);
if(res){
//Synchronization successful
}else{
//Synchronization failed
}

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.syncData

transformBy ​

▸ transformBy(transformationMatrix): boolean

Transform object

Example

import { McGeMatrix3d, McDbEntity, McGeVector3d} from 'mxcad'
 const ent = new McDbEntity()
   let matrix = new McGeMatrix3d();
matrix.setToTranslation(new McGeVector3d(20,0,0));// translation
   ent.transformBy(matrix);

Parameters ​

Returns ​

boolean

Inherited from ​

McDbCurve.transformBy

unErase ​

▸ unErase(): boolean

Anti delete object.

Example

//Assuming obj is a database object
const res = obj.unErase();
console.log(res);

Returns ​

boolean

Inherited from ​

McDbCurve.unErase

updateDisplay ​

▸ updateDisplay(): void

Display the updated display of the calling object

Example

//Assuming ent is a valid instance object
ent.updateDisplay()

Returns ​

void

Inherited from ​

McDbCurve.updateDisplay