add Some uikit annotation

Categories/UIKit/UIBezierPath/UIBezierPath+SVG.h

@@ -9,5 +9,10 @@
 #import <UIKit/UIKit.h>
 
 @interface UIBezierPath (SVG)
+/**
+ *  @brief  UIBezierPath转成SVG
+ *
+ *  @return SVG
+ */
 - (NSString*)toSVGString;
 @end

Categories/UIKit/UIBezierPath/UIBezierPath+SVG.m

@@ -9,6 +9,11 @@
 #import "UIBezierPath+SVG.h"
 static void SVGApplier(void* info, const CGPathElement* element);
 @implementation UIBezierPath (ZTKit)
+/**
+ *  @brief  UIBezierPath转成SVG
+ *
+ *  @return SVG
+ */
 - (NSString*)toSVGString
 {
     CGPathRef path = [self CGPath];

Categories/UIKit/UIButton/UIButton+BackgroundColor.h

@@ -9,6 +9,11 @@
 #import <UIKit/UIKit.h>
 
 @interface UIButton (BackgroundColor)
-
+/**
+ *  @brief  使用颜色设置按钮背景
+ *
+ *  @param backgroundColor 背景颜色
+ *  @param state           按钮状态
+ */
 - (void)setBackgroundColor:(UIColor *)backgroundColor forState:(UIControlState)state;
 @end

Categories/UIKit/UIButton/UIButton+BackgroundColor.m

@@ -9,7 +9,12 @@
 #import "UIButton+BackgroundColor.h"
 
 @implementation UIButton (BackgroundColor)
-
+/**
+ *  @brief  使用颜色设置按钮背景
+ *
+ *  @param backgroundColor 背景颜色
+ *  @param state           按钮状态
+ */
 - (void)setBackgroundColor:(UIColor *)backgroundColor forState:(UIControlState)state
 {
     [self setBackgroundImage:[UIButton imageWithColor:backgroundColor] forState:state];

Categories/UIKit/UIButton/UIButton+TouchAreaInsets.h

@@ -26,7 +26,9 @@
 #import <UIKit/UIKit.h>
 
 @interface UIButton (JLUtils)
-
+/**
+ *  @brief  设置按钮额外热区
+ */
 @property (nonatomic, assign) UIEdgeInsets touchAreaInsets;
 
 @end

Categories/UIKit/UIButton/UIButton+TouchAreaInsets.m

@@ -31,7 +31,9 @@ - (UIEdgeInsets)touchAreaInsets
 {
 	return [objc_getAssociatedObject(self, @selector(touchAreaInsets)) UIEdgeInsetsValue];
 }
-
+/**
+ *  @brief  设置按钮额外热区
+ */
 - (void)setTouchAreaInsets:(UIEdgeInsets)touchAreaInsets
 {
     NSValue *value = [NSValue valueWithUIEdgeInsets:touchAreaInsets];

Categories/UIKit/UIColor/UIColor+Gradient.h

@@ -9,6 +9,14 @@
 #import <UIKit/UIKit.h>
 
 @interface UIColor (Gradient)
-//渐变
+/**
+ *  @brief  渐变颜色
+ *
+ *  @param c1     开始颜色
+ *  @param c2     结束颜色
+ *  @param height 渐变高度
+ *
+ *  @return 渐变颜色
+ */
 + (UIColor*)gradientFromColor:(UIColor*)c1 toColor:(UIColor*)c2 withHeight:(int)height;
 @end

Categories/UIKit/UIColor/UIColor+Gradient.m

@@ -11,7 +11,15 @@
 @implementation UIColor (Gradient)
 
 #pragma mark - Gradient Color
-
+/**
+ *  @brief  渐变颜色
+ *
+ *  @param c1     开始颜色
+ *  @param c2     结束颜色
+ *  @param height 渐变高度
+ *
+ *  @return 渐变颜色
+ */
 + (UIColor*)gradientFromColor:(UIColor*)c1 toColor:(UIColor*)c2 withHeight:(int)height
 {
     CGSize size = CGSizeMake(1, height);

Categories/UIKit/UIColor/UIColor+Random.h

@@ -9,5 +9,10 @@
 #import <UIKit/UIKit.h>
 
 @interface UIColor (Random)
+/**
+ *  @brief  随机颜色
+ *
+ *  @return UIColor
+ */
 + (UIColor *)RandomColor;
 @end

Categories/UIKit/UIColor/UIColor+Web.h

@@ -9,8 +9,16 @@
 #import <UIKit/UIKit.h>
 
 @interface UIColor (Web)
-// 获取canvas用的颜色字符串
+/**
+ *  @brief  获取canvas用的颜色字符串
+ *
+ *  @return canvas颜色
+ */
 - (NSString *)canvasColorString;
-//获取网页颜色字串
+/**
+ *  @brief  获取网页颜色字串
+ *
+ *  @return 网页颜色
+ */
 - (NSString *)webColorString;
 @end

Categories/UIKit/UIColor/UIColor+Web.m

@@ -9,7 +9,11 @@
 #import "UIColor+Web.h"
 
 @implementation UIColor (Web)
-/// 获取canvas用的颜色字符串
+/**
+ *  @brief  获取canvas用的颜色字符串
+ *
+ *  @return canvas颜色
+ */
 - (NSString *)canvasColorString
 {
     CGFloat *arrRGBA = [self getRGB];
@@ -19,7 +23,11 @@ - (NSString *)canvasColorString
     float a = arrRGBA[3];
     return [NSString stringWithFormat:@"rgba(%d,%d,%d,%f)", r, g, b, a];
 }
-/// 获取网页颜色字串
+/**
+ *  @brief  获取网页颜色字串
+ *
+ *  @return 网页颜色
+ */
 - (NSString *)webColorString
 {
     CGFloat *arrRGBA = [self getRGB];

Categories/UIKit/UIImage/UIImage+Alpha.h

@@ -7,12 +7,34 @@
 #import <UIKit/UIKit.h>
 
 @interface UIImage (Alpha)
+/**
+ *  @brief  是否有alpha通道
+ *
+ *  @return 是否有alpha通道
+ */
 - (BOOL)hasAlpha;
+/**
+ *  @brief  如果没有alpha通道 增加alpha通道
+ *
+ *  @return 如果没有alpha通道 增加alpha通道
+ */
 - (UIImage *)imageWithAlpha;
+/**
+ *  @brief  增加透明边框
+ *
+ *  @param borderSize 边框尺寸
+ *
+ *  @return 增加透明边框后的图片
+ */
 - (UIImage *)transparentBorderImage:(NSUInteger)borderSize;
 
-//裁切含透明图片为最小大小
+
 //http://stackoverflow.com/questions/6521987/crop-uiimage-to-alpha?answertab=oldest#tab-top
+/**
+ *  @brief  裁切含透明图片为最小大小
+ *
+ *  @return 裁切后的图片
+ */
 - (UIImage *)trimmedBetterSize;
 
 @end

Categories/UIKit/UIImage/UIImage+Alpha.m

@@ -11,17 +11,23 @@ - (CGImageRef)newBorderMask:(NSUInteger)borderSize size:(CGSize)size;
 @end
 
 @implementation UIImage (Alpha)
-
-// Returns true if the image has an alpha layer
+/**
+ *  @brief  是否有alpha通道
+ *
+ *  @return 是否有alpha通道
+ */
 - (BOOL)hasAlpha {
     CGImageAlphaInfo alpha = CGImageGetAlphaInfo(self.CGImage);
     return (alpha == kCGImageAlphaFirst ||
             alpha == kCGImageAlphaLast ||
             alpha == kCGImageAlphaPremultipliedFirst ||
             alpha == kCGImageAlphaPremultipliedLast);
 }
-
-// Returns a copy of the given image, adding an alpha channel if it doesn't already have one
+/**
+ *  @brief  如果没有alpha通道 增加alpha通道
+ *
+ *  @return 如果没有alpha通道 增加alpha通道
+ */
 - (UIImage *)imageWithAlpha {
     if ([self hasAlpha]) {
         return self;
@@ -54,6 +60,13 @@ - (UIImage *)imageWithAlpha {
 
 // Returns a copy of the image with a transparent border of the given size added around its edges.
 // If the image has no alpha layer, one will be added to it.
+/**
+ *  @brief  增加透明边框
+ *
+ *  @param borderSize 边框尺寸
+ *
+ *  @return 增加透明边框后的图片
+ */
 - (UIImage *)transparentBorderImage:(NSUInteger)borderSize {
     // If the image does not have an alpha layer, add one
     UIImage *image = [self imageWithAlpha];
@@ -87,7 +100,11 @@ - (UIImage *)transparentBorderImage:(NSUInteger)borderSize {
 
     return transparentBorderImage;
 }
-
+/**
+ *  @brief  裁切含透明图片为最小大小
+ *
+ *  @return 裁切后的图片
+ */
 - (UIImage *)trimmedBetterSize {
 
     CGImageRef inImage = self.CGImage;

Categories/UIKit/UIImage/UIImage+Capture.h

@@ -9,7 +9,13 @@
 #import <UIKit/UIKit.h>
 
 @interface UIImage (Capture)
-
+/**
+ *  @brief  截图指定view成图片
+ *
+ *  @param view 一个view
+ *
+ *  @return 图片
+ */
 + (UIImage *)captureWithView:(UIView *)view;
 
 ///截图（未测试是否可行）

Categories/UIKit/UIImage/UIImage+Capture.m

@@ -9,6 +9,13 @@
 #import "UIImage+Capture.h"
 #import <QuartzCore/QuartzCore.h>
 @implementation UIImage (Capture)
+/**
+ *  @brief  截图指定view成图片
+ *
+ *  @param view 一个view
+ *
+ *  @return 图片
+ */
 + (UIImage *)captureWithView:(UIView *)view
 {
     UIGraphicsBeginImageContextWithOptions(view.bounds.size, view.opaque, [UIScreen mainScreen].scale);

Categories/UIKit/UIImage/UIImage+Color.h

@@ -9,14 +9,45 @@
 #import <UIKit/UIKit.h>
 
 @interface UIImage (Color)
+/**
+ *  @brief  根据颜色生成纯色图片
+ *
+ *  @param color 颜色
+ *
+ *  @return 纯色图片
+ */
 + (UIImage *)imageWithColor:(UIColor *)color;
+/**
+ *  @brief  取图片某一点的颜色
+ *
+ *  @param point 某一点
+ *
+ *  @return 颜色
+ */
 - (UIColor *)colorAtPoint:(CGPoint )point;
 //more accurate method ,colorAtPixel 1x1 pixel
+/**
+ *  @brief  取某一像素的颜色
+ *
+ *  @param point 一像素
+ *
+ *  @return 颜色
+ */
 - (UIColor *)colorAtPixel:(CGPoint)point;
-//返回该图片是否有透明度通道
+/**
+ *  @brief  返回该图片是否有透明度通道
+ *
+ *  @return 是否有透明度通道
+ */
 - (BOOL)hasAlphaChannel;
 
-///获得灰度图
+/**
+ *  @brief  获得灰度图
+ *
+ *  @param sourceImage 图片
+ *
+ *  @return 获得灰度图片
+ */
 + (UIImage*)covertToGrayImageFromImage:(UIImage*)sourceImage;
 
 @end

Categories/UIKit/UIImage/UIImage+Color.m

@@ -9,6 +9,13 @@
 #import "UIImage+Color.h"
 
 @implementation UIImage (Color)
+/**
+ *  @brief  根据颜色生成纯色图片
+ *
+ *  @param color 颜色
+ *
+ *  @return 纯色图片
+ */
 + (UIImage *)imageWithColor:(UIColor *)color {
     CGRect rect = CGRectMake(0.0f, 0.0f, 1.0f, 1.0f);
     UIGraphicsBeginImageContext(rect.size);
@@ -22,6 +29,13 @@ + (UIImage *)imageWithColor:(UIColor *)color {
 
     return image;
 }
+/**
+ *  @brief  取图片某一点的颜色
+ *
+ *  @param point 某一点
+ *
+ *  @return 颜色
+ */
 - (UIColor *)colorAtPoint:(CGPoint )point
 {
     if (point.x < 0 || point.y < 0) return nil;
@@ -65,6 +79,13 @@ - (UIColor *)colorAtPoint:(CGPoint )point
     free(rawData);
     return result;
 }
+/**
+ *  @brief  取某一像素的颜色
+ *
+ *  @param point 一像素
+ *
+ *  @return 颜色
+ */
 - (UIColor *)colorAtPixel:(CGPoint)point
 {
     // Cancel if point is outside image coordinates
@@ -106,7 +127,11 @@ - (UIColor *)colorAtPixel:(CGPoint)point
     CGFloat alpha = (CGFloat)pixelData[3] / 255.0f;
     return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }
-
+/**
+ *  @brief  返回该图片是否有透明度通道
+ *
+ *  @return 是否有透明度通道
+ */
 - (BOOL)hasAlphaChannel
 {
     CGImageAlphaInfo alpha = CGImageGetAlphaInfo(self.CGImage);
@@ -116,7 +141,14 @@ - (BOOL)hasAlphaChannel
             alpha == kCGImageAlphaPremultipliedLast);
 }
 
-//转成黑白图像
+/**
+ *  @brief  获得灰度图
+ *
+ *  @param sourceImage 图片
+ *
+ *  @return 获得灰度图片
+ */
+
 + (UIImage*)covertToGrayImageFromImage:(UIImage*)sourceImage
 {
     int width = sourceImage.size.width;