Extensão:3D

This page is a translated version of the page Extension:3D and the translation is 41% complete.
Outdated translations are marked like this.
Other languages:
English • ‎Nederlands • ‎Türkçe • ‎dansk • ‎français • ‎magyar • ‎português do Brasil • ‎čeština • ‎български • ‎русский • ‎עברית • ‎中文 • ‎日本語 • ‎한국어
Manual de extensões do MediaWiki
OOjs UI icon advanced.svg
3D
Estado da versão: beta
Asad Al-Lat.stl
Implementação Mídia
Descrição Fornece suporte para formatos de arquivo 3d.
Autor(es)
Última versão 0.0.1
Política de
compatibilidade
branches de lançamento
MediaWiki 1.31.0+
Licença GNU GPL (Licença Pública Geral) 2.0 ou superior
Download
  • $wgMax3d2pngMemory
  • $wg3dProcessEnviron
  • $wgAjaxPatentPreview
Para traduzir a extensão 3D, verifique sua disponibilidade no translatewiki.net
Verificar uso e matriz de versões
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 Help:Extension: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

1. 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';

2. 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.

3. 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 o seguinte ao seu LocalSettings.php, e certifique-se de atualizar o path-to-your-repository para que corresponda ao caminho correto.

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

4. 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

A 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 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 Template:3dpatent. Os arquivos correspondentes serão automaticamente listados na categoria Files with no machine-readable patent.

Matching files lacking this template in their content will automatically be added to 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.