iOS开发之SceneKit框架--SCNAction.h

1、SCNAction简介

　　主要负责节点SCNNode的属性，实现node的渐变、移动、出现、消失、实现动画等。

2、相关API

节点的移动（earthNode的初始坐标（5，0，0））

//从当前位置移动指定的距离X轴：deltaX Y轴：deltaY Z轴：deltaZ

+ (SCNAction *)moveByX:(CGFloat)deltaX y:(CGFloat)deltaY z:(CGFloat)deltaZ duration:(NSTimeInterval)duration;

+ (SCNAction *)moveBy:(SCNVector3)delta duration:(NSTimeInterval)duration;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction moveByX: y: z: duration:]];

    [self.earthNode runAction:[SCNAction moveBy:SCNVector3Make(5, 5, 0) duration:]];

//移动到指定坐标location

+ (SCNAction *)moveTo:(SCNVector3)location duration:(NSTimeInterval)duration;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction moveTo:SCNVector3Make(5, 5, 0) duration:]];

节点的旋转

//当前的节点基础上进行旋转指定的角度X轴：xAngle Y轴：yAngle Z轴：zAngle

+ (SCNAction *)rotateByX:(CGFloat)xAngle y:(CGFloat)yAngle z:(CGFloat)zAngle duration:(NSTimeInterval)duration;

//旋转到指定的角度X轴：xAngle Y轴：yAngle Z轴：zAngle

//shortestUnitArc：YES是顺时针，NO为逆时针

+ (SCNAction *)rotateToX:(CGFloat)xAngle y:(CGFloat)yAngle z:(CGFloat)zAngle duration:(NSTimeInterval)duration;

+ (SCNAction *)rotateToX:(CGFloat)xAngle y:(CGFloat)yAngle z:(CGFloat)zAngle duration:(NSTimeInterval)duration shortestUnitArc:(BOOL)shortestUnitArc;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction rotateByX: y:M_PI_2 z: duration:]];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)( * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{

        [self.earthNode runAction:[SCNAction rotateToX: y: z: duration:]];

    });

//axis和原点组成轴向量，旋转angle角度

//axisAngle：是四分量，前三个坐标相当于axis的值，第四个值为旋转角度

+ (SCNAction *)rotateByAngle:(CGFloat)angle aroundAxis:(SCNVector3)axis duration:(NSTimeInterval)duration;

+ (SCNAction *)rotateToAxisAngle:(SCNVector4)axisAngle duration:(NSTimeInterval)duration;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction rotateByAngle:M_PI_2 aroundAxis:SCNVector3Make(, , ) duration:]];

    [self.earthNode runAction:[SCNAction rotateToAxisAngle:SCNVector4Make(, , , M_PI_2) duration:]];

节点的缩放

//在原来基础上进行缩放

+ (SCNAction *)scaleBy:(CGFloat)scale duration:(NSTimeInterval)sec;

//在初始化的基础上进行缩放

+ (SCNAction *)scaleTo:(CGFloat)scale duration:(NSTimeInterval)sec;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction scaleTo: duration:]];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)( * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{

        [self.earthNode runAction:[SCNAction scaleBy:0.5 duration:]];

    });

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction scaleBy: duration:]];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)( * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{

        [self.earthNode runAction:[SCNAction scaleTo:0.5 duration:]];

    });

节点的透明度

//透明度变换到1的动画

+ (SCNAction *)fadeInWithDuration:(NSTimeInterval)sec;

//透明度变换到0的动画

+ (SCNAction *)fadeOutWithDuration:(NSTimeInterval)sec;

//原来的透明度基础上 变换值为factor

+ (SCNAction *)fadeOpacityBy:(CGFloat)factor duration:(NSTimeInterval)sec;

//变换到指定的透明度opacity

+ (SCNAction *)fadeOpacityTo:(CGFloat)opacity duration:(NSTimeInterval)sec;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction fadeOutWithDuration:]];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)( * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{

        [self.earthNode runAction:[SCNAction fadeInWithDuration:]];

    });

节点的可视性

//隐藏node

+ (SCNAction *)hide API_AVAILABLE(macos(10.11), ios(9.0));

//不隐藏node

+ (SCNAction *)unhide API_AVAILABLE(macos(10.11), ios(9.0));

移除节点

//移除节点

+ (SCNAction *)removeFromParentNode;

添加音频播放

//播放音频。 waitForCompletion：YES Action的duration就是音频的时长；NO duration为0。

+ (SCNAction *)playAudioSource:(SCNAudioSource *)source waitForCompletion:(BOOL)wait API_AVAILABLE(macos(10.11), ios(9.0));

创建节点的动画组或者重复节点的动画

//所有动画串行运行

+ (SCNAction *)sequence:(NSArray<SCNAction *> *)actions;

//所有动画并行运行

