Custom Properties

../_images/files_data-blocks_add.png

Panneau Custom Properties.

Les propriétés personnalisées sont un moyen d’enregistrer vos propres données dans les blocs de données de Blender. Ceci peut être utilisé pour le rigging (où les os et les objets peuvent avoir des propriétés personnalisées pilotant d’autres propriétés), et les scripts Python, où il est courant de définir de nouveaux paramètres non disponibles dans Blender. Il est également possible d’accéder aux propriétés personnalisées des matériaux via le Nœud Attribute.

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

Pour ajouter une propriété personnalisée, recherchez le panneau Custom Properties (Propriétés personnalisées), situé en bas de la plupart des Properties ou de la région de la barre latérale, puis cliquez sur New (Nouveau). Les propriétés peuvent être supprimées du même emplacement avec l’icône de suppression. Une fois les propriétés ajoutées, elles peuvent être configurées via l’icône d’édition pour fonctionner pour un cas d’utilisation particulier ; voir Editing Properties pour plus d’informations.

Édition des propriétés

Interface utilisateur

../_images/files_data-blocks_edit.png

Fenêtre déroulante pour l’édition des propriétés personnalisées.

Les propriétés personnalisées peuvent être modifiées à l’aide du panneau disponible pour les types de données qui les prennent en charge. La modification des propriétés vous permet de configurer des éléments tels que les valeurs par défaut, les plages et même d’ajouter une info-bulle personnalisée.

Type

Le type des données de la propriété ; différents types de données ne peuvent avoir que des propriétés de données spécifiques.

Float:

Une valeur numérique avec des décimales, par ex. 3,141, 5,0 ou 6,125.

Float Array:

Une collection de plusieurs types de données flottantes, par ex. [3.141, 5.0, 6.125] . Ce type de données peut également être utilisé pour des données pouvant être représentées sous forme de tableau de flottants, telles que des couleurs. Ces tableaux de flottants spéciaux peuvent être définis dans le sélecteur de sous-type.

Integer:

Une valeur numérique entière sans décimales, par ex. 1, 2, 3 ou 4.

Integer Array:

Une collection de plusieurs types de données entiers, par ex. [1, 2, 3, 4] .

Boolean:

Un type de données qui a deux valeurs possibles, par exemple True ou False.

Boolean Array:

Une collection de valeurs booléennes, par exemple [True, False, True]

String:

Une séquence de caractères telle que “Un teste quelconque”.

Data-Block:

Une référence à un objet Blender, voir les Data-Blocks.

Python:

Modifier directement un type de données python, utilisé pour les types de données non pris en charge.

Array Length

Le nombre d’éléments dans le tableau. Notez que si la longueur du tableau est supérieure à 7, vous ne pouvez pas modifier directement ses éléments, vous devez appuyer sur Edit Value pour modifier les éléments du tableau.

Property Name

Le texte qui s’affiche à gauche de la valeur. Ce nom est également utilisé pour accéder à la propriété via Python.

Default Value

Fixe la valeur par défaut de la propriété utilisée par l’opérateur Reset to Default Value.

Avertissement

Les valeurs par défaut sont utilisées comme base de NLA blending, et une valeur par défaut absurde (par exemple 0 pour une propriété utilisée pour la mise à l’échelle) sur une propriété destinée à intégrer des trames clés est susceptible de causer des problèmes.

Min, Max

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

Library Overridable

Permettre à la propriété d’être overridden lorsque le bloc de données est lié.

Soft Limits

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

Soft Min, Max

La valeur minimale / maximale pour la limite souple.

Step

Un multiplicateur pour contrôler de combien le type de données est incrémenté chaque fois. La taille de pas interne pour les flottants est de 0,01, donc une valeur de pas de 5 s’incrémentera à un taux de 0,05 et une valeur de pas de 100 sera incrémentée de 1,0. Pour les entiers, la taille du pas interne est 1.

Précision

Le nombre de chiffres après la virgule à afficher dans l’interface utilisateur pour les types de données flottantes.

Subtype

Spécifie le type de données que contient la propriété, ce qui affecte son apparence dans l’interface utilisateur. Cette option n’est disponible que pour les propriétés flottantes et a différentes options pour les flottants réguliers et les tableaux de flottants. Notez que l’unité dépend souvent des unités de la scène.

Pour les flottants réguliers :

Plane Data:

Les valeurs de données n’ont aucun comportement particulier.

Pixel:

Une mesure de résolution d’image numérique.

Percentage:

La valeur affichée est un pourcentage, généralement vous voudrez que les valeurs Min et Max soient 0 et 100.

Factor:

Un pourcentage entre une limite supérieure et une limite inférieure qui ont typiquement une signification numérique.

Angle:

Une mesure entre des lignes qui se croisent.

Temps:

Temps spécifié en secondes.

Distance:

Mesure de l’espace entre les éléments.

Puissance:

Travaille comme facteur de temps, mesuré en watts. Est utilisé dans Blender pour mesurer l’intensité lumineuse.

Temperature:

Intensité de la chaleur présente.

Pour les tableaux flottants :

Plane Data:

Les valeurs de données n’ont aucun comportement particulier.

Linear Color:

Couleur dans l’espace colorimétrique linéaire.

Gamma-Corrected Color:

Couleur dans l’espace colorimétrique corrigé gamma.

Euler Angles:

Angles de Rotation d’Euleur.

Quaternion Angles:

Angles de Rotation de Quaternion.

Note

Pour que l’un ou l’autre des sous-types de couleur fonctionne comme prévu, la Property Value doit être un vecteur avec trois ou quatre valeurs selon la disponibilité d’un Alpha Channel.

ID Type Data-Block

Le type ID-block (bloc d’identification). Par exemple : Clé, Image, Objet, Matériau. Voir Types de bloc de données pour une liste complète.

Description

Vous permet d’écrire une Infobulle pour votre propriété.

Accès en Python

Les propriétés personnalisées sont accessibles d’une manière similaire aux dictionnaires, avec la contrainte que les clés ne peuvent être que des chaînes de caractères, et les valeurs ne peuvent être que des chaînes de caractères, des nombres, des tableaux de ces types, ou des propriétés imbriquées.

Voir la documentation de l’API pour des détails.