1
0
mirror of https://github.com/omrips/viewstl synced 2026-01-02 20:29:58 +03:00
Files
viewstl/README.md
2021-08-07 11:31:29 +03:00

42 lines
1.1 KiB
Markdown

# Viewstl
Javascript STL/OBJ 3D files Viewer
Reads binary/ASCII STL files; OBJ files
Uses THREE.js lib - Can load THREE.js lib files in the background (no need to deal with THREE JS at all)
Usage:
================
At the html page header / page body:
```
<script src="stl_viewer.min.js"></script>
```
At the page body, create an element to contain the Stl Viewer, and give it an ID:
```
<div id="stl_cont"></div>
```
Create a new instance of Stl Viewer (simplest initiation - read and view STL file called 'mystl.stl'):
```
var stl_viewer=new StlViewer(document.getElementById("stl_cont"), { models: [ {id:0, filename:"mystl.stl"} ] });
```
Dependency on JSZip library:
============================
When dealing with 3mf/vsb files you must use JSZip library - https://stuk.github.io/jszip/
- this library is not included here, you must upload it to your server and supply jszip_path and jszip_utils_path parameters:
```
var stl_viewer=new StlViewer
(
document.getElementById("stl_cont"),
{
....
jszip_path:"/<path_to_jszip>/jszip.min.js",
jszip_utils_path:"/<path_to_jszip>/jszip-utils.min.js"
}
);
```
more at https://www.viewstl.com/plugin/