Class InstancedMeshEntity

实例化mesh实体

Hierarchy (view full)

Constructors

constructor

Properties

_app? _bloomRef _boxHelperObject _boxHelperRef _childrens _destroyed _isDisposed? _matrixRef _matrixWorldRef _node _outlineRef _ownerScene? _pointerEventsRef _positionRef _quaternionRef _rayIntersectRecursive? _rayQueryType? _rotationRef _scaleRef _sceneData? _selectedRef _visualRef addInstance clearInstanceBloom clearInstanceHighlight clearInstanceOutline clearInstanceSelected data entityType extData getGroup getIdByIndex getIndexById getInstanceAttr getInstanceBox3 getInstancedMeshList instanceId isEntity isInstanceBloom isInstanceHighlight isInstanceOutline isInstanceSelected moduleManager onSetApp options rayIntersectObject? removeInstance setInstance setInstanceAttr setInstanceBloom setInstanceHighlight setInstanceOutline setInstanceSelected signal uuid defaultModules

Accessors

app bloom bloomRef boxHelper boxHelperRef castShadow childrens destroyed frustumCulled isDisposed matrix matrixWorld modules node outline outlineRef parent pointerEvents pointerEventsRef position quaternion rayIntersectRecursive rayQueryType receiveShadow rotation scale selected selectedRef uiConfig visible visibleRef

Methods

add addAction addChildEntity addDispose addEdges addModule addObjects addTo applyMixinsTo callModules clearEdges clearHighlight destroy dispatch effectScope eventNames getBoundingBox getEntitiesByModule getEntitiesByName getEntitiesByProperty getEntityById getEntityByName getEntityByProperty getEntityByUuid getLeafEntities getMeshEntities getMeshEntityById getMeshEntityByName getMeshEntityByProperty getMeshEntityByUuid getModule getObjectById getObjectByName getObjectByProperty getObjectByUuid getObjectPropertyValueCount getObjectsByName getObjectsByProperty getPointerEventsEntities hasEvent isFireEventsByIntersect isHighlight isLikeMeshEntity listenerCount off on onEntityAwake once remove removeAction removeAllEventListeners removeAllModules removeChildEntity removeDispose removeModule removeObjects replaceMaterial resetMaterial setHighlight setOpacity setupUiConfig toJSON traverse traverseVisible tween attchObject create fromJSON fromModule fromObject3d fromObjectModule getOwerEntity

Constructors

constructor

Properties

Optional _app

_app?: App

_bloomRef

_bloomRef: Ref<boolean>

是否辉光

_boxHelperObject

_boxHelperObject: BoxHelper

_boxHelperRef

_boxHelperRef: Ref<boolean>

是否显示包围盒

_childrens

_childrens: Entity[] = []

Protected _destroyed

_destroyed: boolean = false

Optional _isDisposed

_isDisposed?: boolean

是否已销毁

_matrixRef

_matrixRef: Matrix4

本地矩阵响应式对象

_matrixWorldRef

_matrixWorldRef: Matrix4

世界矩阵响应式对象

_node

_node: Object3D<Object3DEventMap>

_outlineRef

_outlineRef: Ref<boolean>

是否描边效果

Optional _ownerScene

_ownerScene?: Scene

_pointerEventsRef

_pointerEventsRef: Ref<boolean>

_positionRef

_positionRef: Vector3

位置响应式对象

_quaternionRef

_quaternionRef: Quaternion

四元数响应式对象

Optional _rayIntersectRecursive

_rayIntersectRecursive?: boolean

拾取时是否遍历子对象 默认为true

Optional _rayQueryType

_rayQueryType?: RayQueryType

射线查询类型 默认为1

_rotationRef

_rotationRef: Euler

旋转响应式对象

_scaleRef

_scaleRef: Vector3

缩放响应式对象

Optional _sceneData

_sceneData?: Record<string, any> = {}

_selectedRef

_selectedRef: Ref<boolean>

是否选中

_visualRef

_visualRef: Ref<boolean>

可视响应式对象

addInstance

addInstance: ((opts) => string)

增加实例化对象，如果id为空，则自动增加，如存在，则修改

