macro 枚举

模块: _decorator 父模块: cc

Predefined constants

索引

• INVALID_INDEX
• NODE_TAG_INVALID
• PI
• PI2
• FLT_MAX
• FLT_MIN
• RAD
• DEG
• UINT_MAX
• REPEAT_FOREVER
• FLT_EPSILON
• ONE
• ZERO
• SRC_ALPHA
• SRC_ALPHA_SATURATE
• SRC_COLOR
• DST_ALPHA
• DST_COLOR
• ONE_MINUS_SRC_ALPHA
• ONE_MINUS_SRC_COLOR
• ONE_MINUS_DST_ALPHA
• ONE_MINUS_DST_COLOR
• ONE_MINUS_CONSTANT_ALPHA
• ONE_MINUS_CONSTANT_COLOR
• LINEAR
• BLEND_DST
• WEB_ORIENTATION_PORTRAIT
• WEB_ORIENTATION_LANDSCAPE_LEFT
• WEB_ORIENTATION_PORTRAIT_UPSIDE_DOWN
• WEB_ORIENTATION_LANDSCAPE_RIGHT
• ORIENTATION_PORTRAIT
• ORIENTATION_LANDSCAPE
• ORIENTATION_AUTO
• VERTEX_ATTRIB_FLAG_NONE
• VERTEX_ATTRIB_FLAG_POSITION
• VERTEX_ATTRIB_FLAG_COLOR
• VERTEX_ATTRIB_FLAG_TEX_COORDS
• VERTEX_ATTRIB_FLAG_POS_COLOR_TEX
• GL_ALL
• VERTEX_ATTRIB_POSITION
• VERTEX_ATTRIB_COLOR
• VERTEX_ATTRIB_TEX_COORDS
• VERTEX_ATTRIB_MAX
• UNIFORM_PMATRIX
• UNIFORM_MVMATRIX
• UNIFORM_MVPMATRIX
• UNIFORM_TIME
• UNIFORM_SINTIME
• UNIFORM_COSTIME
• UNIFORM_RANDOM01
• UNIFORM_SAMPLER
• UNIFORM_MAX
• SHADER_POSITION_TEXTURECOLOR
• SHADER_SPRITE_POSITION_TEXTURECOLOR
• SHADER_POSITION_TEXTURECOLORALPHATEST
• SHADER_SPRITE_POSITION_TEXTURECOLORALPHATEST
• SHADER_POSITION_COLOR
• SHADER_SPRITE_POSITION_COLOR
• SHADER_POSITION_TEXTURE
• SHADER_POSITION_TEXTURE_UCOLOR
• SHADER_POSITION_TEXTUREA8COLOR
• SHADER_POSITION_UCOLOR
• SHADER_POSITION_LENGTHTEXTURECOLOR
• UNIFORM_PMATRIX_S
• UNIFORM_MVMATRIX_S
• UNIFORM_MVPMATRIX_S
• UNIFORM_TIME_S
• UNIFORM_SINTIME_S
• UNIFORM_COSTIME_S
• UNIFORM_RANDOM01_S
• UNIFORM_SAMPLER_S
• UNIFORM_ALPHA_TEST_VALUE_S
• ATTRIBUTE_NAME_COLOR
• ATTRIBUTE_NAME_POSITION
• ATTRIBUTE_NAME_TEX_COORD
• ITEM_SIZE
• CURRENT_ITEM
• ZOOM_ACTION_TAG
• NORMAL_TAG
• SELECTED_TAG
• DISABLE_TAG
• FIX_ARTIFACTS_BY_STRECHING_TEXEL
• FIX_ARTIFACTS_BY_STRECHING_TEXEL_TMX
• DIRECTOR_STATS_POSITION
• DIRECTOR_FPS_INTERVAL
• COCOSNODE_RENDER_SUBPIXEL
• SPRITEBATCHNODE_RENDER_SUBPIXEL
• AUTO_PREMULTIPLIED_ALPHA_FOR_PNG
• OPTIMIZE_BLEND_FUNC_FOR_PREMULTIPLIED_ALPHA
• TEXTURE_NPOT_SUPPORT
• USE_LA88_LABELS
• SPRITE_DEBUG_DRAW
• LABELBMFONT_DEBUG_DRAW
• LABELATLAS_DEBUG_DRAW
• ENABLE_STACKABLE_ACTIONS
• ENABLE_GL_STATE_CACHE
• TOUCH_TIMEOUT
• BATCH_VERTEX_COUNT
• ENABLE_GC_FOR_NATIVE_OBJECTS
• ENABLE_TILEDMAP_CULLING
• DOWNLOAD_MAX_CONCURRENT
• ENABLE_TRANSPARENT_CANVAS
• ENABLE_WEBGL_ANTIALIAS
• ENABLE_CULLING
• BLEND_SRC

