Extensão:3DAlloy

Manual de extensões do MediaWiki

3DAlloy Estado da versão: estável
Implementação	Função de análise sintática , Marcação , ContentHandler , Marcação de ligações
Descrição	Adiciona suporte para visualização de arquivos 3D em seu MediaWiki
Autor(es)	Dolfinus
Última versão	1.10 (2025-10-27)
MediaWiki	1.43+
Modifica o banco de dados	Não
Parâmetros $wg3DAlloy
Marcações ‎<3d>
Hooks usados ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile
Licença	Licença MIT
Download	Baixe o snapshot mestre GitHub: página do projeto URL do repositório git [ajuda ] histórico de envios Nota: Nenhuma atualização de localização é fornecida pelo translatewiki.net . (for MW 1.33 and below use mw-1.33 branch) README
Exemplo	[https://en.crystalls.info/File:Cube.json Exemplo de visualizador 3D na página do arquivo]

Descrição

Extensão MediaWiki que permite adicionar visualizador de modelos 3D às páginas do site. Com base em THREE.js, renderiza a imagem com CanvasRenderer. Lá você pode ver um exemplo de modelo 3D da página.

Extensões de arquivo suportadas

Formato do modelo THREE.js:

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

Formato de geometria do buffer do modelo THREE.js:

• .buff
• .buffjson

Formato de arquivo OBJ:

• .obj

Formato de arquivo STL (binário):

• .stl
• .stlb

Instalação

• Download e coloque o(s) arquivo(s) num diretório chamado 3DAlloy na sua pasta extensions/.
• Adicione o seguinte código ao final do seu arquivo LocalSettings.php :

  wfLoadExtension( '3DAlloy' );
  

• Modifique o parâmetro $wgFileExtensions :

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

• Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.

Uso

As Image Handler

[[File:Model.json|300x300px|color=,opacity=,...]]

Como função Parser

{{#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}}

Em vez do nome do arquivo carregado, você pode usar uma url para o arquivo localizado em um site externo.

Como tag Parser

<3d file="Model.json" width="" height="" ... ></3d>

or

<3d width="" height="" ... >Model.json</3d>

Você também pode usar URL em vez de um nome de arquivo curto.

Parâmetros

Nome	Descrição	Default value
width	Largura da tela em pixels	300
height	Altura da tela em pixels	300
color	Cor RGB do modelo como HEX	0xff00ff
opacity	Opacidade do modelo como decimal entre 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	Se verdadeiro ou 1, o modelo não gira	false
scale	Escala do modelo, em porcentagem	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.

Configurar

Todos os valores padrão podem ser alterados em seu arquivo LocalSettings.php :

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

Controles e teclas de atalho

Ação	Controles
Camera rotate	Swipe, left mouse key hold and move
Zoom da câmera (if zoom enabled)	Mouse wheel, hold wheel and move, pinch
Camera pan (if pan enabled)	Right key hold and move
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.