Guia do usuário
Extensões
Adicione mobiliário, modelos de projeto, perfis, padrões de hachura, carimbos e tabelas de preços feitos por outras pessoas a partir do catálogo Lapin Extensions, e remova-os de novo.
O catálogo
O Lapin Extensions é um catálogo gratuito de coisas feitas para o Lapin pelos seus usuários e por nós: pacotes de mobiliário, modelos de projeto, bibliotecas de perfis, padrões de hachura, carimbos e tabelas de preços. Cada uma vai para a biblioteca que o Lapin já tem para ela, e você a usa como se a tivesse feito.
Abra Arquivo → Extensões…. Explorar lista o catálogo: pesquise por nome, etiqueta ou pelo que uma extensão contém, ou escolha uma categoria.

Clique em uma extensão para ver seus detalhes antes de instalá-la:
- Autor e Licença. Toda extensão tem uma licença, escolhida pelo autor. Uma permissiva (MIT, CC-BY, CC0…) deixa você usar o que ela contém em qualquer projeto; em outra, leia os termos antes.
- Não comercial: uma extensão cuja licença proíbe o uso comercial (CC-BY-NC, PolyForm Noncommercial…) é marcada assim na lista e nos seus detalhes. Você pode instalá-la e aprender com ela, mas não usá-la em trabalho pago.
- Funciona com: as versões do Lapin para as quais foi feita. Se não servir para o seu Lapin, ela diz isso em vez de oferecer Instalar.
- Tamanho, o arquivo e o seu SHA-256: a impressão digital do arquivo que o catálogo revisou.
- Conteúdo: seus itens, quando o autor os lista.
- Página e Tópico no fórum: onde perguntar ao autor.
Instalar, atualizar, desinstalar
Clique em Instalar. O Lapin baixa o arquivo, confere se o tamanho e o SHA-256 são exatamente os que o catálogo indica (um arquivo alterado no caminho é recusado e nada é instalado) e então o coloca na sua biblioteca:
| Tipo | Para onde vai |
|---|---|
| Mobiliário | Interiores → O meu mobiliário… |
| Modelos de projeto | Arquivo → Novo a partir de modelo… |
| Perfis | as bibliotecas de perfis deste computador |
| Padrões de hachura | Meus padrões, oferecidos por Gerenciar → Materiais |
| Carimbos | os carimbos deste computador |
| Tabelas de preços | Execução → Tabelas de preços…, marcadas como indicativas: os preços são do autor, compare-os com os seus |
| Tipos | o projeto aberto quando você a instala, em um passo para desfazer (Gerenciar → Pacotes de tipos… exporta os seus) |
Se a sua biblioteca já tiver uma lista de preços, uma biblioteca de perfis ou um ficheiro de tramas com o mesmo nome mas diferente, a Pré-visualização da importação oferece manter ambos (com (2) após o nome), substituí-lo ou ignorá-lo; para um modelo de projeto com o mesmo nome, o Lapin pergunta antes de substituir. Nada do que uma extensão traz é executado: extensões são conteúdo.
O catálogo do Lapin também é assinado pela Lapin Extensions: o catálogo e cada um dos seus arquivos levam uma assinatura que o Lapin verifica antes de ler a lista ou instalar um arquivo, de modo que uma cópia alterada pelo caminho é recusada. Uma linha acima da lista diz Assinado pela Lapin Extensions quando é o caso.
Instaladas lista o que este computador tem. Cada linha abre o lugar para onde foi (O meu mobiliário…, Modelos de projeto…), oferece Atualizar quando o catálogo tem uma versão mais nova, e Desinstalar.


Desinstalar tira das suas bibliotecas o que a extensão adicionou, e só isso. O que você já colocou nos seus projetos continua neles: um tipo de mobiliário inserido em um projeto, um projeto iniciado a partir de um modelo.
Tipos
Uma extensão de tipos traz tipos de paredes, lajes, portas, janelas, pilares, vigas ou escadas com aquilo de que são feitos: suas camadas, materiais, perfis e parâmetros. Instalada, seus tipos entram no projeto aberto agora, em um passo para desfazer: um material com o mesmo nome já no projeto é usado, qualquer outro é criado; um tipo já presente exatamente igual é reutilizado, e um com o mesmo nome que difere é adicionado ao lado com (2) após o nome. Instaladas → Adicionar seus tipos a este projeto os leva para outro projeto.

