TKImageView
An easy way to crop an image.
Features
- Both iPhone/iPad available
- Support pinch gesture to zoom
- Support pan gesture to move&resize
- Support cutomize line width and color
- Support cross line and middle line
System requirements
- iOS 7.0 or higher
Samples
Properties
| name | type | description |
|---|---|---|
| toCropImage | UIImage | 待裁剪的图片。 The image you want to crop. |
| needScaleCrop | BOOL | 是否需要缩放裁剪。 Determines whether you need to scale crop with pinch gesture or not. |
| showMidLines | BOOL | 是否需要显示每条边中间的线，这条中间线支持拖动手势。 Show the lines in the middle of each border, which can receive pan gesture to resize the crop area when the aspect ratio is ZERO. |
| showCrossLines | BOOL | 是否显示裁剪框内的交叉线。 Show the cross lines in the crop area. |
| cropAspectRatio | CGFloat | 设置裁剪框的宽高比。 The aspect retio you want to crop the image, equals to WIDTH / HEIGHT. |
| cropAreaBorderLineColor | UIColor | 设置裁剪边框的颜色。 The color of border lines. |
| cropAreaBorderLineWidth | CGFloat | 设置裁剪边框的线宽。 The width of border lines. |
| cropAreaCornerLineColor | UIColor | 设置裁剪边框四个角的颜色。 The line color of the corner. |
| cropAreaCornerLineWidth | CGFloat | 设置裁剪边框四个角的线宽。 The line width of the corner. |
| cropAreaCornerWidth | CGFloat | 设置裁剪边框四个角的宽度，这里指角的横边的长度。 The width of the corner area, indicate the length of the horizontal line of the corner. |
| cropAreaCornerHeight | CGFloat | 设置裁剪边框四个角的高度，这里指角的竖边的长度。 The height of the corner area, indicate the length of the vertical line of the corner. |
| minspace | CGFloat | 相邻角之间的最小距离。 The minimum distance between the corners. |
| cropAreaCrossLineWidth | CGFloat | 裁剪框内交叉线的宽度。 The width of cross lines. |
| cropAreaCrossLineColor | UIColor | 裁剪框内交叉线的颜色。 The color of cross lines. |
| cropAreaMidLineWidth | CGFloat | 裁剪边框每条边中间线的长度。 The width of middle lines. |
| cropAreaMidLineHeight | CGFloat | 裁剪边框每条边中间线的线宽。 The height of middle lines. |
| cropAreaMidLineColor | UIColor | 裁剪边框每条边中间线的颜色。 The color of middle lines. |
| maskColor | UIColor | 裁剪区域的蒙板颜色。 The color of the mask view which is always transparent black. |
| cornerBorderInImage | BOOL | 裁剪边框的四个角是否可以超出图片显示。 Whether the corner border inside the image or not. |
Usage
TKImageView supports both initWithFrame and initWithCoder to initialize.You can customize your TKImageView instance with the properties to match your design.
@property (weak, nonatomic) IBOutlet TKImageView *tkImageView;
- (void)viewDidLoad {
_tkImageView.toCropImage = [UIImage imageNamed: @"test.jpg"];
_tkImageView.showMidLines = YES;
_tkImageView.needScaleCrop = YES;
_tkImageView.showCrossLines = YES;
_tkImageView.cornerBorderInImage = NO;
_tkImageView.cropAreaCornerWidth = 44;
_tkImageView.cropAreaCornerHeight = 44;
_tkImageView.minSpace = 30;
_tkImageView.cropAreaCornerLineColor = [UIColor whiteColor];
_tkImageView.cropAreaBorderLineColor = [UIColor whiteColor];
_tkImageView.cropAreaCornerLineWidth = 8;
_tkImageView.cropAreaBorderLineWidth = 6;
_tkImageView.cropAreaMidLineWidth = 30;
_tkImageView.cropAreaMidLineHeight = 8;
_tkImageView.cropAreaMidLineColor = [UIColor whiteColor];
_tkImageView.cropAreaCrossLineColor = [UIColor whiteColor];
_tkImageView.cropAreaCrossLineWidth = 6;
}
Function
You can get the cropped image by this function.
- (UIImage *)currentCroppedImage;
Bug&Feature Report
If you find any bugs in my code or you think it is useful to add some features in this tool, please write a issue or mail to me [email protected], thanks a lot!