Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Exportar para o teu jogo

Tudo o que sai de um desenho tem um cartão próprio no painel Exportação: o modelo para o teu jogo, o mesmo modelo para um editor ou uma impressora, e quatro imagens. Chega lá a partir do mosaico Exportação do painel de configuração, ou aponta a barra de título de qualquer painel para lá.

Ctrl+E exporta o modelo e Ctrl+Shift+E o desenho, sem abrir nada.

As exportações vivem dentro da pasta do projeto, não há para onde ir até o projeto ter uma. Até lá cada botão aqui desenha-se inerte, com a razão numa dica.

O que acaba num

Uma camada que ocultaste não está em nenhum destes ficheiros — nem no modelo, nem numa imagem. A marca na lista de Camadas é guardada com o projeto, por isso significa a mesma coisa amanhã que significa agora, e tudo escrito daqui honra-a.

Um solo é diferente, e não chega a um ficheiro de modelo. Muda o que estás a ver — a vista 3D, a arte de linhas, qualquer imagem tirada de uma delas — mas o .glb, o .bbmodel, o .obj e o .stl são construídos a partir de todas as camadas marcadas independentemente. Solo não é guardado com o projeto, por isso um ficheiro de modelo que o honrasse sairia diferente amanhã do mesmo desenho, com nada no desenho para explicar porquê.

Uma camada desvanda sai sólida, em todo o lado exceto o PNG de desenho — e aí apenas porque esse ficheiro é a tela 2D escrita. Ver Camadas e profundidade.

Os cartões

Modelo 3D

<prefix>.glb e <prefix>.meshes.json — o modelo extrudido e o ficheiro acompanhante a nomear as suas partes, pronto para um jogo carregar. É para isto que a aplicação existe.

O .glb tem a malha, um atlas PNG integrado e uma hierarquia de nós de sprite → camada → ilha.

O ficheiro acompanhante existe porque o Model do raylib não tem nomes de malha, apenas um array Meshes. Mapeia índice para ilha para que consigas encontrar “a espada” num modelo sem contar. Os nomes das ilhas são numerados por camada, por isso procura as partes por path ("face/part_1") em vez de apenas por nome.

Material sem iluminação é o único interruptor da ficha. Ligado, o ficheiro diz a quem o abre para desenhar as cores exatamente como foram pintadas — sem iluminação, sem sombras — é assim que a vista 3D do Flatty as mostra. O Blender reconhece-a, assim como qualquer motor que entende glTF sem iluminação; o raylib nunca ouviu falar dela e ilumina o modelo como sempre fez, por isso o interruptor não custa nada a um jogo raylib de qualquer maneira. É uma preferência em vez de uma definição de projeto: diz como um motor deve iluminar o ficheiro, e um jogo quer a mesma resposta para todas as exportações.

Para editores

O mesmo modelo para quem quer continuar a trabalhar nele.

Export para Blockbench (BBMODEL) escreve <prefix>.bbmodel, um projeto Blockbench que abre sem importador nem plugin: cada camada é um grupo, cada peça é uma malha de quadrados, a textura dentro do ficheiro. Usa isto sempre que o Blockbench for o destino do modelo — é a única rota em que nada é adivinhado na entrada.

Export modelo 3D (OBJ) escreve três ficheiros que só funcionam juntos:

FicheiroÉ
<prefix>.obja geometria, como quadrados
<prefix>.mtlo ficheiro de material que o .obj nomeia
<prefix>.atlas.pnga textura que o material nomeia

Elimina qualquer acompanhante e o modelo importa sem textura — é assim que o OBJ funciona, e cada programa que o lê espera os três lado a lado.

No Blender, define a textura para Mais próximo. Um OBJ não tem forma de pedir amostragem vizinho mais próximo, por isso o importador do Blender deixa a imagem em Linear e um atlas pequeno borra pelas faces, com uma franja escura à volta de cada uma, onde a borda de um pixel é media com a transparência ao lado. Seleciona o material, encontra o nó de Textura de Imagem e muda Interpolação para Mais próximo; o borrão e a franja desaparecem juntos. A dica da ferramenta diz o mesmo, já que o ficheiro não pode.

