Extension:3DAlloy

MediaWiki 拡張機能マニュアル

3DAlloy リリースの状態: 安定
実装	Parser function, Tag, ContentHandler, Link markup
説明	Adds support of 3D files viewing at your MediaWiki
作者	Dolfinus
最新バージョン	1.0 (2017-02-05)
MediaWiki	1.25+
データベースの変更	いいえ
ライセンス	MIT License
ダウンロード	Download snapshot GitHub: プロジェクトのページ git リポジトリの URL [ヘルプ] コミット履歴 注: 地域化の更新は translatewiki.net からは提供されません。 README
例	Example of 3D Viewer at file page
パラメーター $wg3DAlloy
タグ <3d>
使用するフック ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay
translatewiki.net で翻訳を利用できる場合は、3DAlloy 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。

説明

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.