+ (SCNAction *)group:(NSArray<SCNAction *> *)actions;

//重复action动画，count次

+ (SCNAction *)repeatAction:(SCNAction *)action count:(NSUInteger)count;

//一直重复action动画

+ (SCNAction *)repeatActionForever:(SCNAction *)action;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction group:@[[SCNAction rotateToX: y: z: duration:],[SCNAction fadeOutWithDuration:]]]];

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction sequence:@[[SCNAction rotateToX: y: z: duration:],[SCNAction fadeOutWithDuration:]]]];

动画延迟设置（适用于//所有动画串行运行+ (SCNAction *)sequence:(NSArray<SCNAction *> *)actions;）

//动画延迟时间

+ (SCNAction *)waitForDuration:(NSTimeInterval)sec;

//动画延迟时间 随机数范围【sec，durationRange/2]

+ (SCNAction *)waitForDuration:(NSTimeInterval)sec withRange:(NSTimeInterval)durationRange;

iOS开发之SceneKit框架--SCNAction.h

    [self.earthNode runAction:[SCNAction sequence:@[[SCNAction rotateToX: y: z: duration:],[SCNAction waitForDuration: withRange:],[SCNAction fadeOutWithDuration:]]]];

节点自定义动画

//执行动画开始时立即调用，node是正在动画的节点

+ (SCNAction *)runBlock:(void (^)(SCNNode *node))block;

+ (SCNAction *)runBlock:(void (^)(SCNNode *node))block queue:(dispatch_queue_t)queue;

/**

 反复运行脚本，直到动作的持续时间结束。每次SceneKit运行脚本时，它计算自操作开始执行以来的运行时间(作为操作在0.0到1.0之间的时间的一部分)，并使脚本作为一个名为elapsedTime的变量可用。

 @param script 包含JavaScript源代码的字符串。

 @param seconds 动作的持续时间，以秒为单位。

 */

+ (SCNAction *)javaScriptActionWithScript:(NSString *)script duration:(NSTimeInterval)seconds;

/**

 自定义动作执行时反复调用

 @param seconds 动作时间

 @param block 节点node，和动作开始经过的时间elapsedTime

 */

+ (SCNAction *)customActionWithDuration:(NSTimeInterval)seconds actionBlock:(void (^)(SCNNode *node, CGFloat elapsedTime))block;

节点动画逆转

- (SCNAction *)reversedAction;

基础属性

//动画时间

@property(nonatomic) NSTimeInterval duration;

//定时模式

@property(nonatomic) SCNActionTimingMode timingMode;

typedef NS_ENUM(NSInteger, SCNActionTimingMode) {

    SCNActionTimingModeLinear,//匀速

    SCNActionTimingModeEaseIn,//先慢后快

    SCNActionTimingModeEaseOut,//先快后慢

    SCNActionTimingModeEaseInEaseOut//先慢中快后慢

} API_AVAILABLE(macos(10.10), ios(8.0));

//使用这个输入来计算定制的计时功能，它的输出决定了动画的计时

@property(nonatomic, nullable) SCNActionTimingFunction timingFunction;

//自定义计时功能。输入时间在0.0到1.0之间。在行动期间。返回值必须为0-1.0并增加。当输入时间达到1.0时，函数必须返回1.0。

typedef float (^SCNActionTimingFunction)(float time);

action.timingMode = SCNActionTimingModeLinear;

action.timingFunction = ^float(float time) {

    return 1.0 - time*time;

};

//速度系数

@property(nonatomic) CGFloat speed;

SCNActionable协议

//运行动画

- (void)runAction:(SCNAction *)action API_AVAILABLE(macos(10.10));

//运行动画，动画结束block块

- (void)runAction:(SCNAction *)action completionHandler:(nullable void (^)(void))block API_AVAILABLE(macos(10.10));

//运行动画设置key值

- (void)runAction:(SCNAction *)action forKey:(nullable NSString *)key API_AVAILABLE(macos(10.10));

//运行动画设置key值，动画结束block块

- (void)runAction:(SCNAction *)action forKey:(nullable NSString *)key completionHandler:(nullable void (^)(void))block API_AVAILABLE(macos(10.10));

//是否正在动画

@property(nonatomic, readonly) BOOL hasActions API_AVAILABLE(macos(10.10));

//通过key值获取动画

- (nullable SCNAction *)actionForKey:(NSString *)key API_AVAILABLE(macos(10.10));

//通过key值移除动画

- (void)removeActionForKey:(NSString *)key API_AVAILABLE(macos(10.10));

//移除所有动画

- (void)removeAllActions API_AVAILABLE(macos(10.10));

//读取所有动画key值

@property(nonatomic, readonly) NSArray<NSString *> *actionKeys API_AVAILABLE(macos(10.10));

秒客网

iOS开发之SceneKit框架--SCNAction.h

相关文章