CCLabelTTF 是一个展示已经渲染的TTF字体纹理的类,使用该类不需要加入新的字体(使用的是系统的字体)。需要注意的是,每一次修改标签文本的时候都会重新渲染纹理,所以如果需要频繁更新文本的时候尽量不要使用CCLabelTTF,可以使用CCLabelBMFont。
CCLabelTTF继承自CCSprite,可以使用以下方法创建CCLabelTTF:
类方法:+ (id)labelWithString:(NSString *)string fontName:(NSString *)name fontSize:(CGFloat)size//使用指定字体、字体大小以及文本内容来创建一个标签
+ (id)labelWithString:(NSString *)string fontName:(NSString *)name fontSize:(CGFloat)size dimensions:(CGSize)dimensions////使用指定字体、字体大小以及文本内容来创建一个标签,同时指定标签的尺寸。
+ (id)labelWithAttributedString:(NSAttributedString *)attrString//使用属性字符串创建标签,只能在ios6以上和OS X才能用
+ (id)labelWithAttributedString:(NSAttributedString *)attrString dimensions:(CGSize)dimensions//使用属性字符串创建标签,同时指定标签尺寸
以下是实例化方法,含义和类方法一致,不在概述。
- (id)initWithAttributedString:(NSAttributedString *)attrString
- (id)initWithAttributedString:(NSAttributedString *)attrString dimensions:(CGSize)dimensions
- (id)initWithString:(NSString *)string fontName:(NSString *)name fontSize:(CGFloat)size
- (id)initWithString:(NSString *)string fontName:(NSString *)name fontSize:(CGFloat)size dimensions:(CGSize)dimensions
CCLabelTTF的属性:
@property (nonatomic, copy) NSString *string//标签的文本
@property (nonatomic, copy) NSAttributedString *attributedString//标签的属性化文本
@property (nonatomic, assign) CGFloat fontSize//文本 的字体大小
@property (nonatomic, strong) CCColor *fontColor//文本的字体颜色
@property (nonatomic, strong) NSString *fontName//文本的字体名称
@property (nonatomic, assign) CCTextAlignment horizontalAlignment//文本水平对齐
@property (nonatomic, assign) CCVerticalTextAlignment verticalAlignment//文本垂直对齐
@property (nonatomic, assign) CGSize dimensions//标签尺寸
@property (nonatomic, assign) CCSizeType dimensionsType//标签尺寸类型
@property (nonatomic, assign) BOOL adjustsFontSizeToFit//如果为true,则标签会缩小比例去适应,缩小到该标签指定的尺寸,即dimensions属性(前提是该属性值设置的有)。
@property (nonatomic, assign) CGFloat minimumFontSize//和上面 adjustsFontSizeToFit属性一起使用。即最小缩放到该属性指定的尺寸,标签会被截取一部分
@property (nonatomic, assign) CGFloat // 如果adjustsFontSizeToFitWidth属性设置为YES,这个属性就来控制文本基线的行为
@property (nonatomic, strong) CCColor *shadowColor//文本阴影颜色
@property (nonatomic, assign) CGPoint shadowOffset//阴影偏移量
@property (nonatomic, readonly) CGPoint shadowOffsetInPoints//点坐标系中阴影偏移量,只读属性
@property (nonatomic, assign) CCPositionType shadowOffsetType//阴影偏移量位置类型
@property (nonatomic, assign) CGFloat shadowBlurRadius//阴影模糊半径
@property (nonatomic, strong) CCColor *outlineColor//文本轮廓颜色
@property (nonatomic, assign) CGFloat outlineWidth//文本轮廓宽度