YYImage特性

• 支持以下類型動(dòng)畫圖像的播放/編碼/解碼:
  WebP, APNG, GIF闽颇。
• 支持以下類型靜態(tài)圖像的顯示/編碼/解碼:
  WebP, PNG, GIF, JPEG, JP2, TIFF, BMP, ICO, ICNS券犁。
• 支持以下類型圖片的漸進(jìn)式/逐行掃描/隔行掃描解碼:
  PNG, GIF, JPEG, BMP。
• 支持多張圖片構(gòu)成的幀動(dòng)畫播放络断，支持單張圖片的 sprite sheet 動(dòng)畫裁替。
• 完全兼容 UIImage 和 UIImageView，使用方便貌笨。
• 保留可擴(kuò)展的接口弱判，以支持自定義動(dòng)畫。
• 高效的動(dòng)態(tài)內(nèi)存緩存管理躁绸，以保證高性能低內(nèi)存的動(dòng)畫播放裕循。

用法

顯示動(dòng)畫類型的圖片

// 文件: mygif@3x.gif
UIImage *image = [YYImage imageNamed:@"mygif.gif"];
UIImageView *imageView = [[YYAnimatedImageView alloc] initWithImage:image];
[self.view addSubView:imageView];

播放幀動(dòng)畫

// 文件: frame1.png, frame2.png, frame3.png
NSArray *paths = @[@"/ani/frame1.png", @"/ani/frame2.png", @"/ani/frame3.png"];
NSArray *times = @[@0.1, @0.2, @0.1];
UIImage *image = [YYFrameImage alloc] initWithImagePaths:paths frameDurations:times repeats:YES];
UIImageView *imageView = [YYAnimatedImageView alloc] initWithImage:image];
[self.view addSubView:imageView];

播放sprite sheet動(dòng)畫

// 8 * 12 sprites in a single sheet image
UIImage *spriteSheet = [UIImage imageNamed:@"sprite-sheet"];
NSMutableArray *contentRects = [NSMutableArray new];
NSMutableArray *durations = [NSMutableArray new];
for (int j = 0; j < 12; j++) {
   for (int i = 0; i < 8; i++) {
       CGRect rect;
       rect.size = CGSizeMake(img.size.width / 8, img.size.height / 12);
       rect.origin.x = img.size.width / 8 * i;
       rect.origin.y = img.size.height / 12 * j;
       [contentRects addObject:[NSValue valueWithCGRect:rect]];
       [durations addObject:@(1 / 60.0)];
   }
}
YYSpriteSheetImage *sprite;
sprite = [[YYSpriteSheetImage alloc] initWithSpriteSheetImage:img
                                                contentRects:contentRects
                                              frameDurations:durations
                                                   loopCount:0];
YYAnimatedImageView *imageView = [YYAnimatedImageView new];
imageView.size = CGSizeMake(img.size.width / 8, img.size.height / 12);
imageView.image = sprite;
[self.view addSubView:imageView];

動(dòng)畫播放控制

YYAnimatedImageView *imageView = ...;
// 暫停:
[imageView stopAnimating];
// 播放:
[imageView startAnimating];
// 設(shè)置播放進(jìn)度:
imageView.currentAnimatedImageIndex = 12;
// 獲取播放狀態(tài):
image.currentIsPlayingAnimation;
//上面兩個(gè)屬性都支持 KVO臣嚣。

圖片解碼

// 解碼單幀圖片:
NSData *data = [NSData dataWithContentOfFile:@"/tmp/image.webp"];
YYImageDecoder *decoder = [YYImageDecoder decoderWithData:data scale:2.0];
UIImage image = [decoder frameAtIndex:0 decodeForDisplay:YES].image;

// 漸進(jìn)式圖片解碼 (可用于圖片下載顯示):
NSMutableData *data = [NSMutableData new];
YYImageDecoder *decoder = [[YYImageDecoder alloc] initWithScale:2.0];
while(newDataArrived) {
   [data appendData:newData];
   [decoder updateData:data final:NO];
   if (decoder.frameCount > 0) {
       UIImage image = [decoder frameAtIndex:0 decodeForDisplay:YES].image;
       // progressive display...
   }
}
[decoder updateData:data final:YES];
UIImage image = [decoder frameAtIndex:0 decodeForDisplay:YES].image;
// final display...

圖片編碼

// 編碼靜態(tài)圖 (支持各種常見(jiàn)圖片格式):
YYImageEncoder *jpegEncoder = [[YYImageEncoder alloc] initWithType:YYImageTypeJPEG];
jpegEncoder.quality = 0.9;
[jpegEncoder addImage:image duration:0];
NSData jpegData = [jpegEncoder encode];

// 編碼動(dòng)態(tài)圖 (支持 GIF/APNG/WebP):
YYImageEncoder *webpEncoder = [[YYImageEncoder alloc] initWithType:YYImageTypeWebP];
webpEncoder.loopCount = 5;
[webpEncoder addImage:image0 duration:0.1];
[webpEncoder addImage:image1 duration:0.15];
[webpEncoder addImage:image2 duration:0.2];
NSData webpData = [webpEncoder encode];

圖片類型檢測(cè)

// 獲取圖片類型
YYImageType type = YYImageDetectType(data); 
if (type == YYImageTypePNG) ...