【K線】UIBezierPath-API詳解

UIBezierPath對象是CGPathRef數(shù)據(jù)類型的封裝哩罪。path如果是基于矢量形狀的呀狼,都用直線和曲線段去創(chuàng)建等曼。我們使用直線段去創(chuàng)建矩形和多邊形里烦,使用曲線段去創(chuàng)建弧(arc)禁谦,圓或者其他復(fù)雜的曲線形狀胁黑。每一段都包括一個或者多個點,繪圖命令定義如何去詮釋這些點州泊。每一個直線段或者曲線段的結(jié)束的地方是下一個的開始的地方丧蘸。每一個連接的直線或者曲線段的集合成為subpath。一個UIBezierPath對象定義一個完整的路徑包括一個或者多個subpaths遥皂。

使用UIBezierPath類可以創(chuàng)建基于矢量的路徑力喷,這個類在UIKit中。它是基于Core Graphics對CGPathRef數(shù)據(jù)類型和path繪圖屬性的一個封裝渴肉,所以是需要圖形上下文的CGContextRef冗懦,所以一般UIBezierPath在drawRect中使用。使用此類可以定義簡單的形狀仇祭,如橢圓或者矩形披蕉,或者有多個直線和曲線段組成的形狀。

  • UIBezierPath的使用方法:
    (1)創(chuàng)建一個Bezier path對象乌奇。
    (2)使用方法moveToPoint:去設(shè)置初始線段的起點没讲。
    (3)添加line或者curve去定義一個或者多個subpaths。
    (4)改變UIBezierPath對象跟繪圖相關(guān)的屬性礁苗。

我們可以設(shè)置stroked path的屬性lineWidth和lineJoinStyle爬凑。也可以設(shè)置filled path的屬性usesEvenOddFillRule

本文分為三大模塊:屬性、類方法试伙、實例方法嘁信。

屬性

    1. CGPath :
      將UIBezierPath類轉(zhuǎn)換成CGPath于样,和UIColor的CGColor類似
    1. empty:
      只讀類型,路徑上是否有有效的元素
    1. bounds:
      和view的bounds是不一樣的潘靖,它獲取path的X坐標(biāo)穿剖、Y坐標(biāo)、寬度卦溢,但是高度為0
    1. currentPoint:
      當(dāng)前path的位置糊余,可以理解為path的終點
    1. lineWidth:
      可以理解為路徑的寬度
    1. lineCapStyle:
      path端點樣式,有3種樣式
typedef CF_ENUM(int32_t, CGLineCap) {
    kCGLineCapButt,  默認(rèn)的
    kCGLineCapRound, 輕微圓角
    kCGLineCapSquare 正方形
};
    1. lineJoinStyle:
      path拐角樣式单寂,也有3種樣式
typedef CF_ENUM(int32_t, CGLineJoin) {
    kCGLineJoinMiter, 默認(rèn)的表示斜接
    kCGLineJoinRound, 圓滑銜接
    kCGLineJoinBevel  斜角連接
};
    1. miterLimit:
      最大斜接長度贬芥,怎么理解呢?就是上圖中拐角處外面尖角和內(nèi)部尖角的距離宣决。但是這個只有在kCGLineJoinMiter情況下使用才有效果蘸劈,如果這個miterLimit小于斜接長度,就成為了kCGLineJoinBevel類型


      image.png
/* 
 最大斜接長度   斜接長度指的是在兩條線交匯處內(nèi)角和外角之間的距離
 只有l(wèi)ineJoin屬性為kCALineJoinMiter時miterLimit才有效
 邊角的角度越小疲扎,斜接長度就會越大昵时。
 為了避免斜接長度過長,我們可以使用 miterLimit屬性椒丧。
 如果斜接長度超過 miterLimit的值壹甥,邊角會以 lineJoin的 "bevel"即kCALineJoinBevel類型來顯示
*/
    1. UIRectCorner
      圓角 分為四種情況
typedef NS_OPTIONS(NSUInteger, UIRectCorner) {
    UIRectCornerTopLeft     = 1 << 0,
    UIRectCornerTopRight    = 1 << 1,
    UIRectCornerBottomLeft  = 1 << 2,
    UIRectCornerBottomRight = 1 << 3,
    UIRectCornerAllCorners  = ~0UL
};

類方法

// 根據(jù)一個Rect畫一個矩形曲線
+ (instancetype)bezierPath;
/**
 *  根據(jù)一個Rect畫一個橢圓曲線  Rect為正方形時畫的是一個圓
 *  @param rect CGRect一個矩形
 */
