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:
Todos los tipos de bloques de datos.
Huesos y el modo Pose de los huesos.
Clips del Editor de video.
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¶
Custom properties can be edited using the panel available for data types that support it. Editing the properties allows you to configure things such as default values, ranges, and even add a custom tooltip.
- Tipo
The data type of the property; different data types have can only have specific data properties.
- Decimal:
A numeric value with decimals e.g. 3.141, 5.0, or 6.125.
- Vector decimal:
A collection of multiple float data types e.g.
[3.141, 5.0, 6.125]
. This data type can also be used for data that can be represented as a float array such as colors. These special float arrays can be set in the Subtype selector.- Entero:
A numeric value without any decimals e.g. 1, 2, 3, or 4.
- Vector entero:
A collection of multiple integer data types e.g.
[1, 2, 3, 4]
.- Booleana:
A data type that has two possible values e.g.
True
orFalse
.- Vector booleano:
A collection of boolean values e.g.
[True, False, True]
- Cadena de texto:
A sequence of characters such as «Some Text».
- Bloque de Datos:
A reference to a Blender object, see Bloques de datos.
- Python:
Edit a Python data type directly, used for unsupported data types.
- Longitud del vector
The number of elements in the array. Note that if the array length is greater than 7 you cannot directly edit its elements, you must press Edit Value to edit the elements of the array.
- Nombre de propiedad
The text that is displayed to the left of the value. This name is also used to access the property via Python.
- Valor predefinido
This sets the default value of the property used by the Reset to Default Value operator.
Advertencia
Default values are used as the basis of NLA blending, and a nonsensical default (e.g. 0 for a property used for scaling) on a property intended for being keyframed is likely to cause issues.
- 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
Specifies the type of data the property contains, which affects how it appears in the user interface. This option is only available for float properties and has different options for regular floats and float arrays. Note, the unit often depends on the Scene Units.
Para valores decimales regulares:
- Plain Data:
Los valores de los datos no tendrán ningún comportamiento específico.
- Píxel:
Una medida de la resolución de imágenes digitales.
- Porcentaje:
The displayed value is a percentage, typically you will want the Min and Max values to be 0 and 100.
- Factor:
A percentage between an upper and lower bound which typical have a numerical significance.
- Ángulo:
A measure between intersecting lines.
- Tiempo:
Time specified in seconds.
- Distancia:
Measure of space between items.
- Potencia:
Work as a factor of time, measured in watts. This is used in Blender to measure light intensity.
- Temperatura:
Intensidad de calor presente.
- Wavelength:
The distance between cycles of a wave measured in millimeters (mm), micrometers (µm), nanometers (nm), or picometers (pm).
Para vectores de valores decimales:
- Plain Data:
Los valores de los datos no tendrán ningún comportamiento específico.
- Color lineal:
Color in linear color space.
- Color con gama corregido:
Color in gamma corrected color space.
- Ángulos Euler:
Ángulos de rotación Euler.
- Ángulos en cuaternios:
Ángulos de rotación en Cuaternios.
Nota
For either of the color subtypes to work as expected the Property Value must be a vector with three or four values depending on the availability of an Alpha Channel.
- 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¶
Custom properties can be accessed in a similar way to dictionaries, with the constraints that keys can only be strings, and values can only be strings, numbers, arrays of such, or nested properties.
See the API documentation for details.