mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-20 23:52:40 +08:00
509d73b27d
* PR1: add explicit function return type (#15311) * PR4: add explicit function return type (#15314) * [ci skip][AUTO]: Automated code generating update: 8843bfe54cd3f8e6f84432948716c8d130ecb233 (#15314) (#15357) Co-authored-by: cocos-robot <cocos-robot@cocos.com> * add function return type * fix version checking * fix return type --------- Co-authored-by: Cocos Robot <48829427+cocos-robot@users.noreply.github.com> Co-authored-by: cocos-robot <cocos-robot@cocos.com>
124 lines
5.0 KiB
TypeScript
124 lines
5.0 KiB
TypeScript
/*
|
|
Copyright (c) 2020-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 { MeshRenderer } from '../framework/mesh-renderer';
|
|
import { Mesh } from '../assets/mesh';
|
|
import { Mat4 } from '../../core';
|
|
import { Node } from '../../scene-graph/node';
|
|
|
|
function checkMaterialisSame (comp1: MeshRenderer, comp2: MeshRenderer): boolean {
|
|
const matNum = comp1.sharedMaterials.length;
|
|
if (matNum !== comp2.sharedMaterials.length) {
|
|
return false;
|
|
}
|
|
for (let i = 0; i < matNum; i++) {
|
|
if (comp1.getRenderMaterial(i) !== comp2.getRenderMaterial(i)) {
|
|
return false;
|
|
}
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @en Utility for 3d model static batching
|
|
* @zh 服务于 3D 模型静态合批的工具类
|
|
*/
|
|
export class BatchingUtility {
|
|
/**
|
|
* @en
|
|
* Collect the Models under `staticModelRoot`,
|
|
* merge all the meshes statically into one (while disabling each component),
|
|
* and attach it to a new Model on `batchedRoot`.
|
|
* The world transform of each model is guaranteed to be preserved.
|
|
*
|
|
* For a more fine-grained control over the process, use `Mesh.merge` directly.
|
|
* @zh
|
|
* 在`staticModelRoot`下收集模型。
|
|
* 将所有的网格静态地合并成一个(同时禁用每个组件)。
|
|
* 并将其附加到 `batchedRoot` 上的一个新模型。
|
|
* 每个模型的世界变换都被保证保留下来。
|
|
* 如果要对这个过程进行更精细的控制,可以直接使用 `Mesh.merge`。
|
|
* @param staticModelRoot root of all the static models to be batched
|
|
* @param batchedRoot the target output node
|
|
*/
|
|
public static batchStaticModel (staticModelRoot: Node, batchedRoot: Node): boolean {
|
|
const models = staticModelRoot.getComponentsInChildren(MeshRenderer);
|
|
if (models.length < 2) {
|
|
console.error('the number of static models to batch is less than 2,it needn\'t batch.');
|
|
return false;
|
|
}
|
|
for (let i = 1; i < models.length; i++) {
|
|
if (!models[0].mesh!.validateMergingMesh(models[i].mesh!)) {
|
|
console.error(`the meshes of ${models[0].node.name} and ${models[i].node.name} can't be merged`);
|
|
return false;
|
|
}
|
|
if (!checkMaterialisSame(models[0], models[i])) {
|
|
console.error(`the materials of ${models[0].node.name} and ${models[i].node.name} can't be merged`);
|
|
return false;
|
|
}
|
|
}
|
|
const batchedMesh = new Mesh();
|
|
const worldMat = new Mat4();
|
|
const rootWorldMatInv = new Mat4();
|
|
staticModelRoot.getWorldMatrix(rootWorldMatInv);
|
|
Mat4.invert(rootWorldMatInv, rootWorldMatInv);
|
|
for (let i = 0; i < models.length; i++) {
|
|
const comp = models[i];
|
|
comp.node.getWorldMatrix(worldMat);
|
|
Mat4.multiply(worldMat, rootWorldMatInv, worldMat);
|
|
batchedMesh.merge(models[i].mesh!, worldMat);
|
|
comp.enabled = false;
|
|
}
|
|
const batchedModel = batchedRoot.addComponent(MeshRenderer);
|
|
batchedModel.mesh = batchedMesh;
|
|
batchedModel.sharedMaterials = models[0].sharedMaterials;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @en
|
|
* Undoes everything `batchStaticModel` did.
|
|
* @zh
|
|
* 回退 `batchStaticModel` 做的工作
|
|
*
|
|
* @param staticModelRoot root of all the static models to be batched
|
|
* @param batchedRoot the target output node
|
|
*/
|
|
public static unbatchStaticModel (staticModelRoot: Node, batchedRoot: Node): boolean {
|
|
const models = staticModelRoot.getComponentsInChildren(MeshRenderer);
|
|
for (let i = 0; i < models.length; i++) {
|
|
const comp = models[i];
|
|
comp.enabled = true;
|
|
}
|
|
const batchedModel = batchedRoot.getComponent(MeshRenderer);
|
|
if (batchedModel) {
|
|
if (batchedModel.mesh) {
|
|
batchedModel.mesh.destroyRenderingMesh();
|
|
}
|
|
batchedModel.destroy();
|
|
}
|
|
return true;
|
|
}
|
|
}
|