Versão do documento v2026.08.31.0

Edição básica de PCB¶

Objetivo da página¶

Realizar no espaço 2D do PCBAtlas um conjunto limitado e reversível de edições básicas em PCB KiCad e salvar o resultado na revisão atual da biblioteca.

Plataformas compatíveis¶

iOS / iPadOS: 17.0 ou posterior.
macOS: 14 ou posterior.
A primeira versão de edição só está disponível quando a fonte de placa realmente aberta é um KiCad .kicad_pcb.

Público-alvo¶

Usuários que precisam mover rapidamente uma via durante a revisão
Usuários que precisam fazer Slide de um segmento de trilha existente, ajustar sua largura ou excluir uma trilha inteira ou via
Testadores que validam a máquina de estados, Undo e salvamento dentro dos limites atuais

Pré-requisitos¶

Prepare uma placa de teste KiCad .kicad_pcb que possa ser alterada e preserve uma cópia dos projetos importantes.
Abra a placa pela biblioteca e permaneça em 2D.
Se não conseguir selecionar um alvo, verifique no Workbench se Visibility ou Selection Filter oculta ou filtra componentes, trilhas ou vias.

Etapas¶

1. Entrar na sessão de edição¶

Aguarde o Viewer 2D concluir sua primeira preparação. Para PCB KiCad editável, o PCBAtlas prepara automaticamente uma sessão de edição completa.
Selecione um segmento de trilha ou via no canvas.
Escolha a ação disponível Slide, Move Via, Delete Track ou Delete Via na barra de ferramentas flutuante sob o canvas.

O Viewer permanece somente leitura durante a preparação. Se a fonte não for PCB KiCad, não for possível criar uma sessão completa ou a placa estiver obsoleta, a parte inferior do canvas informa o motivo claramente sem continuar com edição aproximada.

2. Selecionar um objeto e revisar as ações¶

Após entrar na sessão de edição, selecione um alvo no Viewer 2D. Layouts amplos e compactos usam somente a barra flutuante inferior do Viewer; o Workbench não hospeda mais um painel de edição.

Objeto selecionado	Ações atuais	Comportamento importante
Componente	Somente leitura; sem ação de edição	Suas informações permanecem disponíveis, mas a edição básica não pode alterar um Placement
Via não fixed	`Move Via`, `Delete Via`	O movimento não reescreve trilhas adjacentes
Segmento de trilha compatível	`Slide`, `Track Width`, `Delete Track`	Slide se aplica ao segmento exato; exclusão se aplica a toda a Track

Trilhas / vias fixed, alvos imprecisos e geometrias não compatíveis desativam a ação e mostram o motivo. Placements são atualmente sempre somente leitura e não oferecem botões Move ou Rotate desativados.

3. Mover uma via¶

Selecione uma via não fixed.
Selecione Move Via.
Arraste a partir do alvo; arrastar do espaço vazio ainda desloca a câmera.
Confira ghost, posição original, ΔX / ΔY e passo da grade.
Solte no destino para criar uma prévia de edição pendente.

Depois de soltar, ghost e barra de confirmação permanecem. Selecione ✓ para aceitar a edição ou × para descartá-la. Se o commit falhar, o app mostra erro e não deixa edição parcial.

4. Fazer Slide de uma trilha existente¶

Selecione com precisão um segmento de trilha compatível.
Selecione Slide; o canvas mostra prévia de linha central azul e controles inferiores ✓ / ×.
Arraste a linha azul. A trilha de prévia e sua largura real são atualizadas em tempo real com essa linha.
O estado Slide permanece ativo após soltar, permitindo ajustar novamente a mesma linha azul.
Selecione ✓ para aceitar a prévia válida atual ou × para sair de Slide e descartar a edição.

Se você arrastar o segmento além do limite geométrico, o PCBAtlas mantém a última prévia válida e mostra o motivo sem sair de Slide. Arraste a linha azul de volta a uma faixa válida para continuar.

Não é possível adicionar / excluir nós, dividir / unir uma Track ou alterar layer, net ou rule class aqui.

5. Alterar a largura¶

Selecione uma trilha compatível.
Selecione Track Width.
Digite um valor em milímetros maior que zero.
Selecione Apply para criar uma prévia e use ✓ para aceitar ou × para descartar.

