Converter GLB para OBJ

O glTF e sua forma binária são bem mais novos que a maior parte do software que engenheiros e artistas realmente têm instalado. A Wavefront publicou o OBJ em 1992, e ele continua sendo o menor denominador comum: Blender, MeshLab e Maya leem, e também lê praticamente todo importador de CAD, ferramenta de reparo de malha, fatiador e utilitário acadêmico escrito desde então. Um GLB vindo de um pipeline web precisa virar OBJ para sequer abrir nesse mundo.

Vale entender a conversão como uma mudança de tipo, não uma perda de qualidade. Um GLB é uma cena: hierarquia de nós, materiais, texturas, animação, câmeras. Um OBJ é uma lista de pontos e os triângulos entre eles, mais um ponteiro para um arquivo de material separado. Tudo que não é geometria precisa achar outro lugar para morar, e nesta conversão não acha.

Três tipos de linha e nada além disso. Uma linha de comentário nomeando o programa, uma linha `o` por malha carregando o nome que vinha do GLB, uma linha `v` por vértice com três coordenadas decimais, e uma linha `f` por triângulo com três índices. Sem linhas `vt`, sem `vn`, sem grupos de suavização `s`, sem `usemtl`, sem `mtllib`.

A convenção de índices é a parte que costuma pegar quem escreve o próprio analisador de arquivos: no OBJ os índices começam em um, não em zero, e contam por todo o arquivo em vez de reiniciar a cada grupo. O conversor acompanha esse deslocamento enquanto percorre as malhas, então um segundo objeto referenciando seu próprio primeiro vértice é gravado com o total acumulado somado. Errar isso produz um OBJ que abre e mostra os triângulos errados, o que é pior do que um que simplesmente falha.

Um OBJ nunca guardou material dentro de si mesmo. Ele guarda uma linha `mtllib` apontando para um arquivo `.mtl` complementar, e é esse arquivo que guarda as cores, o brilho e os caminhos das texturas. Este conversor não grava linha `mtllib` nenhuma e não produz `.mtl` nenhum, então o OBJ fica materialmente vazio, e seu importador aplica o cinza padrão dele.

Isso é consequência de ler só a geometria. Os parâmetros de metálico-rugosidade do GLB, sua cor base, texturas de normal e coordenadas UV nunca são extraídos, então não há nada para escrever num MTL que não seria inventado. Inventar seria pior: um MTL com valores padrão plausíveis diz a um artista mais adiante que o material veio da origem quando não veio.

Cada nome de malha do glTF é gravado como a linha `o` daquele grupo no OBJ, então um modelo montado a partir de componentes nomeados — carcaça, suporte, tampa — entra no Blender ou no Maya como três objetos nomeados, e não como uma forma só. Uma malha sem nome na origem recebe um nome gerado para que a estrutura de grupos continue legível.

Isso importa mais do que parece. Numa conversão só de geometria, os nomes são quase a única informação semântica que sobrevive, e são o que permite que alguém do outro lado reatribua materiais às partes certas. Se o seu GLB tem malhas sem nome e você vai precisar dessa distinção, nomeie elas antes de exportar, não depois de importar.

O glTF pode posicionar uma mesma malha várias vezes referenciando ela a partir de vários nós com matrizes diferentes. O OBJ não tem equivalente. O conversor resolve a diferença percorrendo a cena, compondo cada matriz de nó com a do pai, e gravando a transformação de mundo resultante direto nas coordenadas dos vértices antes de escrever elas.

Então um GLB com uma malha de parafuso instanciada sessenta vezes produz um OBJ com sessenta grupos e sessenta cópias completas da geometria do parafuso. O modelo fica correto — é o único jeito de mantê-lo correto — e o arquivo fica sessenta vezes maior que a origem instanciada nessa região. Se o seu software de destino consegue instanciar, reconstruir a instância lá depois de importar costuma valer o esforço.

Nenhuma escala é aplicada. Quaisquer valores de coordenada que o GLB continha são gravados no OBJ sem alteração, na precisão em que o JavaScript imprime eles. Esse é o comportamento correto e também é uma armadilha, porque os dois formatos entendem um número de jeitos diferentes.

O glTF 2.0 define sua unidade linear como metro, então uma cadeira modelada em tamanho real tem coordenadas ao redor de 0,9. O OBJ não declara unidade nenhuma, e cada importador aplica sua própria suposição — comumente metros no Blender, comumente centímetros ou polegadas em ferramentas de CAD mais antigas. Confira a caixa delimitadora depois de importar contra uma dimensão que você conhece, uma vez, em vez de descobrir o fator depois numa peça impressa ou numa montagem.

Ele passa direto, como está. O glTF já guarda triângulos como índices numa lista de posições compartilhada, então não há nada para reconstruir: cada entrada do acessor vira uma linha `v` na mesma ordem, e cada índice vira uma entrada `f` apontando para ela. Nada é fundido neste caminho — a etapa de fusão que junta coordenadas coincidentes se aplica ao ler STL e OBJ, onde duplicatas são a norma, e não aqui.

Isso importa quando o GLB veio de um exportador de verdade, porque o glTF guarda uma UV e uma normal por vértice. Um vértice numa costura de textura ou numa aresta viva precisa ser dividido em duas ou três cópias na mesma posição para que os atributos possam diferir. Essas cópias sobrevivem no OBJ, onde os atributos que justificavam elas não sobrevivem, então um modelo fechado pode acusar arestas de fronteira ao longo das costuras. "Merge by Distance" no Blender, ou "Merge Close Vertices" no MeshLab, resolve isso num único comando.

Os três importam sem configuração nenhuma. Espere uma aparência facetada de imediato: sem linhas `vn` no arquivo, cada importador calcula normais planas por face, e uma superfície curva tesselada em triângulos parece exatamente a casca poligonal que é. "Shade Smooth" no Blender, ou um ângulo de auto-suavização perto de 30 graus, restaura a aparência que o GLB tinha.

Espere nenhum material. Atribuir um é um trabalho de dois cliques em qualquer um dos três programas, e vale fazer isso antes de qualquer outra coisa para o modelo ficar visível contra o fundo do visualizador. Se o modelo não aparece de jeito nenhum, a causa costuma ser escala, não uma importação falha — dê zoom na seleção e leia o painel de dimensões.

Se o destino lê glTF, não converta. Blender, three.js, Babylon.js, Unity, Unreal, o Visualizador 3D do Windows e o Preview do macOS abrem um GLB com o material intacto, e passar ele por um OBJ custa tudo isso de graça.

Converta quando o destino genuinamente não consegue ler glTF, ou quando você quer especificamente um arquivo de texto que dá para inspecionar, buscar ou comparar. Um OBJ é um vértice por linha e uma face por linha, o que faz dele o mais fácil de conferir a olho entre esses seis formatos — e é essa legibilidade, não fidelidade, a vantagem que ele mantém sobre tudo que veio depois.