Type declaration

    • (opts): string

    • 增加实例化对象，如果id为空，则自动增加，如存在，则修改

      Parameters

      • opts: {
            color?: Color;
            computeBoundingSphere?: boolean;
            id: string;
            position?: Vector3;
            rotation?: Vector3;
            scale?: number | Vector3;
        }
        • Optional color?: Color
        • Optional computeBoundingSphere?: boolean
        • id: string
        • Optional position?: Vector3
        • Optional rotation?: Vector3
        • Optional scale?: number | Vector3

      Returns string

clearInstanceBloom

clearInstanceBloom: (() => void)

清除所有实例辉光

Type declaration

    • (): void

    • 清除所有实例辉光

      Returns void

Param: id

id

Returns

clearInstanceHighlight

clearInstanceHighlight: (() => void)

清除所有实例高亮

Type declaration

    • (): void

    • 清除所有实例高亮

      Returns void

Param: id

id

clearInstanceOutline

clearInstanceOutline: (() => void)

清除所有实例描边

Type declaration

    • (): void

    • 清除所有实例描边

      Returns void

Returns

clearInstanceSelected

clearInstanceSelected: (() => void)

清除所有实例选择

Type declaration

    • (): void

    • 清除所有实例选择

      Returns void

Param: id

id

Returns

data

data: ShallowReactive<{
    [key: string]: any;
}> = ...

Type declaration

  • [key: string]: any

entityType

entityType: string = "Entity"

实体类型

extData

extData: {
    [key: string]: any;
} = {}

Type declaration

  • [key: string]: any

getGroup

getGroup: (() => Object3D<Object3DEventMap>)

获取实体化的组对象

Type declaration

    • (): Object3D<Object3DEventMap>

    • 获取实体化的组对象

      Returns Object3D<Object3DEventMap>

getIdByIndex

getIdByIndex: ((index) => string)

通过id获取索引

Type declaration

    • (index): string

    • 通过id获取索引

      Parameters

      • index: number

      Returns string

getIndexById

getIndexById: ((id) => number)

通过索引获取id

Type declaration

    • (id): number

    • 通过索引获取id

      Parameters

      • id: string

      Returns number

getInstanceAttr

getInstanceAttr: ((id, key) => void)

获取实例属性

Type declaration

    • (id, key): void

    • 获取实例属性

      Parameters

      • id: string

        id

      • key: string

      Returns void

Param: id

id

Returns

getInstanceBox3

getInstanceBox3: ((id) => Box3)

获取实例的外包盒

Type declaration

    • (id): Box3

    • 获取实例的外包盒

      Parameters

      • id: string

        id

      Returns Box3

Param: id

id

Returns

getInstancedMeshList

getInstancedMeshList: (() => DynamicInstancedMesh[])

获取实体化mesh列表

Type declaration

Readonly instanceId

instanceId: number = ++AppObject._instanceIdCounter

isEntity

isEntity: boolean = true

isInstanceBloom

isInstanceBloom: ((id) => boolean)

实例是否辉光

Type declaration

    • (id): boolean

    • 实例是否辉光

      Parameters

      • id: string

        id

      Returns boolean

Param: id

id

isInstanceHighlight

isInstanceHighlight: ((id) => boolean)

实例是否高亮

Type declaration

    • (id): boolean

    • 实例是否高亮

      Parameters

      • id: string

        id

      Returns boolean

Param: id

id

Returns

isInstanceOutline

isInstanceOutline: ((id) => boolean)

实例是否描边

Type declaration

    • (id): boolean

    • 实例是否描边

      Parameters

      • id: string

        id

      Returns boolean

Param: id

id

isInstanceSelected

isInstanceSelected: ((id) => boolean)

实例是否选中

Type declaration

    • (id): boolean

    • 实例是否选中

      Parameters

      • id: string

        id

      Returns boolean

Param: id

id

Readonly moduleManager

moduleManager: ModuleManager = ...

onSetApp

onSetApp: Signal = ...

options

options: EntityOptions

Optional rayIntersectObject

rayIntersectObject?: Object3D<Object3DEventMap>

拾取时实体对象，默认为entity.node

