Extensão:3D
3D Estado da versão: beta |
|
---|---|
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 |
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 | |
Help | Help:Extension:3D/pt-br |
|
|
Quarterly downloads | 100 (Ranked 60th) |
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 pastaextensions/
. - 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
.
Esta extensão está sendo usada(o) por um ou mais projetos da Wikimedia. Isto significa que, provavelmente, a extensão é estável e funciona bem o suficiente para ser utilizada(o) em sites da web de alto tráfego. Procure pelo nome dessa extensão nos arquivos de configuração CommonSettings.php e InitialiseSettings.php da Wikimedia para verificar onde ela foi instalada. Uma lista completa das extensões instaladas numa wiki em particular podem ser visualizadas na página Special:Version da wiki. |
Esta extensão está incluída nas seguintes fazendas/hospedagens (farms/hosts) e/ou pacotes wiki: Esta não é uma lista autoritativa (oficial). Algumas fazendas/hospedagens (farms/hosts) e/ou pacotes wiki podem conter esta extensão mesmo que não estejam listados aqui. Sempre verifique com suas fazendas/hospedagens (farms/hosts) ou pacotes wiki para confirmar. |