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 a tu juego

Todo lo que sale de un dibujo tiene su propia tarjeta en el panel Exportación: el modelo para tu juego, el mismo modelo para un editor o una impresora, y cuatro imágenes. Accede desde la casilla Exportación del panel de configuración, o apunta el título de cualquier panel a ella.

Ctrl+E exporta el modelo y Ctrl+Mayús+E el dibujo, sin abrir nada.

Las exportaciones están dentro de la carpeta del proyecto, así que no tienen adónde ir hasta que el proyecto tenga una. Mientras tanto, todos los botones se dibujan inactivos con la razón en una ventana emergente.

Lo que termina en uno

Una capa que has ocultado no está en ninguno de estos archivos — ni el modelo, ni una imagen. La marca en el Panel de Capas se guarda con el proyecto, así que significa lo mismo mañana que hoy, y todo lo que se escribe aquí lo honra.

Un solo es diferente, y se detiene antes de un archivo de modelo. Cambia lo que estás mirando — la vista 3D, el arte lineal, cualquier imagen tomada de cualquiera — pero el .glb, el .bbmodel, el .obj y el .stl se construyen a partir de cada capa marcada de todas formas. El aislamiento no se guarda con el proyecto, así que un archivo de modelo que lo honrara saldría diferente mañana del mismo dibujo, sin nada en el dibujo que diga por qué.

Una capa desvanecida sale sólida, en todas partes excepto el PNG de obra — y ahí solo porque ese archivo es el lienzo 2D escrito. Ver Capas y profundidad.

Las tarjetas

Modelo 3D

<prefix>.glb y <prefix>.meshes.json — el modelo extruido y el acompañante que nombra sus partes, listo para que un juego lo cargue. Este es el que existe por la aplicación.

El .glb contiene la malla, un atlas PNG incrustado y una jerarquía de nodos sprite → layer → island.

El acompañante existe porque Model de raylib no tiene nombres de malla, solo un array Meshes. Mapea índice a isla para que puedas encontrar “la espada” en un modelo sin contar. Los nombres de isla están numerados por capa, así que busca las partes por path ("face/part_1") en lugar de por nombre simple.

Material sin iluminación es el único conmutador de la tarjeta. Activado, el archivo le dice a quien lo abre que dibuje tus colores exactamente como están pintados — sin iluminación, sin sombras — que es como la vista 3D propia de Flatty los muestra. Blender lo respeta, al igual que cualquier motor que entienda glTF sin iluminación; raylib nunca ha oído hablar de ello e ilumina el modelo como siempre lo hizo, así que la opción no cuesta nada a un juego raylib. Es una preferencia más que una opción del proyecto: dice cómo debe iluminar un motor el archivo, y un juego quiere la misma respuesta para cada exportación.

Para editores

El mismo modelo para alguien que quiere seguir trabajando en él.

Export. para Blockbench (BBMODEL) escribe <prefix>.bbmodel, un proyecto de Blockbench que se abre sin importador ni complemento: cada capa un grupo, cada pieza una malla de cuadriláteros, la textura dentro del archivo. Usa esto siempre que Blockbench sea donde va el modelo — es la única ruta en la que nada se adivina al entrar.

Export. modelo 3D (OBJ) escribe tres archivos que solo funcionan juntos:

ArchivoEs
<prefix>.objla geometría, como cuadriláteros
<prefix>.mtlel archivo de material que nombra el .obj
<prefix>.atlas.pngla textura que nombra el material

Borra cualquier acompañante y el modelo se importa sin textura — así funciona OBJ, y cada programa que lo lee espera los tres juntos.

En Blender, establece la textura en Closest. Un OBJ no tiene forma de pedir muestreo de vecino más cercano, así que el importador de Blender deja la imagen en Linear y un atlas pequeño emborrana las caras, con un borde oscuro alrededor de cada una donde el borde de un píxel se promedia con la transparencia al lado. Selecciona el material, encuentra el nodo Image Texture, y cambia Interpolation a Closest; el desenfoque y el borde se van juntos. La información del botón dice lo mismo, ya que el archivo no puede.

Impresión 3D

Export. para imprimir (STL) escribe <prefix>.stl: el modelo como un sólido cerrado, listo para un cortador, a un milímetro por píxel — un sprite de 32 píxeles llega con 32 mm de ancho. Px / unid. no se aplica aquí; dice cuán grande es el modelo en un mundo de juego, no en una mesa.

Las capas que se superponen o se sientan una dentro de la otra salen como un cuerpo, sin nada dentro — una impresora necesita una superficie hermética, y eso es lo que esto escribe. El sólido es blanco en cada visor, porque STL contiene solo geometría, y está donde el punto de anclaje lo pone: abajo centro descansa el punto más bajo en el suelo, Centro en el panel Proyecto lo centra en su lugar.

Obra

<prefix>.png — el lienzo 2D pintado, compuesto plano, en su propio tamaño de píxel. El sprite, en otras palabras.

Dibujo lineal

<prefix>.svg y <prefix>.vector.png para el mismo dibujo rasterizado.

El renderizador y el estilo están en el panel Vector — esta tarjeta solo escribe lo que ese panel está configurado para dibujar. El tamaño de imagen es el borde largo del PNG; el SVG es un archivo vectorial y no tiene tamaño de píxel.

Vista 3D

<prefix>.view.png — una fotografía de la vista 3D en este espacio de trabajo, sin el suelo debajo. La imagen es el modelo; un suelo pertenece a tu espacio de trabajo, no a lo que estás exportando.

ControlHace
Tamaño de imagenel borde largo
Formala misma forma que la vista, o una fija. La cámara mira arriba y abajo por una cantidad fija, así que la forma decide cuánto es visible a los lados
Fondo transparenteactivado por defecto — solo el modelo, sin nada detrás, que se coloca en una página de tienda o un README sin un rectángulo alrededor

