Class InstancingMesh

GPU 인스턴싱 기반의 메시 클래스입니다.

하나의 geometry와 material을 여러 인스턴스(Instance)로 효율적으로 렌더링할 수 있습니다.

각 인스턴스는 transform(위치, 회전, 스케일)만 다르고 geometry/vertex 데이터와 머티리얼은 공유합니다.

Hierarchy (View Summary)

Mesh
- InstancingMesh

Index

Constructors

constructor

Properties

_geometry _material animationInfo castShadow dirtyOpacity dirtyPipeline dirtyTransform disableJitter displacementTexture gltfLoaderInfo gpuRenderInfo localMatrix meshType modelMatrix normalModelMatrix receiveShadow useDisplacementTexture

Constructors

constructor

new InstancingMesh(
    redGPUContext: RedGPUContext,
    instanceCount: number,
    geometry?: Geometry | Primitive.Core.Primitive,
    material?: any,
): InstancingMesh
InstancingMesh 인스턴스를 생성합니다.
Parameters
- redGPUContext: RedGPUContext
  RedGPU 컨텍스트
- instanceCount: number
  인스턴스 개수
- Optionalgeometry: Geometry | Primitive.Core.Primitive
  geometry 또는 primitive 객체(선택)
- Optionalmaterial: any
  머티리얼(선택)
Returns InstancingMesh
Overrides Mesh.constructor
- Defined in src/display/instancingMesh/InstancingMesh.ts:47

Properties

_geometry

_geometry: Geometry | Primitive.Core.Primitive

_material

_material: any

animationInfo

animationInfo: {
    animationsList: GLTFParsedSingleClip[];
    jointBuffer: IndexBuffer;
    morphInfo: MorphInfo_GLTF;
    skinInfo: ParsedSkinInfo_GLTF;
    weightBuffer: VertexBuffer;
} = ...

castShadow

castShadow: boolean = false

그림자 캐스팅 여부

dirtyOpacity

dirtyOpacity: boolean = true

dirtyPipeline

dirtyPipeline: boolean = true

dirtyTransform

dirtyTransform: boolean = true

disableJitter

disableJitter: boolean

displacementTexture

displacementTexture: BitmapTexture

메시의 디스플레이스먼트 텍스처

gltfLoaderInfo

gltfLoaderInfo: GLTFLoader

gpuRenderInfo

gpuRenderInfo: VertexGPURenderInfo

localMatrix

localMatrix: mat4 = ...

meshType

meshType: string

modelMatrix

modelMatrix: mat4 = ...

이 객체의 모델 행렬입니다. 위치, 회전, 스케일 변환에 사용됩니다.

normalModelMatrix

normalModelMatrix: mat4 = ...

receiveShadow

receiveShadow: boolean

useDisplacementTexture

useDisplacementTexture: boolean

Accessors

boundingAABB

get boundingAABB(): AABB
Returns AABB
Inherited from Mesh.boundingAABB
- Defined in src/display/mesh/Mesh.ts:367

boundingOBB

get boundingOBB(): OBB
Returns OBB
Inherited from Mesh.boundingOBB
- Defined in src/display/mesh/Mesh.ts:358

children

get children(): Mesh[]
현재 컨테이너에 포함된 자식 Mesh 배열을 반환합니다.

Returns Mesh[]
자식 객체 배열
Inherited from Mesh.children
- Defined in src/display/mesh/core/Object3DContainer.ts:41

combinedBoundingAABB

get combinedBoundingAABB(): AABB
Returns AABB
Inherited from Mesh.combinedBoundingAABB
- Defined in src/display/mesh/Mesh.ts:376

currentShaderModuleName

get currentShaderModuleName(): string
Returns string
Inherited from Mesh.currentShaderModuleName
- Defined in src/display/mesh/core/MeshBase.ts:73
set currentShaderModuleName(value: string): void
Parameters
- value: string
Returns void
Inherited from Mesh.currentShaderModuleName
- Defined in src/display/mesh/core/MeshBase.ts:77

depthStencilState

get depthStencilState(): DepthStencilState
Returns DepthStencilState
Inherited from Mesh.depthStencilState
- Defined in src/display/mesh/core/MeshBase.ts:86

drawDebugger

get drawDebugger(): DrawDebuggerMesh
Returns DrawDebuggerMesh
Inherited from Mesh.drawDebugger
- Defined in src/display/mesh/Mesh.ts:153

enableDebugger

