Guide de la ligne de commande RealityScan : des photos au modèle 3D

Ce que vous allez apprendre dans ce guide

L’interface en ligne de commande de RealityScan permet d’enchaîner certaines opérations de l’application à l’aide de commandes et d’automatiser des tâches répétitives avec un fichier de commandes. Dans ce guide, vous allez ajouter au projet les photos d’un espace architectural, les aligner, enregistrer le projet, lancer des opérations configurées dans l’application, puis simplifier et exporter un modèle. Les commandes utilisent des noms de dossiers d’exemple : adaptez-les à vos répertoires de travail.

Cette méthode ne garantit pas l’automatisation de chaque opération. Par exemple, la commande -start lance les opérations préalablement configurées pour le bouton Start dans RealityScan. Il faut donc tenir compte à la fois des paramètres définis dans l’application et des étapes exécutées en ligne de commande.

Prérequis

La documentation officielle présente les exemples de commandes en passant par RealityScan.exe. Les étapes ci-dessous concernent l’invite de commandes Windows et les fichiers .bat. La documentation ne précise aucune version particulière, configuration matérielle minimale, type de compte ni information tarifaire. Avant de commencer un projet, vérifiez donc séparément l’installation utilisée et les conditions de licence.

L’exemple utilise les chemins C:\RS\Images et C:\RS\Interior.rsproj pour le dossier de photos et le fichier de projet. Créez ces dossiers sur votre ordinateur et placez les images au bon endroit. Si les chemins utilisés dans les commandes comportent des espaces, vérifiez sur votre installation comment les paramètres sont interprétés ; les exemples privilégient les chemins sans espaces.

Ajouter le dossier RealityScan à la variable système PATH évite de devoir répéter le chemin complet de l’application dans chaque commande. La documentation officielle indique que la ligne PATH ci-dessous ne s’applique qu’à la session d’invite de commandes ouverte.

Étapes de l’application

1. Alignez les photos en mode brouillon

Commencez par ajouter les images et lancer un alignement rapide en mode brouillon. Dans cet exemple, le dossier de l’application est ajouté au PATH, puis les photos sont importées depuis le dossier et le projet est enregistré :

set PATH=%PATH%;C:\Program Files\Epic Games\RealityScan\
RealityScan.exe -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

-draft lance l’alignement en mode brouillon. Cette première vérification permet de voir si les photos s’assemblent correctement. Avant de passer à l’alignement complet, il est plus sûr d’ouvrir le projet dans l’application et de vérifier le résultat.

2. Incluez les sous-dossiers si nécessaire

Si les images sont réparties dans des sous-répertoires du dossier principal, activez l’analyse des sous-dossiers avant l’importation :

RealityScan.exe -set "appIncSubdirs=true" -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

Ce paramètre permet à la commande -addFolder de prendre également en compte les sous-dossiers. Si les images se trouvent déjà dans un seul dossier, ce réglage supplémentaire n’est pas nécessaire. Au lieu d’exécuter ces deux exemples à la suite sur le même projet, choisissez un seul flux de travail adapté à l’organisation des photos.

3. Lancez l’alignement complet

Après avoir vérifié le résultat du mode brouillon, rechargez le projet enregistré et lancez l’alignement complet :

RealityScan.exe -load C:\RS\Interior.rsproj -align -save C:\RS\Interior.rsproj -quit

Les commandes sont exécutées dans l’ordre : le projet s’ouvre, l’alignement est effectué, puis le résultat est enregistré dans le même fichier de projet. Les paramètres de la ligne de commande fonctionnent de manière similaire aux opérations de l’application ; celle-ci peut s’ouvrir normalement et autoriser une interaction de l’utilisateur pendant le traitement. L’option -headless, qui masque l’interface, est également documentée, mais lors des premiers essais, il peut être plus facile de contrôler le résultat en gardant l’interface visible.

4. Lancez le flux de traitement défini dans l’application

Après l’alignement, configurez dans le bouton Start de RealityScan les opérations nécessaires à la création du modèle. Selon la documentation officielle, -start lance les processus configurés pour ce bouton. Ne supposez donc pas que l’ajout de cette seule commande détermine les étapes de modélisation à effectuer.

