cocos2d for iPhone v0.8.2-beta Release Notes

You can download cocos2d for iPhone v0.8.2-beta from here:

http://cocos2d-iphone.googlecode.com/files/cocos2d-iphone-0.8.2-beta.tar.gz

_{cocos2d v0.8.2-beta is SVN revision 1397}

You can find the v0.8.2-beta documentation here:

• API Reference: API reference v0.8.2-beta
• Programming Guide: Programming Guide v0.8

To understand how fast cocos2d v0.8.2-beta is, please see the performance tests:

• v0.8.2 Performance Test

Issue #530, #546

New ease actions were added:

• Support for Ease Elastic actions: In, Out and InOut
• Support for Ease Bounce actions: In, Out and InOut

Full example:

• EaseActionsTest.m

Issue #534

FontLabel is a subclass of UILabel that let's you load any TTF (True Type Font) file.

Since cocos2d v0.8.2 you can use load your custom .ttf font using the Label class. Example:

// simple API
Label *label = [Label labelWithString:@"hello world" fontName:@"Paint Boy" fontSize:24];
 
// more complex API
Label *label2 = [Label labelWithString:@"hello world" dimensions:CGSizeMake(480,50) alignment:UITextAlignmentLeft fontName:@"Paint Boy" fontSize:32];

Full example:

• FontTest.m

Issue #522

A new PageTurnTransition was added. It simulates the movement of turning a page. You can turn the page forward or backwards.

Full example:

• TransitionsTest.m

Issue #517, #536, #537, #538

Improvements:

• Fixed bugs related to the spacing and contentSize

BitmapFontAtlas should render without problems any kind of fonts

Issue #494

Improvements:

• Added Box2D r21.
• Box2d + Coco2d testbed were updated
• Box2d demo updated

A new template that includes cocos2d + box2d was added. To use it, just do:

$ cd cocos2d-iphone
$ . ./install_template.sh

Issue #526, #545

Improvements:

• Added muted property in SimpleAudioEngine
• Added preloadBackgroundMusic and willBackgroundMusicPlay in SimpleAudioEngine

Issue #528

Improvements:

• Added a method that returns the bounding box taking into account any transformation. Useful for ad-hoc collision detection

Issue #531, #524, #560,

Improvements:

• Fixed leaks en calling Director#end
• Default buffer pixel format is: RGBA 8888. Before it was RGB 565.
• Added 2 new types of Directors:
  • DisplayLink director, that uses CADisplayLink (only available on SDK 3.1 or greater)
  • Threaded director, that calls the main loop from a thread, but the main loop executes on the main thread.
• added a way convert coordinates to the UI world.

Issue #XXX

Improvements:

• Added RenderTexture example

Compatibility issues with version 0.8.1

The following files were added to cocos2d:

• cocos2d/ccConfig.h
• cocos2d/PageTurn3DAction.h
• cocos2d/PageTurn3DAction.m
• cocos2d/PageTurnTransition.h
• cocos2d/PageTurnTransition.m
• external/FontLabel/*

The following files were removed from cocos2d:

• None

Full changelog: CHANGELOG

version 0.8.2 - XX-MMM-2009

• All: ccConfig.h file added (issue #551)
• Actions: added Ease Elastic actions (issue #530)
• Actions: added Ease Bounce actions (issue #546)
• Actions: added PageTurn3D action (issue #522)
• BitmapFontAtlas: fixed contentSize (issue #536, #538)
• BitmapFontAtlas: fixed offset/width (issue #537)
• BitmapFontAtlas: only supports Latin 1 chars (issue #517)
• Box2d: using google code r21 (pre v2.1.0) (issue #494)
• CocosDenshion: muted property in SimpleAudioEngine (issue #526)
• CocosDenshion: added preloadBackgroundMusic and willBackgroundMusicPlay to SimpleAudioEngine (issue #545)
• CocosNode: improved doxygen documentation (issue #XXX)
• CocosNode: added boundingBox method (issue #528)
• Director: added convertToUI and renamed convertCoordinate to convertToGL (issue #531)
• Director: fixed 2 leaks on Director#end (issue #524)
• Director: Added a threaded FastDirector (issue #560)
• Director: Added a CADisplayLink Director (issue #560)
• Director: buffer default pixel format is RGBA_8888
• Documentation: doxygen builds OK when there are spaces in the path (issue #540)
• Label / Texture2D: Supports any .ttf via FontLabel (issue #534)
• LabelAtlas: works with 256 different chars (issue #516)
• RenderTexture: added RenderTexture test (issue #XXX)
• Resources: improved directory structure (issue #552)
• Template: using removeUnusedTextures (issue #550)
• TileMap: TMX supports multiple tilesets (1 tileset per layer) (issue #510)
• TileMap: TMX raises expection if map is not encoded and/or gzipped (issue #559)
• Transition: ease actions can be overriden (issue #548)
• Transition: added PageTurnTransition (issue #522)