Skip to content

Interface

PedroVMota edited this page Nov 13, 2026 · 2 revisions

Interface

A janela principal (1280 × 800 por omissão, mínimo 640 × 400) é feita com eframe/egui, com o canvas desenhado na GPU.

┌──────────────────────────────────────────────────────────────────────────┐
│ Run Stop Pause Step [½ cycle] │ ticks/s [20] │ [Unit delay] │ Stopped tick 0│  ← barra
├────────────┬──────────────────────────────────────────────┬──────────────┤
│  Paleta    │                                              │ Propriedades │
│  Tools     │                 canvas (GPU)                 │              │
│  Gates     │                                              │              │
│  Inputs    │                                              │              │
│  Outputs   │                                              │              │
│  FF & mem. │                                              │              │
│  Notes     │                                              │              │
│  Macros    │                                              │              │
└────────────┴──────────────────────────────────────────────┴──────────────┘

Dentro de uma macro aparece também uma barra de breadcrumbs (root › Decade counter#3 › …). Ver Macros e hierarquia.

Barra de simulação

Controlo Função
Run (F9) Começa a simular. Depois de um erro (Halted), repõe o estado antes de correr.
Stop (F10) Para e repõe tudo: flip-flops com Q = 0, memórias com o conteúdo de projeto.
Pause (F11) Pausa / retoma.
Step (F12) Avança até ao próximo flanco de relógio (½ ciclo) ou dois flancos (ciclo completo), escolhido na lista ao lado. Só atua parado ou em pausa.
ticks/s Ritmo da simulação (0,1 a 1 000 000; por omissão 20).
Modo Unit delay ou Sequential (DW). Ver Simulação.
Estado Stopped, Running, Paused ou Halted, o número do tick e, se houver, a mensagem de erro.

Paleta (esquerda)

Tools:

Ferramenta Uso
Select / move Selecionar e mover componentes, segmentos, junções e curvas; caixa de seleção; pan no vazio.
Interact Mudar interruptores, premir botões de pressão, mudar a fase de entradas de impulsos.
Wire Desenhar fios.

Depois vêm o seletor de símbolos ANSI / IEC, o número de entradas das portas (Gate inputs, 2 a 8) e os grupos de componentes, com ícones desenhados a partir dos próprios símbolos (o nome aparece ao passar o rato):

Grupo Componentes
Gates AND, OR, NAND, NOR, XOR, XNOR, NOT, Tri-state
Inputs Interruptor, botão de pressão, entrada de impulsos, relógio, gerador de sequências, VCC, massa
Outputs LED, 7 segmentos, saída numérica
Flip-flops & memory D-FF, RS-FF, JK-FF, RAM, ROM
Notes Anotação de texto
Macros In tag, Out tag, New (macro vazia), Parts Centre, Create Macro from Selection…

Escolher um componente e clicar no canvas coloca-o; enquanto se escolhe o sítio, o símbolo aparece em transparência. Os componentes entram com as predefinições da documentação original: D por flanco ascendente e JK master-slave (ambos com PRE/CLR), RS latch, memória 256 × 8. Ver Componentes.

Propriedades (direita)

  • Nada selecionado: nome do projeto (com • se houver alterações por gravar), número de componentes, segmentos, junções e, se existirem, definições de macros e tamanho achatado. Dentro de uma definição, mostra as propriedades da macro.
  • Um componente: tipo e id, posição, rotação e o editor do tipo (operação e entradas das portas, meio período do relógio, tipo/disparo/PRE-CLR dos flip-flops, tipo e tamanho da memória com Edit contents…, modo dos interruptores, padrão do gerador, formato da saída numérica, texto das anotações, cor para LEDs, relógios, geradores, mostradores e anotações), mais Rotate (R) e Delete (Del). Mudar algo que altera os pinos (por exemplo o tamanho da memória) só é possível sem fios ligados.
  • Vários componentes: quantos são, Create Macro from Selection… e Delete all.
  • Um segmento de fio: extremos, comprimento, quem conduz a rede (um componente, "no driver (floating)" ou "bus of N tri-state drivers") e Delete segment.

Canvas: rato

Ação Efeito
Roda do rato, pinch ou ⌘ + scroll Zoom centrado no cursor.
Scroll de dois dedos, arrastar com o botão do meio ou o direito, arrastar no vazio (Select) Pan.
Clique (Select) Seleciona um componente ou um segmento.
Arrastar no vazio (Select) Caixa de seleção (com Shift junta à seleção).
Shift-clique Junta ou retira um componente da seleção.
Arrastar um componente Move-o; os fios esticam-se na ortogonal (rubber-banding).
Arrastar uma junção ou curva Move-a (o cursor mostra um anel azul quando há uma por baixo).
Arrastar um segmento Desloca-o na perpendicular.
Duplo clique numa macro Abre a definição no lugar.
Botão direito Menu de contexto: Edit Macro (open inside), Macro Properties (numa macro), Create Macro from Selection…, New Macro, Parts Centre, Up One Level (dentro de uma macro).
Passar sobre um fio (Select/Wire) Realça a rede inteira.
Passar sobre um pino (com zoom suficiente) Mostra o nome do pino.

Durante um arrasto vê-se uma pré-visualização; a edição aplica-se ao largar.

Arrastar ficheiros para a janela: .dwm é importado, .bitwerk é aberto, .bwmacro é importado para o projeto e uma pasta é importada para a biblioteca de peças.

Teclado

Tecla Ação
R Rodar o componente selecionado (90°).
Del / Backspace Apagar a seleção; a desenhar um fio, tira a última curva.
Esc Cancela o fio em curso ou o arrasto; senão volta à ferramenta Select.
/ ou Espaço A desenhar um fio, troca o lado da curva do L.
F9 / F10 / F11 / F12 Run / Stop / Pause / Step.
⌘N / ⌘O / ⌘S / ⇧⌘S New / Open… / Save / Save As…
⌘I Import Digital Works…
⇧⌘M Create Macro from Selection…
⌘E Edit Macro (abre a instância selecionada).
⌘↑ Up One Level.
⇧⌘P Parts Centre.
⇧⌘T Spawn Stress Test (100k componentes).
⌘Q Quit.

As teclas só atuam quando nenhum campo de texto tem o foco.

Menus (macOS)

Menu Itens
bitwerk About, Hide, Hide Others, Quit
File New, Open…, Save, Save As…, Import Digital Works…, Import Digital Works Folder to Library…, Export as Digital Works 3.0.5 (.dwm)…
View ANSI Symbols (distinctive shapes), IEC Symbols (rectangular)
Circuit Run, Stop, Pause / Resume, Step, Unit Delay Simulation, Sequential Simulation (Digital Works Compatible)
Macro Create Macro from Selection…, New Macro, Edit Macro, Up One Level, Parts Centre, Import .bwmacro…
Debug Spawn Stress Test (100k components), Spawn Macro Stress Test (2 500 nested cells), Continuous Repaint

Abrir, criar ou importar com alterações por gravar pede confirmação (Discard / Cancel).

Gravar e exportar

  • Save (⌘S) grava o projeto no ficheiro dele; sem ficheiro, faz Save As….
  • Save As… (⇧⌘S; sem menu nativo, há também um botão Save As… na barra de simulação) tem dois formatos no diálogo: bitwerk project (o predefinido) e Digital Works 3.0.5 (.dwm, lossy export). Escolher .dwm exporta uma cópia: o documento continua ligado ao seu .bitwerk, as alterações por gravar continuam por gravar e a barra de estado diz isso.
  • Export as Digital Works 3.0.5 (.dwm)… pede logo um .dwm.
  • A exportação corre numa thread própria e no fim abre a janela Digital Works export: o que foi escrito (contagens, cópias de macros), as notas em Dropped, Warnings e Approximations, e Copy as text.
  • Nas propriedades de uma macro há Export as Digital Works macro…; na janela Memory Contents, Save… oferece o .map de texto do bitwerk ou o .map binário do Digital Works.

Ver Exportação para o Digital Works.

Estilos de símbolos

  • ANSI/IEEE 91 (formas distintivas, por omissão) e IEC 60617 (retângulos com &, ≥1, =1, 1 e bolha de inversão).
  • Muda-se em View, nos botões ANSI/IEC da paleta ou com --style iec. Mudar de estilo só altera um uniform da GPU.
  • A escolha não é gravada entre sessões (a persistência do eframe não está ativa).

Sobreposição de estatísticas

No canto superior esquerdo do canvas aparecem, quando relevante, FPS e tempos de frame, o modo de desenho (tudo ou culling na GPU) e a percentagem do upload de uma cena grande. Debug → Continuous Repaint força o redesenho contínuo para medir; normalmente a app só redesenha quando algo muda (0 % de CPU em repouso).

Clone this wiki locally