RedGPU API v4.4.0-Alpha

---

RedGPU API / RedGPU / Display / Sprite3D

Class: Sprite3D

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:34

3D 공간에 배치되는 스프라이트 클래스입니다.

텍스처 종횡비에 맞춰 가로·세로 비율(renderRatioX, renderRatioY)이 자동 산출되며, 빌보드 회전(useBillboard)과 크기 모드(usePixelSize: worldSize 또는 pixelSize)가 서로 독립적으로 동작합니다.

---

Example

const material = new RedGPU.Material.BitmapMaterial(redGPUContext, texture);
const sprite = new RedGPU.Display.Sprite3D(redGPUContext, material);
scene.addChild(sprite);

See

• Sprite3D Basic example
• Sprite3D Comparison (World vs Pixel)
• Sprite3D MouseEvent example

Extends

• Mesh

Constructors

---

Constructor

new Sprite3D(redGPUContext, material?, geometry?): Sprite3D

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:63

Sprite3D 인스턴스를 생성합니다.

Example

const sprite = new RedGPU.Display.Sprite3D(redGPUContext, material);

Parameters

Parameter	Type	Description
redGPUContext	RedGPUContext	RedGPUContext 인스턴스
material?	any	적용할 머티리얼 (선택)
geometry?	Geometry | Primitive	지오메트리 또는 프리미티브 인스턴스 (생략 시 기본 Plane 사용)

Returns

Sprite3D

Overrides

Mesh.constructor

Properties

Accessors

---

pixelSize

Get Signature

get pixelSize(): number

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:145

고정 픽셀 크기 모드(usePixelSize: true)에서 표시할 세로 픽셀 크기(px 단위, 미지정 시 텍스처 세로 해상도)를 반환하거나 설정합니다.

Returns

number

세로 픽셀 크기 (단위: px)

Set Signature

set pixelSize(value): void

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:149

Parameters

Parameter	Type
value	number

Returns

void

---

---

renderRatioX

Get Signature

readonly get renderRatioX(): number

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:169

텍스처 종횡비와 현재 크기 모드에 따라 산출된 가로 렌더링 스케일 비율을 반환합니다.

Returns

number

가로 렌더링 비율

---

---

renderRatioY

Get Signature

readonly get renderRatioY(): number

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:181

현재 크기 모드에 따라 산출된 세로 렌더링 스케일 비율을 반환합니다.

Returns

number

세로 렌더링 비율

---

---

useBillboard

Get Signature

get useBillboard(): boolean

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:81

카메라를 항상 정면으로 바라보는 빌보드 모드 사용 여부를 반환하거나 설정합니다. (기본값: true)

Returns

boolean

빌보드 모드 활성화 여부

Set Signature

set useBillboard(value): void

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:85

Parameters

Parameter	Type
value	boolean

Returns

void

---

---

usePixelSize

Get Signature

get usePixelSize(): boolean

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:119

카메라 거리와 무관한 화면 고정 픽셀 크기(pixelSize) 모드 사용 여부를 반환하거나 설정합니다. (기본값: false)

Returns

boolean

고정 픽셀 크기 모드 활성화 여부

Set Signature

set usePixelSize(value): void

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:123

Parameters

Parameter	Type
value	boolean

Returns

void

---

---

worldSize

Get Signature

get worldSize(): number

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:101

월드 단위 크기 모드(usePixelSize: false)에서 기준 세로 크기(Unit 단위)를 반환하거나 설정합니다. (기본값: 1)

Returns

number

월드 공간 기준 세로 크기

Set Signature

set worldSize(value): void

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:105

Parameters

Parameter	Type
value	number

Returns

void

---

Methods

---

createCustomMeshVertexShaderModule()

createCustomMeshVertexShaderModule(): GPUShaderModule

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:224

Sprite3D 전용 커스텀 버텍스 셰이더 모듈을 생성합니다.

Returns

GPUShaderModule

생성된 GPUShaderModule 인스턴스

Overrides

Mesh.createCustomMeshVertexShaderModule

---

---

render()

render(renderViewStateData): void

Defined in: src/display/sprites/sprite3D/Sprite3D.ts:193

연결된 텍스처 해상도 변경을 감지하여 렌더링 비율을 갱신하고 스프라이트를 렌더링합니다.

Parameters

Parameter	Type	Description
renderViewStateData	RenderViewStateData	현재 뷰의 렌더링 상태 데이터

Returns

void

Overrides

Mesh.render

---

---

상속받은 속성

상속받은 속성 보기 (클릭하여 확장)

_geometry

_geometry: Geometry | Primitive

Defined in: src/display/mesh/Mesh.ts:301

Inherited from

Mesh._geometry

---

---

_material

