RedGPU API / RedGPU / Display / SpriteSheet2D

Class: SpriteSheet2D

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:37

2D 공간에서 격자형 텍스처 프레임을 순차 재생하는 2D 스프라이트 시트 클래스입니다.

텍스처의 가로/세로 세그먼트 분할 크기에 맞춰 렌더링 픽셀 크기가 자동으로 계산됩니다.

Example

typescript

const info = new RedGPU.Display.SpriteSheetInfo(redGPUContext, 'sheet.png', 5, 3, 15, 0);
const spriteSheet = new RedGPU.Display.SpriteSheet2D(redGPUContext, info);
scene.addChild(spriteSheet);

See

Extends

BaseSpriteSheet2D

Constructors

Constructor

new SpriteSheet2D(redGPUContext, spriteSheetInfo): SpriteSheet2D

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:58

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

Example

typescript

const info = new RedGPU.Display.SpriteSheetInfo(redGPUContext, 'sheet.png', 5, 3, 15, 0);
const spriteSheet = new RedGPU.Display.SpriteSheet2D(redGPUContext, info);

Parameters

Parameter	Type	Description
`redGPUContext`	`RedGPUContext`	RedGPUContext 인스턴스
`spriteSheetInfo`	`SpriteSheetInfo`	스프라이트 시트 애니메이션 정보 객체

Returns

SpriteSheet2D

Overrides

BaseSpriteSheet2D.constructor

Properties

Accessors

geometry

Get Signature

get geometry(): Geometry | Primitive

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:110

고정된 Plane 지오메트리를 반환합니다. 외부에서 변경할 수 없습니다.

Returns

Geometry | Primitive

지오메트리 인스턴스

Set Signature

set geometry(value): void

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:114

현재 지오메트리를 반환합니다. 지오메트리 변경 시도는 에러를 발생시킵니다.

Parameters

Parameter	Type
`value`	`Geometry` \| `Primitive`

Returns

void

지오메트리 인스턴스

Overrides

BaseSpriteSheet2D.geometry

height

Get Signature

readonly get height(): number

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:98

단일 프레임 세그먼트의 픽셀 높이를 반환합니다.

Returns

number

세그먼트 높이 (픽셀 단위)

material

Get Signature

get material(): any

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:126

고정된 내부 머티리얼을 반환합니다. 외부에서 변경할 수 없습니다.

Returns

any

머티리얼 인스턴스

Set Signature

set material(value): void

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:130

현재 머티리얼을 반환합니다. 머티리얼 변경 시도는 에러를 발생시킵니다.

Parameters

Parameter	Type
`value`	`any`

Returns

void

머티리얼 인스턴스

Overrides

BaseSpriteSheet2D.material

width

Get Signature

readonly get width(): number

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:86

단일 프레임 세그먼트의 픽셀 너비를 반환합니다.

Returns

number

세그먼트 너비 (픽셀 단위)

Methods

createCustomMeshVertexShaderModule()

createCustomMeshVertexShaderModule(): GPUShaderModule

Defined in: src/display/sprites/spriteSheets/spriteSheet2D/SpriteSheet2D.ts:142

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

Returns

GPUShaderModule

생성된 GPUShaderModule 인스턴스

Overrides

BaseSpriteSheet2D.createCustomMeshVertexShaderModule

상속받은 속성

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

_geometry

_geometry: Geometry | Primitive

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

Inherited from

BaseSpriteSheet2D._geometry

_material

_material: any

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

Inherited from

BaseSpriteSheet2D._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

BaseSpriteSheet2D.animationInfo

castShadow

castShadow: boolean = false

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

그림자 캐스팅 여부

Inherited from

BaseSpriteSheet2D.castShadow

currentIndex

currentIndex: number

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:39

현재 프레임 인덱스

Inherited from

BaseSpriteSheet2D.currentIndex

dirtyLOD

dirtyLOD: boolean = false

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

LOD 정보 변경 필요 여부

Inherited from

BaseSpriteSheet2D.dirtyLOD

dirtyOpacity

dirtyOpacity: boolean = true

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

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

Inherited from

BaseSpriteSheet2D.dirtyOpacity

dirtyPipeline

dirtyPipeline: boolean = true

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

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

Inherited from

BaseSpriteSheet2D.dirtyPipeline

dirtyTransform

dirtyTransform: boolean = true

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

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

Inherited from

