cocos2d-mac  2.0
Improved Cocos2D API Reference (Mac OS X version) for www.kobold2d.com developers
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Properties Defines
Public Member Functions | Static Public Member Functions | Protected Attributes | Properties
CCLabelTTF Class Reference

#import <CCLabelTTF.h>

Inheritance diagram for CCLabelTTF:
Collaboration diagram for CCLabelTTF:

List of all members.

Public Member Functions

(id) - initWithString:fontName:fontSize:
(id) - initWithString:dimensions:hAlignment:fontName:fontSize:
(id) - initWithString:dimensions:hAlignment:lineBreakMode:fontName:fontSize:
(id) - initWithString:dimensions:hAlignment:vAlignment:fontName:fontSize:
(id) - initWithString:dimensions:hAlignment:vAlignment:lineBreakMode:fontName:fontSize:
(void) - setString:
(id) - initWithString:dimensions:alignment:fontName:fontSize:
(id) - initWithString:dimensions:alignment:lineBreakMode:fontName:fontSize:

Static Public Member Functions

(id) + labelWithString:fontName:fontSize:
(id) + labelWithString:dimensions:hAlignment:fontName:fontSize:
(id) + labelWithString:dimensions:hAlignment:lineBreakMode:fontName:fontSize:
(id) + labelWithString:dimensions:hAlignment:vAlignment:lineBreakMode:fontName:fontSize:
(id) + labelWithString:dimensions:hAlignment:vAlignment:fontName:fontSize:
(id) + labelWithString:dimensions:alignment:fontName:fontSize:
(id) + labelWithString:dimensions:alignment:lineBreakMode:fontName:fontSize:

Protected Attributes

CGSize dimensions_
CCTextAlignment hAlignment_
CCVerticalTextAlignment vAlignment_
NSString * fontName_
CGFloat fontSize_
CCLineBreakMode lineBreakMode_
NSString * string_

Properties

NSString * fontName
float fontSize
CGSize dimensions
CCTextAlignment horizontalAlignment
CCVerticalTextAlignment verticalAlignment

Detailed Description

CCLabel is a subclass of CCTextureNode that knows how to render text labels

All features from CCTextureNode are valid in CCLabel

CCLabel objects are slow. Consider using CCLabelAtlas or CCLabelBMFont instead.

Member Function Documentation

- (id) initWithString: (NSString *)  string
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

initializes the CCLabelTTF with a font name, horizonal alignment, dimension in points, and font size in points. Default verticalAlignment: kCCVerticalTextAlignmentTop Default lineBreakMode: CCLineBreakModeWordWrap

Since:
v1.0
- (id) initWithString: (NSString *)  str
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
lineBreakMode: (CCLineBreakMode)  lineBreakMode
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

initializes the CCLabelTTF with a font name, horizontal alignment, dimension in points, line break mode and font size in points. Default verticalAlignment: kCCVerticalTextAlignmentTop

Supported lineBreakModes:

  • iOS: all UILineBreakMode supported modes
  • Mac: Only NSLineBreakByWordWrapping is supported.
    Since:
    v1.0
- (id) initWithString: (NSString *)  string
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
vAlignment: (CCVerticalTextAlignment)  vertAlignment
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

initializes the CCLabelTTF with a font name, horiozntal alignment, vertical alignment, dimension in points and font size in points. Default lineBreakMode: CCLineBreakModeWordWrap

- (id) initWithString: (NSString *)  str
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
vAlignment: (CCVerticalTextAlignment)  vAlignment
lineBreakMode: (CCLineBreakMode)  lineBreakMode
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

initializes the CCLabelTTF with a font name, horizontal alignment, vertical aligment, dimension in points, line break mode and font size in points. Supported lineBreakModes:

  • iOS: all UILineBreakMode supported modes
  • Mac: Only NSLineBreakByWordWrapping is supported.
    Since:
    v2.0
- (id) initWithString: (NSString *)  string
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

initializes the CCLabelTTF with a font name and font size in points

+ (id) labelWithString: (NSString *)  string
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

creates a CCLabelTTF from a fontname, horizontal alignment, dimension in points, and font size in points. Supported lineBreakModes:

  • iOS: all UILineBreakMode supported modes
  • Mac: Only NSLineBreakByWordWrapping is supported.
    Since:
    v1.0
+ (id) labelWithString: (NSString *)  string
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
lineBreakMode: (CCLineBreakMode)  lineBreakMode
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

creates a CCLabelTTF from a fontname, horizontal alignment, dimension in points, line break mode, and font size in points. Supported lineBreakModes:

  • iOS: all UILineBreakMode supported modes
  • Mac: Only NSLineBreakByWordWrapping is supported.
    Since:
    v1.0
+ (id) labelWithString: (NSString *)  string
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
vAlignment: (CCVerticalTextAlignment)  vertAlignment
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

creates a CCLabel from a fontname, alignment, dimension in points and font size in points

+ (id) labelWithString: (NSString *)  string
dimensions: (CGSize)  dimensions
hAlignment: (CCTextAlignment)  alignment
vAlignment: (CCVerticalTextAlignment)  vertAlignment
lineBreakMode: (CCLineBreakMode)  lineBreakMode
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

creates a CCLabelTTF from a fontname, horizontal aligment, vertical alignment, dimension in points, line break mode, and font size in points. Supported lineBreakModes:

  • iOS: all UILineBreakMode supported modes
  • Mac: Only NSLineBreakByWordWrapping is supported.
    Since:
    v1.0
+ (id) labelWithString: (NSString *)  string
fontName: (NSString *)  name
fontSize: (CGFloat)  size 

creates a CCLabelTTF with a font name and font size in points

- (void) setString: (NSString *)  str

changes the string to render

Warning:
Changing the string is as expensive as creating a new CCLabelTTF. To obtain better performance use CCLabelAtlas or CCLabelBMFont.

Reimplemented from <CCLabelProtocol>.

Property Documentation

- (CGSize) dimensions [read, write, assign]

Dimensions of the label in Points

- (NSString*) fontName [read, write, retain]

Font name used in the label

- (float) fontSize [read, write, assign]

Font size of the label

- (CCTextAlignment) horizontalAlignment [read, write, assign]

The alignment of the label

- (CCVerticalTextAlignment) verticalAlignment [read, write, assign]

The vertical alignment of the label

The documentation for this class was generated from the following file: