obj2html/README.md

48 lines
1.2 KiB
Markdown
Raw Normal View History

2021-11-13 07:04:00 -07:00
[![pipeline status](https://gitlab.com/nicolalandro/obj2html/badges/main/pipeline.svg)](https://gitlab.com/nicolalandro/obj2html/-/commits/main)
[![coverage report](https://gitlab.com/nicolalandro/obj2html/badges/main/coverage.svg)](https://gitlab.com/nicolalandro/obj2html/-/commits/main)
# Obj2Html
This lib is able to transform an .obj file to HTML that use three.js.
In this way it is possible to have an interactive 3D view that can be used on the browser or into a jupyter notebook.
2021-11-13 06:55:57 -07:00
* run into jupyter notebook
```
!pip install obj2html
from obj2html import obj2html
from IPython.display import display, HTML
obj_path = 'model.obj'
obj2html(obj_path, 'index.html')
display(HTML('index.html'))
```
## Features
2021-11-13 06:57:56 -07:00
2021-11-13 07:00:47 -07:00
- [x] .obj files support
2021-11-13 06:57:56 -07:00
- [ ] pipy delivery
- [ ] guide for notebook
- [ ] edit html positions and other 3D params
- [ ] load three.js as static file
- [ ] .mat files support
2021-11-13 06:55:57 -07:00
# Dev
```
python3.8 -m unittest discover
pip install coverage
python3.8 -m coverage run --source=src -m unittest discover
python3.8 -m coverage report -m
```
# References
In this chapter I add at least a link for each of the knowledge needed for develop this project.
* python
* git
* how to use setup.py
* python test
* coverage
* gitlab ci/cd
* three.js