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

O teu primeiro modelo

Dez minutos, do início ao fim: desenha algo, dá-lhe espessura, e obtém um .glb que o teu jogo pode carregar.

1. Começar um projeto

O Flatty abre num selecionador. Lista os projetos que abriste antes — por isso numa execução genuinamente primeira é vazio, enquanto o de baixo já foi usado uma vez.

Carrega em Novo projeto. O navegador de ficheiros abre, e quer uma coisa: a pasta onde o teu projeto vai viver.

Navega até onde guardas o teu trabalho, depois digita um nome na linha sob a listagem — nuvem fofa serve — e carrega em Criar. Cria uma pasta com esse nome dentro daquela em que estás, que é tudo o que é um projeto.

A linha no fundo explica exatamente o que vai ser escrito, por isso nunca há adivinhação:

-> /home/you/sprites/fluffy cloud/project.fdraw

A pasta é o projeto. Não há biblioteca nem base de dados: um projeto é qualquer pasta contendo um ficheiro project.fdraw, e pode estar em qualquer lado. Move-o, copia-o, coloca-o num pen drive — continua um projeto. O nome no painel Projeto é teu para mudar sempre que quiseres.

2. Desenhar algo

Está a ver a tela, grande e no canto superior esquerdo, com as ferramentas, as cores e a lista de camadas numa faixa por baixo. À direita estão as duas vistas do que está a fazer: o modelo em cima e o seu desenho de linhas por baixo. Pinte na tela com o botão esquerdo do rato.

Desenha um blob sólido — uma nuvem, um rosto, um escudo, o que quiseres. Mantém simples e mantém tocando o fundo da tela se é uma personagem; é aí que vai o pivo do modelo, por isso uma personagem desenhada na borda inferior fica em pé no chão no teu jogo.

Algumas coisas a experimentar logo:

Faz istoObtém isto
[ e ]pincel mais pequeno e maior
Ctrl+arrastarpintar com a segunda cor
Shift+arrastarapagar de volta para transparente
Alt+cliquetirar uma cor da tela
G, depois clicainundar uma zona com enchimento
Uformas — uma linha, uma caixa, uma elipse, um polígono
S, ou o botão direito na telao Canivete Suíço — cores, ferramentas e camadas sob o cursor
Ctrl+Zdesfazer
Ctrl+Ppedir qualquer coisa pelo nome — cada painel e cada comando

Esse último vale a pena experimentar cedo. A maioria do que Flatty pode fazer vive num painel que ainda não colocaste no ecrã, e a paleta de comandos é como o encontras sem ter aprendido onde está.

Observa o painel direito enquanto trabalhas. O modelo é reconstruído enquanto desenhas — nunca estás à espera de uma pré-visualização.

3. Dar profundidade

O modelo é atualmente uma laje plana. Muda isso no painel Camadas.

Clica no separador de título de qualquer painel — a pequena etiqueta preenchida no seu canto superior esquerdo, lendo Tela 2D com um ponto de intercalação depois — e escolhe Camadas. Acima da lista de camadas há um cartão para a camada em que estás, e o seu primeiro controlo deslizante é Profundidade. Arrasta-o e observa a forma sair.

O deslizador por baixo é a outra metade do que transforma uma pilha de camadas em relevo. Desvio Z move a laje desta camada para frente ou para trás através do volume, por isso um nariz pode ficar em frente de um rosto em vez de dentro dele.

Dois números mais, vale a pena um momento, ambos no painel Projeto:

  • Paredes laterais → Sombrear escurece a cor dos lados extrudidos em relação à face frontal. Mais baixo é mais escuro. Isto é o que impede um modelo parecer um adesivo.
  • Colocação no mundo → Px / unidade define a escala: em 16, um sprite de 64 pixels tem 4 unidades de mundo de largura.

4. Observar apropriadamente

No painel 3D, arrastra com o botão esquerdo para orbitar, usa a roda para te aproximares, e arrastra com o botão do meio para deslocar. O ícone no canto denominado Órbita livre muda para um ângulo fixo — frente, trás, esquerda, direita, topo ou isométrico — que é a forma honesta de verificar uma silhueta.

O terceiro ícone ao longo dessa linha é como o modelo é sombreado. Flatty são as tuas cores exatamente como as pintaste, e é para o qual deves voltar antes de decidir que uma sombra está errada; os três ao lado são formas estilizadas de ver o mesmo modelo, e as imagens neste livro usam uma delas.

Não importa qual escolhas, a exportação não é afetada — ver A vista 3D.

5. Guardar e exportar

Ctrl+S guarda o projeto. Ctrl+E exporta o modelo. Tudo o que sai de um desenho tem um botão próprio no painel Exportação, que a chave de configuração no canto inferior direito da janela te colocará para fora.

A tua pasta de projeto agora parece assim:

fluffy cloud/
  project.fdraw                              the drawing — this is your work
  exports/
    2026-08-21_144312_fluffy_cloud.glb       an archive, never overwritten
    2026-08-21_144312_fluffy_cloud.meshes.json
    latest/
      fluffy_cloud.glb                       the one your game loads
      fluffy_cloud.meshes.json

Cada exportação é escrita duas vezes. Uma vez com um carimbo de tempo que nunca é substituído, por isso uma semana de trabalho ainda está lá para voltares. E uma vez em latest/ sob um nome fixo, porque o caminho no código do teu jogo não pode mudar cada vez que carregas em exportar.

6. Carregar no teu jogo

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

// A uma linha que tens de adicionar: o ficheiro pede filtragem de vizinho mais próximo,
// mas o carregador glTF do raylib não aplica esse pedido, por isso os teus pixels saem
// desfocados a menos que o digas novamente aqui.
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 pivo está incorporado — nenhum desvio necessário

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

Para onde ir em seguida

  • Camadas e profundidade — o capítulo que faz as formas deixarem de parecer lajes
  • Arte em linha — o mesmo modelo traçado como SVG, seis formas diferentes. Ninguém espera por este
  • Cor — as duas cores, a roda, paletas e transparência
  • Exportar para o teu jogo — pivôs, escala, Blender, e o que realmente está no ficheiro