Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peteroupc/html3dutil
A public domain JavaScript library to ease developing HTML 3D apps
https://github.com/peteroupc/html3dutil
3d 3d-graphics canvas html html5 javascript public-domain
Last synced: 18 days ago
JSON representation
A public domain JavaScript library to ease developing HTML 3D apps
- Host: GitHub
- URL: https://github.com/peteroupc/html3dutil
- Owner: peteroupc
- License: other
- Created: 2015-03-16T18:31:30.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-05-23T00:33:27.000Z (7 months ago)
- Last Synced: 2024-05-23T01:35:30.162Z (7 months ago)
- Topics: 3d, 3d-graphics, canvas, html, html5, javascript, public-domain
- Language: HTML
- Homepage:
- Size: 8.81 MB
- Stars: 30
- Watchers: 11
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
Geometry Utilities
====
**Download source code: [ZIP file](https://github.com/peteroupc/html3dutil/archive/master.zip)**
----
This is a public-domain library with classes and methods that were formerly in the Public Domain HTML 3D Library. Classes and methods that involved WebGL, shaders, or a 3D scene graph were removed, to make this library much more general-purpose. In any case, maintaining a 3D scene graph, textures, materials, and shaders is not trivial and is better handled by established 3D engines, such as three.js. The classes and methods remaining in this library don't assume the existence of a 3D rendering pipeline such as WebGL or OpenGL ES, or even the existence of an HTML DOM, and are thus more easily portable to other programming languages.
(Speaking of OpenGL ES, there are some things supported by some implementations that are strictly not necessary, since they can be implemented with shaders and clever mesh construction. These things include line primitives, triangle fans, triangle strips, and built-in antialiasing.)
API documentation is found at: [https://peteroupc.github.io/html3dutil](https://peteroupc.github.io/html3dutil)
or [https://github.com/peteroupc/html3dutil/blob/master/doc/index.md](https://github.com/peteroupc/html3dutil/blob/master/doc/index.md).
The file "h3du_min.js" is a minified single-file version of the library. Include it in your HTML
as follows:
```html
```
Source Code and Building
---------
Source code is available in the [project page](https://github.com/peteroupc/html3dutil).
To build, you will need a Java runtime environment and a JavaScript environment
that supports `npm`.
* Put `compiler.jar` (the JAR file for the Closure Compiler) in the `build` directory.
* Install [JSDoc](https://github.com/jsdoc3/jsdoc) and `rollup` via `npm`.
* Run `npm run-script build`. This will generate the documentation and compile
the library's source code into files called `h3du_min.js` and `h3du_module.js`.
Overview and Demos
---------
For detailed instructions on using this library and a summary of the library's features, visit:
[https://peteroupc.github.io/html3dutil/tutorial-overview.html](https://peteroupc.github.io/html3dutil/tutorial-overview.html)
Currently, the demos are not expected to work, since a project is in progress to convert the creation of meshes by this library to three.js.
## History
See [the history page](https://peteroupc.github.io/html3dutil/tutorial-history.html) to find
information about what has changed in this library.
## Possible Later Improvements
- Support "deg", "grad", "rad", and "turn" in CSS color hue parsing
## About
Any copyright to this work is released to the Public Domain.
In case this is not possible, this work is also
licensed under the Unlicense: [https://unlicense.org/](https://unlicense.org/)