_material: any

Defined in: src/display/mesh/Mesh.ts:279

Inherited from

Mesh._material

---

---

animationInfo

animationInfo: object

Defined in: src/display/mesh/core/MeshBase.ts:42

GLTF 모프, 스킨 및 클립 애니메이션 정보입니다.

animationsList

animationsList: ClipAnimState[]

jointBuffer

jointBuffer: IndexBuffer

morphInfo

morphInfo: MorphInfo_GLTF

skinInfo

skinInfo: ParsedSkinInfo_GLTF

weightBuffer

weightBuffer: VertexBuffer

Inherited from

Mesh.animationInfo

---

---

castShadow

castShadow: boolean = false

Defined in: src/display/mesh/Mesh.ts:99

그림자 캐스팅 여부

Inherited from

Mesh.castShadow

---

---

dirtyLOD

dirtyLOD: boolean = false

Defined in: src/display/mesh/Mesh.ts:104

LOD 정보 변경 필요 여부

Inherited from

Mesh.dirtyLOD

---

---

dirtyOpacity

dirtyOpacity: boolean = true

Defined in: src/display/mesh/core/MeshBase.ts:74

불투명도(Opacity) 갱신이 필요한지 여부입니다.

Inherited from

Mesh.dirtyOpacity

---

---

dirtyPipeline

dirtyPipeline: boolean = true

Defined in: src/display/mesh/core/MeshBase.ts:64

렌더 파이프라인 갱신이 필요한지 여부입니다.

Inherited from

Mesh.dirtyPipeline

---

---

dirtyTransform

dirtyTransform: boolean = true

Defined in: src/display/mesh/core/MeshBase.ts:69

트랜스폼 행렬 갱신이 필요한지 여부입니다.

Inherited from

Mesh.dirtyTransform

---

---

disableJitter

disableJitter: boolean

Defined in: src/display/mesh/Mesh.ts:50

TAA 지터(Jitter) 비활성화 여부

Inherited from

Mesh.disableJitter

---

---

gltfLoaderInfo

gltfLoaderInfo: GLTFLoader

Defined in: src/display/mesh/core/MeshBase.ts:59

이 객체를 로드한 GLTFLoader 인스턴스 정보입니다.

Inherited from

Mesh.gltfLoaderInfo

---

---

gpuRenderInfo

gpuRenderInfo: VertexGPURenderInfo

Defined in: src/display/mesh/core/MeshBase.ts:37

GPU 버텍스 렌더링 정보 객체입니다.

Inherited from

Mesh.gpuRenderInfo

---

---

isInstanceofMesh

isInstanceofMesh: boolean

Defined in: src/display/mesh/Mesh.ts:60

Mesh 인스턴스 여부 판별 식별자

Inherited from

Mesh.isInstanceofMesh

---

---

localMatrix

localMatrix: mat4

Defined in: src/display/mesh/core/MeshBase.ts:84

부모 기준 로컬 변환 행렬입니다.

Inherited from

Mesh.localMatrix

---

---

modelMatrix

modelMatrix: mat4

Defined in: src/display/mesh/core/MeshBase.ts:79

월드 변환이 적용된 모델 행렬입니다.

Inherited from

Mesh.modelMatrix

---

---

normalModelMatrix

normalModelMatrix: mat4

Defined in: src/display/mesh/core/MeshBase.ts:89

법선 벡터 변환에 사용되는 노멀 모델 행렬입니다.

Inherited from

Mesh.normalModelMatrix

---

---

passFrustumCulling

passFrustumCulling: boolean = true

Defined in: src/display/mesh/Mesh.ts:109

프러스텀 컬링 통과 여부

Inherited from

Mesh.passFrustumCulling

---

---

receiveShadow

receiveShadow: boolean

Defined in: src/display/mesh/Mesh.ts:45

그림자 수신 여부

Inherited from

Mesh.receiveShadow

---

---

useDisplacementTexture

useDisplacementTexture: boolean

Defined in: src/display/mesh/Mesh.ts:55

변위 텍스처(Displacement Texture) 사용 여부

Inherited from

Mesh.useDisplacementTexture

---

boundingAABB

Get Signature

readonly get boundingAABB(): AABB

Defined in: src/display/mesh/Mesh.ts:751

AABB(Axis-Aligned Bounding Box) 정보를 반환합니다. (Zero-GC 인플레이스 재사용)

Returns

AABB

계산된 AABB 인스턴스

Inherited from

Mesh.boundingAABB

---

---

boundingOBB

Get Signature

readonly get boundingOBB(): OBB

Defined in: src/display/mesh/Mesh.ts:736

OBB(Oriented Bounding Box) 정보를 반환합니다.

Returns

OBB

