Class Sprite2D

2D 스프라이트 렌더링을 위한 클래스

Sprite2D는 2D 게임이나 UI 요소를 렌더링하기 위한 클래스입니다. 평면 지오메트리를 기반으로 하며, 너비와 높이를 동적으로 조절할 수 있습니다

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

See

Hierarchy

BaseSprite2D
- Sprite2D

Index

Constructors

constructor

Properties

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

Constructors

constructor

new Sprite2D(redGPUContext: RedGPUContext, material?: any): Sprite2D
새로운 Sprite2D 인스턴스를 생성합니다.
Parameters
- redGPUContext: RedGPUContext
  RedGPU 렌더링 컨텍스트
- Optionalmaterial: any
  스프라이트에 적용할 머티리얼 (옵션)
Returns Sprite2D
Overrides BaseSprite2D.constructor
- Defined in src/display/sprites/sprite2D/Sprite2D.ts:45

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

rotation

rotation: number & Float32Array<ArrayBufferLike>

rotationZ

rotationZ: number

useDisplacementTexture

useDisplacementTexture: boolean

Accessors

blendMode

get blendMode(): string
Returns string
Inherited from BaseSprite2D.blendMode
- Defined in src/display/mesh/core/mixInMesh2D.ts:22
set blendMode(
    value:
        | "SUBTRACT"
        | "NORMAL"
        | "MULTIPLY"
        | "LIGHTEN"
        | "SCREEN"
        | "LINEAR_DODGE"
        | "DIFFERENCE"
        | "EXCLUSION"
        | Material.BLEND_MODE,
): void
Parameters
- value:
      | "SUBTRACT"
      | "NORMAL"
      | "MULTIPLY"
      | "LIGHTEN"
      | "SCREEN"
      | "LINEAR_DODGE"
      | "DIFFERENCE"
      | "EXCLUSION"
      | Material.BLEND_MODE
Returns void
Inherited from BaseSprite2D.blendMode
- Defined in src/display/mesh/core/mixInMesh2D.ts:30

boundingAABB

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

boundingOBB

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

children

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

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

combinedBoundingAABB

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

currentShaderModuleName

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

depthStencilState

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

drawDebugger

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

enableDebugger

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

events

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

geometry

get geometry(): Geometry | Primitive.Core.Primitive
Returns Geometry | Primitive.Core.Primitive
Inherited from BaseSprite2D.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 BaseSprite2D.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 BaseSprite2D.gpuDevice
- Defined in src/display/mesh/core/MeshBase.ts:94

height

get height(): number
스프라이트의 높이를 반환합니다.

Returns number
현재 높이 값
- Defined in src/display/sprites/sprite2D/Sprite2D.ts:73
set height(value: number): void
스프라이트의 높이를 설정합니다.
Parameters
- value: number
  설정할 높이 값 (양수)
Returns void
Throws
값이 양수가 아닌 경우
- Defined in src/display/sprites/sprite2D/Sprite2D.ts:82

ignoreFrustumCulling

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

material

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

name

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

numChildren

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

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

opacity

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

parent

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

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

pickingId

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

pivotX

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

pivotY

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

pivotZ

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

position

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

primitiveState

get primitiveState(): PrimitiveState
Returns PrimitiveState
Inherited from BaseSprite2D.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 BaseSprite2D.redGPUContext
- Defined in src/display/mesh/core/MeshBase.ts:103

rotationX

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

rotationY

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

scale

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

scaleX

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

scaleY

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

scaleZ

get scaleZ(): number
Returns number
Inherited from BaseSprite2D.scaleZ
- Defined in src/display/mesh/Mesh.ts:313
set scaleZ(value: number): void
Parameters
- value: number
Returns void
Inherited from BaseSprite2D.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 BaseSprite2D.uuid
- Defined in src/display/mesh/core/MeshBase.ts:69

vertexStateBuffers

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

width

get width(): number
스프라이트의 너비를 반환합니다.

