Guide pour importer et mettre à jour du contenu Datasmith dans Unreal Engine

Ce que vous apprendrez dans ce guide

Datasmith sert à transférer dans Unreal Engine du contenu provenant d’applications ou de formats de conception 3D pris en charge. Ce guide explique comment ajouter du contenu Datasmith à un projet, réimporter les modifications du fichier source et appliquer ces mises à jour aux acteurs du Level existant. Il montre également comment mettre à jour des ressources Static Mesh, Material et Texture individuellement, sans actualiser toute la scène.

Dans ce workflow, il est important de distinguer la ressource Datasmith Scene créée à partir du fichier source du Datasmith Scene Actor présent dans le Level. La réimportation peut mettre à jour les ressources du projet ; l’application des modifications aux acteurs de la scène dépend des paramètres de synchronisation choisis lors de cette réimportation. Traiter séparément ces deux aspects aide à mieux contrôler la portée des mises à jour.

Prérequis

Avant de commencer, ouvrez le projet à utiliser dans Unreal Editor et vérifiez que le plugin Datasmith Importer est activé. S’il ne l’est pas, les options d’importation Datasmith ne s’affichent pas. Certains plugins Datasmith peuvent être activés par défaut si le projet a été créé à partir du modèle Architecture ou Automotive, Product Design, and Manufacturing. Vérifiez néanmoins que l’option nécessaire est disponible.

Des plugins ou logiciels supplémentaires peuvent être requis selon le format du fichier source. Parmi les exemples indiqués dans la documentation d’Epic Games figurent les fichiers .wire : ils nécessitent l’installation d’une version d’Autodesk Alias AutoStudio compatible avec la source. Les prérequis pour les autres formats et applications varient également en fonction du type de source. Les guides de référence ne précisant pas de version particulière d’Unreal Engine ni de condition relative au compte, aucune exigence de version ou de compte n’est ajoutée ici.

Si vous ajoutez le contenu à un Level existant, ouvrez celui-ci au préalable. Vous pouvez créer un nouveau Level pour une scène distincte ou utiliser le Level par défaut.

Importer du contenu Datasmith

1. Ouvrez le projet cible dans Unreal Editor. Ouvrez le Level où le contenu sera placé ; si nécessaire, créez-en un nouveau ou utilisez le Level par défaut.

2. Ouvrez le menu Create dans la barre d’outils principale et sélectionnez Datasmith > File Import. Dans la fenêtre de sélection des fichiers, choisissez le fichier source et cliquez sur Open.

3. Sélectionnez l’emplacement où le contenu sera stocké dans le projet, puis cliquez sur OK. Pour créer un nouveau dossier parent, faites un clic droit sur une zone vide de la fenêtre de sélection des fichiers. Pour créer un sous-dossier dans un dossier existant, faites un clic droit sur le dossier concerné.

4. Dans la fenêtre Datasmith Import Options, choisissez les types de contenu à récupérer depuis le fichier source et vérifiez les autres paramètres d’importation. Les options variant selon le format de fichier, ne supposez pas qu’elles sont identiques pour toutes les sources.

5. Une fois les paramètres définis, cliquez sur Import. Datasmith traite le fichier source, crée de nouvelles ressources dans le projet et place le Datasmith Scene dans le Level ouvert.

Pour personnaliser le processus d’importation, vous pouvez utiliser le scripting visuel Blueprints ou des scripts Python. Dataprep permet d’appliquer des opérations supplémentaires pendant l’importation ; les recettes peuvent être enregistrées et réutilisées. Il s’agit d’options de personnalisation, et non d’étapes obligatoires pour effectuer un transfert de fichier standard.

Mettre à jour la scène lorsque le fichier source change

Si vous avez enregistré les modifications de la scène source dans le même fichier sur le disque que précédemment, faites un clic droit sur la ressource Datasmith Scene dans le Content Browser, puis choisissez Reimport. Si les modifications se trouvent dans un autre fichier, choisissez Reimport With New File et indiquez le nouveau fichier.

La réimportation propose des options similaires à celles utilisées lors de l’importation initiale. La section Sync Current Level Actors permet en outre de déterminer si les modifications de la ressource Datasmith Scene mise à jour doivent être appliquées aux Datasmith Scene Actor concernés dans le Level ouvert. Une fois les options définies, cliquez sur Import.

