O guia completo do código G: do iniciante ao profissional

O que é o código G?

G-Code (Código Geométrico) é a linguagem de texto simples que acciona as máquinas CNC. Cada arquivo – normalmente `.gcode`, `.nc` ou `.cnc` – é uma sequência de instruções que indica à máquina para onde se deve mover, com que rapidez e quando ativar sua ferramenta. As linhas são executadas de cima para baixo, uma de cada vez.

Pense no seu design como o projeto e no G-Code como a navegação passo a passo. Uma impressora 3D não consegue processar JPG. Um plotter de caneta não sabe a aparência da letra 'A'. O G-Code resolve isto dividindo qualquer forma em movimentos elementares — linhas retas, arcos e comandos de ativação/desativação de ferramentas — que qualquer controlador de movimento pode executar de forma confiável.

A norma remonta ao MIT na década de 1950, formalizada como RS-274 em 1963 e publicada internacionalmente como ISO 6983 em 1982. Apesar da sua idade, o G-Code continua a ser a linguagem universal de fabricação - desde impressoras de secretária amadoras a fresadoras industriais de cinco eixos.

Onde é usado o código G?

• Plotters de caneta (AxiDraw, HP 7475A, DIY GRBL): move uma caneta física pelo papel para reproduzir arte vetorial — um dos pontos de entrada mais acessíveis no G-Code para artistas e criadores.
• Gravadores e cortadores a laser: direciona o feixe enquanto modula a potência para gravar imagens em madeira ou cortar formas em acrílico.
• Impressoras 3D FDM (Prusa, Creality, Bambu Lab): coordena a cabeça de impressão em X, Y, Z enquanto alimenta o filamento, construindo objetos camada a camada.
• Routers e fresas CNC: direciona uma ferramenta de corte rotativa através do material para esculpir, embolsar e perfilar.
• Tornos CNC, cortadores de plasma, jato de água e máquinas de eletroerosão por fio: todos usam código G ou um derivado próximo.

A anatomia de um arquivo de código G

Cada linha (chamada de bloco) é uma instrução completa. A máquina recorda seu estado entre linhas — um avanço definido na linha 10 permanece ativo na linha 200, a menos que o altere. A isto chama-se estado modal.

Aqui está um programa de plotter de caneta que desenha um quadrado de 50×50mm:

G21; milímetros

G90; posicionamento absoluto

G0 Z5.0 ; levantar caneta

G0 X0 Y0 ; mover para a origem

M3 S1000; caneta para baixo

G1 X50.0 Y0 F2000

G1 X50.0 Y50.0

G1 X0 Y50.0

G1 X0 Y0

M5; levantar caneta

M2; fim

Decompondo G1 X50.0 Y25.3 F1500: G1 = traçar uma linha reta, X50.0 Y25.3 = destino, F1500 = 1500 mm/min. Note que G1 só aparece uma vez — cada linha de coordenadas seguinte reutiliza-a automaticamente até que escreva G0 ou outro comando de movimento. Tudo o que seja após um ponto e vírgula é um comentário, ignorado pela máquina.

Comandos essenciais do código G

Estes comandos funcionam em praticamente todos os firmwares — desde o GRBL amador ao Fanuc industrial.

• G0 — Movimento Rápido: reposicione o mais rápido que a máquina permitir. Nunca usar com laser ou fuso ativo.
• G1 — Movimento Linear: desenhe ou corte uma linha reta no avanço definido (F). O comando principal para todo o trabalho CNC.
• G2 / G3 — Arco no sentido horário/anti-horário: produz curvas suaves num único comando usando deslocamentos centrais I/J ou raio R. Um G2/G3 substitui dezenas de pequenos segmentos G1.
• G4 — Dwell: pausa durante um tempo definido. ⚠ A unidade P varia: GRBL = segundos (G4 P1,5 = 1,5s), Marlin = milissegundos (G4 P1500 = 1,5s).
• G20 / G21 — Unidades em polegadas/milímetros. Defina sempre isso no início de cada arquivo.
• G28 — Inicialização de todos os eixos. O comportamento varia de acordo com o firmware. Verifique sempre antes de usar.
• G90 / G91 — Posicionamento absoluto/relativo. G90 é o padrão; G91 torna cada coordenada relativa à posição atual.
• G92 — Define a posição atual como origem sem se mover. Usado para definir uma origem de trabalho no meio do trabalho.
• M3 S[valor] — Ferramenta ligada: dispara o laser, roda o eixo ou baixa o servo da caneta. S controla a potência, as RPM ou o ângulo do servo.
• M5 — Ferramenta desligada. Inclua sempre antes de qualquer movimento rápido.
• M104 / M109 — Defina a temperatura do hotend (impressão 3D). M109 espera até que o alvo seja atingido antes de continuar.
• M140 / M190 — Definir temperatura da cama (impressão 3D). M190 standby – usar antes do início da impressão.
• F — Avanço em mm/min. Modal: persiste até que o altere.
• S — Potência ou velocidade: potência do laser (0–1000 no GRBL), RPM do fuso ou ângulo do servo.
• E — Distância do filamento da extrusora (apenas impressão 3D).
• I, J — Deslocamentos do centro do arco a partir da posição actual, usados com G2 e G3.

SVG para código G: o que realmente acontece

Os percursos SVG usam curvas, arcos e linhas retas de Bézier. G1 apenas desenha linhas retas — por isso, os conversores devem preencher a lacuna de duas formas:

