RedGPU API / RedGPU / Display / SpriteSheet2D

Class: SpriteSheet2D

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

2D 스프라이트 시트 애니메이션 클래스입니다.

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);

아래는 SpriteSheet2D의 구조와 동작을 이해하는 데 도움이 되는 추가 샘플 예제 목록입니다.

See

SpriteSheet2D MouseEvent example

Extends

BaseSpriteSheet2D

Constructors

Constructor

new SpriteSheet2D(redGPUContext, spriteSheetInfo): SpriteSheet2D

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

새로운 SpriteSheet2D 인스턴스를 생성합니다.

Parameters

Parameter	Type	Description
`redGPUContext`	`RedGPUContext`	RedGPU 렌더링 컨텍스트
`spriteSheetInfo`	`SpriteSheetInfo`	스프라이트 시트 정보 객체 (텍스처, 세그먼트 정보, 애니메이션 설정 포함)

Returns

SpriteSheet2D

Overrides

BaseSpriteSheet2D.constructor

Properties

_geometry

_geometry: Geometry | Primitive

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

Inherited from

BaseSpriteSheet2D._geometry

_material

_material: any

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

Inherited from

BaseSpriteSheet2D._material

animationInfo

animationInfo: object

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

animationsList

animationsList: GLTFParsedSingleClip[]

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:93

그림자 캐스팅 여부

Inherited from

BaseSpriteSheet2D.castShadow

currentIndex

currentIndex: number

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

현재 프레임 인덱스

Inherited from

BaseSpriteSheet2D.currentIndex

dirtyLOD

dirtyLOD: boolean = false

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

LOD 정보 변경 필요 여부

Inherited from

BaseSpriteSheet2D.dirtyLOD

dirtyOpacity

dirtyOpacity: boolean = true

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

Inherited from

BaseSpriteSheet2D.dirtyOpacity

dirtyPipeline

dirtyPipeline: boolean = true

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

Inherited from

BaseSpriteSheet2D.dirtyPipeline

dirtyTransform

dirtyTransform: boolean = true

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

Inherited from

BaseSpriteSheet2D.dirtyTransform

disableJitter

disableJitter: boolean

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

Inherited from

BaseSpriteSheet2D.disableJitter

displacementTexture

displacementTexture: BitmapTexture

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

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

Inherited from

BaseSpriteSheet2D.displacementTexture

gltfLoaderInfo

gltfLoaderInfo: GLTFLoader

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

Inherited from

BaseSpriteSheet2D.gltfLoaderInfo

gpuRenderInfo

gpuRenderInfo: VertexGPURenderInfo

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

Inherited from

BaseSpriteSheet2D.gpuRenderInfo

localMatrix

localMatrix: mat4

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

Inherited from

BaseSpriteSheet2D.localMatrix

meshType

meshType: string

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

Inherited from

BaseSpriteSheet2D.meshType

modelMatrix

modelMatrix: mat4

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

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

Inherited from

BaseSpriteSheet2D.modelMatrix

normalModelMatrix

normalModelMatrix: mat4

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

Inherited from

BaseSpriteSheet2D.normalModelMatrix

passFrustumCulling

passFrustumCulling: boolean = true

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

프러스텀 컬링 통과 여부

Inherited from

BaseSpriteSheet2D.passFrustumCulling

receiveShadow

receiveShadow: boolean

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

Inherited from

BaseSpriteSheet2D.receiveShadow

rotation

rotation: number & Float32Array<ArrayBufferLike>

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

Inherited from

BaseSpriteSheet2D.rotation

rotationZ

rotationZ: number

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

Inherited from

BaseSpriteSheet2D.rotationZ

segmentH

segmentH: number

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

세그먼트 높이

Inherited from

BaseSpriteSheet2D.segmentH

segmentW

segmentW: number

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

세그먼트 너비

Inherited from

BaseSpriteSheet2D.segmentW

totalFrame

totalFrame: number

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

총 프레임 수

Inherited from

BaseSpriteSheet2D.totalFrame

useDisplacementTexture

useDisplacementTexture: boolean

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

Inherited from

BaseSpriteSheet2D.useDisplacementTexture

Accessors

blendMode

Get Signature

get blendMode(): string

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

Returns

string

Set Signature

set blendMode(value): void

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

Parameters

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

Returns

void

Inherited from

BaseSpriteSheet2D.blendMode

boundingAABB

Get Signature

get boundingAABB(): AABB

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

