iOS - UIImageView

前言

    NS_CLASS_AVAILABLE_IOS(2_0) @interface UIImageView : UIView 
    @available(iOS 2.0, *)       public class UIImageView : UIView
  • 需要注意的是,Apple 对 png 格式图片支持最为良好的,对于其他格式支持相对较弱,当图片是 png 格式,那么图片名的后缀 .png 可以不写,但是如果图像只有 @2x 图片,没有一倍图像,则不能忽略 .png,在 iPhone4 以后,苹果采用视网膜屏幕,所以就有了 2 倍像素图像,随着发展现在有了 @3x 图,如果你现在还在用 Xcode5.1 写程序,在适配 iPhone6 以及 6+ 会自动放大即可,但是在 Xcode6 上就需要考虑适配问题,不会自动适配了。

  • 如果不是 png 格式,请务必要加入后缀名,否则可能无法显示。比如目前无法直接加载 gif 图。

1、UIImageView 的创建

  • Objective-C

    • 先设置 frame 后添加 image

          // 创建一个图片视图,只有图片 image 是显示不出来的,需要 image 放到 imageView 上才能显示出来
          UIImageView *imageView = [[UIImageView alloc] initWithFrame:self.view.bounds];
          imageView.image = [UIImage imageNamed:@"1"];
      
          [self.view addSubview:imageView];
    • 先添加 image 后设置 frame

          UIImageView *imageView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"13"]];
      
          // 可以不设置 frame,不设置时 imageView 的大小 与 image 的大小相同
          imageView.frame = self.view.bounds;
      
          [self.view addSubview:imageView];
  • Swift

    • 先设置 frame 后添加 image

          // 创建一个图片视图,只有图片 image 是显示不出来的,需要 image 放到 imageView 上才能显示出来
          let imageView:UIImageView = UIImageView(frame: self.view.bounds)
          imageView.image = UIImage(named: "1")
      
          self.view.addSubview(imageView)
    • 先添加 image 后设置 frame

          let imageView:UIImageView = UIImageView(image: UIImage(named: "13"))
      
          // 可以不设置 frame,不设置时 imageView 的大小 与 image 的大小相同
          imageView.frame = self.view.bounds
      
          self.view.addSubview(imageView)