계산된 OBB 인스턴스

Inherited from

Mesh.boundingOBB

---

---

children

Get Signature

readonly get children(): Mesh[]

Defined in: src/display/mesh/core/Object3DContainer.ts:46

자식 객체 배열을 반환합니다.

Returns

Mesh[]

자식 Mesh 배열 (Mesh[])

Inherited from

Mesh.children

---

---

combinedBoundingAABB

Get Signature

readonly get combinedBoundingAABB(): AABB

Defined in: src/display/mesh/Mesh.ts:771

자식 객체들을 포함한 통합 AABB 정보를 반환합니다.

Returns

AABB

통합된 AABB 인스턴스

Inherited from

Mesh.combinedBoundingAABB

---

---

currentShaderModuleName

Get Signature

get currentShaderModuleName(): string

Defined in: src/display/mesh/core/MeshBase.ts:121

현재 적용된 버텍스 셰이더 모듈의 이름을 가져오거나 설정합니다.

Returns

string

현재 버텍스 셰이더 모듈 이름

Set Signature

set currentShaderModuleName(value): void

Defined in: src/display/mesh/core/MeshBase.ts:125

Parameters

Parameter	Type
value	string

Returns

void

Inherited from

Mesh.currentShaderModuleName

---

---

depthStencilState

Get Signature

readonly get depthStencilState(): DepthStencilState

Defined in: src/display/mesh/core/MeshBase.ts:149

객체의 깊이/스텐실 렌더링 상태(DepthStencilState)를 반환합니다.

Returns

DepthStencilState

DepthStencilState 인스턴스

Inherited from

Mesh.depthStencilState

---

---

drawBufferManager

Get Signature

readonly get drawBufferManager(): DrawBufferManager

Defined in: src/display/mesh/Mesh.ts:234

드로우 버퍼 매니저를 반환합니다.

Returns

DrawBufferManager

DrawBufferManager 인스턴스 또는 null

Inherited from

Mesh.drawBufferManager

---

---

drawCommandSlot

Get Signature

readonly get drawCommandSlot(): DrawCommandSlot

Defined in: src/display/mesh/Mesh.ts:222

드로우 커맨드 슬롯을 반환합니다.

Returns

DrawCommandSlot

DrawCommandSlot 인스턴스 또는 null

Inherited from

Mesh.drawCommandSlot

---

---

drawDebugger

Get Signature

readonly get drawDebugger(): DrawDebuggerMesh

Defined in: src/display/mesh/Mesh.ts:275

디버그 메시 객체를 반환합니다.

Returns

DrawDebuggerMesh

DrawDebuggerMesh 인스턴스

Inherited from

Mesh.drawDebugger

---

---

enableDebugger

Get Signature

get enableDebugger(): boolean

Defined in: src/display/mesh/Mesh.ts:258

디버거 활성화 여부를 가져오거나 설정합니다.

Returns

boolean

디버거 활성화 여부

Set Signature

set enableDebugger(value): void

Defined in: src/display/mesh/Mesh.ts:262

Parameters

Parameter	Type
value	boolean

Returns

void

Inherited from

Mesh.enableDebugger

---

---

enableWaterInteraction

Get Signature

get enableWaterInteraction(): boolean

Defined in: src/display/mesh/Mesh.ts:447

물(Lake)과의 실시간 파동 인터랙션 활성화 여부를 가져오거나 설정합니다.

Returns

boolean

물 파동 인터랙션 활성화 여부

Set Signature

set enableWaterInteraction(value): void

Defined in: src/display/mesh/Mesh.ts:451

Parameters

Parameter	Type
value	boolean

Returns

void

Inherited from

Mesh.enableWaterInteraction

---

---

events

Get Signature

readonly get events(): any

Defined in: src/display/mesh/Mesh.ts:407

등록된 이벤트 맵 객체를 반환합니다.

Returns

any

등록된 이벤트 객체

Inherited from

Mesh.events

---

---

geometry

Get Signature

get geometry(): Geometry | Primitive

Defined in: src/display/mesh/Mesh.ts:311

지오메트리를 가져오거나 설정합니다.

Returns

Geometry | Primitive

Geometry 또는 Primitive 인스턴스

Set Signature

set geometry(value): void

Defined in: src/display/mesh/Mesh.ts:315

Parameters

Parameter	Type
value	Geometry | Primitive

Returns

void

Inherited from

Mesh.geometry

---

---

globalVertexSlotIndex

Get Signature

readonly get globalVertexSlotIndex(): number

Defined in: src/display/mesh/Mesh.ts:210

글로벌 버퍼 슬롯 인덱스를 반환합니다.

Returns

number

글로벌 버텍스 슬롯 인덱스

Inherited from

