Propriétés personnalisées

../_images/data-system_custom-properties_add.png

Panneau Custom Properties.

Les propriétés personnalisées sont une manière de stocker vos propres métadonnées dans les bloc de données de Blender qui peuvent être utilisés pour le rigging (où les os et les objets peuvent avoir des propriétés personnalisées qui pilotent d’autres propriétés), et pour des scripts Python, dans lesquels il est fréquent de définir de nouveaux réglages non disponibles dans Blender.

Seules certaines données prennent en charge les propriétés personnalisées :

Pour ajouter une propriété personnalisée, trouvez le panneau Custom Properties, en bas de l”Éditeur des Propriétés, ou la région Properties, et cliquez sur Add.

Édition des propriétés

Interface utilisateur

Les propriétés personnalisées peuvent être éditées avec le panneau disponible pour les types de données qui le prennent en charge.

../_images/data-system_custom-properties_edit.png

Pop-up d’édition des propriétés personnalisées.

Property Name (Nom de la propriété)

Le nom de la propriété personnalisée.

Property Value (Valeur de la propriété)

This does two things: first it sets the current value of the custom property, and second, it defines the data type of the property. For example, custom properties can either be of type: Integers, Floats, or Booleans. See the table below for a list of examples for each:

Entiers

1, 2, 3, 4…

Flottants

3.141, 5.0, 6.125,

Booléens

True, False

Note

Les booléens sont gérés de manière très similaire aux entiers et fonctionnent uniquement à l’usage des valeurs Min/Max qui sont des entiers et qui n’ont pas plus de 1 de différence.

À ce stade, les booléens vont encore ressembler à des entiers mais se comporter comme des booléens en ayant une valeur basse, off, et une valeur haute, on.

Default Value

This sets the default value of the property used by the Reset to Default Value operator.

Avertissement

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.

Min

La valeur minimale que la propriété personnalisée peut prendre.

Max

La valeur maximale que la propriété personnalisée peut prendre.

Use Soft Limits

Active les limites auxquelles le curseur Property Value peut être ajusté sans avoir à entrer numériquement la valeur.

Soft Min

La valeur minimale pour la limite souple.

Soft Max

La valeur maximale pour la limite souple.

Is Statically Overridable

Specifies if the property can be overridden via the Static Overrides system (with an additional performance overhead).

Tooltip (infobulle)

Vous permet d’écrire une infobulle personnalisée pour votre propriété.

Accès avec Python

Les propriétés personnalisées peuvent être accédées de manière comparable aux dictionaries, avec la contrainte que les clés ne peuvent être que des chaînes, et les valeurs ne peuvent être que des chaînes, des nombres, des tableaux et des propriétés imbriquées.

Voir la `documentation de l’API <https://www.blender.org/api/blender_python_api_current/info_quickstart.html#custom-properties>`__pour les détails.