KSYGPUPicPlayer Class Reference

Inherits from GPUImageOutput
Declared in KSYGPUPicPlayer.h

Overview

图片播放器

提供图片播放的功能,支持自定义总时长、输出图像大小

– initWithImage:parameters:

初始化KSYGPUPicPlayer

- (id)initWithImage:(UIImage *)imageSource parameters:(NSDictionary *)parameters

Parameters

imageSource

图像

parameters

播放参数

@discussion

  • 播放参数说明

@{ @“fps”:@(25), // 每秒帧率,默认值为25 @“duration”:@(4), // 播放总时长,默认为4s @“outputSize”:@(540*960), //输出图像的分辨率(CGSize),默认为540p

Declared In

KSYGPUPicPlayer.h

– setCropRegion:toRect:

设置裁剪区域的起始和结束位置

- (void)setCropRegion:(CGRect)fromRegion toRect:(CGRect)toRegion

Discussion

要求输入相对位置, 即CGRect中所有值均在[0.0, 1.0]之间

如果出现非法值,则设置无效

默认的结束裁剪区域是按outputSize比例对全图片进行的裁剪

默认的起始裁剪区域大小是结束区域大小的一半

Declared In

KSYGPUPicPlayer.h

– play

开始播放图片

- (void)play

Discussion

在Idle或者Pause状态下调用,进入play状态

Declared In

KSYGPUPicPlayer.h

– pause

暂停播放图片

- (void)pause

Discussion

在Play状态下调用,进入pause状态

Declared In

KSYGPUPicPlayer.h

– seekTo:

seek到指定时间

- (BOOL)seekTo:(float)time

Parameters

time

时间

Discussion

如果在pause状态下调用,则seek完成后依然为pause状态,需调用play方法恢复播放状态

如果在play状态下调用,则seek完成后依然play状态

在Idle或finished状态下调用,则从time处开始播放

Declared In

KSYGPUPicPlayer.h

– stop

停止播放图片

- (void)stop

Discussion

非Idle状态下调用,进入Idle状态

Declared In

KSYGPUPicPlayer.h

– processImageWithCompletionHandler:

驱动下一帧的输出

- (BOOL)processImageWithCompletionHandler:(void ( ^ ) ( BOOL bEnd ))completion

Parameters

completion

当前图片帧处理完成的回调

Discussion

bEnd 如果completion中的回调参数为YES,表示已经处理到frame最后一帧

Declared In

KSYGPUPicPlayer.h

  duration

当前图片播放的总时长,单位是秒

@property (nonatomic, readonly) float duration

Discussion

与initWithImage方法中设置的duration相同,默认值为4秒

Declared In

KSYGPUPicPlayer.h

  fps

图片播放的帧率

@property (nonatomic, readonly) float fps

Discussion

与initWithImage方法中设置的fps相同,默认值为25

Declared In

KSYGPUPicPlayer.h

  outputSize

输出图像的大小

@property (nonatomic, readonly) CGSize outputSize

Discussion

与initWithImage方法中设置的outputSize相同,默认值为(540, 960)

Declared In

KSYGPUPicPlayer.h

  position

当前播放时间,单位是秒

@property (nonatomic, readonly) float position

Declared In

KSYGPUPicPlayer.h

  progress

当前处理进度

@property (nonatomic, readonly) float progress

Declared In

KSYGPUPicPlayer.h

  state

播放器当前状态

@property (nonatomic, readonly) KSYGPUPicPlayerState state

Declared In

KSYGPUPicPlayer.h

  stateChangeBlock

播放状态发生变化时的回调

@property (nonatomic, copy) void ( ^ ) ( KSYGPUPicPlayerState preState , KSYGPUPicPlayerState newState ) stateChangeBlock

Discussion

preState 变化前的状态

newState 变化后的状态

Declared In

KSYGPUPicPlayer.h