Converter STL para GLTF

Nenhum navegador renderiza STL nativamente nem renderiza glTF nativamente — os dois precisam de um runtime. O que muda é a qualidade do caminho: three.js embarca um leitor de STL, então servir o STL direto parece razoável, e para uma ferramenta interna é uma resposta aceitável.

Deixa de ser razoável quando a página é pública e o modelo é o conteúdo. Um STL é o jeito menos eficiente de mover uma malha por uma conexão que existe, não carrega limites de câmera, e todo triângulo chega com seus próprios três vértices. glTF foi desenhado exatamente para essa transferência.

Um STL binário tem exatamente 84 + 50n bytes para n triângulos, independente da forma. Cinquenta desses bytes são doze para uma normal de face, trinta e seis para três vértices completos e dois sem uso. Nada é compartilhado: um cubo são trinta e seis registros de vértice para oito cantos distintos.

A conversão arredonda coordenadas em seis casas decimais para formar uma chave e funde todo canto na mesma posição num único vértice. Numa superfície fechada, cada vértice costuma servir cinco ou seis triângulos, então os dados de vértice caem por aproximadamente esse fator.

Uma cena, um nó, uma malha, uma primitiva em modo triângulo, um acessor de posição float32 VEC3 e um acessor de índice uint32 SCALAR. O buffer é embutido como data URI base64, então o arquivo é autocontido.

O acessor POSITION carrega mínimo e máximo, exigidos pela especificação, e é a diferença prática entre um modelo que aparece e um que não aparece. model-viewer e three.js derivam a distância inicial da câmera desses seis números.

Nenhum atributo NORMAL é escrito, e a especificação glTF instrui visualizadores a calcularem normais de face chapadas quando uma malha não tem nenhuma. Num modelo orgânico importado de uma ferramenta de escultura, isso pareceria defeito. Numa peça que saiu de um CAD como STL, é a verdade.

Um STL não tem superfície curva. Tem os triângulos que o exportador produziu na tolerância definida, e uma renderização suave deles seria uma mentira sobre a geometria que uma impressora vai reproduzir de fato.

STL não declara unidade, e o mundo da engenharia e da impressão lê seus números como milímetro. glTF 2.0 define sua unidade linear como metro. A conversão copia as coordenadas sem alterar, porque reescalar por um fator que a origem nunca declarou seria um chute.

Então um suporte de 60 mm vira um suporte de 60 metros em termos glTF. Nada parece errado isoladamente — a câmera enquadra pelos limites e o modelo preenche a vista —, mas fica errado assim que ele fica ao lado de outra coisa numa cena. Ajuste uma escala uniforme de 0,001 no nó do seu visualizador.

Como um STL não tem partes, grupos ou objetos, o glTF contém exatamente uma primitiva — o mais barato que existe para renderizar, e significa que um modelo derivado de STL nunca sofre o problema de múltiplas chamadas de desenho que uma exportação CAD com trezentos grupos cria.

Também não tem material, textura, UV nem cor de vértice, porque o STL não tinha nenhum. Seu visualizador aplica o padrão dele, geralmente um cinza médio físico. Atribuir algo melhor no three.js é uma linha, e vale fazer.

O .gltf escrito aqui embute o buffer como data URI base64, então não há .bin para servir ao lado nem caminho relativo para quebrar. Base64 custa quatro caracteres por três bytes, então essa conveniência custa cerca de 33% mais bytes.

Para um arquivo que você vai inspecionar ou processar depois, pegue o glTF. Para o arquivo que o visitante de fato baixa, pegue o GLB: mesma geometria, mesmos limites, buffer binário, uma requisição só. Converter um STL para qualquer um dos dois é a mesma operação aqui.

STL binário e ASCII compartilham extensão e o arquivo não diz qual é. O teste comum — checar se o arquivo começa com a palavra "solid" — é pouco confiável, porque o cabeçalho de oitenta bytes de um STL binário pode conter qualquer texto.

O teste confiável é aritmético: um STL binário tem exatamente 84 + 50n bytes para a contagem de triângulos no seu cabeçalho, e é isso que este conversor usa. Se o comprimento não bater, o arquivo é decodificado como texto.

Para lugar nenhum. O par roda como JavaScript puro na página — nenhum motor WebAssembly a baixar, nenhuma requisição carregando o modelo, nenhuma fila. Isso importa mais que o normal aqui, porque os STLs que as pessoas convertem para uma prévia web costumam ser a peça de um cliente ou um produto ainda não lançado.

O teto gratuito é 100 MB, o que a cinquenta bytes por triângulo dá um modelo de dois milhões de triângulos. Arquivos desse tamanho valem decimação antes da conversão em vez de depois.