Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stephengold/vhacdtuner
A GUI application to tune the V-HACD algorithm for a specific 3-D mesh (code has New BSD license)
https://github.com/stephengold/vhacdtuner
3d-graphics 3d-mesh application convex-decomposition java java-application jme3 jmonkeyengine jmonkeyengine3 nifty-gui open-source vhacd
Last synced: 19 days ago
JSON representation
A GUI application to tune the V-HACD algorithm for a specific 3-D mesh (code has New BSD license)
- Host: GitHub
- URL: https://github.com/stephengold/vhacdtuner
- Owner: stephengold
- License: other
- Created: 2024-06-08T20:08:59.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-11-23T20:06:34.000Z (29 days ago)
- Last Synced: 2024-11-23T21:18:41.440Z (29 days ago)
- Topics: 3d-graphics, 3d-mesh, application, convex-decomposition, java, java-application, jme3, jmonkeyengine, jmonkeyengine3, nifty-gui, open-source, vhacd
- Language: Java
- Homepage:
- Size: 204 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[VhacdTuner][project] is a GUI application
to tune [the V-HACD algorithm][vhacd] for a specific 3-D mesh.
Complete source code (in Java) is provided under
[a 3-clause BSD license][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](#build)
+ [Using VhacdTuner](#use)
+ [Conventions](#conventions)
+ [External links](#links)
+ [History](#history)
+ [Acknowledgments](#acks)
## How to build and run VhacdTuner from source
1. Install a 64-bit [Java Development Kit (JDK)][adoptium],
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* `'`
3. Download and extract the More Advanced Vehicles source code from GitHub:
+ using [Git]:
+ `git clone https://github.com/stephengold/VhacdTuner.git`
+ `cd VhacdTuner`
4. 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](#toc)
## Using VhacdTuner
(Documentation not yet written.)
[Jump to the table of contents](#toc)
## Conventions
The source code and pre-built executables are compatible with JDK 8.
[Jump to the table of contents](#toc)
## External links
+ [V-HACD v4 slideshow](https://docs.google.com/presentation/d/1OZ4mtZYrGEC8qffqb8F7Le2xzufiqvaPpRbLHKKgTIM)
YouTube videos about VhacdTuner:
+ August 2022 walkthru of the VhacdTuner application
[watch](https://www.youtube.com/watch?v=iEWJtPujmM8) (7:45)
[source code](https://github.com/stephengold/Minie/blob/e1b7781fd06d8060ab96928379509a732fd9398f/VhacdTuner/src/main/java/jme3utilities/minie/tuner/VhacdTuner.java)
[Jump to the table of contents](#toc)
## History
Some of the origial source code
was derived from [the DacWizard project][dacwizard].
From August 2022 to June 2024, VhacdTuner was a subproject of
[the Minie Project][minie].
Since June 2024, VhacdTuner has been a separate project, hosted at
[GitHub][project].
[Jump to the table of contents](#toc)
## 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:
+ Khaled Mamou for creating and licensing the [V-HACD Library][vhacd]
for decomposing meshes into convex hulls
+ Riccardo Balbo (aka "riccardo") for creating and licensing
the [V-HACD Java Bindings Project][vhacdBindings]
+ plus the creators of (and contributors to) the following software:
+ the [Checkstyle] tool
+ the [Firefox] web browser
+ the [Git] revision-control system and GitK commit viewer
+ the [GitKraken] client
+ the [Gradle] build tool
+ the [IntelliJ IDEA][idea] and [NetBeans] integrated development environments
+ the [Java] compiler, standard doclet, and runtime environment
+ [jMonkeyEngine][jme] and the jME3 Software Development Kit
+ the [Linux Mint][mint] operating system
+ LWJGL, the Lightweight Java Game Library
+ the [Markdown] document-conversion tool
+ the [Meld] visual merge tool
+ Microsoft Windows
+ the [Nifty] graphical user-interface library
+ [Open Broadcaster Software Studio][obs]
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](#toc)
[adoptium]: https://adoptium.net/releases.html "Adoptium Project"
[checkstyle]: https://checkstyle.org "Checkstyle"
[dacwizard]: https://github.com/stephengold/DacWizard "DacWizard Project"
[firefox]: https://www.mozilla.org/en-US/firefox "Firefox"
[fish]: https://fishshell.com/ "Fish command-line shell"
[git]: https://git-scm.com "Git"
[github]: https://github.com "GitHub"
[gitkraken]: https://www.gitkraken.com "GitKraken client"
[gradle]: https://gradle.org "Gradle Project"
[idea]: https://www.jetbrains.com/idea/ "IntelliJ IDEA"
[imgur]: https://imgur.com/ "Imgur"
[java]: https://en.wikipedia.org/wiki/Java_(programming_language) "Java programming language"
[jme]: https://jmonkeyengine.org "jMonkeyEngine Project"
[license]: https://github.com/stephengold/VhacdTuner/blob/master/LICENSE "VhacdTuner license"
[macstadium]: https://www.macstadium.com/ "MacStadium"
[markdown]: https://daringfireball.net/projects/markdown "Markdown Project"
[meld]: https://meldmerge.org "Meld merge tool"
[minie]: https://stephengold.github.io/Minie/minie/overview.html "Minie Project"
[mint]: https://linuxmint.com "Linux Mint Project"
[netbeans]: https://netbeans.org "NetBeans Project"
[nifty]: https://nifty-gui.github.io/nifty-gui "Nifty GUI Project"
[obs]: https://obsproject.com "Open Broadcaster Software Project"
[project]: https://github.com/stephengold/VhacdTuner "VhacdTuner Project"
[sonatype]: https://www.sonatype.com "Sonatype"
[vhacd]: https://github.com/kmammou/v-hacd "V-HACD Library"
[vhacdBindings]: https://github.com/riccardobl/v-hacd-java-bindings "Riccardo's V-hacd-java-bindings Project"
[youtube]: https://www.youtube.com/ "YouTube"