Coretext实现图文混排及Gif图片播放

2021-07-11 23:46:51

CoreText是iOS3.2推出的一套文字排版和渲染框架，可以实现图文混排，富文本显示等效果。

CoreText中的几个重要的概念： 

  1. CTFont
  2. CTFontCollection
  3. CTFontDescriptor
  4. CTFrame
  5. CTFramesetter
  6. CTGlyphInfo
  7. CTLine
  8. CTParagraphStyle
  9. CTRun
  10. CTTextTab
  11. CTTypesetter

先来了解一下该框架的整体视窗组合图：

Coretext实现图文混排及Gif图片播放

CTFrame 作为一个整体的画布(Canvas)，其中由行(CTLine)组成，而每行可以分为一个或多个小方块（CTRun）。

注意：你不需要自己创建CTRun，Core Text将根据NSAttributedString的属性来自动创建CTRun。每个CTRun对象对应不同的属性，正因此，你可以*的控制字体、颜色、字间距等等信息。

此外还有一点需要注意：一个CTRun是不能跨行的，若是一段文字拥有相同的属性，且跨行，则会被分在多个CTRun当中，每个CTRun拥有相同属性。

首先来看看使用Coretext的基本步骤：

第一步：

要有一个NSMutableAttributedString，用一个字符串来初始化NSMutableAttributedString。

NSMutableAttributedString  * _mString = [[NSMutableAttributedString alloc] initWithString:_text];

第二步：对NSMutableAttributedString进行属性设置。

　　 [_mString beginEditing];

[_mString addAttributes:textAttribute.attributeDic range:attr.range];

[_mString addAttribute:@"MTText" value:attr.text range:attr.range];

[_mString endEditing];

在这里有两种方式，一个是设置单个属性，一个是直接批量设置属性。属性的key值可以是自己定义的。

以下是一些常见的属性设置

1.设置字体属性

CTFontRef font = CTFontCreateWithName(CFSTR("Georgia"), , NULL);

 [_mString addAttribute:(id)kCTFontAttributeName value:(id)font range:NSMakeRange(, )];

　　2.设置斜体字 　　　

CTFontRef font = CTFontCreateWithName((CFStringRef)[UIFont italicSystemFontOfSize:].fontName, , NULL);

 [_mString addAttribute:(id)kCTFontAttributeName value:(id)font range:NSMakeRange(, )];

　

　　3.设置连字

long number = ;

CFNumberRef num = CFNumberCreate(kCFAllocatorDefault,kCFNumberSInt8Type,&number);

[mabstring addAttribute:(id)kCTLigatureAttributeName value:(id)num range:NSMakeRange(, [str length])];

　　

　　4.设置下划线

[_mString addAttribute:(id)kCTUnderlineStyleAttributeName value:(id)[NSNumber numberWithInt:kCTUnderlineStyleDouble] range:NSMakeRange(, )];

　　

　　5.设置下划线颜色

[_mString addAttribute:(id)kCTUnderlineColorAttributeName value:(id)[UIColor redColor].CGColor range:NSMakeRange(, )];

　　

　　6.设置字体间隔

long number = ;

CFNumberRef num = CFNumberCreate(kCFAllocatorDefault,kCFNumberSInt8Type,&number);

[_mString addAttribute:(id)kCTKernAttributeName value:(id)num range:NSMakeRange(, )];

　

最后是画出对应的图像了

　　

　　  CGContextRef context = UIGraphicsGetCurrentContext();

CGContextTranslateCTM(context , 0 ,self.bounds.size.height);

CGContextScaleCTM(context, 1.0, -1.0);

　　CTFramesetterRef frameSetter = CTFramesetterCreateWithAttributedString(

                                                    (CFAttributedStringRef) _mString);

    CGMutablePathRef path = CGPathCreateMutable();

    CGRect rects = CGRectMake( ,  ,self.bounds.size.width , self.bounds.size.height);

    CGPathAddRect(path,

                  NULL ,

                  rects);

    CTFrameRef frame = CTFramesetterCreateFrame(frameSetter,

                                                   CFRangeMake(, ),

                                                   path,

                                                   NULL);

    _frameRef = frame;

    CTFrameDraw(frame,context);

    CGPathRelease(path);

    CFRelease(frameSetter);

