Extension:3DAlloy/zh

MediaWiki扩展手册

File:OOjs UI icon advanced-invert.svg 3DAlloy 发行状态： 稳定版
File:3DAlloy.png
实现	解析器函数 , 标签 , ContentHandler , 链接标记
描述	Adds support of 3D files viewing at your MediaWiki
作者	Dolfinus
最新版本	1.7 (2023-10-17)
MediaWiki	1.25+
数据库更改	否
许可协议	MIT授權條款
下載	<translate> Download master snapshot</translate> GitHub: <translate> project page</translate> <translate> git repository URL</translate> [<translate> help</translate> ] <translate> commit history</translate> <translate> Note:</translate> <translate> No [[<tvar name=1>Special:MyLanguage/Localisation#Translation resources</tvar>|localisation]] updates are provided by <tvar name=twn>translatewiki.net </tvar>.</translate> (for MW 1.33 and below use mw-1.33 branch) README
示例	Example of 3D Viewer at file page
Expand 参数 $wg3DAlloy
Expand 标签 ‎<3d>
Expand 使用的函数钩 ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile
季度下載量
正在使用的公开wiki数

描述

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.

支持的文件扩展名

THREE.js模型格式：

• .json
• .3djson
• .3dj
• .three

THREE.js model buffer geometry format:

• .buff
• .buffjson

OBJ文件格式：

• .obj

STL (binary) file format:

• .stl
• .stlb

安裝

• <translate> <tvar name=1>Download</tvar> and place the file(s) in a directory called <tvar name=name>3DAlloy/zh</tvar> in your <tvar name=ext>extensions/</tvar> folder.</translate>
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( '3DAlloy/zh' );
  

• Modify $wgFileExtensions parameter:

$wgFileExtensions = array_merge(
  $wgFileExtensions, array(
      'json', '3dj', '3djson', 'three',
      'buff', 'buffjson',
      'obj',
      'stl', 'stlb'
  )
);

• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

用法

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|zoom|pan|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

名称	描述	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
zoom	If true or 1, canvas can be zoomed	false
pan	If true or 1, canvas can be panned	false
norotate	If true or 1, model does not rotate	false
scale	Model scale as decimal between 0...1	1
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.

配置

All default values can be changed in your LocalSettings.php file:

$wg3DAlloy["width"]  = 500;
$wg3DAlloy["height"] = 400;
...
$wg3DAlloy["class"]  = 'someclass';

Controls and hotkeys

操作	控制
Camera rotate	Swipe, left mouse key hold and move
Camera zoom (if zoom enabled)	Mouse wheel, hold wheel and move, pinch
Camera pan (if pan enabled)	Right key hold and move
Model rotate	←↑→↓键
Model rotation reset	Home键
Model rotation play/pause	双击、双点按
Model rotation play/pause all models at page	回车、空格键
Model rotation speed	-和+键

Hotkeys automatically disables while you edit or submit wiki page.