CTRun.h学习

2017-03-02

CTLine是由CTRun组成的。

我们通过以下几个方面来看看CTRun

1.Glyph Run Types

2Glyph Run Access

1.Glyph Run Types

CFTypeID CTRunGetTypeID( void ) 获取CTRunRef 的 CFTypeID

typedef CF_OPTIONS(uint32_t, CTRunStatus)
{
    kCTRunStatusNoStatus = 0,
    kCTRunStatusRightToLeft = (1 << 0),
    kCTRunStatusNonMonotonic = (1 << 1),
    kCTRunStatusHasNonIdentityMatrix = (1 << 2)
};
Run的状态
kCTRunStatusNoStatus 没有属性
kCTRunStatusRightToLeft  暂时不知道干嘛的 (这个是当设置文本从右向左书写的时候是这个状态)
kCTRunStatusNonMonotonic   暂时不知道干嘛的
kCTRunStatusHasNonIdentityMatrix   暂时不知道干嘛的

2.Glyph Run Access

CTRunGetGlyphCount (CTRunRef run )	获取run的字体个数
CFDictionaryRef CTRunGetAttributes(CTRunRef run )	获取run的属性
CTRunStatus CTRunGetStatus(CTRunRef run )	获取 status 不知道这个干嘛用(就是获取run的状态，只看出来 kCTRunStatusRightToLeft 的用法其他的没看出来）
const CGGlyph * __nullable CTRunGetGlyphsPtr(CTRunRef run )	获取一个CGGlyph 指针数组
void CTRunGetGlyphs(CTRunRef run,CFRange range,CGGlyph buffer[] )	获取数据CGGlyph 在范围range
const CGPoint * __nullable CTRunGetPositionsPtr(CTRunRef run )	获取每个glyph 字体的起始位置数组
void CTRunGetPositions(CTRunRef run,CFRange range,CGPoint buffer[] )	获取数据获取数据CGGlyph位置在范围range
const CGSize * __nullable CTRunGetAdvancesPtr(CTRunRef run )	获取CGGlyph 的大小数组
void CTRunGetAdvances(CTRunRef run,CFRange range,CGSize buffer[] )	获取数据获取数据CGGlyph大小在范围range
const CFIndex * __nullable CTRunGetStringIndicesPtr(CTRunRef run )	获取CGGlyph 在整个字符串index数组的大小数组
void CTRunGetStringIndices(CTRunRef run,CFRange range,CFIndex buffer[] )	获取数据获取数据CGGlyph在整个字符串index处数组在范围range
CFRange CTRunGetStringRange(CTRunRef run )	获取run在字符串中的range
double CTRunGetTypographicBounds(CTRunRef run,CFRange range,CGFloat __ nullable ascent,CGFloat nullable descent,CGFloat * nullable leading )	获取run 在范围range的的相关信息返回宽度
CGRect CTRunGetImageBounds( CTRunRef run,CGContextRef __nullable context,CFRange range )	获取一个rect 具体是怎么样子不知道（这个同ctline相关函数一样获取的是图片大小）
CGAffineTransform CTRunGetTextMatrix(CTRunRef run )	获取run 的二维矩阵
void CTRunDraw(CTRunRef run,CGContextRef context,CFRange range )	绘制run 位置什么的不变。

代码

    CGContextRef context = UIGraphicsGetCurrentContext();
//    CGContextSetTextMatrix(context , CGAffineTransformIdentity);
    CGContextTranslateCTM(context , 0 ,self.bounds.size.height);
    CGContextScaleCTM(context, 1.0 ,-1.0);
    
    NSMutableAttributedString *mabstring = [[NSMutableAttributedString alloc]initWithString:@"富文本学吧"];
    NSDictionary * dic = [NSDictionary dictionaryWithObject:[UIFont systemFontOfSize:18] forKey:(__bridge NSString *)kCTFontAttributeName];
    ///设置字体
    [mabstring setAttributes:dic range:NSMakeRange(2, 3)];
   CTLineRef line = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)mabstring);
    
    mabstring = [[NSMutableAttributedString alloc]initWithString:@"dd"];
   CTLineRef  linetoken = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)mabstring);
    
    
    CTLineRef lineTru = CTLineCreateTruncatedLine(line, 300, kCTLineTruncationStart, linetoken);