removeInstance

removeInstance: ((id, computeBoundingSphere?) => void)

根据一个id删除实例化对象

Type declaration

    • (id, computeBoundingSphere?): void

    • 根据一个id删除实例化对象

      Parameters

      • id: string
      • Optional computeBoundingSphere: boolean

      Returns void

setInstance

setInstance: ((opts) => string)

根据id设置实例化对象属性，如不存在，则新增，如果id为空，则自动增加

Type declaration

    • (opts): string

    • 根据id设置实例化对象属性，如不存在，则新增，如果id为空，则自动增加

      Parameters

      • opts: {
            color?: Color;
            computeBoundingSphere?: boolean;
            id: string;
            position?: Vector3;
            rotation?: Vector3;
            scale?: number | Vector3;
        }
        • Optional color?: Color
        • Optional computeBoundingSphere?: boolean
        • id: string
        • Optional position?: Vector3
        • Optional rotation?: Vector3
        • Optional scale?: number | Vector3

      Returns string

setInstanceAttr

setInstanceAttr: ((id, key, value) => void)

设置实例属性

Type declaration

    • (id, key, value): void

    • 设置实例属性

      Parameters

      • id: string

        id

      • key: string
      • value: any

      Returns void

Param: id

id

Returns

setInstanceBloom

setInstanceBloom: ((id, isSelected?) => void)

设置实例辉光与否

Type declaration

    • (id, isSelected?): void

    • 设置实例辉光与否

      Parameters

      • id: string
      • Optional isSelected: boolean

      Returns void

setInstanceHighlight

setInstanceHighlight: ((id, highlightColor?) => void)

设置实例高亮与否

Type declaration

    • (id, highlightColor?): void

    • 设置实例高亮与否

      Parameters

      • id: string

        id

      • Optional highlightColor: ColorRepresentation

        高亮颜色，如果为null，则表示取消高亮

      Returns void

Param: id

id

Param: highlightColor

高亮颜色，如果为null，则表示取消高亮

Returns

setInstanceOutline

setInstanceOutline: ((id, isSelected?) => void)

设置实例描边与否

Type declaration

    • (id, isSelected?): void

    • 设置实例描边与否

      Parameters

      • id: string
      • Optional isSelected: boolean

      Returns void

setInstanceSelected

setInstanceSelected: ((id, isSelected?) => void)

设置实例选择与否

Type declaration

    • (id, isSelected?): void

    • 设置实例选择与否

      Parameters

      • id: string
      • Optional isSelected: boolean

      Returns void

signal

signal: {
    onAdd: Signal;
    onBeforeAdd: Signal;
    onBeforeRemove: Signal;
    onKeyDown: Signal;
    onKeyUp: Signal;
    onMouseClick: Signal;
    onMouseDblClick: Signal;
    onMouseDown: Signal;
    onMouseEnter: Signal;
    onMouseLeave: Signal;
    onMouseMove: Signal;
    onMouseOut: Signal;
    onMouseOver: Signal;
    onMouseUp: Signal;
    onMouseWheel: Signal;
    onPointerDown: Signal;
    onPointerMove: Signal;
    onPointerUp: Signal;
    onRayIntersect: Signal;
    onRemove: Signal;
} = ...

Type declaration

uuid

uuid: string = ...

Static defaultModules

defaultModules: (EntityModuleConstructor | [EntityModuleConstructor, any])[] = []

Accessors

app

  • get app(): App

  • Returns App

  • set app(value): void

  • Parameters

    Returns void

bloom

  • get bloom(): boolean

  • Returns boolean

  • set bloom(val): void

  • Parameters

    • val: boolean

    Returns void

bloomRef

  • get bloomRef(): Ref<boolean>

  • Returns Ref<boolean>

boxHelper

boxHelperRef

  • get boxHelperRef(): Ref<boolean>

  • Returns Ref<boolean>

castShadow

  • get castShadow(): boolean

  • Returns boolean

  • set castShadow(val): void

  • Parameters

    • val: boolean

    Returns void

childrens

  • get childrens(): Entity[]

  • Returns Entity[]

  • set childrens(child): void

  • Parameters

    Returns void

