Plugins do PolyPDF: como funcionam

PolyPDF é um aplicativo de desktop para pessoas que trabalham com desenhos PDF em vez de arquivos CAD – engenheiros individuais, arquitetos, estimadores e pequenas equipes ao seu redor. Seu trabalho principal de documento, anotação, medição e exportação ocorre localmente no Mac e no Windows. Mapas, ativação de licença, atualizações, compras e suporte podem exigir uma conexão.

Essa forma local primeiro define as restrições para qualquer coisa que adicionarmos. Os plug-ins foram projetados dentro dele: os pacotes carregam dados e arte assinados, e não código executável baixado ou um serviço de assinatura.

Acesso atual: instalar, executar e editar o conteúdo do plugin requer PolyPDF Pro. O conteúdo já colocado em um PDF permanece como conteúdo comum do documento.

Um pacote de plug-in pode conter tabelas de dados, arte SVG ou PNG higienizada e uma descrição declarativa do formulário que o usuário preenche. O pacote nomeia um dos geradores fixos de propriedade do host do PolyPDF e fornece entrada limitada para esse gerador.

Esse design restringe a superfície de ataque; isso não torna um arquivo arbitrário inofensivo. Um pacote ainda pode conter valores estruturados, rótulos, opções e gráficos. Portanto, o PolyPDF valida o arquivo e o manifesto, limpa a arte suportada, impõe permissões declaradas e valida as anotações e ativos de imagem produzidos por seu próprio gerador antes que qualquer coisa seja inserida.

O que é verificado antes de um pacote ser instalado

• Pacotes agrupados e entregues por catálogo usam uma assinatura Ed25519 em um resumo SHA-256 cobrindo cada arquivo, além de uma verificação SHA-256 separada em cada arquivo.
• Uma instalação de catálogo é aceita somente quando o catálogo assinado fixa a soma de verificação do pacote. Um arquivo que o usuário seleciona diretamente pode ser autoassinado; a tela de consentimento identifica essa fonte e fixa a chave do autor após a aprovação.
• Uma lista de permissões de layout estrita — um pacote pode conter apenas um manifesto, um esquema de formulário, uma assinatura e pastas de dados, ativos e ícones. Qualquer outra coisa é recusada.
• Verificações de segurança de caminho e links simbólicos que rejeitam travessia, caminhos absolutos e entradas duplicadas.
• Limites de tamanho no arquivo, em cada membro e no número de membros.

O modelo de permissão

Um plug-in declara qual das três permissões precisa: ler o contexto atual do documento, criar anotações e criar ativos de imagem na área de trabalho. A visualização detalhada ou de revisão de carregamento lateral os lista em linguagem simples. Um resultado do gerador fora dessas permissões é rejeitado.

A caixa de diálogo do gerador é desenhada pelo PolyPDF a partir do esquema de formulário do plugin. O plugin descreve os campos; o aplicativo os renderiza. Nada em um pacote controla a interface diretamente.

Os plug-ins são gerenciados em uma janela de plug-ins, que mostra uma única lista dos pacotes que o PolyPDF carrega e todos os que você mesmo instalou. Uma página de detalhes mostra o editor, versão instalada, permissões, comandos, compatibilidade, fonte e tamanho do pacote, notas de versão quando presentes e se o plugin está habilitado.

• Habilite, desabilite, desinstale e reverta uma versão anterior disponível na mesma janela.
• Instalar do arquivo… abre uma revisão de consentimento para um pacote que o usuário selecionou deliberadamente, incluindo sua origem, signatário, permissões e contexto de downgrade ou reinstalação.
• Um sideload consentido pode reinstalar a mesma versão ou instalar uma versão mais antiga; a tela de revisão informa o que está para acontecer antes de você aprová-lo.
• A desinstalação de um plugin não afeta o conteúdo já gerado – esse conteúdo faz parte do seu documento, não do plugin.

PolyPDF carrega três geradores originais e os habilita na primeira execução. “Verificar atualizações” aparece apenas quando uma compilação tem uma fonte de atualização configurada; a configuração de remessa normal não possui guias Descobrir, Instalado ou Atualizações e nenhuma ação de atualização de catálogo.

Não existe mercado ou diretório de submissão pública. Instalar do arquivo… é o caminho explícito para um pacote de terceiros escolhido pelo usuário, e sua tela de consentimento distingue esse pacote do software fornecido pelo PolyPDF.

Digite uma designação compatível - por exemplo W24X55, L6X6X1/2, HSS8X8X1/2 ou PIPE6 - escolha unidades habituais ou métricas e uma escala de anotação, e o PolyPDF desenha o perfil da seção na folha.

O perfil é uma geometria vetorial real, colocada como uma anotação de polígono em vez de um bitmap colado: ele permanece nítido em qualquer zoom e é impresso no tamanho solicitado. Formas ocas como HSS e Tubo são desenhadas com seu laço interno, portanto a espessura da parede é a espessura real da parede.

