TGX - 轻量级3D图形库使用指南

TGX - 轻量级3D图形库使用指南

tgx tgx - a tiny/teensy 3D graphics library 项目地址: https://gitcode.com/gh_mirrors/tg/tgx

1. 项目介绍

TGX是一个专为32位微控制器设计的轻量级2D和3D图形库。该库提供了一系列易于使用的类，使得在内存帧缓冲区上绘制2D和3D图形变得简单。尽管它主要针对32位MCU进行优化，但它也是跨平台的，可以在CPU上运行。TGX已经成功在Teensy 3.5、3.6、4.0、4.1，ESP32系列，Raspberry Pico 1/2 (RP2040/RP2350)以及桌面CPU上进行了测试。

项目的主要特性包括：

• 支持多种颜色类型：RGB565、RGB24、RGB32、RGB64、RGBf和HSV。
• 模板Image类，支持创建共享同一缓冲区的子图像（即视图）。
• 与Adafruit GFX和Bodmer TFT_eSPI库兼容的API，但提供更多绘图原语，并且通常更快。
• 支持绘制线条、三角形、矩形、多边形、圆形、椭圆、弧形、饼图、贝塞尔曲线和样条等。
• 支持带有或不带透明蒙版的精灵绘制，支持旋转和缩放。
• 支持图像颜色类型转换和调整大小。
• 所有绘图方法支持透明度。
• 支持抗锯齿方法绘制粗线和圆形。
• 支持Adafruit字体以及PJRC的ILI9341_t3 v1和v2.3抗锯齿字体。
• 提供Python脚本，用于将图像转换为C文件，可以直接导入项目。

2. 项目快速启动

首先，确保你已经安装了必要的开发环境，包括支持C++的开发工具链。

// 例子：在帧缓冲区上绘制一个简单的图形
#include "tgx.h"

using namespace tgx;

int main() {
    // 初始化图形库
    initGraphics();

    // 创建一个帧缓冲区
    Image buffer(240, 320, RGB565);

    // 绘制一个填充的矩形
    buffer.fillRect(10, 10, 100, 100, RGB565(255, 0, 0));

    // 显示帧缓冲区（这部分取决于你的硬件和显示驱动）
    display(buffer);

    return 0;
}

请根据你的硬件和显示驱动，适当修改display(buffer);函数。

3. 应用案例和最佳实践

以下是一些使用TGX库的应用案例和最佳实践：

• 2D游戏开发：利用TGX的2D图形绘制功能，可以轻松实现游戏中的精灵渲染、动画以及用户界面。
• 3D模型渲染：TGX支持3D图形的基本绘制，包括三角形光栅化、深度缓冲测试和纹理映射，适合渲染简单的3D模型。
• 图像处理：TGX的图像处理功能可以用于实时图像效果处理，如图像转换、颜色调整和图像缩放。

最佳实践建议：

• 在性能敏感的应用中，使用适当级别的子像素精度来优化三角形光栅化。
• 利用TGX提供的数学模板类来简化3D数学计算。

4. 典型生态项目

TGX作为一个轻量级的图形库，可以与以下生态项目结合使用：

• OpenFontRender：用于绘制TrueType字体。
• PNGdec：用于绘制PNG图像。
• JPEGDEC：用于绘制JPEG图像。
• AnimateGIF：用于绘制GIF动画。

这些项目的结合使用，可以极大地扩展TGX库的功能和应用范围。

tgx tgx - a tiny/teensy 3D graphics library 项目地址: https://gitcode.com/gh_mirrors/tg/tgx