Files
cocos4/cocos/rendering/custom/define.ts
T
2025-09-02 18:53:05 +08:00

965 lines
37 KiB
TypeScript

/* eslint-disable @typescript-eslint/ban-ts-comment */
/*
Copyright (c) 2022-2023 Xiamen Yaji Software Co., Ltd.
https://www.cocos.com/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
*/
import { BufferInfo, Buffer, BufferUsageBit, ClearFlagBit, Color, DescriptorSet, LoadOp,
Format, Rect, Sampler, StoreOp, Texture, Viewport, MemoryUsageBit,
UniformBlock,
Device,
} from '../../gfx';
import { ReflectionProbe } from '../../render-scene/scene/reflection-probe';
import { Camera, SkyBoxFlagValue } from '../../render-scene/scene/camera';
import { CSMLevel, ShadowType, Shadows } from '../../render-scene/scene/shadows';
import { Light, LightType } from '../../render-scene/scene/light';
import { DirectionalLight } from '../../render-scene/scene/directional-light';
import { RangedDirectionalLight } from '../../render-scene/scene/ranged-directional-light';
import { PointLight } from '../../render-scene/scene/point-light';
import { SphereLight } from '../../render-scene/scene/sphere-light';
import { SpotLight } from '../../render-scene/scene/spot-light';
import { UBOForwardLightEnum, supportsR32FloatTexture, supportsRGBA16HalfFloatTexture } from '../define';
import { BasicPipeline } from './pipeline';
import {
AttachmentType, LightInfo,
QueueHint, ResourceResidency, SceneFlags, UpdateFrequency,
} from './types';
import { Vec4, geometry, toRadian, cclegacy, RecyclePool } from '../../core';
import { RenderWindow } from '../../render-scene/core/render-window';
import { RasterPass, RenderData, RenderGraph } from './render-graph';
import { WebPipeline } from './web-pipeline';
import { DescriptorSetData, LayoutGraphData } from './layout-graph';
import { AABB } from '../../core/geometry';
import { getUBOTypeCount } from './utils';
import { init } from '.';
const _rangedDirLightBoundingBox = new AABB(0.0, 0.0, 0.0, 0.5, 0.5, 0.5);
const _tmpBoundingBox = new AABB();
// Anti-aliasing type, other types will be gradually added in the future
export enum AntiAliasing {
NONE,
FXAA,
FXAAHQ,
}
export function getRTFormatBeforeToneMapping (ppl: BasicPipeline): Format {
const useFloatOutput = ppl.getMacroBool('CC_USE_FLOAT_OUTPUT');
return ppl.pipelineSceneData.isHDR && useFloatOutput && supportsRGBA16HalfFloatTexture(ppl.device) ? Format.RGBA16F : Format.RGBA8;
}
export function validPunctualLightsCulling (pipeline: BasicPipeline, camera: Camera): void {
const sceneData = pipeline.pipelineSceneData;
const validPunctualLights = sceneData.validPunctualLights;
validPunctualLights.length = 0;
const _sphere = geometry.Sphere.create(0, 0, 0, 1);
const { spotLights } = camera.scene!;
const disableLightmap = camera.node.scene.globals.disableLightmap;
for (let i = 0; i < spotLights.length; i++) {
const light = spotLights[i];
if (light.baked && !disableLightmap) {
continue;
}
geometry.Sphere.set(_sphere, light.position.x, light.position.y, light.position.z, light.range);
if (geometry.intersect.sphereFrustum(_sphere, camera.frustum)) {
validPunctualLights.push(light);
}
}
const { sphereLights } = camera.scene!;
for (let i = 0; i < sphereLights.length; i++) {
const light = sphereLights[i];
if (light.baked && !disableLightmap) {
continue;
}
geometry.Sphere.set(_sphere, light.position.x, light.position.y, light.position.z, light.range);
if (geometry.intersect.sphereFrustum(_sphere, camera.frustum)) {
validPunctualLights.push(light);
}
}
const { pointLights } = camera.scene!;
for (let i = 0; i < pointLights.length; i++) {
const light = pointLights[i];
if (light.baked) {
continue;
}
geometry.Sphere.set(_sphere, light.position.x, light.position.y, light.position.z, light.range);
if (geometry.intersect.sphereFrustum(_sphere, camera.frustum)) {
validPunctualLights.push(light);
}
}
const { rangedDirLights } = camera.scene!;
for (let i = 0; i < rangedDirLights.length; i++) {
const light = rangedDirLights[i];
AABB.transform(_tmpBoundingBox, _rangedDirLightBoundingBox, light.node!.getWorldMatrix());
if (geometry.intersect.aabbFrustum(_tmpBoundingBox, camera.frustum)) {
validPunctualLights.push(light);
}
}
// in jsb, std::vector is not synchronized, so we need to assign it manually
sceneData.validPunctualLights = validPunctualLights;
}
export function getCameraUniqueID (camera: Camera): number {
return camera.cameraId;
}
export function getLoadOpOfClearFlag (clearFlag: ClearFlagBit, attachment: AttachmentType): LoadOp {
let loadOp = LoadOp.CLEAR;
if (!(clearFlag & ClearFlagBit.COLOR)
&& attachment === AttachmentType.RENDER_TARGET) {
if (clearFlag & SkyBoxFlagValue.VALUE) {
loadOp = LoadOp.CLEAR;
} else {
loadOp = LoadOp.LOAD;
}
}
if ((clearFlag & ClearFlagBit.DEPTH_STENCIL) !== ClearFlagBit.DEPTH_STENCIL
&& attachment === AttachmentType.DEPTH_STENCIL) {
if (!(clearFlag & ClearFlagBit.DEPTH)) loadOp = LoadOp.LOAD;
if (!(clearFlag & ClearFlagBit.STENCIL)) loadOp = LoadOp.LOAD;
}
return loadOp;
}
export function getRenderArea (
camera: Camera,
width: number,
height: number,
light: Light | null = null,
level = 0,
out: Rect | undefined = undefined,
): Rect {
out = out || new Rect();
const vp = camera ? camera.viewport : new Rect(0, 0, 1, 1);
const w = width;
const h = height;
out.x = vp.x * w;
out.y = vp.y * h;
out.width = vp.width * w;
out.height = vp.height * h;
if (light) {
switch (light.type) {
case LightType.DIRECTIONAL: {
const mainLight = light as DirectionalLight;
if (mainLight.shadowFixedArea || mainLight.csmLevel === CSMLevel.LEVEL_1) {
out.x = 0;
out.y = 0;
out.width = w;
out.height = h;
} else {
const screenSpaceSignY = cclegacy.director.root.device.capabilities.screenSpaceSignY;
out.x = level % 2 * 0.5 * w;
if (screenSpaceSignY > 0) {
out.y = (1 - Math.floor(level / 2)) * 0.5 * h;
} else {
out.y = Math.floor(level / 2) * 0.5 * h;
}
out.width = 0.5 * w;
out.height = 0.5 * h;
}
break;
}
case LightType.SPOT: {
out.x = 0;
out.y = 0;
out.width = w;
out.height = h;
break;
}
default:
}
}
return out;
}
let shadowPass;
export function buildShadowPass (
passName: Readonly<string>,
ppl: BasicPipeline,
camera: Camera,
light: Light,
level: number,
width: Readonly<number>,
height: Readonly<number>,
): void {
const fboW = width;
const fboH = height;
const area = getRenderArea(camera, width, height, light, level);
width = area.width;
height = area.height;
const device = ppl.device;
const shadowMapName = passName;
if (!ppl.containsResource(shadowMapName)) {
const format = supportsR32FloatTexture(device) ? Format.R32F : Format.RGBA8;
ppl.addRenderTarget(shadowMapName, format, fboW, fboH, ResourceResidency.MANAGED);
ppl.addDepthStencil(`${shadowMapName}Depth`, Format.DEPTH_STENCIL, fboW, fboH, ResourceResidency.MANAGED);
}
ppl.updateRenderTarget(shadowMapName, fboW, fboH);
ppl.updateDepthStencil(`${shadowMapName}Depth`, fboW, fboH);
if (!level) {
shadowPass = ppl.addRenderPass(width, height, 'default');
shadowPass.name = passName;
shadowPass.setViewport(new Viewport(0, 0, fboW, fboH));
shadowPass.addRenderTarget(shadowMapName, LoadOp.CLEAR, StoreOp.STORE, new Color(1, 1, 1, camera.clearColor.w));
shadowPass.addDepthStencil(
`${shadowMapName}Depth`,
LoadOp.CLEAR,
StoreOp.DISCARD,
camera.clearDepth,
camera.clearStencil,
ClearFlagBit.DEPTH_STENCIL,
);
}
const queue = shadowPass.addQueue(QueueHint.RENDER_OPAQUE, 'shadow-caster');
queue.addScene(
camera,
SceneFlags.SHADOW_CASTER | SceneFlags.OPAQUE_OBJECT | SceneFlags.MASK,
).useLightFrustum(light, light.type !== LightType.DIRECTIONAL ? 0 : level);
queue.setViewport(new Viewport(area.x, area.y, area.width, area.height));
}
export function buildReflectionProbePass (
camera: Camera,
ppl: BasicPipeline,
probe: ReflectionProbe,
renderWindow: RenderWindow,
faceIdx: number,
): void {
const cameraName = `Camera${faceIdx}`;
const area = probe.renderArea();
const width = area.x;
const height = area.y;
const probeCamera = probe.camera;
const probePassRTName = `reflectionProbePassColor${cameraName}`;
const probePassDSName = `reflectionProbePassDS${cameraName}`;
if (!ppl.containsResource(probePassRTName)) {
ppl.addRenderWindow(probePassRTName, Format.RGBA8, width, height, renderWindow);
ppl.addDepthStencil(probePassDSName, Format.DEPTH_STENCIL, width, height, ResourceResidency.EXTERNAL);
}
ppl.updateRenderWindow(probePassRTName, renderWindow);
ppl.updateDepthStencil(probePassDSName, width, height);
const probePass = ppl.addRenderPass(width, height, 'default');
probePass.name = `ReflectionProbePass${faceIdx}`;
probePass.setViewport(new Viewport(0, 0, width, height));
probePass.addRenderTarget(
probePassRTName,
getLoadOpOfClearFlag(probeCamera.clearFlag, AttachmentType.RENDER_TARGET),
StoreOp.STORE,
new Color(probeCamera.clearColor.x, probeCamera.clearColor.y, probeCamera.clearColor.z, probeCamera.clearColor.w),
);
probePass.addDepthStencil(
probePassDSName,
getLoadOpOfClearFlag(probeCamera.clearFlag, AttachmentType.DEPTH_STENCIL),
StoreOp.STORE,
probeCamera.clearDepth,
probeCamera.clearStencil,
probeCamera.clearFlag,
);
const passBuilder = probePass.addQueue(QueueHint.RENDER_OPAQUE, 'reflect-map');
const lightInfo = new LightInfo();
lightInfo.probe = probe;
passBuilder.addSceneOfCamera(camera, lightInfo, SceneFlags.REFLECTION_PROBE | SceneFlags.OPAQUE_OBJECT);
updateCameraUBO(passBuilder as unknown as any, probeCamera, ppl);
}
export class ShadowInfo {
shadowEnabled = false;
mainLightShadowNames: string[] = [];
spotLightShadowNames: string[] = [];
validLights: Light[] = [];
reset (): void {
this.shadowEnabled = false;
this.mainLightShadowNames.length = 0;
this.spotLightShadowNames.length = 0;
this.validLights.length = 0;
}
}
export function buildShadowPasses (cameraName: string, camera: Camera, ppl: BasicPipeline): ShadowInfo {
validPunctualLightsCulling(ppl, camera);
const pipeline = ppl;
const shadow = pipeline.pipelineSceneData.shadows;
const validPunctualLights = ppl.pipelineSceneData.validPunctualLights;
shadowInfo.reset();
const shadows = ppl.pipelineSceneData.shadows;
if (!shadow.enabled || shadow.type !== ShadowType.ShadowMap) { return shadowInfo; }
shadowInfo.shadowEnabled = true;
let n = 0;
let m = 0;
for (;n < shadow.maxReceived && m < validPunctualLights.length;) {
const light = validPunctualLights[m];
if (light.type === LightType.SPOT) {
const spotLight = light as SpotLight;
if (spotLight.shadowEnabled) {
shadowInfo.validLights.push(light);
n++;
}
}
m++;
}
const { mainLight } = camera.scene!;
// build shadow map
const mapWidth = shadows.size.x;
const mapHeight = shadows.size.y;
if (mainLight && mainLight.shadowEnabled) {
shadowInfo.mainLightShadowNames[0] = `MainLightShadow${cameraName}`;
if (mainLight.shadowFixedArea) {
buildShadowPass(
shadowInfo.mainLightShadowNames[0],
ppl,
camera,
mainLight,
0,
mapWidth,
mapHeight,
);
} else {
const csmLevel = pipeline.pipelineSceneData.csmSupported ? mainLight.csmLevel : 1;
shadowInfo.mainLightShadowNames[0] = `MainLightShadow${cameraName}`;
for (let i = 0; i < csmLevel; i++) {
buildShadowPass(
shadowInfo.mainLightShadowNames[0],
ppl,
camera,
mainLight,
i,
mapWidth,
mapHeight,
);
}
}
}
for (let l = 0; l < shadowInfo.validLights.length; l++) {
const light = shadowInfo.validLights[l];
const passName = `SpotLightShadow${l.toString()}${cameraName}`;
shadowInfo.spotLightShadowNames[l] = passName;
buildShadowPass(
passName,
ppl,
camera,
light,
0,
mapWidth,
mapHeight,
);
}
return shadowInfo;
}
const shadowInfo = new ShadowInfo();
export function updateCameraUBO (setter: any, camera: Readonly<Camera>, ppl: Readonly<BasicPipeline>): void {
const pipeline = cclegacy.director.root!.pipeline as WebPipeline;
const sceneData = ppl.pipelineSceneData;
const skybox = sceneData.skybox;
// setter.addConstant('CCCamera');
setter.setMat4('cc_matView', camera.matView);
setter.setMat4('cc_matViewInv', camera.node.worldMatrix);
setter.setMat4('cc_matProj', camera.matProj);
setter.setMat4('cc_matProjInv', camera.matProjInv);
setter.setMat4('cc_matViewProj', camera.matViewProj);
setter.setMat4('cc_matViewProjInv', camera.matViewProjInv);
setter.setVec4('cc_cameraPos', new Vec4(camera.position.x, camera.position.y, camera.position.z, pipeline.getCombineSignY()));
// eslint-disable-next-line max-len
setter.setVec4('cc_surfaceTransform', new Vec4(camera.surfaceTransform, 0.0, Math.cos(toRadian(skybox.getRotationAngle())), Math.sin(toRadian(skybox.getRotationAngle()))));
// eslint-disable-next-line max-len
setter.setVec4('cc_screenScale', new Vec4(sceneData.shadingScale, sceneData.shadingScale, 1.0 / sceneData.shadingScale, 1.0 / sceneData.shadingScale));
setter.setVec4('cc_exposure', new Vec4(camera.exposure, 1.0 / camera.exposure, sceneData.isHDR ? 1.0 : 0.0, 1.0 / Camera.standardExposureValue));
}
function bindDescValue (desc: DescriptorSet, binding: number, value): void {
if (value instanceof Buffer) {
desc.bindBuffer(binding, value);
} else if (value instanceof Texture) {
desc.bindTexture(binding, value);
} else if (value instanceof Sampler) {
desc.bindSampler(binding, value);
}
}
function bindGlobalDesc (desc: DescriptorSet, binding: number, value): void {
bindDescValue(desc, binding, value);
}
export function getDescBinding (descId, descData: DescriptorSetData): number {
const layoutData = descData;
// find descriptor binding
for (const block of layoutData.descriptorSetLayoutData.descriptorBlocks) {
for (let i = 0; i !== block.descriptors.length; ++i) {
if (descId === block.descriptors[i].descriptorID) {
return block.offset + i;
}
}
}
return -1;
}
export function getDescBindingFromName (bindingName: string): number {
const pipeline = cclegacy.director.root.pipeline as WebPipeline;
const layoutGraph = pipeline.layoutGraph;
const vertIds = layoutGraph.v();
const descId = layoutGraph.attributeIndex.get(bindingName);
let currDesData: DescriptorSetData;
for (const i of vertIds) {
const layout = layoutGraph.getLayout(i);
const sets = layout.getSets();
for (const [k, descData] of sets) {
const layoutData = descData.descriptorSetLayoutData;
const blocks = layoutData.descriptorBlocks;
for (const b of blocks) {
for (const ds of b.descriptors) {
if (ds.descriptorID === descId) {
currDesData = descData;
return getDescBinding(descId, currDesData);
}
}
}
}
}
return -1;
}
class DescBuffManager {
private buffers: Buffer[] = [];
private currBuffIdx: number = 0;
private device: Device;
public currUniform: Float32Array;
private _root;
constructor (bufferSize: number, numBuffers: number = 2) {
const root = this._root = cclegacy.director.root;
const device = root.device;
this.device = device;
this.currUniform = new Float32Array(bufferSize / 4);
for (let i = 0; i < numBuffers; i++) {
const bufferInfo: BufferInfo = new BufferInfo(
BufferUsageBit.UNIFORM | BufferUsageBit.TRANSFER_DST,
MemoryUsageBit.HOST | MemoryUsageBit.DEVICE,
bufferSize,
bufferSize,
);
this.buffers.push(this.device.createBuffer(bufferInfo));
}
}
getCurrentBuffer (): Buffer {
const { director } = cclegacy;
this.currBuffIdx = director.getTotalFrames() % this.buffers.length;
return this.buffers[this.currBuffIdx];
}
updateData (vals: number[]): void {
this.currUniform.set(vals);
}
updateBuffer (bindId: number, setData: DescriptorSetData): void {
const descriptorSet = setData.descriptorSet!;
const buffer = this.getCurrentBuffer();
buffer.update(this.currUniform);
bindGlobalDesc(descriptorSet, bindId, buffer);
}
}
const buffsMap: Map<string, DescBuffManager> = new Map();
const currBindBuffs: Map<string, number> = new Map();
const layouts: Map<string, DescriptorSetData> = new Map();
export function getDescriptorSetDataFromLayout (layoutName: string): DescriptorSetData | undefined {
const descLayout = layouts.get(layoutName);
if (descLayout) {
return descLayout;
}
const webPip = cclegacy.director.root.pipeline as WebPipeline;
const stageId = webPip.layoutGraph.locateChild(webPip.layoutGraph.N, layoutName);
const layout = webPip.layoutGraph.getLayout(stageId);
const layoutData = layout.getSet(UpdateFrequency.PER_PASS);
layouts.set(layoutName, layoutData!);
return layoutData;
}
export function getDescriptorSetDataFromLayoutId (id: number): DescriptorSetData | undefined {
const webPip = cclegacy.director.root.pipeline as WebPipeline;
const layout = webPip.layoutGraph.getLayout(id);
const layoutData = layout.getSet(UpdateFrequency.PER_PASS);
return layoutData;
}
export function updateGlobalDescBinding (data: RenderData, sceneId: number, idxRD: number, layoutName = 'default'): void {
updatePerPassUBO(layoutName, sceneId, idxRD, data);
}
function getUniformBlock (block: string, layoutName: string): UniformBlock | undefined {
const webPip = cclegacy.director.root.pipeline as WebPipeline;
const lg = webPip.layoutGraph;
const nodeId = lg.locateChild(0xFFFFFFFF, layoutName);
const ppl = lg.getLayout(nodeId);
const layout = ppl.getSet(UpdateFrequency.PER_PASS)!.descriptorSetLayoutData;
const nameID: number = lg.attributeIndex.get(block)!;
return layout.uniformBlocks.get(nameID);
}
function getUniformOffset (uniform: string, block: string, layout: string): number {
const uniformBlock = getUniformBlock(block, layout);
if (!uniformBlock) return -1;
let offset = 0;
for (const currUniform of uniformBlock.members) {
const currCount = getUBOTypeCount(currUniform.type);
if (currUniform.name === uniform) {
return offset;
}
offset += currCount * currUniform.count;
}
return -1;
}
const uniformBlockMap: Map<string, number[]> = new Map();
class ConstantBlockInfo {
offset: number = -1;
buffer: number[] = [];
blockId: number = -1;
}
const constantBlockMap: Map<number, ConstantBlockInfo> = new Map();
function copyToConstantBuffer (target: number[], val: number[], offset: number): boolean {
let isImparity = false;
if (offset < 0 || offset > target.length) {
return isImparity;
}
const length = Math.min(val.length, target.length - offset);
for (let i = 0; i < length; i++) {
if (target[offset + i] !== val[i]) {
target[offset + i] = val[i];
isImparity = true;
}
}
return isImparity;
}
function addConstantBuffer (block: string, layout: string): number[] | null {
let buffers = uniformBlockMap.get(block);
if (buffers) {
return buffers;
}
buffers = [];
const webPip = cclegacy.director.root.pipeline as WebPipeline;
const lg = webPip.layoutGraph;
let currCount = 0;
const currBlock = getUniformBlock(block, layout);
if (!currBlock) return null;
for (const uniform of currBlock.members) {
currCount += getUBOTypeCount(uniform.type) * uniform.count;
}
buffers.length = currCount;
buffers.fill(0);
uniformBlockMap.set(block, buffers);
return buffers;
}
function updateGlobalDescBuffer (descKey: string, vals: number[]): void {
let currDescBuff = buffsMap.get(descKey);
if (!currDescBuff) {
buffsMap.set(descKey, new DescBuffManager(vals.length * 4, 2));
currDescBuff = buffsMap.get(descKey);
}
currDescBuff!.updateData(vals);
}
function updateConstantBlock (
constantBuff: ConstantBlockInfo,
data: number[],
descriptorSetData: DescriptorSetData,
sceneId: number,
idxRD: number,
): void {
const blockId = constantBuff.blockId;
const buffer = constantBuff.buffer;
const isImparity = copyToConstantBuffer(buffer, data, constantBuff.offset);
const bindId = getDescBinding(blockId, descriptorSetData);
const desc = descriptorSetData.descriptorSet!;
if (isImparity || !desc.getBuffer(bindId) && bindId !== -1) {
const descKey = `${blockId}${bindId}${idxRD}${sceneId}`;
currBindBuffs.set(descKey, bindId);
updateGlobalDescBuffer(descKey, buffer);
}
}
function updateDefaultConstantBlock (blockId: number, sceneId: number, idxRD: number, vals: number[], setData: DescriptorSetData): void {
const bindId = getDescBinding(blockId, setData);
if (bindId === -1) { return; }
const descKey = `${blockId}${bindId}${idxRD}${sceneId}`;
currBindBuffs.set(descKey, bindId);
updateGlobalDescBuffer(descKey, vals);
}
export function updatePerPassUBO (layout: string, sceneId: number, idxRD: number, user: RenderData): void {
const { constants, samplers, textures, buffers } = user;
const webPip = cclegacy.director.root.pipeline as WebPipeline;
const lg = webPip.layoutGraph;
const descriptorSetData = getDescriptorSetDataFromLayout(layout)!;
currBindBuffs.clear();
for (const [key, data] of constants) {
let constantBlock = constantBlockMap.get(key);
if (!constantBlock) {
const currMemKey = Array.from(lg.constantIndex).find(([_, v]) => v === key)![0];
for (const [block, blockId] of lg.attributeIndex) {
const constantBuff = addConstantBuffer(block, layout);
if (!constantBuff) continue;
const offset = getUniformOffset(currMemKey, block, layout);
// not found
if (offset === -1) {
// Although the current uniformMem does not belong to the current uniform block,
// it does not mean that it should not be bound to the corresponding descriptor.
updateDefaultConstantBlock(blockId, sceneId, idxRD, constantBuff, descriptorSetData);
continue;
}
constantBlockMap.set(key, new ConstantBlockInfo());
constantBlock = constantBlockMap.get(key)!;
constantBlock.buffer = constantBuff;
constantBlock.blockId = blockId;
constantBlock.offset = offset;
updateConstantBlock(constantBlock, data, descriptorSetData, sceneId, idxRD);
}
} else {
updateConstantBlock(constantBlock, data, descriptorSetData, sceneId, idxRD);
}
}
const descriptorSet = descriptorSetData.descriptorSet!;
for (const [key, value] of textures) {
const bindId = getDescBinding(key, descriptorSetData);
if (bindId === -1) { continue; }
const tex = descriptorSet.getTexture(bindId);
if (value !== tex
// @ts-ignore
|| (!tex.gpuTexture && !(tex.gpuTextureView && tex.gpuTextureView.gpuTexture))) {
bindGlobalDesc(descriptorSet, bindId, value);
}
}
for (const [key, value] of samplers) {
const bindId = getDescBinding(key, descriptorSetData);
if (bindId === -1) { continue; }
const sampler = descriptorSet.getSampler(bindId);
if (sampler !== value) {
bindGlobalDesc(descriptorSet, bindId, value);
}
}
for (const [key, value] of currBindBuffs) {
const buffManager = buffsMap.get(key)!;
buffManager.updateBuffer(value, descriptorSetData);
}
for (const [key, value] of buffers) {
const bindId = getDescBinding(key, descriptorSetData);
if (bindId === -1) { continue; }
const buffer = descriptorSet.getBuffer(bindId);
if (!buffer) {
bindGlobalDesc(descriptorSet, bindId, value);
}
}
}
export function hashCombineKey (val): string {
return `${val}-`;
}
export function hashCombineStr (str: string): number {
// DJB2 HASH
let hash = 0;
for (let i = 0; i < str.length; i++) {
hash = ((hash << 5) - hash) + str.charCodeAt(i);
hash |= 0;// Convert to 32bit integer
}
return hash;
}
export function bool (val): boolean {
return !!val;
}
export function AlignUp (value: number, alignment: number): number {
return (value + (alignment - 1)) & ~(alignment - 1);
}
const kLightMeterScale = 10000;
export function SetLightUBO (
light: Light | null,
bHDR: boolean,
exposure: number,
shadowInfo: Shadows | null,
buffer: Float32Array,
offset: number,
elemSize: number,
): void {
const vec4Array = new Float32Array(4);
let size = 0.0;
let range = 0.0;
let luminanceHDR = 0.0;
let luminanceLDR = 0.0;
if (light && light.type === LightType.SPHERE) {
const sphereLight = light as SphereLight;
vec4Array[0] = sphereLight.position.x;
vec4Array[1] = sphereLight.position.y;
vec4Array[2] = sphereLight.position.z;
vec4Array[3] = LightType.SPHERE;
size = sphereLight.size;
range = sphereLight.range;
luminanceHDR = sphereLight.luminanceHDR;
luminanceLDR = sphereLight.luminanceLDR;
} else if (light && light.type === LightType.SPOT) {
const spotLight = light as SpotLight;
vec4Array[0] = spotLight.position.x;
vec4Array[1] = spotLight.position.y;
vec4Array[2] = spotLight.position.z;
vec4Array[3] = LightType.SPOT;
size = spotLight.size;
range = spotLight.range;
luminanceHDR = spotLight.luminanceHDR;
luminanceLDR = spotLight.luminanceLDR;
} else if (light && light.type === LightType.POINT) {
const pointLight = light as PointLight;
vec4Array[0] = pointLight.position.x;
vec4Array[1] = pointLight.position.y;
vec4Array[2] = pointLight.position.z;
vec4Array[3] = LightType.POINT;
size = 0.0;
range = pointLight.range;
luminanceHDR = pointLight.luminanceHDR;
luminanceLDR = pointLight.luminanceLDR;
} else if (light && light.type === LightType.RANGED_DIRECTIONAL) {
const rangedDirLight = light as RangedDirectionalLight;
vec4Array[0] = rangedDirLight.position.x;
vec4Array[1] = rangedDirLight.position.y;
vec4Array[2] = rangedDirLight.position.z;
vec4Array[3] = LightType.RANGED_DIRECTIONAL;
size = 0.0;
range = 0.0;
luminanceHDR = rangedDirLight.illuminanceHDR;
luminanceLDR = rangedDirLight.illuminanceLDR;
}
let index = offset + UBOForwardLightEnum.LIGHT_POS_OFFSET;
buffer.set(vec4Array, index);
index = offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET;
vec4Array.set([size, range, 0, 0]);
buffer.set(vec4Array, index);
index = offset + UBOForwardLightEnum.LIGHT_COLOR_OFFSET;
const color = light ? light.color : new Color();
if (light && light.useColorTemperature) {
const tempRGB = light.colorTemperatureRGB;
buffer[index++] = color.x * tempRGB.x;
buffer[index++] = color.y * tempRGB.y;
buffer[index++] = color.z * tempRGB.z;
} else {
buffer[index++] = color.x;
buffer[index++] = color.y;
buffer[index++] = color.z;
}
if (bHDR) {
buffer[index] = luminanceHDR * exposure * kLightMeterScale;
} else {
buffer[index] = luminanceLDR;
}
switch (light ? light.type : LightType.UNKNOWN) {
case LightType.SPHERE:
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 2] = 0;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 3] = 0;
break;
case LightType.SPOT: {
const spotLight = light as SpotLight;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 2] = spotLight.spotAngle;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 3] = (shadowInfo && shadowInfo.enabled
&& spotLight.shadowEnabled
&& shadowInfo.type === ShadowType.ShadowMap) ? 1.0 : 0.0;
index = offset + UBOForwardLightEnum.LIGHT_DIR_OFFSET;
const direction = spotLight.direction;
buffer[index++] = direction.x;
buffer[index++] = direction.y;
buffer[index] = direction.z;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 0] = 0;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 1] = 0;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 2] = 0;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 3] = spotLight.angleAttenuationStrength;
} break;
case LightType.POINT:
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 2] = 0;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 3] = 0;
break;
case LightType.RANGED_DIRECTIONAL: {
const rangedDirLight = light as RangedDirectionalLight;
const right = rangedDirLight.right;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 0] = right.x;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 1] = right.y;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 2] = right.z;
buffer[offset + UBOForwardLightEnum.LIGHT_SIZE_RANGE_ANGLE_OFFSET + 3] = 0;
const direction = rangedDirLight.direction;
buffer[offset + UBOForwardLightEnum.LIGHT_DIR_OFFSET + 0] = direction.x;
buffer[offset + UBOForwardLightEnum.LIGHT_DIR_OFFSET + 1] = direction.y;
buffer[offset + UBOForwardLightEnum.LIGHT_DIR_OFFSET + 2] = direction.z;
buffer[offset + UBOForwardLightEnum.LIGHT_DIR_OFFSET + 3] = 0;
const scale = rangedDirLight.scale;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 0] = scale.x * 0.5;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 1] = scale.y * 0.5;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 2] = scale.z * 0.5;
buffer[offset + UBOForwardLightEnum.LIGHT_BOUNDING_SIZE_VS_OFFSET + 3] = 0;
} break;
default:
break;
}
}
export function getSubpassOrPassID (sceneId: number, rg: RenderGraph, lg: LayoutGraphData): number {
const queueId = rg.getParent(sceneId);
const subpassOrPassID = rg.getParent(queueId);
const passId = rg.getParent(subpassOrPassID);
let layoutId = lg.N;
// single render pass
if (passId === rg.N) {
const layoutName: string = rg.getLayout(subpassOrPassID);
layoutId = lg.locateChild(lg.N, layoutName);
} else {
const passLayoutName: string = rg.getLayout(passId);
const passLayoutId = lg.locateChild(lg.N, passLayoutName);
const subpassLayoutName: string = rg.getLayout(subpassOrPassID);
if (subpassLayoutName.length === 0) {
layoutId = passLayoutId;
} else {
const subpassLayoutId = lg.locateChild(passLayoutId, subpassLayoutName);
layoutId = subpassLayoutId;
}
}
return layoutId;
}
export class RenderPassMergeInfo {
constructor (
public combineHash: number = 0,
public needBeginRP: boolean = true,
public needEndRP: boolean = true,
) {}
init (
combineHash: number,
needBeginRP: boolean = true,
needEndRP: boolean = true,
): void {
this.combineHash = combineHash;
this.needBeginRP = needBeginRP;
this.needEndRP = needEndRP;
}
}
const passOrders: RasterPass[] = [];
const rpCombineMap: Map<RasterPass, number> = new Map();
export const rpMergeInfos: Map<RasterPass, RenderPassMergeInfo> = new Map();
const rpMergeInfoPool = new RecyclePool<RenderPassMergeInfo>((): RenderPassMergeInfo => new RenderPassMergeInfo(), 16);
export function resetPassMGState (): void {
rpMergeInfoPool.reset();
rpMergeInfos.clear();
rpCombineMap.clear();
passOrders.length = 0;
}
export function processPassMG (pass: RasterPass): void {
const currCHash = rpCombineMap.get(pass)!;
const currRPInfo = rpMergeInfoPool.add();
if (!rpMergeInfos.has(pass)) {
rpMergeInfos.set(pass, currRPInfo);
}
currRPInfo.init(currCHash);
const poLen = passOrders.length;
if (poLen !== 0) {
let isLoadOP = false;
for (const [_, raster] of pass.rasterViews) {
if (raster.loadOp === LoadOp.LOAD) {
isLoadOP = true;
break;
}
}
const prevPass = passOrders[poLen - 1];
if (isLoadOP && rpCombineMap.get(prevPass) === currCHash) {
const prevInfo = rpMergeInfos.get(prevPass)!;
prevInfo.needEndRP = false;
currRPInfo.needBeginRP = false;
}
}
passOrders.push(pass);
}
export function genHashValue (pass: RasterPass): void {
const hashCodeParts: string[] = [];
const combineHashParts: string[] = [];
for (const [name, raster] of pass.rasterViews) {
const commonParts = [
hashCombineKey(name),
hashCombineKey(raster.slotName),
hashCombineKey(raster.accessType),
hashCombineKey(raster.attachmentType),
hashCombineKey(raster.storeOp),
hashCombineKey(raster.clearFlags),
hashCombineKey(raster.slotID),
hashCombineKey(raster.shaderStageFlags),
];
const extraParts = [
hashCombineKey(raster.loadOp),
hashCombineKey(raster.clearColor.x),
hashCombineKey(raster.clearColor.y),
hashCombineKey(raster.clearColor.z),
hashCombineKey(raster.clearColor.w),
];
const fullHash = commonParts.concat(extraParts).join('');
const combineHash = commonParts.join('');
hashCodeParts.push(fullHash);
combineHashParts.push(combineHash);
}
const subpassGraph = pass.subpassGraph;
const subpasses = subpassGraph._subpasses;
for (const subpass of subpasses) {
const resolvePairs = subpass.resolvePairs;
for (const resolve of resolvePairs) {
const commonParts = [
hashCombineKey(resolve.source),
hashCombineKey(resolve.target),
];
const combineHash = commonParts.join('');
combineHashParts.push(combineHash);
}
}
pass.hashValue = hashCombineStr(hashCodeParts.join(''));
rpCombineMap.set(pass, hashCombineStr(combineHashParts.join('')));
processPassMG(pass);
}