//
// UIBezierPath.h
// UIKit
//
// Copyright (c) 2009-2015 Apple Inc. All rights reserved.
//
#import <Foundation/Foundation.h>
#import <CoreGraphics/CoreGraphics.h>
#import <UIKit/UIKitDefines.h>
NS_ASSUME_NONNULL_BEGIN
typedef NS_OPTIONS(NSUInteger, UIRectCorner) {
UIRectCornerTopLeft = 1 << 0, // 上左圆角
UIRectCornerTopRight = 1 << 1, // 上右圆角
UIRectCornerBottomLeft = 1 << 2, // 下左圆角
UIRectCornerBottomRight = 1 << 3, // 下右圆角
UIRectCornerAllCorners = ~0UL // 四个角都是圆角
};
NS_CLASS_AVAILABLE_IOS(3_2) @interface UIBezierPath : NSObject<NSCopying, NSCoding>
// 创建一个贝塞尔曲线
+ (instancetype)bezierPath;
// 创建一个方形
+ (instancetype)bezierPathWithRect:(CGRect)rect;
// 创建一个椭圆
+ (instancetype)bezierPathWithOvalInRect:(CGRect)rect;
// 创建一个圆角方形
// cornerRadius:圆角半径
// rounds all corners with the same horizontal and vertical radius
+ (instancetype)bezierPathWithRoundedRect:(CGRect)rect cornerRadius:(CGFloat)cornerRadius;
// 创建一个圆角方形
// cornerRadii:圆角size
// corners: 圆角位置
+ (instancetype)bezierPathWithRoundedRect:(CGRect)rect byRoundingCorners:(UIRectCorner)corners cornerRadii:(CGSize)cornerRadii;
// 创建一个弧线
// center:弧线中心点
// startAngle:弧线开始角度
// endAngle:结束角度
// clockwise:是否是顺时针方向 YES:顺时针
+ (instancetype)bezierPathWithArcCenter:(CGPoint)center radius:(CGFloat)radius startAngle:(CGFloat)startAngle endAngle:(CGFloat)endAngle clockwise:(BOOL)clockwise;
// 通过已经有的CGPathRef路径,创建贝塞尔曲线
+ (instancetype)bezierPathWithCGPath:(CGPathRef)CGPath;
// 初始化方法
- (instancetype)init NS_DESIGNATED_INITIALIZER;
//
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;
// Returns an immutable CGPathRef which is only valid until the UIBezierPath is further mutated.
// Setting the path will create an immutable copy of the provided CGPathRef, so any further mutations on a provided CGMutablePathRef will be ignored.
// 贝塞尔曲线的路径属性
@property(nonatomic) CGPathRef CGPath;
- (CGPathRef)CGPath NS_RETURNS_INNER_POINTER CF_RETURNS_NOT_RETAINED;
// Path construction
// 移动到某个点
- (void)moveToPoint:(CGPoint)point;
// 添加线段到某个点
- (void)addLineToPoint:(CGPoint)point;
// 添加曲线到某个点
// endPoint:曲线末尾的点
// controlPoint1:贝塞尔曲线控制点一
// controlPoint2:贝塞尔曲线控制点二
- (void)addCurveToPoint:(CGPoint)endPoint controlPoint1:(CGPoint)controlPoint1 controlPoint2:(CGPoint)controlPoint2;
// 添加曲线到某个点
// endPoint:曲线末尾的点
// controlPoint:贝塞尔曲线控制点
- (void)addQuadCurveToPoint:(CGPoint)endPoint controlPoint:(CGPoint)controlPoint;
// 添加弧线
// center:弧线中心点
// startAngle:开始角度
// endAngle:末尾角度
// clockwise:是否是顺时针
- (void)addArcWithCenter:(CGPoint)center radius:(CGFloat)radius startAngle:(CGFloat)startAngle endAngle:(CGFloat)endAngle clockwise:(BOOL)clockwise NS_AVAILABLE_IOS(4_0);
// 关闭路径
- (void)closePath;
// 删除所有的点儿
- (void)removeAllPoints;
// 追加贝塞尔曲线
- (void)appendPath:(UIBezierPath *)bezierPath;
// 翻转贝塞尔曲线
// Modified paths
- (UIBezierPath *)bezierPathByReversingPath NS_AVAILABLE_IOS(6_0);
// 使用矩阵变换
// Transforming paths
- (void)applyTransform:(CGAffineTransform)transform;
// Path info(路径信息)
@property(readonly,getter=isEmpty) BOOL empty; // 是否是空路径
@property(nonatomic,readonly) CGRect bounds; // 路径的bounds
@property(nonatomic,readonly) CGPoint currentPoint; // 路径当前的点
- (BOOL)containsPoint:(CGPoint)point; // 路径是否包含某个点
// Drawing properties (绘制属性)
@property(nonatomic) CGFloat lineWidth; // 线宽
@property(nonatomic) CGLineCap lineCapStyle; // 线头 & 线尾的样式(圆、)
@property(nonatomic) CGLineJoin lineJoinStyle; // 两条线交接地方的样式(圆、)
@property(nonatomic) CGFloat miterLimit; // Used when lineJoinStyle is kCGLineJoinMiter(该属性起作用,当 lineJoinStyle = kCGLineJoinMiter的时候)
@property(nonatomic) CGFloat flatness; // 待定
@property(nonatomic) BOOL usesEvenOddFillRule; // Default is NO. When YES, the even-odd fill rule is used for drawing, clipping, and hit testing.
// 设置虚线
- (void)setLineDash:(nullable const CGFloat *)pattern count:(NSInteger)count phase:(CGFloat)phase;
//
- (void)getLineDash:(nullable CGFloat *)pattern count:(nullable NSInteger *)count phase:(nullable CGFloat *)phase;
// Path operations on the current graphics context
// 填充
- (void)fill;
// 描边
- (void)stroke;
// These methods do not affect the blend mode or alpha of the current graphics context
- (void)fillWithBlendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha;
- (void)strokeWithBlendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha;
// 添加裁剪
- (void)addClip;
@end
NS_ASSUME_NONNULL_END
网友评论