# WS1608GUI

**Repository Path**: msrosapple/WS1608GUI

## Basic Information

- **Project Name**: WS1608GUI
- **Description**: 裸金属 OpenGL ES 2.0 GUI (S805 Mali-450)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: v1.2
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WS1608GUI

<p align="center">
  <img src="screenshot_004.bmp" alt="WS1608GUI 运行截图" width="640">
</p>

<p align="center">
  <b>裸金属 OpenGL ES 2.0 GUI</b><br>
  S805 (Cortex-A5) + Mali-450 · 1920×1080 · DRM/GBM/EGL
</p>

<p align="center">
  <a href="#"><img src="https://img.shields.io/badge/C%2B%2B-11-blue.svg" alt="C++11"></a>
  <a href="#"><img src="https://img.shields.io/badge/OpenGL%20ES-2.0-green.svg" alt="OpenGL ES 2.0"></a>
  <a href="#"><img src="https://img.shields.io/badge/ARM-armv7--a-orange.svg" alt="ARM"></a>
  <a href="#"><img src="https://img.shields.io/badge/License-Proprietary-red.svg" alt="License"></a>
</p>

---

**裸金属 OpenGL ES 2.0 GUI** — DRM/GBM/EGL 直接驱动显示

## ✨ 功能特性 (v1.2)
- 🎲 **3D RGB 立方体** — 漫反射+高光+顶点颜色循环
- 🎯 **鼠标追踪** — 立方体始终面向光标，方向性惯量+动态追随
- 💫 **高速甩动自旋** — 方向感知惯性自旋，松手后衰减
- 🧩 **裂变/合并系统** — 静置2秒方块无限分裂（最高2000），移动鼠标漏斗融合归位
- 🔤 **六面标签 A-F** — PNG 精灵文字（背面剔除），对应立方体 ±X/±Y/±Z 六个面
- 🖼️ **PNG 精灵文字引擎** — 替代 stb_truetype，消除管线停顿
- 🔊 **音频系统** — ALSA 混音器 + 4 音效（click/ding/beep/chip）
- ⚡ **CPU 非实例化批处理** — 每帧合并所有方块顶点→单次 draw call（Mali-450 不支持硬 instanced）
- 🔒 **GPU 频率锁定** — sysfs devfreq 锁定 600MHz，消除 DVFS 波动
- 🖱️ **纹理光标** — × 符号，键盘方向键支持，低延迟非阻塞轮询
- 🕐 **实时时间显示** — 屏幕中央 HH:MM:SS
- 📊 **实时 FPS** — 墙钟计时帧率显示
- 📸 **一键截图** — Print Screen 键保存 BMP

## 🚀 快速开始

```bash
make
make install
make run
```

## 🌐 选择语言

| | | |
|---|---|---|
| 🇨🇳 [中文](readme/zh.md) | 🇺🇸 [English](readme/en.md) | 🇯🇵 [日本語](readme/ja.md) |
| 🇰🇷 [한국어](readme/ko.md) | 🇪🇸 [Español](readme/es.md) | 🇫🇷 [Français](readme/fr.md) |
| 🇩🇪 [Deutsch](readme/de.md) | 🇷🇺 [Русский](readme/ru.md) | 🇸🇦 [العربية](readme/ar.md) |
| 🇧🇷 [Português](readme/pt.md) | 🇮🇹 [Italiano](readme/it.md) | 🇳🇱 [Nederlands](readme/nl.md) |
| 🇹🇭 [ไทย](readme/th.md) | 🇻🇳 [Tiếng Việt](readme/vi.md) | 🇹🇷 [Türkçe](readme/tr.md) |
| 🇮🇳 [हिन्दी](readme/hi.md) | | |

---

## 🛠️ 硬件与开发环境

| 项目 | 规格 |
|------|------|
| 目标设备 | WS1608 电视盒子 |
| CPU | Amlogic S805 (Cortex-A5, armv7-a, NEON) |
| GPU | Mali-450 MP2 (Lima 开源驱动) |
| 内存 | 1GB DDR3 |
| 显示 | HDMI 输出 1920×1080 @ 60Hz |
| 目标系统 | Armbian (Debian Bookworm 12, glibc 2.36) |
| 开发主机 | Ubuntu 24.10 (glibc 2.38) |
| 工具链 | `arm-linux-gnueabihf-g++` (GCC 15) |
| 图形栈 | OpenGL ES 2.0 → EGL → GBM → DRM/KMS |
| 构建系统 | GNU Make |

## 📱 关注我们

<p align="center">
  <b>抖音</b> <a href="https://v.douyin.com/Ai7aXGSzgF8/">@DRM-AI
</a> &nbsp;|&nbsp;
  <b>B站</b> <a href="https://space.bilibili.com/236613155">@DRM-AI</a> &nbsp;|&nbsp;
  <b>微信</b> <code>Kunsir1986</code>
</p>

---

## 🤖 AI 辅助声明

本项目的部分代码由 AI 辅助编写（CodeBuddy Deepseek-V4-Flash）。

## 📄 许可证

参见 [LICENSE](LICENSE) 文件。**版权所有，禁止克隆、禁止复刻、禁止商用。**

---

<p align="center">
  <sub>Built with ❤️ for bare-metal embedded systems</sub>
</p>