AABB(Axis-Aligned Bounding Box) 정보를 반환합니다.

Returns

AABB

Inherited from

BaseSpriteSheet2D.boundingAABB

boundingOBB

Get Signature

get boundingOBB(): OBB

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

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

Returns

OBB

Inherited from

BaseSpriteSheet2D.boundingOBB

children

Get Signature

get children(): Mesh[]

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

현재 컨테이너에 포함된 자식 Mesh 배열을 반환합니다.

Returns

Mesh[]

자식 객체 배열

Inherited from

BaseSpriteSheet2D.children

combinedBoundingAABB

Get Signature

get combinedBoundingAABB(): AABB

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

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

Returns

AABB

Inherited from

BaseSpriteSheet2D.combinedBoundingAABB

currentShaderModuleName

Get Signature

get currentShaderModuleName(): string

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

Returns

string

Set Signature

set currentShaderModuleName(value): void

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

Parameters

Parameter	Type
`value`	`string`

Returns

void

Inherited from

BaseSpriteSheet2D.currentShaderModuleName

depthStencilState

Get Signature

get depthStencilState(): DepthStencilState

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

Returns

DepthStencilState

Inherited from

BaseSpriteSheet2D.depthStencilState

drawDebugger

Get Signature

get drawDebugger(): DrawDebuggerMesh

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

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

Returns

DrawDebuggerMesh

Inherited from

BaseSpriteSheet2D.drawDebugger

enableDebugger

Get Signature

get enableDebugger(): boolean

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

디버거 활성화 여부를 반환합니다.

Returns

boolean

Set Signature

set enableDebugger(value): void

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

디버거 활성화 여부를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`boolean`	활성화 여부

Returns

void

Inherited from

BaseSpriteSheet2D.enableDebugger

events

Get Signature

get events(): any

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

등록된 이벤트들을 반환합니다.

Returns

any

Inherited from

BaseSpriteSheet2D.events

frameRate

Get Signature

get frameRate(): number

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

애니메이션 프레임 레이트를 반환합니다.

Returns

number

초당 프레임 수 (FPS)

Set Signature

set frameRate(value): void

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

애니메이션 프레임 레이트를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	초당 프레임 수 (음수인 경우 0으로 설정)

Returns

void

Inherited from

BaseSpriteSheet2D.frameRate

geometry

Get Signature

get geometry(): Geometry | Primitive

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

지오메트리를 반환합니다. SpriteSheet2D는 Plane으로 고정됩니다.

Returns

Geometry | Primitive

현재 지오메트리

Set Signature

set geometry(value): void

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

SpriteSheet2D는 지오메트리를 변경할 수 없습니다.

Throws

지오메트리 변경 시도 시 Error 발생

Parameters

Parameter	Type	Description
`value`	`Geometry` \| `Primitive`	설정하려는 지오메트리

Returns

void

Overrides

BaseSpriteSheet2D.geometry

gpuDevice

Get Signature

get gpuDevice(): GPUDevice

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

Retrieves the GPU device associated with the current instance.

Returns

GPUDevice

The GPU device.

Inherited from

BaseSpriteSheet2D.gpuDevice

height

Get Signature

get height(): number

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

스프라이트 시트 세그먼트의 높이를 반환합니다. (텍스처 전체 높이를 세그먼트 수로 나눈 값)

Returns

number

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

ignoreFrustumCulling

Get Signature

get ignoreFrustumCulling(): boolean

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

프러스텀 컬링 무시 여부를 반환합니다.

Returns

boolean

Set Signature

set ignoreFrustumCulling(value): void

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

프러스텀 컬링 무시 여부를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`boolean`	무시 여부

Returns

void

Inherited from

BaseSpriteSheet2D.ignoreFrustumCulling

LODManager

Get Signature

get LODManager(): LODManager

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

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:122

반복 재생 여부를 반환합니다.

Returns

boolean

반복 재생 활성화 여부

Set Signature

set loop(value): void

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

반복 재생 여부를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`boolean`	반복 재생 활성화 여부

Returns

void

Inherited from

BaseSpriteSheet2D.loop

material

Get Signature

get material(): any

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

머티리얼을 반환합니다.

Returns

any

현재 머티리얼

Set Signature

set material(value): void

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

SpriteSheet2D는 머티리얼을 변경할 수 없습니다.

Throws

머티리얼 변경 시도 시 Error 발생

Parameters

Parameter	Type	Description
`value`	`any`	설정하려는 머티리얼

Returns

void