BaseSpriteSheet2D.dirtyTransform

disableJitter

disableJitter: boolean

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

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

Inherited from

BaseSpriteSheet2D.disableJitter

gltfLoaderInfo

gltfLoaderInfo: GLTFLoader

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

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

Inherited from

BaseSpriteSheet2D.gltfLoaderInfo

gpuRenderInfo

gpuRenderInfo: VertexGPURenderInfo

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

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

Inherited from

BaseSpriteSheet2D.gpuRenderInfo

isInstanceofMesh

isInstanceofMesh: boolean

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

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

Inherited from

BaseSpriteSheet2D.isInstanceofMesh

localMatrix

localMatrix: mat4

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

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

Inherited from

BaseSpriteSheet2D.localMatrix

modelMatrix

modelMatrix: mat4

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

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

Inherited from

BaseSpriteSheet2D.modelMatrix

normalModelMatrix

normalModelMatrix: mat4

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

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

Inherited from

BaseSpriteSheet2D.normalModelMatrix

passFrustumCulling

passFrustumCulling: boolean = true

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

프러스텀 컬링 통과 여부

Inherited from

BaseSpriteSheet2D.passFrustumCulling

receiveShadow

receiveShadow: boolean

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

그림자 수신 여부

Inherited from

BaseSpriteSheet2D.receiveShadow

rotation

rotation: number & Float32Array<ArrayBufferLike>

Defined in: src/display/mesh/core/mixInMesh2D.ts:106

Inherited from

BaseSpriteSheet2D.rotation

rotationZ

rotationZ: number

Defined in: src/display/mesh/core/mixInMesh2D.ts:16

Z축 회전값 (도 단위)

Inherited from

BaseSpriteSheet2D.rotationZ

segmentH

segmentH: number

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:29

세로 세그먼트 분할 수

Inherited from

BaseSpriteSheet2D.segmentH

segmentW

segmentW: number

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:24

가로 세그먼트 분할 수

Inherited from

BaseSpriteSheet2D.segmentW

totalFrame

totalFrame: number

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:34

총 프레임 수

Inherited from

BaseSpriteSheet2D.totalFrame

useDisplacementTexture

useDisplacementTexture: boolean

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

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

Inherited from

BaseSpriteSheet2D.useDisplacementTexture

blendMode

Get Signature

get blendMode(): string

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

2D 객체의 블렌드 모드를 가져오거나 설정합니다.

Returns

string

현재 적용된 블렌드 모드 키 문자열

Set Signature

set blendMode(value): void

Defined in: src/display/mesh/core/mixInMesh2D.ts:81

Parameters

Parameter	Type
`value`	`"NORMAL"` \| `"SUBTRACT"` \| `"MULTIPLY"` \| `"LIGHTEN"` \| `"SCREEN"` \| `"LINEAR_DODGE"` \| `"DIFFERENCE"` \| `"EXCLUSION"` \| `BLEND_MODE`

Returns

void

Inherited from

BaseSpriteSheet2D.blendMode

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.boundingOBB

children

Get Signature

readonly get children(): Mesh[]

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

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

Returns

Mesh[]

자식 Mesh 배열 (Mesh[])

Inherited from

BaseSpriteSheet2D.children

combinedBoundingAABB

Get Signature

readonly get combinedBoundingAABB(): AABB

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

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

Returns

AABB

통합된 AABB 인스턴스

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.currentShaderModuleName

depthStencilState

Get Signature

readonly get depthStencilState(): DepthStencilState

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

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

Returns

DepthStencilState

DepthStencilState 인스턴스

Inherited from

BaseSpriteSheet2D.depthStencilState

drawBufferManager

Get Signature

readonly get drawBufferManager(): DrawBufferManager

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

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

Returns

DrawBufferManager

DrawBufferManager 인스턴스 또는 null

Inherited from

BaseSpriteSheet2D.drawBufferManager

drawCommandSlot

Get Signature

readonly get drawCommandSlot(): DrawCommandSlot

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

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

Returns

DrawCommandSlot

DrawCommandSlot 인스턴스 또는 null

Inherited from

BaseSpriteSheet2D.drawCommandSlot

drawDebugger

Get Signature

readonly get drawDebugger(): DrawDebuggerMesh

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

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

Returns

DrawDebuggerMesh

DrawDebuggerMesh 인스턴스

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.enableWaterInteraction

events

Get Signature

readonly get events(): any

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

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

