Difference between revisions of "3D Objects Help"
Jump to navigation
Jump to search
Joelmartin (talk | contribs) |
Joelmartin (talk | contribs) m (→As Parser tag) |
||
| (9 intermediate revisions by the same user not shown) | |||
| Line 16: | Line 16: | ||
* .stlb | * .stlb | ||
| − | == Usage == | + | == Usage == |
=== As Image Handler === | === As Image Handler === | ||
| Line 41: | Line 41: | ||
<3d width="" height="" ... >Model.json</3d> | <3d width="" height="" ... >Model.json</3d> | ||
</pre> | </pre> | ||
| − | You also can use url instead of short filename. | + | You also can use url instead of short filename.<br> |
| + | <3d width="100" height="100" norotate="true" color="aabbff">Star.stl</3d> | ||
| + | |||
== Parameters == | == Parameters == | ||
{|class="wikitable" | {|class="wikitable" | ||
| Line 94: | Line 96: | ||
|wipe, left mouse key hold and move | |wipe, left mouse key hold and move | ||
|- | |- | ||
| − | |Camera pan | + | |Camera pan |
| − | |Right key hold and move | + | |Right key hold and move |
|- | |- | ||
| − | |Camera zoom | + | |Camera zoom |
| Mouse wheel, hold wheel and move, pinch | | Mouse wheel, hold wheel and move, pinch | ||
|- | |- | ||
Latest revision as of 19:56, 3 October 2020
Description
This wiki includes an extension which allows to add 3D models viewer to site pages.
Supported file extensions
THREE.js model format
- .json
- .3djson
- .3dj * .three
THREE.js model buffer geometry format
- .buff
- .buffjson
OBJ file format
- .obj
STL (binary) file format
- .stl
- .stlb
Usage
As Image Handler
[[File:Model.json|300x300px|color=,opacity=,...]]
As Parser function
{{#3d:Model.json}}
{{#3d:Model.json|width}}
{{#3d:Model.json|width|height}}
...
{{#3d:Model.json|width|height|color|opacity|norotate|scale|z|style|class}}
Instead of uploaded filename you can use an url for file located in external site.
As Parser tag
<3d file="Model.json" width="" height="" ... ></3d> or <3d width="" height="" ... >Model.json</3d>
You also can use url instead of short filename.
Parameters
| Name | Description | Default value |
|---|---|---|
| width | Canvas width in pixels | 300 |
| height | Canvas height in pixels | 300 |
| color | Model RGB color as hex | 0xff00ff |
| opacity | Model opacity as decimal between 0...1 | 0.8 |
| norotate | If true or 1, model does not rotate | false |
| scale | Model scale, in percent | 100 |
| z | Model z coordinate | 75 |
| style | Additional canvas CSS style | |
| class | Additional canvas HTML class |
Width and height can be set to 0 value, so size of viewer will be set according to user screen dimensions.
Controls and hotkeys
| Action | Controls |
|---|---|
| Camera rotate | wipe, left mouse key hold and move |
| Camera pan | Right key hold and move |
| Camera zoom | Mouse wheel, hold wheel and move, pinch |
| Model rotate | ←↑→↓ keys |
| Model rotation reset | Home key |
| Model rotation play/pause | <Double click, double tap |
| Model rotation play/pause all models at page | Enter, Space keys |
| Model rotation speed | - and + keys |
Hotkeys automatically disables while you edit or submit wiki page.