Extension:3DAlloy
3DAlloy リリースの状態: 安定 |
|
---|---|
![]() |
|
実装 | パーサー関数 , タグ , ContentHandler , リンク マークアップ |
説明 | Adds support of 3D files viewing at your MediaWiki |
作者 | Dolfinus |
最新バージョン | 1.0 (2017-02-05) |
MediaWiki | 1.25+ |
データベースの変更 | いいえ |
ライセンス | MIT ライセンス |
ダウンロード | master スナップショットをダウンロード 注: README |
例 | Example of 3D Viewer at file page |
$wg3DAlloy |
|
<3d> |
|
説明
MediaWiki extension which allows to add 3D models viewer to site pages. Based on THREE.js, renders image with CanvasRenderer. There you can see example 3D model page.
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
インストール
Download the latest snapshot and extract it to your extensions directory. Then include it in your LocalSettings.php file as in the following example:
wfLoadExtension( '3DAlloy' );
$wgFileExtensions = array_merge(
$wgFileExtensions, array(
'json', '3dj', '3djson', 'three',
'buff', 'buffjson',
'obj',
'stl', 'stlb'
)
);
Then add these lines to the end of your MediaWiki includes/mime.types file:
application/json json 3djson 3dj three buff buffjson application/obj obj application/stl stl stlb
And then to includes/mime.info file:
application/json [TEXT] application/obj [TEXT] application/stl [TEXT]
使用法
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.
パラメーター
名前 | 説明 | 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.
Configure
All default values can be changed in your LocalSettings.php file:
$wg3DAlloy["width"] = 500;
$wg3DAlloy["height"] = 400;
...
$wg3DAlloy["class"] = 'someclass';
Controls and hotkeys
動作 | Controls |
---|---|
Camera rotate | Swipe, 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.
- Stable extensions/ja
- Parser function extensions/ja
- Tag extensions/ja
- ContentHandler extensions/ja
- Link markup extensions/ja
- MIT licensed extensions/ja
- Extensions in GitHub version control/ja
- ParserMakeImageParams extensions/ja
- ParserFirstCallInit extensions/ja
- ImageBeforeProduceHTML extensions/ja
- ImageOpenShowImageInlineBefore extensions/ja
- BeforePageDisplay extensions/ja
- BeforePageDisplayMobile extensions/ja
- All extensions/ja
- 3D extensions/ja