WebCAD-Lib-TS API 文档 - v1.0.0
    Preparing search index...

    Class MeshEnt

    Unified 3D mesh entity. Represents triangulated mesh data from AcDb3dSolid, AcDbRegion, AcDbSurface, AcDbPolyFaceMesh, AcDbPolygonMesh, AcDbFace. Stores full 3D vertex data for future 3D plugin support.

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    type objectId id _lineType _isAlive isDirty block?

    Accessors

    handle entityType color layerId lineTypeScale lineWeight transpMgr isAlive visible xdataRaw extData extDataAppName doc layer lineType sourceType vertexCount triangleCount vertices indices subGeometries

    Methods

    setExtData clearExtData hasExtData fromDefaultProps setDefaults fromDbDefaultProps mapToDbDefaultProps dispose getProjectedEdges setModified fromDb toDb boundingBox allPointsWithInBox getPoints move rotate scale mirror stretch gripEdit clone

    Constructors

    Properties

    type: string

    实体类型标识符（如"LINE"、"CIRCLE"等）

    objectId: string

    DWG对象ID（句柄）- 从DWG文件导入时的唯一标识符 这个值不应该在克隆时复制，新创建的实体应该为空字符串

    id: number

    实体索引ID - 从1开始递增的唯一索引 用于在WebCAD格式中标识实体

    _lineType

    _lineType: string

    _isAlive

    _isAlive: boolean
    isDirty: boolean

    是否处于脏状态，供渲染器增量更新

    block?: any

    Accessors

    • get handle(): string

      DWG句柄别名（兼容性）

      Returns string

      objectId

    • get entityType(): string

      实体类型别名（兼容性）

      Returns string

      type

    • get color(): number

      获取颜色索引

      Returns number

      颜色索引值（256表示"随图层"颜色）

    • set color(value: number): void

      设置颜色索引

      Parameters

      • value: number

        颜色索引值（256表示"随图层"颜色）

      Returns void

    • get layerId(): string

      获取图层ID

      Returns string

      图层ID字符串

    • set layerId(value: string): void

      设置图层ID

      Parameters

      • value: string

        图层ID字符串

      Returns void

    • get lineTypeScale(): number

      获取线型比例

      Returns number

      线型比例因子

    • set lineTypeScale(value: number): void

      设置线型比例

      Parameters

      • value: number

        线型比例因子

      Returns void

    • get lineWeight(): number

      获取线宽

      Returns number

      线宽值（-1=ByLayer, -2=ByBlock, >=0为具体值，单位为0.01mm）

    • set lineWeight(value: number): void

      设置线宽

      Parameters

      • value: number

        线宽值（-1=ByLayer, -2=ByBlock, >=0为具体值）

      Returns void

    • get transpMgr(): TransparencyManager

      获取透明度管理器

      Returns TransparencyManager

      透明度管理器实例

    • set transpMgr(value: TransparencyManager): void

      设置透明度管理器

      Parameters

      Returns void

    • get isAlive(): boolean

      获取实体存活状态

      Returns boolean

      是否存活（true表示有效，false表示已删除）

    • set isAlive(value: boolean): void

      设置实体存活状态

      Parameters

      • value: boolean

        是否存活

      Returns void

    • get visible(): boolean

      DXF Group Code 60 entity visibility. true = visible (default), false = invisible.

      Returns boolean

    • set visible(value: boolean): void

      Parameters

      • value: boolean

      Returns void

    • get xdataRaw(): Record<string, string>

      获取原始扩展数据（用于序列化） 格式: { "1001": "AppName", "1000": "JSON字符串" }

      Returns Record<string, string>

      原始xdata对象或undefined

    • set xdataRaw(value: Record<string, string>): void

      设置原始扩展数据（从数据库加载时使用）

      Parameters

      • value: Record<string, string>

        原始xdata对象

      Returns void

    • get extData(): Record<string, any>

      获取扩展数据（用户友好格式） 自动解析JSON字符串返回对象

      Returns Record<string, any>

      解析后的扩展数据对象，或undefined

      const data = entity.extData;
      console.log(data?.sensorVal); // 10
    • get extDataAppName(): string

      获取扩展数据的应用程序名（AppName）

      Returns string

      AppName字符串，或undefined

    • get doc(): any

      获取所属文档

      通过实体所在的块来获取文档对象。在CAD系统中， 实体总是属于某个块，而块又属于某个文档。

      Returns any

      文档对象，如果无法获取则返回undefined

    • get layer(): string

      获取图层名称

      根据实体的layerId从文档的图层集合中查找对应的图层名称。 如果找不到对应的图层，则返回默认图层"0"。

      Returns string

      图层名称，默认为"0"

    • set layer(layerName: string): void

      设置图层名称

      根据图层名称查找对应的图层ID并设置给实体。 如果找不到指定的图层，则使用默认图层ID（"0"）。

      注意：优先使用实体所属文档的图层列表，如果实体尚未添加到文档， 则使用 Engine.currentDoc 的图层列表。

      Parameters

      • layerName: string

        图层名称

      Returns void

    • get lineType(): string

      获取线型

      返回实体当前的线型设置。线型控制线条的显示样式 （如实线、虚线、点划线等）。

      Returns string

      线型名称

    • set lineType(lineTypeName: string): void

      设置线型

      设置实体的线型，支持标准CAD线型、常见别名和自定义线型。 输入的线型名称会被转换为大写进行匹配。

      支持的线型：

      • CONTINUOUS: 连续线（实线）
      • HIDDEN/DASHED: 虚线（虚线）
      • CENTER: 中心线
      • PHANTOM: 幻影线
      • DOT: 点线（映射为虚线）
      • 自定义线型：通过LinetypeManager管理的线型

      Parameters

      • lineTypeName: string

        线型名称

      Returns void

    • get sourceType(): string

      Returns string

    • get vertexCount(): number

      Returns number

    • get triangleCount(): number

      Returns number

    • get vertices(): Float64Array

      Returns Float64Array

    • get indices(): Uint32Array

      Returns Uint32Array

    • get subGeometries(): GLine[]

      Returns GLine[]

    Methods

    • 设置扩展数据（用户友好格式） 自动将对象序列化为JSON字符串存储

      Parameters

      • appName: string

        应用程序名（用于在DWG中标识数据来源）

      • data: Record<string, any>

        要存储的数据对象（将被序列化为JSON）

      Returns void

      entity.setExtData("MY_SENSOR", {
        sensorVal: 10,
        deviceName: "温度传感器",
        isActive: true
      });

    • 清除扩展数据

      Returns void

    • 检查是否有扩展数据

      Returns boolean

      是否存在扩展数据

    • 从默认属性对象复制属性

      将指定的默认属性对象的所有相关属性复制到当前实体。 这通常用于创建新实体时应用默认设置。

      Parameters

      • defaultPropsObject: any

        默认属性对象，包含layer、colorIndex、lineType等属性

      Returns this

      当前实例（支持链式调用）

    • 设置为系统默认值

      从全局CAD系统设置中获取当前的默认属性值并应用到实体。 这些默认值包括当前图层、当前颜色、当前线型等。

      使用的全局变量：

      • Engine.currentDoc.CLAYER: 当前图层名称
      • Engine.CECOLOR: 当前实体颜色
      • Engine.CELTYPE: 当前实体线型
      • Engine.CELTSCALE: 当前实体线型比例

      Returns void

    • 从数据库默认属性对象设置属性

      从数据库查询结果或序列化数据中恢复实体属性。 这个方法处理数据库中可能存在的空值和默认值情况。

      Parameters

      • dbPropsObject: any

        数据库属性对象，包含layerId、colorIndex等属性

      Returns this

      当前实例（支持链式调用）

    • 将属性映射到数据库默认属性对象

      将当前实体的属性映射到数据库存储格式的对象中。 用于保存实体数据到数据库或序列化。

      Parameters

      • targetDbObject: any

        目标数据库属性对象

      Returns any

      映射后的属性对象

    • 释放实体占用的外部资源 子类如持有 PIXI 对象或大尺寸缓冲，应覆盖此方法清理

      Returns void

    • Projected visible edges for 2D rendering and hit-testing. Lazily computed and cached; cleared on setModified().

      Returns GLine[]

    • 通知渲染系统此实体已被修改。 在桶渲染模式下，这将标记对应的桶为"脏"，以便在下次 regenPartial 时重绘。 注意：此方法只标记，不触发重绘。调用方需要在适当的时候（如命令结束时）调用 regenPartial()。

      Returns void

    • Parameters

      Returns void

    • Returns DbMesh

    • Parameters

      Returns boolean

    • Returns Point2D[]

    • Move this entity by the vector from fromPoint to toPoint. Subclasses override with geometry-specific translation logic.

      Parameters

      Returns void

    • Parameters

      Returns void

    • Parameters

      Returns void

    • 镜像变换（基类默认实现为空，子类应重写）

      Parameters

      • mirrorAxisStart: PointInput

        镜像轴起点，支持 Point2D 或数组 [x, y]

      • mirrorAxisEnd: PointInput

        镜像轴终点，支持 Point2D 或数组 [x, y]

      Returns void

    • Parameters

      • newPosition: Point2D
      • gripName: string

      Returns void

    • Clone this entity. Subclasses override to produce a typed deep copy. The base implementation creates a shallow copy with common properties.

      Returns MeshEnt

      A new EntityBase (or subclass) instance

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods