{"id":17250068,"url":"https://github.com/stephengold/vhacdtuner","last_synced_at":"2025-03-26T06:16:32.172Z","repository":{"id":243434445,"uuid":"812409832","full_name":"stephengold/VhacdTuner","owner":"stephengold","description":"A GUI application to tune the V-HACD algorithm for a specific 3-D mesh (code has New BSD license)","archived":false,"fork":false,"pushed_at":"2025-02-27T19:09:37.000Z","size":261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-28T03:38:59.215Z","etag":null,"topics":["3d-graphics","3d-mesh","application","convex-decomposition","java","java-application","jme3","jmonkeyengine","jmonkeyengine3","nifty-gui","open-source","vhacd"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stephengold.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-08T20:08:59.000Z","updated_at":"2025-02-27T19:09:40.000Z","dependencies_parsed_at":"2024-07-12T16:34:47.626Z","dependency_job_id":"9543551c-49a2-430f-ba08-5faf822e1d44","html_url":"https://github.com/stephengold/VhacdTuner","commit_stats":null,"previous_names":["stephengold/vhacdtuner"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2FVhacdTuner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2FVhacdTuner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2FVhacdTuner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2FVhacdTuner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stephengold","download_url":"https://codeload.github.com/stephengold/VhacdTuner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245598314,"owners_count":20641884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-graphics","3d-mesh","application","convex-decomposition","java","java-application","jme3","jmonkeyengine","jmonkeyengine3","nifty-gui","open-source","vhacd"],"created_at":"2024-10-15T06:46:05.333Z","updated_at":"2025-03-26T06:16:32.142Z","avatar_url":"https://github.com/stephengold.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg height=\"150\" src=\"https://i.imgur.com/YEPFEcx.png\" alt=\"Minie Project logo\"\u003e\n\n[VhacdTuner][project] is a GUI application\nto tune [the V-HACD algorithm][vhacd] for a specific 3-D mesh.\n\nComplete source code (in Java) is provided under\n[a 3-clause BSD license][license].\n\nVhacdTuner was designed for a desktop environment with:\n\n + a wheel mouse and\n + a display at least 640 pixels wide and 700 pixels tall.\n\n\n\u003ca name=\"toc\"\u003e\u003c/a\u003e\n\n## Contents of this document\n\n+ [How to build and run VhacdTuner from source](#build)\n+ [Using VhacdTuner](#use)\n+ [Conventions](#conventions)\n+ [External links](#links)\n+ [History](#history)\n+ [Acknowledgments](#acks)\n\n\n\u003ca name=\"build\"\u003e\u003c/a\u003e\n\n## How to build and run VhacdTuner from source\n\n1. Install a 64-bit [Java Development Kit (JDK)][adoptium],\n   if you don't already have one.\n2. Point the `JAVA_HOME` environment variable to your JDK installation:\n   (In other words, set it to the path of a directory/folder\n   containing a \"bin\" that contains a Java executable.\n   That path might look something like\n   \"C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.3.7-hotspot\"\n   or \"/usr/lib/jvm/java-17-openjdk-amd64/\" or\n   \"/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home\" .)\n  + using Bash or Zsh: `export JAVA_HOME=\"` *path to installation* `\"`\n  + using [Fish]: `set -g JAVA_HOME \"` *path to installation* `\"`\n  + using Windows Command Prompt: `set JAVA_HOME=\"` *path to installation* `\"`\n  + using PowerShell: `$env:JAVA_HOME = '` *path to installation* `'`\n3. Download and extract the More Advanced Vehicles source code from GitHub:\n  + using [Git]:\n    + `git clone https://github.com/stephengold/VhacdTuner.git`\n    + `cd VhacdTuner`\n4. Run the [Gradle] wrapper:\n  + using Bash or Fish or PowerShell or Zsh: `./gradlew run`\n  + using Windows Command Prompt: `.\\gradlew run`\n\nYou can restore the project to a pristine state:\n+ using Bash or Fish or PowerShell or Zsh: `./gradlew clean`\n+ using Windows Command Prompt: `.\\gradlew clean`\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"use\"\u003e\u003c/a\u003e\n\n## Using VhacdTuner\n\n(Documentation not yet written.)\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"conventions\"\u003e\u003c/a\u003e\n\n## Conventions\n\nThe source code and pre-built executables are compatible with JDK 8.\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"links\"\u003e\u003c/a\u003e\n\n## External links\n\n+ [V-HACD v4 slideshow](https://docs.google.com/presentation/d/1OZ4mtZYrGEC8qffqb8F7Le2xzufiqvaPpRbLHKKgTIM)\n\nYouTube videos about VhacdTuner:\n\n  + August 2022 walkthru of the VhacdTuner application\n    [watch](https://www.youtube.com/watch?v=iEWJtPujmM8) (7:45)\n    [source code](https://github.com/stephengold/Minie/blob/e1b7781fd06d8060ab96928379509a732fd9398f/VhacdTuner/src/main/java/jme3utilities/minie/tuner/VhacdTuner.java)\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"history\"\u003e\u003c/a\u003e\n\n## History\n\nSome of the origial source code\nwas derived from [the DacWizard project][dacwizard].\n\nFrom August 2022 to June 2024, VhacdTuner was a subproject of\n[the Minie Project][minie].\n\nSince June 2024, VhacdTuner has been a separate project, hosted at\n[GitHub][project].\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"acks\"\u003e\u003c/a\u003e\n\n## Acknowledgments\n\nLike most projects, the VhacdTuner Project builds on the work of many who\nhave gone before.  I therefore acknowledge the following\nartists and software developers:\n\n+ Khaled Mamou for creating and licensing the [V-HACD Library][vhacd]\n  for decomposing meshes into convex hulls\n+ Riccardo Balbo (aka \"riccardo\") for creating and licensing\n  the [V-HACD Java Bindings Project][vhacdBindings]\n+ plus the creators of (and contributors to) the following software:\n    + the [Checkstyle] tool\n    + the [Firefox] web browser\n    + the [Git] revision-control system and GitK commit viewer\n    + the [GitKraken] client\n    + the [Gradle] build tool\n    + the [IntelliJ IDEA][idea] and [NetBeans] integrated development environments\n    + the [Java] compiler, standard doclet, and runtime environment\n    + [jMonkeyEngine][jme] and the jME3 Software Development Kit\n    + the [Linux Mint][mint] operating system\n    + LWJGL, the Lightweight Java Game Library\n    + the [Markdown] document-conversion tool\n    + the [Meld] visual merge tool\n    + Microsoft Windows\n    + the [Nifty] graphical user-interface library\n    + [Open Broadcaster Software Studio][obs]\n\nI am grateful to [GitHub], [Sonatype],\n[MacStadium], [YouTube], and [Imgur]\nfor providing free hosting for this project\nand many other open-source projects.\n\nI'm also grateful to my dear Holly, for keeping me sane.\n\nIf I've misattributed anything or left anyone out, please let me know, so I can\ncorrect the situation: sgold@sonic.net\n\n[Jump to the table of contents](#toc)\n\n\n[adoptium]: https://adoptium.net/releases.html \"Adoptium Project\"\n[checkstyle]: https://checkstyle.org \"Checkstyle\"\n[dacwizard]: https://github.com/stephengold/DacWizard \"DacWizard Project\"\n[firefox]: https://www.mozilla.org/en-US/firefox \"Firefox\"\n[fish]: https://fishshell.com/ \"Fish command-line shell\"\n[git]: https://git-scm.com \"Git\"\n[github]: https://github.com \"GitHub\"\n[gitkraken]: https://www.gitkraken.com \"GitKraken client\"\n[gradle]: https://gradle.org \"Gradle Project\"\n[idea]: https://www.jetbrains.com/idea/ \"IntelliJ IDEA\"\n[imgur]: https://imgur.com/ \"Imgur\"\n[java]: https://en.wikipedia.org/wiki/Java_(programming_language) \"Java programming language\"\n[jme]: https://jmonkeyengine.org \"jMonkeyEngine Project\"\n[license]: https://github.com/stephengold/VhacdTuner/blob/master/LICENSE \"VhacdTuner license\"\n[macstadium]: https://www.macstadium.com/ \"MacStadium\"\n[markdown]: https://daringfireball.net/projects/markdown \"Markdown Project\"\n[meld]: https://meldmerge.org \"Meld merge tool\"\n[minie]: https://stephengold.github.io/Minie/minie/overview.html \"Minie Project\"\n[mint]: https://linuxmint.com \"Linux Mint Project\"\n[netbeans]: https://netbeans.org \"NetBeans Project\"\n[nifty]: https://nifty-gui.github.io/nifty-gui \"Nifty GUI Project\"\n[obs]: https://obsproject.com \"Open Broadcaster Software Project\"\n[project]: https://github.com/stephengold/VhacdTuner \"VhacdTuner Project\"\n[sonatype]: https://www.sonatype.com \"Sonatype\"\n[vhacd]: https://github.com/kmammou/v-hacd \"V-HACD Library\"\n[vhacdBindings]: https://github.com/riccardobl/v-hacd-java-bindings \"Riccardo's V-hacd-java-bindings Project\"\n[youtube]: https://www.youtube.com/ \"YouTube\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephengold%2Fvhacdtuner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstephengold%2Fvhacdtuner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephengold%2Fvhacdtuner/lists"}