Extensão:3D

Manual de extensões do MediaWiki

3D Estado da versão: beta
Implementação	Mídia
Descrição	Fornece suporte para formatos de arquivo 3d.
Autor(es)	Gilles Dubuc Matthias Mullie Mark Holmquist
Última versão	0.0.1
Política de compatibilidade	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	>= 1.43
Licença	GNU GPL (Licença Pública Geral) 2.0 ou superior
Download	Baixar extensão Git [?]: Baixar master do Git navegar pelo repositório (GitHub) histórico de commits contribuidores do repositório (GitHub) revisão de código
Help	Help:Extension:3D/pt-br
Parâmetros $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Hooks usados BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	99 (Ranked 57th)
Função no Vagrant	three_d
Problemas	Tarefas em aberto · Relatar um bug

A extensão 3D fornece ao usuário um suporte para wiki para carregar e visualizar modelos 3D. Veja Ajuda:Extensão:3D para documentação de uso.

Ele atualmente suporta os formatos de arquivo AMF e STL, que são comuns no campo de impressão 3D.

Instalação

Permitindo o envio de arquivos em 3D

Diga ao software para aceitar envios STL. Adicione o seguinte ao seu LocalSettings.php:

$wgTrustedMediaFormats[] = 'application/sla';
$wgFileExtensions[] = 'stl';

Instalando a extensão 3D

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

  wfLoadExtension( '3D' );
  

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

Instalando o 3d2png

O 3d2png é um renderizador de miniaturas para arquivos em 3D. Ele renderizará miniaturas em PNG da mesma maneira que essa extensão vai exibir os objetos, pois usa das mesmas bibliotecas JS, que são executas pelo Node.js em vez do próprio navegador do usuário.

Para instalar, clonar e ativar o repositório 3d2png:

git clone https://gerrit.wikimedia.org/r/3d2png
cd 3d2png
npm install

No Linux, será necessário instalar um framebuffer virtual para que o 3d2png possa capturar o objeto 3D sem o uso de cabeçalhos.

apt-get install xvfb

Após ter instalado o 3d2png, diremos à extensão 3D como fazer a chamada ao serviço. Adicione isto ao seu LocalSettings.php e certifique-se de atualizar os caminhos para corresponder à sua configuração:

$wg3dProcessor = [
    '/usr/bin/xvfb-run',
    '-a',
    '-s',
    '-ac -screen 0 1280x1024x24',
    '/path-to-your-repository/3d2png.js'
];

Instalando a extensão Visualizador multimídia

O Visualizador multimídia não é uma dependência obrigatória, mas será necessário instalá-la para poder interagir (mover, ampliar, reduzir) com os modelos em 3D. Após instalar o Visualizador multimídia, associe o tipo de arquivo STL com a extensão adicionando o seguinte ao LocalSettings.php:

$wgMediaViewerExtensions['stl'] = 'mmv.3d';

Configuração

Acordo de patente

Na página de envios

Para adicionar opções de seleção de licença de patente à Special:Upload, edite a página MediaWiki:3d-patents. Cada linha nesta página se tornará uma opção (marcação %lt;option>), em que tudo após o último caractere | será o texto, e tudo antes será a predefinição a ser adicionada ao envio. Confira commons:MediaWiki:3d-patents para alguns exemplos.

Certifique-se de criar a(s) predefinição(ões) antes, como Template:3dpatent.

No assistente de envios

Special:UploadWizard também é compatível com acordos de patente, embora com menor flexibilidade. Ao enviar um arquivo STL de terceiros, uma caixa de diálogo aparecerá, pedindo para confirmar que seu envio não infringe patentes. Ao enviar um arquivo seu, ela também pedirá para confirmar que os objetos em 3D são de sua autoria. A predefinição adicionada ao envio, a exemplo da página no Commons mencionada acima, será ou {{3dpatent}} ou {{3dpatent|ownwork}}.

É possível editar essas mensagens nas páginas MediaWiki:Mwe-upwiz-patent-dialog-text-warranty e MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Para modificar quais tipos de arquivos necessitam de patente, quais predefinições são adicionadas ao envio ou para onde as ligações apontam, edite o LocalSettings.php. Abaixo, estão as configurações padrão:

$wgUploadWizardConfig['patents'] = [
	'extensions' => [ 'stl' ],
	'template' => '3dpatent',
	'url' => [
		'legalcode' => '//wikimediafoundation.org/wiki/Wikimedia_3D_file_patent_license',
		'warranty' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
		'license' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
		'weapons' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing#Weapons',
	],
];

Na extensão CommonsMetadata

Finalmente, a extensão Extension:CommonsMetadata fornece uma maneira de rastrear envios em 3D sem licenças de patente, embora ela não seja configurável. Ela buscará envios do tipo MIME application/sla (os compatíveis pela extensão 3D no momento) sem a predefinição 3dpatent. Os arquivos correspondentes serão automaticamente listados na categoria Category:Files_with_no_machine-readable_patent.

Note, entretanto, que a extensão só funcionará se o nome da sua predefinição for exatamente 3dpatent.