Archive for the 'cocos2d' Category

Since v0.5 cocos2d for iPhone supports TileMaps. Instead of using the original cocos2d tilemap format (cocos2d for PC) it is using a new format based on the PGU tilemap editor.

This editor lets you edit tiles, tile maps and tile codes.

How do you install the PGU tilemap editor ?

• Mac OS/X 10.5 already has python 2.5 installed, but you need to install MacPython (the pygame installer needs it): python-2.5-macosx.dmg
• Once you have installed MacPython, you need to install pygame: pygame-1.8.1release-py2.5-macosx10.5.zip
• And once you have installed pygame, install pyobjc-1.4: http://www.pygame.org/ftp/pyobjc-1.4-py2.5-macosx10.4.mpkg.zip
• And then you can download and uncompress the PGU level editor: pgu_level_editor-20081118.tar.gz (This is the standard PGU dist + cocos2d examples)

To run the PGU level editor do:

home:~ $ cd src/pgu_level_editorhome:~/src/pgu_level_editor $ python leveledit.py level.tga

The left panel is the map.
The upper-right panel are the tiles.
The bottom-right panel are the codes.

The map is loaded from the file: level.tga
The tiles are loaded from the file: tiles.tga
The codes are loaded from the file: codes.tga

For more info see the leveledit.ini file. eg: you can change the tiles’ size.

Features and limitations:

• cocos2d v0.6.1 (an earlier) doesn’t support codes, so ignore this feature for the moment.
• PGU tile editor uses the TGA RGB channels to identify the codes, tiles’ positions and (mmm… what else? I’m not sure). So, you can only have 256 different tiles per TileMap.

IMPORTANT: You need to convert the tiles.tga file to PNG (eg: tiles.png). To convert a TGA file to PNG you can use the GIMP editor.

How to use these files from cocos2d for iPhone:

• Include the tiles.png and level.tga to your XCode project
• See the AtlasDemo example: TestAtlas.m. In particular see the Atlas3 demo.

-(id) init{if( ![super init] )return nil;

TileMapAtlas *tilemap = [TileMapAtlas tileMapAtlasWithTileFile:@"tiles.png" mapFile:@"level.tga" tileWidth:16 tileHeight:16];[self add:tilemap];

return self;}

Update: Added missing pyobjc-1.4 package

Hey, I’ve just released cocos2d for iPhone v0.6.1

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

Changelog:

• Documentation: Generation of doc fixes (issue #105)
• Primitives: drawLine prototype fixed (issue #103)
• XCode: all projects have “thumb compilation” turned off (issue #104)

As you can see a the changelog is pretty small. But I decided to release a new release because of the “compile for thumb” thing. An article regarding “compilation for thumb” coming soon.

cocos2d v0.6 has a new way to propagate and most importantly, to stop the propagation of touch events.

The old interface was using the UIKit interface:

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event;- (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event;- (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event;- (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event;

The new interface is very similar, but instead of returning void, it now returns a BOOL, and since the return value can’t be used as part of the selector’s identity, the selector was renamed. The prefix ‘cc’ (short of cocos2d) was prepended. Example:

- (BOOL)ccTouchesBegan:(NSSet *)touches withEvent:(UIEvent *)event;- (BOOL)ccTouchesEnded:(NSSet *)touches withEvent:(UIEvent *)event;- (BOOL)ccTouchesMoved:(NSSet *)touches withEvent:(UIEvent *)event;- (BOOL)ccTouchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event;

If a certain layer handles the event then it should return kEventHandled, else it should return kEventIgnored.

Example taken from Menu.c:

- (BOOL)ccTouchesBegan:(NSSet *)touches withEvent:(UIEvent *)event{ UITouch *touch = [touches anyObject]; CGPoint point = [touch locationInView: [touch view]]; int idx;

 MenuItem *item = [self itemInPoint: point idx:&idx];

 if( item ) {     [item selected];     selectedItem = idx;

     // Event handled. It won't be propagated     return kEventHandled; }

 // event not handled. It will be propagated to the next // Layer on the stack return kEventIgnored;}

Which Layer is the first one to receive the event ?
The last Layer to be added. If this layer doesn’t return kEventHandled, then the event will be propagated to the next Layer on the stack.

cocos2d v0.6 introduces a manual way to align the items. You can align them both vertically and horizontally.
Prior to v0.6 the items were vertically aligned automatically. In v0.6 the automatic alignment feature was removed. If you want to align them you need to do this:

menu = [Menu menuWithItems:item1, item2, item3, nil];[menu alignItemsHorizontally];

or:

menu = [Menu menuWithItems:item1, item2, item3, nil];[menu alignItemsVertically];

Also, the previous vertical alignment algorithm had a bug, and wasn’t aligning the items in the center of the screen. If you want to use the old and buggy alignment algorithm you can do this:

menu = [Menu menuWithItems:item1, item2, item3, nil];[menu alignItemsVerticallyOld];

The alignItemsVerticallyOld is deprecated and will be removed in v0.7.

Tip: you can place your MenuItem as well as the Menu manually like any other CocosNode:

menu = [Menu menuWithItems:item1, item2, item3, nil];menu.position = cpv(0,0);item1.position = cpv(50,50);item2.position = cpv(200,200);

Working Example: MenuTest example. See MenuTest.m file.