cocos2d for iPhone v0.8.1 Release Notes

You can download cocos2d for iPhone v0.8.1 from here:

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

_{cocos2d v0.8.1 is SVN revision 1321}

You can find the v0.8.1 documentation here:

• API Reference: API reference v0.8.1
• Programming Guide: Programming Guide v0.8

To understand how fast cocos2d v0.8.1 is, please see the performance tests:

• v0.8.1 Performance Test

Issues #462, #473

tiled is an open source tile map editor that supports:

• orthogonal maps
• isometric maps
• and hexagonal maps

Since v0.8.1, it's possible to use the maps generated by tiled in your games.

For more information about how to use it, please, read the programming guide:

• How to use TMX maps in cocos2d

Example:

• tests/TileMapTest.m

Issue #XXX

The new RenderTexture class let's you render CocosNode objects into an OpenGL texture.

Features:

• You can save the texture into a file: .PNG and .JPEG formats
• You can edit the texture like any other OpenGL texture
• You can create an UIImage from the texture

Issue #480

ParticleView is a cocos2d particle editor. It let's you edit all the particle's properties.

To run it:

1. Open cocos2d-iphone.xcodeproj
2. select the ParticleView target
3. run the selected target

The ParticleView source code is in:

• tools/ParticleView

Issue #521

cocos2d has a new official logo. For more information about the new logos, see this page: cocos2d logos

Issue #481, #490

The bug that was causing random crashes, specially in games with several actions, was fixed.

Also, a bug related to removing all actions + scheduling new actions was fixed.

Issue #464

Improvements:

• .fnt files as well as .png files can be loaded from subfolders

Issues #493, #494

Improvements:

• Box2d svn r10 from google code was integrated into cocos2d.
• The DrawDebugData method can be used within cocos2d.
• Box2d TestBed integrated into cocos2d

Box2d integration is also an stable feature (promoted from experimental)

How to use world#DrawDebugData:

-(id) init
{
	if( (self=[super init])) {
		// Define the gravity vector.
		b2Vec2 gravity;
		gravity.Set(0.0f, -10.0f);
 
		// Do we want to let bodies sleep?
		bool doSleep = true;
 
		// Construct a world object, which will hold and simulate the rigid bodies.
		world = new b2World(gravity, doSleep);
 
		world->SetContinuousPhysics(true);
 
		m_debugDraw = new GLESDebugDraw( PTM_RATIO );
		world->SetDebugDraw(m_debugDraw);
 
		uint32 flags = 0;
		flags += b2DebugDraw::e_shapeBit;
		flags += b2DebugDraw::e_jointBit;
		flags += b2DebugDraw::e_aabbBit;
		flags += b2DebugDraw::e_pairBit;
		flags += b2DebugDraw::e_centerOfMassBit;
		m_debugDraw->SetFlags(flags);
	}
	return self;
}	
 
// draw the shapes at "draw" time
-(void) draw
{
	[super draw];
	glEnableClientState(GL_VERTEX_ARRAY);
	world->DrawDebugData();
	glDisableClientState(GL_VERTEX_ARRAY);
}

Full example:

• tests/Box2dTest.mm

Issues #465, #486, #498, #513

Some fixes a some enhancements were added to the CocosDenshion sound engine.

Issues #476 #482

Improvements:

• parent property is set to nill only after calling onExit
• added the userData property

The userData is a void* property can be used for the purpose that you want.

sprite1.userData = (void*) 10;
sprite2.userData = (void*) sprite1;
 
int value = (int) sprite1.userData;

Issues #405 #484

Improvements:

• The API was updated in a way that is uses the new cocos2d v0.8 structures.
• New examples were added

The MotionStreak feature was promoted from experimental to stable.

Full example:

• tests/MotionStreatTest.m

Issue #471

Since v0.8.1 the parallax scroller updates it's children at visit time, just after all the possible updates were executed. This guarantees that the children position will have the correct ratio, thus, preventing possible flickers.

Issue #514

The bug that was rendering huge particles (particles with negative size) on the iPhone 3GS was fixed.

Issue #469

A cocos2d application template was added, and the MyFirtGame project was removed. The template is more useful than MyFirstGame project, since it let's you start a new cocos2d empty project with a single click every time that you want.

How to:

1. Install the template
   1. Open a terminal
   2. $ cd cocos2d-iphone
   3. $ . ./install_template.sh
2. Open XCode
   1. XCode → File → New Project
   2. iPhone Application → cocos2d v0.8.1 Application

The template comes with:

• cocos2d
• CocosDenshion
• cocoslive
• and a HelloWorld scene

You can easily add/remove frameworks/libraries to the created project.

Compatibility issues with version 0.8.0

• None

The following files were added to cocos2d:

• TMXTiledMap.h
• TMXTiledMap.m
• TMXXMLParser.h
• TMXXMLParser.m
• MotionStreak.h
• MotionStreak.m
• RenderTexture.h
• RenderTexture.m
• Support/ZipUtils.h
• Support/ZipUtils.m
• Support/base64.c
• Support/base64.h

The following files were removed from cocos2d:

• None

Full changelog: CHANGELOG

• ActionManager: doesn't delete running actions (issue #481)
• Box2d: using google code r10 (v2.1.0) (issue #494)
• CocosDenshion: resumeBackground music (issue #513)
• MultiplexLayer: removes child using cleanup:YES (issue #466)
• Particles: no negative size (issue #514)
• Resources: added new cocos2d logos (issue #521)
• Template: added Icon.png and Default.png (part of issue #469)
• Texture2D: using CCLOG instead of NSLog+#ifdef (issue #519)

• All: Using nonatomic properties (issue #509)
• ActionManager: fixed crash (issue #490)
• Actions: RotateTo always rotates to shortest angle fix (issue #499)
• Box2d: using google code r8 (issue #494)
• Box2d: added box2dTestBed (part of issue #494)
• CocosDenshion: correct channel in SimpleAudioEngine (issue #465)
• CocosDenshion: update buffer status after deletion ( issue #486)
• CocosDenshion: SimpleAudioEngine can stop sounds (issue #498)
• Parallax: update children at draw (issue #471)
• TileMap: TMX maps starts at 0,0 position (part of issue #462)
• TileMap: TMX getter/setters works OK with async maps (issue #506)
• TileMap: anchorPoint works OK (issue #508)
• XCode: COCOS2D_DEBUG used instead of DEBUG (issue #507)

• BitmapFontAtlas: .png image can be in subfolders (issue #464)
• Box2d: possibility to call world.DrawDebugData() from draw (issue #493)
• Box2d: updated box2d repository. using r228 (issue #494)
• CocosNode: parent is set to nil only after calling onExit (issue #476)
• CocosNode: added user data (issue #482)
• CocosLive: added support to request current ranking (issue #495)
• MotionStreak: moved from experimental to stable. uses v0.8 API (issue #484)
• MotionStreak: by default uses GL_SRC_ALPHA blend function (issue #405)
• ParticleView: integrated Particle visual editor (issue #480)
• Parallax: more precise absolute coords (issue #471)
• RenderTexture: let's you render CocosNode objects into a texture (issue #XXX)
• Template: added XCode cocos2d Template (issue #469)
• TextureMgr: Async reuses EAGL context (issue #472)
• tools: added mkatlas.pl script (issue #483)
• TiledMap: Added support for the TMX format: iso, ortho and hex maps (issue #462)
• TouchDispatcher: don't dispatch empty touches (issue #468)