Skip to content

A GUI application to tune the V-HACD algorithm for a specific 3-D mesh (code has New BSD license)

License

Notifications You must be signed in to change notification settings

stephengold/VhacdTuner

Repository files navigation

Minie Project logo

VhacdTuner is a GUI application to tune the V-HACD algorithm for a specific 3-D mesh.

Complete source code (in Java) is provided under a 3-clause BSD license.

VhacdTuner was designed for a desktop environment with:

  • a wheel mouse and
  • a display at least 640 pixels wide and 700 pixels tall.

Contents of this document

How to build and run VhacdTuner from source

  1. Install a 64-bit Java Development Kit (JDK), if you don't already have one.
  2. Point the JAVA_HOME environment variable to your JDK installation: (In other words, set it to the path of a directory/folder containing a "bin" that contains a Java executable. That path might look something like "C:\Program Files\Eclipse Adoptium\jdk-17.0.3.7-hotspot" or "/usr/lib/jvm/java-17-openjdk-amd64/" or "/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home" .)
  • using Bash or Zsh: export JAVA_HOME=" path to installation "
  • using Fish: set -g JAVA_HOME " path to installation "
  • using Windows Command Prompt: set JAVA_HOME=" path to installation "
  • using PowerShell: $env:JAVA_HOME = ' path to installation '
  1. Download and extract the More Advanced Vehicles source code from GitHub:
  • using Git:
    • git clone https://github.com/stephengold/VhacdTuner.git
    • cd VhacdTuner
  1. Run the Gradle wrapper:
  • using Bash or Fish or PowerShell or Zsh: ./gradlew run
  • using Windows Command Prompt: .\gradlew run

You can restore the project to a pristine state:

  • using Bash or Fish or PowerShell or Zsh: ./gradlew clean
  • using Windows Command Prompt: .\gradlew clean

Jump to the table of contents

Using VhacdTuner

(Documentation not yet written.)

Jump to the table of contents

Conventions

The source code and pre-built executables are compatible with JDK 8.

Jump to the table of contents

External links

YouTube videos about VhacdTuner:

Jump to the table of contents

History

Some of the origial source code was derived from the DacWizard project.

From August 2022 to June 2024, VhacdTuner was a subproject of the Minie Project.

Since June 2024, VhacdTuner has been a separate project, hosted at GitHub.

Jump to the table of contents

Acknowledgments

Like most projects, the VhacdTuner Project builds on the work of many who have gone before. I therefore acknowledge the following artists and software developers:

I am grateful to GitHub, Sonatype, MacStadium, YouTube, and Imgur for providing free hosting for this project and many other open-source projects.

I'm also grateful to my dear Holly, for keeping me sane.

If I've misattributed anything or left anyone out, please let me know, so I can correct the situation: [email protected]

Jump to the table of contents