封装CoreGraphics的API简化绘图操作
效果
说明
1. 将CoreGraphics的API接口抽象为对象,让绘图变得简单易懂
2. 简化常用的绘制操作
3. 源码长期更新
源码
https://github.com/YouXianMing/CGContextObject
//
// CGContextObject.h
// DrawRect
//
// Created by YouXianMing on 15/7/2.
// Copyright (c) 2015年 YouXianMing. All rights reserved.
// #import <Foundation/Foundation.h>
#import <CoreGraphics/CoreGraphics.h>
#import "RGBColor.h"
#import "GradientColor.h"
@class CGContextObject; typedef void(^CGContextObjectDrawBlock_t)(CGContextObject *contextObject); @interface CGContextObject : NSObject /**
* 操作句柄
*/
@property (nonatomic) CGContextRef context; /**
* 线头样式
*/
@property (nonatomic) CGLineCap lineCap; /**
* 线条宽度
*/
@property (nonatomic) CGFloat lineWidth; /**
* 线条颜色
*/
@property (nonatomic, strong) RGBColor *strokeColor; /**
* 填充颜色
*/
@property (nonatomic, strong) RGBColor *fillColor; /**
* 由context进行初始化
*
* @param context 绘制句柄
*
* @return 绘制对象
*/
- (instancetype)initWithCGContext:(CGContextRef)context; #pragma mark - 绘制操作流程
/**
* 开始path
*/
- (void)beginPath; /**
* 关闭path
*/
- (void)closePath; /**
* 线条绘制
*/
- (void)strokePath; /**
* 填充绘制
*/
- (void)fillPath; /**
* 线条绘制 + 填充绘制
*/
- (void)strokeAndFillPath; /**
* 绘制线条用block (beginPath + closePath + 你绘制的代码 + strokePath)
*
* @param block 绘制用block
*/
- (void)drawStrokeBlock:(CGContextObjectDrawBlock_t)block; /**
* 填充区域用block (beginPath + closePath + 你绘制的代码 + fillPath)
*
* @param block 填充用block
*/
- (void)drawFillBlock:(CGContextObjectDrawBlock_t)block; /**
* 绘制加填充
*
* @param block 绘制加填充用block
*/
- (void)drawStrokeAndFillBlock:(CGContextObjectDrawBlock_t)block; /**
* 绘制线条用block (beginPath + closePath + 你绘制的代码 + strokePath)
*
* @param block 绘制用block
* @param closePath 是否关闭曲线
*/
- (void)drawStrokeBlock:(CGContextObjectDrawBlock_t)block closePath:(BOOL)closePath; /**
* 填充区域用block (beginPath + closePath + 你绘制的代码 + fillPath)
*
* @param block 绘制用block
* @param closePath 是否关闭曲线
*/
- (void)drawFillBlock:(CGContextObjectDrawBlock_t)block closePath:(BOOL)closePath; /**
* 绘制加填充
*
* @param block 绘制用block
* @param closePath 是否关闭曲线
*/
- (void)drawStrokeAndFillBlock:(CGContextObjectDrawBlock_t)block closePath:(BOOL)closePath; #pragma mark - 绘制图片API - (void)drawImage:(UIImage *)image atPoint:(CGPoint)point;
- (void)drawImage:(UIImage *)image atPoint:(CGPoint)point blendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha;
- (void)drawImage:(UIImage *)image inRect:(CGRect)rect;
- (void)drawImage:(UIImage *)image inRect:(CGRect)rect blendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha;
- (void)drawImage:(UIImage *)image asPatternInRect:(CGRect)rect; #pragma mark - 保存操作 /**
* 将当前设置存取到栈区中(入栈操作)
*/
- (void)saveStateToStack; /**
* 从栈区中取出之前保存的设置(出栈操作)
*/
- (void)restoreStateFromStack; #pragma mark - 图形绘制API
/**
* 移动到起始点
*
* @param point 起始点
*/
- (void)moveToStartPoint:(CGPoint)point; /**
* 添加一个点(与上一个点直线相连)
*
* @param point 点
*/
- (void)addLineToPoint:(CGPoint)point; /**
* 添加二次贝塞尔曲线
*
* @param point 结束点
* @param pointOne 控制点1
* @param pointTwo 控制点2
*/
- (void)addCurveToPoint:(CGPoint)point controlPointOne:(CGPoint)pointOne controlPointTwo:(CGPoint)pointTwo; /**
* 添加一次贝塞尔曲线
*
* @param point 结束点
* @param controlPoint 控制点
*/
- (void)addQuadCurveToPoint:(CGPoint)point controlPoint:(CGPoint)controlPoint; /**
* 在指定的区域填充彩色的矩形（此为直接绘制）
*
* @param rect 指定的区域
* @param gradientColor 渐变色对象
*/
- (void)drawLinearGradientAtClipToRect:(CGRect)rect gradientColor:(GradientColor *)gradientColor; #pragma mark -
/**
* 添加一个矩形
*
* @param rect
*/
- (void)addRect:(CGRect)rect; /**
* 在给定的矩形中绘制椭圆
*
* @param rect
*/
- (void)addEllipseInRect:(CGRect)rect; /**
* 将string绘制在指定的点上
*
* @param string 字符串
* @param point 点
* @param attributes 富文本设置（可以为空）
*/
- (void)drawString:(NSString *)string atPoint:(CGPoint)point withAttributes:(NSDictionary *)attributes; /**
* 将string绘制在制定的区域
*
* @param string 字符串
* @param rect 区域
* @param attributes 富文本设置（可以为空）
*/
- (void)drawString:(NSString *)string inRect:(CGRect)rect withAttributes:(NSDictionary *)attributes; /**
* 将富文本绘制在制定的点上
*
* @param string 富文本
* @param point 点
*/
- (void)drawAttributedString:(NSAttributedString *)string atPoint:(CGPoint)point; /**
* 将富文本绘制在制定的矩形中
*
* @param string 富文本
* @param rect 矩形
*/
- (void)drawAttributedString:(NSAttributedString *)string inRect:(CGRect)rect; @end
//
// CGContextObject.m
// DrawRect
//
// Created by YouXianMing on 15/7/2.
// Copyright (c) 2015年 YouXianMing. All rights reserved.
// #import "CGContextObject.h" @interface CGContextObject () @end @implementation CGContextObject - (instancetype)initWithCGContext:(CGContextRef)context { self = [super init];
if (self) { self.context = context;
} return self;
} - (void)moveToStartPoint:(CGPoint)point { if (_context) {
CGContextMoveToPoint(_context, point.x, point.y);
}
} - (void)addLineToPoint:(CGPoint)point { if (_context) {
CGContextAddLineToPoint(_context, point.x, point.y);
}
} - (void)addCurveToPoint:(CGPoint)point controlPointOne:(CGPoint)pointOne controlPointTwo:(CGPoint)pointTwo { if (_context) {
CGContextAddCurveToPoint(_context, pointOne.x, pointOne.y, pointTwo.x, pointTwo.y, point.x, point.y);
}
} - (void)addQuadCurveToPoint:(CGPoint)point controlPoint:(CGPoint)controlPoint { if (_context) {
CGContextAddQuadCurveToPoint(_context, controlPoint.x, controlPoint.y, point.x, point.y);
}
} - (void)drawLinearGradientAtClipToRect:(CGRect)rect gradientColor:(GradientColor *)gradientColor { [self saveStateToStack]; if (_context) { CGContextClipToRect(_context, rect); CGContextDrawLinearGradient(_context,
gradientColor.gradientRef,
gradientColor.gradientStartPoint,
gradientColor.gradientEndPoint, kCGGradientDrawsBeforeStartLocation);
} [self restoreStateFromStack];
} - (void)addRect:(CGRect)rect { if (_context) {
CGContextAddRect(_context, rect);
}
} - (void)addEllipseInRect:(CGRect)rect { if (_context) {
CGContextAddEllipseInRect(_context, rect);
}
} - (void)drawString:(NSString *)string atPoint:(CGPoint)point withAttributes:(NSDictionary *)attributes { [string drawAtPoint:point withAttributes:attributes];
} - (void)drawString:(NSString *)string inRect:(CGRect)rect withAttributes:(NSDictionary *)attributes { [string drawInRect:rect withAttributes:attributes];
} - (void)drawAttributedString:(NSAttributedString *)string atPoint:(CGPoint)point { [string drawAtPoint:point];
} - (void)drawAttributedString:(NSAttributedString *)string inRect:(CGRect)rect { [string drawInRect:rect];
} - (void)beginPath { if (_context) {
CGContextBeginPath(_context);
}
} - (void)closePath { if (_context) {
CGContextClosePath(_context);
}
} - (void)strokePath { if (_context) {
CGContextStrokePath(_context);
}
} - (void)fillPath { if (_context) {
CGContextFillPath(_context);
}
} - (void)strokeAndFillPath { if (_context) {
CGContextDrawPath(_context, kCGPathFillStroke);
}
} - (void)drawStrokeBlock:(CGContextObjectDrawBlock_t)block { [self beginPath]; __weak CGContextObject *weakSelf = self; block(weakSelf); [self closePath]; [self strokePath];
} - (void)drawFillBlock:(CGContextObjectDrawBlock_t)block { [self beginPath]; __weak CGContextObject *weakSelf = self; block(weakSelf); [self closePath]; [self fillPath];
} - (void)drawStrokeAndFillBlock:(CGContextObjectDrawBlock_t)block { [self beginPath]; __weak CGContextObject *weakSelf = self; block(weakSelf); [self closePath]; [self strokeAndFillPath];
} - (void)drawStrokeBlock:(CGContextObjectDrawBlock_t)block closePath:(BOOL)closePath { [self beginPath]; __weak CGContextObject *weakSelf = self; block(weakSelf); if (closePath) {
[self closePath];
} [self strokePath];
} - (void)drawFillBlock:(CGContextObjectDrawBlock_t)block closePath:(BOOL)closePath { [self beginPath]; __weak CGContextObject *weakSelf = self; block(weakSelf); if (closePath) {
[self closePath];
} [self fillPath];
} - (void)drawStrokeAndFillBlock:(CGContextObjectDrawBlock_t)block closePath:(BOOL)closePath { [self beginPath]; __weak CGContextObject *weakSelf = self; block(weakSelf); if (closePath) {
[self closePath];
} [self strokeAndFillPath];
} - (void)drawImage:(UIImage *)image atPoint:(CGPoint)point { [image drawAtPoint:point];
} - (void)drawImage:(UIImage *)image atPoint:(CGPoint)point blendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha { [image drawAtPoint:point blendMode:blendMode alpha:alpha];
} - (void)drawImage:(UIImage *)image inRect:(CGRect)rect { [image drawInRect:rect];
} - (void)drawImage:(UIImage *)image inRect:(CGRect)rect blendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha { [image drawInRect:rect blendMode:blendMode alpha:alpha];
} - (void)drawImage:(UIImage *)image asPatternInRect:(CGRect)rect { [image drawAsPatternInRect:rect];
} - (void)saveStateToStack { if (_context) {
CGContextSaveGState(_context);
}
} - (void)restoreStateFromStack { if (_context) {
CGContextRestoreGState(_context);
}
} #pragma mark - 重写setter,getter方法
@synthesize strokeColor = _strokeColor;
- (void)setStrokeColor:(RGBColor *)strokeColor { if (_context) { _strokeColor = strokeColor;
CGContextSetRGBStrokeColor(_context, strokeColor.red, strokeColor.green, strokeColor.blue, strokeColor.alpha);
}
}
- (RGBColor *)strokeColor { return _strokeColor;
} @synthesize fillColor = _fillColor;
- (void)setFillColor:(RGBColor *)fillColor { if (_context) { _fillColor = fillColor;
CGContextSetRGBFillColor(_context, fillColor.red, fillColor.green, fillColor.blue, fillColor.alpha);
}
}
- (RGBColor *)fillColor { return _fillColor;
} @synthesize lineWidth = _lineWidth;
- (void)setLineWidth:(CGFloat)lineWidth { if (_context) { _lineWidth = lineWidth;
CGContextSetLineWidth(_context, lineWidth);
}
}
- (CGFloat)lineWidth { return _lineWidth;
} @synthesize lineCap = _lineCap;
- (void)setLineCap:(CGLineCap)lineCap { if (_context) { _lineCap = lineCap;
CGContextSetLineCap(_context, lineCap);
} }
- (CGLineCap)lineCap { return _lineCap;
} @end
细节