iOS:图像选取器控制器控件UIImagePickerController的详解

图像选择控制器:UIImagePickerController

功能:用于选取相册或相机等里面的照片。

@interface UIImagePickerController : UINavigationController

枚举:

//图片资源来源类型

typedef NS_ENUM(NSInteger, UIImagePickerControllerSourceType) {

    UIImagePickerControllerSourceTypePhotoLibrary,          //图库

    UIImagePickerControllerSourceTypeCamera,                 //相机

    UIImagePickerControllerSourceTypeSavedPhotosAlbum   //相册

};

 

//摄像图像的质量

typedef NS_ENUM(NSInteger, UIImagePickerControllerQualityType) {

    UIImagePickerControllerQualityTypeHigh = 0,          // 高质量

    UIImagePickerControllerQualityTypeMedium = 1,      //中等质量,适合通过Wi-Fi传输

    UIImagePickerControllerQualityTypeLow = 2,           // 最低的质量,适合通过蜂窝网络传输

 

    UIImagePickerControllerQualityType640x480 = 3,             // VGA质量,640*480分辨率

    UIImagePickerControllerQualityTypeIFrame1280x720 = 4,  // VGA质量1280*720分辨率

    UIImagePickerControllerQualityTypeIFrame960x540 = 5    // VGA质量,960*540分辨率

 

};

 

//相机摄像模式

typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraCaptureMode) {

    UIImagePickerControllerCameraCaptureModePhoto,  //图片

    UIImagePickerControllerCameraCaptureModeVideo   //录像

};

 

//摄像头位置

typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraDevice) {

    UIImagePickerControllerCameraDeviceRear,          //后摄像头

    UIImagePickerControllerCameraDeviceFront          //前摄像头

};

 

//闪光灯状态模式

typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraFlashMode) {

    UIImagePickerControllerCameraFlashModeOff  = -1,   //关闭状态

    UIImagePickerControllerCameraFlashModeAuto = 0,   //自动调节状态

    UIImagePickerControllerCameraFlashModeOn   = 1    //开启状态

 

};

 

图片信息中字典的键:

UIKIT_EXTERN NSString *const UIImagePickerControllerMediaType;       //用户自定义的媒体类型 

UIKIT_EXTERN NSString *const UIImagePickerControllerOriginalImage;   // 原始的图片

UIKIT_EXTERN NSString *const UIImagePickerControllerEditedImage;     // 编辑后的图片 

UIKIT_EXTERN NSString *const UIImagePickerControllerCropRect;        // 裁剪尺寸

UIKIT_EXTERN NSString *const UIImagePickerControllerMediaURL;        // 媒体URL

UIKIT_EXTERN NSString *const UIImagePickerControllerReferenceURL;  // 原件URL

UIKIT_EXTERN NSString *const UIImagePickerControllerMediaMetadata  // 仅有效于拍摄图片时

 

 

属性:

//图像选取代理

@property(nonatomic,assign)  id <UINavigationControllerDelegate, UIImagePickerControllerDelegate> delegate;

//图片资源来源类型,默认来自图库

@property(nonatomic)UIImagePickerControllerSourceType     sourceType;                                                       

//媒体类型数组

@property(nonatomic,copy)NSArray  *mediaTypes; 

//是否允许编辑图像,默认为NO

@property(nonatomic) BOOL   allowsEditing ;   

@property(nonatomic)  BOOL    allowsImageEditing ;

 //录像最大时长,默认为10分钟

@property(nonatomic)  NSTimeInterval   videoMaximumDuration; 

//录像质量

@property(nonatomic)  UIImagePickerControllerQualityType  videoQuality ;

//是否显示相机控制界面,默认显示

@property(nonatomic) BOOL  showsCameraControls ;   

//设置视图覆盖预览视图

@property(nonatomic,retain)    UIView    *cameraOverlayView  ;  

//相机视图仿射类型

@property(nonatomic) CGAffineTransform   cameraViewTransform ;  

//相机摄像模式,默认为拍摄图片

@property(nonatomic) UIImagePickerControllerCameraCaptureMode cameraCaptureMode ;

