Sorry, i know already.
[CCSprite spriteWithBatchNode:spriteManager rect:rect]

I am the beginner for cocos2d. and i got this code about AtlasSpriteManager. then i know that AtlasSpriteManager is already deprecated. i try to change this code.

AtlasSpriteManager *spriteManager = [AtlasSpriteManager spriteManagerWithFile:@"sprites.png" capacity:10];
	[self addChild:spriteManager z:-1 tag:kSpriteManager];

	AtlasSprite *background = [AtlasSprite spriteWithRect:CGRectMake(0,0,320,480) spriteManager:spriteManager];
	[spriteManager addChild:background];
	background.position = CGPointMake(160,240);

into this.

CCSpriteBatchNode *spriteManager = [CCSpriteBatchNode batchNodeWithFile:@"sprites.png" capacity:10];
	[self addChild:spriteManager z:-1 tag:kSpriteManager];

	CCSprite *background = [CCSprite spriteWithFile:spriteManager rect:CGRectMake(0,0,320,480)];
	[spriteManager addChild:background];
	background.position = CGPointMake(160,240);

and i got this warning. it is the way im doing it correct?
warning: incompatible Objective-C types 'struct CCSpriteBatchNode *', expected 'struct NSString *' when passing argument 1 of 'spriteWithFile:rect:' from distinct Objective-C type

I has more functionality, but it should work in the same way.

Sorry to cross-post, but I'm confused about this too. I posted something about it here http://www.cocos2d-iphone.org/forum/topic/9729 already, but I guess the question is:

Is CCSpriteBatchNode a rename of CCSpriteSheet, or does it have other functionality/limitations? I can't seem to get it to work the same way as I used AtlasSpriteManager in 0.8.1.

It's was renamed to CCSpriteSheet, then I think it was renamed again in last version to CCSpriteBatchNode.

I'm new to Cocos2d but i like it a lot. I have a long flash history and it gives me a comfortable feeling.
In a tutorial i followed i saw the use of the AtlasSpriteManager but it seems to be gone.

Is it replaced or does the functionallity not excists anymore?
I can see that there is an implementation in CCCompatibility.h

So can i still use it?

ah yeah, makes sense then.

I think the good use of the rotate feature in zwoptex is to be able to better use all the available space in the 1024x1024 texture. There are some sprites that are too much tall that would better fit if they were rotated.

I also use the free version, so I'm just imagining it's one of the useful things when using it.

See ya!

Yeah, I'm stuck in 0.8.2 yet, will try to update at some point, but in the mean time I'm polishing/optimizing my game.
I was using the free online version of zwoptex, no rotation there.
But why do you think we need rotation? Maybe it's only me but I can't think of a good use of rotation on my sprite frames, whenever I need to reuse the same sprite frame in different orientation, I just flip/rotate in run time.

Not that I use 0.8.2, but I just wanted to point out that zwoptex also supports rotation.

I didn't see it in you code. Although i could have missed it, and it may be only in the purchased version that it supports rotation.

If anyone was using this class, I recommend update with following code, as it was preventing to use multiple sprite sheets, stupid me used a static class variable to store the frames, so here it goes the new update:

#import "cocos2d.h"

@interface SpriteManager : AtlasSpriteManager {
	int formatPlist;
	NSDictionary *frames;
}

+(id)spriteManagerWithFile:(NSString*)fileImage plist:(NSString*)plist capacity:(NSUInteger)capacity;
+(id)spriteManagerWithFile:(NSString*) imageFile plist:(NSString*)plist;
-(id)initWithFile:(NSString *)fileImage plist:(NSString*)plist capacity:(NSUInteger)capacity;
-(void)createDictionaryFromPlist:(NSString*)plist;

-(CGRect)createRectangle:(NSString*) imageFileName;
-(AtlasSprite *)createSprite:(NSString*) imageFileName className:(NSString *)className;

@end

#import "SpriteManager.h"

const int _defaultCapacity = 29;

@implementation SpriteManager

+(id)spriteManagerWithFile:(NSString*)imageFile plist:(NSString*)plist capacity:(NSUInteger)capacity
{
	return [[[SpriteManager alloc] initWithFile:imageFile plist:plist capacity:capacity] autorelease];
}

+(id)spriteManagerWithFile:(NSString*) imageFile plist:(NSString*)plist
{
	return [[[SpriteManager alloc] initWithFile:imageFile plist:plist capacity:_defaultCapacity] autorelease];
}

-(id)initWithFile:(NSString *)fileImage plist:(NSString*)plist capacity:(NSUInteger)capacity
{
	self = [super initWithFile:fileImage capacity:capacity];

	[self createDictionaryFromPlist:plist];

	return self;
}