Mesh.globalVertexSlotIndex

---

---

gpuDevice

Get Signature

readonly get gpuDevice(): GPUDevice

Defined in: src/display/mesh/core/MeshBase.ts:161

현재 인스턴스에 연결된 WebGPU 디바이스를 반환합니다.

Returns

GPUDevice

GPUDevice 인스턴스

Inherited from

Mesh.gpuDevice

---

---

ignoreFrustumCulling

Get Signature

get ignoreFrustumCulling(): boolean

Defined in: src/display/mesh/Mesh.ts:347

프러스텀 컬링 무시 여부를 가져오거나 설정합니다.

Returns

boolean

프러스텀 컬링 무시 여부

Set Signature

set ignoreFrustumCulling(value): void

Defined in: src/display/mesh/Mesh.ts:351

Parameters

Parameter	Type
value	boolean

Returns

void

Inherited from

Mesh.ignoreFrustumCulling

---

---

instanceId

Get Signature

readonly get instanceId(): number

Defined in: src/base/BaseObject.ts:36

클래스별로 순차 부여되는 고유 인스턴스 번호를 반환합니다.

Returns

number

클래스별 고유 인스턴스 번호

Inherited from

Mesh.instanceId

---

---

LODManager

Get Signature

readonly get LODManager(): LODManager

Defined in: src/display/mesh/Mesh.ts:246

LOD(Level of Detail) 매니저를 반환합니다.

Returns

LODManager

LODManager 인스턴스

Inherited from

Mesh.LODManager

---

---

material

Get Signature

get material(): any

Defined in: src/display/mesh/Mesh.ts:289

머티리얼을 가져오거나 설정합니다.

Returns

any

설정된 머티리얼 인스턴스

Set Signature

set material(value): void

Defined in: src/display/mesh/Mesh.ts:293

Parameters

Parameter	Type
value	any

Returns

void

Inherited from

Mesh.material

---

---

minScreenSpaceSize

Get Signature

get minScreenSpaceSize(): number

Defined in: src/display/mesh/Mesh.ts:379

투영 면적 컬링의 화면상 크기 비율 임계값을 가져오거나 설정합니다.

Returns

number

화면상 크기 비율 임계값

Set Signature

set minScreenSpaceSize(value): void

Defined in: src/display/mesh/Mesh.ts:383

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.minScreenSpaceSize

---

---

name

Get Signature

get name(): string

Defined in: src/base/BaseObject.ts:63

객체의 이름을 반환하거나 설정합니다. 미설정 시 기본 이름(ClassName Instance N)을 반환합니다.

Returns

string

객체 이름 문자열

Set Signature

set name(value): void

Defined in: src/base/BaseObject.ts:70

Parameters

Parameter	Type
value	string

Returns

void

Inherited from

Mesh.name

---

---

numChildren

Get Signature

readonly get numChildren(): number

Defined in: src/display/mesh/core/Object3DContainer.ts:58

등록된 자식 객체의 개수를 반환합니다.

Returns

number

자식 객체 개수

Inherited from

Mesh.numChildren

---

---

opacity

Get Signature

get opacity(): number

Defined in: src/display/mesh/Mesh.ts:329

메시의 투명도를 가져오거나 설정합니다 (0~1).

Returns

number

투명도 값 (0~1)

Set Signature

set opacity(value): void

Defined in: src/display/mesh/Mesh.ts:333

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.opacity

---

---

parent

Get Signature

get parent(): Object3DContainer

Defined in: src/display/mesh/Mesh.ts:431

설정된 부모 컨테이너 객체를 가져오거나 설정합니다.

Returns

Object3DContainer

부모 Object3DContainer 인스턴스

Set Signature

set parent(value): void

Defined in: src/display/mesh/Mesh.ts:435

Parameters

Parameter	Type
value	Object3DContainer

Returns

void

Inherited from

Mesh.parent

---

---

pickingId

Get Signature

readonly get pickingId(): number

Defined in: src/display/mesh/Mesh.ts:395

피킹 ID를 반환합니다.

Returns

number

피킹 식별자 값

Inherited from

Mesh.pickingId

---

---

pivotX

Get Signature

get pivotX(): number

Defined in: src/display/mesh/Mesh.ts:496

피벗 X 좌표를 가져오거나 설정합니다.

Returns

number

피벗 X 좌표

Set Signature

set pivotX(value): void

Defined in: src/display/mesh/Mesh.ts:500

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.pivotX

---

---

pivotY

Get Signature

get pivotY(): number

Defined in: src/display/mesh/Mesh.ts:513

피벗 Y 좌표를 가져오거나 설정합니다.

Returns

number

피벗 Y 좌표

Set Signature

set pivotY(value): void

