Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
cocos2d for iPhone
Objective-C C C++ Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
CocosDenshion
Resources
cocos2d-iphone.xcclassmodel
cocos2d-iphone.xcodeproj
cocos2d
cocoslive
experimental
external
templates
tests
tools
AUTHORS
CHANGELOG
DONORS
LICENSE
LICENSE.FontLabel
LICENSE.TouchJSON
LICENSE.artwork
LICENSE.box2d
LICENSE.chipmunk
LICENSE.cocosdenshion
LICENSE.libpng
README
doxygen.config
install_template.sh

README

cocos2d for iPhone
------------------

cocos2d for iPhone[1] is a framework for building 2D games, demos, and other
graphical/interactive applications. It is based on the cocos2d [2] (python)
design:
  it uses the same API and 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, etc.
        * Misc actions: CallFunc, OrbitCamera
    * 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
    * Parallax scrolling
    * Motion Streak
    * High Score server (cocosLive library)
    * Touch/Accelerometer
    * Portrait and Landscape mode
    * Sound Engine support (CocosDenshion library)
    * Integrated Pause/Resume
    * Integrated Slow motion/Fast forward
    * Fast textures: PVRTC 2-bit & 4-bit textures, RGBA 16-bit (and 32-bit) textures
    * Language: objective-c
    * Open Source: Compatible with open and closed source projects
    * OpenGL ES 1.1 based


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


Build Requeriments
------------------

Mac OS X 10.5.3, Xcode 3.1, iPhone OS 2.0, Beta 8 release or later


Runtime Requirements
--------------------

Mac OS X 10.5.3, iPhone OS 2.0, Beta 8 release or later


Files and Folders
-----------------

  * cocos2d/
     core files and folders of cocos2d
  * cocoslive
     high score client library
  * CocosDenshion
     sound engine library
  * tests/
     tests, demo and template examples     
  * 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 'install_template.sh' script:
$ ./install_template.sh
And then open XCode -> New Project -> cocos2d iphone Application



[1] http://www.cocos2d-iphone.org
[2] http://www.cocos2d.org
Something went wrong with that request. Please try again.