//摄像头选取,默认为后摄像头

@property(nonatomic) UIImagePickerControllerCameraDevice cameraDevice ; 

//闪光灯状态模式

@property(nonatomic) UIImagePickerControllerCameraFlashMode   cameraFlashMode;   

 

方法:

//资源来源类型是否可用

+ (BOOL)isSourceTypeAvailable:(UIImagePickerControllerSourceType)sourceType;     

//返回资源来源类型中可用的媒体类型数组         

+ (NSArray *)availableMediaTypesForSourceType:(UIImagePickerControllerSourceType)sourceType; 

//摄像头是否可用

+ (BOOL)isCameraDeviceAvailable:(UIImagePickerControllerCameraDevice)cameraDevice                   ; 

//闪光灯是否可用

+ (BOOL)isFlashAvailableForCameraDevice:(UIImagePickerControllerCameraDevice)cameraDevice ; 

//返回可用的相机模式数组

+ (NSArray *)availableCaptureModesForCameraDevice (UIImagePickerControllerCameraDevice)

cameraDevice;  

//照相

- (void)takePicture;                                                   

//开始录频

- (BOOL)startVideoCapture ;

//停止录频

- (void)stopVideoCapture ;

 

代理:

@protocol UIImagePickerControllerDelegate<NSObject>

@optional

//选取编辑过的图片

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingImage:(UIImage *)image editingInfo:(NSDictionary *)editingInfo ;

//选取原始图片

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info;

//取消选取

- (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker;

@end

 

保存相关的函数:

// 保存图片到被保存的相册中

UIKIT_EXTERN void UIImageWriteToSavedPhotosAlbum(UIImage *image, id completionTarget, SEL completionSelector, void *contextInfo);

// - (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo;

 

// 保存指定路径的录频到被保存的相册中

UIKIT_EXTERN BOOL UIVideoAtPathIsCompatibleWithSavedPhotosAlbum(NSString *videoPath) ;

 

// 保存录频到被保存的相册中

UIKIT_EXTERN void UISaveVideoAtPathToSavedPhotosAlbum(NSString *videoPath, id completionTarget, SEL completionSelector, void *contextInfo);

//- (void)video:(NSString *)videoPath didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo;

 

下面来举一个实例如下:从本地相册读取显示图片

1、设置故事板,往故事板的视图中拖入两个控件,一个是UIImageView,另一个是UIButton,分别命名为imageView、“相册”。

 

2、将imageView关联IBOutLet到控制器类中作为属性,给"相册"按钮关联IBAction事件,用来显示功能。还要让类实现图像选取器控制器协议和导航控制器协议

 

3、现在就是显示功能的实现和协议方法的实现了。

//按钮事件,打开相册(以模态窗口的形式显示相册)

- (IBAction)buttonClicked:(UIButton *)sender
{
    //创建图片选取控制器
    UIImagePickerController *imagePicker = [[UIImagePickerController alloc]init];

//图片资源来自相册
imagePicker.sourceType
= UIImagePickerControllerSourceTypeSavedPhotosAlbum;

//设置选取代理 imagePicker.
delegate = self; //使用模态窗口显示相册 [self presentViewController:imagePicker animated:YES completion:nil]; } - (void)viewDidLoad { [super viewDidLoad]; }

//实现协议方法,选取相册中的相片:

#pragma mark -<UIImagePickercontrollerDelegate>

-(void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info
{
    //NSLog(@"%@",info);
/*info:这个字典中放着图片的具体信息,通过这个字典的键可以获取图片*/
//取出图片 self.image = [info objectForKey:UIImagePickerControllerOriginalImage];//显示图片在图像视图中 [self.imageView setImage:self.image]; //关闭模态窗口 [picker dismissViewControllerAnimated:YES completion:nil]; }

4、演示结果:

开始运行截图:                                                    显示的本地相册截图:

   

选取某一图片截图:                                              点击"相册"返回,再选取某一图片截图:

    

 

 

posted @ 2015-10-11 21:18  XYQ全哥  阅读(1071)  评论(0编辑  收藏  举报