Impressão 3D

Export para impressão (STL) escreve <prefix>.stl: o modelo como um sólido fechado, pronto para uma fatiadora, a um milímetro por pixel — um sprite de 32 pixéis chega com 32 mm de largura. Px / unid. não se aplica aqui; diz o quão grande o modelo é num mundo de jogo, não numa secretária.

As camadas que se sobrepõem ou ficam dentro umas das outras saem como um corpo, sem nada lá dentro — uma impressora precisa de uma superfície estanque única, e é isto que isto escreve. O sólido é branco em cada visualizador, porque STL contém geometria e nada mais, e fica onde o ponto de apoio a coloca: centro inferior repousa o ponto mais baixo no chão, Centro no painel Projeto centra-o em vez disso.

Desenho

<prefix>.png — a tela 2D tal como desenhada, composta em plano, no seu próprio tamanho de pixel. O sprite, por outras palavras.

Desenho de linhas

<prefix>.svg, e <prefix>.vector.png para o mesmo desenho rasterizado.

O renderizador e o estilo vivem no painel Vector — este cartão apenas escreve o que esse painel está configurado para desenhar. Tamanho da imagem é o lado maior do PNG; o SVG é um ficheiro vetorial e não tem tamanho de pixel para dar.

Vista 3D

<prefix>.view.png — uma fotografia da vista 3D neste espaço de trabalho, sem o chão por baixo. A imagem é o modelo; um chão pertence ao teu espaço de trabalho em vez de pertencer à coisa que estás a exportar.

ControleFaz
Tamanho da imagemo lado maior
Formaa mesma forma que a vista, ou uma fixa. A câmara olha para cima e para baixo por uma quantidade fixa, por isso a forma decide quanta visibilidade há para os lados
Fundo transparenteligado por padrão — o modelo sozinho, sem nada por trás, que cai numa página de loja ou num README sem um retângulo à volta

O cartão diz qual painel 3D está seguindo, e se não há vista 3D neste espaço de trabalho, segura o último ângulo em vez de recusar.

Há uma tecla de câmara no próprio painel 3D que escreve a mesma imagem, que é geralmente o caminho mais curto: alinhas o disparo e depois tiras-o.

Um modelo translúcido sobre nada compõe contra a transparência, por isso o vidro de Lam::pula sai mais escuro do que parece no painel, que limpa para um fundo opaco. Ligar o fundo é a resposta, e é por isso que é um comutador em vez de um facto.

Partilhar

Empacotar para partilhar… — vê abaixo.

Uma gravação também cai aqui. O painel do Gravador escreve os seus GIFs e vídeos na mesma pasta exports com os seus próprios nomes — vê Gravação. Tem o seu próprio tamanho, porque um filme paga o seu tamanho em cada quadro onde uma imagem paga uma vez.

Tudo é escrito duas vezes, de propósito

fluffy cloud/
  exports/
    2026-08-21_144312_fluffy_cloud.glb    kept forever, never overwritten
    2026-08-21_144312_fluffy_cloud.meshes.json
    latest/
      fluffy_cloud.glb                    replaced by every export
      fluffy_cloud.meshes.json

O arquivo é o que impede uma exportação de destruir a anterior. A cópia estável é o que deixa o teu jogo codificar um caminho que não muda cada vez que pressas o botão.

Aponta rl.LoadModel para exports/latest/.

Ambas as cópias são o mesmo modelo. O nome da cena, o nó raiz e o atlas todos tomam o prefixo do projeto — deliberadamente não o nome do ficheiro — para que um consumidor lendo o nome da cena não o veja mudar porque um timestamp mudou. O ficheiro acompanhante é a única coisa que difere: cada cópia nomeia o .glb sentado ao lado.

Mostrar pasta abre a pasta de exportações no teu gestor de ficheiros, e Mostrar a pasta depois faz-o em cada exportação, com o ficheiro que acabou de escrever marcado onde o teu desktop consegue fazer isso.

Prefixo