Details

INVALID_INDEX

NODE_TAG_INVALID

Default Node tag

PI

PI is the ratio of a circle's circumference to its diameter.

PI2

PI * 2

FLT_MAX

Maximum float value

FLT_MIN

Minimum float value

RAD

PI / 180

DEG

One degree

UINT_MAX

Maximum unsigned int value

REPEAT_FOREVER

FLT_EPSILON

ONE

ZERO

SRC_ALPHA

SRC_ALPHA_SATURATE

SRC_COLOR

DST_ALPHA

DST_COLOR

ONE_MINUS_SRC_ALPHA

ONE_MINUS_SRC_COLOR

ONE_MINUS_DST_ALPHA

ONE_MINUS_DST_COLOR

ONE_MINUS_CONSTANT_ALPHA

ONE_MINUS_CONSTANT_COLOR

LINEAR

the constant variable equals gl.LINEAR for texture

BLEND_DST

default gl blend dst function. Compatible with premultiplied alpha images.

WEB_ORIENTATION_PORTRAIT

Device oriented vertically, home button on the bottom (UIDeviceOrientationPortrait)

WEB_ORIENTATION_LANDSCAPE_LEFT

Device oriented horizontally, home button on the right (UIDeviceOrientationLandscapeLeft)

WEB_ORIENTATION_PORTRAIT_UPSIDE_DOWN

Device oriented vertically, home button on the top (UIDeviceOrientationPortraitUpsideDown)

WEB_ORIENTATION_LANDSCAPE_RIGHT

Device oriented horizontally, home button on the left (UIDeviceOrientationLandscapeRight)

ORIENTATION_PORTRAIT

Oriented vertically

ORIENTATION_LANDSCAPE

Oriented horizontally

ORIENTATION_AUTO

Oriented automatically

VERTEX_ATTRIB_FLAG_NONE

VERTEX_ATTRIB_FLAG_POSITION

VERTEX_ATTRIB_FLAG_COLOR

VERTEX_ATTRIB_FLAG_TEX_COORDS

VERTEX_ATTRIB_FLAG_POS_COLOR_TEX

GL_ALL

GL server side states

VERTEX_ATTRIB_POSITION

VERTEX_ATTRIB_COLOR

VERTEX_ATTRIB_TEX_COORDS

VERTEX_ATTRIB_MAX

UNIFORM_PMATRIX

UNIFORM_MVMATRIX

UNIFORM_MVPMATRIX

UNIFORM_TIME

UNIFORM_SINTIME

UNIFORM_COSTIME

UNIFORM_RANDOM01

UNIFORM_SAMPLER

UNIFORM_MAX

SHADER_POSITION_TEXTURECOLOR

SHADER_SPRITE_POSITION_TEXTURECOLOR

SHADER_POSITION_TEXTURECOLORALPHATEST

SHADER_SPRITE_POSITION_TEXTURECOLORALPHATEST

SHADER_POSITION_COLOR

SHADER_SPRITE_POSITION_COLOR

SHADER_POSITION_TEXTURE

SHADER_POSITION_TEXTURE_UCOLOR

SHADER_POSITION_TEXTUREA8COLOR

SHADER_POSITION_UCOLOR

SHADER_POSITION_LENGTHTEXTURECOLOR

UNIFORM_PMATRIX_S

UNIFORM_MVMATRIX_S

UNIFORM_MVPMATRIX_S

UNIFORM_TIME_S

UNIFORM_SINTIME_S

UNIFORM_COSTIME_S

UNIFORM_RANDOM01_S

UNIFORM_SAMPLER_S

UNIFORM_ALPHA_TEST_VALUE_S

ATTRIBUTE_NAME_COLOR

ATTRIBUTE_NAME_POSITION

ATTRIBUTE_NAME_TEX_COORD

ITEM_SIZE

default size for font size

