OC之设置视频opacity、transform和croppin

2018-10-23 本文已影响0人苏沫离

一、不可变对象AVVideoCompositionLayerInstruction

AVVideoCompositionLayerInstruction 继承自NSObject,设置AVVideoComposition中指定轨道的不透明度opacity、旋转矩阵变换transform和裁剪cropping。

1、获取trackID

合成器将应用指令的源轨道的trackID。

@property(nonatomic, readonly, assign) CMPersistentTrackID trackID;

2、获得opacity，transform和croppingRamps

2.1、获得指定时间的渐变opacity

- (BOOL)getOpacityRampForTime:(CMTime)time
startOpacity:(float *)startOpacity
endOpacity:(float *)endOpacity
timeRange:(CMTimeRange *)timeRange;

获得包含指定时间的不透明度渐变：

参数time：如果设置了包含指定时间范围的渐变，则提供有关该时间的有效渐变的信息。否则，将提供关于在指定时间之后开始的第一个渐变的信息。
参数startOpacity：指向float的指针，用于接收不透明度渐变的初始值；该值可能为NULL。
参数endOpacity：指向float的指针，用于接收不透明度渐变的最终值；该值可能为NULL。
参数timeRange：指向CMTimeRange的指针，用于接收不透明度渐变的时间范围；该值可能为NULL。
返回值：如果返回值成功，则为YES，否则为NO。如果时间超过设置的最后一个不透明度渐变的持续时间，则返回NO。

2.2、获得指定时间的渐变 transform

- (BOOL)getTransformRampForTime:(CMTime)time
startTransform:(CGAffineTransform *)startTransform
endTransform:(CGAffineTransform *)endTransform
timeRange:(CMTimeRange *)timeRange;

获得包含指定时间的渐变transform：

参数time：如果设置了包含指定时间范围的渐变，则提供有关该时间的有效渐变的信息。否则，将提供关于在指定时间之后开始的第一个渐变的信息。
参数startTransform：用于接收transform渐变的起始值；该值可能为NULL。
参数endTransform：用于接收transform渐变的最终值；该值可能为NULL。
参数timeRange：指向CMTimeRange的指针，用于接收transform渐变的时间范围；该值可能为NULL。

2.3、获得指定时间的渐变矩形裁剪

- (BOOL)getCropRectangleRampForTime:(CMTime)time
startCropRectangle:(CGRect *)startCropRectangle
endCropRectangle:(CGRect *)endCropRectangle
timeRange:(CMTimeRange *)timeRange;

获得指定时间的渐变crop rectangle：

参数time：如果设置了包含指定时间范围的渐变，则提供有关该时间的有效渐变的信息。否则，将提供关于在指定时间之后开始的第一个渐变的信息。
参数startCropRectangle：指向CGRect的指针，用于接收裁剪矩形渐变的起始值；该值可能为NULL。
参数endCropRectangle：指向CGRect的指针，用于接收裁剪矩形渐变的最终值；该值可能为NULL。
参数timeRange：指向CMTimeRange的指针，用于接收裁剪矩形渐变的时间范围；该值可能为NULL。

二、可变对象AVMutableVideoCompositionLayerInstruction

AVMutableVideoCompositionLayerInstruction 继承自AVVideoCompositionLayerInstruction,设置AVVideoComposition中指定轨道的不透明度opacity、旋转矩阵变换transform和裁剪cropping。

1、创建指令

新的可变视频合成图层指令：没有transform或opacity渐变和trackID为kCMPersistentTrackID_Invalid。

+ (instancetype)videoCompositionLayerInstruction;

//为指定的音轨道返回一个新的可变视频合成层指令
+ (instancetype)videoCompositionLayerInstructionWithAssetTrack:(AVAssetTrack *)track;

2、配置trackID

合成器将应用指令的源轨道的trackID。

@property(nonatomic, assign) CMPersistentTrackID trackID;

3、设置不透明度opacity

3.1、指定时间范围的不透明度opacity

在指定时间范围内设置不透明度值opacity。

- (void)setOpacity:(float)opacity atTime:(CMTime)time;