destroyed

  • get destroyed(): boolean

  • Whether it has been destroyed.

    Returns boolean

frustumCulled

  • get frustumCulled(): boolean

  • Returns boolean

  • set frustumCulled(val): void

  • Parameters

    • val: boolean

    Returns void

isDisposed

  • get isDisposed(): boolean

  • Returns boolean

matrix

  • get matrix(): Matrix4

  • Returns Matrix4

matrixWorld

  • get matrixWorld(): Matrix4

  • Returns Matrix4

modules

node

  • get node(): Object3D<Object3DEventMap>

  • Returns Object3D<Object3DEventMap>

  • set node(obj): void

  • Parameters

    • obj: Object3D<Object3DEventMap>

    Returns void

outline

  • get outline(): boolean

  • Returns boolean

  • set outline(val): void

  • Parameters

    • val: boolean

    Returns void

outlineRef

  • get outlineRef(): Ref<boolean>

  • Returns Ref<boolean>

parent

  • get parent(): Entity

  • Returns Entity

  • set parent(val): void

  • Parameters

    Returns void

pointerEvents

  • get pointerEvents(): boolean

  • Returns boolean

  • set pointerEvents(b): void

  • Parameters

    • b: boolean

    Returns void

pointerEventsRef

  • get pointerEventsRef(): Ref<boolean>

  • Returns Ref<boolean>

position

  • get position(): Vector3

  • Returns Vector3

quaternion

  • get quaternion(): Quaternion

  • Returns Quaternion

rayIntersectRecursive

  • get rayIntersectRecursive(): boolean

  • Returns boolean

  • set rayIntersectRecursive(b): void

  • Parameters

    • b: boolean

    Returns void

rayQueryType

  • get rayQueryType(): RayQueryType

  • Returns RayQueryType

  • set rayQueryType(b): void

  • Parameters

    Returns void

receiveShadow

  • get receiveShadow(): boolean

  • Returns boolean

  • set receiveShadow(val): void

  • Parameters

    • val: boolean

    Returns void

rotation

  • get rotation(): Euler

  • Returns Euler

scale

  • get scale(): Vector3

  • Returns Vector3

selected

  • get selected(): boolean

  • Returns boolean

  • set selected(val): void

  • Parameters

    • val: boolean

    Returns void

selectedRef

  • get selectedRef(): Ref<boolean>

  • Returns Ref<boolean>

uiConfig

visible

  • get visible(): boolean

  • Returns boolean

  • set visible(val): void

  • Parameters

    • val: boolean

    Returns void

visibleRef

  • get visibleRef(): Ref<boolean>

  • Returns Ref<boolean>

Methods

add

  • add<T, U>(type, params?): T

  • 增加模块,如果模块已存在，则返回之前的模型，等同于this.addModule(xxx)

    Type Parameters

    Parameters

    • type: (new (entity?, obj?) => T)
        • new (entity?, obj?): T

        • Parameters

          • Optional entity: any
          • Optional obj: U

          Returns T

    • Optional params: U

    Returns T

addAction

  • addAction(func, id?): (() => void)

  • 增加一个自定义动作脚本

    Parameters

    • func: ((context) => void | BehaviorStatus)

      脚本函数

        • (context): void | BehaviorStatus

        • Parameters

          • context: {
                elapsed: number;
                entity: Entity;
                timeDelta: number;
                [key: string]: any;
            }
            • [key: string]: any
            • elapsed: number
            • entity: Entity
            • timeDelta: number

          Returns void | BehaviorStatus

    • Optional id: string

      脚本id

    Returns (() => void)

      • (): void

      • Returns void

addChildEntity

addDispose

  • addDispose(cb): void

  • Parameters

    • cb: Function

    Returns void

addEdges

  • addEdges(option?, isHideMesh?): void

  • 增加模型边框线

    Parameters

    • Optional option: LineBasicMaterialParameters
    • Optional isHideMesh: boolean

      是否隐藏mesh本身（默认false)

    Returns void