这里有几点比较需要注意：

　　1.坐标转换问题。在使用CGcontext进行绘制时坐标轴圆点在屏幕左下方，而UIKit得坐标系圆点在左上方，需要对此进行转换。此外，在后面的操作中也要用到坐标变换。

　　2.文字的绘画区域不是整个context，而是在CTFrameRef中，后面我们还会碰到相关的问题。

CTFrameRef frame = CTFramesetterCreateFrame(frameSetter,

                                                   CFRangeMake(, ),

                                                   path,

                                                   NULL);

现在我们已经能设置文字的基本属性了，但富文本中还有比较重要的一个应用：图文混排

我们先来说说实现图文混排的基本思路。

coretext是直接绘制在layer层上的，我们可以在drawRect 方法中直接画一张图片，只要将图片放在适合的位置，就实现了图文混排。

现在的关键是如何计算出图片所在的位置，此外，当图片添加的时候，文字的排版要如何调整问题。

为了能插入图片，首先我们要设置一个占位符，正常设置为空格符，因为图片如果没有完全覆盖那个区域，可能显示出占位符。当然你也可以任意设置一个字符并将其

的颜色设置为clearColor。设置占位符后我们要为它设置属性，

记住，要为它设置一个单独的属性，不能与相邻的字符属性一致，因为这样系统可能因此将他们合并在一个CTRun当中。

占位符最好只设置一个，如果占位符是多个的话，有可能占位符处于不同行，会被分成两个CTRun，此时图片就可能超出屏幕边界。

NSMutableAttributedString *replaceStr = [[NSMutableAttributedString alloc] initWithString:@"1"];

UIColor *color = [UIColor clearColor];

NSRange range = NSMakeRange(_mString.length - 1, 1);

[replaceStr addAttribute:(id)color.CGColor value:(id)kCTForegroundColorAttributeName range:range];

[_mString appendAttributedString:replaceStr];

设置完占位符基本属性后，我们需要设置占位符对应得CTRun的回调方法来设置CTRun的大小，以适应图片。 CTRunDelegateCallbacks imageCallBacks;

 imageCallBacks.version = kCTRunDelegateVersion1;

 imageCallBacks.dealloc = RunDelegateDeallocCallback;

 imageCallBacks.getAscent = RunDelegateGetAsent;

 imageCallBacks.getDescent = RunDelegateGetDescent;

 imageCallBacks.getWidth = RunDelegateGetWidthCallBack;

 //传入的参数attr.text可以在回调方法中使用

 CTRunDelegateRef runDelegate = CTRunDelegateCreate(&imageCallBacks,

                                                               (__bridge void *)(attr.text));

 CTRunDelegateGetRefCon(runDelegate);

 [_mString addAttribute:(NSString *)kCTRunDelegateAttributeName

                              value:(__bridge id)runDelegate

                                          range:attr.range];

 [_mString addAttribute:@"imageName" value:attr.text range:attr.range];

 CFRelease(runDelegate);

void RunDelegateDeallocCallback{

}


CGFloat RunDelegateGetAsent(void *refCon) {




NSString *imageName = (__bridge NSString *)(refCon);


return [UIImage imageNamed:imageName].size.height;


}


CGFloat RunDelegateGetDescent(void *refCon) {


　　return 0;


}


CGFloat RunDelegateGetWidth(void *refCon) {


   NSString *imageName = (__bridge NSString *)(refCon);


return [UIImage imageNamed:imageName].size.width;


}




在设置好属性还有回调方法之后，就可以开始绘制图片了。