+ (instancetype)bezierPathWithRect:(CGRect)rect;
/**
 *  根據(jù)一個Rect畫一個圓角矩形曲線 (Radius:圓角半徑)   當(dāng)Rect為正方形時且Radius等于邊長一半時畫的是一個圓
 *  @param rect CGRect一個矩形
 */
+ (instancetype)bezierPathWithOvalInRect:(CGRect)rect;
/**
 *  根據(jù)一個Rect畫一個圓角矩形曲線   當(dāng)Rect為正方形時且Radius等于邊長一半時畫的是一個圓
 *  @param rect         CGRect一個矩形
 *  @param cornerRadius 圓角半徑
 */
+ (instancetype)bezierPathWithRoundedRect:(CGRect)rect 
                             cornerRadius:(CGFloat)cornerRadius; 
// rounds all corners with the same horizontal and vertical radius
/**
 *  根據(jù)一個Rect針對四角中的某個或多個角設(shè)置圓角
 *
 *  @param rect        CGRect一個矩形
 *  @param corners     允許指定矩形的部分角為圓角,而其余的角為直角壶熏,取值來自枚舉 
 *  @param cornerRadii  指定了圓角的半徑句柠,這個參數(shù)的取值是 CGSize 類型,也就意味著這里需要給出的是橢圓的半徑棒假。
 */
+ (instancetype)bezierPathWithRoundedRect:(CGRect)rect 
                        byRoundingCorners:(UIRectCorner)corners 
                              cornerRadii:(CGSize)cornerRadii;
/**
 *  以某個中心點畫弧線
 *  @param center     指定了圓弧所在正圓的圓心點坐標(biāo)
 *  @param radius     指定了圓弧所在正圓的半徑
 *  @param startAngle 指定了起始弧度位置  注意: 起始與結(jié)束這里是弧度 
 *  @param endAngle   指定了結(jié)束弧度位置  
 *  @param clockwise  指定了繪制方向溯职,以時鐘方向為判斷基準(zhǔn)   看下圖
 */
+ (instancetype)bezierPathWithArcCenter:(CGPoint)center 
                                 radius:(CGFloat)radius 
                             startAngle:(CGFloat)startAngle 
                               endAngle:(CGFloat)endAngle 
                              clockwise:(BOOL)clockwise;
2452150-5bf0e532c2a0f6d9.jpg
/**
 *  根據(jù)CGPath創(chuàng)建并返回一個新的UIBezierPath對象
 *  @param CGPath CGPathRef
 */
+ (instancetype)bezierPathWithCGPath:(CGPathRef)CGPath;

實例方法

/**
 *  設(shè)置第一個起始點到接收器
 *  @param point 起點坐標(biāo)
 */
- (void)moveToPoint:(CGPoint)point;
/**
 *  附加一條直線到接收器的路徑
 *  @param point 要到達(dá)的坐標(biāo)
 */
- (void)addLineToPoint:(CGPoint)point;
/**
 *  該方法就是畫三次貝塞爾曲線的關(guān)鍵方法,以三個點畫一段曲線帽哑,一般和moveToPoint:配合使用谜酒。其實端點為moveToPoint:設(shè)置,終止端點位為endPoint妻枕;僻族。控制點1的坐標(biāo)controlPoint1屡谐,這個參數(shù)可以調(diào)整述么。控制點2的坐標(biāo)是controlPoint2愕掏。
 *
 *  @param endPoint      終點坐標(biāo)
 *  @param controlPoint1 控制點1
 *  @param controlPoint2 控制點2  看下圖
 */
- (void)addCurveToPoint:(CGPoint)endPoint 
          controlPoint1:(CGPoint)controlPoint1 
          controlPoint2:(CGPoint)controlPoint2;
2452150-fabfa795e061d718.jpg
/**
 *  畫二次貝塞爾曲線度秘,是通過調(diào)用此方法來實現(xiàn)的。一般和moveToPoint:配合使用饵撑。endPoint終端點剑梳,controlPoint控制點唆貌,對于二次貝塞爾曲線,只有一個控制點
 *  @param endPoint     終點坐標(biāo)
 *  @param controlPoint 控制點  看下圖
 */
- (void)addQuadCurveToPoint:(CGPoint)endPoint 
               controlPoint:(CGPoint)controlPoint;
