GLView 项目技术文档

1. 安装指南

1.1 项目简介

GLView 是一个为 iOS 应用提供 OpenGL 功能的类集合，旨在简化在 iOS 应用中使用 OpenGL 的过程。它包括多个模块，如图像加载与显示、3D 模型加载与显示等，用户可以根据需求选择性地使用这些模块。

1.2 支持的系统与 SDK 版本

• 支持的构建目标：iOS 9.3 (Xcode 7.3, Apple LLVM compiler 7.0)
• 最早支持的部署目标：iOS 7.0
• 最早兼容的部署目标：iOS 6.0

1.3 ARC 兼容性

从版本 1.5 开始，GLView 需要 ARC 支持。如果项目未启用 ARC，可以通过添加 -fobjc-arc 编译器标志来启用 ARC。

1.4 安装步骤

1. 将 GLView 的类文件拖入项目中。
2. 添加 QuartzCore 和 OpenGLES 框架。
3. 如果使用可选的 GZIP 库，还需添加 libz.dylib。

2. 项目的使用说明

2.1 模块化设计

GLView 是模块化的，用户可以根据需求选择性地使用以下模块：

• 图像模块：包括 GLImage 和 GLImageView，用于加载和显示 PVR 格式的图像和视频。
• 模型模块：包括 GLModel 和 GLModelView，用于加载和显示 3D 模型（目前支持 WaveFront .obj 格式）。

2.2 使用示例

• 图像显示：使用 GLImageView 可以轻松加载和显示 PVR 格式的图像，无需了解 OpenGL。
• 3D 模型显示：使用 GLModelView 可以加载和显示 3D 模型，同样无需了解 OpenGL。

3. 项目 API 使用文档

3.1 GLView 类

• setUp 方法：初始化视图时调用，用户可以在子类中重写此方法进行自定义设置。
• display 方法：手动调用以立即更新视图内容。
• drawRect: 方法：用于自定义 OpenGL 渲染逻辑。
• bindFramebuffer 方法：绑定帧缓冲区以准备绘图。
• presentRenderbuffer 方法：更新视图并显示绘图结果。

3.2 GLImage 类

• size 属性：图像的尺寸。
• scale 属性：图像的缩放比例。
• texture 属性：图像的 OpenGL 纹理 ID。
• textureSize 属性：纹理的尺寸。

3.3 GLModel 类

• loadModel: 方法：加载 3D 模型文件。
• render 方法：渲染加载的 3D 模型。

4. 项目安装方式

4.1 手动安装

1. 下载 GLView 项目文件。
2. 将类文件拖入 Xcode 项目中。
3. 添加所需的框架：QuartzCore 和 OpenGLES。
4. 如果使用 GZIP 库，还需添加 libz.dylib。

4.2 使用 CocoaPods（可选）

如果项目使用 CocoaPods，可以在 Podfile 中添加以下内容：

pod 'GLView', '~> 1.5'

然后运行 pod install 进行安装。

5. 注意事项

• 该项目已弃用，不再接收更新或修复。建议迁移到其他解决方案。
• 如果项目未启用 ARC，需手动添加 -fobjc-arc 编译器标志。

通过以上文档，用户可以了解 GLView 项目的安装、使用及 API 调用方法，帮助用户更好地在 iOS 应用中集成 OpenGL 功能。