UIBezierPath 是 UIKit 提供的向量路徑類別,主要用來封裝 Core Graphics 的 CGPathRef。透過它可以建立矩形、圓形、橢圓、多邊形、弧線,以及二次與三次貝塞爾曲線等常見圖形。
一個 UIBezierPath 物件可包含一個或多個 subpath。每個 subpath 由直線段或曲線段組成,而每段都會定義起點、終點與必要的控制點。建立路徑時,通常會先設定起始點,再逐步加入線段或曲線,最後設定線寬、線端與轉折樣式,並以 stroke 或 fill 完成繪製。
如果希望後續能整體移動圖形,建議將路徑建立在接近原點的座標上,再利用繪圖上下文進行平移,這樣會比逐一修改座標更方便。
多邊形可由 moveToPoint: 與 addLineToPoint: 組合建立。先指定起點,再依序加入各邊的終點。若需要封閉圖形,可呼叫 closePath,系統會自動補上最後一個點到第一個點之間的線段。
若將描邊改為填色,就會看到封閉區域被填滿:
因此,stroke 主要用來繪製輪廓,fill 則會填滿路徑內部。
矩形可直接使用 bezierPathWithRect: 建立。建立後,再設定 lineWidth、lineCapStyle、lineJoinStyle 等屬性,即可呼叫 stroke 或 fill 完成繪製。
使用 bezierPathWithOvalInRect: 可建立內切於指定矩形的橢圓。若傳入的是正方形,就會得到圓形;若傳入長方形,則會得到橢圓。
弧線可使用 bezierPathWithArcCenter:radius:startAngle:endAngle:clockwise: 建立。參數分別代表圓心、半徑、起始角度、結束角度,以及是否順時針繪製。
角度通常以弧度表示,實務上常會自訂巨集或方法,將一般角度轉換為弧度。
二次貝塞爾曲線只需要一個控制點,可使用 addQuadCurveToPoint:controlPoint: 加入。曲線會從目前點出發,受到控制點影響後,抵達指定的終點。
實際繪製結果會呈現平滑的弧形過渡:
三次貝塞爾曲線則使用兩個控制點,可使用 addCurveToPoint:controlPoint1:controlPoint2: 加入。由於有兩個控制點,因此能描述更複雜的彎曲變化。
UIBezierPath 提供 CGPath 屬性,讓開發者可以直接操作底層路徑。若要混用 Core Graphics 與 UIBezierPath,不能直接修改唯讀的 CGPath,而應該先建立可變副本,修改完成後再設定回 CGPath。
在自訂 View 的 drawRect: 方法中建立路徑後,可先設定填色與描邊顏色,再透過 Graphics Context 平移座標,最後依需求呼叫 fill 與 stroke。若同時需要填色與描邊,通常建議先填色再描邊,避免填色覆蓋線條。