Defined in: src/display/mesh/Mesh.ts:517

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.pivotY

---

---

pivotZ

Get Signature

get pivotZ(): number

Defined in: src/display/mesh/Mesh.ts:530

피벗 Z 좌표를 가져오거나 설정합니다.

Returns

number

피벗 Z 좌표

Set Signature

set pivotZ(value): void

Defined in: src/display/mesh/Mesh.ts:534

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.pivotZ

---

---

position

Get Signature

readonly get position(): Float32Array

Defined in: src/display/mesh/Mesh.ts:598

현재 위치를 반환합니다. [x, y, z]

Returns

Float32Array

위치 배열

Inherited from

Mesh.position

---

---

primitiveState

Get Signature

readonly get primitiveState(): PrimitiveState

Defined in: src/display/mesh/core/MeshBase.ts:137

객체의 프리미티브 렌더링 상태(PrimitiveState)를 반환합니다.

Returns

PrimitiveState

PrimitiveState 인스턴스

Inherited from

Mesh.primitiveState

---

---

redGPUContext

Get Signature

readonly get redGPUContext(): RedGPUContext

Defined in: src/display/mesh/core/MeshBase.ts:173

현재 인스턴스에 연결된 RedGPUContext를 반환합니다.

Returns

RedGPUContext

RedGPUContext 인스턴스

Inherited from

Mesh.redGPUContext

---

---

rotation

Get Signature

readonly get rotation(): Float32Array

Defined in: src/display/mesh/Mesh.ts:724

현재 회전값을 반환합니다. [x, y, z] (도)

Returns

Float32Array

회전값 배열 (도)

Inherited from

Mesh.rotation

---

---

rotationX

Get Signature

get rotationX(): number

Defined in: src/display/mesh/Mesh.ts:673

X축 회전값을 가져오거나 설정합니다 (도).

Returns

number

X축 회전값 (도)

Set Signature

set rotationX(value): void

Defined in: src/display/mesh/Mesh.ts:677

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.rotationX

---

---

rotationY

Get Signature

get rotationY(): number

Defined in: src/display/mesh/Mesh.ts:690

Y축 회전값을 가져오거나 설정합니다 (도).

Returns

number

Y축 회전값 (도)

Set Signature

set rotationY(value): void

Defined in: src/display/mesh/Mesh.ts:694

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.rotationY

---

---

rotationZ

Get Signature

get rotationZ(): number

Defined in: src/display/mesh/Mesh.ts:707

Z축 회전값을 가져오거나 설정합니다 (도).

Returns

number

Z축 회전값 (도)

Set Signature

set rotationZ(value): void

Defined in: src/display/mesh/Mesh.ts:711

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.rotationZ

---

---

scale

Get Signature

readonly get scale(): Float32Array

Defined in: src/display/mesh/Mesh.ts:661

현재 스케일을 반환합니다. [x, y, z]

Returns

Float32Array

스케일 배열

Inherited from

Mesh.scale

---

---

scaleX

Get Signature

get scaleX(): number

Defined in: src/display/mesh/Mesh.ts:610

X축 스케일을 가져오거나 설정합니다.

Returns

number

X축 스케일 값

Set Signature

set scaleX(value): void

Defined in: src/display/mesh/Mesh.ts:614

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.scaleX

---

---

scaleY

Get Signature

get scaleY(): number

Defined in: src/display/mesh/Mesh.ts:627

Y축 스케일을 가져오거나 설정합니다.

Returns

number

Y축 스케일 값

Set Signature

set scaleY(value): void

Defined in: src/display/mesh/Mesh.ts:631

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.scaleY

---

---

scaleZ

Get Signature

get scaleZ(): number

Defined in: src/display/mesh/Mesh.ts:644

Z축 스케일을 가져오거나 설정합니다.

Returns

number

Z축 스케일 값

Set Signature

set scaleZ(value): void

Defined in: src/display/mesh/Mesh.ts:648

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.scaleZ

---

---

useScreenSpaceSizeCulling

Get Signature

get useScreenSpaceSizeCulling(): boolean

Defined in: src/display/mesh/Mesh.ts:363

투영 면적 컬링(Screen Space Size Culling) 사용 여부를 가져오거나 설정합니다.

Returns

boolean

투영 면적 컬링 사용 여부

Set Signature

set useScreenSpaceSizeCulling(value): void

Defined in: src/display/mesh/Mesh.ts:367

Parameters

Parameter	Type
value	boolean

Returns

void

Inherited from

Mesh.useScreenSpaceSizeCulling

---

---

uuid

Get Signature

readonly get uuid(): string

Defined in: src/base/BaseObject.ts:48

객체의 고유 식별자(UUID)를 반환합니다.

