cocos2d Programming Guide

The cocos2d Programming Guide provides in-depth documentation for writing applications that use cocos2d. Many topics described here reference the cocos2d API reference, provided separately.

If this is your first time reading about cocos2d, we suggest you start at Writing a cocos2d application .

• Introduction
• Installation, Dependencies and Compatibility
  • Dependencies
    • most of functionality
    • particles support
    • audio and video support by pyglet and ffmpeg
    • support for extra image file formats
    • audio support by SDL
  • Compatibility
  • Installing
  • Using PYTHONPATH or .pth
• Writing a cocos2d application
  • Hello, World
  • Hello Actions
  • Handling Events
  • Where to next?
• Basic Concepts
  • Scenes
  • Director
  • Layers
  • Sprites
  • Events
    • The pyglet event framework in a pinch
    • Cocos and events
• Actions, Transformations and Effects
  • Actions
  • Basic actions
  • Special Actions
  • Composition and modification of actions
  • Effects
    • How they work
    • 3D actions
    • Index of grid effects
    • Examples
  • Creating your own actions
    • Basic Internals
    • Instant Actions
    • Interval Actions
    • Grid Actions
• Scenes & Transitions
  • Using Director’s API
  • Transitions
• Tiled maps
  • Maps
  • The XML File Specification
  • XML file contents
  • Map, Cell and Tile Properties
  • Controlling Map Scrolling
  • Map Queries
  • Handling collisions between actors and tiles
  • Rectangular Maps
  • Support for .TMX maps with hexagonal tiles
  • Support for TMX object layers
• Map Colliders
  • Overview
    • Properly update the velocity and the position
    • Call appropriate methods when it detects actor bumped into an obstacle
    • Tell if any collision in the x and / or y axis happened
  • Variants
    • RectMapCollider
    • RectMapWithPropsCollider
    • TmxObjectMapCollider
  • How to use
• CocosNodes
  • CocosNode Functionality
    • Parent-child
    • Spatial Placement
    • Going in or out of the active scene
    • Render
    • Time management
    • Automated changes along the time (actions management)
  • Brief tour of built-in CocosNode subclasses
    • Scene
    • TransitionScene
    • Layer
    • ColorLayer
    • MultiplexLayer
    • ScrollingManager
    • ScrollableLayer
    • RectMapLayer and HexMapLayer
    • PythonInterpreterLayer
    • Sprite
    • Particle Systems
    • TextElement, Label, HTMLLabel, RichLabel
    • Menu
    • Menu items
    • Creating your CocosNode subclasses
  • CocosNodes Examples
    • Parent-Child examples
    • Spatial Placement snippets
    • Automated changes along the time snippets
• Built-in Python Interpreter
• Default Handlers
• Collision
  • Collision Model
    • Use cases
    • Simplified shapes
    • What an object must comply to be collidable ?
    • The role of collision manager
    • Limitations and weaknesees
    • More details
  • Performance numbers
    • The benchmark
    • Comparing with brute force
    • Shape comparisson
    • Ballpark fps
• Skeletal Animations
  • Creating Skeletons and skins
    • The skeleton file
    • The skin file
    • The skeleton editor
  • Animations
    • The animator editor
    • Playing animations
• A few tips on threading and multiprocessing