AwesomeBump 项目安装与使用教程

AwesomeBump 项目安装与使用教程

AwesomeBump AwesomeBump is a free program written using Qt library designed to generate normal, height, specular or ambient occlusion textures from a single image. Since the image processing is done in 99% on GPU the program runs very fast and all the parameters can be changed in real time. AB was made to be a new alternative to known gimp plugin called Insane Bump. 项目地址: https://gitcode.com/gh_mirrors/aw/AwesomeBump

1. 项目目录结构及介绍

AwesomeBump 项目的目录结构如下：

AwesomeBump/
├── Bin/
├── Sources/
│   ├── cmake/
│   ├── gitignore
│   ├── gitmodules
│   ├── qmake.conf
│   ├── AwesomeBump.pro
│   ├── BuildingInstruction.pdf
│   ├── CHANGELOG.md
│   ├── CMakeLists.txt
│   ├── LICENSE.LESSER.txt
│   ├── LICENSE.txt
│   ├── README.md
│   ├── ShortAbout.pdf
│   ├── unixBuildScript.sh
│   └── ...
└── ...

目录介绍

• Bin/: 存放编译后的可执行文件。
• Sources/: 项目的主要源代码目录。
  • cmake/: CMake 构建脚本和配置文件。
  • gitignore: Git 忽略文件配置。
  • gitmodules: Git 子模块配置。
  • qmake.conf: qmake 配置文件。
  • AwesomeBump.pro: Qt 项目文件，用于项目构建。
  • BuildingInstruction.pdf: 构建项目的详细说明文档。
  • CHANGELOG.md: 项目更新日志。
  • CMakeLists.txt: CMake 构建脚本。
  • LICENSE.LESSER.txt: LGPL 许可证文件。
  • LICENSE.txt: 项目许可证文件。
  • README.md: 项目介绍和使用说明。
  • ShortAbout.pdf: 项目简要介绍文档。
  • unixBuildScript.sh: Unix 系统下的自动化构建脚本。

2. 项目启动文件介绍

项目的启动文件是 AwesomeBump.pro，这是一个 Qt 项目文件，用于配置和构建项目。通过 Qt Creator 打开此文件，可以进行项目的编译和运行。

启动步骤

1. 打开 Qt Creator。
2. 选择 File -> Open File or Project。
3. 导航到 AwesomeBump 目录，选择 AwesomeBump.pro 文件。
4. 配置构建路径和运行路径。
5. 点击 Build 按钮进行编译。
6. 编译完成后，点击 Run 按钮启动程序。

3. 项目的配置文件介绍

qmake.conf

qmake.conf 文件是 qmake 的配置文件，用于指定编译器和构建选项。通常不需要手动修改此文件，除非需要自定义编译选项。

CMakeLists.txt

CMakeLists.txt 是 CMake 的构建脚本，用于配置项目的构建过程。可以通过修改此文件来调整项目的构建配置，例如添加或删除源文件、设置编译选项等。

unixBuildScript.sh

unixBuildScript.sh 是一个 Unix 系统下的自动化构建脚本。通过运行此脚本，可以自动完成项目的编译和运行。

使用方法

1. 打开终端。
2. 导航到 AwesomeBump 目录。
3. 运行脚本：sh unixBuildScript.sh。
4. 脚本执行完成后，可以在 Bin/ 目录下找到编译后的可执行文件。

通过以上步骤，您可以顺利安装和使用 AwesomeBump 项目。

AwesomeBump AwesomeBump is a free program written using Qt library designed to generate normal, height, specular or ambient occlusion textures from a single image. Since the image processing is done in 99% on GPU the program runs very fast and all the parameters can be changed in real time. AB was made to be a new alternative to known gimp plugin called Insane Bump. 项目地址: https://gitcode.com/gh_mirrors/aw/AwesomeBump