mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-21 16:12:40 +08:00
e2b740dd15
* sync asset-manager refine refine refine * change director * refine * fix bugs * commit * refine and fix bugs * refine docs * fix bugs * merge * fix bugs * fix bugs * merge * sync jsb-adapter * fix ci * adapt preloading process for new Deserializer * adapt preloading process for new Deserializer * fix bugs * minor fix * dump dependency of SpriteFrame explicitly (sync #6938) * dump dependency of SpriteFrame explicitly (sync #6938) * remove unused variable * exporting should trigger uuid compression in serializer * refine * fix ci Co-authored-by: Santy-Wang <wh19930829@qq.com>
1001 lines
22 KiB
TypeScript
1001 lines
22 KiB
TypeScript
/*
|
|
Copyright (c) 2008-2010 Ricardo Quesada
|
|
Copyright (c) 2011-2012 cocos2d-x.org
|
|
Copyright (c) 2013-2016 Chukong Technologies Inc.
|
|
Copyright (c) 2017-2020 Xiamen Yaji Software Co., Ltd.
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* @packageDocumentation
|
|
* @module core
|
|
*/
|
|
|
|
import { legacyCC } from '../global-exports';
|
|
|
|
const SUPPORT_TEXTURE_FORMATS = ['.astc', '.pkm', '.pvr', '.webp', '.jpg', '.jpeg', '.bmp', '.png'];
|
|
|
|
const KEY = {
|
|
/**
|
|
* @en None
|
|
* @zh 没有分配
|
|
* @readonly
|
|
*/
|
|
'none': 0,
|
|
|
|
// android
|
|
/**
|
|
* @en The back key
|
|
* @zh 返回键
|
|
* @readonly
|
|
*/
|
|
'back': 6,
|
|
/**
|
|
* @en The menu key
|
|
* @zh 菜单键
|
|
* @readonly
|
|
*/
|
|
'menu': 18,
|
|
|
|
/**
|
|
* @en The backspace key
|
|
* @zh 退格键
|
|
* @readonly
|
|
*/
|
|
'backspace': 8,
|
|
|
|
/**
|
|
* @en The tab key
|
|
* @zh Tab 键
|
|
* @readonly
|
|
*/
|
|
'tab': 9,
|
|
|
|
/**
|
|
* @en The enter key
|
|
* @zh 回车键
|
|
* @readonly
|
|
*/
|
|
'enter': 13,
|
|
|
|
/**
|
|
* @en The shift key
|
|
* @zh Shift 键
|
|
* @readonly
|
|
*/
|
|
'shift': 16, // should use shiftkey instead
|
|
|
|
/**
|
|
* @en The ctrl key
|
|
* @zh Ctrl 键
|
|
* @readonly
|
|
*/
|
|
'ctrl': 17, // should use ctrlkey
|
|
|
|
/**
|
|
* @en The alt key
|
|
* @zh Alt 键
|
|
* @readonly
|
|
*/
|
|
'alt': 18, // should use altkey
|
|
|
|
/**
|
|
* @en The pause key
|
|
* @zh 暂停键
|
|
* @readonly
|
|
*/
|
|
'pause': 19,
|
|
|
|
/**
|
|
* @en The caps lock key
|
|
* @zh 大写锁定键
|
|
* @readonly
|
|
*/
|
|
'capslock': 20,
|
|
|
|
/**
|
|
* @en The esc key
|
|
* @zh ESC 键
|
|
* @readonly
|
|
*/
|
|
'escape': 27,
|
|
|
|
/**
|
|
* @en The space key
|
|
* @zh 空格键
|
|
* @readonly
|
|
*/
|
|
'space': 32,
|
|
|
|
/**
|
|
* @en The page up key
|
|
* @zh 向上翻页键
|
|
* @readonly
|
|
*/
|
|
'pageup': 33,
|
|
|
|
/**
|
|
* @en The page down key
|
|
* @zh 向下翻页键
|
|
* @readonly
|
|
*/
|
|
'pagedown': 34,
|
|
|
|
/**
|
|
* @en The end key
|
|
* @zh 结束键
|
|
* @readonly
|
|
*/
|
|
'end': 35,
|
|
|
|
/**
|
|
* @en The home key
|
|
* @zh 主菜单键
|
|
* @readonly
|
|
*/
|
|
'home': 36,
|
|
|
|
/**
|
|
* @en The left key
|
|
* @zh 向左箭头键
|
|
* @readonly
|
|
*/
|
|
'left': 37,
|
|
|
|
/**
|
|
* @en The up key
|
|
* @zh 向上箭头键
|
|
* @readonly
|
|
*/
|
|
'up': 38,
|
|
|
|
/**
|
|
* @en The right key
|
|
* @zh 向右箭头键
|
|
* @readonly
|
|
*/
|
|
'right': 39,
|
|
|
|
/**
|
|
* @en The down key
|
|
* @zh 向下箭头键
|
|
* @readonly
|
|
*/
|
|
'down': 40,
|
|
|
|
/**
|
|
* @en The select key
|
|
* @zh Select 键
|
|
* @readonly
|
|
*/
|
|
'select': 41,
|
|
|
|
/**
|
|
* @en The insert key
|
|
* @zh 插入键
|
|
* @readonly
|
|
*/
|
|
'insert': 45,
|
|
|
|
/**
|
|
* @en The Delete key
|
|
* @zh 删除键
|
|
* @readonly
|
|
*/
|
|
'Delete': 46,
|
|
|
|
/**
|
|
* @en The '0' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 0 键
|
|
* @readonly
|
|
*/
|
|
'0': 48,
|
|
|
|
/**
|
|
* @en The '1' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 1 键
|
|
* @readonly
|
|
*/
|
|
'1': 49,
|
|
|
|
/**
|
|
* @en The '2' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 2 键
|
|
* @readonly
|
|
*/
|
|
'2': 50,
|
|
|
|
/**
|
|
* @en The '3' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 3 键
|
|
* @readonly
|
|
*/
|
|
'3': 51,
|
|
|
|
/**
|
|
* @en The '4' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 4 键
|
|
* @readonly
|
|
*/
|
|
'4': 52,
|
|
|
|
/**
|
|
* @en The '5' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 5 键
|
|
* @readonly
|
|
*/
|
|
'5': 53,
|
|
|
|
/**
|
|
* @en The '6' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 6 键
|
|
* @readonly
|
|
*/
|
|
'6': 54,
|
|
|
|
/**
|
|
* @en The '7' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 7 键
|
|
* @readonly
|
|
*/
|
|
'7': 55,
|
|
|
|
/**
|
|
* @en The '8' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 8 键
|
|
* @readonly
|
|
*/
|
|
'8': 56,
|
|
|
|
/**
|
|
* @en The '9' key on the top of the alphanumeric keyboard.
|
|
* @zh 字母键盘上的 9 键
|
|
* @readonly
|
|
*/
|
|
'9': 57,
|
|
|
|
/**
|
|
* @en The a key
|
|
* @zh A 键
|
|
* @readonly
|
|
*/
|
|
'a': 65,
|
|
|
|
/**
|
|
* @en The b key
|
|
* @zh B 键
|
|
* @readonly
|
|
*/
|
|
'b': 66,
|
|
|
|
/**
|
|
* @en The c key
|
|
* @zh C 键
|
|
* @readonly
|
|
*/
|
|
'c': 67,
|
|
|
|
/**
|
|
* @en The d key
|
|
* @zh D 键
|
|
* @readonly
|
|
*/
|
|
'd': 68,
|
|
|
|
/**
|
|
* @en The e key
|
|
* @zh E 键
|
|
* @readonly
|
|
*/
|
|
'e': 69,
|
|
|
|
/**
|
|
* @en The f key
|
|
* @zh F 键
|
|
* @readonly
|
|
*/
|
|
'f': 70,
|
|
|
|
/**
|
|
* @en The g key
|
|
* @zh G 键
|
|
* @readonly
|
|
*/
|
|
'g': 71,
|
|
|
|
/**
|
|
* @en The h key
|
|
* @zh H 键
|
|
* @readonly
|
|
*/
|
|
'h': 72,
|
|
|
|
/**
|
|
* @en The i key
|
|
* @zh I 键
|
|
* @readonly
|
|
*/
|
|
'i': 73,
|
|
|
|
/**
|
|
* @en The j key
|
|
* @zh J 键
|
|
* @readonly
|
|
*/
|
|
'j': 74,
|
|
|
|
/**
|
|
* @en The k key
|
|
* @zh K 键
|
|
* @readonly
|
|
*/
|
|
'k': 75,
|
|
|
|
/**
|
|
* @en The l key
|
|
* @zh L 键
|
|
* @readonly
|
|
*/
|
|
'l': 76,
|
|
|
|
/**
|
|
* @en The m key
|
|
* @zh M 键
|
|
* @readonly
|
|
*/
|
|
'm': 77,
|
|
|
|
/**
|
|
* @en The n key
|
|
* @zh N 键
|
|
* @readonly
|
|
*/
|
|
'n': 78,
|
|
|
|
/**
|
|
* @en The o key
|
|
* @zh O 键
|
|
* @readonly
|
|
*/
|
|
'o': 79,
|
|
|
|
/**
|
|
* @en The p key
|
|
* @zh P 键
|
|
* @readonly
|
|
*/
|
|
'p': 80,
|
|
|
|
/**
|
|
* @en The q key
|
|
* @zh Q 键
|
|
* @readonly
|
|
*/
|
|
'q': 81,
|
|
|
|
/**
|
|
* @en The r key
|
|
* @zh R 键
|
|
* @readonly
|
|
*/
|
|
'r': 82,
|
|
|
|
/**
|
|
* @en The s key
|
|
* @zh S 键
|
|
* @readonly
|
|
*/
|
|
's': 83,
|
|
|
|
/**
|
|
* @en The t key
|
|
* @zh T 键
|
|
* @readonly
|
|
*/
|
|
't': 84,
|
|
|
|
/**
|
|
* @en The u key
|
|
* @zh U 键
|
|
* @readonly
|
|
*/
|
|
'u': 85,
|
|
|
|
/**
|
|
* @en The v key
|
|
* @zh V 键
|
|
* @readonly
|
|
*/
|
|
'v': 86,
|
|
|
|
/**
|
|
* @en The w key
|
|
* @zh W 键
|
|
* @readonly
|
|
*/
|
|
'w': 87,
|
|
|
|
/**
|
|
* @en The x key
|
|
* @zh X 键
|
|
* @readonly
|
|
*/
|
|
'x': 88,
|
|
|
|
/**
|
|
* @en The y key
|
|
* @zh Y 键
|
|
* @readonly
|
|
*/
|
|
'y': 89,
|
|
|
|
/**
|
|
* @en The z key
|
|
* @zh Z 键
|
|
* @readonly
|
|
*/
|
|
'z': 90,
|
|
|
|
/**
|
|
* @en The numeric keypad 0
|
|
* @zh 数字键盘 0
|
|
* @readonly
|
|
*/
|
|
'num0': 96,
|
|
|
|
/**
|
|
* @en The numeric keypad 1
|
|
* @zh 数字键盘 1
|
|
* @readonly
|
|
*/
|
|
'num1': 97,
|
|
|
|
/**
|
|
* @en The numeric keypad 2
|
|
* @zh 数字键盘 2
|
|
* @readonly
|
|
*/
|
|
'num2': 98,
|
|
|
|
/**
|
|
* @en The numeric keypad 3
|
|
* @zh 数字键盘 3
|
|
* @readonly
|
|
*/
|
|
'num3': 99,
|
|
|
|
/**
|
|
* @en The numeric keypad 4
|
|
* @zh 数字键盘 4
|
|
* @readonly
|
|
*/
|
|
'num4': 100,
|
|
|
|
/**
|
|
* @en The numeric keypad 5
|
|
* @zh 数字键盘 5
|
|
* @readonly
|
|
*/
|
|
'num5': 101,
|
|
|
|
/**
|
|
* @en The numeric keypad 6
|
|
* @zh 数字键盘 6
|
|
* @readonly
|
|
*/
|
|
'num6': 102,
|
|
|
|
/**
|
|
* @en The numeric keypad 7
|
|
* @zh 数字键盘 7
|
|
* @readonly
|
|
*/
|
|
'num7': 103,
|
|
|
|
/**
|
|
* @en The numeric keypad 8
|
|
* @zh 数字键盘 8
|
|
* @readonly
|
|
*/
|
|
'num8': 104,
|
|
|
|
/**
|
|
* @en The numeric keypad 9
|
|
* @zh 数字键盘 9
|
|
* @readonly
|
|
*/
|
|
'num9': 105,
|
|
|
|
/**
|
|
* @en The numeric keypad '*'
|
|
* @zh 数字键盘 *
|
|
* @readonly
|
|
*/
|
|
'*': 106,
|
|
|
|
/**
|
|
* @en The numeric keypad '+'
|
|
* @zh 数字键盘 +
|
|
* @readonly
|
|
*/
|
|
'+': 107,
|
|
|
|
/**
|
|
* @en The numeric keypad '-'
|
|
* @zh 数字键盘 -
|
|
* @readonly
|
|
*/
|
|
'-': 109,
|
|
|
|
/**
|
|
* @en The numeric keypad 'delete'
|
|
* @zh 数字键盘删除键
|
|
* @readonly
|
|
*/
|
|
'numdel': 110,
|
|
|
|
/**
|
|
* @en The numeric keypad '/'
|
|
* @zh 数字键盘 /
|
|
* @readonly
|
|
*/
|
|
'/': 111,
|
|
|
|
/**
|
|
* @en The F1 function key
|
|
* @zh F1 功能键
|
|
* @readonly
|
|
*/
|
|
'f1': 112, // f1-f12 dont work on ie
|
|
|
|
/**
|
|
* @en The F2 function key
|
|
* @zh F2 功能键
|
|
* @readonly
|
|
*/
|
|
'f2': 113,
|
|
|
|
/**
|
|
* @en The F3 function key
|
|
* @zh F3 功能键
|
|
* @readonly
|
|
*/
|
|
'f3': 114,
|
|
|
|
/**
|
|
* @en The F4 function key
|
|
* @zh F4 功能键
|
|
* @readonly
|
|
*/
|
|
'f4': 115,
|
|
|
|
/**
|
|
* @en The F5 function key
|
|
* @zh F5 功能键
|
|
* @readonly
|
|
*/
|
|
'f5': 116,
|
|
|
|
/**
|
|
* @en The F6 function key
|
|
* @zh F6 功能键
|
|
* @readonly
|
|
*/
|
|
'f6': 117,
|
|
|
|
/**
|
|
* @en The F7 function key
|
|
* @zh F7 功能键
|
|
* @readonly
|
|
*/
|
|
'f7': 118,
|
|
|
|
/**
|
|
* @en The F8 function key
|
|
* @zh F8 功能键
|
|
* @readonly
|
|
*/
|
|
'f8': 119,
|
|
|
|
/**
|
|
* @en The F9 function key
|
|
* @zh F9 功能键
|
|
* @readonly
|
|
*/
|
|
'f9': 120,
|
|
|
|
/**
|
|
* @en The F10 function key
|
|
* @zh F10 功能键
|
|
* @readonly
|
|
*/
|
|
'f10': 121,
|
|
|
|
/**
|
|
* @en The F11 function key
|
|
* @zh F11 功能键
|
|
* @readonly
|
|
*/
|
|
'f11': 122,
|
|
|
|
/**
|
|
* @en The F12 function key
|
|
* @zh F12 功能键
|
|
* @readonly
|
|
*/
|
|
'f12': 123,
|
|
|
|
/**
|
|
* @en The numlock key
|
|
* @zh 数字锁定键
|
|
* @readonly
|
|
*/
|
|
'numlock': 144,
|
|
|
|
/**
|
|
* @en The scroll lock key
|
|
* @zh 滚动锁定键
|
|
* @readonly
|
|
*/
|
|
'scrolllock': 145,
|
|
|
|
/**
|
|
* @en The ';' key.
|
|
* @zh 分号键
|
|
* @readonly
|
|
*/
|
|
';': 186,
|
|
|
|
/**
|
|
* @en The ';' key.
|
|
* @zh 分号键
|
|
* @readonly
|
|
*/
|
|
'semicolon': 186,
|
|
|
|
/**
|
|
* @en The '=' key.
|
|
* @zh 等于号键
|
|
* @readonly
|
|
*/
|
|
'equal': 187,
|
|
|
|
/**
|
|
* @en The '=' key.
|
|
* @zh 等于号键
|
|
* @readonly
|
|
*/
|
|
'=': 187,
|
|
|
|
/**
|
|
* @en The ',' key.
|
|
* @zh 逗号键
|
|
* @readonly
|
|
*/
|
|
',': 188,
|
|
|
|
/**
|
|
* @en The ',' key.
|
|
* @zh 逗号键
|
|
* @readonly
|
|
*/
|
|
'comma': 188,
|
|
|
|
/**
|
|
* @en The dash '-' key.
|
|
* @zh 中划线键
|
|
* @readonly
|
|
*/
|
|
'dash': 189,
|
|
|
|
/**
|
|
* @en The '.' key.
|
|
* @zh 句号键
|
|
* @readonly
|
|
*/
|
|
'.': 190,
|
|
|
|
/**
|
|
* @en The '.' key
|
|
* @zh 句号键
|
|
* @readonly
|
|
*/
|
|
'period': 190,
|
|
|
|
/**
|
|
* @en The forward slash key
|
|
* @zh 正斜杠键
|
|
* @readonly
|
|
*/
|
|
'forwardslash': 191,
|
|
|
|
/**
|
|
* @en The grave key
|
|
* @zh 按键 `
|
|
* @readonly
|
|
*/
|
|
'grave': 192,
|
|
|
|
/**
|
|
* @en The '[' key
|
|
* @zh 按键 [
|
|
* @readonly
|
|
*/
|
|
'[': 219,
|
|
|
|
/**
|
|
* @en The '[' key
|
|
* @zh 按键 [
|
|
* @readonly
|
|
*/
|
|
'openbracket': 219,
|
|
|
|
/**
|
|
* @en The '\' key
|
|
* @zh 反斜杠键
|
|
* @readonly
|
|
*/
|
|
'backslash': 220,
|
|
|
|
/**
|
|
* @en The ']' key
|
|
* @zh 按键 ]
|
|
* @readonly
|
|
*/
|
|
']': 221,
|
|
|
|
/**
|
|
* @en The ']' key
|
|
* @zh 按键 ]
|
|
* @readonly
|
|
*/
|
|
'closebracket': 221,
|
|
|
|
/**
|
|
* @en The quote key
|
|
* @zh 单引号键
|
|
* @readonly
|
|
*/
|
|
'quote': 222,
|
|
|
|
// gamepad controll
|
|
|
|
/**
|
|
* @en The dpad left key
|
|
* @zh 导航键 向左
|
|
* @readonly
|
|
*/
|
|
'dpadLeft': 1000,
|
|
|
|
/**
|
|
* @en The dpad right key
|
|
* @zh 导航键 向右
|
|
* @readonly
|
|
*/
|
|
'dpadRight': 1001,
|
|
|
|
/**
|
|
* @en The dpad up key
|
|
* @zh 导航键 向上
|
|
* @readonly
|
|
*/
|
|
'dpadUp': 1003,
|
|
|
|
/**
|
|
* @en The dpad down key
|
|
* @zh 导航键 向下
|
|
* @readonly
|
|
*/
|
|
'dpadDown': 1004,
|
|
|
|
/**
|
|
* @en The dpad center key
|
|
* @zh 导航键 确定键
|
|
* @readonly
|
|
*/
|
|
'dpadCenter': 1005,
|
|
};
|
|
|
|
/**
|
|
* @en
|
|
* Predefined constants
|
|
* @zh
|
|
* 预定义常量。
|
|
*/
|
|
const macro = {
|
|
/**
|
|
* @en
|
|
* The image format supported by the engine defaults, and the supported formats may differ in different build platforms and device types.
|
|
* Currently all platform and device support ['.webp', '.jpg', '.jpeg', '.bmp', '.png'], ios mobile platform
|
|
* @zh
|
|
* 引擎默认支持的图片格式,支持的格式可能在不同的构建平台和设备类型上有所差别。
|
|
* 目前所有平台和设备支持的格式有 ['.webp', '.jpg', '.jpeg', '.bmp', '.png']. The iOS mobile platform also supports the PVR format。
|
|
*/
|
|
SUPPORT_TEXTURE_FORMATS,
|
|
|
|
/**
|
|
* @en Key map for keyboard event
|
|
* @zh 键盘事件的按键值。
|
|
* @example {@link cocos/core/platform/CCCommon/KEY.js}
|
|
*/
|
|
KEY,
|
|
|
|
/**
|
|
* PI / 180
|
|
*/
|
|
RAD: Math.PI / 180,
|
|
|
|
/**
|
|
* One degree
|
|
*/
|
|
DEG: 180 / Math.PI,
|
|
|
|
/**
|
|
* A maximum value of number
|
|
*/
|
|
REPEAT_FOREVER: (Number.MAX_VALUE - 1),
|
|
|
|
/**
|
|
* A minimal float value
|
|
*/
|
|
FLT_EPSILON: 0.0000001192092896,
|
|
|
|
// Possible device orientations
|
|
/**
|
|
* @en Oriented vertically
|
|
* @zh 竖屏朝向
|
|
*/
|
|
ORIENTATION_PORTRAIT: 1,
|
|
|
|
/**
|
|
* @en Oriented horizontally
|
|
* @zh 横屏朝向
|
|
*/
|
|
ORIENTATION_LANDSCAPE: 2,
|
|
|
|
/**
|
|
* @en Oriented automatically
|
|
* @zh 自动适配朝向
|
|
*/
|
|
ORIENTATION_AUTO: 3,
|
|
|
|
/**
|
|
* <p>
|
|
* If enabled, the texture coordinates will be calculated by using this formula: <br/>
|
|
* - texCoord.left = (rect.x*2+1) / (texture.wide*2); <br/>
|
|
* - texCoord.right = texCoord.left + (rect.width*2-2)/(texture.wide*2); <br/>
|
|
* <br/>
|
|
* The same for bottom and top. <br/>
|
|
* <br/>
|
|
* This formula prevents artifacts by using 99% of the texture. <br/>
|
|
* The "correct" way to prevent artifacts is by expand the texture's border with the same color by 1 pixel<br/>
|
|
* <br/>
|
|
* Affected component: <br/>
|
|
* - TMXLayer <br/>
|
|
* <br/>
|
|
* Enabled by default. To disabled set it to 0. <br/>
|
|
* To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h
|
|
* </p>
|
|
* Currently not useful in 3D engine
|
|
*/
|
|
// FIX_ARTIFACTS_BY_STRECHING_TEXEL_TMX: true,
|
|
|
|
/**
|
|
* @en
|
|
* Whether or not enabled tiled map auto culling. If you set the TiledMap skew or rotation,
|
|
* then need to manually disable this, otherwise, the rendering will be wrong.
|
|
* Currently not useful in 3D engine
|
|
* @zh
|
|
* 是否开启瓦片地图的自动裁减功能。瓦片地图如果设置了 skew, rotation 的话,需要手动关闭,否则渲染会出错。
|
|
* 在 3D 引擎中暂时无效。
|
|
* @default true
|
|
*/
|
|
ENABLE_TILEDMAP_CULLING: true,
|
|
|
|
/**
|
|
* @en
|
|
* The timeout to determine whether a touch is no longer active and should be removed.
|
|
* The reason to add this timeout is due to an issue in X5 browser core,
|
|
* when X5 is presented in wechat on Android, if a touch is glissed from the bottom up, and leave the page area,
|
|
* no touch cancel event is triggered, and the touch will be considered active forever.
|
|
* After multiple times of this action, our maximum touches number will be reached and all new touches will be ignored.
|
|
* So this new mechanism can remove the touch that should be inactive if it's not updated during the last 5000 milliseconds.
|
|
* Though it might remove a real touch if it's just not moving for the last 5 seconds which is not easy with the sensibility of mobile touch screen.
|
|
* You can modify this value to have a better behavior if you find it's not enough.
|
|
* @zh
|
|
* 用于甄别一个触点对象是否已经失效并且可以被移除的延时时长
|
|
* 添加这个时长的原因是 X5 内核在微信浏览器中出现的一个 bug。
|
|
* 在这个环境下,如果用户将一个触点从底向上移出页面区域,将不会触发任何 touch cancel 或 touch end 事件,而这个触点会被永远当作停留在页面上的有效触点。
|
|
* 重复这样操作几次之后,屏幕上的触点数量将达到我们的事件系统所支持的最高触点数量,之后所有的触摸事件都将被忽略。
|
|
* 所以这个新的机制可以在触点在一定时间内没有任何更新的情况下视为失效触点并从事件系统中移除。
|
|
* 当然,这也可能移除一个真实的触点,如果用户的触点真的在一定时间段内完全没有移动(这在当前手机屏幕的灵敏度下会很难)。
|
|
* 你可以修改这个值来获得你需要的效果,默认值是 5000 毫秒。
|
|
* @default 5000
|
|
*/
|
|
TOUCH_TIMEOUT: 5000,
|
|
|
|
/**
|
|
* @en
|
|
* Boolean that indicates if the canvas contains an alpha channel, default sets to false for better performance.
|
|
* Though if you want to make your canvas background transparent and show other dom elements at the background,
|
|
* you can set it to true before {{game.init}}.
|
|
* Web only.
|
|
* @zh
|
|
* 用于设置 Canvas 背景是否支持 alpha 通道,默认为 false,这样可以有更高的性能表现。
|
|
* 如果你希望 Canvas 背景是透明的,并显示背后的其他 DOM 元素,你可以在 {{game.init}} 之前将这个值设为 true。
|
|
* 仅支持 Web
|
|
* @default false
|
|
*/
|
|
ENABLE_TRANSPARENT_CANVAS: false,
|
|
|
|
/**
|
|
* @en
|
|
* Boolean that indicates if the WebGL context is created with `antialias` option turned on, default value is false.
|
|
* Set it to true could make your game graphics slightly smoother, like texture hard edges when rotated.
|
|
* Whether to use this really depend on your game design and targeted platform,
|
|
* device with retina display usually have good detail on graphics with or without this option,
|
|
* you probably don't want antialias if your game style is pixel art based.
|
|
* Also, it could have great performance impact with some browser / device using software MSAA.
|
|
* You can set it to true before {{game.init}}.
|
|
* Web only.
|
|
* @zh
|
|
* 用于设置在创建 WebGL Context 时是否开启抗锯齿选项,默认值是 false。
|
|
* 将这个选项设置为 true 会让你的游戏画面稍稍平滑一些,比如旋转硬边贴图时的锯齿。是否开启这个选项很大程度上取决于你的游戏和面向的平台。
|
|
* 在大多数拥有 retina 级别屏幕的设备上用户往往无法区分这个选项带来的变化;如果你的游戏选择像素艺术风格,你也多半不会想开启这个选项。
|
|
* 同时,在少部分使用软件级别抗锯齿算法的设备或浏览器上,这个选项会对性能产生比较大的影响。
|
|
* 你可以在 {{game.init}} 之前设置这个值,否则它不会生效。
|
|
* 仅支持 Web
|
|
* @default true
|
|
*/
|
|
ENABLE_WEBGL_ANTIALIAS: true,
|
|
|
|
/**
|
|
* @en
|
|
* Whether to clear the original image cache after uploaded a texture to GPU. If cleared, [Dynamic Atlas](https://docs.cocos.com/creator/manual/en/advanced-topics/dynamic-atlas.html) will not be supported.
|
|
* Normally you don't need to enable this option on the web platform, because Image object doesn't consume too much memory.
|
|
* But on Wechat Game platform, the current version cache decoded data in Image object, which has high memory usage.
|
|
* So we enabled this option by default on Wechat, so that we can release Image cache immediately after uploaded to GPU.
|
|
* Currently not useful in 3D engine
|
|
* @zh
|
|
* 是否在将贴图上传至 GPU 之后删除原始图片缓存,删除之后图片将无法进行 [动态合图](https://docs.cocos.com/creator/manual/zh/advanced-topics/dynamic-atlas.html)。
|
|
* 在 Web 平台,你通常不需要开启这个选项,因为在 Web 平台 Image 对象所占用的内存很小。
|
|
* 但是在微信小游戏平台的当前版本,Image 对象会缓存解码后的图片数据,它所占用的内存空间很大。
|
|
* 所以我们在微信平台默认开启了这个选项,这样我们就可以在上传 GL 贴图之后立即释放 Image 对象的内存,避免过高的内存占用。
|
|
* 在 3D 引擎中暂时无效。
|
|
* @default false
|
|
*/
|
|
CLEANUP_IMAGE_CACHE: false,
|
|
|
|
/**
|
|
* @en
|
|
* Whether to enable multi-touch.
|
|
* @zh
|
|
* 是否开启多点触摸
|
|
* @default true
|
|
*/
|
|
ENABLE_MULTI_TOUCH: true,
|
|
};
|
|
|
|
legacyCC.macro = macro;
|
|
|
|
export { macro };
|