-(void)createDictionaryFromPlist:(NSString*)plist
{
	NSString *path = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:plist];
	NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path];
	NSDictionary *metadataDict = [dict objectForKey:@"metadata"];

	// get the format
	if (metadataDict != nil) {
		formatPlist = [[metadataDict objectForKey:@"format"] intValue];
	} else {
		formatPlist = 0;
	}

	frames = [[dict objectForKey:@"frames"] retain];

	//NSLog(@"SpriteManager.spriteManagerWithFile: %@", frames);
}

-(CGRect)createRectangle:(NSString*) imageFileName
{
	if(formatPlist == 0) {
		NSDictionary *properties = [frames objectForKey:imageFileName];
		//NSLog(@"SpriteManager.createSprite: %@", properties);

		float x = [[properties objectForKey:@"x"] floatValue];
		float y = [[properties objectForKey:@"y"] floatValue];
		float w = [[properties objectForKey:@"width"] floatValue];
		float h = [[properties objectForKey:@"height"] floatValue];
		//float ox = [[properties objectForKey:@"offsetX"] floatValue];
		//float oy = [[properties objectForKey:@"offsetY"] floatValue];
		//int ow = [[properties objectForKey:@"originalWidth"] intValue];
		//int oh = [[properties objectForKey:@"originalHeight"] intValue];

		return CGRectMake(x, y, w, h);

	} else if (formatPlist == 1) {
		NSDictionary *properties = [frames objectForKey:imageFileName];
		//NSLog(@"SpriteManager.createSprite: %@", properties);

		CGRect frame = CGRectFromString([properties objectForKey:@"frame"]);
		//CGPoint offset = CGPointFromString([properties objectForKey:@"offset"]);
		//CGSize sourceSize = CGSizeFromString([properties objectForKey:@"sourceSize"]);

		return frame;

	} else {
		NSAssert(NO,@"cocos2d: WARNING: format is not supported for SpriteManager");
		return CGRectMake(0, 0, 0, 0);
	}
}

-(AtlasSprite *)createSprite:(NSString*) imageFileName;
{
	return [AtlasSprite spriteWithRect:[self createRectangle:imageFileName] spriteManager:self];
}

-(void) dealloc {
	[frames release];
	[super dealloc];
}

@end

If any problems please let me know.

Ok, forget my question, managed to alter the draw method on the AtlasSpriteManager.

Hi, sorry to jump on this old thread, but I am trying to do exactly the same, I'm finally porting all my sprites to a sprite sheet, before on my sprites subclass I overwrote the draw method so I could draw a bouncing box around, note I'm working with isometric so the default cocos2d debug bouncing box is not what I needed, I do draw an isometric 3d rectangle enclosing my objects so I could debug the collision and stuff, like the image:

So Steve, are you saying this is not possible to do? I am stuck on 0.8.2 so using old AtlasManager / AtlasSprite.

Cool, let me know if you have any problems.

Hey,

I am having trouble with using the AtlasSpriteManager in the latest XCODE 3.2.3. It doesn't recognize it. I get the error "AtlasSpriteManager not declared here'. Does it have something to do with the new SDK or do I need to import ne file?

Thanks
Abhinav

thanks
i try that now. I have same constraints, stucked in 0.82 and i updated to 0.99 but had lot of performance problems. So get back to 0.82.

Ok, found an easy solution, using Zwoptex just be sure before exporting the texture/coordinates, you untrim all images, select all images, then go to Modify > Untrim Selected Images.
Basically Zwoptex trim by default any 100% transparent border left on the images, and adds the offsets. If we untrim all images, then offsets will be zero, so we can just use the code I posted above. Remember use the updated SpriteManager.m on the third post, where we ignore the offsets.

Ok, I figured out the problem, I need to draw the sprite on the x/y coordinates plus the x/y offsets. So I guess I need to create a category of Sprite again to add the offsets when drawing. It's actually what id does the CCSprite in v0.99.3 I think.

Sorry, just to update we do need to use the offset and the original size as well, not sure yet how, tryign to figure out. Will psot update as soon as I am 100% sure. Or if anyone has an idea, please share!

Umm, I may be wrong, but I think we can ignore the offset, definitively I dind't need it on my first tests:

SpriteManager.m:

#import "SpriteManager.h"

const int _defaultCapacity = 29;

@implementation AtlasSpriteManager (SpriteManager)

+(id)spriteManagerWithFile:(NSString*)fileImage plist:(NSString*)plist capacity:(NSUInteger)capacity
{
	[AtlasSpriteManager createDictionaryFromPlist:plist];
	return [[[AtlasSpriteManager alloc] initWithFile:fileImage capacity:capacity] autorelease];
}

