Dans le système Visual Dataprep, vos ressources Dataprep fournissent des formules réutilisables qui assurent la cohérence lors de l'importation et de la modification des données 3D. Le graphique Dataprep offre une grande souplesse et de puissantes fonctionnalités ; vous pouvez l'utiliser pour manipuler vos données comme vous le souhaitez pour que vos scènes importées fonctionnent correctement lors de l'exécution dans l'Unreal Engine.
Selon les tâches que votre graphique Dataprep doit effectuer, il est parfois possible que vous deviez procéder à certains ajustements en fonction de la scène ou de la ressource d'entrée. Par exemple, un nouvel ensemble de données d'entrée peut utiliser une convention de dénomination différente pour les objets ou les surfaces, et vous devrez peut-être modifier les paramètres de votre graphique en conséquence. Vous pouvez toujours modifier votre graphique de ressource Dataprep pour gérer ces nouvelles situations. Cependant, les graphiques Dataprep peuvent être volumineux et complexes et, dans les grandes entreprises, la personne devant importer le contenu n'est peut-être pas celle qui a créé le graphique. Dans des cas comme celui-ci, il n'est pas toujours évident de savoir quels paramètres modifier.
Pour faciliter cette tâche, vous pouvez sélectionner les paramètres importants de votre graphique Dataprep et les exposer en leur attribuant les noms descriptifs de votre choix. Lorsqu'une personne modifie la ressource Dataprep, ces paramètres exposés s'affichent dans une zone spéciale appelée Paramétrage du panneau Paramètres, situé en haut à droite de l'éditeur Dataprep. Cette zone met en évidence les paramètres sélectionnés que d'autres utilisateurs doivent personnaliser fréquemment.
De plus, vous pouvez créer une instance de Dataprep afin que les utilisateurs puissent modifier uniquement les paramètres que vous avez choisi d'exposer, mais ne puissent pas accéder aux autres éléments du graphique Dataprep. En exposant judicieusement les paramètres appropriés dans vos ressources Dataprep et en créant des instances Dataprep, vous pouvez donner aux utilisateurs de votre organisation la liberté dont ils ont besoin pour modifier les paramètres présélectionnés, sans leur demander de modifier, voire d'afficher la logique du graphique Dataprep proprement dit.
Si vous maîtrisez l'utilisation des matériaux et des instances de matériaux dans l'Unreal Engine, les concepts de « ressource Dataprep » et d'« instance Dataprep » sont identiques.
Exposer des paramètres dans une ressource Dataprep parente
Pour exposer les paramètres d'une ressource Dataprep en vue de les personnaliser et de les remplacer dans les instances Dataprep :
-
Configurez votre graphique Dataprep comme vous le souhaitez.
-
Faites un clic droit sur le paramètre que vous souhaitez exposer. Dans le menu contextuel, sous la section Paramétrage, cliquez sur Lien vers le paramètre.
Cliquez sur l'image pour l'afficher à taille réelle.
Vous pouvez exposer n'importe quel paramètre dans n'importe quel type de blocs Dataprep : blocs de filtre, blocs d'opérateur et blocs de transformation.
-
Dans la zone de texte prévue à cet effet, saisissez un nom descriptif que vous souhaitez utiliser pour faire référence au paramètre. Une fois le nom souhaité défini, cliquez sur Créer un nouveau paramètre sous la zone de texte.
Cliquez sur l'image pour l'afficher à taille réelle.
-
Le paramètre que vous avez choisi est accompagné dans le graphique Dataprep d'une icône de lien, pour indiquer qu'il a été exposé à des fins de personnalisation. Vous pouvez placer le pointeur de la souris sur cette icône pour afficher le nom du paramètre qui correspond à ce paramètre.
Cliquez sur l'image pour l'afficher à taille réelle.
Le nouveau paramètre que vous avez créé figure également dans la section Paramétrage du panneau Paramètres situé en haut à droite de l'éditeur Dataprep.
Cliquez sur l'image pour l'afficher à taille réelle.
La modification de la valeur du paramètre dans le bloc ou dans le panneau Paramètres modifie cette valeur aux deux emplacements.
Votre paramètre est désormais modifiable dans n'importe quelle instance Dataprep que vous créez à partir de cette ressource Dataprep, avec le nom de paramètre que vous avez défini. Consultez les sections suivantes pour en savoir plus.
Si vous souhaitez désactiver la possibilité de configurer un paramètre afin qu'il ne puisse plus être modifié dans aucune instance de cette ressource Dataprep, faites un clic droit sur le paramètre et choisissez Supprimer le lien vers le paramètre.
Vous pouvez lier plusieurs paramètres sur différents blocs Dataprep à un seul paramètre nommé. Si différentes parties de votre graphique Dataprep reposent sur les mêmes valeurs de seuil ou noms de chaîne, la réutilisation d'un paramètre pour piloter plusieurs paramètres de bloc différents peut permettre de réduire le nombre de paramètres que vous exposez à vos instances Dataprep.
Créer une ressource d'instance Dataprep
Vous pouvez créer une ressource d'instance Dataprep à partir de n'importe quelle ressource Dataprep. Faites un clic droit sur la ressource Dataprep dans le navigateur de contenu puis, dans le menu contextuel, cliquez sur Créer une instance.
Cliquez sur l'image pour l'afficher à taille réelle.
Votre nouvelle ressource d'instance Dataprep est créée dans le même dossier que son parent. Vous pouvez lui attribuer un nom et double-cliquer dessus pour l'ouvrir dans l'éditeur d'instance Dataprep afin de configurer les valeurs de ses paramètres exposés.
Configurer la ressource de l'instance Dataprep
Lorsque vous modifiez la ressource d'une instance Dataprep, elle s'ouvre dans un éditeur qui contient la plupart des panneaux visibles dans l'éditeur Dataprep principal.
Cliquez sur l'image pour l'afficher à taille réelle.
La principale différence est que l'éditeur de graphique n'est pas du tout disponible. Dans une instance Dataprep, vous ne pouvez ni modifier ni afficher la formule que l'instance Dataprep utilise pour modifier les scènes que vous importez. Vous avez uniquement accès aux paramètres qui ont été exposés dans la ressource Dataprep parente, dans la section Paramétrage du panneau Paramètres situé en haut à droite de l'éditeur.
Sinon, l'utilisation de l'éditeur d'instance Dataprep est très similaire à celle de l'éditeur Dataprep :
- Utilisez le panneau Paramètres pour personnaliser les fichiers d'entrée et les emplacements de sortie.
- Utilisez les boutons de la barre d'outils pour importer les fichiers d'entrée, exécuter le graphique Dataprep et valider les résultats dans votre projet Unreal Engine.
- Utilisez les panneaux d'aperçu pour interagir avec vos données importées et vous assurer qu'elles répondent à vos attentes avant de valider les résultats.