Overrides

BaseSpriteSheet2D.material

name

Get Signature

get name(): string

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

메시의 이름을 반환합니다.

Returns

string

Set Signature

set name(value): void

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

메시의 이름을 설정합니다.

Parameters

Parameter	Type	Description
`value`	`string`	메시 이름

Returns

void

Inherited from

BaseSpriteSheet2D.name

numChildren

Get Signature

get numChildren(): number

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

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

Returns

number

자식 수

Inherited from

BaseSpriteSheet2D.numChildren

opacity

Get Signature

get opacity(): number

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

메시의 투명도를 반환합니다. (0~1)

Returns

number

Set Signature

set opacity(value): void

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

메시의 투명도를 설정합니다. (0~1)

Parameters

Parameter	Type	Description
`value`	`number`	투명도 값

Returns

void

Inherited from

BaseSpriteSheet2D.opacity

parent

Get Signature

get parent(): Object3DContainer

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

설정된 부모 객체를 반환합니다.

Returns

Object3DContainer

Set Signature

set parent(value): void

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

부모 객체를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`Object3DContainer`	부모 컨테이너

Returns

void

Inherited from

BaseSpriteSheet2D.parent

pickingId

Get Signature

get pickingId(): number

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

피킹 ID를 반환합니다.

Returns

number

Inherited from

BaseSpriteSheet2D.pickingId

pivotX

Get Signature

get pivotX(): number

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

피벗 X 좌표를 반환합니다.

Returns

number

Set Signature

set pivotX(value): void

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

피벗 X 좌표를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	X 좌표

Returns

void

Inherited from

BaseSpriteSheet2D.pivotX

pivotY

Get Signature

get pivotY(): number

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

피벗 Y 좌표를 반환합니다.

Returns

number

Set Signature

set pivotY(value): void

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

피벗 Y 좌표를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	Y 좌표

Returns

void

Inherited from

BaseSpriteSheet2D.pivotY

pivotZ

Get Signature

get pivotZ(): number

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

피벗 Z 좌표를 반환합니다.

Returns

number

Set Signature

set pivotZ(value): void

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

피벗 Z 좌표를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	Z 좌표

Returns

void

Inherited from

BaseSpriteSheet2D.pivotZ

position

Get Signature

get position(): Float32Array

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

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

Returns

Float32Array

위치 배열

Inherited from

BaseSpriteSheet2D.position

primitiveState

Get Signature

get primitiveState(): PrimitiveState

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

Returns

PrimitiveState

Inherited from

BaseSpriteSheet2D.primitiveState

redGPUContext

Get Signature

get redGPUContext(): RedGPUContext

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

Retrieves the RedGPUContext instance.

Returns

RedGPUContext

The RedGPUContext instance.

Inherited from

BaseSpriteSheet2D.redGPUContext

rotationX

Get Signature

get rotationX(): number

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

X축 회전값을 반환합니다. (도)

Returns

number

Set Signature

set rotationX(value): void

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

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

Parameters

Parameter	Type	Description
`value`	`number`	회전값

Returns

void

Inherited from

BaseSpriteSheet2D.rotationX

rotationY

Get Signature

get rotationY(): number

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

Y축 회전값을 반환합니다. (도)

Returns

number

Set Signature

set rotationY(value): void

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

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

Parameters

Parameter	Type	Description
`value`	`number`	회전값

Returns

void

Inherited from

BaseSpriteSheet2D.rotationY

scale

Get Signature

get scale(): Float32Array

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

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

Returns

Float32Array

Inherited from

BaseSpriteSheet2D.scale

scaleX

Get Signature

get scaleX(): number

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

X축 스케일을 반환합니다.

Returns

number

Set Signature

set scaleX(value): void

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

X축 스케일을 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	스케일 값

Returns

void

Inherited from

BaseSpriteSheet2D.scaleX

scaleY

Get Signature

get scaleY(): number

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

Y축 스케일을 반환합니다.

Returns

number

Set Signature

set scaleY(value): void

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

Y축 스케일을 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	스케일 값

Returns

void

Inherited from

BaseSpriteSheet2D.scaleY

scaleZ

Get Signature

get scaleZ(): number

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

Z축 스케일을 반환합니다.

Returns

number

Set Signature

set scaleZ(value): void

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

Z축 스케일을 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	스케일 값

Returns

void

Inherited from

BaseSpriteSheet2D.scaleZ

spriteSheetInfo

Get Signature

