1、SCNScene

  SCNScene是一个场景图——具有附加几何形状、光照、摄像机和其他属性的节点的层次结构,共同形成可显示的3D场景。

2、相关API简介

  • 初始化方法
//懒加载
+ (instancetype)scene; //name:3D文件的路径
+ (nullable instancetype)sceneNamed:(NSString *)name API_AVAILABLE(macos(10.9)); /**
@param name 3D文件路径
@param directory 要搜索的路径子目录的名称
@param options 字典,相关秘钥记录在SCNSceneSource类中
*/
+ (nullable instancetype)sceneNamed:(NSString *)name inDirectory:(nullable NSString *)directory options:(nullable NSDictionary<SCNSceneSourceLoadingOption, id> *)options API_AVAILABLE(macos(10.10)); /**
@param url 3D文件路径
@param options 字典,相关秘钥记录在SCNSceneSource类中
@param error 错误信息
*/
+ (nullable instancetype)sceneWithURL:(NSURL *)url options:(nullable NSDictionary<SCNSceneSourceLoadingOption, id> *)options error:(NSError **)error;
  • 控制场景的动画
//暂停场景将暂停动画、动作、粒子和物理。默认为NO。
@property(nonatomic, getter=isPaused) BOOL paused API_AVAILABLE(macos(10.10));
  • 获取场景内容
//获取根节点
@property(nonatomic, readonly) SCNNode *rootNode; //获取背景
//背景在场景渲染之前出现
//通过设置SCNMaterialProperty.h 中描述的多维数据集映射,可以将背景渲染成天空盒
@property(nonatomic, readonly) SCNMaterialProperty *background API_AVAILABLE(macos(10.9)); //获取灯光环境
//环境应该是SCNMaterialProperty.h中所述的立方体映射
@property(nonatomic, readonly) SCNMaterialProperty *lightingEnvironment API_AVAILABLE(macos(10.12), ios(10.0), tvos(10.0));
  • 管理场景属性
//检索场景属性
- (nullable id)attributeForKey:(NSString *)key; //设置场景属性
- (void)setAttribute:(nullable id)attribute forKey:(NSString *)key;
//场景属性
#if defined(SWIFT_SDK_OVERLAY2_SCENEKIT_EPOCH) && SWIFT_SDK_OVERLAY2_SCENEKIT_EPOCH >= 3
typedef NSString * SCNSceneAttribute NS_STRING_ENUM;
#else
typedef NSString * SCNSceneAttribute;
#endif
FOUNDATION_EXTERN SCNSceneAttribute const SCNSceneStartTimeAttributeKey; //一个浮点值,封装在NSNumber中,包含场景的开始时间
FOUNDATION_EXTERN SCNSceneAttribute const SCNSceneEndTimeAttributeKey; // 一个浮点值,封装在NSNumber中,包含场景的结束时间
FOUNDATION_EXTERN SCNSceneAttribute const SCNSceneFrameRateAttributeKey; // 一个浮点值,封装在NSNumber中,包含场景的帧速率
FOUNDATION_EXTERN SCNSceneAttribute const SCNSceneUpAxisAttributeKey API_AVAILABLE(macos(10.10)); //一个包含x,y,z向量[结构体]值,封装在NSValue中,包含场景的上轴.这仅仅是为了信息,设置上轴没有任何效果 #define SCNSceneAttributeStartTime SCNSceneStartTimeAttributeKey
#define SCNSceneAttributeEndTime SCNSceneEndTimeAttributeKey
#define SCNSceneAttributeFrameRate SCNSceneFrameRateAttributeKey
#define SCNSceneAttributeUpAxis SCNSceneUpAxisAttributeKey
  • 导出场景文件