La tarjeta dice qué panel 3D está siguiendo, y si no hay vista 3D en este espacio de trabajo, mantiene el último ángulo en lugar de negarse.

Hay una tecla de cámara en el panel 3D que escribe la misma imagen, que suele ser el camino más corto: alineas la toma y luego la tomas.

Un modelo translúcido sobre nada se compone contra transparencia, así que el cristal de Lam::pula sale más oscuro de lo que parece en el panel, que se limpia a un fondo opaco. Activar el fondo es la respuesta, y es por eso que es un interruptor en lugar de un hecho.

Compartir

Empaquetar para compartir… — ver abajo.

Una grabación llega aquí también. El panel Grabadora escribe sus GIFs y vídeos en la misma carpeta exports con sus propios nombres — ver Grabación. Tiene su propio tamaño, porque una película paga por su tamaño en cada fotograma donde una imagen paga una vez.

Todo se escribe dos veces, a 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

El archivo es lo que evita que una exportación destruya la anterior. La copia estable es la que permite que tu juego codifique una ruta que no cambia cada vez que presionas el botón.

Apunta rl.LoadModel a exports/latest/.

Ambas copias son el mismo modelo. El nombre de la escena, el nodo raíz y el atlas toman el prefijo del proyecto — deliberadamente no el nombre de archivo — para que un consumidor leyendo el nombre de la escena no lo vea cambiar porque una marca de tiempo lo hizo. El acompañante es lo único que difiere: cada copia nombra el .glb que está al lado.

Mostrar carpeta abre la carpeta de exportaciones en tu gestor de archivos, y Mostrar la carpeta después lo hace en cada exportación, con el archivo que acaba de escribir marcado donde tu escritorio pueda hacerlo.

Prefijo

El campo Prefijo es cómo se llaman los archivos de exportación. Sigue automáticamente el nombre del proyecto hasta que lo edites tú mismo, momento en el que deja de rastrear — renombrar silenciosamente los archivos de alguien es peor que dejar que los dos se separen. La tarjeta dice cuál de los dos está pasando.

El slug que convierte un nombre en un prefijo pliega acentos en lugar de eliminarlos: Zażółć se convierte en zazolc, no en z.

Punto de anclaje y escala

Ambos están en el panel Proyecto, bajo Colocación en el mundo.

Px / unid. establece la escala: a 16, un sprite de 64 píxeles se convierte en 4 unidades del mundo.

El punto de anclaje predetermina abajo-centro, así que DrawModel(m, pos, ...) pone los pies de un personaje en pos.

Dibuja tu personaje tocando la parte inferior del lienzo. X e Y vienen del lienzo, no de los límites ajustados del dibujo. Es deliberado: los fotogramas de una animación deben compartir un origen, y los límites ajustados lo moverían cada vez que el contorno cambia.

Cargándolo en raylib

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

// La única línea que tienes que añadir. El archivo pide filtrado de vecino más cercano en
// su muestreador glTF, pero el cargador de raylib no aplica muestreadores glTF — así que
// sin esto tus píxeles salen 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)  // el punto de anclaje está incorporado

Es la integración completa. Sin paso de conversión, sin ajustes de importación, sin materiales que reconstruir.

Abrir el .glb en Blender

Si el modelo se importa gris, cambia el visor fuera del sombreado sólido — pulsa Z y elige Vista previa de material, o haz clic en la tercera esfera arriba a la derecha del visor 3D.

El modo Sólido predeterminado de Blender ignora completamente los materiales y muestra cada malla en gris plano, lo que parece idéntico a un modelo que genuinamente no tiene textura. El archivo está bien.

Una banda más clara que atraviesa diagonalmente el modelo es la iluminación de Blender, no tu textura. Material Preview ilumina el modelo desde un entorno de estudio y deja que la capa frontal proyecte una sombra en la capa detrás; la banda es la tira que no está en sombra, y cruza varias caras como una línea recta, cosa que ninguna textura podría hacer. Cambia a sombreado Solid con Lighting: Flat y se va. Mejor aún, activa Material sin iluminación antes de exportar: entonces Blender dibuja los colores como están pintados, exactamente como lo hace el panel 3D.

Blockbench abre el .glb a través de su complemento glTF, y la exportación está dispuesta para que lo haga; el .bbmodel sigue siendo la mejor puerta, porque llega como cuadriláteros con sus capas ya agrupadas.

Transparencia

Si algún texel en el atlas es translúcido, el material se escribe con alphaMode: "BLEND". Si ninguno lo es, no se escribe la clave alphaMode en absoluto y el modelo se comporta exactamente como uno opaco. El conmutador Material sin iluminación no cambia ninguno: quita la iluminación y deja la transparencia exactamente como estaba.

Ver Color para saber por qué y qué cuesta el mezcladado.

Empaquetar un proyecto para enviar

Empaquetar para compartir… pide una carpeta nueva y vacía y copia el proyecto en ella junto con cada recurso de biblioteca que usa — las texturas y paletas que de otro modo viven en tus carpetas en lugar del proyecto. Comprime esa carpeta y es una entrega completa. Ver Tus bibliotecas.

Exportar sin abrir la ventana

Para scripts de construcción:

flatty -open ./sprites/cloud -export     # escribir exports/ y exports/latest/
flatty -project ./sprites/cloud -save    # crear el archivo del proyecto

Ambos se ejecutan sin cabeza y salen. Necesitan un lugar para escribir, así que se niegan a ejecutarse sin -project u -open en lugar de inventar una ruta — y ninguno toca tus ajustes ni tu lista de proyectos recientes en el camino.