360° Photo Sphere (pano 360)

RIM-Nat prend en charge l’importation de bulles photo 360°, permettant d’intégrer des panoramas immersifs dans les projets 3D. Ce format est particulièrement utile pour fournir des vues détaillées des environnements capturés. Ce guide fournit les spécifications attendues pour préparer correctement les données avant leur importation.

Options d’importation disponibles

Vous avez deux options pour préparer vos données avant de les importer dans RIM-Nat :

1. Option 1 : Envoyer les images avec les fichiers .excam associés et un fichier origin.txt.
2. Option 2 : Envoyer les images avec un fichier de calage au format texte contenant les coordonnées pour chaque image, ainsi qu’un fichier origin.txt.

Chaque option nécessite une structure et des formats de fichiers spécifiques, décrits en détail ci-dessous.

Option 1 : Images + Fichiers .excam + origin.txt

Structure des Fichiers

• Images : Toutes les photos doivent être au format JPEG (JPG).
• Fichiers .excam : Chaque image doit avoir un fichier .excam associé, contenant les paramètres de la caméra.
• Fichier d’origine (origin.txt) : Ce fichier définit les valeurs de translation initiales pour ajuster les coordonnées des images.

Préparation des Données

1. Images

• Format : Les images doivent être au format JPEG (JPG).
• Emplacement : Placez toutes les images dans le même répertoire.
• Nom des Fichiers : Les noms de fichiers ne doivent pas contenir d’espaces, d’accents ou de caractères spéciaux.

2. Fichiers .excam

Les fichiers .excam contiennent les paramètres externes de la caméra pour chaque image.

• Contenu du Fichier .excam :

  3DReshaper camera external parameters
  X = 73.4221
  Y = -12.96
  Z = 21.422
  # Orientation is given with Euler angles in radians 
  Omega = 0.000809356
  Phi = -3.1405
  Kappa = 0.483712

• Correspondance : Assurez-vous que chaque fichier .excam correspond à l’image associée.

• Emplacement : Placez les fichiers .excam dans le même répertoire que les images.

3. Fichier d’Origine (origin.txt)

Le fichier origin.txt est utilisé pour définir les coordonnées d’origine pour la translation globale des points.

• Format du Fichier :

  • Une seule ligne avec les valeurs séparées par un séparateur (\t, ;, ,, |) :

    1000.0;2000.0;50.0

  • Ou trois lignes séparées avec chaque coordonnée sur une ligne :

    1000.0
    2000.0
    50.0

• Remarques :

  • Les valeurs doivent être des nombres décimaux avec un point (.) comme séparateur décimal.
  • Si le fichier origin.txt est absent ou invalide, [0, 0, 0] sera utilisé par défaut.

Compression des Fichiers

• ZIP : Compressez l’ensemble des images, des fichiers .excam et le fichier origin.txt dans un fichier ZIP non protégé par mot de passe.
• Structure : Maintenez la structure des répertoires lors de la compression.

Option 2 : Images + Fichier de Calage TXT + origin.txt

Structure des Fichiers

• Images : Toutes les photos doivent être au format JPEG (JPG).
• Fichier de Calage : Un fichier texte contenant les informations de coordonnées et d’orientation pour chaque image.
• Fichier d’origine (origin.txt) : Ce fichier définit les valeurs de translation initiales pour ajuster les coordonnées des images.

Préparation des Données

1. Images

• Format : Les images doivent être au format JPEG (JPG).
• Emplacement : Placez toutes les images dans le même répertoire.
• Nom des Fichiers : Les noms de fichiers ne doivent pas contenir d’espaces, d’accents ou de caractères spéciaux.

2. Fichier de Calage

Le fichier de calage contient les informations de position et d’orientation de chaque image.

• Format du Fichier :

  • Type de Fichier : Texte avec extension .txt ou .csv.

  • Encodage : UTF-8 recommandé.

  • Séparateur de Champs : Tabulation (\t), point-virgule (;), virgule (,), ou pipe (|).

  • Ligne d’En-tête Obligatoire :

    File	Time	x	y	z	course	pitch	roll
    • Si des quaternions sont utilisés pour l’orientation, ajoutez le champ real à la fin.

• Champs Attendus :

  1. File : Nom de l’image (doit correspondre exactement au nom des fichiers images).
  2. Time : Horodatage (nombre flottant, ex. timestamp Unix).
  3. x, y, z : Coordonnées spatiales (nombres flottants).
  4. course : Angle de cap en degrés (nombre flottant).
  5. pitch : Angle de tangage en degrés (nombre flottant).
  6. roll : Angle de roulis en degrés (nombre flottant).
  7. real (optionnel) : Composante réelle d’un quaternion (pour certains formats spécifiques).

• Exemple de Contenu :

  File	Time	x	y	z	course	pitch	roll
  image1.jpg	1622547800	100.0	200.5	50.0	0.0	0.0	0.0
  image2.jpg	1622547860	101.0	201.5	51.0	10.0	0.0	0.0

• Remarques Importantes :

  • Format Décimal : Utilisez le point (.) comme séparateur décimal.
  • Guillemets : Ne pas entourer les valeurs de guillemets.
  • Correspondance des Noms de Fichiers : Les noms dans le champ File doivent correspondre exactement aux noms des fichiers images après normalisation (minuscules, sans espaces ni caractères spéciaux).
  • Validité des Données : Les lignes avec des valeurs manquantes ou invalides seront ignorées.

3. Fichier d’Origine (origin.txt)

• Format : Identique à celui décrit dans l’Option 1.
• Utilisation : Les valeurs x, y, z du fichier de calage seront ajustées en fonction des coordonnées fournies dans origin.txt.

Compression des Fichiers

• ZIP : Compressez l’ensemble des images, le fichier de calage et le fichier origin.txt dans un fichier ZIP non protégé par mot de passe.
• Structure : Maintenez la structure des répertoires lors de la compression.

Détails techniques communs aux deux options

Format des données

• Nombres décimaux : Utilisez le point (.) comme séparateur décimal. Si des virgules sont utilisées, le système tentera de les convertir.
• Séparateurs de champs : Le système peut détecter automatiquement les séparateurs parmi les suivants : tabulation (\t), point-virgule (;), virgule (,), pipe (|).
• Guillemets : Les valeurs ne doivent pas être entourées de guillemets simples ou doubles. Le système les supprimera si nécessaire.

Gestion des Erreurs

• Fichier de Données Invalide : Si le fichier de données ne contient pas les en-têtes attendus ou que le séparateur ne peut pas être détecté, le traitement s’arrêtera et un message d’erreur sera affiché.
• Valeurs Manquantes ou Invalides : Les lignes contenant des valeurs manquantes ou invalides seront ignorées.
• Fichier Image Manquant ou Invalide : Si une image référencée n’est pas trouvée ou n’est pas au format JPEG valide, la ligne correspondante sera ignorée.
• Fichier origin.txt Manquant ou Invalide : Si origin.txt est absent ou invalide, [0, 0, 0] sera utilisé comme origine par défaut.

Exemple Pratique

Structure des fichiers pour l’Option 2

/MonProjet360/
├── image1.jpg
├── image2.jpg
├── image3.jpg
├── calage.txt
└── origin.txt

Contenu de calage.txt

File	Time	x	y	z	course	pitch	roll
image1.jpg	1622547800	100.0	200.5	50.0	0.0	0.0	0.0
image2.jpg	1622547860	101.0	201.5	51.0	10.0	0.0	0.0
image3.jpg	1622547920	102.0	202.5	52.0	20.0	0.0	0.0

Contenu de origin.txt

1000.0
2000.0
100.0