前言

GLKit 是为了加速基于OpenGL或OpenGl ES应用开发而设计出来的，它简化了基于着色器的应用程序所需的工作量，提高了开发效率。

GLKit 框架

功能：

1.  加载纹理

2.  高性能的数学运算库。 

3.  提供常见的标准Shader特效。 

4. 提供视图以及视图控制器.

GLKit API

纹理加载

初始化

- (instancetype)initWithSharegroup:(EAGLSharegroup*)sharegroup; //初始化一个纹理加载到对象中

 - (instancetype)initWithShareContext:(NSOpenGLContext *)context; //初始化一个纹理加载对象

从文件中加载

+ (nullableGLKTextureInfo*)textureWithContentsOfFile:(NSString*)path  options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError;  //从文件中加载纹理

- (void)textureWithContentsOfFile:(NSString*)path  options:(nullableNSDictionary *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block;  //从文件中异步加载纹理

从URL加载纹理

+ (nullableGLKTextureInfo*)textureWithContentsOfURL:(NSURL*)url options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError;  //从URL加载纹理

- (void)textureWithContentsOfURL:(NSURL*)url options:(nullableNSDictionary *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block; //从URL异步加载纹理

从内存中表示创建纹理

+ (nullableGLKTextureInfo*)textureWithContentsOfData:(NSData*)data options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError; //从内存数据加载纹理

- (void)textureWithContentsOfData:(NSData*)data options:(nullableNSDictionary *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block; //从内存数据异步加载纹理

从CGImage加载纹理

+ (nullableGLKTextureInfo*)textureWithCGImage:(CGImageRef)cgImage  options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError; //从CGImage加载纹理

- (void)textureWithCGImage:(CGImageRef)cgImage  options:(nullable NSDictionary<NSString*, NSNumber*> *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block; //从CGImage异步加载纹理

从文件加载多维创建纹理

+ (nullableGLKTextureInfo*)cubeMapWithContentsOfFile:(NSString*)path  options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError; //从单个文件加载立方体贴图纹理对象

- (void)cubeMapWithContentsOfFile:(NSString*)path options:(nullableNSDictionary *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block; //从单个文件异步加载立方体贴图纹理对象

+ (nullableGLKTextureInfo*)cubeMapWithContentsOfFiles:(NSArray<id> *)paths options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError;  //从多个文件加载立方体贴图纹理对象

- (void)cubeMapWithContentsOfFiles:(NSArray<id> *)paths options:(nullableNSDictionary *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block; //从多个文件异步加载立方体贴图纹理对象

从URL加载多维创建纹理

+ (nullableGLKTextureInfo*)cubeMapWithContentsOfURL:(NSURL*)url options:(nullableNSDictionary *)options error:(NSError*__nullable*__nullable)outError; //从URL加载立方体贴图纹理对象

- (void)cubeMapWithContentsOfURL:(NSURL*)url  options:(nullableNSDictionary *)options queue:(nullabledispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block; //从URL异步加载立方体贴图纹理对象

---

GLKView

初始化视图

- (instancetype)initWithFrame:(CGRect)frame context:(EAGLContext*)context; //初始化一个新的视图

帧缓存区对象

@property (nonatomic) GLKViewDrawableColorFormat drawableColorFormat; //颜色缓冲区格式

@property (nonatomic) GLKViewDrawableDepthFormat drawableDepthFormat; //深度缓冲区格式

@property (nonatomic) GLKViewDrawableStencilFormat drawableStencilFormat; //模板缓冲区格式

@property (nonatomic) GLKViewDrawableMultisample drawableMultisample; //多从采样缓冲区格式

帧缓存区属性

@property (nonatomic, readonly) NSInteger drawableWidth; //底层缓存区对象的⾼度(以像素为单位)

@property (nonatomic, readonly) NSInteger drawableHeight; //底层缓存区对象的宽度(以像素为单位)

绘制视图的内容

@property (nonatomic, retain) EAGLContext *context; //绘制使用的OpenGL ES上下文

@property(nonatomic)BOOL enableSetNeedsDisplay; //指定视图是否响应使得视图内容无效的消息

@property (readonly, strong) UIImage *snapshot; //绘制视图内容并将其作为新图像对象返回

- (void)display; //立刻重新绘制视图

- (void)bindDrawable; //将底层FrameBuffer对象绑定到OpenGL ES

- (void)deleteDrawable; //删除与视图关联的可绘制对象

---

GLKViewDelegate

- (void)glkView:(GLKView*)view drawInRect:(CGRect)rect; //绘制视图内容（必须实现）

---

GLKViewController

更新

- (void)glkViewControllerUpdate:(GLKViewController*)controller; 

配置帧速率

@property(nonatomic)NSIntegerpreferredFramesPerSecond; //视图控制器调用视图以及更新视图内容的速率

@property (nonatomic, readonly) NSInteger framesPerSecond; //视图控制器调⽤视图以及更新其内容的实际速率

控制帧更新

@property (nonatomic, getter=isPaused) BOOL paused; //渲染循环是否已暂停

@property(nonatomic)BOOL pauseOnWillResignActive; //当前程序重新激活动状态时视图控制器是否⾃动暂停渲染循环

@property(nonatomic)BOOL resumeOnDidBecomeActive; //当前程序变为活动状态时视图控制是否⾃动恢复呈现循环

获取有关View 更新信息

@property (nonatomic, readonly) NSInteger framesDisplayed; //视图控制器⾃创建以来发送的帧更新数

@property(nonatomic,readonly)NSTimeInterval timeSinceFirstResume; //自视图控制器第一次恢复发送更新事件以来经过的时间量

@property(nonatomic,readonly)NSTimeInterval timeSinceLastResume; //⾃上次视图控制器恢复发送更新事件以来更新的时间量

@property(nonatomic,readonly)NSTimeInterval timeSinceLastUpdate; //⾃上次视图控制器调⽤委托⽅法以及经过的时间量

@property (nonatomic, readonly) NSTimeInterval timeSinceLastDraw; //⾃上次视图控制器调用视图display方法以来经过的时间量

---

GLKViewControllerDelegate

处理更新事件

- (void)glkViewControllerUpdate:(GLKViewController*)controller; //在显示每个帧之前调⽤

暂停/恢复通知

- (void)glkViewController:(GLKViewController*)controller willPause:(BOOL)pause; //在渲染循环暂停或恢复之前调用

---

GLKBaseEffect

命名

@property(nullable,nonatomic,copy) NSString *label; 

配置模型视图转换

@property(nonatomic,readonly) GLKEffectPropertyTransform *transform; //绑定效果时应⽤于顶点数据的模型视图,投影和纹理变换

配置光照效果

@property(nonatomic,assign) GLKLightingType lightingType;  //⽤于计算每个片段的光照策略,取值为GLKLightingTypePerVertex，GLKLightingTypePerPixel

GLKLightingTypePerVertex //表示在三角形中每个顶点执行光照计算,然后在三角形进行插值

GLKLightingTypePerPixel //表示光照计算的输⼊在三角形内插入,并且在每个片段执行光照计算

配置光照

@property(nonatomic,assign) GLboolean lightModelTwoSided; //表示为基元的两侧计算光照

@property(nonatomic,readonly) GLKEffectPropertyMaterial *material; //计算渲染图元光照使用的材质属性

@property(nonatomic,assign) GLKVector4 lightModelAmbientColor; //环境颜⾊,应用效果渲染的所有图元

@property(nonatomic,readonly) GLKEffectPropertyLight *light0, *light1, *light2; //场景中第一、二、三个光照属性

配置纹理

@property(nonatomic,readonly) GLKEffectPropertyTexture *texture2d0, *texture2d1; //场景中第⼀、二个纹理理属性

@property (nullable, nonatomic, copy) NSArray<GLKEffectPropertyTexture*> *textureOrder; //纹理应用于渲染图元的顺序

配置雾化

@property(nonatomic,readonly) GLKEffectPropertyFog *fog; //应用于场景的雾属性

配置颜⾊信息

@property(nonatomic,assign) GLboolean colorMaterialEnabled; //表示计算光照与材质交互时是否使用颜色顶点属性

@property(nonatomic,assign) GLboolean useConstantColor; //指示是否使用常量颜色

@property(nonatomic,assign) GLKVector4 constantColor; //不提供每个顶点颜⾊数据时使⽤常量颜色

准备绘制效果

- (void) prepareToDraw; //准备渲染

---