2、UIImageView 的设置

  • Objective-C

        // 设置 frame
        /*
            imageView.image.size.width, imageView.image.size.height 可获取 imageView image 中图片的尺寸
        */
        imageView.frame = CGRectMake(10, 30, [UIScreen mainScreen].bounds.size.width - 20, [UIScreen mainScreen].bounds.size.height - 40);
    
        // 设置图片填充方式
        /*
            当图片小于 imageView 的大小时,处理图片的显示方式
    
            // 缩放图片,使图片充满容器。图片未必保持长宽比例协调,有可能会拉伸至变形。默认
            UIViewContentModeScaleToFill,
    
            // 在保持长宽比的前提下,缩放图片,使得图片在容器内完整显示出来
            UIViewContentModeScaleAspectFit,
    
            // 在保持长宽比的前提下,缩放图片,使图片充满容器
            UIViewContentModeScaleAspectFill,
    
            UIViewContentModeRedraw,
            UIViewContentModeCenter,
            UIViewContentModeTop,
            UIViewContentModeBottom,
            UIViewContentModeLeft,
            UIViewContentModeRight,
            UIViewContentModeTopLeft,
            UIViewContentModeTopRight,
            UIViewContentModeBottomLeft,
            UIViewContentModeBottomRight,
        */
        imageView.contentMode = UIViewContentModeScaleToFill;
    
        // 设置透明度
        imageView.alpha = 0.5;
    
        // 设置 image
        /*
            图片名称为 nil 时,控制台会打印输出 CUICatalog: Invalid asset name supplied: (null)
        */
    
            // 正常状态时的图片
            imageView.image = [UIImage imageNamed:@"18"];
    
            // 高亮状态时的图片
            imageView.highlightedImage = [UIImage imageNamed:@"17"];
    
        // 设置是否隐藏
        imageView.hidden = YES;
    
        // 设置 imageView 的交互属性
        /*
            UIImageView 的交互属性默认是关闭的
        */
        imageView.userInteractionEnabled = YES;
    
        // 为图片添加单击事件
        /*
            一定要先将 userInteractionEnabled 置为 YES,这样才能响应单击事件
        */
        [imageView addGestureRecognizer:[[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(singleTapImageView:)]];
  • Swift

        // 设置 frame
        /*
            imageView.image.size.width, imageView.image.size.height 可获取 imageView image 中图片的尺寸
        */
        imageView.frame = CGRectMake(10, 30, UIScreen.mainScreen().bounds.size.width - 20, UIScreen.mainScreen().bounds.size.height - 40)
    
        // 设置图片填充方式
        /*
            当图片小于 imageView 的大小时,处理图片的显示方式
    
            // 缩放图片,使图片充满容器。图片未必保持长宽比例协调,有可能会拉伸至变形。默认
            case ScaleToFill
    
            // 在保持长宽比的前提下,缩放图片,使得图片在容器内完整显示出来
            case ScaleAspectFit
    
            // 在保持长宽比的前提下,缩放图片,使图片充满容器
            case ScaleAspectFill
    
            case Redraw
            case Center
            case Top
            case Bottom
            case Left
            case Right
            case TopLeft
            case TopRight
            case BottomLeft
            case BottomRight
         */
    
        imageView.contentMode = UIViewContentMode.ScaleToFill
    
        // 设置透明度
        imageView.alpha = 0.5
    
        // 设置 image
        /*
            图片名称为 nil 时,控制台会打印输出 CUICatalog: Invalid asset name supplied: (null)
        */
    
            // 正常状态时的图片
            imageView.image = UIImage(named: "18")
    
            // 高亮状态时的图片
            imageView.highlightedImage = UIImage(named: "17")
    
        // 设置是否隐藏
        imageView.hidden = true
    
        // 设置 imageView 的交互属性
        /*
            UIImageView 的交互属性默认是关闭的
        */
        imageView.userInteractionEnabled = true 
    
        // 为图片添加单击事件
        /*
            一定要先将 userInteractionEnabled 置为 YES,这样才能响应单击事件
        */
        imageView.addGestureRecognizer(UITapGestureRecognizer(target:self, action:#selector(UiImageView.singleTapImageView(_:))))

3、UIImageView 播放图片集

  • Objective-C

        // 创建图片集
        NSMutableArray *imageArray = [NSMutableArray arrayWithCapacity:0];
    
        for (int i = 0; i < 30; i++) {
            [imageArray addObject:[UIImage imageNamed:[NSString stringWithFormat:@"%d.jpg", i]]];
        }
    
        // 播放图片集
    
            // 设置播放的图片集(需将图片添加到数组 imageArray 中)
            imageView.animationImages = imageArray;
    
            // 设置播放整个图片集的时间
            imageView.animationDuration = 30;
    
            // 设置循环播放次数,默认为0 一直循环
            imageView.animationRepeatCount = 0;
    
            // 开始播放
            [imageView startAnimating];
    
            // 停止播放动画
            [imageView stopAnimating];
  • Swift

        // 创建图片集
        var imageArray:Array<UIImage> = Array()
    
        for i in 0 ..< 30 {
            imageArray.append(UIImage(named: String(format: "%d.jpg", i))!)
        }
    
        // 播放图片集
    
            // 设置播放的图片集(需将图片添加到数组 imageArray 中)
            imageView.animationImages = imageArray
    
            // 设置播放整个图片集的时间
            imageView.animationDuration = 30
    
            // 设置循环播放次数,默认为0 一直循环
            imageView.animationRepeatCount = 0
    
            // 开始播放
            imageView.startAnimating()
    
            // 停止播放动画
            imageView.stopAnimating()

4、UIImage 图片的处理

4.1 UIImage 图片的加载方式

  • Assets.xcassets

    • Assets.xcassets 在 App 打包后,以 Assets.car 文件的形式出现在 Bundle 中。其作用在于:
      • 自动识别 @2x,@3x 图片,对内容相同但分辨率不同的图片统一管理。
      • 可以对图片进行剪裁和拉伸处理。
  • 根据是否将创建好的对象缓存入系统内存,有两类创建 UIImage 对象的方法可选

    • 1、缓存:imageNamed:,只需传入文件名.扩展名(可选)即可。
      • 根据图片文件名在缓存池中查找特定的 UIImage 对象,若存在,将这个对象返回。如果不存在,则从 Bundle 中加载图片数据,创建对象并返回。如果相应的图片数据不存在,返回 nil。
    • 2、不缓存:imageWithContentsOfFile:,必须传入文件的全名(全路径+文件名)。
  • UIImage 从 Bundle 中加载图片资源

    • Assets.xcassets 中的图片资源只能通过 imageNamed: 方法加载,通过 NSBundle 的 pathForResource:ofType: 无法获得图片路径。因此,Assets.xcassets 只适合存放系统常用的,占用内存小的图片资源。
    • imageNamed: 方法同样可以加载根目录中的图片资源。
    • 要想利用 imageWithContentsOfFile: 方法以不缓存的形式加载图片,必须将图片资源放置在根目录中。
    • 相对于 jpg,iOS 对 png 的支持较好,如果从 Assets.xcassets 以外的地方加载 jpg 格式的图片,必须在文件名后加扩展名。

4.2 对图片进行缩放和翻转

  • Objective-C

        /*
            + (UIImage *)imageWithCGImage:(CGImageRef)cgImage 
                                    scale:(CGFloat)scale 
                              orientation:(UIImageOrientation)orientation;
    
            cgImage:       图片
            scale:         比例: < 1 放大, > 1 缩小
            orientation:   翻转方式
    
            UIImageOrientationUp,              // 不反转
            UIImageOrientationDown,            // 逆时针旋转 180 度
            UIImageOrientationLeft,            // 逆时针旋转 90 度,只垂直方向放大
            UIImageOrientationRight,           // 顺时针旋转 90 度,只垂直方向放大
            UIImageOrientationUpMirrored,      // 水平镜像反转
            UIImageOrientationDownMirrored,    // 垂直镜像反转
            UIImageOrientationLeftMirrored,    // 水平镜像反转,逆时针旋转 90 度,只垂直方向放大
            UIImageOrientationRightMirrored,   // 水平镜像反转,顺时针旋转 90 度,只垂直方向放大
        */
    
        image = [UIImage imageWithCGImage:image.CGImage scale:0.5 orientation:UIImageOrientationUpMirrored];
  • Swift

        /*
            public init(CGImage cgImage: CGImage, scale: CGFloat, orientation: UIImageOrientation)
    
            cgImage:       图片
            scale:         比例: < 1 放大, > 1 缩小
            orientation:   翻转方式
    
            case Up              // 不反转
            case Down            // 逆时针旋转 180 度
            case Left            // 逆时针旋转 90 度,只垂直方向放大
            case Right           // 顺时针旋转 90 度,只垂直方向放大
            case UpMirrored      // 水平镜像反转
            case DownMirrored    // 垂直镜像反转
            case LeftMirrored    // 水平镜像反转,逆时针旋转 90 度,只垂直方向放大
            case RightMirrored   // 水平镜像反转,顺时针旋转 90 度,只垂直方向放大
        */
    
        image = UIImage(CGImage: image.CGImage!, scale: 0.5, orientation: .UpMirrored)

4.3 设置图片渲染方式

  • Objective-C

        /*
            // Use the default rendering mode for the context where the image is used
            UIImageRenderingModeAutomatic,
    
            // Always draw the original image, without treating it as a template
            UIImageRenderingModeAlwaysOriginal,
    
            // Always draw the image as a template image, ignoring its color information
            UIImageRenderingModeAlwaysTemplate,
        */
    
        // 在有些可以添加图片的控件中,需要显示原图,否则图片将以阴影的方式显示
        image = [image imageWithRenderingMode:UIImageRenderingModeAlwaysOriginal];      
  • Swift

        /*
            // Use the default rendering mode for the context where the image is used
            case Automatic
    
            // Always draw the original image, without treating it as a template
            case AlwaysOriginal
    
            // Always draw the image as a template image, ignoring its color information
            case AlwaysTemplate
        */
    
        // 在有些可以添加图片的控件中,需要显示原图,否则图片将以阴影的方式显示
        image = image.imageWithRenderingMode(.AlwaysOriginal)

4.4 设置图片拉伸方式

  • 设置拉伸方式前后拉伸效果

    iOS - UIImageView
    iOS - UIImageView

  • 1、只拉伸中间的 1 * 1 的区域

    • Objective-C

          /*
              设置的区域为不拉伸(保护)的部分,自动计算右侧和下侧保护部分的大小:
      
                  rightCapWidth = width - leftCapWidth - 1
                  bottomCapHeight  = height - topCapHeight - 1
          */
      
          image = [image stretchableImageWithLeftCapWidth:image.size.width * 0.5 
                                             topCapHeight:image.size.height * 0.5];
    • Swift

          /*
              设置的区域为不拉伸(保护)的部分,自动计算右侧和下侧保护部分的大小:
      
                  rightCapWidth = width - leftCapWidth - 1
                  bottomCapHeight  = height - topCapHeight - 1
          */
      
          image = image.stretchableImageWithLeftCapWidth(NSInteger(image.size.width * 0.5), 
                                            topCapHeight: NSInteger(image.size.height * 0.5))
  • 2、拉伸指定的区域

    • Objective-C

          /*
              设置的区域为不拉伸(保护)的部分
      
              拉伸模式:
                  UIImageResizingModeTile         平铺,默认
                  UIImageResizingModeStretch      直接拉伸
          */
      
          // 以默认平铺模式拉伸
          image = [image resizableImageWithCapInsets:UIEdgeInsetsMake(30, 30, 30, 30)];
      
          // 以指定拉伸模式拉伸
          image = [image resizableImageWithCapInsets:UIEdgeInsetsMake(30, 30, 30, 30) 
                                        resizingMode:UIImageResizingModeStretch];
    • Swift

          /*
              设置的区域为不拉伸(保护)的部分
      
              拉伸模式:
                  Tile         平铺,默认
                  Stretch      直接拉伸
          */
      
          // 以默认平铺模式拉伸
          image = image.resizableImageWithCapInsets(UIEdgeInsetsMake(30, 30, 30, 30))
      
          // 以指定拉伸模式拉伸
          image = image.resizableImageWithCapInsets(UIEdgeInsetsMake(30, 30, 30, 30), 
                                       resizingMode:.Stretch)
  • 3、Xcode Assets.xcassets 中设置

    • 将图片添加到 Assets.xcassets 中

      iOS - UIImageView

    • 选中需要拉伸的图片

      iOS - UIImageView

    • 设置拉伸方向和拉伸模式及保护区域大小(会自动计算填充)

      iOS - UIImageView

    • 默认拉伸方向为 None 即不拉伸

      iOS - UIImageView

    • 默认拉伸模式为 Tiles 即平铺

      iOS - UIImageView

4.5 重绘图片大小

  • Objective-C

        // 添加 UIImage 的分类 ResizeUIImage
        @implementation UIImage (ResizeUIImage)
    
            - (UIImage *)resizeImageToSize:(CGSize)size {
    
                // change from UIGraphicsBeginImageContext(size) to suit scale > 1
                UIGraphicsBeginImageContextWithOptions(size, false, 0);
                [self drawInRect:CGRectMake(0, 0, size.width, size.height)];
                UIImage *newImage = UIGraphicsGetImageFromCurrentImageContext();
                UIGraphicsEndImageContext();
    
                return newImage;
            }
    
        @end
    
        // 重新设置图片的大小
        image = [image resizeImageToSize:CGSizeMake(100, 200)];                         
  • Swift

        // 扩展 UIImage 类
        extension UIImage {
    
            func resizeImageToSize(size: CGSize) -> UIImage {
    
                // change from UIGraphicsBeginImageContext(size) to suit scale > 1
                UIGraphicsBeginImageContextWithOptions(size, false, 0)
                self.drawInRect(CGRectMake(0, 0, size.width, size.height))
                let newImage = UIGraphicsGetImageFromCurrentImageContext()
                UIGraphicsEndImageContext()
    
                return newImage
            }
        }
    
        // 重新设置图片的大小
        image = image?.resizeImageToSize(CGSizeMake(100, 200))

4.6 保存图片到相册

  • 设置系统访问相册权限

    iOS - UIImageView

  • 保存图片到相册

        // 将图片存储到相册中
        UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
        // 将图片存储到相册中,完成后调用指定的方法
        UIImageWriteToSavedPhotosAlbum(image, self, @selector(image:didFinishSavingWithError:contextInfo:), nil);
    
        // 保存完成后调用的方法,必须为这个方法
        - (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo {
    
        }

5、UIImage 与 NSData 的相互转换

  • Objective-C

        // image 转 NSData
        NSData *data = UIImagePNGRepresentation(image1);
    
        // NSData 转 image
        UIImage *image = [UIImage imageWithData:data];
  • Swift

        // image 转 NSData
        let data:NSData = UIImagePNGRepresentation(image1!)!
    
        // NSData 转 image
        let image = UIImage(data: data)

6、UIImage 加载 GIF 动图

  • Gif 图片是非常常见的图片格式,尤其是在聊天的过程中,Gif 表情使用地很频繁。但是 iOS 没有现成的支持加载和播放 Gif 的类。

6.1 加载本地 GIF 动图

  • 1、使用 UIWebView 加载

    • 使用 UIWebView 的弊端在于,不能设置 Gif 动画的播放时间,不能自动缩放 Gif 动图。

          // 读取 GIF 图片数据
          NSData *data = [NSData dataWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"demo3" ofType:@"gif"]];
      
          // 加载 GIF 动图
          UIWebView *webView = [[UIWebView alloc] initWithFrame:CGRectMake(0, 0, self.view.bounds.size.width, 200)];
          [webView loadData:data MIMEType:@"image/gif" textEncodingName:@"" baseURL:[NSURL URLWithString:@""]];
      
          [self.view addSubview:webView];
  • 2、将 Gif 动图拆分成多张图片,使用 UIImageView 播放

    • 最好把所需要的 Gif 图片打包到 Bundle 文件内。下拉、上拉加载控件需要一个根据拉动距离设置特定的 Image,一般使用该方法。

          - (NSArray *)animationImages {
      
              NSFileManager *fielM = [NSFileManager defaultManager];
              NSString *path = [[NSBundle mainBundle] pathForResource:@"Loading" ofType:@"bundle"];
              NSArray *arrays = [fielM contentsOfDirectoryAtPath:path error:nil];
      
              NSMutableArray *imagesArr = [NSMutableArray array];
              for (NSString *name in arrays) {
                  UIImage *image = [UIImage imageNamed:[(@"Loading.bundle") stringByAppendingPathComponent:name]];
                  if (image) {
                      [imagesArr addObject:image];
                  }
              }
              return imagesArr;
          }
      
          - (void)viewDidLoad {
              [super viewDidLoad];
      
              UIImageView *gifImageView = [[UIImageView alloc] initWithFrame:frame];
              gifImageView.animationImages = [self animationImages]; // 获取 Gif 图片列表
              gifImageView.animationDuration = 5;                    // 执行一次完整动画所需的时长
              gifImageView.animationRepeatCount = 1;                 // 动画重复次数
              [gifImageView startAnimating];
              [self.view addSubview:gifImageView];
          }
  • 3、使用 SDWebImage 加载

    • 在 SDWebImage 这个库里有一个 UIImage+GIF 的类别,里面为 UIImage 扩展了三个方法。

          @interface UIImage (GIF)
          + (IImage *)sd_animatedGIFNamed:(NSString *)name;
          + (UIImage *)sd_animatedGIFWithData:(NSData *)data;
          - (UIImage *)sd_animatedImageByScalingAndCroppingToSize:(CGSize)size;
          @end
    • 我们要获取处理后的 Gif 图片,其实只要调用前面两个中的其中一个方法就行了,注意,第一个只需要传 Gif 的名字,而不需要带扩展名(如 Gif 图片名字为 001@2x.gif,只需传 001 即可)。

    • 我们就使用第二个方法试一试效果:

          NSString *path = [[NSBundle mainBundle] pathForResource:@"gifTest" ofType:@"gif"];
          NSData *data = [NSData dataWithContentsOfFile:path];
          UIImage *image = [UIImage sd_animatedGIFWithData:data];
          gifImageView.image = image;
    • 然后通过断点,我们看下获取到的 image 是个什么样的

      iOS - UIImageView

    • 我们发现 image 的 isa 指针指向了 _UIAnimatedImage,说明它是一个叫作 _UIAnimatedImage 的类(当然,这个 _UIAnimatedImage 苹果是不会直接让我们使用的)。_images 表示这个 Gif 包含了多少张图片。_duration 表示执行一次完整动画所需的时长。

    • 其实,动画执续时间 _duration 也可以更改。

          + (UIImage *)sd_animatedGIFWithData:(NSData *)data {
              if (!data) {
                  return nil;
              }
      
              CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, NULL);
      
              size_t count = CGImageSourceGetCount(source);
      
              UIImage *animatedImage;
      
              if (count <= 1) {
                  animatedImage = [[UIImage alloc] initWithData:data];
              }
              else {
                  NSMutableArray *images = [NSMutableArray array];
      
                  NSTimeInterval duration = 0.0f;
      
                  for (size_t i = 0; i < count; i++) {
                      CGImageRef image = CGImageSourceCreateImageAtIndex(source, i, NULL);
      
                      duration += [self sd_frameDurationAtIndex:i source:source];
      
                      [images addObject:[UIImage imageWithCGImage:image scale:[UIScreen mainScreen].scale orientation:UIImageOrientationUp]];
      
                      CGImageRelease(image);
                  }
      
                  if (!duration) {
                      duration = (1.0f / 10.0f) * count;
                  }
      
                  animatedImage = [UIImage animatedImageWithImages:images duration:duration];
              }
      
              CFRelease(source);
      
              return animatedImage;
          }
      • 很明显,duration 是可以随意更改的,只不过此方法设置了一个默认值(duration = (1.0f / 10.0f) * count)
    • 归根到底,创建新的动态的 Image 其实是调用了系统提供的一个 UIImage 的类方法而已。直接显示 Gif 图片,一般使用该方法。

          UIImage *animatedImage = [UIImage animatedImageWithImages:images duration:duration];
  • 4、使用 QExtension 加载

    • 使用第三方框架 QExtension

    • Objective-C

          // 通过名称加载 gif 图片,不需要写扩展名
          self.imageView.image = [UIImage q_gifImageNamed:@"demo3"];
      
          // 通过数据加载 gif 图片
          NSData *imageData = [NSData dataWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"demo3" ofType:@"gif"]];
          self.imageView.image = [UIImage q_gifImageWithData:imageData];
    • 效果

      iOS - UIImageView

6.2 加载网络 GIF 动图

  • 1、使用 SDWebImage 加载

    • 加载网络的 Gif 文件就简单多了。最简单的方法,我们只需要使用 SDWebImage 的 sd_setImageWithURL: 这个方法传入 Gif 文件是 url 地址即可。

          NSURL *url = [NSURL URLWithString:@"http://images.cnblogs.com/cnblogs_com/QianChia/934664/o_QExtension31.gif"];
      
          [self.imageView sd_setImageWithURL:url];
    • SDWebImage 内部实现大概是以下几个步骤:
      • 1、SDWebImage 根据 url 将 Gif 文件下载下来,格式为一个 NSData。
      • 2、如果判断是 Gif 格式,则会调用 sd_animatedGIFWithData: 将 Data 转换成我们需要的 Gif 格式。
      • 3、通过上面的方法二即可显示出 Gif 图片。
          UIImage *image = [UIImage sd_animatedGIFWithData:data];
      
          gifImageView.image = image;
上一篇:iOS - UIActionSheet


下一篇:iOS - UIScrollView