addModule

  • addModule<T, U>(type, params?): T

  • 增加模块,如果模块已存在，则返回之前的模型，等同于this.add(xxx)

    Type Parameters

    Parameters

    • type: (new (entity?, obj?) => T)

      模块类

        • new (entity?, obj?): T

        • Parameters

          • Optional entity: any
          • Optional obj: U

          Returns T

    • Optional params: U

      参数

    Returns T

addObjects

  • addObjects(objs): void

  • Parameters

    • objs: Object3D<Object3DEventMap> | Object3D<Object3DEventMap>[]

    Returns void

addTo

applyMixinsTo

  • applyMixinsTo(toClassInst, methodNames?, addMethods?, filterName?): void

  • Parameters

    • toClassInst: any
    • Optional methodNames: string[]
    • Optional addMethods: string[]
    • Optional filterName: string[]

    Returns void

callModules

  • callModules(methodName, ...args): void

  • 调用模块中的函数

    Parameters

    • methodName: string
    • Rest ...args: any

    Returns void

clearEdges

  • clearEdges(): void

  • 移除模型边框线

    Returns void

clearHighlight

destroy

  • destroy(): void

  • Destroy self.

    Returns void

dispatch

  • dispatch(event, ...data): boolean

  • 触发指定事件名称.

    Parameters

    • event: string

      Event name

    • Rest ...data: any

      Data

    Returns boolean

    • Whether the dispatching is successful

effectScope

  • effectScope(fn): void

  • Parameters

    • fn: (() => any)
        • (): any

        • Returns any

    Returns void

eventNames

  • eventNames(): string[]

  • 返回注册的所有事件名.

    Returns string[]

    所有事件名

getBoundingBox

  • getBoundingBox(inLocalSpace?, mapModeSceneSpace?): Box3

  • 获取物体的外包盒

    Parameters

    • Optional inLocalSpace: boolean

      局部空间

    • Optional mapModeSceneSpace: boolean

      地图模式下返回场景空间坐标

    Returns Box3

getEntitiesByModule

getEntitiesByName

getEntitiesByProperty

getEntityById

getEntityByName

getEntityByProperty

getEntityByUuid

getLeafEntities

getMeshEntities

getMeshEntityById

getMeshEntityByName

getMeshEntityByProperty

getMeshEntityByUuid

getModule

  • getModule<T, U>(type): T

  • 获取模块

    Type Parameters

    Parameters

    • type: (new (entity?, obj?) => T)

      模型类型

        • new (entity?, obj?): T

        • Parameters

          • Optional entity: any
          • Optional obj: U

          Returns T

    Returns T

getObjectById

  • getObjectById(id): Object3D<Object3DEventMap>

  • Parameters

    • id: string

    Returns Object3D<Object3DEventMap>

getObjectByName

  • getObjectByName(name): Object3D<Object3DEventMap>

  • Parameters

    • name: string

    Returns Object3D<Object3DEventMap>

getObjectByProperty

  • getObjectByProperty(name, value): Object3D<Object3DEventMap>

  • Parameters

    • name: string
    • value: string

    Returns Object3D<Object3DEventMap>

getObjectByUuid

  • getObjectByUuid(uuid): Object3D<Object3DEventMap>

  • Parameters

    • uuid: string

    Returns Object3D<Object3DEventMap>

getObjectPropertyValueCount

getObjectsByName

  • getObjectsByName(name): Object3D<Object3DEventMap>[]

  • Parameters

    • name: string

    Returns Object3D<Object3DEventMap>[]

getObjectsByProperty

  • getObjectsByProperty(name, value): Object3D<Object3DEventMap>[]

  • Parameters

    • name: string
    • value: string

    Returns Object3D<Object3DEventMap>[]

getPointerEventsEntities

hasEvent

  • hasEvent(event): boolean

  • 确定是否存在事件侦听

    Parameters

    • event: string

      事件名

    Returns boolean

    返回是否存在相应的事件

isFireEventsByIntersect

isHighlight

isLikeMeshEntity

  • isLikeMeshEntity(): boolean

  • 判断实体是否是mesh实体或包含mesh实体模块

    Returns boolean