参数opacity：不透明度；该值必须介于0.0和1.0之间。
参数time：合成指令的时间范围内的时间值。

设置一个固定的不透明度，从指定的时间应用到下一次设置不透明度的时间;这与为那个时间范围设置一个平坦渐变是一样的。在首次设置不透明度之前，不透明度保持在1.0不变;在最后指定的时间之后，不透明度在最后一个值保持不变。

3.2、指定时间的渐变不透明度opacity

设置在指定时间范围内应用的不透明度渐变。

- (void)setOpacityRampFromStartOpacity:(float)startOpacity
toEndOpacity:(float)endOpacity
timeRange:(CMTimeRange)timeRange;

参数startOpacity：在timeRange的开始时间应用的不透明度；该值必须介于0.0和1.0之间。
参数endOpacity：在timeRange结束时应用的不透明度；该值必须介于0.0和1.0之间。
参数timeRange：在startOpacity和endOpacity之间插入不透明度值的时间范围。

在不透明度渐变期间，使用线性插值计算不透明度。在第一次设置不透明度之前，不透明度保持恒定为1.0; 在最后一个指定时间之后，不透明度在最后一个值处保持不变。

4、设置旋转矩阵变换transform

4.1、指定时间范围的旋转矩阵变换transform

每次在指定时间范围内设置旋转矩阵变换transform值。

- (void)setTransform:(CGAffineTransform)transform atTime:(CMTime)time;

设置固定变换以从指定时间应用到下一次设置变换的时间。这与为该时间范围设置平坦渐变相同。在设置变换的第一个指定时间之前，仿射变换保持恒定在CGAffineTransformIdentity的值; 在设置了变换的最后一次之后，仿射变换在该最后一个值处保持恒定。

4.2、指定时间的渐变转换transform

- (void)setTransformRampFromStartTransform:(CGAffineTransform)startTransform
toEndTransform:(CGAffineTransform)endTransform
timeRange:(CMTimeRange)timeRange;

参数startTransform：要在timeRange的开始时间应用的变换。
参数endTransform：在timeRange结束时应用的转换。
参数timeRange：在startTransform和endTransform之间插入变换值的时间范围。

在transform渐变期间，仿射变换在渐变的开始时间和结束时间设置的值之间进行插值。在设置变换的第一个指定时间之前，仿射变换保持恒定在CGAffineTransformIdentity的值; 在设置了变换的最后一次之后，仿射变换在该最后一个值处保持恒定。

5、设置裁剪矩形值

裁剪矩形的原点是缓冲区光圈矩形的左上角。裁剪矩形是在正方形像素空间中定义的，即不考虑像素长宽比。将延伸到光圈外的矩形裁剪成光圈。

在设置裁剪矩形的第一个指定时间之前，裁剪矩形保持不变为CGRectInfinite，并且在最后一次设置裁剪矩形之后，裁剪矩形在该最后一个值处保持不变。

5.1、指定时间的固定裁剪值 cropRectangle

在指令的时间范围内设置裁剪矩形的值。

- (void)setCropRectangle:(CGRect)cropRectangle atTime:(CMTime)time;

设置固定的裁剪矩形，以便从下次设置裁剪矩形的时间开始应用; 这与为该时间范围设置平坦渐变相同。

5.2、指定时间的渐变裁剪 cropRectangle

设置要在指定时间范围内应用的裁剪矩形渐变。

- (void)setCropRectangleRampFromStartCropRectangle:(CGRect)startCropRectangle
toEndCropRectangle:(CGRect)endCropRectangle
timeRange:(CMTimeRange)timeRange;

参数startCropRectangle：要在timeRange的开始时间应用的裁剪矩形。
参数endCropRectangle：要在timeRange结束时应用的裁剪矩形。
参数timeRange：在startCropRectangle和endCropRectangle之间插入裁剪矩形值的时间范围。

在裁剪矩形渐变期间，矩形在渐变的开始时间和结束时间之间设置的值之间进行插值。当起始或结束矩形为空时，插值会考虑空矩形的原点和大小。