get enableDebugger(): boolean
Returns boolean
Inherited from Mesh.enableDebugger
- Defined in src/display/mesh/Mesh.ts:144
set enableDebugger(value: boolean): void
Parameters
- value: boolean
Returns void
Inherited from Mesh.enableDebugger
- Defined in src/display/mesh/Mesh.ts:148

events

get events(): any
Returns any
Inherited from Mesh.events
- Defined in src/display/mesh/Mesh.ts:205

geometry

get geometry(): Geometry | Primitive.Core.Primitive
Returns Geometry | Primitive.Core.Primitive
Inherited from Sprite3D.geometry
- Defined in src/display/mesh/Mesh.ts:173
set geometry(value: Geometry | Primitive.Core.Primitive): void
Parameters
- value: Geometry | Primitive.Core.Primitive
Returns void
Inherited from Sprite3D.geometry
- Defined in src/display/mesh/Mesh.ts:177

gpuDevice

get gpuDevice(): GPUDevice
Retrieves the GPU device associated with the current instance.

Returns GPUDevice
The GPU device.
Inherited from Mesh.gpuDevice
- Defined in src/display/mesh/core/MeshBase.ts:94

ignoreFrustumCulling

get ignoreFrustumCulling(): boolean
Returns boolean
Inherited from ASpriteSheet.ignoreFrustumCulling
- Defined in src/display/mesh/Mesh.ts:193
set ignoreFrustumCulling(value: boolean): void
Parameters
- value: boolean
Returns void
Inherited from ASpriteSheet.ignoreFrustumCulling
- Defined in src/display/mesh/Mesh.ts:197

instanceChildren

get instanceChildren(): instancingMeshObject3D[]
인스턴스별 transform/계층 구조를 관리하는 객체 배열을 반환합니다.

Returns instancingMeshObject3D[]
- Defined in src/display/instancingMesh/InstancingMesh.ts:105

instanceCount

get instanceCount(): number
인스턴스 개수를 반환합니다.

Returns number
- Defined in src/display/instancingMesh/InstancingMesh.ts:67
set instanceCount(count: number): void
인스턴스 개수를 설정합니다. (버퍼 및 인스턴스 객체 자동 갱신)
Parameters
- count: number
  인스턴스 개수
Returns void
- Defined in src/display/instancingMesh/InstancingMesh.ts:75

material

get material(): any
Returns any
Inherited from Sprite3D.material
- Defined in src/display/mesh/Mesh.ts:158
set material(value: any): void
Parameters
- value: any
Returns void
Inherited from Sprite3D.material
- Defined in src/display/mesh/Mesh.ts:162

name

get name(): string
Returns string
Inherited from Mesh.name
- Defined in src/display/mesh/Mesh.ts:209
set name(value: string): void
Parameters
- value: string
Returns void
Inherited from Mesh.name
- Defined in src/display/mesh/Mesh.ts:214

numChildren

get numChildren(): number
자식 객체의 개수를 반환합니다.

Returns number
자식 수
Inherited from Mesh.numChildren
- Defined in src/display/mesh/core/Object3DContainer.ts:49

opacity