//    CTLineDraw(line, context);
    
    
//    CTLineDraw(line, context);
    double offset =  CTLineGetPenOffsetForFlush(line,0.5, 300);
    NSLog(@"line offset %f",offset);
    UIView * view =[[UIView alloc]initWithFrame:CGRectMake(300/2-offset, self.bounds.size.height-64, offset, 10)];
    [self addSubview:view];
    view.backgroundColor =[UIColor redColor];
    
    view =[[UIView alloc]initWithFrame:CGRectMake(0, self.bounds.size.height-64, 300/2, 10)];
    [self addSubview:view];
    view.alpha = 0.4;
    view.backgroundColor =[UIColor greenColor];
    ///access
    CFIndex index =   CTLineGetGlyphCount(lineTru);
    NSLog(@"line glyph %ld",index);
    index =   CTLineGetGlyphCount(line);
    NSLog(@"line glyph %ld",index);
    
    
  NSArray * runArr = (__bridge NSArray *)  CTLineGetGlyphRuns(line);
    NSLog(@"runArr %@" ,runArr);
    
    if (runArr.count>1) {
        CTRunRef run = (__bridge CTRunRef)runArr[1];
        CFIndex index =  CTRunGetGlyphCount(run);
        NSLog(@"Run glyph 个数 %ld",index);
       NSDictionary * dic = (__bridge NSDictionary * ) CTRunGetAttributes(run);
        NSLog(@"run att %@",dic);
        CTRunStatus status = CTRunGetStatus(run);
        NSLog(@"run status %d",status);
        
        
       const CGGlyph * glyph = CTRunGetGlyphsPtr(run);
        const CGPoint * point =   CTRunGetPositionsPtr(run);
        const CGSize * size = CTRunGetAdvancesPtr(run);
        const CFIndex *  indexs = CTRunGetStringIndicesPtr(run);
        for (int i=0; i<index; i++) {
            NSLog(@"run glyph   %d",glyph[i]);
            NSLog(@"run point %lf %lf",point[i].x,point[i].y);
            NSLog(@"run size %lf %lf",size[i].width,size[i].height);
            NSLog(@"run index %ld",indexs[i]);
        }
        CGGlyph buffer[2];
        CGPoint pointPos[2];
        CGSize sizeBuffer[2];
        CFIndex indexBuffer[2];
        CTRunGetGlyphs(run, CFRangeMake(0, 2), buffer);
        NSLog(@"run glyph %d %d",buffer[0],buffer[1]);
        CTRunGetPositions(run, CFRangeMake(0, 2), pointPos);
        NSLog(@"run glyph point %lf %lf",pointPos[0].x,pointPos[1].y);
        CTRunGetAdvances(run, CFRangeMake(0, 2), sizeBuffer);
        NSLog(@"run glyph size %lf %lf",sizeBuffer[0].width,sizeBuffer[1].height);
         CTRunGetStringIndices(run,CFRangeMake(0, 2),indexBuffer);
        NSLog(@"run glyph index %ld %ld",indexBuffer[0],indexBuffer[1]);
        CFRange stringRange =  CTRunGetStringRange(run);
        NSLog(@"run string range %ld %ld",stringRange.location,stringRange.length);
        CGFloat ascent;
        CGFloat descent;
        CGFloat leading;
        CTRunGetTypographicBounds(run, CFRangeMake(1, 2), &ascent, &descent, &leading);
        NSLog(@"run ascent %f,descent %f,leading %f",ascent,descent,leading);
    CGRect imageRect=  CTRunGetImageBounds(run, context, CFRangeMake(1, 2));
        NSLog(@"不知道能干嘛 run image rect %@",NSStringFromCGRect(imageRect));
        UIView * view = [[UIView alloc]initWithFrame:imageRect];
        view.backgroundColor =[UIColor redColor ];
        view.alpha = 0.8;
        [self addSubview:view];
        CGAffineTransform transfrom =   CTRunGetTextMatrix(run);
        NSLog(@"run transform %@",NSStringFromCGAffineTransform(transfrom));
        
        CTRunDraw(run, context, CFRangeMake(1, 2));
    }
    
    结果
    2017-02-27 15:12:46.162 CoreTextDemo[11205:345484] line offset 110.487000
