XangleCs documentation

Scanner de photogrammétrie – Architecture Raspberry Pi – guide complet

Par Eric Paré / Xangle – https://xangleCs.com

Dernière révision : 26 septembre 2023

Préparation du studio
1. Une pièce blanche (murs / sols peints en blanc) est votre meilleure option pour faire rebondir la lumière et éclairer uniformément le sujet avec vos stroboscopes
Installation matérielle
1. Structure Suivez les instructions fournies pour le modèle acheté
2. Composants électroniques
  1. Connectez les caméras aux Raspberry Pis à l'aide du câble USB (données, 4 caméras par Raspberry Pi)
  2. Connectez l'alimentation des caméras à l'adaptateur secteur (Usb charger hub, Esper, ou adaptateurs secteur Canon d'origine)
  3. Connectez les Raspberry Pis à un Usb charger hub à l'aide d'un câble USB-C (alimentation)
  4. Connectez les Raspberry Pis aux commutateurs 8 ports à l'aide de câbles Ethernet (données)
  5. Connectez les commutateurs 8 ports au commutateur maître à l'aide de câbles Ethernet
  6. Connectez le commutateur maître à l'ordinateur principal à l'aide d'un câble Ethernet
3. Caméras
  1. Suivez les instructions de configuration Xangle par marque de caméra pour les caméras Canon, Sony, Android ou Pi.
  2. Répartissez vos caméras sur votre structure en fonction de vos projets spécifiques. Dans certains cas, vous aurez besoin d'une densité plus élevée sur le visage (moins de caméras à l'arrière). Dans d'autres cas, vous devrez pouvoir couvrir une pose en T, ce qui signifie des caméras pointant vers les mains/bras de votre sujet (au-dessus et en dessous). Pour une installation plus générique, dézoomez les objectifs afin de pouvoir couvrir toute la zone au sein de votre structure. Plus vous zoomez, meilleurs seront les détails que vous obtiendrez, mais plus il sera difficile de couvrir tout ce dont vous avez besoin.
  3. Placez un mannequin texturé au centre de la structure. Assurez-vous d'avoir suffisamment de lumière (continue, uniforme). L'utilisation d'un mannequin est facultative, mais cela vous aidera à faire la mise au point automatique sur tous les objectifs et à bien voir le cadrage pour chaque caméra.
  4. Faites la mise au point sur tous les objectifs à l'aide du bouton d'autofocus (cela peut également être fait en une seule fois via Xangle une fois que tout est configuré). Vous pouvez laisser la mise au point sur « auto » car nous la désactivons depuis Xangle.
  5. Cadrage (scan de tête) : zoomez tous les objectifs à 55 mm et pointez droit pour une couverture maximale.
  6. Cadrage (corps entier) : zoomez tous les objectifs à environ 35 mm et pointez les caméras de manière à couvrir le corps entier avec un chevauchement d'environ 25 %. Toutes les caméras sont verticales sauf la n°1. La première caméra est normalement utilisée comme vignette pour la galerie Xangle, donc la garder dézoomée permet d'obtenir une feuille de référence propre pour votre client (toutes les poses sur une seule page)
  7. Essayez de zigzaguer verticalement vos caméras sur votre structure (évitez d'avoir deux caméras côte à côte)
Installation logicielle
1. Téléchargez XangleCs depuis https://xangleapps.net/downloadsAssurez-vous de maintenir votre version de Xangle à jour en visitant cette page. Vous trouverez le journal des modifications sur https://xanglecs.com/changelog
2. Exécutez le fichier d'installation
3. Lancez XangleCs.exe depuis le dossier d'installation. Au premier lancement, un dossier sera créé dans c:\users\votre-nom-d'utilisateur\xangleCs. C'est là que vous trouverez tous vos fichiers de configuration et les images capturées par le logiciel.
4. Connectez-vous à l'aide de vos identifiants fournis lors de l'achat
5. XangleCS peut être utilisé pour de nombreux scénarios multi-caméras différents. Au premier lancement, sélectionnez « photogrammétrie » parmi les préréglages d'interface utilisateur proposés. Vous pouvez modifier cela à tout moment depuis les paramètres. Cela modifie les menus en haut et les modules affichés sur le dashboard. Mais cela garantit également que les processus sont optimisés pour la photogrammétrie (pas de génération de mp4, pas de calibration…)
6. Assurez-vous de voir toutes vos caméras. Si certaines sont manquantes, il est plus probable que cela soit dû au fait que les Raspberry Pis ne sont pas visibles sur le réseau. Consultez le guide de dépannage pour plus de détails
Ordre des caméras
1. Éteignez toutes les caméras
2. Une fois que le nombre de caméras est à zéro, allez au panneau des caméras (cliquez sur le nombre de caméras)
3. Lancez le processus de commande
4. Allumez les caméras une par une dans le bon ordre (la caméra n°1 est la première que vous allumez, etc.)
5. Assurez-vous d'attendre le signal audio (ou l'augmentation du nombre de caméras) avant d'allumer la suivante
6. Confirmez l'ordre

