cocos2d for iPhone
C Objective-C C++ Other
Pull request Compare This branch is 2535 commits ahead, 8332 commits behind cocos2d:v3.5.0.
Failed to load latest commit information.
CocosDenshion CocosDenshion compiles without warnings in x64 Apr 9, 2011
Resources-Mac Mac: Uses color an RGBA8 color buffer. Not a RGBA16 Apr 8, 2011
Resources-iPad/Images Resources: PNG images have a 72 dpi Jan 22, 2011
Resources Added support for Particle Designer 1.3.60 Apr 13, 2011
cocos2d-ios.xcodeproj add -ObjC option to OTHER_LDFLAGS of EAGLViewTest May 25, 2011
cocos2d-mac.xcodeproj Mac project: removed library path. Not needed. May 20, 2011
cocos2d.xcworkspace Xcode4: added performance tests to workscape. Apr 8, 2011
cocos2d Skew: Serveral fixes May 22, 2011
cocoslive Fixed memory leaks in cocoslive May 19, 2011
experimental Fixed issue #839 Nov 11, 2010
external Box2d: compiles without warnings in llvm 2.0 Apr 9, 2011
extras moving the proximity manager into it's own directory since it's not p… Oct 3, 2009
templates Fixed issue #1158 May 17, 2011
tests Skew: Serveral fixes May 22, 2011
tools Templates: subgroups + cocosdenshion in Mac Apr 8, 2011
.gitattributes Create standard ignore / attributes for Xcode git repositories Apr 1, 2010
.gitignore Issue 1159: Test doesn't use textures. It works OK with quads too. Apr 7, 2011
AUTHORS Updated AUTHORS & CHANGELOG for linebreak May 20, 2011
CHANGELOG Skew: Serveral fixes May 22, 2011
DONORS Updated DONORS May 18, 2011
LICENSE_Box2D.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_Chipmunk.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_FontLabel.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_TouchJSON.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_artwork.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_cocos2d.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_cocosdenshion.txt LICENSE files are .txt. Mar 24, 2011
LICENSE_libpng.txt LICENSE files are .txt. Mar 24, 2011
README.mdown Just a little typo - it should Snow Leopard 10.6 or Leopard 10.5 May 19, 2011
RELEASE_NOTES RenderTexture: Optimized for "begin" use, and not "beginWithColor" Mar 28, 2011
doxygen.config Fixed issue #1066 Dec 20, 2010
doxygen.footer added doxygen footer Mar 18, 2010 installer template: more verbose output so users know what it is bein… Apr 15, 2011


cocos2d for iPhone

cocos2d for iPhone is a framework for building 2D games, demos, and other graphical/interactive applications for iPod Touch, iPhone, iPad and Mac. It is based on the cocos2d design but instead of using python it, uses objective-c.

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
  • Fonts:
    • Fast font rendering using Fixed and Variable width fonts
    • Support for .ttf fonts
  • Texture Atlas support
  • Tile Map support: Orthogonal, Isometric and Hexagonal
  • Parallax scrolling
  • Motion Streak
  • Render To Texture
  • High Score server (cocosLive library)
  • Touch/Accelerometer on iOS
  • Touch/Mouse/Keyboard on Mac
  • Portrait and Landscape mode on iOS
  • Sound Engine support (CocosDenshion library) based on OpenAL
  • Integrated Pause/Resume
  • Integrated Slow motion/Fast forward
  • Fast textures: PVR compressed and uncompressed textures
  • Point based: iPhone4 + RetinaDisplay mode compatible
  • Language: objective-c
  • Open Source: Compatible with open and closed source projects
  • OpenGL ES 1.1 (iOS) / OpenGL 1.5 based (Mac)

This library does not work with the toolchain, but it should be easy to port it to it.

Build Requirements

Mac OS X 10.6, Xcode 3.2.3 (or newer)

Runtime Requirements

  • iOS 3.0 or newer for iOS games
  • Snow Leopard (v10.6) or newer for Mac games

Files and Folders

  • cocos2d/
    core files and folders of cocos2d
  • cocoslive/
    high score client library
  • CocosDenshion/
    sound engine library
  • tests/
    tests, demo examples
  • templates/ folder that contains the Xcode templates
  • experimental/
    experimental stuff
  • external/
    3rd party libraries used by cocos2d or any other project.
    • Chipmunk/: physics library
    • Box2d/: physics library
    • TouchJSON/: JSON parser
    • Tremor/: OGG audio decoder

How to run the tests

Xcode -> View -> Customize toolbar
Then, drag "Active Target" and "Active Executable" to your top project tool bar. Select the test you want to view in both drop downs and hit Build and Go.

How to start a new game

Run the '' script: $ cd cocos2d-iphone $ ./ -u -f And then open XCode -> New Project -> User Templates -> cocos2d

How to contribute to the project

Did you find a bug ? Do you have feature request ? Do you want to merge a feature ?