Template:3D-model

From Droid Reference Library
Jump to navigation Jump to search
Documentation icon Template documentation[view] [edit] [history] [purge]

<phptag>if (isset($argv[1])) {echo '{{', str_replace('/doc', , $argv[1]), '|width=0|height=0}}';}</phptag>

Template for placing interactive 3d model on pages. Acceptable models formats are json, buff, obj, stl. Based on THREE.js v73 and Blender.

Available parameters:

width - width of drawing area (canvas) in pixels. When set to "0", size is determined automatically. Default value - "200".
height - height of drawing area in pixels. When set to "0", size is determined automatically. Default value - "200".
color - color of model in hex format, 0xffffff. Default value - "0xff00ff".
opacity - decimal from 0.0 - full transparent to 1.0 - full opaque. Default value - "0.8".
norotate - disables automatic model rotation if value is not empty. Use it for high polygonal models which consumes too much browser resources. Default value - "0".
scale - model scale relative to drawing area size, in percent. Default value - "100"
z - model z coordinate, a lift height over a grid, in pixel. Default value - "75"
style - CSS style of drawing area. Default value - "".
class - HTML class of drawing area. Default value - "".
description - displays under model, by default is a link to model page. If value is set to "-", then description hides.


Model control:

←↑→↓ keys - rotating models.
Double click, double tap - pause/play model rotation.
Enter, Space keys - pause/play models rotation from all page.
- and + keys - decreasing/increasing rotation speed.
Home key - reset rotation angles to default values.
Swipe, left mouse key hold and move - camera rotation.
Right key hold and move - camera pan.
Mouse wheel, hold wheel and move, pinch - zoom in/out.

It is recommended to make experiments in your own personal space, to avoid damaging of pages using this template.