get spriteSheetInfo(): SpriteSheetInfo

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

스프라이트 시트 정보를 반환합니다.

Returns

SpriteSheetInfo

현재 스프라이트 시트 정보

Set Signature

set spriteSheetInfo(value): void

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

스프라이트 시트 정보를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`SpriteSheetInfo`	새로운 스프라이트 시트 정보

Returns

void

Inherited from

BaseSpriteSheet2D.spriteSheetInfo

state

Get Signature

get state(): string

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

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

Returns

string

'play', 'pause', 'stop' 중 하나

Inherited from

BaseSpriteSheet2D.state

uuid

Get Signature

get uuid(): string

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

Retrieves the UUID of the object.

Returns

string

The UUID of the object.

Inherited from

BaseSpriteSheet2D.uuid

vertexStateBuffers

Get Signature

get vertexStateBuffers(): GPUVertexBufferLayout[]

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

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

Returns

GPUVertexBufferLayout[]

Inherited from

BaseSpriteSheet2D.vertexStateBuffers

width

Get Signature

get width(): number

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

스프라이트 시트 세그먼트의 너비를 반환합니다. (텍스처 전체 너비를 세그먼트 수로 나눈 값)

Returns

number

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

x

Get Signature

get x(): number

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

X 위치 좌표를 반환합니다.

Returns

number

Set Signature

set x(value): void

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

X 위치 좌표를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	X 좌표

Returns

void

Inherited from

BaseSpriteSheet2D.x

y

Get Signature

get y(): number

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

Y 위치 좌표를 반환합니다.

Returns

number

Set Signature

set y(value): void

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

Y 위치 좌표를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	Y 좌표

Returns

void

Inherited from

BaseSpriteSheet2D.y

z

Get Signature

get z(): number

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

Z 위치 좌표를 반환합니다.

Returns

number

Set Signature

set z(value): void

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

Z 위치 좌표를 설정합니다.

Parameters

Parameter	Type	Description
`value`	`number`	Z 좌표

Returns

void

Inherited from

BaseSpriteSheet2D.z

Methods

__fireListenerList()

__fireListenerList(resetList?): void

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

Fires the dirty listeners list.

Parameters

Parameter	Type	Default value	Description
`resetList?`	`boolean`	`false`	Indicates whether to reset the dirty listeners list after firing.

Returns

void

Inherited from

BaseSpriteSheet2D.__fireListenerList

addChild()

addChild(child): Mesh

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

자식 Mesh를 컨테이너에 추가합니다.

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:87

자식 Mesh를 특정 인덱스에 추가합니다.

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:897

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

Parameters

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

Returns

void

Inherited from

BaseSpriteSheet2D.addListener

clone()

clone(): Mesh

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

Experimental

메시를 복제합니다.

Returns

Mesh

복제된 Mesh 인스턴스

Inherited from

BaseSpriteSheet2D.clone

contains()

contains(child): boolean

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

특정 Mesh가 현재 컨테이너에 포함되어 있는지 확인합니다.

Parameters

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

Returns

boolean

포함 여부

Inherited from

BaseSpriteSheet2D.contains

createCustomMeshVertexShaderModule()

createCustomMeshVertexShaderModule(): GPUShaderModule

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

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

2D 스프라이트 시트 렌더링에 최적화된 버텍스 셰이더를 생성하며, UV 좌표 계산과 프레임 인덱싱 로직이 포함되어 있습니다.

Returns

GPUShaderModule

생성된 GPU 셰이더 모듈

Overrides

BaseSpriteSheet2D.createCustomMeshVertexShaderModule

createMeshVertexShaderModuleBASIC()

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

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

Parameters

Parameter	Type
`VERTEX_SHADER_MODULE_NAME`	`any`
`SHADER_INFO`	`any`
`UNIFORM_STRUCT_BASIC`	`any`
`vertexModuleSource`	`any`

Returns

GPUShaderModule

Inherited from

BaseSpriteSheet2D.createMeshVertexShaderModuleBASIC

getChildAt()

getChildAt(index): Mesh

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

지정된 인덱스의 자식 Mesh를 반환합니다.

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:123

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

Parameters

Parameter	Type	Description
`child`	`Mesh`	조회할 자식 객체

Returns

number

인덱스 또는 -1

Inherited from

BaseSpriteSheet2D.getChildIndex

getCombinedOpacity()

getCombinedOpacity(): number

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

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

Returns

number

통합 투명도 값

Inherited from

BaseSpriteSheet2D.getCombinedOpacity

