一、不可变对象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之间插入裁剪矩形值的时间范围。
在裁剪矩形渐变期间，矩形在渐变的开始时间和结束时间之间设置的值之间进行插值。当起始或结束矩形为空时，插值会考虑空矩形的原点和大小。