Returns

string

객체의 UUID 문자열

Inherited from

Mesh.uuid

---

---

vertexStateBuffers

Get Signature

readonly get vertexStateBuffers(): GPUVertexBufferLayout[]

Defined in: src/display/mesh/Mesh.ts:419

버텍스 상태 버퍼 레이아웃 배열을 반환합니다.

Returns

GPUVertexBufferLayout[]

GPUVertexBufferLayout 배열

Inherited from

Mesh.vertexStateBuffers

---

---

waterWaveStrength

Get Signature

get waterWaveStrength(): number

Defined in: src/display/mesh/Mesh.ts:472

물 파동 생성 강도 배율을 가져오거나 설정합니다 (기본값: 1.0).

Returns

number

물 파동 생성 강도 배율

Set Signature

set waterWaveStrength(value): void

Defined in: src/display/mesh/Mesh.ts:476

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.waterWaveStrength

---

---

x

Get Signature

get x(): number

Defined in: src/display/mesh/Mesh.ts:547

X 위치 좌표를 가져오거나 설정합니다.

Returns

number

X 위치 좌표

Set Signature

set x(value): void

Defined in: src/display/mesh/Mesh.ts:551

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.x

---

---

y

Get Signature

get y(): number

Defined in: src/display/mesh/Mesh.ts:564

Y 위치 좌표를 가져오거나 설정합니다.

Returns

number

Y 위치 좌표

Set Signature

set y(value): void

Defined in: src/display/mesh/Mesh.ts:568

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.y

---

---

z

Get Signature

get z(): number

Defined in: src/display/mesh/Mesh.ts:581

Z 위치 좌표를 가져오거나 설정합니다.

Returns

number

Z 위치 좌표

Set Signature

set z(value): void

Defined in: src/display/mesh/Mesh.ts:585

Parameters

Parameter	Type
value	number

Returns

void

Inherited from

Mesh.z

---

상속받은 메서드

상속받은 메서드 보기 (클릭하여 확장)

addChild()

addChild(child): Mesh

Defined in: src/display/mesh/core/Object3DContainer.ts:89

자식 객체를 컨테이너 끝에 추가합니다.

Parameters

Parameter	Type	Description
child	Mesh	추가할 자식 객체

Returns

Mesh

추가된 자식 객체 (실패 시 null)

Inherited from

Mesh.addChild

---

---

addChildAt()

addChildAt(child, index): Sprite3D

Defined in: src/display/mesh/core/Object3DContainer.ts:115

지정한 인덱스 위치에 자식 객체를 추가합니다.

Parameters

Parameter	Type	Description
child	Mesh	추가할 자식 객체
index	number	삽입할 인덱스 위치

Returns

Sprite3D

현재 컨테이너 인스턴스

Inherited from

Mesh.addChildAt

---

---

addListener()

addListener(eventName, callback): void

Defined in: src/display/mesh/Mesh.ts:888

이벤트 리스너를 추가합니다.

Parameters

Parameter	Type	Description
eventName	string	이벤트 이름
callback	Function	콜백 함수

Returns

void

Inherited from

Mesh.addListener

---

---

clone()

clone(): Mesh

Defined in: src/display/mesh/Mesh.ts:1002

Experimental

메시를 복제합니다.

Returns

Mesh

복제된 Mesh 인스턴스

Inherited from

Mesh.clone

---

---

contains()

contains(child): boolean

Defined in: src/display/mesh/core/Object3DContainer.ts:73

지정한 객체가 현재 컨테이너의 자식인지 확인합니다.

Parameters

Parameter	Type	Description
child	Mesh	확인할 자식 객체

Returns

boolean

포함 여부

Inherited from

Mesh.contains

---

---

createMeshVertexShaderModuleBASIC()

createMeshVertexShaderModuleBASIC(VERTEX_SHADER_MODULE_NAME, SHADER_INFO, UNIFORM_STRUCT_BASIC, vertexModuleSource): GPUShaderModule

Defined in: src/display/mesh/Mesh.ts:1721

기본 메시 버텍스 셰이더 모듈과 유니폼 바인드 그룹을 생성하고 반환합니다.

Parameters

Parameter	Type	Description
VERTEX_SHADER_MODULE_NAME	any	버텍스 셰이더 모듈 이름
SHADER_INFO	any	파싱된 WGSL 셰이더 정보
UNIFORM_STRUCT_BASIC	any	버텍스 유니폼 구조체 정보
vertexModuleSource	any	버텍스 셰이더 WGSL 소스 코드

Returns

GPUShaderModule

생성된 GPUShaderModule 인스턴스

Inherited from

Mesh.createMeshVertexShaderModuleBASIC

---

---

destroy()