listenerCount

  • listenerCount(event): number

  • 返回具有指定事件名称的侦听总数.

    Parameters

    • event: string

      Event name

    Returns number

    The count of listeners

off

  • off(event, fn?): EventDispatcher

  • 移除监听.

    Parameters

    • event: string

      Event name

    • Optional fn: Function

      Function, If is undefined, delete all corresponding event listeners.

    Returns EventDispatcher

on

onEntityAwake

  • onEntityAwake(callback): void

  • Parameters

    • callback: ((app) => void)
        • (app): void

        • Parameters

          Returns void

    Returns void

once

remove

removeAction

  • removeAction(id): void

  • 移除一个自定义动作脚本

    Parameters

    • id: string

      脚本id

    Returns void

removeAllEventListeners

  • removeAllEventListeners(event?): void

  • 通过事件名移除所有监听.

    Parameters

    • Optional event: string

      Event name, delete all events if not passed

    Returns void

removeAllModules

removeChildEntity

removeDispose

removeModule

  • removeModule<T, U>(type): void

  • 移除模块

    Type Parameters

    Parameters

    • type: (new (entity?, obj?) => T)

      模型类型

        • new (entity?, obj?): T

        • Parameters

          • Optional entity: any
          • Optional obj: U

          Returns T

    Returns void

removeObjects

  • removeObjects(objs): void

  • Parameters

    • objs: Object3D<Object3DEventMap> | Object3D<Object3DEventMap>[]

    Returns void

replaceMaterial

  • replaceMaterial(material): void

  • 替换材质

    Parameters

    • material: Material | Material[]

    Returns void

resetMaterial

setHighlight

  • setHighlight(color?, opacity?): void

  • 设置高亮

    Parameters

    • Optional color: ColorRepresentation
    • Optional opacity: number

    Returns void

setOpacity

  • setOpacity(opacity, isAccOpacity?): void

  • 设置透明度

    Parameters

    • opacity: number

      透明度0(完全透明)-1(不透明)

    • Optional isAccOpacity: boolean

      是否累加透明度(ture和之前透明度相乘，false直接设置透明度)

    Returns void

setupUiConfig

toJSON

traverse

  • traverse(callback, filter?): void

  • Parameters

    • callback: ((ent) => any)
        • (ent): any

        • Parameters

          Returns any

    • Optional filter: ((ent) => boolean)
        • (ent): boolean

        • Parameters

          Returns boolean

    Returns void

traverseVisible

  • traverseVisible(callback, filter?): void

  • Parameters

    • callback: ((ent) => any)
        • (ent): any

        • Parameters

          Returns any

    • Optional filter: ((ent) => boolean)
        • (ent): boolean

        • Parameters

          Returns boolean

    Returns void

tween

Static attchObject

  • attchObject(obj, splitSubEntity?, overwriteEntity?, app?): Entity

  • 给一个已加入场景中的对象关联一个实体

    Parameters

    • obj: Object3D<Object3DEventMap>

      已加入场景中的对象

    • Optional splitSubEntity: boolean

      是否把子对象拆成子实体 （默认false)

    • Optional overwriteEntity: boolean

      当有关联的实体时，重新再生成一个实体相关联 （默认false)

    • Optional app: App

      应用对象，默认用当前的

    Returns Entity

Static create

Static fromJSON

  • fromJSON(json, objects): Entity

  • Parameters

    • json: Record<string, any>
    • objects: Map<string, Object3D<Object3DEventMap>>

    Returns Entity

Static fromModule

Static fromObject3d

  • fromObject3d(objs): Entity

  • 通过一个或多个object3d对象创建一个实体

    Parameters

    • objs: Object3D<Object3DEventMap> | Object3D<Object3DEventMap>[]

    Returns Entity

Static fromObjectModule

Static getOwerEntity

  • getOwerEntity(object, canChildEntity?): Entity

  • 通过一个obejct获取所属的实体

    Parameters

    • object: Object3D<Object3DEventMap>

      物体对象

    • Optional canChildEntity: boolean

      是否获取到子实体。默认false. false的话表示获取的是最上级的实体对象。true获取的是所属的子实体对象

    Returns Entity

Settings

Member Visibility

Theme

On This Page