/Users/ricardoquesada/progs/cocos2d-iphone/cocos2d/CCBitmapFontAtlas.h

/*
 * cocos2d for iPhone: http://www.cocos2d-iphone.org
 *
 * Copyright (c) 2008-2010 Ricardo Quesada
 * 
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 * Portions of this code are based and inspired on:
 *   http://www.71squared.co.uk/2009/04/iphone-game-programming-tutorial-4-bitmap-font-class
 *   by Michael Daley
 
 * Use any of these editors to generate bitmap font atlas:
 *   http://www.n4te.com/hiero/hiero.jnlp
 *   http://slick.cokeandcode.com/demos/hiero.jnlp
 *   http://www.angelcode.com/products/bmfont/
 *
 */

#import "CCAtlasNode.h"
#import "CCSpriteSheet.h"
#import "Support/uthash.h"

struct _KerningHashElement;

typedef struct _bitmapFontDef {
        unsigned int charID;
        CGRect rect;
        int xOffset;
        int yOffset;
        int xAdvance;
} ccBitmapFontDef;

typedef struct _bitmapFontPadding {
        int     left;
        int top;
        int right;
        int bottom;
} ccBitmapFontPadding;

enum {
        // how many characters are supported
        kCCBitmapFontAtlasMaxChars = 2048, //256,
};

@interface CCBitmapFontConfiguration : NSObject
{
// XXX: Creating a public interface so that the bitmapFontArray[] is accesible
@public
        // The characters building up the font
        ccBitmapFontDef bitmapFontArray[kCCBitmapFontAtlasMaxChars];
        
        // FNTConfig: Common Height
        NSUInteger              commonHeight;
        
        // Padding
        ccBitmapFontPadding     padding;
        
        // atlas name
        NSString                *atlasName;

        // values for kerning
        struct _KerningHashElement      *kerningDictionary;
}

+(id) configurationWithFNTFile:(NSString*)FNTfile;
-(id) initWithFNTfile:(NSString*)FNTfile;
@end


@interface CCBitmapFontAtlas : CCSpriteSheet <CCLabelProtocol, CCRGBAProtocol>
{
        // string to render
        NSString                *string_;
        
        CCBitmapFontConfiguration       *configuration_;

        // texture RGBA
        GLubyte         opacity_;
        ccColor3B       color_;
        BOOL opacityModifyRGB_;
}

+(void) purgeCachedData;

@property (nonatomic,readwrite) GLubyte opacity;
@property (nonatomic,readwrite) ccColor3B color;


+(id) bitmapFontAtlasWithString:(NSString*)string fntFile:(NSString*)fntFile;

-(id) initWithString:(NSString*)string fntFile:(NSString*)fntFile;

-(void) createFontChars;
@end

CCBitmapFontConfiguration * FNTConfigLoadFile( NSString *file );
void FNTConfigRemoveCache( void );