AISC Steel Sections desenha perfis de seção. Ele não realiza verificações de capacidade, código ou design. Os dados agrupados são um subconjunto de formatos 57 selecionados nas famílias W, M, S, HP, C, MC, L, WT, HSS, HSS-Round e Pipe, em vez do banco de dados completo, portanto, verifique qualquer designação em relação a uma referência oficial antes de tomar uma decisão de projeto.

Escolha Engenheiro Profissional ou Arquiteto, escolha uma jurisdição - os 50 estados e o Distrito de Columbia - preencha os campos solicitados pelo modelo de jurisdição e observe o selo ser construído na visualização ao vivo antes de inseri-lo.

A saída é um gráfico gerado a partir de um modelo. Não é uma assinatura criptográfica e a inserção de uma não assina o documento. As ferramentas de assinatura digital do PolyPDF são separadas e, se você precisar de uma assinatura, um verificador poderá verificar, esse é o caminho a ser usado.

Um selo do Seal Maker é uma obra de arte gráfica, não uma assinatura digital criptográfica. O PolyPDF não verifica o status da licença e não confirma se um modelo corresponde aos requisitos atuais da sua placa. O profissional licenciado cujo nome aparece no selo permanece responsável pela sua aparência, redação e uso.

Insira um endereço, cidade ou nome de local, defina um nível de zoom da visão mundial até o nível do edifício e insira uma imagem de mapa na página. Dentro do PolyPDF, o resultado permanece ajustável: clique duas vezes nele para deslocar e ampliar um pequeno editor e salvar a visualização. Em outros visualizadores de PDF, é uma imagem simples.

As pesquisas de locais são geocodificadas através do Nominatim em openstreetmap.org. A imagem em si é renderizada a partir de blocos de vetor OpenFreeMap usando o esquema OpenMapTiles. PolyPDF incorpora “OpenFreeMap © OpenMapTiles Data from OpenStreetMap” na imagem gerada – ou em um formato de layout mais curto quando o espaço exigir – para que o crédito viaje com o PDF.

O PDF Maps precisa de uma conexão com a Internet enquanto resolve um local e renderiza blocos do OpenFreeMap. Uma vez inserido, o resultado é uma anotação de imagem independente que permanece no PDF.

Os sinais MUTCD não são plugins. Eles são integrados ao PolyPDF como conjuntos de ferramentas. O baú regulatório contém 435 cartões de sinalização; escolher R1-1 Stop e posicioná-lo cria uma anotação de imagem que pode ser movida, redimensionada ou excluída como outro conteúdo da página.

O exemplo abaixo executa esse fluxo de trabalho de navegação e posicionamento em um exemplo de planilha de controle de tráfego. A arte da sinalização vem do lançamento FHWA Standard Highway Signs 2024.

Cada plugin segue o mesmo caminho. Aprenda uma vez e isso se aplica à próxima também.

1. Abra o Gerenciador de plug-ins. No macOS: PolyPDF ▸ Plug-ins…. No Windows: Ferramentas ▸ Plugins ▸ Plugins….
2. Escolha uma linha na lista única e leia sua página de detalhes – editor, versão instalada, permissões solicitadas, fonte, compatibilidade e comandos.
3. Para um pacote que você mesmo obteve, escolha Instalar do arquivo… e revise seu signatário, fonte, permissões e aviso de reinstalação ou downgrade antes de consentir. Os três geradores retratados aqui já estão instalados.
4. Execute um plugin em Ferramentas ▸ Plugins e escolha seu comando: Inserir seção de aço AISC…, Inserir selo profissional… ou Inserir mapa….
5. Preencha a caixa de diálogo do gerador. O painel de visualização é redesenhado conforme você digita, para que você veja o resultado antes de tocar no documento.
6. Escolha Inserir. O conteúdo é colocado como anotações comuns, em uma única etapa de desfazer — um Desfazer remove toda a inserção.
7. Use as operações de edição suportadas por esse tipo de anotação. Um perfil vetorial pode ser movido, redimensionado, reestilizado ou excluído; a saída baseada em imagem pode ser movida, redimensionada ou excluída.

O que aparece na página é uma anotação PDF padrão – um polígono para uma seção de aço, um carimbo para um selo ou um mapa – escrita com um fluxo de aparência consolidada. O conteúdo pertence ao documento, não ao plugin, por isso a desinstalação do plugin o deixa intacto.

Os três primeiros geradores são deliberadamente diferentes: uma pesquisa de dados que desenha geometria vetorial, um modelo que compõe uma imagem e um gerador que alcança serviços externos. Cada um nos diz algo diferente sobre o que o formato do pacote deve suportar a seguir.

Se um plugin facilitaria a sua semana, diga-nos o que ele deve gerar e o que deve pedir. Escreva para support@polypdf.com.