Class LightsManager

Hierarchy (View Summary)

ECSManager<BaseLight>
- LightsManager

Index

Constructors

Properties

_lastNumberOfLights _lastNumberOfShadow ambientLight device lightsUniformGPUBuffer list reNewLightsNumberOfShadow scene shadowArrayOfDepthMapAndMVP shadowIndexID shadowMapTexture ShadowMapUniformGPUBuffer

Methods

add beforUpdate checkDestroy count createlightsUniformGPUBuffer createShadowMapGPUBufferOfMVP createShadowMapRPD createShadowMapUniformGPUBuffer generateShadowMapTexture getAmbientLight getByID getIdAndMatrixIndexByMergeID getLightBindGroupAndBindGroupLayoutByMergeID getLightBindGroupByMergeID getLightByID getLightByMergeID getLightMVP_ByID getLightMVP_ByMergeID getLightNumber getLightNumbers getLightsUniformForSystem getOneByUUID getOneLightMVP_ByID getOneLightMVP_ByMergeID getShadowMapDepthTextureView_ByIdAndMatrixID getShadowMapDepthTextureView_ByMergeID getShadowMapNumber getShadowMapRPDByIdAndSelfIndex getShadowMapUniformForSystem getShdowMapsStructArray gettShadowMapRPD_ByMergeID getUUIDByID remove setAmbientLight update updateAllShadowMapRPD updateLights updateSystemUniformBufferForlights updateSystemUniformOfShadowMap writeToGPUBuffer

Constructors

constructor

new LightsManager(scene: Scene): LightsManager
Parameters
- scene: Scene
Returns LightsManager
Overrides ECSManager.constructor
- Defined in src/we/core/light/lightsManager.ts:153

Properties

_lastNumberOfLights

_lastNumberOfLights: number = 0

*上一帧光源数量，动态增减光源，uniform的光源的GPUBuffer大小会变化，这个值如果与this.lights.length相同，不更新；不同，更新GPUBuffer

_lastNumberOfShadow

_lastNumberOfShadow: number = 0

上一帧shadowmap数量，动态增减光源，uniform的shadowmap的GPUBuffer大小会变化，这个值如果与this.shadowArrayOfDepthMapAndMVP.length相同，不更新；不同，怎更新GPUBuffer

ambientLight

ambientLight: AmbientLight = ...

环境光
1、在PBR中，尽可能小 2、在非PBR，设置在0.01比较合适。原有设定为0.21

device

device: GPUDevice

lightsUniformGPUBuffer

lightsUniformGPUBuffer: GPUBuffer

@group(0) @binding(1) var U_lights : ST_Lights;

所有光源的uniform ,直接生成默认最大光源数的Buffer 对应system.wgsl中的struct ST_Lights scene 的MVP使用中的lights

list

list: BaseLight[] = []

reNewLightsNumberOfShadow

reNewLightsNumberOfShadow: boolean = false

todo：20250105，目前写成固定的

是否动态增加了光源

scene

scene: Scene

shadowArrayOfDepthMapAndMVP

shadowArrayOfDepthMapAndMVP: light_shadowMapMatrix[] = []

光源的shadow map 和 MVP的存储结构在addLight()中动态增加,按照count（1或6）增加

shadowIndexID

shadowIndexID: number = 0

shadowmap数量的计数器：indexID，从0开始 shadowmap的数量不一定和lights的数量对应（一个light可能有多个shadowmap，以及光源是否产生shadowmap） MVP和depth texture使用，根据增加的光源的shadow而自增,从0开始（ GPUOrigin3DDict 的 depthOrArrayLayers）

shadowMapTexture

shadowMapTexture: GPUTexture

@group(0) @binding(3) var U_shadowMap_depth_texture : texture_depth_2d_array;

shadowmap的depth texture texture_depth_2d_array 动态的：根据光源的数量、种类和是否产生shadowmap，动态增加shadowmap的数量

ShadowMapUniformGPUBuffer

ShadowMapUniformGPUBuffer: GPUBuffer

@group(0) @binding(2) var U_shadowMapMatrix : array<ST_shadowMapMatrix,$lightNumberShadowNumber>;

render scene 用的每个 light 的shadow MVP.是uniform的GPUBuffer 对应system.wgsl中的结构 ST_shadowMapMatrix;

Methods

add

add(one: BaseLight, _stage?: string): void
增加光源
Parameters
- one: BaseLight
- Optional_stage: string
Returns void
Overrides ECSManager.add
- Defined in src/we/core/light/lightsManager.ts:255

beforUpdate

