GLKit的API解析

GLKit框架的设计是为了简化iOS开发者基于OpenGL/OpenGL ES的应用开发，应用该框架提供的功能和类，可以减少创建新的基于着色器的应用程序所需的工作量。

GLKView提供绘制场所
GLKViewController扩展于标准的UIKit设计模式，用于绘制视图内容的管理与呈现

GLKit功能

加载纹理
提供高性能的数学运算
提供常见的着色器
提供视图以及视图控制器

EAGLContext OpenGl ES上下文

初始化上下文&设置当前上下文

/*
  EAGLContext 是苹果iOS平台下实现OpenGLES 渲染层.
  kEAGLRenderingAPIOpenGLES1 = 1, 固定管线
  kEAGLRenderingAPIOpenGLES2 = 2,
  kEAGLRenderingAPIOpenGLES3 = 3,
 */
context = [[EAGLContext alloc]initWithAPI:kEAGLRenderingAPIOpenGLES3];
//设置当前上下文
[EAGLContext setCurrentContext:context];

GLKView

初始化GLKView
//设置frame并设置view的上下文context
GLKView *view = [GLKView alloc]initWithFrame:(CGRect) context:(nonnull EAGLContext *)
//设置代理
view.delegate = self;
//drawableColorFormat: 设置颜色缓存区格式.
view.drawableColorFormat = GLKViewDrawableColorFormatRGBA8888;
//drawableDepthFormat: 深度缓存区格式
/*
GLKViewDrawableDepthFormatNone = 0,意味着完全没有深度缓冲区
GLKViewDrawableDepthFormat16,
GLKViewDrawableDepthFormat24,
 如果你要使用这个属性（一般用于3D游戏），你应该选择GLKViewDrawableDepthFormat16或GLKViewDrawableDepthFormat24。这里的差别是使用GLKViewDrawableDepthFormat16将消耗更少的资源
*/
view.drawableDepthFormat = GLKViewDrawableDepthFormat16;
//设置模版渲染缓存区格式
.drawableStencilFormat
//设置多重采样缓存区格式
.drawableMultisample
//将底层FrameBuffer对象绑定到OpenGL ES
- (void)bindDrawable;
//布尔值,指定视图是否响应使得视图内容⽆无效的消息
enableSetNeedsDisplay
//立即重绘视图内容
- (void)display;
//绘制视图内容并将其作为新图像对象返回
snapshot
//删除视图FrameBuffer对象,通常写在dealloc中
- (void)deleteDrawable;
//GLKViewDelegate代理方法
//绘制视图内容，必须实现的代理
- (void)glkView:(GLKView *)view drawInRect:(CGRect)rect

GLKTextureInfo用于创建OpenGL纹理信息

name: OpenGL上下文中纹理名称
target: 绑定纹理的目标
height: 加载的纹理高度
width: 加载的纹理宽度
textureOrigin: 加载纹理中的原点位置
alphaState: 加载纹理中alpha分量量状态
containsMipmaps: 布尔值,加载的纹理理是否包含mip贴图

GLTextureLoader 从各种资源文件中加载纹理

初始化
-initWithSharegroup: 初始化⼀一个新的纹理加载到对象中
-initWithShareContext: 初始化⼀一个新的纹理加载对象
从文件中加载处理
+textureWithContentsOfFile:options:errer:从文件加载2D纹理图像并从数据中
创建新的纹理
-textureWithContentsOfFile:options:queue:completionHandler: 从⽂件中异步
加载2D纹理图像,并根据数据创建新纹理
从URL加载纹理
-textureWithContentsOfURL:options:error: 从URL 加载2D纹理图像并从数据创
建新纹理
-textureWithContentsOfURL:options:queue:completionHandler: 从URL异步
加载2D纹理图像,并根据数据创建新纹理
从内存中加载创建新纹理
+textureWithContentsOfData:options:errer: 从内存空间加载2D纹理图像,并根
据数据创建新纹理
-textureWithContentsOfData:options:queue:completionHandler:从内存空间
异步加载2D纹理图像,并从数据中创建新纹理
从CGImages创建纹理
-textureWithCGImage:options:error: 从Quartz图像加载2D纹理图像并从数据创
建新纹理
-textureWithCGImage:options:queue:completionHandler: 从Quartz图像异步
加载2D纹理图像,并根据数据创建新纹理
从URL加载多维创建纹理
+cabeMapWithContentsOfURL:options:errer: 从单个URL加载⽴方体贴图纹理
图像,并根据数据创建新纹理
-cabeMapWithContentsOfURL:options:queue:completionHandler:从单个
URL异步加载立方体贴图纹理图像,并根据数据创建新纹理
+cubeMapWithContentsOfFiles:options:errer: 从一系列文件中加载⽴方体贴图纹理图像,并从数据总创建新纹理
-cubeMapWithContentsOfFiles:options:options:queue:completionHandler:
从⼀系列文件异步加载⽴方体贴图纹理图像,并从数据中创建新纹理

GLKViewController

获取有关View 更新信息
frameDisplayed 视图控制器自创建以来发送的帧更新数
timeSinceFirstResume 自视图控制器第一次恢复发送更新事件以来经过的时间量
timeSinceLastResume ⾃上次视图控制器恢复发送更新事件以来更新的时间量
timeSinceLastUpdate ⾃上次视图控制器调用委托方法以及经过的时间量
timeSinceLastDraw 自上次视图控制器调⽤视图display 方法以来经过的时间量
处理理更新事件
-glkViewControllerUpdate: 在显示每个帧之前调⽤
暂停/恢复通知
-glkViewController:willPause: 在渲染循环暂停或恢复之前调⽤

GLKBaseEffect

一种简单光照/着色系统,用于基于着⾊器OpenGL 渲染

命名Effect
label 给Effect(效果)命名
配置模型视图转换
transform 绑定效果时应⽤于顶点数据的模型视图,投影和纹理变换
配置光照效果
LightingType ⽤于计算每个片段的光照策略,GLKLightingType
GLKLightingTypePerVertex 表示在三⻆形中每个顶点执⾏光照计算,然后在三角形进⾏插值
GLKLightingTypePerPixel 表示光照计算的输⼊在三⻆形内插⼊,并且在每个片段执行光照计算
配置光照
lightModelTwoSided 布尔值,表示为基元的两侧计算光照
material 计算渲染图元光照使⽤的材质属性
lightModelAmbientColor 环境颜色,应用效果渲染的所有图元
light0 场景中第⼀个光照属性
light1 场景中第二个光照属性
light2 场景中第三个光照属性
配置纹理
texture2d0 第⼀个纹理属性
texture2d1 第二个纹理属性
textureOrder 纹理应⽤于渲染图元的顺序
配置雾化
fog 应⽤于场景的雾属性
配置颜色信息
colorMaterialEnable 布尔值,表示计算光照与材质交互时是否使⽤颜色顶点属性
useConstantColor 布尔值,指示是否使用常量颜色
constantColor 不提供每个顶点颜色数据时使用常量颜⾊
准备绘制效果
-prepareToDraw 准备渲染效果