getScreenPoint()

getScreenPoint(view): [number, number]

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

Parameters

Parameter	Type
`view`	`View3D`

Returns

[number, number]

Inherited from

BaseSpriteSheet2D.getScreenPoint

initGPURenderInfos()

initGPURenderInfos(): void

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

Returns

void

Inherited from

BaseSpriteSheet2D.initGPURenderInfos

localToWorld()

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

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

Parameters

Parameter	Type
`x`	`number`
`y`	`number`
`z`	`number`

Returns

[number, number, number]

Inherited from

BaseSpriteSheet2D.localToWorld

lookAt()

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

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

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

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:227

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

Returns

void

Inherited from

BaseSpriteSheet2D.pause

play()

play(): void

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

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

Returns

void

Inherited from

BaseSpriteSheet2D.play

removeAllChildren()

removeAllChildren(): SpriteSheet2D

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

모든 자식 객체를 제거합니다.

Returns

SpriteSheet2D

현재 컨테이너

Inherited from

BaseSpriteSheet2D.removeAllChildren

removeChild()

removeChild(child): Mesh

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

특정 자식 객체를 제거합니다.

Parameters

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

Returns

Mesh

제거된 객체

Inherited from

BaseSpriteSheet2D.removeChild

removeChildAt()

removeChildAt(index): Mesh

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

지정된 인덱스의 자식 객체를 제거합니다.

Parameters

Parameter	Type	Description
`index`	`number`	제거할 위치

Returns

Mesh

제거된 객체

Inherited from

BaseSpriteSheet2D.removeChildAt

render()

render(renderViewStateData): void

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

스프라이트 시트를 렌더링합니다.

시간에 따른 프레임 업데이트와 애니메이션 로직을 처리한 후 렌더링을 수행합니다.

Parameters

Parameter	Type	Description
`renderViewStateData`	`RenderViewStateData`	렌더링 상태 및 디버그 정보

Returns

void

Inherited from

BaseSpriteSheet2D.render

setCastShadowRecursively()

setCastShadowRecursively(value?): void

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

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

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:138

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

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:807

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

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:861

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

Parameters

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

Returns

void

Inherited from

BaseSpriteSheet2D.setIgnoreFrustumCullingRecursively

setPosition()

Call Signature

setPosition(x, y?): void

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

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:966

위치를 설정합니다.

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:843

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

Parameters

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

Returns

void

Inherited from

BaseSpriteSheet2D.setReceiveShadowRecursively

setRotation()

Call Signature

setRotation(value): void

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

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:989

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

Parameters

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

Returns

void

Inherited from

BaseSpriteSheet2D.setRotation

setScale()

Call Signature

setScale(x, y?): void

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

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:943

스케일을 설정합니다.

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:236

애니메이션을 정지합니다. 상태를 'stop'으로 변경하고 첫 번째 프레임으로 되돌립니다.

Returns

void

Inherited from

BaseSpriteSheet2D.stop

swapChildren()

swapChildren(child1, child2): void

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

두 자식 객체의 위치를 서로 바꿉니다.

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:181

두 인덱스의 자식 객체 위치를 서로 바꿉니다.

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:113

Parameters

Parameter	Type
`x`	`number`
`y`	`number`
`z`	`number`

Returns

[number, number, number]

Inherited from

BaseSpriteSheet2D.worldToLocal

Core

classes

Core

classes

CoreGroup

classes

CoreInstancingMesh

classes

CoreMesh

classes

functions

CoreSkyBox

classes

CoreSpriteSheet

classes

CoreTextField

classes

CoreView

classes

Core

classes

Core

classes

functions

mat3

functions

mat4

functions

quat

functions

variables

vec2

functions

vec3

functions

vec4

functions

RapierPhysics

classes

Core

classes

functions

Core

classes

functions

Core

classes

CoreBuffer

classes

functions

CoreIBL

classes

CoreNoiseTexture

classes

functions

CoreVertexBuffer

classes

CoreWGSLParser

classes

functions

Class: SpriteSheet2D ​

Example ​

See ​

Extends ​

Constructors ​

Constructor ​

Parameters ​

Returns ​

Overrides ​

Properties ​

_geometry ​

Inherited from ​

_material ​

Inherited from ​

animationInfo ​

Class: SpriteSheet2D

Example

See

Extends

Constructors

Constructor

Parameters

Returns

Overrides

Properties

_geometry

Inherited from

_material

Inherited from

animationInfo