beforUpdate(): void
更新所有光源的入口之前的预处理

Returns void
- Defined in src/we/core/light/lightsManager.ts:384

checkDestroy

checkDestroy(): void
Returns void
Inherited from ECSManager.checkDestroy
- Defined in src/we/core/organization/manager.ts:34

count

count(): number
Returns number
Inherited from ECSManager.count
- Defined in src/we/core/organization/manager.ts:42

createlightsUniformGPUBuffer

createlightsUniformGPUBuffer(): GPUBuffer
生成所有光源的MVP，是MVP*lightNumber的大小

Returns GPUBuffer
GPUBuffer
- Defined in src/we/core/light/lightsManager.ts:232

createShadowMapGPUBufferOfMVP

createShadowMapGPUBufferOfMVP(
id: string,
m4?: Float32Array<ArrayBufferLike>,
): GPUBuffer
创建光源的shadow map的uniform buffer（GPUBuffer），渲染shadow map 使用
Parameters
- id: string
  光源的ID
- Optionalm4: Float32Array<ArrayBufferLike>
  光源的MVP
Returns GPUBuffer
光源的shadow map的uniform buffer
- Defined in src/we/core/light/lightsManager.ts:346

createShadowMapRPD

createShadowMapRPD(
shadowIndexID: number,
selfIndex: number,
): GPURenderPassDescriptor
shadow map render RPD 创建shadowMap的RPD,每个MVP对应一个RPD（因为depth textrue 是array）
Parameters
- shadowIndexID: number
- selfIndex: number
  光源的selfIndex，当前位置后的便宜了
Returns GPURenderPassDescriptor
- Defined in src/we/core/light/lightsManager.ts:317

createShadowMapUniformGPUBuffer

createShadowMapUniformGPUBuffer(): GPUBuffer
生成shadow map 的所有光源的MVP，是MVP*lightNumber的大小

1、在scene render 中system uniform 使用：@group(0)@binding(2) var U_shadowMapMatrix

Returns GPUBuffer
GPUBuffer
- Defined in src/we/core/light/lightsManager.ts:219

generateShadowMapTexture

generateShadowMapTexture(layerNumber: number): GPUTexture
生成shadow map 的 texture_depth_2d_array

1、用途两种：
```
 A、render 每个light的 shadow map 的RPD使用     

 B、scene render的system uniform 使用，@group(0)@binding(3) var U_shadowMap_depth_texture
```
2、目前是使用固定光源数量*6的最大array（point light 需要6个depth texture）

3、后期更改为动态
Parameters
- layerNumber: number
Returns GPUTexture
GPUTexture
- Defined in src/we/core/light/lightsManager.ts:192

getAmbientLight

getAmbientLight(): AmbientLight
Returns AmbientLight
- Defined in src/we/core/light/lightsManager.ts:250

getByID

getByID(id: number): undefined | BaseLight
Parameters
- id: number
Returns undefined | BaseLight
Inherited from ECSManager.getByID
- Defined in src/we/core/organization/manager.ts:13

getIdAndMatrixIndexByMergeID

getIdAndMatrixIndexByMergeID(
mergeUUID: string,
): { id: number; matrixIndex: number }
获取光源的ID和matrixIndex，根据mergeID
Parameters
- mergeUUID: string
  光源的mergeID：由光源的ID，和matrixIndex组成
Returns { id: number; matrixIndex: number }
光源的ID和matrixIndex
- Defined in src/we/core/light/lightsManager.ts:664

getLightBindGroupAndBindGroupLayoutByMergeID

getLightBindGroupAndBindGroupLayoutByMergeID(
mergeID: string,
): I_bindGroupAndGroupLayout
目前使用的模式，shadow map render 生成光源shadowmap渲染的bindGroup和bindGroupLayout
Parameters
- mergeID: string
Returns I_bindGroupAndGroupLayout
GPUBindGroup, GPUBindGroupLayout
- Defined in src/we/core/light/lightsManager.ts:726

getLightBindGroupByMergeID

getLightBindGroupByMergeID(
mergeID: string,
pipeline: GPURenderPipeline,
): GPUBindGroup
目前的版本没有采用，shadow map render 根据pipeline auto 模式生产BindGroup
Parameters
- mergeID: string
- pipeline: GPURenderPipeline
Returns GPUBindGroup
GPUBindGroup
- Defined in src/we/core/light/lightsManager.ts:688

getLightByID

getLightByID(id: number): boolean | BaseLight
获取当前光源的index的MVP get light by id
Parameters
- id: number
Returns boolean | BaseLight
- Defined in src/we/core/light/lightsManager.ts:632