A facetação divide as curvas em muitos pequenos segmentos rectos. Curvas mais suaves requerem segmentos mais curtos, o que significa arquivos maiores e possíveis falhas de movimento quando o buffer de comando da máquina não consegue acompanhar.

O ajuste do arco é mais inteligente: detecta quando uma sequência de segmentos curtos forma coletivamente um círculo e substitui todo o grupo por um único comando G2 ou G3. Um círculo que ocupe 360 ​​linhas G1 transforma-se numa linha de G-Code. Os arquivos podem encolher até 90%, o movimento é perfeitamente suave e a máquina mantém uma velocidade contínua através do arco. Nem todas as compilações GRBL suportam G2/G3. Verifique antes de ativar.

Dialectos de código G: porque é que um arquivo não cabe em todas as máquinas

Os comandos principais de movimento (G0, G1, G2, G3) funcionam em qualquer lugar. Tudo o resto – sequências de inicialização, alterações de ferramentas, sintaxe de comentários – varia de acordo com a família de firmware. A execução do G-Code a partir do controlador errado numa máquina CNC profissional não produz apenas resultados errados – pode causar uma colisão rápida na peça de trabalho.

• GRBL: firmware dominante para plotters de caneta amadores, gravadores a laser e pequenos routers CNC. Baseado em Arduino, amplamente suportado por conversores e ferramentas CAM.
• Marlin: dominante para impressoras 3D FDM. Adiciona controle de extrusora, códigos M de temperatura e nivelamento da base para além dos comandos de movimento padrão.
• Klipper: firmware moderno de impressora 3D a correr num Raspberry Pi. Permite input shaping e velocidades de impressão mais elevadas que não são possíveis no Marlin com o mesmo hardware.
• Smoothieware: firmware ARM de 32 bits para gravadores laser e CNC de média dimensão — mais capacidade computacional do que o GRBL baseado em Arduino.
• Fanuc: controlador CNC industrial dominante em todo o mundo. Inclui ciclos fixos (G81–G89) e programação de macros.
• Siemens Sinumerik / Heidenhain / Haas: controladores industriais europeus e norte-americanos com seus próprios dialetos. Um pós-processador Fanuc não funcionará corretamente em uma máquina Sinumerik.

Conversão de fotos em percursos plotáveis

As fotos contêm apenas pixels – não há dados de caminho. Antes que uma foto possa ser plotada ou gravada em vetor, deve ser convertida para SVG. Abordagens comuns:

• Traçado de arte de linha: extrai os contornos e as arestas estruturais do motivo como caminhos SVG. Melhor para logotipos, retratos e ilustrações com contornos claros.
• Hachura/hachura cruzada: mapeia o brilho da imagem para a densidade da linha – as áreas mais escuras obtêm linhas mais comprimidas. Os resultados evocam a gravura tradicional e funcionam muito bem em plotter.
• Pontilhado: mapeia o brilho para a densidade do ponto. Cada ponto é um breve toque de caneta ou laser, semelhante à ilustração pontilhista.
• Mapeamento de contornos: trata a luminosidade como elevação, desenhando linhas concêntricas nos limites de brilho. Produz resultados fluidos e orgânicos a partir de fotos.
• Estilos algorítmicos (Voronoi, campos de fluxo, padrões de onda): transformações matemáticas moduladas pelo brilho da imagem para arte abstrata, mas reconhecível, desenhada à máquina.

O pipeline completo: Foto → SVG → Código G com Pixel2Lines

Pixel2Lines converte sua foto num SVG limpo e pronto para a máquina em estilos profissionais criados para plotters de caneta e gravadores a laser - desenho de linhas, hachura, pontilhado e muito mais. Os caminhos de saída são estruturados como traços discretos, minimizando o levantamento da caneta e o tempo de deslocamento.

Depois de obter o SVG, o conversor de SVG para G-Code gera o arquivo final com controle total sobre a taxa de avanço, a altura da caneta, a potência do laser e a ordem de classificação do percurso.

Este pipeline de dois passos — foto para SVG via Pixel2Lines, SVG para G-Code através do conversor — leva-o de qualquer foto para um arquivo pronto para a máquina sem a necessidade de competências de design vetorial ou conhecimento de G-Code.

Problemas e soluções comuns

• O desenho é espelhado: SVG Y aumenta para baixo; O Código G Y aumenta para cima. Ative a inversão do eixo Y no seu conversor.
• Tamanho de saída incorreto: incompatibilidade de DPI. Illustrator = 72, Inkscape antigo = 90, ferramentas modernas = 96. Combine o DPI do conversor com sua aplicação de origem ou defina as dimensões SVG em milímetros.
• A máquina gagueja nas curvas: muitos segmentos minúsculos a transbordar o buffer de movimento. Ative o ajuste do arco, aumente a tolerância de linearização ou diminua a velocidade de avanço.
• A caneta arrasta e nunca levanta: o comando M5 está em falta ou a folga Z é muito baixa para ser fisicamente levantada do papel.
• O trabalho demora muito mais tempo do que o esperado: ordem de percurso inadequada. Reordene os caminhos com o vpype antes de regenerar o G-Code.
• A máquina move-se para o local errado no início: origem do trabalho não definida. Volte para a posição inicial, mova até a origem desejada e execute G92 X0 Y0 antes de iniciar.