基本的思路是获取文本的每一行，再获取每一个CTRun，根据属性来判断是否是绘制图片的点，是的话则获取绘画区域，绘制图片。




    CFArrayRef lines = CTFrameGetLines(_frameRef);

    CGPoint origins[CFArrayGetCount(lines)];

    CTFrameGetLineOrigins(_frameRef, CFRangeMake(, ), origins);

    NSMutableArray *attrArray = [[NSMutableArray alloc] init];

    for (int i = ; i < CFArrayGetCount(lines); i ++) {

        CTLineRef line = CFArrayGetValueAtIndex(lines, i);

        CFArrayRef runs = CTLineGetGlyphRuns(line);

        for (int k = ; k < CFArrayGetCount(runs); k ++) {

            CTRunRef run = CFArrayGetValueAtIndex(runs, k);

            NSDictionary *attri = (NSDictionary *)CTRunGetAttributes(run);

            NSString *imageName = [attri objectForKey:@"imageName"];

            if (imageName) {

                CGFloat runAsent;

                CGFloat runDescent;

                CGPoint origin = origins[i];

                CGRect runRect;

                runRect.size.width = CTRunGetTypographicBounds(run,

                                                               CFRangeMake(, ),

                                                               &runAsent,

                                                               &runDescent,

                                                               NULL);

                CGFloat offset = CTLineGetOffsetForStringIndex(line,

                                                               CTRunGetStringRange(run).location,

                                                               NULL);

                runRect = CGRectMake(origin.x + offset,

                                     origin.y - runDescent,

                                     runRect.size.width,

                                     runAsent + runDescent);


　　　　　　　　　　UIImage *image = [UIImage imageNamed:imageName];


CGContextDrawImage(context, runRect, image.CGImage);


            }

        }

    }




这里有个需要注意的点，我们取到得位置是相对于整个画布，而不是相对于所在的View的位置




CTFrameRef frame = CTFramesetterCreateFrame(frameSetter,

                                                   CFRangeMake(, ),

                                                   path,

                                                   NULL);




因此，如果CTFrameref如果有不在原点，计算时需要加上这部分的偏移量。


点击事件和图片绘制差不多，获取点击的点，进行坐标变换




- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{

    UITouch *touch = touches.anyObject;

    CGPoint point = [touch locationInView:self];
　　//坐标变换

    CGPoint location = CGPointMake(point.x, self.bounds.size.height - point.y);

    MTLabelAttribute *attr = [self getAttributeByLocation:location];

    _lastAttr = attr;

    if (attr) {

        if ([self.delegate respondsToSelector:@selector(clickWithAttibute:andText:)]) {

            [self.delegate clickWithAttibute:attr andText:attr.text];

        }

        [self setAttributeWithType:@"hightlight" andAttribute:attr];

    }

       //判断point是否在点击的文字范围内

}




先判断在哪一行，然后判断点击的点在哪一个CTRun上。在这里要注意所要实现点击的字符串可能跨行的情况。




- (MTLabelAttribute *)getAttributeByLocation:(CGPoint) point{

    NSArray *lines = (NSArray *)CTFrameGetLines(_frameRef);

    CGPoint origins[lines.count];

    CTFrameGetLineOrigins(_frameRef, CFRangeMake(, ), origins);

    CTLineRef ref;

    int count = ;

//判断所在的行

    if (point.y < origins[lines.count - ].y) {

        return nil;

    }

    for (int i = ; i < lines.count ; i ++) {

        CGFloat minY = origins[i].y;

        CGFloat maxY = origins[i - ].y;

        if (point.y >= minY && point.y <=  maxY) {

            count = i ;

            break;

        }

    }

    ref = (__bridge CTLineRef)lines[count];

    CGPoint origin = origins[count];

    NSArray *ctRuns = (NSArray *)CTLineGetGlyphRuns(ref);

 //判断所在的CTRun

    for (int k = ; k < ctRuns.count; k ++) {

        CTRunRef runTest = (__bridge CTRunRef)([ctRuns objectAtIndex:k]);

        CGFloat offset = CTLineGetOffsetForStringIndex((CTLineRef)lines[count],

                                                       CTRunGetStringRange(runTest).location,

                                                       NULL) + 0.0;

        CGPoint firstPoint = CGPointMake(origin.x + offset , origin.y);

        CGFloat ascent;

        CGFloat descent;

        CGFloat leading;

        CGFloat width =  CTRunGetTypographicBounds(runTest, CFRangeMake(, ),

                                                   &ascent,

                                                   &descent,

                                                   &leading);

        if ( point.x >= firstPoint.x

            &&point.x <= firstPoint.x + width

            &&point.y <= origin.y + ascent

            &&point.y >= origin.y ) {

            NSDictionary *dic = (NSDictionary *)CTRunGetAttributes(runTest);

            NSString *string = [dic objectForKey:@"MTText"];

            CFRange cfRange = CTRunGetStringRange(runTest);

            if ([dic objectForKey:@"imageName"]) {

                return [self getAttributesWithRange:NSMakeRange(cfRange.location, cfRange.length)];

            }

　　　　　　　//跨行情况处理

            NSString *subString = [self.text substringWithRange:

                                   NSMakeRange(cfRange.location, cfRange.length)];

            NSRange range;

            NSRange subStringRange = [string rangeOfString:subString];

            range = NSMakeRange(cfRange.location - subStringRange.location, string.length);

            return [self getAttributesWithRange:range];

        }

    }

    return nil;

}