2017-02-27 15:12:46.163 CoreTextDemo[11205:345484] line glyph 5
2017-02-27 15:12:46.163 CoreTextDemo[11205:345484] line glyph 5
2017-02-27 15:12:46.163 CoreTextDemo[11205:345484] runArr (
    "<CTRun: 0x7fdb89c28330>{string range = (0, 2), string = \"\\u5BCC\\u6587\", attributes = <CFBasicHash 0x60800026abc0 [0x10117ec70]>{type = mutable dict, count = 1,\nentries =>\n\t2 : <CFString 0x101b3b788 [0x10117ec70]>{contents = \"NSFont\"} = <CTFont: 0x7fdb89c28130>{name = PingFangSC-Regular, size = 12.000000, matrix = 0x0, descriptor = <CTFontDescriptor: 0x60000008a640>{attributes = <CFBasicHash 0x600000271a80 [0x10117ec70]>{type = mutable dict, count = 1,\nentries =>\n\t2 : <CFString 0x101b41908 [0x10117ec70]>{contents = \"NSFontNameAttribute\"} = <CFString 0x10ea6d6c0 [0x10117ec70]>{contents = \"PingFangSC-Regular\"}\n}\n>}}\n}\n}",
    "<CTRun: 0x7fdb89c3d710>{string range = (2, 3), string = \"\\u672C\\u5B66\\u5427\", attributes = <CFBasicHash 0x60800026a8c0 [0x10117ec70]>{type = mutable dict, count = 1,\nentries =>\n\t2 : <CFString 0x101b3b788 [0x10117ec70]>{contents = \"NSFont\"} = <CTFont: 0x7fdb89c3d3f0>{name = .PingFangSC-Regular, size = 18.000000, matrix = 0x0, descriptor = <CTFontDescriptor: 0x60000008d570>{attributes = <CFBasicHash 0x600000279140 [0x10117ec70]>{type = mutable dict, count = 1,\nentries =>\n\t2 : <CFString 0x101b41908 [0x10117ec70]>{contents = \"NSFontNameAttribute\"} = <CFString 0x101b39be8 [0x10117ec70]>{contents = \".PingFangSC-Regular\"}\n}\n>}}\n}\n}"
)
2017-02-27 15:12:46.171 CoreTextDemo[11205:345484] Run glyph 个数 3
2017-02-27 15:12:46.171 CoreTextDemo[11205:345484] run att {
    NSFont = "<UICTFont: 0x7fdb89c3d3f0> font-family: \".PingFangSC-Regular\"; font-weight: normal; font-style: normal; font-size: 18.00pt";
}
2017-02-27 15:12:46.172 CoreTextDemo[11205:345484] run status 0
2017-02-27 15:12:46.172 CoreTextDemo[11205:345484] run glyph   3676
2017-02-27 15:12:46.172 CoreTextDemo[11205:345484] run point 24.000000 0.000000
2017-02-27 15:12:46.172 CoreTextDemo[11205:345484] run size 18.342000 0.000000
2017-02-27 15:12:46.172 CoreTextDemo[11205:345484] run index 2
2017-02-27 15:12:46.172 CoreTextDemo[11205:345484] run glyph   2573
2017-02-27 15:12:46.173 CoreTextDemo[11205:345484] run point 42.342000 0.000000
2017-02-27 15:12:46.173 CoreTextDemo[11205:345484] run size 18.342000 0.000000
2017-02-27 15:12:46.173 CoreTextDemo[11205:345484] run index 3
2017-02-27 15:12:46.173 CoreTextDemo[11205:345484] run glyph   1929
2017-02-27 15:12:46.173 CoreTextDemo[11205:345484] run point 60.684000 0.000000
2017-02-27 15:12:46.173 CoreTextDemo[11205:345484] run size 18.342000 0.000000
2017-02-27 15:12:46.255 CoreTextDemo[11205:345484] run index 4
2017-02-27 15:12:46.255 CoreTextDemo[11205:345484] run glyph 3676 2573
2017-02-27 15:12:46.256 CoreTextDemo[11205:345484] run glyph point 24.000000 0.000000
2017-02-27 15:12:46.256 CoreTextDemo[11205:345484] run glyph size 18.342000 0.000000
2017-02-27 15:12:46.256 CoreTextDemo[11205:345484] run glyph index 2 3
2017-02-27 15:12:46.256 CoreTextDemo[11205:345484] run string range 2 3
2017-02-27 15:12:46.256 CoreTextDemo[11205:345484] run ascent 15.480000,descent 2.520000,leading 0.540000
2017-02-27 15:12:46.257 CoreTextDemo[11205:345484] 不知道能干嘛 run image rect {{19.619999999999997, -1.7459999999999998}, {34.128, 16.631999999999998}}
2017-02-27 15:12:46.257 CoreTextDemo[11205:345484] run transform [1, 0, 0, 1, 0, 0]

