Dans cette page, nous vous fournissons un aperçu du système Visual Dataprep et vous expliquons comment commencer à créer vos propres formules d'importation personnalisées pour préparer vos données 3D pour une visualisation en temps réel.
Activer Visual Dataprep
Activez les plug-ins suivants pour votre projet :
- Éditeur DataPrep
- Importateur Datasmith
- Opérations géométriques Dataprep - Ce plug-in est requis pour certains filtres et opérations.
- Si vous souhaitez importer à partir d'autres types de fichiers sources pris en charge par Datasmith, il est possible que vous deviez activer d'autres plug-ins d'importation pour ces types de fichiers. Pour en savoir plus, consultez la page Importing Datasmith Content into Unreal Engine (Importation de contenu Datasmith dans Unreal Engine).
Pour savoir comment activer les plug-ins, consultez la page Utiliser les plug-ins.
Si vous créez votre projet Unreal à partir d'un modèle dans les catégories Architecture, ingénierie et construction ou Automobile, conception de produits et fabrication, certains de ces plug-ins sont peut-être déjà activés.
Ressources Visual Dataprep
Le système Visual Dataprep est basé sur un nouveau type de ressource appelé Dataprep. Cette ressource est similaire à un blueprint dans la mesure où elle présente une série d'étapes dans une représentation visuelle. Cependant, le but de ce graphique Dataprep est de transformer les données de scène lues à partir d'un ou plusieurs fichiers d'entrée que vous spécifiez.
Pour créer une nouvelle ressource Dataprep, faites un clic droit dans le navigateur de contenu et choisissez Dataprep > Ressource Dataprep dans le menu contextuel.
Cliquez sur l'image pour l'afficher à taille réelle.
Interface utilisateur de l'éditeur Dataprep
À l'instar des classes de blueprint, les ressources Dataprep disposent de leur propre fenêtre d'éditeur spécialisée. Vous pouvez ouvrir cette fenêtre en double-cliquant sur n'importe quelle ressource Dataprep dans le navigateur de contenu.
L'interface utilisateur de l'éditeur Dataprep est divisée en plusieurs panneaux, que vous utiliserez à différents stades du flux de travail Dataprep.
Cliquez sur l'image pour l'afficher à taille réelle.
Numéro | Nom | Description |
---|---|---|
1 | Barre d'outils | Raccourcis pour les actions utilisateur les plus importantes dans le flux de travail Dataprep, y compris les actions Importer, Exécuter et Valider. |
2 | Aperçu du navigateur de contenu | Répertorie toutes les ressources que vous avez importées à partir de vos fichiers d'entrée. Il s'agit d'un aperçu des ressources que le système Visual Dataprep crée dans votre navigateur de contenu lorsque vous validez votre graphique. |
3 | Aperçu du hublot | Affiche un aperçu visuel des scènes 3D que vous avez importées à partir de vos fichiers d'entrée. |
4 | Aperçu de l'organiseur | Répertorie tous les acteurs dans les scènes 3D que vous avez importées à partir de vos fichiers d'entrée. Il s'agit d'un aperçu des acteurs que le système Visual Dataprep crée dans votre niveau et de la hiérarchie de scène qui est créée dans l'organiseur de votre niveau. |
5 | Panneau Paramètres | Utilisez ce panneau pour spécifier les fichiers d'entrée à partir desquels vous souhaitez importer vos scènes 3D et pour indiquer où créer les ressources dans le navigateur de contenu de votre projet. Si vous avez exposé des paramètres dans votre graphique Dataprep afin qu'ils puissent être remplacés dans des instances de votre ressource Dataprep, ces paramètres sont également répertoriés ici dans la section Paramétrage. Pour en savoir plus, consultez la page Utiliser des instances Dataprep. |
6 | Palette | Contient des blocs de construction que vous pouvez faire glisser dans l'éditeur de graphique Dataprep pour créer votre formule d'importation. |
7 | Éditeur de graphique Dataprep | Zone dans laquelle vous pouvez préparer des formules Dataprep, c'est-à-dire des étapes logiques que le système Dataprep doit suivre pour préparer votre contenu d'entrée pour la visualisation en temps réel dans Unreal Engine. |
8 | Panneau Détails | Similaire au panneau Détails de l'éditeur de niveau principal, il affiche des informations sur les acteurs que vous avez sélectionnés dans l'aperçu de l'organiseur. Notez que ces paramètres sont en lecture seule. Ils sont fournis uniquement à titre d'information afin que vous puissiez évaluer les effets de votre graphique Dataprep sur vos acteurs. |
Flux de travail de Dataprep
Le flux de travail typique pour configurer une ressource Visual Dataprep est le suivant :
-
Spécification des fichiers d'entrée : dans le panneau Paramètres situé en haut à droite, créez un nouveau producteur d'entrée pour chaque fichier que vous souhaitez importer, ou chaque dossier de fichiers d'entrée. Cliquez sur l'icône d'engrenage pour configurer des options de géométrie et de tessellation supplémentaires, par exemple Tolérance cordale et Technique de montage.
Cliquez sur l'image pour l'afficher à taille réelle.
Vous pouvez également personnaliser les paramètres de sortie suivants :
- Dossier détermine le nom du dossier qui sera créé dans le navigateur de contenu de votre projet pour contenir vos ressources importées. Par défaut, vos ressources sont distribuées par Datasmith dans des sous-dossiers de ce dossier en fonction de leur type : un pour les ressources de maillage statique, un pour les matériaux, un pour les textures, etc. (Vous pouvez remplacer cette distribution par défaut lorsque vous créez votre graphique Dataprep, en utilisant l'opération Générer dans le dossier.)
- Nom du niveau définit le nom d'un nouvel élément de niveau qui sera créé dans le but de contenir votre scène. Après avoir validé les résultats du graphique Dataprep, vous pouvez ajouter la scène importée à n'importe quel niveau de votre projet en ajoutant ce sous-niveau.
-
Importation préliminaire : appuyez sur le bouton Importer dans la barre d'outils pour importer vos fichiers sources dans un monde temporaire.
Le hublot 3D et d'autres panneaux d'aperçu se mettent à jour avec le contenu de votre fichier. Ce contenu n'a pas encore été ajouté à votre projet. Il s'agit d'un monde temporaire qui n'existe que dans l'éditeur Dataprep. Cela vous donne la possibilité de modifier les ressources et la hiérarchie de scène lues à partir de vos fichiers d'entrée avant d'enregistrer les résultats dans votre projet.
Cette étape est techniquement facultative, mais elle vous permet d'évaluer plus facilement les effets de votre graphique Dataprep à mesure que vous créez ce dernier.
-
Création du graphique Dataprep : faites glisser les nœuds Sélectionner par et Opérations de la palette vers l'éditeur de graphique Dataprep et connectez vos nœuds Action dans l'ordre dans lequel vous souhaitez qu'ils s'exécutent. Consultez la rubrique Graphiques Dataprep ci-dessous.
- Test du graphique : appuyez sur le bouton Exécuter de la barre d'outils pour exécuter les données que vous avez importées à partir de vos fichiers sources via le graphique Dataprep que vous avez créé. Les panneaux d'aperçu se mettent à jour pour afficher les résultats.
Il est possible de désactiver des blocs ou des nœuds d'action individuels à des fins de débogage en faisant un clic droit sur le nom correspondant et en choisissant l'option Désactiver. Un bloc/une action désactivés sont grisés dans le graphique. Vous pouvez les activer en ouvrant à nouveau le menu et en choisissant l'option Activer.
-
Validation : lorsque vous êtes satisfait des effets de votre graphique sur les données 3D importées à partir de vos fichiers d'entrée, appuyez sur le bouton Valider de la barre d'outils pour finaliser le processus d'importation.
Lorsque vous validez les résultats, le système Visual Dataprep enregistre les ressources de l'aperçu du navigateur de contenu dans les ressources de votre projet. Il modifie également le niveau actuellement ouvert pour ajouter la hiérarchie des acteurs affichée dans l'aperçu de l'organiseur.
Si vous préférez importer votre hiérarchie d'acteurs dans un nouveau niveau, définissez le nom du niveau dans le paramètre Sous-niveau du panneau Paramètres. Le système Visual Dataprep crée un nouveau niveau avec ce nom (s'il n'existe pas déjà), ajoute vos acteurs à ce niveau, puis ajoute ce niveau en tant que sous-niveau dans le niveau actuellement ouvert dans la fenêtre principale d'Unreal Editor.
Panneau de statistiques
Ouvrez le panneau Statistiques à partir du menu principal de l'éditeur de ressources Visual Dataprep : Fenêtre > Statistiques. Ce panneau présente une comparaison simple des mesures de vos données, telles que les appels à générer, le nombre d'acteurs ou le nombre total de vertex, avant et après l'exécution du graphique Dataprep.
Cliquez sur l'image pour l'afficher à taille réelle.
Graphiques Dataprep
Au cœur de chaque ressource Dataprep se trouve le graphique Dataprep, à savoir l'ensemble des opérations que le système va exécuter sur les fichiers d'entrée que vous spécifiez.
Cliquez sur l'image pour l'afficher à taille réelle.
Chaque graphique Dataprep est composé de blocs de construction appelés nœuds Action, autrement dit des piles verticales de blocs. Par exemple, le graphique ci-dessus contient trois nœuds Action. Lorsque vous exécutez le graphique Dataprep, il commence par le nœud Start sur la gauche, puis exécute chaque nœud Action dans l'ordre, de gauche à droite.
Vous pouvez redimensionner les actions horizontalement pour lire leur texte intégral en faisant glisser leurs limites.

Contrairement aux graphiques de blueprint, où l'embranchement conditionnel est autorisé, la progression des graphiques Dataprep se fait toujours de gauche à droite, le long d'un chemin d'exécution linéaire unique. De plus, il n'existe aucun flux de données entre les nœuds Action successifs. Toutes les actions utilisent le même contexte, à savoir un ensemble de ressources et d'acteurs importés à partir des fichiers d'entrée que vous fournissez.
Chaque action est une pile d'un ou plusieurs blocs. Lorsque le graphique Dataprep exécute une action, il traite chaque bloc du nœud Action de haut en bas.
Pour commencer à créer une action, vous pouvez faire glisser des blocs de la palette de gauche vers l'éditeur de graphique, ou faire un clic droit dans l'arrière-plan de l'éditeur de graphique et sélectionner des blocs dans la palette contextuelle.
Vous pouvez regrouper plusieurs actions ensemble. Pour ce faire :
- Cliquez et faites glisser pour sélectionner les actions que vous souhaitez regrouper.
- Faites un clic droit sur le groupe.
- Dans le menu contextuel, sélectionnez Actions de groupe.
Vous pouvez désactiver toutes les actions d'un groupe d'actions en faisant un clic droit sur le groupe et en sélectionnant Désactiver le groupe d'actions dans le menu contextuel.
Pour dissocier les actions, faites un clic droit sur le groupe, puis sélectionnez Dissocier les actions.
Opérations, filtres et transformations
Vous pouvez utiliser trois types de blocs de base dans un nœud Action Dataprep :
-
Les opérations modifient les ressources, les acteurs ou les composants d'une manière prédéfinie. Par exemple, les blocs Définir le matériau, Graphique de scène compact et Définir la collision simple présentés ci-dessus sont tous des types d'opérations différents.
Pour en savoir plus sur les différentes opérations que vous pouvez utiliser dans vos graphiques Dataprep, consultez la page Dataprep Operation Reference (Référence des opérations Dataprep).
-
Les filtres, également appelés blocs Sélectionner par, déterminent les ressources, les acteurs et les composants que les opérations dépendantes dans le bloc Action actuel doivent modifier. Par défaut, chaque étape Action exécute ses opérations sur l'ensemble des ressources, acteurs et composants contenus dans le monde temporaire construit à partir de vos fichiers d'entrée. Vous pouvez utiliser ces blocs Filtre pour définir un sous-ensemble de ces objets, en vue de contrôler les objets que votre nœud Action modifie.
Pour en savoir plus sur les différents filtres de sélection que vous pouvez utiliser dans vos graphiques Dataprep, consultez la page Dataprep Operation Reference (Référence des opérations Dataprep).
-
Les transformations modifient la sélection actuelle de ressources, d'acteurs et de composants de manière plus ou moins complexe. À cet égard, elles sont similaires aux filtres. Néanmoins, un bloc de filtre peut uniquement réduire la liste des objets qui lui sont transmis. Un bloc de transformation, en revanche, peut ajouter des objets à la sélection actuelle.
Par exemple, vous souhaitez peut-être sélectionner des arborescences d'objets spécifiques dans la hiérarchie de scène. Pour ce faire, vous pouvez utiliser des blocs de filtre pour restreindre l'ensemble complet des éléments de scène à un nombre réduit d'éléments parents spécifiques, puis utiliser un bloc de transformation pour étendre à nouveau cette sélection afin d'inclure les enfants des éléments sélectionnés.
Pour en savoir plus sur les différentes transformations que vous pouvez utiliser pour étendre ou modifier l'ensemble d'objets sélectionné dans une action, consultez la page Dataprep Selection Transform Reference (Référence de transformation de sélection Dataprep).
Exemple d'action
L'action illustrée ci-dessous définit un nouveau matériau sur les parties d'un assemblage de CAO. Ce nœud exécute une séquence d'étapes, en traitant les données via sa pile de filtres et d'opérations, de haut en bas.
Cliquez sur l'image pour l'afficher à taille réelle.
Numéro d'étape | Nom | Type de bloc | Description |
---|---|---|---|
1 | Broche d'entrée | S.O. | Chaque action rassemble toutes les données du monde temporaire, notamment l'ensemble des ressources et acteurs qui se trouvent dans les fichiers importés, et transmet ces objets au bloc au sommet de la pile. |
2 | Filtrer par balise | Filtre | Ce filtre ne conserve que les acteurs disposant de la balise « Métal », puis transmet cette liste d'acteurs au bloc suivant. |
3 | Filtrer par étiquette d'acteur | Filtre | Ce filtre ne conserve que les acteurs dont les noms contiennent le mot « Mécanique », puis les transmet au bloc suivant. |
4 | Définir une collision simple | Opérateur | Cet opérateur définit une forme de collision de boîte sur toutes les ressources de maillage statique référencées par l'ensemble d'acteurs transmis via les filtres ci-dessus. Il transmet ensuite la même liste d'acteurs au bloc suivant. |
5 | Définir le matériau | Opérateur | Le dernier opérateur recherche tous les matériaux sur tous les composants de maillage statique appartenant à l'ensemble d'acteurs transmis via les filtres ci-dessus et remplace ces matériaux par le substitut spécifié dans le paramètre Matériau du bloc. |
Une fois tous les blocs de cette action terminés, l'action suivante dans le graphique commence à s'exécuter. Lorsque l'action suivante démarre, elle rassemble à nouveau toutes les données du monde temporaire. Les filtres mis en place par les blocs précédents ne sont plus pris en compte. Cependant, toutes les modifications apportées à la scène par les actions précédentes sont conservées pour l'action suivante, notamment la modification des matériaux, la suppression des acteurs, etc.
Utiliser des filtres
Tous les blocs de filtres offrent des options supplémentaires qui vous permettent de capturer plus facilement la liste exacte des ressources, acteurs et composants que vous souhaitez modifier avec vos blocs d'opérations, et de vérifier que vos filtres produisent l'effet escompté.
Pour accéder à ces options, faites un clic droit sur n'importe quel bloc de filtre et recherchez la section Filtre dans le menu contextuel.
Cliquez sur l'image pour l'afficher à taille réelle.
Si vous souhaitez affecter plusieurs blocs de filtres, maintenez la touche Ctrl enfoncée tout en faisant un clic gauche sur les blocs pour créer votre sélection. Une fois tous les blocs à affecter mis en surbrillance, faites un clic droit sur n'importe quel bloc en surbrillance. Vous pouvez également cliquer et faire glisser pour sélectionner plusieurs blocs.
Créer un filtre à partir des ressources sélectionnées
Après avoir sélectionné un ou plusieurs acteurs ou composants dans le hublot, l'organiseur ou le panneau Ressources, faites un clic droit n'importe où dans l'éditeur de graphique Dataprep puis, dans le menu contextuel, sélectionnez Créer un filtre à partir de la sélection.
Cliquez sur l'image pour l'afficher à taille réelle.
Le nouveau filtre affiche le nombre d'acteurs et de ressources qui seront sélectionnés, ainsi que les premiers acteurs ou ressources de la liste.
Vous ne pouvez pas modifier cette liste directement, mais pouvez créer un nouveau filtre qui inclut celle-ci en procédant comme suit :
- Faites un clic droit sur le filtre Filtrer par sélection dans la formule Dataprep.
- Dans le menu contextuel, sélectionnez Aperçu du ou des filtres. Les acteurs et ressources sont mis en surbrillance dans le panneau Aperçu de l'organiseur du monde que ce filtre sélectionne.
- Pour ajouter de nouveaux acteurs et ressources au filtre, cliquez dessus tout en maintenant la touche Ctrl enfoncée dans le panneau Aperçu de l'organiseur du monde.
- Faites un clic droit n'importe où dans l'éditeur de graphique Dataprep puis, dans le menu contextuel, sélectionnez Créer un filtre à partir de la sélection.
Inverser la logique de filtre
Choisissez Filtre > Inverser la sélection de filtre(s) pour inverser la logique de sélection de n'importe quel bloc Sélectionner par, le convertissant ainsi en bloc Exclure par. Dans ce cas, les opérations de la même action s'appliquent uniquement à l'ensemble des éléments de scène qui ne correspondent pas aux critères que vous avez définis.
Afficher un aperçu des résultats du filtre
Choisissez Filtre > Aperçu des filtres pour que les panneaux Aperçu du navigateur de contenu et Aperçu de l'organiseur du monde affichent une coche en regard de l'ensemble des ressources et acteurs sélectionnés par votre filtre.
Cliquez sur l'image pour l'afficher à taille réelle.
Vous ne pouvez prévisualiser qu'un seul filtre ou un seul ensemble de filtres sélectionné à la fois. Si vous commencez à prévisualiser un filtre ou un ensemble de filtres différent, vos filtres précédents cessent de s'afficher.