CURRENT_ITEM

default tag for current item

ZOOM_ACTION_TAG

default tag for zoom action tag

NORMAL_TAG

default tag for normal

SELECTED_TAG

default selected tag

DISABLE_TAG

default disabled tag

FIX_ARTIFACTS_BY_STRECHING_TEXEL

If enabled, the texture coordinates will be calculated by using this formula:
- texCoord.left = (rect.x*2+1) / (texture.wide*2);
- texCoord.right = texCoord.left + (rect.width*2-2)/(texture.wide*2);

The same for bottom and top.

This formula prevents artifacts by using 99% of the texture.
The "correct" way to prevent artifacts is by expand the texture's border with the same color by 1 pixel

Affected nodes:
- _ccsg.Sprite

Disabled by default. To enabled set it to 1.
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

FIX_ARTIFACTS_BY_STRECHING_TEXEL_TMX

If enabled, the texture coordinates will be calculated by using this formula:
- texCoord.left = (rect.x*2+1) / (texture.wide*2);
- texCoord.right = texCoord.left + (rect.width*2-2)/(texture.wide*2);

The same for bottom and top.

This formula prevents artifacts by using 99% of the texture.
The "correct" way to prevent artifacts is by expand the texture's border with the same color by 1 pixel

Affected nodes:
- _ccsg.TMXLayer

Enabled by default. To disabled set it to 0.
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

DIRECTOR_STATS_POSITION

Position of the FPS (Default: 0,0 (bottom-left corner))
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

DIRECTOR_FPS_INTERVAL

Seconds between FPS updates.
0.5 seconds, means that the FPS number will be updated every 0.5 seconds.
Having a bigger number means a more reliable FPS

Default value: 0.1f
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

COCOSNODE_RENDER_SUBPIXEL

If enabled, the ccsg.Node objects (_ccsg.Sprite, _ccsg.Label,etc) will be able to render in subpixels.
If disabled, integer pixels will be used.

To enable set it to 1. Enabled by default.
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

SPRITEBATCHNODE_RENDER_SUBPIXEL

If enabled, the _ccsg.Sprite objects rendered with cc.SpriteBatchNode will be able to render in subpixels.
If disabled, integer pixels will be used.

To enable set it to 1. Enabled by default.
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

AUTO_PREMULTIPLIED_ALPHA_FOR_PNG

Automatically premultiply alpha for remote PNG resources.

OPTIMIZE_BLEND_FUNC_FOR_PREMULTIPLIED_ALPHA

If most of your images have pre-multiplied alpha, set it to 1 (if you are going to use .PNG/.JPG file images).
Only set to 0 if ALL your images by-pass Apple UIImage loading system (eg: if you use libpng or PVR images)

To enable set it to a value different than 0. Enabled by default.
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

TEXTURE_NPOT_SUPPORT

If enabled, NPOT textures will be used where available. Only 3rd gen (and newer) devices support NPOT textures.
NPOT textures have the following limitations:
- They can't have mipmaps
- They only accept GL_CLAMP_TO_EDGE in GL_TEXTURE_WRAP_{S,T}

To enable set it to a value different than 0. Disabled by default.

This value governs only the PNG, GIF, BMP, images.
This value DOES NOT govern the PVR (PVR.GZ, PVR.CCZ) files. If NPOT PVR is loaded, then it will create an NPOT texture ignoring this value.
To modify it, in Web engine please refer to CCMacro.js, in JSB please refer to CCConfig.h

USE_LA88_LABELS

If enabled, it will use LA88 (Luminance Alpha 16-bit textures) for CCLabelTTF objects.
If it is disabled, it will use A8 (Alpha 8-bit textures).
LA88 textures are 6% faster than A8 textures, but they will consume 2x memory.

This feature is enabled by default.

SPRITE_DEBUG_DRAW

If enabled, all subclasses of _ccsg.Sprite will draw a bounding box
Useful for debugging purposes only. It is recommend to leave it disabled.

To enable set it to a value different than 0. Disabled by default:
0 -- disabled
1 -- draw bounding box
2 -- draw texture box

LABELBMFONT_DEBUG_DRAW

If enabled, all subclasses of cc.LabelBMFont will draw a bounding box
Useful for debugging purposes only. It is recommend to leave it disabled.

To enable set it to a value different than 0. Disabled by default.