/**
将场景及其内容导出到指定URL的文件中。 @param url 指定的URL
@param options 一个字典选项.有效的key在"场景书写选项"部分中有所描述
@param delegate 一个可选的代理,用于管理外部引用.例如图片
@param API_UNAVAILABLE progressHandler(进度处理程序) 一个可选的块来处理操作的进度
@return 如果操作成功就返回YES,否则就返回NO.错误检查可以通过"progressHandler"的"error"参数来完成.
@讨论 macOS 10.10 和 更低的版本只支持导出 .DAE 文件.
开启 macOS 10.11 支持导出 .dae, .scn 以及模型I/O支持的文件所有格式.
开启 iOS 10 支持导出 .scn 以及模型I/O支持的文件所有格式. */
- (BOOL)writeToURL:(NSURL *)url options:(nullable NSDictionary<NSString *, id> *)options delegate:(nullable id <SCNSceneExportDelegate>)delegate progressHandler:(nullable SCNSceneExportProgressHandler)progressHandler API_AVAILABLE(macos(10.9), ios(10.0), tvos(10.0)) API_UNAVAILABLE(watchos); /**
场景导出期间调用的block块 @param totalProgress 进度0-1
@param error 错误信息
@param stop 是否终止 设置*stop为YES停止
*/
typedef void (^SCNSceneExportProgressHandler)(float totalProgress, NSError * _Nullable error, BOOL *stop);
API_AVAILABLE(macos(10.9), ios(10.0), tvos(10.0)) API_UNAVAILABLE(watchos)
@protocol SCNSceneExportDelegate <NSObject>
@optional
/**
在代理上调用写入引用的图像并返回目标网址 @param image 这个图片是白色
@param documentURL 这个URL是场景现在导出的
@param API_UNAVAILABLE 图像的原始网址.如果图像之前未从网址加载,则可能为nil
@return 委托必须返回导出的图像网址,如果未导出任何图像,则返回nil。 如果返回的值为nil,则图像将以默认格式导出到默认目标。
*/
- (nullable NSURL *)writeImage:(UIImage *)image withSceneDocumentURL:(NSURL *)documentURL originalImageURL:(nullable NSURL *)originalImageURL API_AVAILABLE(macos(10.9), ios(10.0), tvos(10.0)) API_UNAVAILABLE(watchos);
@end
//场景导出目标URL
FOUNDATION_EXTERN NSString * const SCNSceneExportDestinationURL API_AVAILABLE(macos(10.9));
  • 给场景添加雾
//开始雾距离
@property(nonatomic) CGFloat fogStartDistance API_AVAILABLE(macos(10.10)); //结束雾距离
@property(nonatomic) CGFloat fogEndDistance API_AVAILABLE(macos(10.10)); //雾密度指数
//(控制开始和结束雾距之间的衰减.0表示恒定雾,1表示线性雾,2表示二次雾,但任何正值都将起作用
@property(nonatomic) CGFloat fogDensityExponent API_AVAILABLE(macos(10.10)); //雾颜色、默认为白色
@property(nonatomic, retain) id fogColor API_AVAILABLE(macos(10.10));
  • 场景的物理信息
//物理世界
//每个场景自动创建一个物理世界对象,以模拟场景中节点上的物理现象.你可以使用此属性来访问场景的全局物理属性,例如重力.要向特定节点添加物理现象,请看physicsBody
@property(nonatomic, readonly) SCNPhysicsWorld *physicsWorld API_AVAILABLE(macos(10.10));

