Created page with "{{Note|Quels concepts ou propriétés vos espaces et variables représentent? Prenez du temps pour bien les nommer. Ces noms vont être utilisés dans d'autres contextes et même par d'autres utilisateurs. Les changer après le fait peut être un challenge. |suggestion}}" |
Created page with "Créer, dupliquer ou bouger une variable dynamique requiers de '''fixer''' cette variable a un espace." |
||
Line 43: | Line 43: | ||
Si vous voulez utiliser un champ ou référence comme contenu d'une variable dynamique, vous pouvez utiliser les composants [[DynamicField%601_(Component)|DynamicField<T>]] ou [[DynamicReference%601_(Component)|DynamicReference<T>]]. A la place de stocker quelque chose directement, ils pointent a un champ contenant une certaine valeur ou référence. | Si vous voulez utiliser un champ ou référence comme contenu d'une variable dynamique, vous pouvez utiliser les composants [[DynamicField%601_(Component)|DynamicField<T>]] ou [[DynamicReference%601_(Component)|DynamicReference<T>]]. A la place de stocker quelque chose directement, ils pointent a un champ contenant une certaine valeur ou référence. | ||
Comme avec les variables, il y a un pour les champs <code>Type</code>: [[Component:DynamicTypeField|DynamicTypeField]] | |||
(A FAIRE: clarifier les types valeur vs référence) | (A FAIRE: clarifier les types valeur vs référence) | ||
Line 57: | Line 55: | ||
A la création d'une variable dynamique, vous pouvez choisir depuis une liste de types communs. Si ce que vous voulez n'est pas dans la liste, vous allez devoir entrer le [[Complex Types in Components | type complexe]] manuellement. | A la création d'une variable dynamique, vous pouvez choisir depuis une liste de types communs. Si ce que vous voulez n'est pas dans la liste, vous allez devoir entrer le [[Complex Types in Components | type complexe]] manuellement. | ||
=== | === La Fixation === | ||
Créer, dupliquer ou bouger une variable dynamique requiers de '''fixer''' cette variable a un espace. | |||
C'est un processus automatique mais qui n'est pas parfait. | |||
Dans l'essence, il va chercher un espace de variable dynamique correspondant au slot de la variable dynamique. | |||
Si il n'en trouve pas, il essaye le slot parent, et son parent, ect. jusqu'à ce qu'un espace soit trouvé. | |||
Les variables avec un nom d'espace spécifique ne vont être compatible qu'avec un espace du même nom. | |||
Les variables sans nom d'espace explicite vont s'attacher a n'importe quel espace qui n'est pas <code>OnlyDirectBinding</code>. | |||
L'image suivante montre les différence de fixation: | |||
[[File:Dynamic_Variables.svg|border|<span lang="en" dir="ltr" class="mw-content-ltr">an image demonstrating that dynamic variable spaces with enabled OnlyDirectBinding are ignored except by variables which have explicitly declared the same space name</span>]] | [[File:Dynamic_Variables.svg|border|<span lang="en" dir="ltr" class="mw-content-ltr">an image demonstrating that dynamic variable spaces with enabled OnlyDirectBinding are ignored except by variables which have explicitly declared the same space name</span>]] |
Revision as of 23:45, 25 April 2024
Aperçu
Les variables dynamiques vous permettent de lire et écrire des information depuis un simple nom. Elles rendent simple la gestion de données dans des systèmes larges; chaque bout de données est étiquetée correctement que vous pouvez décomposer en plusieurs espaces.
Restrictions de noms
En utilisant les variables dynamiques, il y a quelques restrictions sur le nommage sur les variables et espaces.
Les noms de variables et espaces ne peuvent pas contenir:
- Des symboles
- Comme défini en C# avec Char.IsSymbol
- Ponctuation / WhiteSpaces
- Comme défini en C# avec Char.IsPunctuation et Char.IsWhiteSpace
- Excepté pour les points (.), underscore (_) et espaces ( ).
Utilisation
Optionnellement, un nom de variable peut être préfixé avec le nom d'un espace, se finissant avec /, pour choisir un espace de variables. Cela est utile pour distinguer des systèmes indépendants.
Quelques noms valides incluent:
- Vie -- pas d'espaces, juste nommé Vie
- World/Couleur -- nommé Couleur, dans l'espace World
- MonSysteme/Score -- Nommé Score, dans l'espace MonSysteme
Espaces
Les variables dynamiques peuvent être n'importe ou ou sous un slot contenant le composant DynamicVariableSpace.
Donc, une variable sur l'origine du monde peut être utilisée de partout alors qu'une variable dans un espace sur votre avatar ne peut être utilisée que sur votre avatar.
Variables
La manière la plus simple d'utiliser les variables dynamiques est d'utiliser les composants DynamicValueVariable<T> et DynamicReferenceVariable<T>. Ils fonctionnent pour des valeurs (int, float, String...) et references (Slot, Utilisateur...).
Ces components stockent une valeur ou référence directement. Si deux variable ont le même nom, elles auront des valeurs identiques.
Champs
Si vous voulez utiliser un champ ou référence comme contenu d'une variable dynamique, vous pouvez utiliser les composants DynamicField<T> ou DynamicReference<T>. A la place de stocker quelque chose directement, ils pointent a un champ contenant une certaine valeur ou référence.
Comme avec les variables, il y a un pour les champs Type
: DynamicTypeField
(A FAIRE: clarifier les types valeur vs référence)
Pilotes
Vous pouvez utiliser le contenu d'une variable dynamique pour piloter un champ ou référence en utilisant les composants DynamicValueVariableDriver<T> ou DynamicReferenceVariableDriver<T>.
Types non-listés
A la création d'une variable dynamique, vous pouvez choisir depuis une liste de types communs. Si ce que vous voulez n'est pas dans la liste, vous allez devoir entrer le type complexe manuellement.
La Fixation
Créer, dupliquer ou bouger une variable dynamique requiers de fixer cette variable a un espace. C'est un processus automatique mais qui n'est pas parfait.
Dans l'essence, il va chercher un espace de variable dynamique correspondant au slot de la variable dynamique.
Si il n'en trouve pas, il essaye le slot parent, et son parent, ect. jusqu'à ce qu'un espace soit trouvé.
Les variables avec un nom d'espace spécifique ne vont être compatible qu'avec un espace du même nom.
Les variables sans nom d'espace explicite vont s'attacher a n'importe quel espace qui n'est pas OnlyDirectBinding
.
L'image suivante montre les différence de fixation:
- I:
A
is connected toInner
becauseInner
is notOnlyDirectBinding
. - II/III: Both variables are bound explicitly.
- IV:
A
ignoresInner
becauseInner
isOnlyDirectBinding
. - V/VI: Both variables are bound explicitly.
- VII/IX: There is no matching dynamic variable space. Both variables are not bound.
- VIII: The variable is explicitly bound to
World
. - I and II share the same value.
- III, IV and VI share the same value.
Attention
In a few use-cases, binding may take a small amount of time, before which the dynamic variable can appear to be present, but not be readable or writable. Therefore, if you create a dynamic variable using the Create Dynamic Variable or Write Or Create Dynamic Variable ProtoFlux Node, or cause it to be duplicated using the Duplicate Slot ProtoFlux Node, or cause it to be moved using the Set Parent ProtoFlux Node, you may find it necessary to add an Updates Delay or Updates Delay With Value ProtoFlux Node afterwards in order to ensure the dynamic variables have been bound by the time you use them. A delay of 1 to 3 updates usually suffices.
Example Applications
The following examples will demonstrate a few use-cases of dynamic variables. There is a focus on how to use them to create separate objects
Modules within an object
Dynamic variables within an object allow modularization. Different modules would be connected via dynamic variables within the space located at the root of the object. If all hard-coded references going in or out of a module are eliminated you can replace it with a different variant/version without additional setup. Module-local variables can be created with a dynamic variable space located at the root of the module. Use appropriately named spaces to differentiate between the two. To make available variables more obvious to other people - including you in 6 months - it is recommended to place all dynamic variables within a dedicated slot hierarchy.
Commonly used names for such hierarchies are:
- DV
- DynVar
- Vars
- etc.
A modular object could look like this:
- Project (Space:
MyProject
)- Dynamic Variables
- projectVar: String (Dynamic variable
projectVar
of type String)
- projectVar: String (Dynamic variable
- Module: UI (i.e. MeshRenderer or Canvas plus Colliders), may contain:
- Dynamic Variable Drivers → Visuals
- Button Interactions → Dynamic Variables
- Editors ↔ Dynamic Variables
- Module: Logic (Space:
Logic
)- Dynamic Variables
- logicVar: int (Dynamic variable
logicVar
of type int) - MyProject/Logic:
- logicVar: int (Dynamic variable
- Dynamic Variables
- Dynamic Variables
- français
- русский
Slot (Dynamic variable Logic
of type Slot for space MyProject
, driven with reference to Slot of module to make it accessible to other modules)
- ProtoFlux (may read, write or even drive dynamic variables of space
MyProject
)
- ProtoFlux (may read, write or even drive dynamic variables of space
Configurable objects
Dynamic variables make it possible to access other object's properties.
Assuming objects with a dynamic variable space, a collider and a string variable named Description
you could then create a separate tool that reads and displays the Description
of the object it is pointed at. The same tool could be extended to edit descriptions.
The same concept can also be applied to template slots used within a project. Their instances can be interacted with using dynamic variables.
World/User variables
There are already pre-made dynamic variable spaces:
World
on Root (OnlyDirectBinding
)User
on each User Root Slot (OnlyDirectBinding
)Dash
on Slot of UserSpaceRadiantDash
They can be used for states that are shared by many objects (i.e. day/night toggle, performance) or to broadcast information into the world. (BeatLink, library objects like the Redprint manager)
See Dynamic Variable Naming Standard for a more detailed listing.