mirror of https://github.com/axmolengine/axmol.git
9d5813b7d9
1) Moving the implementation of JSStringWrapper to .cpp file. Removing override operator() which will be easy to make errors. 2) Deleting JSCallFuncWrapper since it isn’t needed after using std::function for MenuItem’s Callback. 3) Fixing ChipmunkTest crash sometimes on MAC platform(64bit). |
||
|---|---|---|
| build | ||
| cocos | ||
| docs | ||
| extensions | ||
| external | ||
| licenses | ||
| plugin@8f01fc10fc | ||
| samples | ||
| template | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .travis.yml | ||
| AUTHORS | ||
| CHANGELOG | ||
| CMakeLists.txt | ||
| README.md | ||
README.md
cocos2d-x
cocos2d-x is a multi-platform framework for building 2d games, interactive books, demos and other graphical applications. It is based on cocos2d-iphone, but instead of using Objective-C, it uses C++. It works on iOS, Android, OS X, Windows, Linux, Emscripten, Google Native Client, BlackBerry and Tizen.
cocos2d-x is:
- Fast
- Free
- Easy to use
- Community Supported
How to start a new game
-
Download the code from cocos2d download site
-
Enter
tools/project-creator -
Run the
create-projects.pyscript
Example:
$ cd cocos2d-x/tools/project-creator
$ ./create-multi-platform-projects.py -p mygame -k com.your_company.mygame -l cpp
$ cd ../../projects/mygame
Main features
- Scene management (workflow)
- Transitions between scenes
- Sprites and Sprite Sheets
- Effects: Lens, Ripple, Waves, Liquid, etc.
- Actions (behaviours):
- Trasformation Actions: Move, Rotate, Scale, Fade, Tint, etc.
- Composable actions: Sequence, Spawn, Repeat, Reverse
- Ease Actions: Exp, Sin, Cubic, Elastic, etc.
- Misc actions: CallFunc, OrbitCamera, Follow, Tween
- Basic menus and buttons
- Integrated with physics engines: Box2d and Chipmunk
- Particle system
- Skeleton Animations: Spine and Armature support
- Fonts:
- Fast font rendering using Fixed and Variable width fonts
- Support for .ttf fonts
- Tile Map support: Orthogonal, Isometric and Hexagonal
- Parallax scrolling
- Motion Streak
- Render To Texture
- Touch/Accelerometer on mobile devices
- Touch/Mouse/Keyboard on desktop
- Sound Engine support (CocosDenshion library) based on OpenAL
- Integrated Slow motion/Fast forward
- Fast and compressed textures: PVR compressed and uncompressed textures, ETC1 compressed textures, and more
- Resolution Independence
- Language: C++, with Lua and JavaScript bindings
- Open Source Commercial Friendly: Compatible with open and closed source projects
- OpenGL ES 2.0 (mobile) / OpenGL 2.1 (desktop) based
Build Requirements
- Mac OS X 10.7+, Xcode 4.6+
- or Ubuntu 12.10+, CMake 2.6+
- or Windows 7+, VS 2012+
Runtime Requirements
- iOS 5.0+ for iPhone / iPad games
- Android 2.3+ for Android games
- OS X v10.6+ for Mac games
- Windows 7+ for Win games
Running Tests
Select the test you want from Xcode Scheme chooser.
- For OS X / iOS
$ cd cocos2d-x/build
$ open samples.xcodeproj
- For Linux
$ cd cocos2d-x
$ cmake CMakeLists.txt
$ make
- For Windows
Open the cocos2d-x/build/cocos2d-win32.vc2012.sln
- For Android
$ cd cocos2d-x/build
$ python ./android-build.py hellocpp
Import HelloCpp Android project using Eclipse(released with Android SDK). The path to be imported is cocos2d-x/samples/Cpp/HelloCpp/proj.android.
Contributing to the Project
Did you find a bug? Do you have feature request? Do you want to merge a feature?
Contact us
- Forum: http://forum.cocos2d-x.org
- Twitter: http://www.twitter.com/cocos2dx
- Weibo: http://t.sina.com.cn/cocos2dx
- IRC: https://webchat.freenode.net/ (#cocos2d and #cocos2d-x channels)