iOS开发之SceneKit框架--SCNScene.h的更多相关文章

  1. iOS开发之SceneKit框架--SCNParametricGeometry.h

    1.SCNParametricGeometry简介 SCNParametricGeometry用于创建简单的3D模型,比如SCNPlane 平面.SCNPyramid 锥形(金字塔).SCNBox 立 ...

  2. iOS开发之SceneKit框架--SCNGeometry.h

    1.SCNGeometry简介 SCNGeometry负责呈现三维模型的类,它管理者物体的形状.纹理等.它可以由SCNGeometrySource和SCNGeometryElement来构造, 一个S ...

  3. iOS开发之SceneKit框架--SCNNode.h

    1.SCNNode简介 SCNNode是场景图的结构元素,表示3D坐标空间中的位置和变换,您可以将模型,灯光,相机或其他可显示内容附加到该元素.也可以对其做动画. 2.相关API简介 初始化方法 // ...

  4. iOS开发之SceneKit框架--SCNView.h

    1.SCNView 在macOS中,SCNView是NSView的子类,在iOS和tvOS中,SCNView是UIView的子类.SCNView用于显示SceneKit的3D场景,而需要设置场景的相关 ...

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

    1.SCNAction简介 主要负责节点SCNNode的属性,实现node的渐变.移动.出现.消失.实现动画等. 2.相关API 节点的移动(earthNode的初始坐标(5,0,0)) //从当前位 ...

  6. iOS开发之SceneKit框架--SCNLight.h

    1.SCNLight简介 用于添加光源,连接到一个节点照亮现场,可以给场景添加不同的灯光,模拟逼真的环境. 2.四种灯光的简介 添加一个box立方体.一个tube圆柱管道和一个地板floor,没有灯光 ...

  7. iOS开发之SceneKit框架--SCNCamera.h

    1.SCNCamera简介 被称为照相机或者摄像机,可以附加到节点以提供显示场景的角度.其实就是用户视角和人的眼睛一样. 2.相关API简介 初始化 //懒加载 + (instancetype)cam ...

  8. iOS开发之SceneKit框架--加载多个模型.dae/.scn文件

    1.通过SCNGeometry或子类SCNParametricGeometry创建 相关链接:iOS开发之SceneKit框架--SCNGeometry.h iOS开发之SceneKit框架--SCN ...

  9. iOS开发之SceneKit框架--实战地月系统围绕太阳旋转

    1.创建地月太阳系统scn文件 注意:moon在earth结构下,earth和moon在sun结构下. 2.获取scn中模型的对应节点和自转(太阳为例) 获取节点: name是对应的Identity字 ...

随机推荐

  1. 实战ZeroMQ的PUSH/PULL推拉模式

    原文地址: http://ju.outofmemory.cn/entry/235976

  2. HttpUrlConnection类基本使用

    这个类用来模拟浏览器向服务器发送请求和接收响应 注意: HttpUrlConnection对象简称huc对象 1)获取huc对象向url构造中传递url字符串,并调用openconnection方法即 ...

  3. php mysql函数库总结(一)

    连接mysqlresource mysql_connect(host,username,password);设置交互字符集bool mysql_set_charset("utf8|gbk&q ...

  4. Delphi产生任务栏图标【TNotifyIconData】(转载)

    一.新建一个应用程序:File->New Applicaton 在Interface部分要放在Uses Message之后,定义一个消息常量:const WM_NID=WM_USER+1000; ...

  5. Photon Server的服务器端配置

    Photon Server与Unity3D的交互分为3篇博文实现 (1)Photon Server的服务器端配置 (2)Photon Server的Unity3D客户端配置 (3)Photon Ser ...

  6. Try running RemoteDll as Administrator

    在使用RemoteDll注入动态库的时候发现注入有的动态库会提示下面的错误, LoadLibrary on remote process [1968 - Explorer.exe] failed. T ...

  7. idea 社区版+spring boot+ssm+swagger创建rest api

    新手上路,出了好多错,记录一下 1.创建数据库:springBootSsmTest 2.打开IDEA创建 Spring boot项目:File——New——Project——Spring Assist ...

  8. Mybatis笔记 - Mybatis框架简介

    MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis,实质上 ...

  9. .net与C#

    一..net包含什么? 1.包含庞大的代码库,分为多个模块,可以自主选择 2.定义了基本的类型,被称为通用类型系统(CTS,common type system): 3.包含.NET公共语言运行库(C ...

  10. 如果一个文件块有130M,请问有多少个mapper

    如果一个文件块有130M,请问有多少个mapper 130M的文件将被分成2个mapper. 原因:根据FileInputFormat类 有一个成员变量 private static final do ...