1
0
mirror of https://github.com/troisjs/trois.git synced 2024-11-24 04:12:02 +08:00
trois/README.md
2020-09-17 23:11:46 +02:00

107 lines
2.6 KiB
Markdown

# ✨ VueJS 3 + ViteJS + ThreeJS ⚡
I wanted to try to write a lib similar to [react-three-fiber](https://github.com/react-spring/react-three-fiber) but for VueJS.
<p>
<img src="/screenshots/troisjs1.jpg" width="40%" />
<img src="/screenshots/troisjs2.jpg" width="40%" />
</p>
Demos : https://troisjs.github.io/trois/
I started from scratch... I don't know if I will have time to maintain this, but feel free to participate :)
I will try to rewrite some of my [WebGL demos](https://codepen.io/collection/AGZywR) to see if this little toy can do the job.
*Trois* is a french word, it means *Three*.
## Features
- [ ] Lights
- [x] AmbientLight
- [x] PointLight
- [x] SpotLight
- [ ] ...
- [ ] Materials
- [x] Basic
- [x] Phong
- [x] Lambert
- [x] Standard
- [x] Sub Surface Scattering
- [ ] ...
- [ ] Geometries
- [x] Box
- [x] Sphere
- [ ] ...
- [ ] Meshes
- [x] Box
- [x] Plane
- [x] Sphere
- [x] Text
- [x] InstancedMesh
- [ ] ...
- [ ] Post Processing
- [x] EffectComposer
- [x] Renderpass
- [x] UnrealBloomPass
- [ ] ...
- [ ] Watch props
- [ ] Improve HMR
## Installation
yarn add troisjs
## PoC
I first made a simple *Proof of Concept*, take a look at [Test1.vue](/src/components/Test1.vue) :
```html
<Renderer ref="renderer">
<Camera :position="{ z: 100 }"></Camera>
<LambertMaterial id="material"></LambertMaterial>
<Scene>
<PointLight :position="{ x: 0, y: 50, z: 50 }"></PointLight>
<Box ref="box" :size="10" :rotation="{ y: Math.PI / 4, z: Math.PI / 4 }" material="material"></Box>
</Scene>
</Renderer>
```
## InstancedMesh
Take a look at [Test2.vue](/src/components/Test2.vue).
### Template
```html
<Renderer ref="renderer" :orbit-ctrl="{ enableDamping: true, dampingFactor: 0.05 }" mouse-move="body" :mouse-raycast="true">
<Camera :position="{ z: 200 }"></Camera>
<StandardMaterial id="material" :transparent="true" :opacity="0.9" :metalness="0.8" :roughness="0.5"></StandardMaterial>
<Scene id="scene1" background="#000000">
<AmbientLight color="#808080"></AmbientLight>
<PointLight color="#ff6000"></PointLight>
<PointLight ref="light" color="#0060ff" :intensity="0.5" :position="{ z: 200 }"></PointLight>
<InstancedMesh ref="imesh" material="material" :count="NUM_INSTANCES">
<BoxGeometry :width="2" :height="2" :depth="10"></BoxGeometry>
</InstancedMesh>
</Scene>
</Renderer>
```
## GLTF
Take a look at [TestGLTF.vue](/src/components/TestGLTF.vue).
```html
<GLTFViewer src="test.glb" :camera-position="{ z: 1 }">
<AmbientLight></AmbientLight>
</GLTFViewer>
```
## Dev
git clone https://github.com/troisjs/trois
cd trois
yarn
yarn dev