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>
155 lines
4.9 KiB
TypeScript
155 lines
4.9 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 { PrimitiveMode } from '../gfx';
|
|
import { IGeometry } from './define';
|
|
|
|
/**
|
|
* @en
|
|
* Translate the geometry.
|
|
* @zh
|
|
* 平移几何体。
|
|
* @param geometry @zh 几何体信息。@en The geometry to be translated
|
|
* @param offset @zh 偏移量。@en The translation
|
|
*/
|
|
export function translate (geometry: IGeometry, offset: { x?: number; y?: number; z?: number; }): IGeometry {
|
|
const x = offset.x || 0;
|
|
const y = offset.y || 0;
|
|
const z = offset.z || 0;
|
|
const nVertex = Math.floor(geometry.positions.length / 3);
|
|
for (let iVertex = 0; iVertex < nVertex; ++iVertex) {
|
|
const iX = iVertex * 3;
|
|
const iY = iVertex * 3 + 1;
|
|
const iZ = iVertex * 3 + 2;
|
|
geometry.positions[iX] += x;
|
|
geometry.positions[iY] += y;
|
|
geometry.positions[iZ] += z;
|
|
}
|
|
if (geometry.minPos) {
|
|
geometry.minPos.x += x;
|
|
geometry.minPos.y += y;
|
|
geometry.minPos.z += z;
|
|
}
|
|
if (geometry.maxPos) {
|
|
geometry.maxPos.x += x;
|
|
geometry.maxPos.y += y;
|
|
geometry.maxPos.z += z;
|
|
}
|
|
return geometry;
|
|
}
|
|
|
|
/**
|
|
* @en
|
|
* Scale the geometry.
|
|
* @zh
|
|
* 缩放几何体。
|
|
* @param geometry @zh 几何体信息。 @en The geometry to be scaled
|
|
* @param value @zh 缩放量。@en The scaling size
|
|
*/
|
|
export function scale (geometry: IGeometry, value: { x?: number; y?: number; z?: number }): IGeometry {
|
|
const x = value.x ?? 1.0;
|
|
const y = value.y ?? 1.0;
|
|
const z = value.z ?? 1.0;
|
|
const nVertex = Math.floor(geometry.positions.length / 3);
|
|
for (let iVertex = 0; iVertex < nVertex; ++iVertex) {
|
|
const iX = iVertex * 3;
|
|
const iY = iVertex * 3 + 1;
|
|
const iZ = iVertex * 3 + 2;
|
|
geometry.positions[iX] *= x;
|
|
geometry.positions[iY] *= y;
|
|
geometry.positions[iZ] *= z;
|
|
}
|
|
const {
|
|
minPos,
|
|
maxPos,
|
|
} = geometry;
|
|
if (minPos) {
|
|
minPos.x *= x;
|
|
minPos.y *= y;
|
|
minPos.z *= z;
|
|
}
|
|
if (maxPos) {
|
|
maxPos.x *= x;
|
|
maxPos.y *= y;
|
|
maxPos.z *= z;
|
|
}
|
|
if (minPos && maxPos) {
|
|
// Negative scaling causes min-max to be swapped.
|
|
if (x < 0) {
|
|
const tmp = minPos.x; minPos.x = maxPos.x; maxPos.x = tmp;
|
|
}
|
|
if (y < 0) {
|
|
const tmp = minPos.y; minPos.y = maxPos.y; maxPos.y = tmp;
|
|
}
|
|
if (z < 0) {
|
|
const tmp = minPos.z; minPos.z = maxPos.z; maxPos.z = tmp;
|
|
}
|
|
}
|
|
if (typeof geometry.boundingRadius !== 'undefined') {
|
|
geometry.boundingRadius *= Math.max(Math.max(Math.abs(x), Math.abs(y)), Math.abs(z));
|
|
}
|
|
return geometry;
|
|
}
|
|
|
|
/**
|
|
* @en
|
|
* Converts geometry to wireframe mode. Only geometry with triangle topology is supported.
|
|
* @zh
|
|
* 将几何体转换为线框模式,仅支持三角形拓扑的几何体。
|
|
* @param geometry @zh 几何体信息。@en The geometry to be converted to wireframe
|
|
*/
|
|
export function wireframed (geometry: IGeometry): IGeometry {
|
|
const { indices } = geometry;
|
|
if (!indices) {
|
|
return geometry;
|
|
}
|
|
|
|
// We only support triangles' wireframe.
|
|
if (geometry.primitiveMode && geometry.primitiveMode !== PrimitiveMode.TRIANGLE_LIST) {
|
|
return geometry;
|
|
}
|
|
|
|
const offsets = [[0, 1], [1, 2], [2, 0]];
|
|
const lines: number[] = [];
|
|
const lineIDs = {};
|
|
|
|
for (let i = 0; i < indices.length; i += 3) {
|
|
for (let k = 0; k < 3; ++k) {
|
|
const i1 = indices[i + offsets[k][0]];
|
|
const i2 = indices[i + offsets[k][1]];
|
|
|
|
// check if we already have the line in our lines
|
|
const id = (i1 > i2) ? ((i2 << 16) | i1) : ((i1 << 16) | i2);
|
|
if (lineIDs[id] === undefined) {
|
|
lineIDs[id] = 0;
|
|
lines.push(i1, i2);
|
|
}
|
|
}
|
|
}
|
|
|
|
geometry.indices = lines;
|
|
geometry.primitiveMode = PrimitiveMode.LINE_LIST;
|
|
return geometry;
|
|
}
|