destroy(): void

Defined in: src/display/mesh/Mesh.ts:1740

Mesh 인스턴스를 파기하고 할당된 드로우 커맨드 슬롯, 전역 버퍼 슬롯 및 리소스를 즉시 해제합니다.

Returns

void

Inherited from

Mesh.destroy

---

---

getChildAt()

getChildAt(index): Mesh

Defined in: src/display/mesh/core/Object3DContainer.ts:143

지정한 인덱스에 위치한 자식 객체를 반환합니다.

Parameters

Parameter	Type	Description
index	number	조회할 인덱스 위치

Returns

Mesh

해당 위치의 자식 객체 (범위 초과 시 undefined)

Inherited from

Mesh.getChildAt

---

---

getChildIndex()

getChildIndex(child): number

Defined in: src/display/mesh/core/Object3DContainer.ts:163

지정한 자식 객체의 인덱스를 반환합니다.

Parameters

Parameter	Type	Description
child	Mesh	인덱스를 조회할 자식 객체

Returns

number

자식 객체의 인덱스 (존재하지 않으면 -1)

Inherited from

Mesh.getChildIndex

---

---

getCombinedOpacity()

getCombinedOpacity(): number

Defined in: src/display/mesh/Mesh.ts:869

부모 계층을 고려한 통합 투명도를 계산하여 반환합니다.

Returns

number

통합 투명도 값

Inherited from

Mesh.getCombinedOpacity

---

---

getScreenPoint()

getScreenPoint(view): [number, number]

Defined in: src/display/mesh/core/MeshBase.ts:245

지정된 뷰를 기준으로 이 객체의 2D 화면 좌표를 반환합니다.

Example

const screenPos = mesh.getScreenPoint(view3D);

Parameters

Parameter	Type	Description
view	View3D	기준이 되는 View3D 인스턴스

Returns

[number, number]

화면 좌표 [x, y]

Inherited from

Mesh.getScreenPoint

---

---

initGPURenderInfos()

initGPURenderInfos(): void

Defined in: src/display/mesh/Mesh.ts:1687

메시의 GPU 렌더링 정보(VertexGPURenderInfo)를 초기화하고 파이프라인을 갱신합니다.

Returns

void

Inherited from

Mesh.initGPURenderInfos

---

---

localToWorld()

localToWorld(x, y, z): [number, number, number]

Defined in: src/display/mesh/core/MeshBase.ts:225

이 객체의 로컬 공간 좌표를 월드 공간 좌표로 변환합니다.

Example

const worldPos = mesh.localToWorld(0, 1, 0);

Parameters

Parameter	Type	Description
x	number	로컬 X 좌표
y	number	로컬 Y 좌표
z	number	로컬 Z 좌표

Returns

[number, number, number]

변환된 월드 좌표 [x, y, z]

Inherited from

Mesh.localToWorld

---

---

lookAt()

lookAt(targetX, targetY?, targetZ?): void

Defined in: src/display/mesh/Mesh.ts:907

메시가 특정 좌표를 바라보도록 회전시킵니다.

Parameters

Parameter	Type	Description
targetX	number | [number, number, number]	대상 X 좌표 또는 [x, y, z] 배열
targetY?	number	대상 Y 좌표 (targetX가 배열인 경우 무시됨)
targetZ?	number	대상 Z 좌표 (targetX가 배열인 경우 무시됨)

Returns

void

Inherited from

Mesh.lookAt

---

---

removeAllChildren()

removeAllChildren(): Sprite3D

Defined in: src/display/mesh/core/Object3DContainer.ts:309

컨테이너의 모든 자식 객체를 제거합니다.

Returns

Sprite3D

현재 컨테이너 인스턴스

Inherited from

Mesh.removeAllChildren

---

---

removeChild()

removeChild(child): Mesh

Defined in: src/display/mesh/core/Object3DContainer.ts:265

지정한 자식 객체를 컨테이너에서 제거합니다.

Parameters

Parameter	Type	Description
child	Mesh	제거할 자식 객체

Returns

Mesh

제거된 자식 객체

Inherited from

Mesh.removeChild

---

---

removeChildAt()

removeChildAt(index): Mesh

Defined in: src/display/mesh/core/Object3DContainer.ts:290

지정한 인덱스의 자식 객체를 컨테이너에서 제거합니다.

Parameters

Parameter	Type	Description
index	number	제거할 자식 객체의 인덱스

Returns

Mesh

제거된 자식 객체

Throws

해당 인덱스에 자식 객체가 존재하지 않을 경우 Error 발생

Inherited from

Mesh.removeChildAt

---

---

setCastShadowRecursively()

setCastShadowRecursively(value?): void

Defined in: src/display/mesh/Mesh.ts:802

