vitaGL 项目教程

vitaGL 项目教程

vitaGL openGL wrapper for PSVITA. 项目地址: https://gitcode.com/gh_mirrors/vi/vitaGL

1. 项目的目录结构及介绍

vitaGL/
├── include/
│   ├── vitaGL.h
│   └── ...
├── lib/
│   ├── libvitaGL.a
│   └── ...
├── samples/
│   ├── basic/
│   │   ├── basic.c
│   │   └── ...
│   └── ...
├── src/
│   ├── vitaGL.c
│   └── ...
├── Makefile
└── README.md

• include/: 包含项目的头文件，如 vitaGL.h，用于定义 API 接口。
• lib/: 包含编译后的库文件，如 libvitaGL.a，供其他项目链接使用。
• samples/: 包含示例代码，如 basic/basic.c，展示了如何使用 vitaGL 进行基本的图形渲染。
• src/: 包含项目的源代码，如 vitaGL.c，是 vitaGL 的核心实现。
• Makefile: 项目的构建文件，用于编译和生成库文件。
• README.md: 项目的说明文档，包含项目的基本信息和使用指南。

2. 项目的启动文件介绍

项目的启动文件通常是指 samples/basic/basic.c，这是一个简单的示例程序，展示了如何使用 vitaGL 进行基本的图形渲染。以下是 basic.c 的部分代码：

#include <vitaGL.h>

int main() {
    vglInit(0x800000);

    while (1) {
        glClear(GL_COLOR_BUFFER_BIT);
        // 渲染代码
        vglSwapBuffers();
    }

    vglEnd();
    return 0;
}

• vglInit(0x800000): 初始化 vitaGL，参数为显存大小。
• glClear(GL_COLOR_BUFFER_BIT): 清除屏幕颜色缓冲区。
• vglSwapBuffers(): 交换前后缓冲区，显示渲染结果。
• vglEnd(): 结束 vitaGL 的使用。

3. 项目的配置文件介绍

项目的配置文件主要是 Makefile，用于定义项目的编译规则和依赖关系。以下是 Makefile 的部分内容：

CC = arm-vita-eabi-gcc
CFLAGS = -Wl,-q -Wall

all: libvitaGL.a

libvitaGL.a: $(OBJS)
    $(AR) rcs $@ $^

%.o: %.c
    $(CC) $(CFLAGS) -c $< -o $@

clean:
    rm -f $(OBJS) libvitaGL.a

• CC = arm-vita-eabi-gcc: 指定编译器为 arm-vita-eabi-gcc。
• CFLAGS = -Wl,-q -Wall: 指定编译选项，-Wl,-q 用于链接选项，-Wall 用于开启所有警告。
• all: libvitaGL.a: 默认目标为生成 libvitaGL.a 库文件。
• libvitaGL.a: $(OBJS): 定义如何生成 libvitaGL.a，使用 ar 工具将目标文件打包成静态库。
• %.o: %.c: 定义如何编译源文件为目标文件。
• clean: 定义清理目标，删除生成的目标文件和库文件。

vitaGL openGL wrapper for PSVITA. 项目地址: https://gitcode.com/gh_mirrors/vi/vitaGL