从run 的api中可以看出，run 是CGGlyph 组成的。CGGlayph可以用来创建字体。

CTRun CTLine CTFrame CTFrameSetter 这些就可以完成文本的布局了。

难点攻关

kCTRunStatusRightToLeft

 CGContextRef context = UIGraphicsGetCurrentContext();
    NSMutableAttributedString *mabstring = [[NSMutableAttributedString alloc]initWithString:@"富文本学习/慢慢来吧。不是一朝一夕之功。ok   \n ok ok富文本学习/慢慢来吧。不是一朝一夕之功。ok  ok ok富文本学习/慢慢来吧。不是一朝一夕之功。ok  ok ok富文本学习/慢慢来吧。不是一朝一夕之功。ok  ok ok富文本学习/慢慢来吧。不是一朝一夕之功。ok  ok ok富文本学习/慢慢来吧。不是一朝一夕之功。ok  ok ok"];
    
    NSMutableDictionary * dic1 = [NSMutableDictionary dictionaryWithObject:@[@(kCTWritingDirectionRightToLeft | kCTWritingDirectionOverride)] forKey:(__bridge NSString *)kCTWritingDirectionAttributeName];
    [mabstring setAttributes:dic1 range:NSMakeRange(0, mabstring.length)];
    
    CTFramesetterRef framesetter = CTFramesetterCreateWithAttributedString((CFAttributedStringRef)mabstring);
    
    CGMutablePathRef Path = CGPathCreateMutable();
    CGPathAddRect(Path, NULL ,CGRectMake(0 , 0 ,self.bounds.size.width , self.bounds.size.height-60));
    
    NSMutableDictionary * Framedic = [NSMutableDictionary dictionary];
    
    [Framedic setObject:@(kCTFrameProgressionTopToBottom) forKey:(__bridge NSString *)kCTFrameProgressionAttributeName];
    [Framedic setObject:@(kCTFramePathFillEvenOdd) forKey:(__bridge NSString *)kCTFramePathFillRuleAttributeName];
    CFRange range = CFRangeMake(0, 0);
    CTFrameRef frame = CTFramesetterCreateFrame(framesetter,range, Path, (__bridge CFDictionaryRef) Framedic);
    
    CGRect rectBoud = CGPathGetBoundingBox(Path);
    CFRange fitRange = CFRangeMake(0, 0);
    
    
    CGSize size =CTFramesetterSuggestFrameSizeWithConstraints(framesetter, range, (__bridge CFDictionaryRef) Framedic, rectBoud.size, &fitRange);
    NSArray * array = (__bridge NSArray * )CTFrameGetLines(frame);
    
    for (int i=0; i<array.count; i++) {
        CTLineRef line = (__bridge CTLineRef)(array[i]);
        NSArray * runArr = (__bridge NSArray *)  CTLineGetGlyphRuns(line);
        
        
        if (runArr.count>1) {
            CTRunRef run = (__bridge CTRunRef)runArr[1];
            CFIndex index =  CTRunGetGlyphCount(run);
            CTRunStatus status = CTRunGetStatus(run);
            NSLog(@"run status %d",status);
        }
    }
    CGContextSetTextMatrix(context , CGAffineTransformIdentity);
    CGContextTranslateCTM(context , 0 ,self.bounds.size.height);
    CGContextScaleCTM(context, 1.0 ,-1.0);
    CTFrameDraw(frame,context);
结果
2017-03-08 11:35:08.390 CoreTextDemo[73352:3199845] run status 1
2017-03-08 11:35:08.390 CoreTextDemo[73352:3199845] run status 1
2017-03-08 11:35:08.390 CoreTextDemo[73352:3199845] run status 1
2017-03-08 11:35:08.391 CoreTextDemo[73352:3199845] run status 1
2017-03-08 11:35:08.391 CoreTextDemo[73352:3199845] run status 1

截图