하위 계층의 모든 객체에 그림자 캐스팅 여부를 설정합니다.

Parameters

Parameter	Type	Default value	Description
value?	boolean	false	캐스팅 여부 (기본값: false)

Returns

void

Inherited from

Mesh.setCastShadowRecursively

---

---

setChildIndex()

setChildIndex(child, index): void

Defined in: src/display/mesh/core/Object3DContainer.ts:184

자식 객체의 인덱스 위치를 변경합니다.

Parameters

Parameter	Type	Description
child	Mesh	위치를 변경할 자식 객체
index	number	새로 지정할 인덱스

Returns

void

Inherited from

Mesh.setChildIndex

---

---

setEnableDebuggerRecursively()

setEnableDebuggerRecursively(enableDebugger?): void

Defined in: src/display/mesh/Mesh.ts:783

하위 계층의 모든 객체에 디버거 활성화 여부를 설정합니다.

Parameters

Parameter	Type	Default value	Description
enableDebugger?	boolean	false	활성화 여부 (기본값: false)

Returns

void

Inherited from

Mesh.setEnableDebuggerRecursively

---

---

setIgnoreFrustumCullingRecursively()

setIgnoreFrustumCullingRecursively(value?): void

Defined in: src/display/mesh/Mesh.ts:840

하위 계층의 모든 객체에 프러스텀 컬링 무시 여부를 설정합니다.

Parameters

Parameter	Type	Default value	Description
value?	boolean	false	무시 여부 (기본값: false)

Returns

void

Inherited from

Mesh.setIgnoreFrustumCullingRecursively

---

---

setPosition()

setPosition(x, y?, z?): void

Defined in: src/display/mesh/Mesh.ts:959

위치를 설정합니다.

Parameters

Parameter	Type	Description
x	number	X 좌표
y?	number	Y 좌표 (생략 시 x와 동일)
z?	number	Z 좌표 (생략 시 x와 동일)

Returns

void

Inherited from

Mesh.setPosition

---

---

setReceiveShadowRecursively()

setReceiveShadowRecursively(value?): void

Defined in: src/display/mesh/Mesh.ts:821

하위 계층의 모든 객체에 그림자 수신 여부를 설정합니다.

Parameters

Parameter	Type	Default value	Description
value?	boolean	false	수신 여부 (기본값: false)

Returns

void

Inherited from

Mesh.setReceiveShadowRecursively

---

---

setRotation()

setRotation(rotationX, rotationY?, rotationZ?): void

Defined in: src/display/mesh/Mesh.ts:983

회전값을 설정합니다. (도)

Parameters

Parameter	Type	Description
rotationX	number	X축 회전
rotationY?	number	Y축 회전 (생략 시 rotationX와 동일)
rotationZ?	number	Z축 회전 (생략 시 rotationX와 동일)

Returns

void

Inherited from

Mesh.setRotation

---

---

setScale()

setScale(x, y?, z?): void

Defined in: src/display/mesh/Mesh.ts:935

스케일을 설정합니다.

Parameters

Parameter	Type	Description
x	number	X축 스케일
y?	number	Y축 스케일 (생략 시 x와 동일)
z?	number	Z축 스케일 (생략 시 x와 동일)

Returns

void

Inherited from

Mesh.setScale

---

---

swapChildren()

swapChildren(child1, child2): void

Defined in: src/display/mesh/core/Object3DContainer.ts:213

두 자식 객체의 배열 내 순서(인덱스)를 서로 맞바꿉니다.

Parameters

Parameter	Type	Description
child1	Mesh	첫 번째 자식 객체
child2	Mesh	두 번째 자식 객체

Returns

void

Inherited from

Mesh.swapChildren

---

---

swapChildrenAt()

swapChildrenAt(index1, index2): void

Defined in: src/display/mesh/core/Object3DContainer.ts:239

지정된 두 인덱스에 있는 자식 객체들의 위치를 서로 맞바꿉니다.

Parameters

Parameter	Type	Description
index1	number	첫 번째 인덱스
index2	number	두 번째 인덱스

Returns

void

Inherited from

Mesh.swapChildrenAt

---

---

worldToLocal()

worldToLocal(x, y, z): [number, number, number]

Defined in: src/display/mesh/core/MeshBase.ts:199

월드 공간 좌표를 이 객체의 로컬 공간 좌표로 변환합니다.

Example

const localPos = mesh.worldToLocal(10, 5, 0);

Parameters

Parameter	Type	Description
x	number	월드 X 좌표
y	number	월드 Y 좌표
z	number	월드 Z 좌표

Returns

[number, number, number]

변환된 로컬 좌표 [x, y, z]

Inherited from

Mesh.worldToLocal