get opacity(): number
Returns number
Inherited from Mesh.opacity
- Defined in src/display/mesh/Mesh.ts:183
set opacity(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.opacity
- Defined in src/display/mesh/Mesh.ts:187

parent

get parent(): Object3DContainer
설정된 부모 객체값을 반환합니다.

Returns Object3DContainer
Inherited from Mesh.parent
- Defined in src/display/mesh/Mesh.ts:225
set parent(value: Object3DContainer): void
부모 객체를 설정합니다.
Parameters
- value: Object3DContainer
Returns void
Inherited from Mesh.parent
- Defined in src/display/mesh/Mesh.ts:233

pickingId

get pickingId(): number
Returns number
Inherited from Mesh.pickingId
- Defined in src/display/mesh/Mesh.ts:201

pivotX

get pivotX(): number
Returns number
Inherited from Mesh.pivotX
- Defined in src/display/mesh/Mesh.ts:237
set pivotX(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.pivotX
- Defined in src/display/mesh/Mesh.ts:241

pivotY

get pivotY(): number
Returns number
Inherited from Mesh.pivotY
- Defined in src/display/mesh/Mesh.ts:246
set pivotY(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.pivotY
- Defined in src/display/mesh/Mesh.ts:250

pivotZ

get pivotZ(): number
Returns number
Inherited from Mesh.pivotZ
- Defined in src/display/mesh/Mesh.ts:255
set pivotZ(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.pivotZ
- Defined in src/display/mesh/Mesh.ts:259

position

get position(): Float32Array
Returns Float32Array
Inherited from Mesh.position
- Defined in src/display/mesh/Mesh.ts:291

primitiveState

get primitiveState(): PrimitiveState
Returns PrimitiveState
Inherited from Mesh.primitiveState
- Defined in src/display/mesh/core/MeshBase.ts:82

redGPUContext

get redGPUContext(): RedGPUContext
Retrieves the RedGPUContext instance.

Returns RedGPUContext
The RedGPUContext instance.
Inherited from Mesh.redGPUContext
- Defined in src/display/mesh/core/MeshBase.ts:103

rotation

get rotation(): Float32Array
Returns Float32Array
Inherited from Mesh.rotation
- Defined in src/display/mesh/Mesh.ts:354

rotationX

get rotationX(): number
Returns number
Inherited from Mesh.rotationX
- Defined in src/display/mesh/Mesh.ts:326
set rotationX(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.rotationX
- Defined in src/display/mesh/Mesh.ts:330

rotationY

get rotationY(): number
Returns number
Inherited from Mesh.rotationY
- Defined in src/display/mesh/Mesh.ts:336
set rotationY(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.rotationY
- Defined in src/display/mesh/Mesh.ts:340

rotationZ

get rotationZ(): number
Returns number
Inherited from Mesh.rotationZ
- Defined in src/display/mesh/Mesh.ts:345
set rotationZ(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.rotationZ
- Defined in src/display/mesh/Mesh.ts:349

scale

get scale(): Float32Array
Returns Float32Array
Inherited from Mesh.scale
- Defined in src/display/mesh/Mesh.ts:322

scaleX

get scaleX(): number
Returns number
Inherited from Mesh.scaleX
- Defined in src/display/mesh/Mesh.ts:295
set scaleX(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.scaleX
- Defined in src/display/mesh/Mesh.ts:299

scaleY

get scaleY(): number
Returns number
Inherited from Mesh.scaleY
- Defined in src/display/mesh/Mesh.ts:304
set scaleY(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.scaleY
- Defined in src/display/mesh/Mesh.ts:308

scaleZ

get scaleZ(): number
Returns number
Inherited from Mesh.scaleZ
- Defined in src/display/mesh/Mesh.ts:313
set scaleZ(value: number): void
Parameters
- value: number
Returns void
Inherited from Mesh.scaleZ
- Defined in src/display/mesh/Mesh.ts:317

uuid

get uuid(): string
Retrieves the UUID of the object.

Returns string
The UUID of the object.
Inherited from Mesh.uuid
- Defined in src/display/mesh/core/MeshBase.ts:69

vertexStateBuffers

get vertexStateBuffers(): GPUVertexBufferLayout[]
Returns GPUVertexBufferLayout[]
Inherited from Mesh.vertexStateBuffers
- Defined in src/display/mesh/Mesh.ts:218

x

get x(): number
Returns number
Inherited from ASpriteSheet.x
- Defined in src/display/mesh/Mesh.ts:264
set x(value: number): void
Parameters
- value: number
Returns void
Inherited from ASpriteSheet.x
- Defined in src/display/mesh/Mesh.ts:268

y

get y(): number
Returns number
Inherited from ASpriteSheet.y
- Defined in src/display/mesh/Mesh.ts:273
set y(value: number): void
Parameters
- value: number
Returns void
Inherited from ASpriteSheet.y
- Defined in src/display/mesh/Mesh.ts:277

z

get z(): number
Returns number
Inherited from ASpriteSheet.z
- Defined in src/display/mesh/Mesh.ts:282
set z(value: number): void
Parameters
- value: number
Returns void
Inherited from ASpriteSheet.z
- Defined in src/display/mesh/Mesh.ts:286

Methods

__fireListenerList

__fireListenerList(resetList?: boolean): void
Fires the dirty listeners list.
Parameters
- OptionalresetList: boolean = false
  Indicates whether to reset the dirty listeners list after firing.
Returns void
Inherited from Mesh.__fireListenerList
- Defined in src/display/mesh/core/MeshBase.ts:124

addChild

addChild(child: Mesh): Mesh
자식 Mesh를 컨테이너에 추가합니다.
Parameters
- child: Mesh
  추가할 자식 객체
Returns Mesh
추가된 객체 또는 실패 시 null
Inherited from Mesh.addChild
- Defined in src/display/mesh/core/Object3DContainer.ts:68

addChildAt

addChildAt(child: Mesh, index: number): InstancingMesh
자식 Mesh를 특정 인덱스에 추가합니다.
Parameters
- child: Mesh
  추가할 자식 객체
- index: number
  삽입 위치
Returns InstancingMesh
현재 컨테이너
Inherited from Mesh.addChildAt
- Defined in src/display/mesh/core/Object3DContainer.ts:86

addListener

addListener(eventName: string, callback: Function): void
Parameters
- eventName: string
- callback: Function
Returns void
Inherited from Mesh.addListener
- Defined in src/display/mesh/Mesh.ts:421

clone

clone(): Mesh
Returns Mesh
Inherited from Mesh.clone
- Defined in src/display/mesh/Mesh.ts:471

contains

contains(child: Mesh): boolean
특정 Mesh가 현재 컨테이너에 포함되어 있는지 확인합니다.
Parameters
- child: Mesh
  확인할 자식 객체
Returns boolean
포함 여부
Inherited from Mesh.contains
- Defined in src/display/mesh/core/Object3DContainer.ts:58

createMeshVertexShaderModuleBASIC

createMeshVertexShaderModuleBASIC(
    VERTEX_SHADER_MODULE_NAME: any,
    SHADER_INFO: any,
    UNIFORM_STRUCT_BASIC: any,
    vertexModuleSource: any,
): GPUShaderModule
Parameters
- VERTEX_SHADER_MODULE_NAME: any
- SHADER_INFO: any
- UNIFORM_STRUCT_BASIC: any
- vertexModuleSource: any
Returns GPUShaderModule
Inherited from Mesh.createMeshVertexShaderModuleBASIC
- Defined in src/display/mesh/Mesh.ts:1067

getChildAt

getChildAt(index: number): Mesh
지정된 인덱스의 자식 Mesh를 반환합니다.
Parameters
- index: number
  조회할 위치
Returns Mesh
해당 위치의 자식 객체 또는 undefined
Inherited from Mesh.getChildAt
- Defined in src/display/mesh/core/Object3DContainer.ts:108

getChildIndex

getChildIndex(child: Mesh): number
특정 자식 객체의 인덱스를 반환합니다.
Parameters
- child: Mesh
  조회할 자식 객체
Returns number
인덱스 또는 -1
Inherited from Mesh.getChildIndex
- Defined in src/display/mesh/core/Object3DContainer.ts:122

getCombinedOpacity

getCombinedOpacity(): number
Returns number
Inherited from Mesh.getCombinedOpacity
- Defined in src/display/mesh/Mesh.ts:413

getScreenPoint

getScreenPoint(view: View3D): [number, number]
Parameters
- view: View3D
Returns [number, number]
Inherited from Mesh.getScreenPoint
- Defined in src/display/mesh/core/MeshBase.ts:115

initGPURenderInfos

initGPURenderInfos(): void
Returns void
Inherited from Mesh.initGPURenderInfos
- Defined in src/display/mesh/Mesh.ts:1053

localToWorld

localToWorld(x: number, y: number, z: number): [number, number, number]
Parameters
- x: number
- y: number
- z: number
Returns [number, number, number]
Inherited from Mesh.localToWorld
- Defined in src/display/mesh/core/MeshBase.ts:111

lookAt

lookAt(
    targetX: number | [number, number, number],
    targetY?: number,
    targetZ?: number,
): void
Parameters
- targetX: number | [number, number, number]
- OptionaltargetY: number
- OptionaltargetZ: number
Returns void
Inherited from Mesh.lookAt
- Defined in src/display/mesh/Mesh.ts:426

removeAllChildren

removeAllChildren(): InstancingMesh
모든 자식 객체를 제거합니다.

Returns InstancingMesh
현재 컨테이너
Inherited from Mesh.removeAllChildren
- Defined in src/display/mesh/core/Object3DContainer.ts:231

removeChild

removeChild(child: Mesh): Mesh
특정 자식 객체를 제거합니다.
Parameters
- child: Mesh
  제거할 자식 객체
Returns Mesh
제거된 객체
Inherited from Mesh.removeChild
- Defined in src/display/mesh/core/Object3DContainer.ts:200

removeChildAt

removeChildAt(index: number): Mesh
지정된 인덱스의 자식 객체를 제거합니다.
Parameters
- index: number
  제거할 위치
Returns Mesh
제거된 객체
Inherited from Mesh.removeChildAt
- Defined in src/display/mesh/core/Object3DContainer.ts:216

render

render(renderViewStateData: RenderViewStateData, shadowRender?: boolean): void
인스턴싱 메시의 렌더링을 수행합니다.
Parameters
- renderViewStateData: RenderViewStateData
  렌더 상태 데이터
- shadowRender: boolean = false
  그림자 렌더링 여부
Returns void
Overrides Mesh.render
- Defined in src/display/instancingMesh/InstancingMesh.ts:114

setCastShadowRecursively

setCastShadowRecursively(castShadow?: boolean): void
Parameters
- castShadow: boolean = false
Returns void
Inherited from Mesh.setCastShadowRecursively
- Defined in src/display/mesh/Mesh.ts:391

setChildIndex

setChildIndex(child: Mesh, index: number): void
자식 객체의 위치를 변경합니다.
Parameters
- child: Mesh
  대상 자식 객체
- index: number
  새 인덱스
Returns void
Inherited from Mesh.setChildIndex
- Defined in src/display/mesh/core/Object3DContainer.ts:137

setEnableDebuggerRecursively

setEnableDebuggerRecursively(enableDebugger?: boolean): void
Parameters
- enableDebugger: boolean = false
Returns void
Inherited from Mesh.setEnableDebuggerRecursively
- Defined in src/display/mesh/Mesh.ts:380

setPosition

setPosition(x: number, y?: number, z?: number): void
Parameters
- x: number
- Optionaly: number
- Optionalz: number
Returns void
Inherited from Mesh.setPosition
- Defined in src/display/mesh/Mesh.ts:451

setReceiveShadowRecursively

setReceiveShadowRecursively(receiveShadow?: boolean): void
Parameters
- receiveShadow: boolean = false
Returns void
Inherited from Mesh.setReceiveShadowRecursively
- Defined in src/display/mesh/Mesh.ts:402

setRotation

setRotation(rotationX: number, rotationY?: number, rotationZ?: number): void
Parameters
- rotationX: number
- OptionalrotationY: number
- OptionalrotationZ: number
Returns void
Inherited from Mesh.setRotation
- Defined in src/display/mesh/Mesh.ts:461

setScale

setScale(x: number, y?: number, z?: number): void
Parameters
- x: number
- Optionaly: number
- Optionalz: number
Returns void
Inherited from Mesh.setScale
- Defined in src/display/mesh/Mesh.ts:441

swapChildren

swapChildren(child1: Mesh, child2: Mesh): void
두 자식 객체의 위치를 서로 바꿉니다.
Parameters
- child1: Mesh
  첫 번째 객체
- child2: Mesh
  두 번째 객체
Returns void
Inherited from Mesh.swapChildren
- Defined in src/display/mesh/core/Object3DContainer.ts:160

swapChildrenAt

swapChildrenAt(index1: number, index2: number): void
두 인덱스의 자식 객체 위치를 서로 바꿉니다.
Parameters
- index1: number
  첫 번째 인덱스
- index2: number
  두 번째 인덱스
Returns void
Inherited from Mesh.swapChildrenAt
- Defined in src/display/mesh/core/Object3DContainer.ts:180

worldToLocal

worldToLocal(x: number, y: number, z: number): [number, number, number]
Parameters
- x: number
- y: number
- z: number
Returns [number, number, number]
Inherited from Mesh.worldToLocal
- Defined in src/display/mesh/core/MeshBase.ts:107

Class InstancingMesh

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns InstancingMesh

Properties

_geometry

_material

animationInfo

castShadow

dirtyOpacity

dirtyPipeline

dirtyTransform

disableJitter

displacementTexture

gltfLoaderInfo

gpuRenderInfo

localMatrix

meshType

modelMatrix

normalModelMatrix

receiveShadow

useDisplacementTexture

Accessors

boundingAABB

Returns AABB

boundingOBB

Returns OBB

children

Returns Mesh[]

combinedBoundingAABB

Returns AABB

currentShaderModuleName

Returns string

Parameters

Returns void

depthStencilState

Returns DepthStencilState

drawDebugger

Returns DrawDebuggerMesh

enableDebugger

Returns boolean

Parameters

Returns void

events

Returns any

geometry

Returns Geometry | Primitive.Core.Primitive

Parameters

Returns void

gpuDevice

Returns GPUDevice

ignoreFrustumCulling

Returns boolean

Parameters

Returns void

instanceChildren

Returns instancingMeshObject3D[]

instanceCount

Returns number

Parameters

Returns void

material

Returns any

Parameters

Returns void

name

Returns string

Parameters

Returns void

numChildren

Returns number

opacity

Returns number