0.0.10 • Published 2 years ago

@elzone/vue-3d-model-extend v0.0.10

Weekly downloads
-
License
-
Repository
-
Last release
2 years ago

vue-3d-model-extend

a fork from vue-3d-model

vue.js 3D model viewer component, based on threejs, inspired by model-tag

Install

using npm

npm install @elzone/vue-3d-model-extend --save

Or using script tag for global use

<script src="https://unpkg.com/@elzone/vue-3d-model-extend/dist/vue-3d-model-extend.umd.js"></script>

Or Download @elzone/vue-3d-model-extend.js and include it in your html

Usage

<template>
  <model-obj src="example/models/obj/LeePerrySmith.obj"></model-obj>
</template>
<script>
import { ModelObj } from 'vue-3d-model-extend';
export default {
  components: { ModelObj }
}
</script>

Or

<!DOCTYPE html>
<html>
<head>
 <meta charset="UTF-8"></head>
<body>
  <div id="app">
    <model-obj src="example/models/obj/LeePerrySmith.obj"></model-obj>
  </div>
<script src="vue.js"></script>
<script src="vue-3d-model-extend.umd.js"></script>
<script>
  new Vue({ el: '#app' });
</script>
</body>

in some cases (if project has been created without vue-cli) please try to include link to lib into webpack babel-loader section, like:

{
    test: /\.js$/,
    loader: 'babel-loader',
    include: [resolve('src'), resolve('test'), resolve('node_modules/@elzone/vue-3d-model-extend/dist')]
}

Documents

props

proptypedefaultexample
srcstring-'./exapmle.obj'
widthnumber-300
heightnumber-300
positionobject{ x: 0, y: 0, z: 0 }{ x: 100, y: 20, z: -10 }
rotationobject{ x: 0, y: 0, z: 0 }{ x: Math.PI / 2, y: 0, z: - Math.PI / 4 }
cameraPositionobject{ x: 0, y: 0, z: 0 }{ x: 1, y: 2, z: -3 }
cameraRotationobject{ x: 0, y: 0, z: 0 }{ x: 3, y: 2, z: -1 }
cameraQuaternionobject{ x: 0, y: 0, z: 0, w: 0 }{ x: 2, y: 3, z: 0, w: -0.4 }
scaleobject{ x: 1, y: 1, z: 1 }{ x: 2, y: 2, z: 3 }
lightsarray-
backgroundColornumber/string0xffffff0xffffff/'#f00'/'rgb(255,255,255)'
backgroundAlphanumber10.5
controlsOptionsobject-see OrbitControls Properties
crossOriginstringanonymousanonymous/use-credentials
requestHeaderobject-{ 'Authorization: Bearer token' }
outputEncodingnumberTHREE.LinearEncodingsee WebGLRenderer OutputEncoding
glOptionsobject{ antialias: true, alpha: true }see WebGLRenderer Parameters

events

event
on-mousedown
on-mousemove
on-mouseup
on-wheel
on-click
on-load
on-progress
on-error

Model Format Support

model formatcomponent tag
obj\
json\
stl\
dae\
ply\
fbx\
gltf(2.0)\

Browser Support

Modern browsers and IE 11.

You can click on this for more information.

TODO List

  • Support for more model formats
  • Animation
  • Post-processing

LICENSE

MIT

0.0.10

2 years ago

0.0.9

2 years ago

0.0.8

2 years ago

0.0.7

2 years ago

0.0.6

2 years ago

0.0.5

2 years ago

0.0.4

2 years ago