LABELATLAS_DEBUG_DRAW

If enabled, all subclasses of cc.LabelAtlas will draw a bounding box
Useful for debugging purposes only. It is recommend to leave it disabled.

To enable set it to a value different than 0. Disabled by default.

ENABLE_STACKABLE_ACTIONS

If enabled, actions that alter the position property (eg: CCMoveBy, CCJumpBy, CCBezierBy, etc..) will be stacked.
If you run 2 or more 'position' actions at the same time on a node, then end position will be the sum of all the positions.
If disabled, only the last run action will take effect.

ENABLE_GL_STATE_CACHE

If enabled, cocos2d will maintain an OpenGL state cache internally to avoid unnecessary switches.
In order to use them, you have to use the following functions, instead of the the GL ones:
- cc.gl.useProgram() instead of glUseProgram()
- cc.gl.deleteProgram() instead of glDeleteProgram()
- cc.gl.blendFunc() instead of glBlendFunc()

If this functionality is disabled, then cc.gl.useProgram(), cc.gl.deleteProgram(), cc.gl.blendFunc() will call the GL ones, without using the cache.
It is recommend to enable whenever possible to improve speed.
If you are migrating your code from GL ES 1.1, then keep it disabled. Once all your code works as expected, turn it on.

TOUCH_TIMEOUT

用于甄别一个触点对象是否已经失效，并且可以被移除的延时时长 添加这个时长的原因是 X5 内核在微信浏览器中出现的一个 bug。 在这个环境下，如果用户将一个触点从底向上移出页面区域，将不会触发任何 touch cancel 或 touch end 事件，而这个触点会被永远当作停留在页面上的有效触点。 重复这样操作几次之后，屏幕上的触点数量将达到我们的事件系统所支持的最高触点数量，之后所有的触摸事件都将被忽略。 所以这个新的机制可以在触点在一定时间内没有任何更新的情况下视为失效触点并从事件系统中移除。 当然，这也可能移除一个真实的触点，如果用户的触点真的在一定时间段内完全没有移动（这在当前手机屏幕的灵敏度下会很难）。 你可以修改这个值来获得你需要的效果，默认值是 5000 毫秒。

BATCH_VERTEX_COUNT

最大可以被单次批处理渲染的顶点数量。

ENABLE_GC_FOR_NATIVE_OBJECTS

仅限 JSB 有意义，使用 JS 对象生命周期来控制 C++ 对象，或是相反，这标示了两种不同的内存模型， 它的值被 native 宏 CC_ENABLE_GC_FOR_NATIVE_OBJECTS 所控制，修改 JS 宏的值不会产生任何效果。

ENABLE_TILEDMAP_CULLING

是否开启瓦片地图的自动裁减功能。瓦片地图如果设置了 skew, rotation 的话，需要手动关闭，否则渲染会出错。

DOWNLOAD_MAX_CONCURRENT

下载任务的最大并发数限制，在安卓平台部分机型或版本上可能需要限制在较低的水平

ENABLE_TRANSPARENT_CANVAS

用于设置 Canvas 背景是否支持 alpha 通道，默认为 false，这样可以有更高的性能表现。 如果你希望 Canvas 背景是透明的，并显示背后的其他 DOM 元素，你可以在 cc.game.run 之前将这个值设为 true。 仅支持 Web

ENABLE_WEBGL_ANTIALIAS

用于设置在创建 WebGL Context 时是否开启 antialias 选项，默认值是 false。 将这个选项设置为 true 会让你的游戏画面稍稍平滑一些，比如旋转硬边贴图时的锯齿。是否开启这个选项很大程度上取决于你的游戏和面向的平台。 在大多数拥有 retina 级别屏幕的设备上用户往往无法区分这个选项带来的变化；如果你的游戏选择像素艺术风格，你也多半不会想开启这个选项。 同时，在少部分使用软件级别抗锯齿算法的设备或浏览器上，这个选项会对性能产生比较大的影响。 你可以在 cc.game.run 之前设置这个值，否则它不会生效。 仅支持 Web

ENABLE_CULLING

是否开启自动裁减功能，开启裁减功能将会把在屏幕外的物体从渲染队列中去除掉。 如果游戏中的动态物体比较多的话，建议将此选项关闭。 如果游戏中的静态物体比较多的话，建议将此选项打开。

BLEND_SRC

默认的混合源模式