Returns

any

등록된 이벤트 객체

Inherited from

BaseSpriteSheet2D.events

frameRate

Get Signature

get frameRate(): number

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:131

초당 프레임 수(FPS)를 반환하거나 설정합니다. 음수 입력 시 0으로 보정됩니다.

Returns

number

초당 프레임 수 (FPS)

Set Signature

set frameRate(value): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:135

Parameters

Parameter	Type
`value`	`number`

Returns

void

Inherited from

BaseSpriteSheet2D.frameRate

globalVertexSlotIndex

Get Signature

readonly get globalVertexSlotIndex(): number

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

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

Returns

number

글로벌 버텍스 슬롯 인덱스

Inherited from

BaseSpriteSheet2D.globalVertexSlotIndex

gpuDevice

Get Signature

readonly get gpuDevice(): GPUDevice

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

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

Returns

GPUDevice

GPUDevice 인스턴스

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.ignoreFrustumCulling

instanceId

Get Signature

readonly get instanceId(): number

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

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

Returns

number

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

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.LODManager

loop

Get Signature

get loop(): boolean

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:115

애니메이션 반복 재생 여부를 반환하거나 설정합니다.

Returns

boolean

반복 재생 여부

Set Signature

set loop(value): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:119

Parameters

Parameter	Type
`value`	`boolean`

Returns

void

Inherited from

BaseSpriteSheet2D.loop

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.name

numChildren

Get Signature

readonly get numChildren(): number

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

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

Returns

number

자식 객체 개수

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.parent

pickingId

Get Signature

readonly get pickingId(): number

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

피킹 ID를 반환합니다.

Returns

number

피킹 식별자 값

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.pivotZ

position

Get Signature

readonly get position(): Float32Array

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

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

Returns

Float32Array

위치 배열

Inherited from

BaseSpriteSheet2D.position

primitiveState

Get Signature

readonly get primitiveState(): PrimitiveState

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

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

Returns

PrimitiveState

PrimitiveState 인스턴스

Inherited from

BaseSpriteSheet2D.primitiveState

redGPUContext

Get Signature

readonly get redGPUContext(): RedGPUContext

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

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

Returns

RedGPUContext

RedGPUContext 인스턴스

Inherited from

BaseSpriteSheet2D.redGPUContext

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.rotationY

scale

Get Signature

readonly get scale(): Float32Array

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

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

Returns

Float32Array

스케일 배열

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.scaleZ

spriteSheetInfo

Get Signature

get spriteSheetInfo(): SpriteSheetInfo

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:184

적용된 스프라이트 시트 정보를 반환하거나 설정합니다.

Returns

SpriteSheetInfo

SpriteSheetInfo 인스턴스

Set Signature

set spriteSheetInfo(value): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:188

Parameters

Parameter	Type
`value`	`SpriteSheetInfo`

Returns

void

Inherited from

BaseSpriteSheet2D.spriteSheetInfo

state

Get Signature

readonly get state(): string

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:103

현재 애니메이션 재생 상태를 반환합니다.

Returns

string

재생 상태 문자열 ('play', 'pause', 'stop')

Inherited from

BaseSpriteSheet2D.state

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

BaseSpriteSheet2D.useScreenSpaceSizeCulling

uuid

Get Signature

readonly get uuid(): string

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

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

Returns

string

객체의 UUID 문자열

Inherited from

BaseSpriteSheet2D.uuid

vertexStateBuffers

Get Signature

readonly get vertexStateBuffers(): GPUVertexBufferLayout[]

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

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

Returns

GPUVertexBufferLayout[]

GPUVertexBufferLayout 배열

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.addChild

addChildAt()

addChildAt(child, index): SpriteSheet2D

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

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

Parameters

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

Returns

SpriteSheet2D

현재 컨테이너 인스턴스

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.addListener

clone()

clone(): Mesh

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

Experimental

메시를 복제합니다.

Returns

Mesh

복제된 Mesh 인스턴스

Inherited from

BaseSpriteSheet2D.clone

contains()

contains(child): boolean

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

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

Parameters

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

Returns

boolean

포함 여부

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.createMeshVertexShaderModuleBASIC

destroy()

destroy(): void

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

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

Returns

void

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.getChildIndex

getCombinedOpacity()

getCombinedOpacity(): number

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

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

Returns

number

통합 투명도 값

Inherited from

BaseSpriteSheet2D.getCombinedOpacity