O campo Prefixo é como os ficheiros de exportação são chamados. Segue automaticamente o Nome do projeto até o editar tu próprio, nesse ponto deixa de seguir — renomear silenciosamente os ficheiros de alguém é pior do que deixar os dois afastarem-se. O cartão diz qual dos dois está acontecendo.

A slug que transforma um Nome num Prefixo dobra acentos em vez de eliminá-los: Zażółć torna-se zazolc, não z.

Ponto de apoio e escala

Ambos estão no painel Projeto, sob Colocação no mundo.

Px / unid. define a escala: em 16, um sprite de 64 pixéis torna-se 4 unidades do mundo.

O ponto de apoio padrão é baixo-centro, por isso DrawModel(m, pos, ...) coloca os pés de um personagem em pos.

Desenha o teu personagem tocando o fundo da tela. X e Y vêm da tela, não dos limites justos do desenho. Isto é deliberado: os quadros de uma animação devem partilhar uma origem, e limites justos moveriam-a cada vez que a silhueta mudasse.

Carregá-lo no raylib

m := rl.LoadModel("sprites/fluffy cloud/exports/latest/fluffy_cloud.glb")

// A única linha que tens de adicionar. O ficheiro pede filtragem de vizinho mais próximo
// no seu amostrador glTF, mas o carregador do raylib não aplica amostradores glTF — portanto
// sem isto os teus pixéis saem suavizados.
for _, mat := range m.GetMaterials() {
    if tex := mat.GetMap(rl.MapAlbedo).Texture; tex.ID != 0 {
        rl.SetTextureFilter(tex, rl.FilterPoint)
    }
}

rl.DrawModel(m, playerPos, 1, rl.White)  // o ponto de apoio está incorporado

Isto é toda a integração. Nenhuma etapa de conversão, nenhuma definição de importação, nenhum material a reconstruir.

Abrir o .glb no Blender

Se o modelo importa cinzento, muda o viewport para fora do sombreamento Solid — prime Z e escolhe Material Preview, ou clica a terceira esfera no canto superior direito do viewport 3D.

O modo Solid padrão do Blender ignora completamente os materiais e mostra cada malha em cinzento plano, o que parece idêntico a um modelo que genuinamente não tem textura. O ficheiro está bem.

Uma faixa mais clara a correr diagonalmente pelo modelo é a iluminação do Blender, não a tua textura. A Pré-visualização de Material ilumina o modelo a partir de um ambiente de estúdio e deixa a camada frontal projetar uma sombra na camada atrás; a faixa é a tira que não está em sombra, e cruza várias faces como uma linha reta, o que nenhuma textura poderia fazer. Muda para sombreado Sólido com Iluminação: Plana e desaparece. Melhor, liga o Material sem iluminação antes de exportar: o Blender desenha então as cores como foram pintadas, exatamente como o painel 3D faz.

O Blockbench abre o .glb através do seu plugin glTF, e a exportação é organizada para que o faça; o .bbmodel é ainda a melhor porta, porque chega como quadrados com as camadas já agrupadas.

Transparência

Se qualquer texel no atlas é translúcido, o material é escrito com alphaMode: "BLEND". Se nenhum for, nenhuma chave alphaMode é escrita e o modelo comporta-se exatamente como um opaco. O interruptor de Material sem iluminação não muda nenhum: tira a iluminação e deixa a transparência exatamente como estava.

Vê Cor para entender porquê, e o que o místurar custa.

Empacotar um projeto para enviar

Empacotar para partilhar… pede uma pasta nova e vazia e copia o projeto para dentro com cada ativo da biblioteca que usa — as texturas e paletas que de outra forma vivem nas tuas pastas em vez de no projeto. Faz zip daquela pasta e é uma entrega completa. Vê As tuas bibliotecas.

Exportar sem abrir a janela

Para scripts de construção:

flatty -open ./sprites/cloud -export     # escrever exports/ e exports/latest/
flatty -project ./sprites/cloud -save    # criar o ficheiro de projeto

Ambos correm headless e saem. Precisam de um lugar para escrever, por isso recusam correr sem -project ou -open em vez de inventar um caminho — e nenhum toca nas tuas definições ou na tua lista de projetos recentes.