ShaderLab: Propiedades

Los shaders pueden definir una lista de parámetros que deben establecer los artistas en el inspector de materiales de Unity. El bloque de propiedades en el archivo del shader los define.

Sintaxis

Propiedades

Properties { Property [Property ...] }

Define el bloque de propiedades. Dentro de llaves múltiples propiedades se definen como sigue.

Numbers (números) y Sliders (deslizadores)

name ("display name", Range (min, max)) = number
name ("display name", Float) = number
name ("display name", Int) = number

Todo esto define una propiedad de número (escalar) con un valor predeterminado. La forma Range hace que se muestre como un control deslizante entre los rangos min y max.

Colores y Vectores

name ("display name", Color) = (number,number,number,number)
name ("display name", Vector) = (number,number,number,number)

Define una propiedad de color con un valor predeterminado de componentes RGBA dados, o una propiedad de vector 4D con un valor predeterminado. Las propiedades de color tienen un selector de color que se muestra para ellas y se ajustan según sea necesario según el espacio de color (consulte Propiedades en Programas shaders). Las propiedades del vector se muestran como cuatro campos numéricos.

Texturas

name ("display name", 2D) = "defaulttexture" {}
name ("display name", Cube) = "defaulttexture" {}
name ("display name", 3D) = "defaulttexture" {}

Define una propiedad 2D texture, cubemap o 3D (volumen) respectivamente.

Detalles

Cada propiedad dentro del shader es referenciado por name (en Unity, es comúnmente comenzar los nombres de propiedades shader con rayita abajo “_”). La propiedad va a mostrarse en el inspector del material como display name. Para cada propiedad un valor predeterminado es dado después del signo igual:

• Para las propiedades Range y Float es simplemente un número, por ejemplo “13.37”.
• Para las propiedades de Color y Vector son cuatro números en parentesis, por ejemplo “(1,0.5,0.2,1)”.
• Para texturas 2D, el valor predeterminado es una cadena vacía o una de las texturas predeterminadas incorporadas: “blanco” (RGBA: 1,1,1,1), “negro” (RGBA: 0,0,0) , 0), “gris” (RGBA: 0.5,0.5,0.5,0.5), “bulto” (RGBA: 0,5,0.5,1,0.5) o “rojo” (RGBA: 1,0,0,0).
• Para texturas no 2D (Cubo, 3D, 2DArray) el valor predeterminado es un string. Cuando un Material no tiene asignado un Cubemap/3D/Array Texture, se usa uno gris (RGBA: 0.5,0.5,0.5,0.5)

Más adelante, en las partes de funciones fijas del shader, se puede acceder a los valores de propiedad utilizando el nombre de la propiedad entre corchetes: [name]. Por ejemplo, podría hacer que el modo de fusión sea controlado por una propiedad material declarando dos propiedades enteras (por ejemplo, “SrcBlend“ y ”DstBlend”), y más adelante haga que Blend Command las use: Blend [_SrcBlend ] [_DstBlend].

Los parámetros del shader que se encuentran en el bloque Propiedades se serializan como datos Material. Programas Shader puede tener más parámetros (como matrices, vectores y floats) que se configuran en el material desde el código en tiempo de ejecución, pero si no forman parte del bloque de Propiedades, sus valores no se guardarán . Esto es principalmente útil para los valores que son completamente guiados por código de comandos (usando Material.SetFloat y funciones similares).

Atributos de propiedades y drawers

Delante de cualquier propiedad, se pueden especificar atributos opcionales entre corchetes. Estos son atributos reconocidos por Unity, o pueden indicar sus propias clases de MaterialPropertyDrawer para controlar cómo deben renderizarse en el material inspector. Atributos reconocidos por Unity:

• [HideInInspector] - no muestra el valor de propiedad en el Inspector de Material..
• [NoScaleOffset] - El inspector de materiales no mostrará los campos de tiling/offset de textura para las propiedades de textura con este atributo.
• [Normal] - Indica que una propiedad de textura espera un mapa normal.
• [HDR] - Indica que una propiedad de textura espera una textura de alto rango dinámico (HDR).
• [Gamma] - Indica que una propiedad float/vector se especifica como valor sRGB en la interfaz de usuario (al igual que los colores) y, posiblemente, necesita la conversión de acuerdo con el espacio de color utilizado. Consulte Propiedades en los programas Shader.
• [PerRendererData] - indica que una propiedad de textura provendrá de los datos de cada procesador en forma de MaterialPropertyBlock. El inspector de materiales cambia la UI de la ranura de textura para estas propiedades.

Ejemplo

// propiedades para un shader de agua
Properties
{
    _WaveScale ("Wave scale", Range (0.02,0.15)) = 0.07 // sliders
    _ReflDistort ("Reflection distort", Range (0,1.5)) = 0.5
    _RefrDistort ("Refraction distort", Range (0,1.5)) = 0.4
    _RefrColor ("Refraction color", Color) = (.34, .85, .92, 1) // color
    _ReflectionTex ("Environment Reflection", 2D) = "" {} // textures
    _RefractionTex ("Environment Refraction", 2D) = "" {}
    _Fresnel ("Fresnel (A) ", 2D) = "" {}
    _BumpMap ("Bumpmap (RGB) ", 2D) = "" {}
}

Opciones de propiedad (quitado en 5.0)

Antes de Unity 5, las propiedades de textura podrían tener opciones dentro del bloque de llaves, por ejemplo. TexGen CubeReflect. Estos estaban controlando la función de la función de coordenadas de la generación de coordenadas. Esta funcionalidad fue eliminada en 5.0; si necesita texgen, debe escribir un vertex shader en su lugar. Consulte los ejemplos en la página Implementación de la página de TexGen de función fija.

Véase también

• Accediendo propiedades Shader en HLSL/Cg.
• Material Property Drawers.