最后，是Gif的显示


　　gif是比较特殊的一种情况，处理起来也比较麻烦。对于gif有两种展示方式，一种是用一个专门的UIView来展示，然后用添加subView的方式使用。用这种方式可以使用


第三方的框架，使用UIWebView播放等，也可以自己写，下面是使用UIImageView的方式：详情可看http://www.cocoachina.com/bbs/read.php?tid=124430




UIImageView *gifImageView = [[UIImageView alloc] initWithFrame:[[UIScreen mainScreen] bounds]];

    NSArray *gifArray = [NSArray arrayWithObjects:[UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],

                                                  [UIImage imageNamed:@""],nil];

    gifImageView.animationImages = gifArray; //动画图片数组

    gifImageView.animationDuration = ; //执行一次完整动画所需的时长

    gifImageView.animationRepeatCount = ;  //动画重复次数

    [gifImageView startAnimating];

    [self.view addSubview:gifImageView];

    [gifImageView release]; 




使用UIImageView的方式是固定的时间间隔，但gif并非每一帧的间隔都一样，因此有些情况可能达不到最好的播放效果。


在IOS7之后可以使用TextKit中的attachment，直接添加UIWebView播放Gif图片，YYTextKit中也有类似的实现。


如果我们要手动实现的话，那就只好一帧一帧的往屏幕上画了。我们首先来看看继承UIView的实现方式，记住不能继承自caLayer，虽然最后是在layer层绘画，


但直接继承calyer，然后用addsublayer方法显示，图像会有重影，大概UIView中有对其进行处理。


首先用一个类对Gif图片进行解析




@interface MTGifAttribute : NSObject

@property (nonatomic, strong, readonly) NSArray *imageFrames;

@property (nonatomic, strong, readonly) NSArray *properties;

@property (nonatomic, strong, readonly) NSArray *delayTimes;

@property (nonatomic, assign, readwrite) UIView<MTGifProtocol> * delegate;

@property (nonatomic, assign, readwrite) CGRect frame;

//@property (nonatomic, copy) NSString *path;

@property (nonatomic, assign, readonly) NSInteger index;

- (void)setImageInfoWithFilePath:(NSString *)path;

- (void)startAnitation;

@end




解析方法




@implementation MTGifAttribute

- (instancetype)init{

    self = [super init];

    if (self) {

        _index = ;

    }

    return self;

}