+(id)spriteManagerWithFile:(NSString*) imageFile plist:(NSString*)plist
{
	[AtlasSpriteManager createDictionaryFromPlist:plist];
	return [[[AtlasSpriteManager alloc] initWithFile:imageFile capacity:_defaultCapacity] autorelease];
}

+(void)createDictionaryFromPlist:(NSString*)plist
{
	NSString *path = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:plist];
	NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path];
	NSDictionary *metadataDict = [dict objectForKey:@"metadata"];

	// get the format
	if (metadataDict != nil) {
		formatPlist = [[metadataDict objectForKey:@"format"] intValue];
	} else {
		formatPlist = 0;
	}

	frames = [dict objectForKey:@"frames"];

	//NSLog(@"SpriteManager.spriteManagerWithFile: %@", frames);
}

-(AtlasSprite *)createSprite:(NSString*) imageFileName
{
	if(formatPlist == 0) {
		NSDictionary *properties = [frames objectForKey:imageFileName];
		float x = [[properties objectForKey:@"x"] floatValue];
		float y = [[properties objectForKey:@"y"] floatValue];
		float w = [[properties objectForKey:@"width"] floatValue];
		float h = [[properties objectForKey:@"height"] floatValue];
		//float ox = [[properties objectForKey:@"offsetX"] floatValue];
		//float oy = [[properties objectForKey:@"offsetY"] floatValue];
		//int ow = [[properties objectForKey:@"originalWidth"] intValue];
		//int oh = [[properties objectForKey:@"originalHeight"] intValue];
		//NSLog(@"SpriteManager.createSprite: %@", properties);

		//AtlasSprite *sprite = [AtlasSprite spriteWithRect:CGRectMake(x + ox, y + oy, w, h) spriteManager:self];
		AtlasSprite *sprite = [AtlasSprite spriteWithRect:CGRectMake(x, y, w, h) spriteManager:self];
		[self addChild:sprite];
		return sprite;

	} else if (formatPlist == 1) {
		NSDictionary *properties = [frames objectForKey:imageFileName];
		CGRect frame = CGRectFromString([properties objectForKey:@"frame"]);
		//CGPoint offset = CGPointFromString([properties objectForKey:@"offset"]);
		//CGSize sourceSize = CGSizeFromString([properties objectForKey:@"sourceSize"]);
		//frame.origin.x += offset.x;
		//frame.origin.y += offset.y;

		AtlasSprite *sprite = [AtlasSprite spriteWithRect:frame spriteManager:self];
		[self addChild:sprite];
		return sprite;

	} else {
		NSAssert(NO,@"cocos2d: WARNING: format is not supported for SpriteManager");
		return nil;
	}

}

@end

I just added the offsets as well, as I forgot, not 100% sure it's right to be honest, need to do some more testing, but I think it should be fine.

And in case you don't know Zwoptex, check here:
http://zwoptexapp.com/

Hi, if you happen to be stuck on cocos2d v0.8.2 like me, and can't upgrade to latest versions 0.99.X for any reason (probably something wrong on our code), but still want to use Zwoptex to manage your sprite sheets, here it is a simple solution based on the CCSpriteFrameCache class on v0.99.3:

SpriteManager.h

#import "cocos2d.h"

@interface AtlasSpriteManager (SpriteManager) 

NSDictionary *frames;
int formatPlist; 

+(id)spriteManagerWithFile:(NSString*)fileImage plist:(NSString*)plist capacity:(NSUInteger)capacity;
+(id)spriteManagerWithFile:(NSString*) imageFile plist:(NSString*)plist;
+(void)createDictionaryFromPlist:(NSString*)plist;

-(AtlasSprite *)createSprite:(NSString*) imageFileName;

@end

SpriteManager.m:

#import "SpriteManager.h"

const int _defaultCapacity = 29;

@implementation AtlasSpriteManager (SpriteManager)

+(id)spriteManagerWithFile:(NSString*)fileImage plist:(NSString*)plist capacity:(NSUInteger)capacity
{
	[AtlasSpriteManager createDictionaryFromPlist:plist];
	return [[[AtlasSpriteManager alloc] initWithFile:fileImage capacity:capacity] autorelease];
}

+(id)spriteManagerWithFile:(NSString*) imageFile plist:(NSString*)plist
{
	[AtlasSpriteManager createDictionaryFromPlist:plist];
	return [[[AtlasSpriteManager alloc] initWithFile:imageFile capacity:_defaultCapacity] autorelease];
}

+(void)createDictionaryFromPlist:(NSString*)plist
{
	NSString *path = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:plist];
	NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path];
	NSDictionary *metadataDict = [dict objectForKey:@"metadata"];

	// get the format
	if (metadataDict != nil) {
		formatPlist = [[metadataDict objectForKey:@"format"] intValue];
	} else {
		formatPlist = 0;
	}

	frames = [dict objectForKey:@"frames"];

	//NSLog(@"SpriteManager.spriteManagerWithFile: %@", frames);
}

