如何获取和编译 sjgui 的源代码?

sjgui 的源代码可以从 SourceForge.net 获取,安装步骤写在发行包附带的 INSTALL 文件里。编译前需要先确认平台:在非 Windows 系统上编译需要 glut,Windows 用户可以不依赖 glut 完成编译。

获取源代码

根据 sjgui version 1.0 页面的说明,源代码托管在 SourceForge.net 上。访问项目页面后,从文件发布区下载发行包,解压后即可看到源码和随包的 INSTALL 文件。

编译前的环境准备

平台 是否需要 glut 说明
Windows 否 Windows 用户可以不依赖 glut 编译
非 Windows 系统 是 开箱即用的编译需要 glut

也就是说,如果你在 Linux 等非 Windows 平台上编译,需要先准备好 glut 环境;Windows 下则没有这个强制要求。

编译与安装步骤

  1. 下载并解压发行包。
  2. 打开包内的 INSTALL 文件,按其中描述的安装流程操作。
  3. 根据所在平台确认 glut 是否就绪(非 Windows 系统需要)。
  4. 执行编译,得到 sjgui 库。

INSTALL 文件是这一环节的权威依据,具体命令以文件内容为准。

开始使用:先看文档和课程

页面提到,快速上手可以查看文档页面(documentation page)。项目还提供了一组课程(Lesson),针对不同起点的人:

  • 如果你刚开始接触 OpenGL,想找一个合适的起步方式,可以从 Lesson 1 开始。
  • 如果你已经有正在运行的程序,只是“需要一个按钮”,可以直接看 Lesson 8,了解把 sjgui 接进现有代码需要做哪些改动,然后再看其余课程了解“是什么”和“怎么做”,不需要从 Lesson 1 看起。

常见卡点

  • 非 Windows 平台编译失败:优先检查 glut 是否安装并可被编译器找到,这是该平台开箱编译的前提。
  • 不确定要改多少现有代码:页面明确说明,为了在屏幕上加一个按钮,需要做的改动很少,不必大改现有代码;具体改动点参考 Lesson 8。
  • 找不到安装说明:安装流程不在网页上,而在发行包自带的 INSTALL 文件里,下载后解压即可看到。

这个项目当前的状态

页面 News 显示,网页创建于 2003 年 6 月 12 日。作者在说明中解释了自己为什么没有使用 Glow 而是另写一套:主要原因是他不希望 GUI 过度依赖 glut,因为当时 glut 和 glow 都已很久没有更新。如果你在意依赖关系和长期维护状态,这一点值得纳入考虑。

sjgui.sourceforge.net