huxingyi/dust3d

Dust3D is a cross-platform 3D modeling software that makes it easy to create 3D models for video games, 3D printing, and more. It features built-in rigging, procedural animation and UV unwrapping, with export to GLB and FBX formats.

For more information, visit dust3d.org.

These instructions will get you a copy of Dust3D up and running on your local machine for development and testing purposes.

• Qt 6 (recommended) or Qt 5, with the following modules: qtbase, qtsvg, qtmultimedia
• C++ compiler with C++17 support

1. Download and install the Qt Online Installer
2. Run the installer and choose the Qt 6 archives you want to install (required: qtbase, qtsvg, qtmultimedia)
3. Install Visual Studio 2022

1. Install Qt via Homebrew: brew install qt
2. Install Xcode Command Line Tools: xcode-select --install

1. Install Qt 6 using your distribution's package manager:
   • Ubuntu/Debian: sudo apt install qt6-base-dev qt6-svg-dev qt6-multimedia-dev libgl-dev
   • Fedora: sudo dnf install qt6-qtbase-devel qt6-qtsvg-devel qt6-qtmultimedia-devel

1. Clone the repository

git clone https://github.com/huxingyi/dust3d.git

1. Build using qmake

1. Open the Qt Creator IDE
2. Select "Open Project" from the File menu
3. Navigate to the project directory dust3d/application and open the .pro file
4. Select the desired build configuration (e.g. Debug or Release) from the dropdown menu at the bottom left of the window
5. Click the "Run" button to build and run the project

1. Change to the project directory dust3d/application
2. Run qmake to generate a Makefile
3. Build the project using make

1. Make sure all changes are merged to master branch including CHANGELOGS update
2. Run git tag <version> (e.g. git tag 1.1.0)
3. Run git push origin <version>
4. Wait for Actions/release to finish and download all the Artifacts
5. Go to Tags/<version> and create release from tag
6. Title the release as <version>
7. Copy description from CHANGELOGS
8. Drag the Artifacts to binaries: Dust3D-win32-x86_64.zip, Dust3D-x86_64.AppImage, Dust3D.dmg
9. Publish release

Dust3D is licensed under the MIT License - see the LICENSE file for details.