4d8a9c273a | ||
---|---|---|
.github/ISSUE_TEMPLATE | ||
backup | ||
dist | ||
src | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
README.md | ||
_config.yml | ||
herosaver-autoloader.user.js | ||
herosaver.js | ||
package-lock.json | ||
package.json | ||
rollup.config.js |
README.md
Herosaver
Methodology to Save Configuration and STLs from websites using the THREE.JS framework for academic and educational purposes.
Please Always think about the developers of such websites and try to support them whenever possible, as without them, there would be no such tools.
Usage
Browser Console
- Go to the intended website
- Open the Javascript Console [F12], then click on Console
- Paste the following
var xhr=new XMLHttpRequest;xhr.open("get","https://raw.githubusercontent.com/hero-saver/threejs/master/dist/saver.min.js",true);xhr.onreadystatechange=function(){if(xhr.readyState==4){var script=document.createElement("script");script.type="text/javascript";script.text=xhr.responseText;document.body.appendChild(script)}};xhr.send(null);
Loading via Greecemonkey or other script loader
This method should automatically load the script on page load.
- Install Greasemonkey Browser Addon (or alternative)
- Click here to install, Link to repository: herosaver-autoloader.user.js
- The install window should pop up, check "Open editor after install completes" if you want to add domains, then click install.
- If it doesn't pop up an install window, either Greasemonkey isn't installed or another problem has occured, you can try adding the script manually.
User Guide
Buttons
- STL - Exports the current model and downloads a STL of it.
- OBJ - Exports the current model and downloads a OBJ of it.
Options
- Quality - Number of loop subdivision passes for the model.
Dropdown Menu Items
- Save - Exports the current model settings in a JSON format.
- Load - Imports a previously exported JSON file with model settings.
Limitations
- This is a collaborative effort by people of the community, so the output is not perfect.
- If you want higher quality exports, consider purchasing the stl files or help work on the code :)
- The outputted file is not a solid object, but a set of objects which is fine for some uses, but can be problimatic if you want to print the 3D object. You will probabily need to combine these into a solid ojbect, Consider using Meshmixer (or equvilient) to produce a printable output, some guides below.
3D Printing Guides
For some guides look at:
- Youtube - Master Miniatures with Meshmixer Supports
- Youtube - How to create custom supports in Meshmixer
- Reddit - Cheatsheet on Printing and Painting Miniatures
- Reddit - A detailed guide to printing your minis
Contributing
Installing minifyer
- Install NPM
- Clone the repository
- Navigate to the repository in your console
- Install rollup using:
npm install rollup
Minifying
- Navigate to the repository in your console
- Build the minified version using:
npm run build
Bugs
Current bugs, open to solutions/suggestions
- Shaders are not included, causing a more 'blocky' output, work on the THREE.js section is needed for this.
Future work
Current things to work on, open to solutions/suggestions
- Empty?
Done
Finished work
- Rotation is off by 90 degrees, simple fix
- The buttons for enlarge and reset scale are a quick and ugly method, needs reworking to not affect the scale in brower if possible, if not, automatically change scale when downloading and resetting scale when downloaded. My lack of THREE.js experience means I am unsure how to do the latter.
Fixed bugs
- Reset Scale Button doesnt work first press, need a second refresh to work.
- Autoloader.js doesnt work when page is reloaded, only on first page load.
- Some Geometry like facial experessions are not implemented, need to work on the THREE.js section.