getLightByMergeID

getLightByMergeID(mergeID: string): boolean | BaseLight
Parameters
- mergeID: string
Returns boolean | BaseLight
- Defined in src/we/core/light/lightsManager.ts:640

getLightMVP_ByID

getLightMVP_ByID(id: number, matrix_index: number): Float32Array
待检查：20250918，这个应该是从light中取的，目前来看是一个从this.shadowArrayOfDepthMapAndMVP[] 获取当前光源的index的MVP
Parameters
- id: number
- matrix_index: number
Returns Float32Array
- Defined in src/we/core/light/lightsManager.ts:606

getLightMVP_ByMergeID

getLightMVP_ByMergeID(mergeID: string): Float32Array
获取当前光源的MVP
Parameters
- mergeID: string
  光源的合并ID
Returns Float32Array
光源的MVP
- Defined in src/we/core/light/lightsManager.ts:619

getLightNumber

getLightNumber(): number
Returns number
- Defined in src/we/core/light/lightsManager.ts:142

getLightNumbers

getLightNumbers(): number
获取光源数量

Returns number
number
- Defined in src/we/core/light/lightsManager.ts:546

getLightsUniformForSystem

getLightsUniformForSystem(): GPUBuffer
获取光源的uniform buffer（GPUBuffer） system camera 使用:@group(0) @binding(1) var U_lights : ST_Lights;

Returns GPUBuffer
光源的uniform buffer
- Defined in src/we/core/light/lightsManager.ts:565

getOneByUUID

getOneByUUID(UUID: string): null | BaseLight
Parameters
- UUID: string
Returns null | BaseLight
Inherited from ECSManager.getOneByUUID
- Defined in src/we/core/organization/manager.ts:45

getOneLightMVP_ByID

getOneLightMVP_ByID(id: number, matrixIndex: number): false | GPUBuffer
获取光源的shadow map 的MVP
Parameters
- id: number
  string, light id
- matrixIndex: number
  number, 光源的矩阵index，0-5，点光源有6个shadow map
Returns false | GPUBuffer
GPUBuffer | false
- Defined in src/we/core/light/lightsManager.ts:590

getOneLightMVP_ByMergeID

getOneLightMVP_ByMergeID(mergeID: string): false | GPUBuffer
Parameters
- mergeID: string
Returns false | GPUBuffer
- Defined in src/we/core/light/lightsManager.ts:580

getShadowMapDepthTextureView_ByIdAndMatrixID

getShadowMapDepthTextureView_ByIdAndMatrixID(
id: number,
matrixIndex: number,
): GPUTextureView
获取shadowMap的depth texture view，根据ID和matrixIndex
Parameters
- id: number
  光源的ID
- matrixIndex: number
  光源的selfIndex
Returns GPUTextureView
光源的shadow map的depth texture view
- Defined in src/we/core/light/lightsManager.ts:806

getShadowMapDepthTextureView_ByMergeID

getShadowMapDepthTextureView_ByMergeID(mergeID: string): GPUTextureView
获取shadowMap的depth texture view，根据mergeID
Parameters
- mergeID: string
  光源的mergeID：由光源的ID，和matrixIndex组成
Returns GPUTextureView
光源的shadow map的depth texture view
- Defined in src/we/core/light/lightsManager.ts:796

getShadowMapNumber

getShadowMapNumber(): number
Returns number
- Defined in src/we/core/light/lightsManager.ts:175

getShadowMapRPDByIdAndSelfIndex

getShadowMapRPDByIdAndSelfIndex(
id: number,
matrixIndex: number,
): false | GPURenderPassDescriptor
获取shadowMap的RPD，
Parameters
- id: number
  光源的ID
- matrixIndex: number
  光源的selfIndex
Returns false | GPURenderPassDescriptor
GPURenderPassDescriptor | false
- Defined in src/we/core/light/lightsManager.ts:845

getShadowMapUniformForSystem

getShadowMapUniformForSystem(): GPUBuffer
获取光源的shadow map的uniform buffer（GPUBuffer） system camera 使用:@group(0) @binding(2) var U_shadowMapMatrix : array<ST_shadowMapMatrix,$lightNumberShadowNumber>;

Returns GPUBuffer
光源的shadow map的uniform buffer
- Defined in src/we/core/light/lightsManager.ts:557

getShdowMapsStructArray

getShdowMapsStructArray(): light_shadowMapMatrix[]
获取shadowmap的结构数组 BaseEntity 调用此函数

