Ir al contenido
Descargar
Guía de Gobu

Materiales

Gobu nombra sus materiales como Unreal:

GobuQué esArchivo
MaterialEl código: un shader_type y sus funciones..material
MaterialInstanceUsa un Material y guarda los valores de sus parámetros. Es lo que se asigna a las mallas..tres
MaterialFunctionFunciones reutilizables que se incluyen con #include..materialfn
LayeredMaterialUn material hecho de una pila de capas, sin código..tres

StandardMaterial3D, CanvasItemMaterial y los materiales de cielo funcionan como siempre. Los proyectos guardados con los nombres de antes (.gdshader, ShaderMaterial, ShaderInclude) siguen cargando; al guardarlos se escriben los nuevos.

Abre el menú de un hueco de material en el Inspector y elige Material Library…: la Material Library se abre en una ventana flotante. Muestra materiales listos por categoría (Real-world y Stylized), con un buscador (wood, metal, gold, toon…).

La Material Library: las categorías Real-world y Stylized, el buscador y los materiales de la biblioteca

Haz clic en un material: se copia al proyecto (res://Materials/) y se pone en ese hueco. La copia es tuya para editarla; la biblioteca no cambia. La copia aparece en el panel Assets cuando el sistema de archivos se vuelve a escanear.

La pelota seleccionada: su hueco de material tiene MI_GlossyPlastic, copiado a la carpeta Materials del proyecto

La biblioteca viene con el editor, ya compilada: aplicar un material nunca espera a que se compile un shader.

Un LayeredMaterial es una pila de capas, como en Spline o en un editor de imágenes. Créalo en cualquier hueco de material (New LayeredMaterial) y usa Add Layer:

CapaQué añade
ColorUn color plano.
GradientDos colores según la altura, el ancho, la profundidad, la distancia o el ángulo de vista.
NoiseRuido value, Perlin, celular o fractal entre dos colores.
FresnelUn color en los bordes.
TextureUna textura por UV o triplanar (no necesita UV).
MatcapUna textura matcap.
PatternRayas, ajedrez, lunares o rejilla.

Cada capa tiene un modo de mezcla (normal, multiply, screen, overlay, soft light, add), una opacidad y un destino (el color de la superficie o su emisión). La tarjeta de arriba se dibuja sobre las de abajo; se reordenan con las flechas. Shading elige PBR, sin sombreado o toon.

Un LayeredMaterial en el Inspector: Add Layer, las tarjetas de las capas Fresnel y Gradient con sus flechas, los ajustes de la capa de arriba y Shading

Cambiar un color o un valor es instantáneo. Los materiales con la misma estructura de capas comparten un único programa compilado, así que una escena con muchos sigue siendo barata.

Para seguir en código, en el menú del recurso: Convert to MaterialInstance.

Los materiales se escriben en el lenguaje de shaders (shader_type spatial;, void fragment()…). El motor incluye una biblioteca de funciones que se pueden usar desde cualquier material:

shader_type spatial;
#include "gobu://triplanar.materialfn"
#include "gobu://noise.materialfn"
uniform sampler2D rock : source_color;
void fragment() {
vec3 world = (INV_VIEW_MATRIX * vec4(VERTEX, 1.0)).xyz;
vec3 n = mat3(INV_VIEW_MATRIX) * NORMAL;
ALBEDO = gobu_triplanar(rock, world, n, 0.5, 4.0).rgb;
ALBEDO *= 0.8 + 0.2 * gobu_value_noise3d(world * 2.0);
}
MóduloFunciones
noisevalue, perlin, simplex, worley, fbm; actores MaterialX mx_noise3d, mx_fractal3d…
colorluminancia, HSV, cambio de tono, saturación, contraste, sRGB ↔ lineal, degradados
uvrepetición, rotación, polares, remolino, flipbook, desplazamiento, parallax
triplanarproyección de texturas y normal maps sin UV
normalmezcla de normales, normales a partir de una altura
blendmodos de mezcla (multiply, screen, overlay…), mezcla por altura
lightingfresnel, borde, rampa toon, difuso envolvente, UV de matcap
windviento en los vértices y temblor de hojas
sdf2dformas 2D, unión suave, relleno y contorno sin dientes
billboardbillboards que miran a la cámara

En el editor de materiales, el menú Library muestra cada función con su descripción: al elegir una añade el #include (si falta) y la llamada en el cursor. #include "gobu:// también se autocompleta.

El editor de materiales con un material que incluye gobu://triplanar y gobu://noise, y el menú Library

Solo las funciones que llamas acaban en el shader compilado.

Los materiales de la biblioteca son instancias de unos pocos maestros (M_Surface, M_Toon, M_Water, M_Glass, M_Foliage…). Un maestro declara switches para las opciones:

shader_type spatial;
#pragma switch USE_TRIPLANAR
uniform sampler2D albedo : source_color;
void fragment() {
#ifdef USE_TRIPLANAR
// ...
#else
ALBEDO = texture(albedo, UV).rgb;
#endif
}

Una MaterialInstance suya muestra su maestro en Shader, y un grupo Switches con una casilla por cada uno. Un switch apagado no cuesta nada: no se compila (a diferencia de un if sobre un uniform). Las instancias con los mismos switches comparten un programa compilado, y el inspector solo muestra los parámetros de los switches activos.

Una MaterialInstance de M_Surface en el Inspector: su maestro y el grupo Switches con una casilla por switch