Propiedades personalizadas

../_images/files_data-blocks_add.png

Panel Propiedades personalizadas.

Las propiedades personalizadas son una forma de almacenar datos propios en bloques de datos de Blender. Podrán ser usadas para la creación de sistemas de control (donde los huesos y objetos podrán contener propiedades personalizadas que controlen a otras propiedades) y en scripts de Python, donde es común definir nuevas propiedades no disponibles en Blender. También será posible acceder a las propiedades personalizadas desde los materiales, mediante el nodo Atributo.

Sólo ciertos tipos de datos soportan propiedades personalizadas:

Para agregar una propiedad personalizada, buscar el panel Propiedades personalizadas, ubicado en la parte inferior de la mayoría de las regiones de Propiedades o en la Barra lateral de los distintos editores, y hacer en el botón Nueva. Las propiedades podrán ser eliminadas desde el mismo lugar, mediante el ícono de borrar. Una vez agregadas, las propiedades podrán ser configuradas mediante el ícono «Editar propiedad» para lograr que las mismas se adapten a los requerimientos de cada uso particular deseado; ver Edición de propiedades para más información.

Edición de propiedades

Interfaz de usuario

../_images/files_data-blocks_edit.png

Panel emergente de edición de propiedades personalizadas.

Las propiedades personalizadas podrán ser editadas mediante el panel disponible, para los tipos de datos que las soporten. La edición de las propiedades permitirá configurar cosas tales como sus valores predefinidos, rangos de acción y hasta agregarles descripciones personalizadas.

Tipo

El tipo de datos de la propiedad; distintos tipos de datos podrán contener diferentes tipos de propiedades de datos.

Decimal:

Un valor numérico con decimales. p.ej: 3.141, 5.0 o 6.125.

Vector decimal:

Una colección de varios datos decimales. p.ej: [3.141, 5.0, 6.125] . Este tipo de datos también podrá ser usado para datos que puedan ser representados por un vector decimal, como los colores. Estos vectores decimales especiales podrán ser definidos mediante el selector de Subtipo.

Entero:

Un valor numérico sin decimales. p.ej: 1, 2, 3 o 4.

Vector entero:

Una colección de varios datos enteros. p.ej: [1, 2, 3, 4] .

Booleana:

Un tipo de datos que sólo puede tomar dos valores: Verdadero o Falso.

Vector booleano:

Una colección de valores booleanos. p.ej: [Verdadero, Falso, Verdadero]

Cadena de texto:

Una secuencia de caracteres. p.ej: «Este es un texto».

Bloque de datos:

Una referencia a un objeto de Blender, ver Bloques de datos.

Python:

Permite editar un tipo de datos de Python de forma directa, usado para tipos de datos no soportados.

Longitud del vector

La cantidad de elementos en el vector. Nótese que si la longitud del vector fuera mayor a 7 no será posible editar directamente sus elementos, en ese caso será necesario presionar el botón Editar valor para editar los elementos del vector.

Nombre de propiedad

El texto que será mostrado a la izquierda del valor. Este nombre también será usado para acceder a la propiedad mediante Python.

Valor predefinido

Permitirá establecer el valor predefinido de la propiedad, usado por el operador Restablecer a valor predefinido.

Advertencia

Los valores predefinidos son usados como base para el fundido en la ANL, por lo que valores predefinidos insensatos (p.ej: 0 para una propiedad usada para escalar algo) en una propiedad destinada a ser animada, posiblemente produzca inconvenientes.

Mín, Máx

El valor mínimo/máximo que podrá tomar la propiedad personalizada.

Redefinible

Permite que la propiedad sea redefinida cuando el bloque de datos se encuentre vinculado.

Límites laxos

Mantiene los límites establecidos para el deslizador de valores de la propiedad, sin embargo se permitirá el ingreso manual de valores que se encuentren por fuera de esos límites.

Límite laxo mínimo / máximo

El valor mínimo/máximo para los límites laxos.

Intervalo

Un multiplicador que permitirá controlar cuánto se incrementará el tipo de dato cada vez. El tamaño interno de intervalo para decimales es de 0.01, por lo que un valor de Intervalo de 5 provocará aumentos a una tasa de 0.05 y un valor de Intervalo de 100 provocará aumentos a una tasa de 1.0. En el caso de los enteros el tamaño interno de intervalo es de 1.

Precisión

La cantidad de dígitos, luego del separador decimal, a mostrar en la interfaz para los tipos de datos decimales.

Subtipo

Permitirá especificar el tipo de datos que contendrá la propiedad, lo cual afectará a la forma de presentarla en la interfaz. Esta opción sólo estará disponible para propiedades decimales y tendrá diferentes opciones para propiedades simples o de tipo vector. Nótese que las unidades mostradas usualmente dependerán de las Unidades de la escena.

Para valores decimales regulares:

Datos simples:

Datos, cuyos valores no tendrán ningún comportamiento especial.

Píxel:

Una medida de la resolución de imágenes digitales.

Porcentaje:

El valor mostrado será un porcentaje, normalmente se querrá que sus valores Mín y Máx sean 0 y 100 respectivamente.

Factor:

Un porcentaje entre un límite superior y uno inferior que normalmente tendrá un significado numérico.

Ángulo:

Una medida tomada entre líneas secantes.

Tiempo:

Tiempo, especificado en segundos.

Distancia:

Medida de espacio entre elementos.

Potencia:

Trabajo, como un factor del tiempo, medido en watts. Es usado en Blender para medir la intensidad de las luces.

Temperatura:

Intensidad de calor presente.

Longitud de onda:

La distancia entre los ciclos de una onda, medida en milímetros (mm), micrómetros (µm), nanómetros (nm) o picómetros (pm).

Para vectores de valores decimales:

Datos simples:

Datos, cuyos valores no tendrán ningún comportamiento especial.

Color lineal:

Color, en espacio de color lineal.

Color con gama corregido:

Color, en espacio de color con gama corregido.

Ángulos Euler:

Ángulos de rotación Euler.

Ángulos en cuaternios:

Ángulos de rotación en Cuaternios.

Nota

Para que cada subtipo de color funcione como se espera, la propiedad deberá ser un vector con tres o cuatro valores, dependiendo de la disponibilidad o no de un Canal alfa.

Tipo de ID Bloque de datos

El tipo de bloque de datos de ID. Por ejemplo: clave, imagen, objeto, material. Ver Tipos de bloques de datos para una lista completa.

Descripción

Permitirá ingresar una Descripción personalizada para la propiedad.

Acceso desde Python

Las propiedades podrán ser accedidas de una manera similar a los diccionarios, con las restricciones de que las claves sólo podrán ser cadenas y que los valores sólo podrán ser cadenas, números, vectores de los anteriores o propiedades anidadas.

Ver la documentación de la API (en inglés) para más detalles.