-(AtlasSprite *)createSprite:(NSString*) imageFileName
{
	if(formatPlist == 0) {
		NSDictionary *properties = [frames objectForKey:imageFileName];
		float x = [[properties objectForKey:@"x"] floatValue];
		float y = [[properties objectForKey:@"y"] floatValue];
		float w = [[properties objectForKey:@"width"] floatValue];
		float h = [[properties objectForKey:@"height"] floatValue];
		float ox = [[properties objectForKey:@"offsetX"] floatValue];
		float oy = [[properties objectForKey:@"offsetY"] floatValue];
		//int ow = [[properties objectForKey:@"originalWidth"] intValue];
		//int oh = [[properties objectForKey:@"originalHeight"] intValue];
		//NSLog(@"SpriteManager.createSprite: %@", properties);

		AtlasSprite *sprite = [AtlasSprite spriteWithRect:CGRectMake(x + ox, y + oy, w, h) spriteManager:self];
		[self addChild:sprite];
		return sprite;

	} else if (formatPlist == 1) {
		NSDictionary *properties = [frames objectForKey:imageFileName];
		CGRect frame = CGRectFromString([properties objectForKey:@"frame"]);
		CGPoint offset = CGPointFromString([properties objectForKey:@"offset"]);
		//CGSize sourceSize = CGSizeFromString([properties objectForKey:@"sourceSize"]);

		frame.origin.x += offset.x;
		frame.origin.y += offset.y;

		AtlasSprite *sprite = [AtlasSprite spriteWithRect:frame spriteManager:self];
		[self addChild:sprite];
		return sprite;

	} else {
		NSAssert(NO,@"cocos2d: WARNING: format is not supported for SpriteManager");
		return nil;
	}

}

@end

To use it, easy:

AtlasSpriteManager *spriteManager = [AtlasSpriteManager spriteManagerWithFile:@"sprite_sheet.png" plist:@"sprite_sheet.plist"];
[self addChild:spriteManager z:1];
AtlasSprite *spriteAtlas = [spriteManager createSprite:@"file_name.png"];

Animation Documentation is a weakness in the docs right now, I'll see what I can cook up eventually.

Thanks, that's the function I was trying to use. It kept crashing, but that's because I didn't realize you have to call addAnimation manually. Thanks for your help!

Is there any particular reason why, when you animate a sprite, the animation isn't automatically added to the animation dictionary in AtlasSprite? If I'm animating a sprite, I would intuitively think that the animation should be added automatically.

AtlasSpriteManager *mgr = [AtlasSpriteManager spriteManagerWithFile:@"spritesheet.png" capacity:100];
[self addChild:mgr z:0 tag:101];

AtlasSprite *sprite = [AtlasSprite spriteWithRect:CGRectMake(0, 205, 50, 44) spriteManager: mgr];

AtlasAnimation *animation = [AtlasAnimation animationWithName:@"run3" delay:0.06f];
for(int i=0;i<8;i++) {
	int x= i % 5;
	int y= 1;
	[animation addFrameWithRect: CGRectMake(x*50, y*205, 50, 44) ];
}
[sprite addAnimation:animation];
[mgr addChild:sprite z:1 tag:102];

Can't you just use a method like

-(void) setDisplayFrame: (NSString*) animationName index:(int) frameIndex

to set the "resting" animation when the sprite stops?

But i assume you want the action to run until end when the sprite stops, is that it? In that case don't call stopAllActions but wait till the animation is done (i'm not sure if there are ways to find this out). Or stopAllActions and then restart the animation again but with the current frame of the animation as starting frame and without looping the animation. But i don't know if CCSprite supports any of this, as i haven't worked with animations much yet.

Rightnow I have a sprite running around on the screen across the X-axis (side scroller style). When the sprite reaches the endPosition point, I call [sprite stopAllActions]. When the actions stop, the sprite is displayed in whatever the last frame happened to be. Is there a way to make the whole animation complete so that the sprite is in the "resting" position and not in a "running" position?

I know this is a pretty old thread, but I've got the same question. I'm pretty new to Cocos2d (but not to ObjC, etc). Could someone please explain this to me. What's the connection between AtlasAnimation and AtlasSpriteManager?

Perhaps it's because it's now called CCSpriteSheet?

Read the 0.99 notes, and they will tell you about the Sprite / AtlasSprite merge:

http://www.cocos2d-iphone.org/wiki/doku.php/release_notes:0_99_0_rc

why i cant declare AtlasSpriteManager in my project i am using 9 version

Ok. It turns out that the thing was working perfectly. My mistake was loading a black sprite onto the default black background.

FML.