//
|
// TZImagePickerController.h
|
// TZImagePickerController
|
//
|
// Created by 谭真 on 15/12/24.
|
// Copyright © 2015年 谭真. All rights reserved.
|
// version 1.7.8 - 2016.12.20
|
|
/*
|
经过测试，比起xib的方式，把TZAssetCell改用纯代码的方式来写，滑动帧数明显提高了（约提高10帧左右）
|
|
最初发现这个问题并修复的是@小鱼周凌宇同学，她的博客地址: http://zhoulingyu.com/
|
表示感谢~
|
|
原来xib确实会导致性能问题啊...大家也要注意了...
|
*/
|
|
#import <UIKit/UIKit.h>
|
#import "TZAssetModel.h"
|
#import "NSBundle+TZImagePicker.h"
|
|
#define iOS7Later ([UIDevice currentDevice].systemVersion.floatValue >= 7.0f)
|
#define iOS8Later ([UIDevice currentDevice].systemVersion.floatValue >= 8.0f)
|
#define iOS9Later ([UIDevice currentDevice].systemVersion.floatValue >= 9.0f)
|
#define iOS9_1Later ([UIDevice currentDevice].systemVersion.floatValue >= 9.1f)
|
|
@protocol TZImagePickerControllerDelegate;
|
@interface TZImagePickerController : UINavigationController
|
|
/// Use this init method / 用这个初始化方法
|
- (instancetype)initWithMaxImagesCount:(NSInteger)maxImagesCount delegate:(id<TZImagePickerControllerDelegate>)delegate;
|
- (instancetype)initWithMaxImagesCount:(NSInteger)maxImagesCount columnNumber:(NSInteger)columnNumber delegate:(id<TZImagePickerControllerDelegate>)delegate;
|
- (instancetype)initWithMaxImagesCount:(NSInteger)maxImagesCount columnNumber:(NSInteger)columnNumber delegate:(id<TZImagePickerControllerDelegate>)delegate pushPhotoPickerVc:(BOOL)pushPhotoPickerVc;
|
/// This init method just for previewing photos / 用这个初始化方法以预览图片
|
- (instancetype)initWithSelectedAssets:(NSMutableArray *)selectedAssets selectedPhotos:(NSMutableArray *)selectedPhotos index:(NSInteger)index;
|
/// This init method for crop photo / 用这个初始化方法以裁剪图片
|
- (instancetype)initCropTypeWithAsset:(id)asset photo:(UIImage *)photo completion:(void (^)(UIImage *cropImage,id asset))completion;
|
|
/// Default is 9 / 默认最大可选9张图片
|
@property (nonatomic, assign) NSInteger maxImagesCount;
|
|
/// The minimum count photos user must pick, Default is 0
|
/// 最小照片必选张数,默认是0
|
@property (nonatomic, assign) NSInteger minImagesCount;
|
|
/// Always enale the done button, not require minimum 1 photo be picked
|
/// 让完成按钮一直可以点击，无须最少选择一张图片
|
@property (nonatomic, assign) BOOL alwaysEnableDoneBtn;
|
|
/// Sort photos ascending by modificationDate，Default is YES
|
/// 对照片排序，按修改时间升序，默认是YES。如果设置为NO,最新的照片会显示在最前面，内部的拍照按钮会排在第一个
|
@property (nonatomic, assign) BOOL sortAscendingByModificationDate;
|
|
/// Default is 828px / 默认828像素宽
|
@property (nonatomic, assign) CGFloat photoWidth;
|
|
/// Default is 600px / 默认600像素宽
|
@property (nonatomic, assign) CGFloat photoPreviewMaxWidth;
|
|
/// Default is 15, While fetching photo, HUD will dismiss automatic if timeout;
|
/// 超时时间，默认为15秒，当取图片时间超过15秒还没有取成功时，会自动dismiss HUD；
|
@property (nonatomic, assign) NSInteger timeout;
|
|
/// Default is YES, if set NO, the original photo button will hide. user can't picking original photo.
|
/// 默认为YES，如果设置为NO,原图按钮将隐藏，用户不能选择发送原图
|
@property (nonatomic, assign) BOOL allowPickingOriginalPhoto;
|
|
/// Default is YES, if set NO, user can't picking video.
|
/// 默认为YES，如果设置为NO,用户将不能选择视频
|
@property (nonatomic, assign) BOOL allowPickingVideo;
|
|
/// Default is NO, if set YES, user can picking gif image.
|
/// 默认为NO，如果设置为YES,用户可以选择gif图片
|
@property (nonatomic, assign) BOOL allowPickingGif;
|
|
/// Default is YES, if set NO, user can't picking image.
|
/// 默认为YES，如果设置为NO,用户将不能选择发送图片
|
@property(nonatomic, assign) BOOL allowPickingImage;
|
|
/// Default is YES, if set NO, user can't take picture.
|
/// 默认为YES，如果设置为NO,拍照按钮将隐藏,用户将不能选择照片
|
@property(nonatomic, assign) BOOL allowTakePicture;
|
|
/// Default is YES, if set NO, user can't preview photo.
|
/// 默认为YES，如果设置为NO,预览按钮将隐藏,用户将不能去预览照片
|
@property (nonatomic, assign) BOOL allowPreview;
|
|
/// Default is YES, if set NO, the picker don't dismiss itself.
|
/// 默认为YES，如果设置为NO, 选择器将不会自己dismiss
|
@property(nonatomic, assign) BOOL autoDismiss;
|
|
/// The photos user have selected
|
/// 用户选中过的图片数组
|
@property (nonatomic, strong) NSMutableArray *selectedAssets;
|
@property (nonatomic, strong) NSMutableArray<TZAssetModel *> *selectedModels;
|
|
/// Minimum selectable photo width, Default is 0
|
/// 最小可选中的图片宽度，默认是0，小于这个宽度的图片不可选中
|
@property (nonatomic, assign) NSInteger minPhotoWidthSelectable;
|
@property (nonatomic, assign) NSInteger minPhotoHeightSelectable;
|
/// Hide the photo what can not be selected, Default is NO
|
/// 隐藏不可以选中的图片，默认是NO，不推荐将其设置为YES
|
@property (nonatomic, assign) BOOL hideWhenCanNotSelect;
|
|
/// Single selection mode, valid when maxImagesCount = 1
|
/// 单选模式,maxImagesCount为1时才生效
|
@property (nonatomic, assign) BOOL showSelectBtn; ///< 在单选模式下，照片列表页中，显示选择按钮,默认为NO
|
@property (nonatomic, assign) BOOL allowCrop; ///< 允许裁剪,默认为YES，showSelectBtn为NO才生效
|
@property (nonatomic, assign) CGRect cropRect; ///< 裁剪框的尺寸
|
@property (nonatomic, assign) BOOL needCircleCrop; ///< 需要圆形裁剪框
|
@property (nonatomic, assign) NSInteger circleCropRadius; ///< 圆形裁剪框半径大小
|
@property (nonatomic, copy) void (^cropViewSettingBlock)(UIView *cropView); ///< 自定义裁剪框的其他属性
|
|
- (void)showAlertWithTitle:(NSString *)title;
|
- (void)showProgressHUD;
|
- (void)hideProgressHUD;
|
@property (nonatomic, assign) BOOL isSelectOriginalPhoto;
|
|
@property (nonatomic, copy) NSString *takePictureImageName;
|
@property (nonatomic, copy) NSString *photoSelImageName;
|
@property (nonatomic, copy) NSString *photoDefImageName;
|
@property (nonatomic, copy) NSString *photoOriginSelImageName;
|
@property (nonatomic, copy) NSString *photoOriginDefImageName;
|
@property (nonatomic, copy) NSString *photoPreviewOriginDefImageName;
|
@property (nonatomic, copy) NSString *photoNumberIconImageName;
|
|
/// Appearance / 外观颜色 + 按钮文字
|
@property (nonatomic, strong) UIColor *oKButtonTitleColorNormal;
|
@property (nonatomic, strong) UIColor *oKButtonTitleColorDisabled;
|
@property (nonatomic, strong) UIColor *naviBgColor;
|
@property (nonatomic, strong) UIColor *naviTitleColor;
|
@property (nonatomic, strong) UIFont *naviTitleFont;
|
@property (nonatomic, strong) UIColor *barItemTextColor;
|
@property (nonatomic, strong) UIFont *barItemTextFont;
|
|
@property (nonatomic, copy) NSString *doneBtnTitleStr;
|
@property (nonatomic, copy) NSString *cancelBtnTitleStr;
|
@property (nonatomic, copy) NSString *previewBtnTitleStr;
|
@property (nonatomic, copy) NSString *fullImageBtnTitleStr;
|
@property (nonatomic, copy) NSString *settingBtnTitleStr;
|
@property (nonatomic, copy) NSString *processHintStr;
|
|
/// Public Method
|
- (void)cancelButtonClick;
|
|
// The picker should dismiss itself; when it dismissed these handle will be called.
|
// You can also set autoDismiss to NO, then the picker don't dismiss itself.
|
// If isOriginalPhoto is YES, user picked the original photo.
|
// You can get original photo with asset, by the method [[TZImageManager manager] getOriginalPhotoWithAsset:completion:].
|
// The UIImage Object in photos default width is 828px, you can set it by photoWidth property.
|
// 这个照片选择器会自己dismiss，当选择器dismiss的时候，会执行下面的handle
|
// 你也可以设置autoDismiss属性为NO，选择器就不会自己dismis了
|
// 如果isSelectOriginalPhoto为YES，表明用户选择了原图
|
// 你可以通过一个asset获得原图，通过这个方法：[[TZImageManager manager] getOriginalPhotoWithAsset:completion:]
|
// photos数组里的UIImage对象，默认是828像素宽，你可以通过设置photoWidth属性的值来改变它
|
@property (nonatomic, copy) void (^didFinishPickingPhotosHandle)(NSArray<UIImage *> *photos,NSArray *assets,BOOL isSelectOriginalPhoto);
|
@property (nonatomic, copy) void (^didFinishPickingPhotosWithInfosHandle)(NSArray<UIImage *> *photos,NSArray *assets,BOOL isSelectOriginalPhoto,NSArray<NSDictionary *> *infos);
|
@property (nonatomic, copy) void (^imagePickerControllerDidCancelHandle)();
|
|
// If user picking a video, this handle will be called.
|
// If system version > iOS8,asset is kind of PHAsset class, else is ALAsset class.
|
// 如果用户选择了一个视频，下面的handle会被执行
|
// 如果系统版本大于iOS8，asset是PHAsset类的对象，否则是ALAsset类的对象
|
@property (nonatomic, copy) void (^didFinishPickingVideoHandle)(UIImage *coverImage,id asset);
|
|
// If user picking a gif image, this callback will be called.
|
// 如果用户选择了一个gif图片，下面的handle会被执行
|
@property (nonatomic, copy) void (^didFinishPickingGifImageHandle)(UIImage *animatedImage,id sourceAssets);
|
|
@property (nonatomic, weak) id<TZImagePickerControllerDelegate> pickerDelegate;
|
|
@end
|
|
|
@protocol TZImagePickerControllerDelegate <NSObject>
|
@optional
|
// The picker should dismiss itself; when it dismissed these handle will be called.
|
// You can also set autoDismiss to NO, then the picker don't dismiss itself.
|
// If isOriginalPhoto is YES, user picked the original photo.
|
// You can get original photo with asset, by the method [[TZImageManager manager] getOriginalPhotoWithAsset:completion:].
|
// The UIImage Object in photos default width is 828px, you can set it by photoWidth property.
|
// 这个照片选择器会自己dismiss，当选择器dismiss的时候，会执行下面的handle
|
// 你也可以设置autoDismiss属性为NO，选择器就不会自己dismis了
|
// 如果isSelectOriginalPhoto为YES，表明用户选择了原图
|
// 你可以通过一个asset获得原图，通过这个方法：[[TZImageManager manager] getOriginalPhotoWithAsset:completion:]
|
// photos数组里的UIImage对象，默认是828像素宽，你可以通过设置photoWidth属性的值来改变它
|
- (void)imagePickerController:(TZImagePickerController *)picker didFinishPickingPhotos:(NSArray<UIImage *> *)photos sourceAssets:(NSArray *)assets isSelectOriginalPhoto:(BOOL)isSelectOriginalPhoto;
|
- (void)imagePickerController:(TZImagePickerController *)picker didFinishPickingPhotos:(NSArray<UIImage *> *)photos sourceAssets:(NSArray *)assets isSelectOriginalPhoto:(BOOL)isSelectOriginalPhoto infos:(NSArray<NSDictionary *> *)infos;
|
- (void)imagePickerControllerDidCancel:(TZImagePickerController *)picker __attribute__((deprecated("Use -tz_imagePickerControllerDidCancel:.")));
|
- (void)tz_imagePickerControllerDidCancel:(TZImagePickerController *)picker;
|
|
// If user picking a video, this callback will be called.
|
// If system version > iOS8,asset is kind of PHAsset class, else is ALAsset class.
|
// 如果用户选择了一个视频，下面的handle会被执行
|
// 如果系统版本大于iOS8，asset是PHAsset类的对象，否则是ALAsset类的对象
|
- (void)imagePickerController:(TZImagePickerController *)picker didFinishPickingVideo:(UIImage *)coverImage sourceAssets:(id)asset;
|
|
// If user picking a gif image, this callback will be called.
|
// 如果用户选择了一个gif图片，下面的handle会被执行
|
- (void)imagePickerController:(TZImagePickerController *)picker didFinishPickingGifImage:(UIImage *)animatedImage sourceAssets:(id)asset;
|
@end
|
|
|
@interface TZAlbumPickerController : UIViewController
|
@property (nonatomic, assign) NSInteger columnNumber;
|
@end
|
|
|
@interface UIImage (MyBundle)
|
|
+ (UIImage *)imageNamedFromMyBundle:(NSString *)name;
|
|
@end
|