Returns light_shadowMapMatrix[]
light_shadowMapMatrix[]
- Defined in src/we/core/light/lightsManager.ts:572

gettShadowMapRPD_ByMergeID

gettShadowMapRPD_ByMergeID(mergeID: string): false | GPURenderPassDescriptor
获取shadowMap的RPD，
Parameters
- mergeID: string
Returns false | GPURenderPassDescriptor
GPURenderPassDescriptor | false
- Defined in src/we/core/light/lightsManager.ts:835

getUUIDByID

getUUIDByID(id: number): string
获取当前光源的UUID
Parameters
- id: number
  光源的ID
Returns string
光源的UUID
- Defined in src/we/core/light/lightsManager.ts:650

remove

remove(entity: BaseLight, scendValue?: any): void
Parameters
- entity: BaseLight
- OptionalscendValue: any
Returns void
Inherited from ECSManager.remove
- Defined in src/we/core/organization/manager.ts:28

setAmbientLight

setAmbientLight(values: IV_AmbientLight): void
Parameters
- values: IV_AmbientLight
Returns void
- Defined in src/we/core/light/lightsManager.ts:245

update

update(clock: Clock): void
更新所有光源的入口
Parameters
- clock: Clock
Returns void
Overrides ECSManager.update
- Defined in src/we/core/light/lightsManager.ts:390

updateAllShadowMapRPD

updateAllShadowMapRPD(): void
更新所有光源的storageGPUBuffer(uniform ),MVP,RPD

Returns void
- Defined in src/we/core/light/lightsManager.ts:299

updateLights

updateLights(clock: Clock): void
更新所有光源参数
Parameters
- clock: Clock
Returns void
- Defined in src/we/core/light/lightsManager.ts:398

updateSystemUniformBufferForlights

updateSystemUniformBufferForlights(): Promise<GPUBuffer>
更新所有光源在主渲染过程中的system uniform 的GPUBuffe 在WGSL是一个struct ，参见“system.wgsl”中的 ST_Lights结构。

Returns Promise<GPUBuffer>
光源的GPUBuffer,大小=16 + 16 +(this.list.length ||1) * lightStructSize,
- Defined in src/we/core/light/lightsManager.ts:408

updateSystemUniformOfShadowMap

updateSystemUniformOfShadowMap(): GPUBuffer
1、更新所有光源的shadow map的uniform :@group(0)@binding(2) var U_shadowMapMatrix 2、同步更新每个光源生成shadow map用的MVP

Returns GPUBuffer
- Defined in src/we/core/light/lightsManager.ts:470

writeToGPUBuffer

writeToGPUBuffer(m4: Float32Array, oneGPUBuffer: GPUBuffer): void
写入MVP到GPUBuffer
Parameters
- m4: Float32Array
  光源的MVP
- oneGPUBuffer: GPUBuffer
  光源的shadow map的uniform buffer
Returns void
- Defined in src/we/core/light/lightsManager.ts:517

Class LightsManager

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns LightsManager

Properties

_lastNumberOfLights

_lastNumberOfShadow

ambientLight

device

lightsUniformGPUBuffer

list

reNewLightsNumberOfShadow

scene

shadowArrayOfDepthMapAndMVP

shadowIndexID

shadowMapTexture

ShadowMapUniformGPUBuffer

Methods

add

Parameters

Returns void

beforUpdate

Returns void

checkDestroy

Returns void

count

Returns number

createlightsUniformGPUBuffer

Returns GPUBuffer

createShadowMapGPUBufferOfMVP

Parameters

Returns GPUBuffer

createShadowMapRPD

Parameters

Returns GPURenderPassDescriptor

createShadowMapUniformGPUBuffer

Returns GPUBuffer

generateShadowMapTexture

Parameters

Returns GPUTexture

getAmbientLight

Returns AmbientLight

getByID

Parameters

Returns undefined | BaseLight

getIdAndMatrixIndexByMergeID

Parameters

Returns { id: number; matrixIndex: number }

getLightBindGroupAndBindGroupLayoutByMergeID

Parameters

Returns I_bindGroupAndGroupLayout

getLightBindGroupByMergeID

Parameters

Returns GPUBindGroup

getLightByID

Parameters

Returns boolean | BaseLight

getLightByMergeID

Parameters

Returns boolean | BaseLight

getLightMVP_ByID

Parameters

Returns Float32Array

getLightMVP_ByMergeID

Parameters

Returns Float32Array

getLightNumber

Returns number

getLightNumbers

Returns number

getLightsUniformForSystem

Returns GPUBuffer

getOneByUUID

Parameters