[mxcad_2d API documentation] (../README. md)/[2d] (../modules/2d. md)/McDbHatch
Class: McDbHatch
2d.McDbHatch
Representing pattern filling classes, achieving solid color filling and various pattern filling effects
Example
import { MxCADUiPrPoint, MxCADUtility, McDbHatch, MxCpp, McDb} from "mxcad"
//Select point filling
const getPoint = new MxCADUiPrPoint();
Console.log ("\ n Specify a point inside the filled area: ");
let pt = (await getPoint.go()) as McGePoint3d;
if (!pt) return;
let hatch:McDbHatch = MxCADUtility.builderHatchFromPoint(pt);
if (!hatch) {
Console.log ("Closed area not found \ n")
return;
}
//Clear the fill pattern effect
hatch.clearPatternDefinition();
//Add Pattern Fill Definition
hatch.addPatternDefinition(45, 1, 1, 1, 0.25, [45, 0.17677695, 0, 0, 0.25, 0.125, -0.0625])
//Set Fill Pattern
hatch.setPattern(McDb.HatchPatternType.kCustomDefined, 'test')
//Set Fill Color
hatch.trueColor = new McCmColor(0, 133, 122)
//Draw Fill Object
MxCpp.getCurrentMxCAD().drawEntity(hatch);
Hierarchy
↳
McDbHatch
Table of contents
Constructors
Properties
Accessors
- colorIndex
- drawOrder
- dxf0
- layer
- layerId
- linetype
- linetypeId
- linetypeScale
- lineweight
- normal
- numLoops
- numPatternDefinitions
- objectName
- patternAngle
- patternDouble
- patternScale
- patternSpace
- textStyle
- textStyleId
- trueColor
- visible
Methods
- IntersectWith
- addPatternDefinition
- appendCircleLoop
- appendLoop
- assertObjectModification
- clearPatternDefinition
- clone
- createExtensionDictionary
- deleteXData
- disableDisplay
- erase
- explode
- getAllAppName
- getArea
- getBoundingBox
- getDatabase
- getDatabaseIndexId
- getExtensionDictionary
- getGripPoints
- getHandle
- getImp
- getJson
- getLoopAt
- getObjectID
- getOwnerID
- getPatternDefinitionAt
- getxData
- getxDataDouble
- getxDataLong
- getxDataPoint
- getxDataString
- hatchStyle
- highlight
- initTempObject
- isErased
- isHaveExtensionDictionary
- isKindOf
- isNull
- isSolid
- loopTypeAt
- mirror
- move
- moveGripPointsAt
- patternName
- patternType
- removeAllLoop
- removeLoopAt
- rotate
- scaleEntity
- scalePattern
- setHatchStyle
- setJson
- setLoopAt
- setPattern
- setxData
- setxDataDouble
- setxDataLong
- setxDataPoint
- setxDataString
- syncData
- transformBy
- unErase
- updateDisplay
Constructors
constructor
• new McDbHatch(x?
)
Constructor.
Parameters
Name | Type |
---|---|
x? | object |
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch()
Overrides
Properties
imp
• imp: any
= 0
Internal implementation object.
Inherited from
Accessors
colorIndex
• get
colorIndex(): number
Obtain object color index
Returns
number
Example
import { McDbEntity, ColorIndexType } from 'mxcad'
const ent = new McDbEntity();
ent.colorIndex = ColorIndexType.kByblock;
console.log(ent.colorIndex)
Inherited from
McDbEntity.colorIndex
• set
colorIndex(val
): void
Set object color index
Parameters
Name | Type | Description |
---|---|---|
Val | number | ColorIndexType |
Returns
void
Inherited from
McDbEntity.colorIndex
drawOrder
• get
drawOrder(): number
Display order of objects
Returns
number
Example
//Assuming ent is a valid instance object
const order = ent.drawOrder();
Inherited from
McDbEntity.drawOrder
• set
drawOrder(order
): void
Display order of objects
Parameters
Name | Type | Description |
---|---|---|
Order | number | sequential value |
Returns
void
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;
}
})
Inherited from
McDbEntity.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
McDbEntity.dxf0
layer
• get
layer(): string
Obtain the layer name of the object
Returns
string
Inherited from
McDbEntity.layer
• set
layer(val
): void
Set object layer name
Parameters
Name | Type | Description |
---|---|---|
Val | string | Layer Name |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity();
ent.layer = "newLayerName";
console.log(ent.layer)
Inherited from
McDbEntity.layer
layerId
• get
layerId(): McObjectId
Get layer ID object
Returns
Example
//Assuming ent is a valid instance object
const layerId = ent.layerId;
Inherited from
McDbEntity.layerId
• set
layerId(id
): void
Set Layer Id Object
Parameters
Name | Type |
---|---|
id | McObjectId |
Returns
void
Example
//Assuming ent is a valid instance object
const mxcad = MxCpp.getCurrentMxCAD();
Const layerId=mxcad. addLayer (Test Layer)
ent.layerId = layerId;
Inherited from
McDbEntity.layerId
linetype
• get
linetype(): string
Obtain the object line type name
Returns
string
Inherited from
McDbEntity.linetype
• set
linetype(val
): void
Set object line type name
Parameters
Name | Type | Description |
---|---|---|
Val | string | Line type name |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.linetype = "MyLineType";
console.log(ent.linetype)
Inherited from
McDbEntity.linetype
linetypeId
• get
linetypeId(): McObjectId
Get entity object line type ID
Returns
Example
//Assuming ent is a valid instance object
const linetypeId = ent.linetypeId;
Inherited from
McDbEntity.linetypeId
• set
linetypeId(id
): void
Set entity object line type ID
Parameters
Name | Type |
---|---|
id | McObjectId |
Returns
void
Example
//Assuming ent is a valid instance object
const mxcad = MxCpp.getCurrentMxCAD();
const lineId = mxcad.addLinetypeEx("TestMyLine", '25,-5');
ent.linetypeId = lineId;
Inherited from
McDbEntity.linetypeId
linetypeScale
• get
linetypeScale(): number
Obtain the proportion of object line types
Returns
number
Inherited from
McDbEntity.linetypeScale
• set
linetypeScale(val
): void
Set object line type scale
Parameters
Name | Type | Description |
---|---|---|
Val | number | Line type ratio |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.linetypeScale = 0.8;
console.log(ent.linetypeScale)
Inherited from
McDbEntity.linetypeScale
lineweight
• get
lineweight(): number
Obtain object line weight
Returns
number
Inherited from
McDbEntity.lineweight
• set
lineweight(val
): void
Set object line weight
Parameters
Name | Type | Description |
---|---|---|
Val | number | line weight |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.lineweight = 20;
console.log(ent.lineweight)
Inherited from
McDbEntity.lineweight
normal
• get
normal(): McGeVector3d
Return the normal of the object
Returns
Example
Inherited from
McDbEntity.normal
• set
normal(val
): void
Set the normal of the object
Parameters
Name | Type |
---|---|
val | McGeVector3d |
Returns
void
Example
Inherited from
McDbEntity.normal
numLoops
• get
numLoops(): number
Number of closed areas
Returns
number
Example
//Hatch is an instance object for pattern filling
const num = hatch.numLoops
numPatternDefinitions
• get
numPatternDefinitions(): number
The number of pattern definitions
Returns
number
Example
//Hatch is an instance object for pattern filling
const num = hatch.numPatternDefinitions;
objectName
• get
objectName(): string
Get the object name.
Returns
string
Return object name
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
console.log(obj.objectName);
Inherited from
McDbEntity.objectName
patternAngle
• get
patternAngle(): number
Obtain the angle of the fill pattern
Returns
number
Example
//Hatch is an instance object for pattern filling
const angle = hatch.patternAngle
• set
patternAngle(angle
): void
Set the angle of the fill pattern
Parameters
Name | Type |
---|---|
angle | number |
Returns
void
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch();
hatch.patternAngle(Math.PI/4);
patternDouble
• get
patternDouble(): boolean
Obtain whether the fill pattern is double
Returns
boolean
Example
//Hatch is an instance object for pattern filling
const isDouble = hatch.patternDouble;
if(isDouble){
//Double the filling pattern
}else{
//The filling pattern is not double
}
• set
patternDouble(isDouble
): void
Set the fill pattern to double
Parameters
Name | Type |
---|---|
isDouble | boolean |
Returns
void
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch();
hatch.patternDouble = true;
patternScale
• get
patternScale(): number
Get the scaling ratio of the fill pattern
Returns
number
Example
//Hatch is an instance object for pattern filling
const scale = hatch.patternScale
• set
patternScale(scale
): void
Set the scaling ratio of the fill pattern
Parameters
Name | Type |
---|---|
scale | number |
Returns
void
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch();
hatch.patternScale = 0.8;
patternSpace
• get
patternSpace(): number
Obtain the space for filling patterns
Returns
number
Example
//Hatch is an instance object for pattern filling
const patternSpace = hatch.patternSpace
• set
patternSpace(space
): void
Set the space for filling patterns
Parameters
Name | Type |
---|---|
space | number |
Returns
void
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch();
hatch.patternSpace = 0.8;
textStyle
• get
textStyle(): string
Obtain the text style of the object
Returns
string
Inherited from
McDbEntity.textStyle
• set
textStyle(val
): void
Set object text style
Parameters
Name | Type | Description |
---|---|---|
Val | string | Text style name |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.textStyle = "st_style";
Inherited from
McDbEntity.textStyle
textStyleId
• get
textStyleId(): McObjectId
Get entity text style
Returns
Example
//Assuming ent is a valid instance object
const textStyleId = ent.textStyleId;
Inherited from
McDbEntity.textStyleId
• set
textStyleId(id
): void
Set the text style of the entity
Parameters
Name | Type |
---|---|
id | McObjectId |
Returns
void
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;
Inherited from
McDbEntity.textStyleId
trueColor
• get
trueColor(): McCmColor
Obtain the color of the object
Returns
Example
import { McDbEntity, McCmColor} from 'mxcad'
const ent = new McDbEntity();
ent.trueColor = new McCmColor(255, 0, 0);
console.log(ent.trueColor)
Inherited from
McDbEntity.trueColor
• set
trueColor(val
): void
Set object color
Parameters
Name | Type |
---|---|
val | McCmColor |
Returns
void
Inherited from
McDbEntity.trueColor
visible
• get
visible(): boolean
Is the object visible
Returns
boolean
Inherited from
McDbEntity.visible
• set
visible(val
): void
Set whether it is visible
Parameters
Name | Type | Description |
---|---|---|
Val | boolean | Boolean value |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.visible = true;
console.log(ent.visible)
Inherited from
McDbEntity.visible
Methods
IntersectWith
▸ IntersectWith(intersectObject
, exOption
): McGePoint3dArray
Intersection with other entities to obtain the intersection point
Parameters
Name | Type | Description |
---|---|---|
IntersectObject | [McDbEntity] (2d. McDbEntity. md) | The entity object that needs to intersect is the entity object |
ExOption | Intersection (../enums/2d. McDb. Intersect. md) | Intersection options |
Returns
Obtain all intersection points
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)
Inherited from
addPatternDefinition
▸ addPatternDefinition(angle
, baseX
, baseY
, offsetX
, offsetY
, dashes
): boolean
Add pattern definition
Parameters
Name | Type | Description |
---|---|---|
Angle | number | angle such as 45 |
BaseX | number | Base point x coordinate |
BaseY | number | base point y coordinate |
Offset X | number | offset x coordinate |
Offset Y | number | offset y coordinate |
Dashes | number [] | dash data |
Returns
boolean
Did you successfully add the pattern definition
Example
import { McDbHatch } from "mxcad"
const hatch = new McDbHatch()
const res = hatch.addPatternDefinition(45, 0, 0, 0, 0.25, [45, 0.17677695, 0, 0, 0.25, 0.125, -0.0625]);
if(res){
//Added successfully
}else{
//Add failed
}
appendCircleLoop
▸ appendCircleLoop(dCenX
, dCenY
, dR
, dPrecision?
, loopType?
): any
Add a closed area for circle construction
Parameters
Name | Type | Default value | Description |
---|---|---|---|
DCenX | number | undefined | X-axis coordinate of the center of the circle |
DCenY | number | undefined | Y-axis coordinate of the center of the circle |
DR | number | undefined | radius of circle |
DPrecision | number | 0 | Precision parameter, default value is 0 |
loopType | number | McDb. HatchLoopType. kPolyline | Loop type parameter, default value is McDb HatchLoopType.kPolyline |
Returns
any
Additional Results
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch();
const res = hatch.appendCircleLoop(0,0,0,20);
if(res){
//Added successfully
}else{
//Addition failed
}
appendLoop
▸ appendLoop(vertices
, bulges?
, loopType?
): boolean
Add closed area
Parameters
Name | Type | Default value | Description |
---|---|---|---|
Vertices | [McGePoint3dArray] (2d. McGePoint3dArray. md) | undefined | Coordinate set |
Bulges | number [] | convexity set | |
loopType | number | `McDb. HatchLoopType.kPolyline | Closed Area Type |
Returns
boolean
Return additional results
Example
import { McDbHatch, McGePoint3d, McGePoint3dArray } from "mxcad";
let solid = new McDbHatch();
const pts = [
new McGePoint3d({ x: 10, y: 20, z: 0 }),
new McGePoint3d({ x: 0, y: 0, z: 0 }),
];
const res = solid.appendLoop(new McGePoint3dArray(pts));
if(res){
//Setting successful
}else{
//Setting failed
}
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.
Parameters
Name | Type | Default value |
---|---|---|
autoUndo | boolean | false |
Returns
number
Example
//Assuming obj is a database object
obj.assertObjectModification()
Inherited from
McDbEntity.assertObjectModification
clearPatternDefinition
▸ clearPatternDefinition(): boolean
Clear pattern definition
Returns
boolean
Example
//Hatch is an instance object for pattern filling
const res = hatch.clearPatternDefinition();
if(res){
//Cleared successfully
}else{
//Clearing failed
}
clone
▸ clone(): null
| McDbObject
Clone objects.
Returns
null
| McDbObject
The cloned object.
Example
//Assuming obj is a database object
const obj_clone = obj.clone();
Inherited from
createExtensionDictionary
▸ createExtensionDictionary(): boolean
Create extended dictionary data for objects
Returns
boolean
Example
//Assuming obj is a database object
const res = obj.createExtensionDictionary();
Inherited from
McDbEntity.createExtensionDictionary
deleteXData
▸ deleteXData(appName
): boolean
Delete data related to entity specified application name
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Returns
boolean
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
}
Inherited from
disableDisplay
▸ disableDisplay(isDisable
): void
Disable automatic update display of objects
Parameters
Name | Type | Description |
---|---|---|
IsDisable | boolean | Do you want to disable automatic object update display |
Returns
void
Example
import { McDbLine } from 'mxcad'
const line1 = new McDbLine(new McGePoint3d(0,0,0), new McGePoint3d(20,1,0));
line1.disableDisplay(true)
Inherited from
erase
▸ erase(): boolean
Delete object.
Returns
boolean
Whether the deletion was successful.
Example
//Assuming obj is a database object
const res = obj.erase();
console.log(res);
Inherited from
explode
▸ explode(): MxCADResbuf
Break the object and return the linked list of the object's data after being broken
Returns
Rebuf data
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);
}
}
Inherited from
getAllAppName
▸ getAllAppName(): McGeStringArray
Get the application name (AppName) of all XData records contained in the entity
Returns
Example
//Assuming ent is a valid instance object
const appNames = ent.getAllAppName();
console.log(appNames);
Inherited from
getArea
▸ getArea(): Object
Calculate Area
Returns
Object
Is the val area value | ret successfully obtained
Name | Type |
---|---|
ret | boolean |
val | number |
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)
Inherited from
getBoundingBox
▸ getBoundingBox(): Object
Obtain the minimum outsourcing of the object
Returns
Object
Name | Type |
---|---|
maxPt | McGePoint3d |
minPt | McGePoint3d |
ret | boolean |
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()
Inherited from
getDatabase
▸ getDatabase(): McDbDatabase
Get the database where the object is located
Returns
Return to database
Example
//Assuming obj is a database object
const data = obj.getDatabase();
Inherited from
getDatabaseIndexId
▸ getDatabaseIndexId(): number
Get the index ID of the object
Returns
number
Example
//Assuming obj is a database object
const id = obj.getDatabaseIndexId();
Inherited from
getExtensionDictionary
▸ getExtensionDictionary(): McDbDictionary
Obtain the extended dictionary data of the object
Returns
Expand dictionary data
Example
//Assuming obj is a database object
const id = obj.getOwnerID();
Inherited from
McDbEntity.getExtensionDictionary
getGripPoints
▸ getGripPoints(): McGePoint3dArray
Get the control points of the object
Returns
Example
//Assuming obj is a database object
const ptArr = obj.getGripPoints();
Inherited from
getHandle
▸ getHandle(): string
Obtain object handle
Returns
string
Return object handle
Example
//Assuming obj is a database object
const handle = obj.getHandle();
Inherited from
getImp
▸ getImp(): any
Retrieve internal implementation objects.
Returns
any
Internal implementation object.
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
let imp = obj.getImp();
Inherited from
getJson
▸ getJson(): string
Retrieve a string in JSON format.
Returns
string
A string in JSON format.
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
const json = obj.getJson()
Inherited from
getLoopAt
▸ getLoopAt(loopIndex
): Object
Retrieve the value of the index
Parameters
Name | Type | Description |
---|---|---|
LoopIndex | number | index of closed area |
Returns
Object
Whether ret successfully obtained | lootype type | verticals coordinate set | bulges convexity set
Name | Type |
---|---|
bulges | number [] |
lootype | number |
ret | boolean |
vertices | McGePoint3d [] |
Example
//Hatch is an instance object for pattern filling
const numLoops = hatch.numLoops;
for (let i = 0; i < numLoops; i++) {
const loop = hatch.getLoopAt(i);
console.log(loop)
};
getObjectID
▸ getObjectID(): McObjectId
Get the object ID.
Returns
Object ID.
Example
import { McDbObject } from "mxcad";
const id = obj.getObjectID();
Inherited from
getOwnerID
▸ getOwnerID(): number
Obtain the ID of the object owner
Returns
number
Example
//Assuming obj is a database object
const id = obj.getOwnerID();
Inherited from
getPatternDefinitionAt
▸ getPatternDefinitionAt(index
): Object
Obtain data corresponding to the pattern definition
Parameters
Name | Type | Description |
---|---|---|
Index | number | index |
Returns
Object
Whether ret successfully obtained | angle | baseX, BaseY base point position | offsetX, OffsetY offset position | aryDashes dash data
Name | Type |
---|---|
angle | number |
aryDashes | number [] |
baseX | number |
baseY | number |
offsetX | number |
offsetY | number |
ret | boolean |
Example
//Hatch is an instance object for pattern filling
const obj = {};
for (let i = 0; i < obj.numPatternDefinitions; i++) {
obj["patternDefinitions:" + i] = hatch.getPatternDefinitionAt(i);
};
getxData
▸ getxData(appName?
): MxCADResbuf
Obtain the extended data of the object
Parameters
Name | Type | Default value | Description |
---|---|---|---|
AppName | string | "" | Extended Data Name |
Returns
Example
//Assuming ent is a valid instance object
const xData = ent.getXData();
Inherited from
getxDataDouble
▸ getxDataDouble(appName
): Object
Retrieve the double value from the specified XData type of the entity
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Returns
Object
Double value
Name | Type |
---|---|
ret | boolean |
val | number |
Example
//Assuming ent is a valid instance object
let data = ent.getxDataDouble("DataName");
if(data.ret){
console.log(data.val)
}
Inherited from
getxDataLong
▸ getxDataLong(appName
): Object
Retrieve the long (integer) value from the specified XData type of the entity
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Returns
Object
Long value
Name | Type |
---|---|
ret | boolean |
val | number |
Example
//Assuming ent is a valid instance object
let data = ent.getxDataLong("DataName");
if(data.ret){
console.log(data.val)
}
Inherited from
getxDataPoint
▸ getxDataPoint(appName
): Object
Retrieve point objects from the specified XData type of entity
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Returns
Object
Obtain results and 3D point objects
Name | Type |
---|---|
ret | boolean |
val | McGePoint3d |
Inherited from
getxDataString
▸ getxDataString(appName
): Object
Retrieve XData information associated with a specific entity and return it in string form
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Returns
Object
Val XData information | whether ret returns success
Name | Type |
---|---|
ret | boolean |
val | string |
Example
//Assuming ent is a valid instance object
let data = ent.getxDataString("DataName");
if(data.ret){
console.log(data.val)
}
Inherited from
hatchStyle
▸ hatchStyle(): HatchStyle
Fill style
Returns
Example
//Hatch is an instance object for pattern filling
const style = hatch.hatchStyle();
highlight
▸ highlight(isHighlight
): void
Set whether the object is highlighted
Parameters
Name | Type | Description |
---|---|---|
IsHighlight | boolean | Is it highlighted |
Returns
void
Example
import { McDbEntity } from 'mxcad'
const ent = new McDbEntity()
ent.highlight(true);
Inherited from
initTempObject
▸ initTempObject(imp
): void
Initialize temporary objects.
Parameters
Name | Type | Description |
---|---|---|
'imp' | 'any' | Internal implementation object |
Returns
void
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
obj.initTempObject()
Inherited from
isErased
▸ isErased(): boolean
Has the object been deleted
Returns
boolean
Example
//Assuming obj is a database object
const res = obj.isErased();
console.log(res);
Inherited from
isHaveExtensionDictionary
▸ isHaveExtensionDictionary(): boolean
Is there any extended dictionary data available
Returns
boolean
Example
//Assuming obj is a database object
const res = obj.isHaveExtensionDictionary();
Inherited from
McDbEntity.isHaveExtensionDictionary
isKindOf
▸ isKindOf(sObjectName
): boolean
Determine object type
Parameters
Name | Type | Description |
---|---|---|
SOrtName | string | Type Name |
Returns
boolean
Return whether the object is of the target type
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
let isKind = obj.isKindOf('SomeObjectType');
console.log(isKind); // Output: True or false
Inherited from
isNull
▸ isNull(): any
Determine if it is an empty object
Returns
any
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
console.log(obj.isNull()); // Output: True or false
Inherited from
isSolid
▸ isSolid(): boolean
Check if the filled object is solid filled
Returns
boolean
Boolean value
Example
//Hatch is an instance object for pattern filling
const res = hatch.isSolid();
if(res){
//Entity filling
}else{
//Non entity filling
}
loopTypeAt
▸ loopTypeAt(loopIndex
): number
Types in a closed area index
Parameters
Name | Type |
---|---|
loopIndex | number |
Returns
number
Example
//Hatch is an instance object for pattern filling
const looptType = hatch.loopTypeAt(0)
mirror
▸ mirror(point1
, point2
): boolean
Mirror oriented object
Parameters
Name | Type | Description |
---|---|---|
Point1 | [McGePoint3d] (2d. McGePoint3d. md) | Mirror Base Point |
point2 | McGePoint3d | - |
Returns
boolean
Example
import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.mirror(new McGePoint3d(0,0,0), new McGePoint3d(20,10,0))
Inherited from
move
▸ move(fromPoint
, toPoint
): boolean
move objects
Parameters
Name | Type | Description |
---|---|---|
From Point | [McGePoint3d] (2d. McGePoint3d. md) | Move the starting point |
ToPoint | [McGePoint3d] (2d. McGePoint3d. md) | Move End Point |
Returns
boolean
Example
import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.move(new McGePoint3d(0,0,0), new McGePoint3d(20,0,0))
Inherited from
moveGripPointsAt
▸ moveGripPointsAt(iIndex
, dXOffset
, dYOffset
, dZOffset
): any
Control points for moving objects
Parameters
Name | Type | Description |
---|---|---|
IIndex | Number | Index |
DXOffset | number | X-axis offset |
DYOffset | number | Y-axis offset |
DZOffset | number | Z-axis offset |
Returns
any
Example
//Assuming obj is a database object
obj.moveGripPointsAt(1,10,10,10);
Inherited from
patternName
▸ patternName(): string
Fill pattern name
Returns
string
Example
//Hatch is an instance object for pattern filling
const patternName = hatch.patternName()
patternType
▸ patternType(): number
Fill pattern type
Returns
number
Example
//Hatch is an instance object for pattern filling
const type = hatch.patternType()
removeAllLoop
▸ removeAllLoop(): boolean
Delete all closed areas
Returns
boolean
Example
//Hatch is an instance object for pattern filling
const res = hatch.removeAllLoop();
if(res){
//Delete successfully
}else{
//Delete failed
}
removeLoopAt
▸ removeLoopAt(loopIndex
): boolean
Delete a closed region under a certain index
Parameters
Name | Type | Description |
---|---|---|
LoopIndex | number | Index of removed loops |
Returns
boolean
Example
//Hatch is an instance object for pattern filling
const res = hatch.removeLoopAt(1);
if(res){
//Delete successfully
}else{
//Delete failed
}
rotate
▸ rotate(basePoint
, dRotationAngle
): boolean
Rotate object
Parameters
Name | Type | Description |
---|---|---|
BasePoint | [McGePoint3d] (2d. McGePoint3d. md) | Rotate the base point |
DRotationAngle | number | Rotation angle |
Returns
boolean
Example
import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.rotate(new McGePoint3d(0,0,0), Math.PI)
Inherited from
scaleEntity
▸ scaleEntity(basePoint
, dScaleFactor
): boolean
Scaling objects
Parameters
Name | Type | Description |
---|---|---|
BasePoint | [McGePoint3d] (2d. McGePoint3d. md) | Scale Base Point |
DScaleFactor | number | scaling factor (<1 zoom out;>1 zoom in) |
Returns
boolean
Example
import { McDbEntity, McGePoint3d } from 'mxcad'
const ent = new McDbEntity()
ent.scaleEntity(new McGePoint3d(0,0,0), 0.5)
Inherited from
scalePattern
▸ scalePattern(scale
): boolean
Scale the currently defined fill pattern data.
Parameters
Name | Type |
---|---|
scale | number |
Returns
boolean
setHatchStyle
▸ setHatchStyle(val
): void
Set fill style
Parameters
Name | Type |
---|---|
val | HatchStyle |
Returns
void
Example
import { McDbHatch, McDb } from "mxcad"
McDbHatch.setHatchStyle(McDb.HatchStyle.kNormal)
setJson
▸ setJson(str
): boolean
Set a string in JSON format.
Parameters
Name | Type | Description |
---|---|---|
Str | string | JSON formatted string |
Returns
boolean
Is the setting successful.
Example
import { McRxObject } from 'mxcad';
let obj = new McRxObject();
const res = obj.setJson('{"key": "value"}');
console.log(res)
Inherited from
setLoopAt
▸ setLoopAt(loopIndex
, vertices
, bulges
, loopType?
): boolean
Set closed area data under a certain index
Parameters
Name | Type | Default value | Description |
---|---|---|---|
LoopIndex | number | undefined | Closed area index |
Vertices | [McGePoint3dArray] (2d. McGePoint3dArray. md) | undefined | Coordinate set |
Bulges | number [] | undefined | convexity set |
loopType | number | `McDb. HatchLoopType.kPolyline | Closed Area Type |
Returns
boolean
Example
import { McDbHatch } from "mxcad";
const hatch = new McDbHatch();
const pts = [
new McGePoint3d({ x: 10, y: 20, z: 0 }),
new McGePoint3d({ x: 0, y: 0, z: 0 }),
];
const isSuccess = hatch.setLoopAt(0, new McGePoint3dArray(pts), [0.4,0.8]);
if (isSuccess) {
Console.log ("Loop setting successful! ");
} else {
Console.log ("Loop setting failed ");
}
setPattern
▸ setPattern(type
, patName
): void
Set Fill Pattern
Parameters
Name | Type | Description |
---|---|---|
Type | Number | Source type of fill pattern |
PatName | string | Fill pattern name |
Returns
void
Example
import { McDbHatch, MxCpp } from "mxcad";
const hatch = new McDbHatch();
hatch.setPattern(McDb.HatchPatternType.kCustomDefined, 'test')
let mxcad = MxCpp.getCurrentMxCAD();
mxcad.drawEntity(hatch);
setxData
▸ setxData(xdata
): boolean
Set extended data for objects
Parameters
Name | Type | Description |
---|---|---|
Xdata | [MxCADResbuf] (2d. MxCADResbuf. md) | Extended data linked list |
Returns
boolean
Example
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"}]));
Inherited from
setxDataDouble
▸ setxDataDouble(appName
, val
): boolean
Set the double value in the specified XData type of the entity
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Val | number | double value |
Returns
boolean
Boolean value
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
}
Inherited from
setxDataLong
▸ setxDataLong(appName
, val
): boolean
Set the long (integer) value in the specified XData type of the entity
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Val | number | long value |
Returns
boolean
Long value
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
}
Inherited from
setxDataPoint
▸ setxDataPoint(appName
, val
): boolean
Set the point object in the specified XData type of the entity
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Val | [McGePoint3d] (2d. McGePoint3d. md) | Point Object |
Returns
boolean
Obtain results and 3D point objects
Inherited from
setxDataString
▸ setxDataString(appName
, val
): boolean
Set XData information associated with a specific entity and set it in string form
Parameters
Name | Type | Description |
---|---|---|
AppName | string | Extended Data Name |
Val | string | string value |
Returns
boolean
Is the setting successful
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
}
Inherited from
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.
Parameters
Name | Type | Default value | Description |
---|---|---|---|
_toCpp | boolean | true | Whether to synchronize data |
Returns
boolean
Example
//Assuming ent is a valid instance object
const res = ent.syncData(true);
if(res){
//Synchronization successful
}else{
//Synchronization failed
}
Inherited from
transformBy
▸ transformBy(transformationMatrix
): boolean
Transform object
Parameters
Name | Type | Description |
---|---|---|
TransformationMatrix | [McGeMatrix3d] (2d. McGeMatrix3d. md) | Transformation Matrix |
Returns
boolean
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);
Inherited from
unErase
▸ unErase(): boolean
Anti delete object.
Returns
boolean
Example
//Assuming obj is a database object
const res = obj.unErase();
console.log(res);
Inherited from
updateDisplay
▸ updateDisplay(): void
Display the updated display of the calling object
Returns
void
Example
//Assuming ent is a valid instance object
ent.updateDisplay()