- (void)setImageInfoWithFilePath:(NSString *)path {

    NSMutableArray *imageFrames = [[NSMutableArray alloc] init];

    NSMutableArray *delayTimes = [[NSMutableArray alloc] init];

    NSURL *filrUrl = [NSURL fileURLWithPath:path];

    CFURLRef cfUrl = (__bridge CFURLRef)filrUrl;

    CGImageSourceRef gifSource = CGImageSourceCreateWithURL(cfUrl, NULL);

    NSInteger count = CGImageSourceGetCount(gifSource);

    for (int i = ; i < count; i++){

        CGImageRef frame = CGImageSourceCreateImageAtIndex(gifSource,

                                                           i,

                                                           NULL);

        [imageFrames addObject:(__bridge id)frame];

        CGImageRelease(frame);

        NSDictionary *dic = CFBridgingRelease(CGImageSourceCopyPropertiesAtIndex(gifSource,

                                                                                 i,

                                                                                 NULL));

        NSDictionary *gifDic =[dic valueForKey:(NSString *)kCGImagePropertyGIFDictionary];

        [delayTimes addObject:[gifDic objectForKey:(NSString *)kCGImagePropertyGIFDelayTime]];

    }

    NSDictionary *dic = CFBridgingRelease(CGImageSourceCopyPropertiesAtIndex(gifSource,

                                                                             ,

                                                                             NULL));

    CGFloat gifWidth = (CGFloat)[[dic valueForKey:(NSString*)kCGImagePropertyPixelWidth]

                                 floatValue];

    CGFloat gifHeight = (CGFloat)[[dic valueForKey:(NSString*)kCGImagePropertyPixelHeight]

                                  floatValue];

    _frame = CGRectMake(, , gifWidth, gifHeight);

    _imageFrames = imageFrames;

    _delayTimes = delayTimes;

}

- (void)startAnitation {

    [self changeImage];

}

- (void)changeImage {

　　    
　　//代理方法，调用setNeeddisplay

    if ([self.delegate respondsToSelector:@selector(disPlayInRect:)]) {

        [self.delegate disPlayInRect:self.frame];

    }else{

        return;

    }

    _index ++;

    _index = _index % self.imageFrames.count;

    CGFloat delay = [[self.delayTimes objectAtIndex:_index] floatValue];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW,

                       (int64_t)(delay * NSEC_PER_SEC)),

                       dispatch_get_main_queue(), ^{

                           [self changeImage];

                       });

}






图片索引切换方法




- (void)startAnitation {

    [self changeImage];

}

- (void)changeImage {

    if ([self.delegate respondsToSelector:@selector(disPlayInRect:)]) {

        [self.delegate disPlayInRect:self.frame];

    }else{

        return;

    }

    _index ++;

    _index = _index % self.imageFrames.count;

    CGFloat delay = [[self.delayTimes objectAtIndex:_index] floatValue];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW,

                       (int64_t)(delay * NSEC_PER_SEC)),

                       dispatch_get_main_queue(), ^{

                           [self changeImage];

                       });

}




继承UIView，重写drawRect方法。




- (void)drawRect:(CGRect)rect{

    CGContextRef ctx = UIGraphicsGetCurrentContext();

    CGContextTranslateCTM(ctx ,  ,self.frame.size.height);

    CGContextScaleCTM(ctx, 1.0, -1.0); 

    UIImage *image = [_gifImage.imageFrames objectAtIndex:_index];

    CGImageRef cgimage = image.CGImage;

    UIGraphicsBeginImageContext(CGSizeMake(self.frame.size.width, self.frame.size.height));

    CGContextDrawImage(ctx, _gifImage.frame, cgimage);

}




至此Gif的显示已经完成，但有些时候我们不想单独用一个view来显示。而是想用coretext图文混排的方式来显示，将gif和文字显示在同一个view。


此时的方式和用一个单独的view显示一样，只是绘画的对象不同而已。


比较需要注意的一个点是，在每次重绘的时候，因为gif不断地重绘，如果每次都刷新整个View的话有可能会造成性能问题。因此可以使用


[self setNeedsDisplayInRect:rect];方法，只刷新gif所在区域。


当然，在这种情况下也要万分注意左边变换问题，如果刷新的区域，与变换坐标后的绘画区域不对应，图片会消失或者只显示部分。
上一篇：（转）JSP HTML JAVASCRIPT 中文乱码 解决方案 大全

下一篇：Android深度探索--HAL与驱动开发----第十章读书笔记