Remarques :

La caméra n°1 est généralement la plus orientée vers l'avant. Cela vous donne une bibliothèque propre pour une référence facile. Dans le cas d'un corps entier, dézoomez la n°1 à 18 mm (et ne l'utilisez pas pour l'objet 3D). Ce faisant, vous perdez une caméra, mais vous obtenez un plan de référence de la pose complète.

Configuration de l'éclairage
1. Lumière continue (ambiance) Voir la démo complète du processus sur https://www.youtube.com/watch?v=KrsvGJQTLp0. Ces lumières ne sont pas utilisées pour la capture, mais uniquement pour l'expérience utilisateur
  1. Coupez l'alimentation de toute la structure
  2. Installez les XangleBoards sur les Raspberry Pis
  3. Installez vos bandes LED sur votre structure
  4. Mettez sous tension
  5. Naviguez vers http://localhost:8089/lights
  6. Créez des préréglages pour « 100% white » et « countdown colors »
  7. En bas de la page, définissez le préréglage à utiliser pour le compte à rebours (« countdown colors ») et le temps de déclenchement (off)
  8. Depuis le dashboard, modifiez le mode de déclenchement pour ajouter un délai de 2000 ms (2 secondes)
2. Stroboscope (flash pour figer le sujet)
  1. Installez votre déclencheur de flash (un seul) sur la griffe porte-accessoire de votre dernière caméra. Cette caméra sera considérée comme une caméra « de sacrifice » et son image ne sera pas utilisée. Son but est uniquement d'envoyer un signal de déclenchement exactement à mi-chemin du temps d'exposition. Il est important d'utiliser le même modèle de caméra car le timing peut être légèrement différent entre les modèles.
  2. Installez vos lumières et associez-les à votre déclencheur de flash. Voici trois méthodes différentes de configuration de l'éclairage qui peuvent être utilisées. Dans tous les cas, les réglages sont les mêmes sur tous vos flashs.
    1. Stroboscopes, par rebond (méthode préférée) : placez les lumières juste à l'extérieur de la structure et pointez vers l'extérieur. Dans une pièce carrée, pointez quatre lumières vers les quatre coins pour maximiser le rebond de la lumière.
    2. Stroboscopes, à travers des rideaux blancs : installez des rideaux blancs (les rideaux de douche fonctionnent parfaitement) derrière vos caméras. Installez vos lumières derrière les rideaux et pointez vers le centre de la structure. Vous aurez généralement besoin de 6 à 10 unités de flash pour obtenir une lumière uniforme. Cette méthode fonctionne bien mais peut vous donner un accès plus difficile à vos caméras.
    3. Speedlights + diffuseurs : installez vos speedlights directement sur la structure, et ajoutez un diffuseur sur chacun d'eux (papier plié, ou toute solution plus sophistiquée). Pointez directement vers votre sujet. C'est la meilleure méthode si vous êtes dans un petit espace avec de l'espace autour de votre structure.
  3. Dans Xangle, définissez le mode de déclenchement sur « Freeze », et activez la compensation (à mi-chemin de l'exposition). Utilisez une shutter speed de 1/60s, prenez une photo et vérifiez si vous obtenez des images noires. Si vos caméras sont plus lentes, vous devrez peut-être descendre à 1/10s.
    Remarques :
    Le but est de figer le sujet en utilisant la lumière (rapide) au lieu des obturateurs des caméras (lents). En utilisant la vitesse de la lumière, il est possible de capturer votre modèle en train de sauter ou effectuant tout type de mouvement rapide.
Logiciel
1. Déclenchement : Déclenchez toutes les caméras en utilisant le bouton « trigger » sur le dashboard, la touche « b » du clavier, une manette de jeu (touche « b »), ou une télécommande de présentation PowerPoint (touche « black out »).
2. Revue des images : Utilisez la Library pour revoir vos images.
  1. Utilisez les touches gauche/droite pour parcourir les ensembles de données
  2. Utilisez les touches haut/bas pour parcourir les images d'un ensemble de données
  3. Utilisez les touches Maj + haut/bas pour parcourir les itérations d'un ensemble de données (burst, ROM, OLAT)
  4. Utilisez les touches 1,2,3,4,5 pour noter votre ensemble de données
  5. Utilisez la molette de votre souris pour zoomer/dézoomer à l'intérieur des images
3. Revue des images : Il existe 3 façons de revoir les images
  1. Dashboard
  2. /frames (page web)
  3. Library (utilisez le raccourci « t » pour basculer entre l'image unique et la liste complète des images)
    La taille / l'espacement de ce module peut être configuré depuis les paramètres
4. Revue d'image unique : il est possible de lancer des fenêtres avec des images spécifiques pour une revue rapide. Pour ce faire, ouvrez un navigateur avec cette adresse : http://localhost:8089/preview/22 où 22 est le numéro d'image. Vous pouvez ouvrir plusieurs navigateurs sur le même ordinateur, ou sur de nombreux autres ordinateurs / tablettes en utilisant l'adresse IP au lieu de localhost (voir l'onglet « devices » pour commencer)
Folders & file renaming

La meilleure utilisation de ce module est de préparer à l'avance les préréglages de nommage pour les noms des talents et les poses sélectionnées.

Chemin de base : ajoutez le nom de tous les talents
Session : ajoutez la liste de toutes les poses requises

Voir tous les détails sur https://doc.xanglecs.com/files

Sessions complètes
1. Logiciel workflow : A usual workflow for a photogrammetry session looks like this:Xangle -> Lightroom (raw processing) -> Reality capture (3d model build) -> ZBrush (model cleaning) -> Unreal Engine (final product). Most high-end sessions are going to be in RAW quality, meaning you’ll have to edit the RAW files in Lightroom before creating the 3d object. Some 3d Logiciel can handle RAW files, but the LightRoom raw processor is the best one out there, meaning you can get more of your files by doing this extra step.
2. Préparation de la session : avant chaque session, assurez-vous que tous les objectifs sont propres, mis au point et que les caméras sont bien cadrées. Faites un essai avec un sujet réel et effectuez une construction rapide pour vous assurer que tout est parfait. Depuis RealityCapture, vérifiez le score très bas par caméra. Cela vous donnera une idée des caméras qui sont soit floues, soit pointent vers des endroits non pertinents. Vérifiez également l'espace disque et assurez-vous d'être à jour avec votre version de Windows.
3. Préparation du talent
  1. Visage rasé / propre / pas de maquillage (scan de tête)
  2. Pas de bijoux
  3. Vêtements (scan de tête) : t-shirt blanc, bonnet de perruque
  4. Vêtements (scan de corps entier) : pas de chemise/pantalon de couleur unie
  5. Pas de matière réfléchissante, pas de matière transparente,
  6. Essuyez la sueur (ayez beaucoup de lingettes à portée de main)
  7. Marqueurs à points sur le visage (si nécessaire)
4. Autres exigences
  1. Pour la plupart des sessions, des ensembles de données de charte de couleurs et de charte d'échelle sont requis
  2. Un plan vide (scan de corps entier) pourrait être requis dans certains cas pour la soustraction de l'arrière-plan
Produits
1. Liste d'équipement : https://xanglecs.com/gear
2. Mannequin : https://amzn.to/3zLBWt1
3. Charte de couleurs/charte d'échelle : https://amzn.to/3p0Na6N
4. Repose-tête : À confirmer
5. Chaise : À confirmer