Números inválidos, larguras não positivas e valores fora da faixa são rejeitados.

6. Excluir uma trilha ou via¶

Selecione qualquer segment da trilha ou uma via.
Confirme que toda a Track está destacada ou que a via está correta.
Selecione Delete Track ou Delete Via e use ✓ para aceitar ou × para descartar.

A exclusão não usa confirmação modal adicional. Teardrops relacionadas são removidas de forma atômica quando podem ser resolvidas com segurança. Em exclusão acidental, use Undo na barra flutuante inferior do Viewer.

7. Desfazer e salvar¶

Undo na barra flutuante inferior só fica disponível quando o comando atual termina e volta ao estado ready. Mensagens de conclusão não mostram mais botão Undo separado.
Cada movimento de via, Slide, alteração de largura ou exclusão em cascata aceitos cria uma entrada de histórico.
Após cada commit de edição ou Undo, o app acrescenta seu registro de recuperação à cópia de trabalho interna EditingDraftsV4. Se o salvamento ainda falhar após nova tentativa automática, o resultado já confirmado do canvas permanece, mas novas edições ficam bloqueadas e Retry Saving Draft aparece. Selecioná-lo repete apenas o salvamento do registro pendente, sem executar a edição outra vez. O estado ready só retorna após salvar com sucesso.
Um * antes do título indica alterações não salvas na sessão atual.
Selecionar Save na barra flutuante inferior, ou pressionar ⌘S no macOS ou iPad com teclado físico, grava o resultado diretamente na revisão de biblioteca aberta. Não cria revisão nem altera canvas ou câmera atuais.
Salvamentos de edição PCB preservam a miniatura Mini Viewer existente do Case. Execute explicitamente Regenerar miniatura depois se desejar refletir a placa atualizada.
Ao voltar à biblioteca pelo controle superior esquerdo com alterações não salvas, escolha:
- Save: salvar na revisão atual e voltar à biblioteca;
- Discard Unsaved Edits: restaurar o último ponto salvo e sair;
- Continue Editing: voltar à sessão atual.
Importar arquivo de mesmo nome ou selecionar explicitamente Add Revision ainda cria nova revisão. Salvamentos comuns de edição não alteram a contagem de revisões.

Checklist de aceitação¶

Limites atuais¶

Slide altera somente as restrições topológicas existentes do segmento atual suportado. Não há novo roteamento, roteamento interativo, empurrar / contornar nem autorroteamento.
Não há suporte a mover, girar, adicionar ou excluir componentes, trocar footprint, mudar de face ou transformar vários objetos.
Sem edição de Zone, Pad, contorno, texto, gráfico ou shape arbitrária.
Não é possível excluir apenas um segment; Delete Track sempre remove a trilha completa.
A edição pode adicionar ratsnest ou problemas DRC. Um resultado enviado explicitamente não é revertido em silêncio.
Salvar atualiza a revisão de biblioteca aberta. Somente importação de arquivo de mesmo nome ou Add Revision explícito cria nova revisão.

Perguntas frequentes¶

Por que não há ação de edição na barra flutuante, ou por que entrar nela falha?¶

Confirme que uma visualização PCB 2D está aberta, que a fonte real da placa é .kicad_pcb e que o app pode criar uma sessão completa. Pacotes de fabricação, DSN, SES, ODB++, IPC-2581 e esquemáticos estão fora desta primeira versão. A barra flutuante mostra apenas ações disponíveis para o objeto selecionado atual.

Por que não aparecem botões para o objeto selecionado?¶

Placements são atualmente inspecionáveis, mas não editáveis, portanto sua seleção não mostra botões Move ou Rotate. Outros objetos também podem não oferecer ação por estarem fixed, usarem geometria de track não compatível ou ficarem obsoletos após atualização. Selecione novamente e leia o motivo de bloqueio na parte inferior do canvas.

Por que a linha azul de Slide para de se mover em um ponto?¶

Essa posição excede as restrições geométricas atuais. A interface mantém a última prévia válida em vez de sair de Slide; arraste a linha azul preservada de volta à faixa válida para continuar.

Resultado¶

A revisão PCB KiCad atual contém um resultado salvo que pode ser reaberto, e cada alteração da sessão é uma transação atômica reversível.

Última verificação¶

2026-08-22