RealityScan.exe -load C:\RS\Interior.rsproj -start -save C:\RS\Interior.rsproj -quit

Les options utilisées pendant le traitement doivent être vérifiées dans l’application en fonction du projet et de l’objectif. La ligne de commande facilite la répétition de ce flux prédéfini, mais ne garantit pas à elle seule que les paramètres soient appropriés.

5. Simplifiez et exportez le modèle

Si vous connaissez le nom du modèle dans le projet, vous pouvez le sélectionner avec -selectModel, définir le nombre de triangles cible avec -simplify, puis l’exporter avec -exportSelectedModel. L’exemple ci-dessous utilise le nom Model1 et une cible de 1.000.000 triangles ; cette valeur illustre l’utilisation de la commande et ne constitue pas une recommandation de qualité.

RealityScan.exe -load C:\RS\Interior.rsproj -selectModel Model1 -simplify 1000000 -exportSelectedModel C:\RS\Interior.obj -save C:\RS\Interior.rsproj -quit

Remplacez le nom du modèle par son nom réel dans le projet. Pour gérer plus finement les paramètres de simplification et d’exportation, vous pouvez ajouter aux commandes, en option, le fichier params.xml exporté depuis les outils concernés de l’application. Les paramètres à utiliser dépendent de la manière dont le fichier a été préparé dans l’application.

Erreurs fréquentes

• Si vous lancez RealityScan.exe sans vous placer dans le dossier d’installation de l’application, l’exécutable risque de ne pas être trouvé. Utilisez le chemin complet de l’application ou ajoutez la ligne PATH à la session de commandes active.

• Ne supposez pas que les images des sous-dossiers seront automatiquement importées. Si vous en avez besoin, utilisez le paramètre appIncSubdirs.

• Ne considérez pas l’alignement en mode brouillon comme un résultat final. -draft et -align sont deux commandes d’alignement différentes ; vérifiez le projet après l’étape brouillon.

• Ne présumez pas des opérations lancées par la commande -start. Configurez au préalable les paramètres du bouton Start dans l’application.

• Une sélection du modèle avec un nom incorrect ou un mauvais chemin de projet peut empêcher le flux de travailler sur le fichier attendu. Vérifiez que les noms de projet et de modèle correspondent à ceux de l’application.

Conséquences pour les flux de travail en architecture, intérieur et archviz

Les équipes qui traitent des modèles créés à partir de photos d’espaces ou de bâtiments peuvent tirer parti de la ligne de commande pour les projets où les mêmes étapes d’importation et d’alignement sont répétées. La simplification et l’exportation figurent également parmi les outils documentés ; il est donc possible de créer un flux de travail pour préparer à différentes étapes un modèle obtenu à partir de photos. Cette méthode ne remplace pas les décisions architecturales : c’est un outil destiné à organiser des données issues de photos dans un projet et à répéter certaines opérations.

Dans les projets menés par plusieurs personnes au sein d’un bureau, il est important de conserver une organisation cohérente des dossiers, des noms de projets et des paramètres de traitement dans l’application. La documentation RealityScan ne donne aucune information sur la compatibilité avec un logiciel archviz particulier, le matériel requis ni le coût de la licence. Il faut donc tester séparément, avec les données d’un vrai projet, l’utilisation du fichier exporté dans l’application cible, l’effet du matériel sur la durée de traitement et les conditions de licence.

Étapes suivantes

Une fois le flux de base opérationnel, vous pouvez examiner d’autres commandes de projet, comme l’ajout d’images à partir d’une liste, le chargement et l’enregistrement d’un projet. Pour l’alignement, il existe des options d’exportation et de réutilisation des métadonnées de caméra XMP. Les outils de modèle documentés comprennent aussi le nettoyage, la fermeture des trous, le calcul des textures et différentes opérations d’exportation. Tester chaque nouvelle commande sur une copie de projet de petite taille contribue à réduire le risque d’écraser le travail en cours.

Sources et licence

Ce guide s’appuie sur les sections de la documentation RealityScan publiée par Epic Games consacrées aux commandes de projet et d’image, aux commandes d’alignement et aux outils de modèle. Les sources sont indiquées comme libres de licence ; leur contenu a été adapté en turc et les exemples réorganisés pour ce guide.