2452150-3d4952efead3a84c.jpg
/**
 *  添加一個弧線 與bezierPathWithArcCenter:radius:startAngle:endAngle:clockwise:區(qū)別是bezierPathWithArcCenter它是初始化一個弧線,addArcWithCenter是添加一個弧線,共同點就是參數(shù)都一樣
 *  @param center     指定了圓弧所在正圓的圓心點坐標(biāo)
 *  @param radius     指定了圓弧所在正圓的半徑
 *  @param startAngle 指定了起始弧度位置
 *  @param endAngle   指定了結(jié)束弧度位置
 *  @param clockwise  指定了繪制方向阻荒,以時鐘方向為判斷基準(zhǔn)
 */
- (void)addArcWithCenter:(CGPoint)center 
                  radius:(CGFloat)radius 
              startAngle:(CGFloat)startAngle 
                endAngle:(CGFloat)endAngle 
               clockwise:(BOOL)clockwise NS_AVAILABLE_IOS(4_0);
/**
 *  閉合線使用這個方法起始點與終點將相連
 */
- (void)closePath;
/**
 *  移除所有坐標(biāo)點
 */
- (void)removeAllPoints;
// Appending paths
// 添加一個paths UIBezierPath
- (void)appendPath:(UIBezierPath *)bezierPath;
// Modified paths
// 創(chuàng)建并返回一個與當(dāng)前路徑相反的新的貝塞爾路徑對象
- (UIBezierPath *)bezierPathByReversingPath NS_AVAILABLE_IOS(6_0);
  • 用指定的仿射變換矩陣變換路徑的所有點
// Transforming paths
// 用指定的仿射變換矩陣變換路徑的所有點
- (void)applyTransform:(CGAffineTransform)transform;
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末挠锥,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子侨赡,更是在濱河造成了極大的恐慌,老刑警劉巖粱侣,帶你破解...
    沈念sama閱讀 217,657評論 6 505
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件羊壹,死亡現(xiàn)場離奇詭異,居然都是意外死亡齐婴,警方通過查閱死者的電腦和手機油猫,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,889評論 3 394
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來柠偶,“玉大人情妖,你說我怎么就攤上這事∮盏#” “怎么了毡证?”我有些...
    開封第一講書人閱讀 164,057評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長蔫仙。 經(jīng)常有香客問我料睛,道長,這世上最難降的妖魔是什么摇邦? 我笑而不...
    開封第一講書人閱讀 58,509評論 1 293
  • 正文 為了忘掉前任恤煞,我火速辦了婚禮,結(jié)果婚禮上施籍,老公的妹妹穿的比我還像新娘居扒。我一直安慰自己,他們只是感情好丑慎,可當(dāng)我...
    茶點故事閱讀 67,562評論 6 392
  • 文/花漫 我一把揭開白布喜喂。 她就那樣靜靜地躺著,像睡著了一般立哑。 火紅的嫁衣襯著肌膚如雪夜惭。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,443評論 1 302
  • 那天铛绰,我揣著相機與錄音诈茧,去河邊找鬼。 笑死捂掰,一個胖子當(dāng)著我的面吹牛敢会,可吹牛的內(nèi)容都是我干的曾沈。 我是一名探鬼主播,決...
    沈念sama閱讀 40,251評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼鸥昏,長吁一口氣:“原來是場噩夢啊……” “哼塞俱!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起吏垮,我...
    開封第一講書人閱讀 39,129評論 0 276
  • 序言:老撾萬榮一對情侶失蹤障涯,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后膳汪,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體唯蝶,經(jīng)...
    沈念sama閱讀 45,561評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,779評論 3 335
  • 正文 我和宋清朗相戀三年遗嗽,在試婚紗的時候發(fā)現(xiàn)自己被綠了粘我。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,902評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡痹换,死狀恐怖征字,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情娇豫,我是刑警寧澤匙姜,帶...
    沈念sama閱讀 35,621評論 5 345
  • 正文 年R本政府宣布,位于F島的核電站锤躁,受9級特大地震影響搁料,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜系羞,卻給世界環(huán)境...
    茶點故事閱讀 41,220評論 3 328
  • 文/蒙蒙 一郭计、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧椒振,春花似錦昭伸、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,838評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至夹供,卻和暖如春灵份,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背哮洽。 一陣腳步聲響...
    開封第一講書人閱讀 32,971評論 1 269
  • 我被黑心中介騙來泰國打工填渠, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 48,025評論 2 370
  • 正文 我出身青樓氛什,卻偏偏與公主長得像莺葫,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子枪眉,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,843評論 2 354

推薦閱讀更多精彩內(nèi)容