Seus próprios tipos vão para um pacote em Gerenciar → Pacotes de tipos…: marque os tipos, dê um nome ao pacote, e Exportar tipos… salva um arquivo .lapintypes. Importar tipos… no mesmo diálogo lê um, deixa você escolher seus tipos e os adiciona do mesmo jeito.

Scripts
O catálogo também lista scripts Python. No aplicativo de desktop você já pode instalar um; ele roda quando o Lapin tiver o seu console Python, e só quando você o executar. Antes de instalá-lo, seus detalhes dizem o que ele pede (ler ou alterar o projeto aberto, acessar arquivos ou a internet). Um script pode fazer no seu computador o que você pode fazer, então instale scripts de autores em quem você confia. O navegador aceita apenas pacotes de conteúdo.

Extensões pagas
Algumas extensões são vendidas pelos seus autores, na própria loja (hoje, Gumroad). Aparecem como Pago na lista, com o preço; o preço é indicativo: vale o do vendedor, no pagamento. A Lapin Extensions não cobra comissão e não faz parte da venda: o vendedor recebe o pagamento, emite a nota fiscal e cuida dos reembolsos, segundo os termos que Termos do vendedor abre.

- Clique em Comprar: a página de pagamento do vendedor abre no seu navegador. Depois de pagar você recebe uma chave de licença (por e-mail ou na página do recibo).
- De volta a Arquivo → Extensões…, cole a chave em Chave de licença e clique em Instalar. O Lapin envia a chave para a loja, que a verifica com a loja do vendedor e então entrega o arquivo ao Lapin; o Lapin confere o tamanho, o SHA-256 e a assinatura como em qualquer outro.
A chave fica neste computador (nas configurações do Lapin), então você a digita uma vez: as atualizações a usam. O Lapin a verifica de novo quando uma atualização é oferecida, ou uma vez por semana; sem internet nada é bloqueado e o que está instalado continua funcionando.
Se o vendedor reembolsar a compra ou desativar a chave, a extensão não recebe mais atualizações e Instaladas avisa; o que está instalado permanece. Esquecer a chave de licença em Instaladas remove a chave guardada (a próxima atualização pede de novo). Uma extensão paga também se instala no navegador, a partir da loja, com a mesma chave.
Outro catálogo
Catálogo…, na parte de baixo da janela, define o endereço do catálogo: um endereço https, ou o caminho de um index.json neste computador ou em uma pasta compartilhada (o catálogo próprio de um escritório). Deixe vazio para usar o do Lapin. A seta ao lado lê o catálogo de novo. Um catálogo seu não precisa ser assinado: o Lapin diz então acima da lista que ele não é assinado pela Lapin Extensions, então instale a partir dele só se confiar em quem o mantém. Um catálogo cuja assinatura não confere nunca é lido.
Publicar as suas
O catálogo tem o seu próprio site, store.lapinbim.com: uma página para cada extensão, com as suas imagens, versões, licença e downloads, e uma página para cada autor.
Qualquer pessoa pode publicar uma extensão. Exporte-a do Lapin (O meu mobiliário → Exportar, Guardar como modelo…, uma biblioteca de perfis, um carimbo), e depois:
- Na loja: entre em store.lapinbim.com com a sua conta do fórum, abra Your extensions (as suas extensões), preencha o formulário e envie o arquivo e algumas capturas de tela. A loja verifica o arquivo como o Lapin fará e o envia para revisão; a sua página mostra a revisão e, depois de publicada, quantas vezes foi baixada. Uma versão nova segue o mesmo caminho.
- No GitHub: anexe o arquivo a uma release de um repositório seu e adicione o manifesto dele por um pull request em Ciuntuc-BIM-Studio/lapin-extensions. O README dele explica como, e o que as verificações automáticas examinam.
Um pacote de tipos sai de Gerenciar → Pacotes de tipos… → Exportar tipos…; uma tabela de preços de Tabelas de preços…, com o botão de exportar de uma tabela deste computador (um arquivo .lapinprices, com os preços marcados como indicativos).