getScreenPoint()

getScreenPoint(view): [number, number]

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

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

Example

typescript

const screenPos = mesh.getScreenPoint(view3D);

Parameters

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

Returns

[number, number]

화면 좌표 [x, y]

Inherited from

BaseSpriteSheet2D.getScreenPoint

initGPURenderInfos()

initGPURenderInfos(): void

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

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

Returns

void

Inherited from

BaseSpriteSheet2D.initGPURenderInfos

localToWorld()

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

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

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

Example

typescript

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.lookAt

pause()

pause(): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:214

현재 프레임에서 애니메이션을 일시정지하고 상태를 'pause'로 변경합니다.

Returns

void

Inherited from

BaseSpriteSheet2D.pause

play()

play(): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:204

애니메이션 재생을 시작하고 상태를 'play'로 변경합니다.

Returns

void

Inherited from

BaseSpriteSheet2D.play

removeAllChildren()

removeAllChildren(): SpriteSheet2D

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

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

Returns

SpriteSheet2D

현재 컨테이너 인스턴스

Inherited from

BaseSpriteSheet2D.removeAllChildren

removeChild()

removeChild(child): Mesh

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

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

Parameters

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

Returns

Mesh

제거된 자식 객체

Inherited from

BaseSpriteSheet2D.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

BaseSpriteSheet2D.removeChildAt

render()

render(renderViewStateData): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:237

경과 시간에 따라 현재 프레임 인덱스를 갱신하고 스프라이트 시트를 렌더링합니다.

Parameters

Parameter	Type	Description
`renderViewStateData`	`RenderViewStateData`	뷰 렌더링 상태 데이터

Returns

void

Inherited from

BaseSpriteSheet2D.render

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.setIgnoreFrustumCullingRecursively

setPosition()

2D 객체의 X, Y 위치를 설정합니다. y를 생략하면 x와 동일한 값으로 설정됩니다.

Param

X축 좌표

Param

Y축 좌표 (생략 시 x 값 적용)

Call Signature

setPosition(x, y?): void

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

Parameters

Parameter	Type
`x`	`number`
`y?`	`number`

Returns

void

Inherited from

BaseSpriteSheet2D.setPosition

Call Signature

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.setReceiveShadowRecursively

setRotation()

2D 객체의 회전 각도(도 단위)를 설정합니다.

Param

value

회전 각도 (도 단위)

Call Signature

setRotation(value): void

Defined in: src/display/mesh/core/mixInMesh2D.ts:157

Parameters

Parameter	Type
`value`	`number`

Returns

void

Inherited from

BaseSpriteSheet2D.setRotation

Call Signature

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

BaseSpriteSheet2D.setRotation

setScale()

2D 객체의 X, Y 스케일을 설정합니다. y를 생략하면 x와 동일한 값으로 설정됩니다.

Param

X축 스케일

Param

Y축 스케일 (생략 시 x 값 적용)

Call Signature

setScale(x, y?): void

Defined in: src/display/mesh/core/mixInMesh2D.ts:126

Parameters

Parameter	Type
`x`	`number`
`y?`	`number`

Returns

void

Inherited from

BaseSpriteSheet2D.setScale

Call Signature

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

BaseSpriteSheet2D.setScale

stop()

stop(): void

Defined in: src/display/sprites/spriteSheets/core/ASpriteSheet.ts:223

애니메이션을 정지하고 첫 번째 프레임(0)으로 초기화한 뒤 상태를 'stop'으로 변경합니다.

Returns

void

Inherited from

BaseSpriteSheet2D.stop

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

BaseSpriteSheet2D.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

BaseSpriteSheet2D.swapChildrenAt

worldToLocal()

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

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

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

Example

typescript

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

BaseSpriteSheet2D.worldToLocal

📁 Interfaces

📁 Functions

📁 Interfaces

📁 Type Aliases

📁 Functions

📁 Interfaces

📁 Interfaces

Class: SpriteSheet2D ​

Example ​

See ​

Extends ​

Constructors ​

Constructor ​

Example ​

Parameters ​

Returns ​

Overrides ​

Properties ​

Accessors ​

geometry ​

Get Signature ​

Returns ​

Set Signature ​

Class: SpriteSheet2D

Example

See

Extends

Constructors

Constructor

Example

Parameters

Returns

Overrides

Properties

Accessors

geometry

Get Signature

Returns

Set Signature