axmol/docs/RELEASE_NOTES.md

96 lines
4.4 KiB
Markdown
Raw Normal View History

2015-01-15 08:59:03 +08:00
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [Cocos2d-x 3.13 Release Notes](#cocos2d-x-313-release-notes)
2015-01-15 08:59:03 +08:00
- [Misc Information](#misc-information)
- [v3.13](#v313)
- [Highlights](#highlights)
- [The main features in detail of Cocos2d-x v3.13](#the-main-features-in-detail-of-cocos2d-x-v313)
- [Add VR plugin](#add-vr-plugin)
- [Support ETC1 alpha channel](#support-etc1-alpha-channel)
- [AudioEngine performance for Android 4.2+](#audioengine-performance-for-android-42)
- [Dirty region in canvas renderer](#dirty-region-in-canvas-renderer)
- [Android arm-64 support](#android-arm-64-support)
- [Switch to use gcc 4.9 on Android](#switch-to-use-gcc-49-on-android)
- [Upgrade CURL to 7.50.0](#upgrade-curl-to-7500)
2015-01-15 08:59:03 +08:00
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
2016-08-04 09:48:55 +08:00
# Cocos2d-x 3.13 Release Notes #
2015-07-01 18:44:15 +08:00
2014-01-07 08:23:06 +08:00
# Misc Information
2015-03-13 17:18:29 +08:00
* [Full Changelog](https://github.com/cocos2d/cocos2d-x/blob/v3/CHANGELOG)
2014-01-07 08:23:06 +08:00
2016-08-04 09:48:55 +08:00
# v3.13
2015-04-22 14:59:22 +08:00
## Highlights
2015-08-24 09:40:59 +08:00
2016-08-23 11:47:08 +08:00
* added VR plugins for Gear, Deepoon, Google Cardboard and Oculus.
2016-08-04 09:48:55 +08:00
* support ETC1 alpha channel
* fix AudioEngine performance for Android 4.2+
* improve canvas renderer performance with dirty region
2016-08-04 09:48:55 +08:00
* add Andorid arm-64 support
* switch to use gcc 4.9
* upgrade CURL to 7.50.0
* upgrade Spine to 3.4
* upgrade GLFW to 3.2
2016-08-04 09:48:55 +08:00
## The main features in detail of Cocos2d-x v3.13
2016-08-23 11:47:08 +08:00
### Added VR plugins
2016-08-23 11:47:08 +08:00
Support for Gear, Deepoon, Google Cardboard and Oculus has been added. Read about VR in our [Programmers Guide](http://www.cocos2d-x.org/docs/programmers-guide/vr/index.html)
2016-05-04 11:54:38 +08:00
2016-08-04 09:48:55 +08:00
### Support ETC1 alpha channel
2016-05-04 11:54:38 +08:00
2016-08-04 09:48:55 +08:00
Thanks [halx99](https://github.com/halx99)'s contribution, now cocos2d-x supports ETC1 alpha channel by default.
2016-05-04 11:54:38 +08:00
2016-08-04 09:48:55 +08:00
If want to use ETC1 alpha chaneel, you should put `xxx.pkm` and `xxx.pkm@alpha` in the same folder, and use it like this:
2016-08-04 09:48:55 +08:00
```c++
auto sprite = Sprite::create("xxx.pkm");
```
`xxx.pkm@alpha` is the resource for alpha channel. `@alpha` subfix is required by engine to load alpha texture automatically.
More detail usage can refer to the implementation of `Sprite1ETC1Alpha` in `tests/cpp-tests/Classes/SpriteTest/SpriteTest.cpp`.
![](https://raw.githubusercontent.com/minggo/Pictures/master/etc1-alpha.png)
As you can see, the blue block in the middle of the picture is an ETC1 picture with alpha channel.
2016-08-04 09:48:55 +08:00
### AudioEngine performance for Android 4.2+
2016-06-28 17:21:43 +08:00
2016-08-04 09:48:55 +08:00
AudioEngine uses [OpenSL ES](https://developer.android.com/ndk/guides/audio/opensl-for-android.html) on Android, and it supports decoding audio source file to PCM data in codes since Android 4.2. Now AudioEngine uses this feature to fix the performance issue. The performane is the same as before if running on Android 4.1 or lower version.
2016-06-28 17:21:43 +08:00
### Dirty region in canvas renderer
In v3.12, we improved WebGL renderer in the web engine, this version have brought the dirty region algorithm to improve canvas renderer performance. Basically, it detect every region that have been changed between frames, then only render these parts instead of refresh the whole canvas. This technique is beneficial for many games in which the dynamic region is often limited, it can improve frame rate and reduce CPU usage, power consumation. It's desactivated by default, to activate it, you can do the following:
```
// Enable dirty region algorithm
if (cc._renderType === cc.game.RENDER_TYPE_CANVAS) {
cc.renderer.enableDirtyRegion(true);
// Maximum dirty region count to activate the partial rendering process
cc.renderer.setDirtyRegionCountThreshold(6);
}
// Detect if dirty is enabled
var enabled = isDirtyRegionEnabled();
```
2016-08-04 09:48:55 +08:00
### Android arm-64 support
Now we provide arm-64 bit 3rd party libraries, which means can build 64-bit apps on Android. You can use the command to build 64-bit apps:
```
cocos run -p android --app-abi arm64-v8a
```
2016-06-28 17:21:43 +08:00
### Switch to use gcc 4.9 on Android
2016-08-04 09:48:55 +08:00
cocos2d-x switch to use clang in `v3.12`, but developers reported [some crash issue](https://github.com/cocos2d/cocos2d-x/issues/16244) that caused by using `clang+gnustl_static`, so we switch to use gcc 4.9. We will change to use `clang+c++_static` when `c++_static` is stable.
2016-07-06 14:35:15 +08:00
2016-08-04 09:48:55 +08:00
### Upgrade CURL to 7.50.0
2016-08-04 09:48:55 +08:00
Because CURL has [a bug about connect to IPV4 numerical IP address in NAT64 environment](https://github.com/curl/curl/issues/863), and it is fixed in v7.50.0, so we upgrade to this version when v7.50.0 is released.