Extensão:3DAlloy

From mediawiki.org
This page is a translated version of the page Extension:3DAlloy and the translation is 53% complete.
Outdated translations are marked like this.
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 hiperligações
Descrição Adiciona suporte para visualização de arquivos 3D em seu MediaWiki
Autor(es) Dolfinus
Última versão 1.7 (2023-10-17)
MediaWiki 1.25+
Modifica o banco
de dados
Não
Licença Licença MIT
Download (for MW 1.33 and below use mw-1.33 branch)
README
Exemplo Exemplo de visualizador 3D na página do arquivo
$wg3DAlloy
‎<3d>

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'
  )
);
  • Yes 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.