Glossário de G-code para impressão 3D — termos práticos e exemplos

O que este glossário explica

Um arquivo de G-code contém mais do que nomes de comandos. Ele também contém conceitos como deslocamento, extrusão, retração, altura de camada e compensação de pressão. Essas ideias descrevem o que uma sequência de comandos está tentando realizar.

As definições ligam cada termo a linhas que você consegue ver em um arquivo de G-code e explicam o que este visualizador de navegador mostra — e o que não mostra.

Conceito ≠ comando

Deslocamento, altura de camada e retração descrevem relações entre ações e estado; nenhum corresponde necessariamente a um único comando fixo. Identifique-os pelos modos anteriores, pelas coordenadas atuais, pelas mudanças de E, pelos comentários do fatiador e pelo firmware de destino.

Três níveis de significado

Movimento

Coordenadas, planos e velocidades de avanço descrevem para onde e como a ferramenta se move.

Material

O estado de extrusão e retração determina se um movimento deposita, escorva ou recolhe filamento.

Estado da máquina

Comandos modais e ajustes de firmware mudam a forma como os valores numéricos seguintes são lidos.

Como seis conceitos fundamentais se conectam

Onde um conceito deixa indícios

Fonte do indício	Forma típica	O que consegue mostrar
Comando direto	`G90, M83, M104`	Muda explicitamente o posicionamento, a extrusão, a temperatura ou outro alvo ou estado.
Sequência de valores	`X / Y / Z / E / F`	As diferenças entre linhas vizinhas ajudam a identificar direção, deposição, retração e mudanças de camada.
Comentário do fatiador	`;LAYER, ;TYPE, ;FEATURE`	Traz a intenção do fatiador, como número de camada, parede ou preenchimento; os rótulos exatos variam conforme o fatiador e não são universais.
Estado externo da máquina	`Configuração, macros, sensores, mecânica`	Determina a execução final e normalmente não pode ser reconstruído por completo a partir de um arquivo de G-code comum.

Deslocamento e extrusão dependem do contexto

Movimento de deslocamento

G1 X80 Y40 F9000

O cabeçote se move sem variação positiva de extrusão.

Movimento de extrusão

M83
G1 X120 Y40 E1.6 F1800

A extrusão relativa está ativa, então E1.6 deposita filamento durante o movimento.

G90             ; X/Y/Z absolutos
M83             ; E relativo
G1 Z0.20 F600   ; chegar à altura de impressão
G1 X60 E1.20    ; mover e depositar
G1 E-0.80       ; retrair
G0 X90 Y40      ; deslocar até a próxima área
G1 E0.80        ; escorvar

Esta sequência contém modos de posicionamento, uma pista de altura de camada, extrusão, retração, deslocamento e escorva. Nenhuma linha pode ser interpretada corretamente sem o estado anterior de G90/M83 e a posição atual.

Conceitos fáceis de confundir

Não confundir	Diferença essencial	Como distinguir no arquivo
Deslocamento / retração	O deslocamento muda de lugar; a retração puxa o filamento de volta por um instante para reduzir o escorrimento. Costumam ocorrer juntos, mas são ações diferentes.	Verifique o movimento em X/Y/Z e depois interprete E negativo, positivo ou inalterado conforme M82/M83.
Altura de camada / movimento em Z	Altura de camada é a espessura entre camadas depositadas. Um Z-hop também move Z, mas não cria automaticamente uma camada nova.	Compare os níveis de Z das trajetórias depositadas e use os comentários de camada como apoio; não conte toda mudança de Z como uma camada.
Velocidade de avanço / velocidade real	F pede uma velocidade programada. Trajetos curtos podem nunca alcançá-la por causa da aceleração, dos limites nas curvas e da capacidade da máquina.	O G-code mostra o F solicitado; a velocidade real também depende do planejamento do firmware e da configuração da máquina.
Valor de E / material depositado	E normalmente descreve uma coordenada ou um comprimento de filamento de entrada; não comprova que um volume equivalente de plástico saiu do bico.	O arquivo informa uma quantidade comandada; a deposição real depende também do diâmetro do filamento, do multiplicador de fluxo, da temperatura, do escorregamento e de entupimentos.
Pressure advance / retração	O pressure advance compensa dinamicamente conforme a velocidade de extrusão muda; a retração normalmente recolhe e devolve filamento em torno de um deslocamento. Podem coexistir.	A retração costuma aparecer nas mudanças de E ou em G10/G11; o pressure advance pode vir da configuração do firmware, de M900, de M572 ou de uma extensão do Klipper.

Os termos variam conforme o sistema

Firmwares de impressoras 3D, fatiadores e controladores CNC às vezes usam a mesma palavra para comportamentos diferentes — ou palavras diferentes para o mesmo objetivo. “Pressure advance”, por exemplo, corresponde a comandos e modelos de valores distintos em cada família de firmware.

Por isso as páginas do glossário ligam um conceito explicado em linguagem simples ao seu contexto de comandos, em vez de tratar o vocabulário de um firmware como universal.

Aprenda pelo problema que você quer resolver

Primeiro arquivo

Comece pelo posicionamento absoluto/relativo, depois G0/G1 e o modo de extrusão. Isso responde para onde a ferramenta vai e se o movimento deposita.

Diagnosticar fios

Examine junto o deslocamento, a retração, a escolha de trajetória, a temperatura e o controle de pressão. Só aumentar a retração não resolve filamento úmido, calor em excesso nem todo problema de trajetória.

Qualidade de superfície

Compare altura de camada, velocidade de avanço, extrusão e pressure advance na mesma trajetória, lembrando que F não comprova que a máquina atingiu aquela velocidade.

O que o visualizador pode mostrar

O que dá para ver no arquivo

O visualizador consegue mostrar os movimentos suportados, as mudanças de extrusão, os modos de coordenadas e alguns detalhes salvos pelo fatiador. Ele não confirma os ajustes da impressora nem prevê exatamente como a máquina física vai se mover.

Como usar a página de um termo

Comece pela definição concisa e depois confira o exemplo de código.
Siga o contexto dos comandos relacionados quando um estado modal alterar o resultado.
Use a nota sobre o visualizador para separar o que o arquivo mostra do que só a impressora pode decidir.

Fontes oficiais usadas neste guia

Redigido em 8 de agosto de 2026 com base na documentação primária de firmwares, controladores e fatiadores. As definições usam o significado compartilhado e mantêm explícitas as diferenças de cada sistema.

G-code glossário