La réimportation peut modifier la géométrie des Static Mesh, les Parent Materials et les ressources Texture dans le Content Browser. Ne la considérez donc pas comme une simple actualisation de l’affichage de la scène : les ressources du projet peuvent également être affectées. Avant de lancer l’opération, examinez la portée des modifications de la source et vos préférences de synchronisation.

Pour synchroniser les acteurs pendant la réimportation, ouvrez le Level concerné, réimportez la ressource Datasmith Scene et cochez Datasmith Scene Actors dans la section Sync Current Level Actors de la fenêtre Import Options. Si les acteurs précédemment supprimés doivent également être réintégrés au Level, activez l’option Re-Spawn Deleted Actors.

La synchronisation peut aussi être effectuée ultérieurement. Ouvrez le Level concerné et sélectionnez le Datasmith Scene Actor dans l’Outliner. Dans la section Datasmith du panneau Details, cliquez sur Update actors from Scene. Si vous souhaitez rétablir les acteurs supprimés, cochez l’option Respawn deleted actors avant l’opération.

Mettre à jour des ressources individuellement

Vous pouvez aussi mettre à jour des ressources individuelles au lieu de réimporter toute la ressource Datasmith Scene. Dans le Content Browser, faites un clic droit sur la ressource Static Mesh, Material ou Texture concernée, puis choisissez Reimport. Pour les ressources Material, l’option Datasmith > Reimport Material apparaît pour celles que Datasmith a créées de zéro à partir de la définition du matériau dans le fichier source. Selon le guide de référence, c’est généralement le cas des Parent Materials importés depuis 3ds Max ; l’option peut être absente pour les instances Material basées sur les matériaux intégrés de Datasmith.

Lors de la réimportation d’une ressource individuelle, une fenêtre s’ouvre pour les paramètres, mais elle ne propose pas de synchroniser les acteurs du Level. Les références du projet utilisent toutefois automatiquement la nouvelle version de la ressource mise à jour. Autrement dit, l’absence d’option de synchronisation des acteurs pour l’importation d’une ressource individuelle ne signifie pas qu’une étape de synchronisation supplémentaire est nécessaire pour actualiser les références de la ressource.

Erreurs courantes et prochaines étapes

• Si les options Datasmith ne s’affichent pas, vérifiez d’abord que le plugin Datasmith Importer est activé dans le projet.

• Pour effectuer une mise à jour à partir d’un autre fichier source, utilisez Reimport With New File plutôt que Reimport.

• Ne confondez pas la réimportation et la synchronisation des acteurs du Level : vérifiez l’option Sync Current Level Actors.

• Gardez à l’esprit que la réimportation d’une ressource individuelle ne propose pas de synchroniser les acteurs du Level, tandis que les références de la ressource utilisent automatiquement la version actualisée.

• N’oubliez pas que la réimportation peut affecter la géométrie des Static Mesh ainsi que les ressources Parent Materials et Texture.

Dans les workflows d’architecture, de design d’intérieur et d’archviz, Datasmith peut servir à importer dans un projet Unreal Engine du contenu provenant d’une source de conception prise en charge et à y transférer les modifications de la scène source. Il est important de déterminer si les modifications doivent s’appliquer à l’ensemble de la scène ou à certaines ressources seulement. Les équipes peuvent décider ensemble du moment où synchroniser les acteurs de la scène et de l’opportunité de rétablir les acteurs supprimés.

Les documents de référence ne fournissant pas d’informations sur la configuration matérielle requise ni sur les frais de licence, il convient de ne pas spéculer sur ces sujets. Avant de commencer, vérifiez que le format du fichier source est pris en charge, que les logiciels supplémentaires nécessaires sont installés et que les plugins du projet sont activés. Pour la suite, consultez les descriptions de Datasmith Import Options correspondant au type de fichier utilisé ; pour les opérations récurrentes, vous pouvez envisager des personnalisations avec Blueprints, Python ou Dataprep.

Sources et licence

Ce guide est une adaptation en turc des guides d’Epic Games « Importing Datasmith Content into Unreal Engine » et « Reimporting Datasmith Content into Unreal Engine ». Les deux sources sont indiquées comme licence=libre.