Returns number
현재 너비 값
- Defined in src/display/sprites/sprite2D/Sprite2D.ts:54
set width(value: number): void
스프라이트의 너비를 설정합니다.
Parameters
- value: number
  설정할 너비 값 (양수)
Returns void
Throws
값이 양수가 아닌 경우
- Defined in src/display/sprites/sprite2D/Sprite2D.ts:63

x

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

y

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

z

get z(): number
Returns number
Inherited from BaseSprite2D.z
- Defined in src/display/mesh/Mesh.ts:282
set z(value: number): void
Parameters
- value: number
Returns void
Inherited from BaseSprite2D.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 BaseSprite2D.__fireListenerList
- Defined in src/display/mesh/core/MeshBase.ts:124

addChild

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

addChildAt

addChildAt(child: Mesh, index: number): Sprite2D
자식 Mesh를 특정 인덱스에 추가합니다.
Parameters
- child: Mesh
  추가할 자식 객체
- index: number
  삽입 위치
Returns Sprite2D
현재 컨테이너
Inherited from BaseSprite2D.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 BaseSprite2D.addListener
- Defined in src/display/mesh/Mesh.ts:421

clone

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

contains

contains(child: Mesh): boolean
특정 Mesh가 현재 컨테이너에 포함되어 있는지 확인합니다.
Parameters
- child: Mesh
  확인할 자식 객체
Returns boolean
포함 여부
Inherited from BaseSprite2D.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 BaseSprite2D.createMeshVertexShaderModuleBASIC
- Defined in src/display/mesh/Mesh.ts:1067

getChildAt

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

getChildIndex

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

getCombinedOpacity

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

getScreenPoint

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

initGPURenderInfos

initGPURenderInfos(): void
Returns void
Inherited from BaseSprite2D.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 BaseSprite2D.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 BaseSprite2D.lookAt
- Defined in src/display/mesh/Mesh.ts:426

removeAllChildren

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

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

removeChild

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

removeChildAt

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

render

render(renderViewStateData: RenderViewStateData): void
Parameters
- renderViewStateData: RenderViewStateData
Returns void
Inherited from BaseSprite2D.render
- Defined in src/display/mesh/Mesh.ts:486

setCastShadowRecursively

setCastShadowRecursively(castShadow?: boolean): void
Parameters
- castShadow: boolean = false
Returns void
Inherited from BaseSprite2D.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 BaseSprite2D.setChildIndex
- Defined in src/display/mesh/core/Object3DContainer.ts:137

setEnableDebuggerRecursively

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

setPosition

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

setReceiveShadowRecursively

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

setRotation

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

setScale

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

setSize

setSize(width: number, height?: number): void
스프라이트의 크기를 설정합니다.
Parameters
- width: number
  설정할 너비 값
- Optionalheight: number
  설정할 높이 값 (옵션, 생략 시 너비와 같은 값 사용)
Returns void
- Defined in src/display/sprites/sprite2D/Sprite2D.ts:110

swapChildren

swapChildren(child1: Mesh, child2: Mesh): void
두 자식 객체의 위치를 서로 바꿉니다.
Parameters
- child1: Mesh
  첫 번째 객체
- child2: Mesh
  두 번째 객체
Returns void
Inherited from BaseSprite2D.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 BaseSprite2D.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 BaseSprite2D.worldToLocal
- Defined in src/display/mesh/core/MeshBase.ts:107

Class Sprite2D

See

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Sprite2D

Properties

_geometry

_material

animationInfo

castShadow

dirtyOpacity

dirtyPipeline

dirtyTransform

disableJitter

displacementTexture

gltfLoaderInfo

gpuRenderInfo

localMatrix

meshType

modelMatrix

normalModelMatrix

receiveShadow

rotation

rotationZ

useDisplacementTexture

Accessors

blendMode

Returns string

Parameters

Returns void

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

height

Returns number

Parameters

Returns void

Throws

ignoreFrustumCulling

Returns boolean

Parameters

Returns void

material

Returns any

Parameters

Returns void

name

Returns string