mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-20 23:52:40 +08:00
0d7c5c8f56
* move `cocos/core/scene-graph` to `cocos/scene-graph` * move some files in `cocos/core/components` to `cocos/scene-graph`: - component.ts - component-event-handler.ts - component-event-handler-schema.ts * move some files in `cocos/core/components` to `cocos/misc`: - missing-script.ts - model-renderer.ts - renderer.ts - camera-component.ts * move `cocos/core/components/system.ts` to ``cocos/core/system.ts``
100 lines
3.8 KiB
TypeScript
100 lines
3.8 KiB
TypeScript
/*
|
|
Copyright (c) 2022 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 engine source code (the "Software"), a limited,
|
|
worldwide, royalty-free, non-assignable, revocable and non-exclusive license
|
|
to use Cocos Creator solely to develop games on your target platforms. You shall
|
|
not use Cocos Creator software for developing other software or tools that's
|
|
used for developing games. You are not granted to publish, distribute,
|
|
sublicense, and/or sell copies of Cocos Creator.
|
|
|
|
The software or tools in this License Agreement are licensed, not sold.
|
|
Xiamen Yaji Software Co., Ltd. reserves all rights not expressly granted to you.
|
|
|
|
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 { ccclass, disallowMultiple, editable, executeInEditMode, menu, range, serializable, type } from 'cc.decorator';
|
|
import { clamp } from '../core/math';
|
|
import { SortingLayers } from './sorting-layers';
|
|
import { Component } from '../scene-graph/component';
|
|
import { ModelRenderer } from '../misc/model-renderer';
|
|
import { warnID } from '../core/platform/debug';
|
|
|
|
const MAX_INT16 = (1 << 15) - 1;
|
|
const MIN_INT16 = -1 << 15;
|
|
|
|
/**
|
|
* @en
|
|
* Render sort component. This component must be placed on a node with a [[MeshRenderer]] or [[SpriteRenderer]] component.
|
|
*
|
|
* @zh
|
|
* 渲染排序组件。该组件必须放置在带有 [[MeshRenderer]] 或者 [[SpriteRenderer]] 组件的节点上。
|
|
*/
|
|
@ccclass('cc.Sorting')
|
|
@menu('Sorting/Sorting')
|
|
@disallowMultiple
|
|
@executeInEditMode
|
|
export class Sorting extends Component {
|
|
/**
|
|
* @zh 组件所属排序层 id,影响组件的渲染排序。
|
|
* @en The sorting layer id of the component, which affects the rendering order of the component.
|
|
*/
|
|
@editable
|
|
@type(SortingLayers.Enum)
|
|
get sortingLayer () {
|
|
return this._sortingLayer;
|
|
}
|
|
set sortingLayer (val) {
|
|
if (val === this._sortingLayer || !SortingLayers.isLayerValid(val)) return;
|
|
this._sortingLayer = val;
|
|
this._updateSortingPriority();
|
|
}
|
|
|
|
/**
|
|
* @zh 组件在当前排序层中的顺序,在默认排序规则中,越小越先渲染。
|
|
* @en Model Renderer's order within a sorting layer. In the default sorting rule, smaller values are rendered first.
|
|
*/
|
|
@range([MIN_INT16, MAX_INT16, 1])
|
|
get sortingOrder () {
|
|
return this._sortingOrder;
|
|
}
|
|
set sortingOrder (val) {
|
|
if (val === this._sortingOrder) return;
|
|
this._sortingOrder = clamp(val, MIN_INT16, MAX_INT16);
|
|
this._updateSortingPriority();
|
|
}
|
|
|
|
@serializable
|
|
protected _sortingLayer = SortingLayers.Enum.default; // Actually saved id
|
|
@serializable
|
|
protected _sortingOrder = 0;
|
|
|
|
private _modelRenderer: ModelRenderer | null = null;
|
|
|
|
protected __preload () {
|
|
this._modelRenderer = this.getComponent('cc.ModelRenderer') as ModelRenderer;
|
|
if (!this._modelRenderer) {
|
|
warnID(16301, this.node.name);
|
|
}
|
|
this._updateSortingPriority();
|
|
}
|
|
|
|
protected _updateSortingPriority () {
|
|
const sortingLayerValue = SortingLayers.getLayerIndex(this._sortingLayer);
|
|
const sortingPriority = SortingLayers.getSortingPriority(sortingLayerValue, this._sortingOrder);
|
|
if (this._modelRenderer && this._modelRenderer.isValid) {
|
|
this._modelRenderer.priority = sortingPriority;
|
|
}
|
|
}
|
|
}
|