Chapitre 10 — Mode débutant

OÙ

Dans la barre en haut de la fenêtre, à gauche du sélecteur de mode. Visible uniquement en mode Débutant.

TECHNIQUE

Affiche les six étapes du pipeline sous forme de chaîne de boutons alignés, chacun avec une icône et un nom, séparés par une flèche : Import → Frame Quality → Cameras → Training → Preview → Export. L'étape actuelle est entièrement colorée, les étapes déjà franchies sont semi-transparentes, les étapes pas encore atteintes sont grisées. Les étapes déjà terminées sont cliquables et permettent de revenir en arrière ; l'étape actuelle et toutes celles pas encore atteintes sont désactivées, tout comme l'ensemble de la chaîne pendant qu'un traitement est en cours. Il n'existe plus de barre de progression en pourcentage continue sur l'ensemble du pipeline — la progression de l'étape en cours est indiquée par le grand cercle sur l'écran de traitement (C-19).

OÙ

Partie gauche de l'étape d'import, grand rectangle en pointillés avec icône. Affiché en mode Débutant avec le libellé « Drop photos or a video here ».

TECHNIQUE

Zone de dépôt qui fait légèrement rebondir l'icône et colore l'arrière-plan dès que des éléments glissés survolent le champ. Accepte JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, les paquets .radiancescene et les répertoires. Routage du dépôt selon le type : les images sont collectées et transmises triées, les vidéos déclenchent le chemin d'échantillonnage de frames, les fichiers splat ouvrent directement l'aperçu, les paquets de scène sont chargés. Les répertoires sont énumérés et toutes les images qu'ils contiennent sont importées. Les security-scoped bookmarks pour un accès conforme au bac à sable sont correctement acquis et libérés. Les extensions non prises en charge affichent une bannière d'avertissement pendant 5 secondes.

OÙ

À l'intérieur de la zone de dépôt, bouton bien visible.

TECHNIQUE

Bouton qui ouvre la boîte de dialogue de fichiers macOS avec sélection multiple et les types de fichiers JPG, PNG, TIFF, MP4, MOV, dossiers ainsi que le format de scène propre à l'application. Les URLs résultantes sont security-scoped et transmises via les mêmes chemins d'import que le glisser-déposer. Si l'utilisateur sélectionne un dossier, il est énuméré de manière récursive pour en extraire les images.

OÙ

À l'intérieur de la zone de dépôt, visible uniquement si le paquet de l'application contient la scène d'exemple et qu'aucune image/splat n'a encore été importé.

TECHNIQUE

N'apparaît que si (a) un fichier sample-scene.splat, .spz ou .ply est présent dans le paquet de l'application ET (b) qu'aucune image/vidéo n'a été importée et qu'aucun nuage de points n'existe encore. Au clic, charge le nuage de points terminé (préférence pour le format le plus léger — .splat ~3 Mo, .spz ~1,4 Mo, repli sur .ply) et applique après 400 ms des valeurs de caméra codées en dur issues des métadonnées d'origine de la scène de fleurs pour une perspective d'entrée esthétiquement cohérente.

OÙ

À l'intérieur de la zone de dépôt, à côté de « Try Sample Scene » ; mêmes conditions de visibilité.

TECHNIQUE

Télécharge depuis Internet un jeu d'exemples fourni par RadianceKit : environ 427 Mo pour 960 frames en pleine résolution, qui sont ensuite décompressés et directement intégrés dans l'application. Tant qu'un autre traitement est en cours, le bouton est désactivé et le téléchargement ne démarre pas. La progression du chargement n'est pas indiquée dans l'interface sous forme de pourcentage ; tu sais que le téléchargement est terminé quand tu vois que la liste d'images à droite se remplit des 960 frames.

OÙ

Barre d'outils inférieure flottante de l'overlay d'import, à gauche du bouton de démarrage.

TECHNIQUE

Sélecteur de menu avec le libellé « Quality », qui regroupe les préréglages fournis par catégorie en quatre sections : « Classic », « MCMC (fewer Gaussians, slower) », « Hybrid (sharp detail, compact) » et « Capture — curated real-world (Drone / 360° / Photo) ». Une cinquième section « Custom » s'ajoute dès que la version complète est débloquée et qu'au moins un préréglage personnalisé a été enregistré. État verrouillé : tous les préréglages sauf Quick et Preview reçoivent un suffixe « 🔒 » après le nom si l'utilisateur ne possède pas la version complète ; en cas de sélection, le sélecteur revient sur Preview et ouvre automatiquement la fenêtre d'achat. Lors de la sélection, le préréglage est appliqué, ce qui remplace l'intégralité de la configuration d'entraînement.

OÙ

Barre d'outils inférieure flottante de l'overlay d'import, à droite du sélecteur de préréglages.

TECHNIQUE

Bouton qui reste grisé tant qu'aucune image ni vidéo n'est importée. Au clic, démarre le pipeline et fait passer la machine à étapes dans l'ordre Frame-Quality → SfM → Training. Le bouton lui-même n'a pas d'autre état ; un traitement en cours apparaît à la place sous forme d'un écran de traitement séparé.

OÙ

Liste d'images à droite, visible uniquement si une vidéo (au lieu d'images) a été importée.

TECHNIQUE

Curseur de 0.5 fps à 30 fps par pas de 0.5. En cas de changement, la densité de frames est mise à jour et le nombre de frames cibles (au moins 10) est en plus calculé à partir de la densité et de la longueur de la vidéo. Le curseur se trouve en dehors de la liste d'images, car les éléments de liste bloqueraient les événements de souris des curseurs. Sous le curseur figurent les frames cibles calculées (« 247 frames ») et la longueur de la vidéo (« 1m23s video »). Une infobulle avertit : « Doubling the density doubles the number of frames and increases SfM time by ~100%. »

OÙ

Liste d'images à droite, en bas à droite ; visible uniquement si des images ont été importées.

TECHNIQUE

Bouton rouge. Le clic ouvre une boîte de dialogue de confirmation avec le titre « Clear all imported files? » et le message « N images will be removed. ». La confirmation vide toutes les images/vidéos importées, les répertoires de staging, le nuage de points, l'état d'entraînement, le résultat SfM et tous les caches ; l'étape revient à Import. Sur Cancel, tout est conservé. La boîte de dialogue est configurée avec un chemin par défaut non destructeur (le bouton destructeur est marqué en rouge).

OÙ

Liste d'images à droite, chaque entrée.

TECHNIQUE

Liste des images importées avec suppression par glissement (swipe). Une ligne par image avec icône, nom de fichier, résolution (« 1920 × 1080 ») et taille de fichier (formatée en Ko/Mo). La résolution provient d'un cache de métadonnées, rempli de manière asynchrone à partir des en-têtes d'image, pour ne pas bloquer l'interface. La suppression se fait via le geste typique de macOS (glissement vers la gauche sur le trackpad sur une ligne) ; la liste ne connaît pas de sélection de ligne, il n'y a donc pas de suppression au clavier ici. Remarque : le chemin de suppression d'image avancé avec un bouton moins explicite, Retour arrière et Cmd-Z pour annuler n'a été ajouté qu'en mode Expert dans le Project Navigator — en mode Débutant, on reste au swipe-delete.

OÙ

Sous la liste d'images, au-dessus du bouton Clear-All.

TECHNIQUE

Trois seuils successifs basés sur le nombre d'images importées (actif uniquement si des images sont présentes et pas de vidéo) : - moins de 3 images : bannière rouge (octogone rouge), texte « At least 3 images are required. Camera alignment cannot be computed from fewer images. » - 3 à 9 images : bannière rouge, texte « With fewer than 10 images, SfM often fails and the trained scene tends to overfit […]. 15–20 images minimum recommended; 30+ for object captures. » - 10 à 19 images : bannière orange (triangle d'avertissement), texte « Workable, but quality usually improves with 20+ images and good coverage around the scene. »

À partir de 20 images, la bannière disparaît. Les seuils sont codés en dur et se basent sur plus de 560 expériences d'entraînement empiriques.

OÙ

Lors du dépôt d'un dossier — pas de bouton visible, mais une logique de détection.

TECHNIQUE

Lors du dépôt d'un répertoire, on vérifie s'il contient l'une des trois dispositions canoniques de workspace : sparse/0/cameras.bin, sparse/cameras.bin ou directement cameras.bin à la racine. Si c'est le cas, l'énumération standard des images est interrompue et une alerte modale s'ouvre à la place, demandant à l'utilisateur si la reconstruction existante doit être utilisée ou si les images doivent être renvoyées via Apple Photogrammetry. Même chemin également pour les workspaces au format texte (cameras.txt) et les exports ETH3D. Voir chapitre 9 Backend Q6 pour les détails. Fonctionne de la même façon en mode Débutant qu'en mode Expert.

OÙ

Arrière-plan plein écran derrière le cercle de progression, masqué en cas d'annulation ou d'erreur.

TECHNIQUE

Animation décorative qui, selon l'avancement du pipeline (0…1), affiche un nombre croissant de petites particules de splats animées. La source est une valeur de progression calculée qui associe les phases SfM à 0–0,2 et l'entraînement à 0,2–1,0 (Frame-Quality à 0–0,05). Ainsi, les splats se « construisent » visiblement pendant que l'entraînement progresse. Purement décoratif — l'affichage ne montre pas de résultats intermédiaires réels de l'entraînement en cours (ce serait la prévisualisation en direct en mode Expert). En cas de Cancel ou d'échec, elle est masquée et seul le cercle de statut reste visible.

OÙ

Au centre de l'écran de traitement, 220 × 220 pixels.

TECHNIQUE

Deux anneaux superposés : à l'extérieur un anneau de piste atténué, à l'intérieur un anneau de progression rempli avec contour d'accent ou rouge (rouge en cas d'erreur). L'anneau suit directement la progression réelle de l'étape en cours (en douceur via une courte animation d'entrée/sortie), afin que l'affichage corresponde à la ligne de progression du mode Expert. À l'intérieur du cercle se trouve une icône d'étape (cerveau pour l'entraînement, caméra pour le SfM, film pour l'extraction d'images vidéo, étincelles pour la vérification de la qualité des images, globe pour le déploiement de matériel 360°), le titre de l'étape et le nombre de progression. Ce nombre est, pendant l'entraînement, le compteur d'itérations (« 12 500/20 000 »), et un pourcentage à toutes les autres étapes. L'icône pulse doucement tant que le traitement est actif. En cas d'erreur, le titre passe à l'étape ayant échoué (« Structure from Motion Failed », « Training Failed »), l'anneau et le nombre passent au rouge. Après une annulation, le cercle affiche à la place une croix orange avec « Cancelled! ».

OÙ

En haut à gauche de l'écran de traitement, 32 × 32 pixels.

TECHNIQUE

Bouton sobre avec arrière-plan matériel. Active ou désactive le panneau d'informations. L'icône passe d'un contour de cercle d'info à un cercle d'info rempli lorsqu'il est actif. Animation d'apparition en douceur. Infobulle « Show detailed processing metrics ».

OÙ

En bas à gauche de l'écran de traitement, visible uniquement lorsque les détails du traitement sont affichés.

TECHNIQUE

Panneau à deux colonnes avec arrière-plan matériel ultra-fin. Colonne de gauche : lignes d'informations spécifiques à l'étape — pour le SfM, texte de statut et pourcentage ; pour l'entraînement, itération, loss combiné, loss L1, loss D-SSIM, nombre de Gaussians (coloré en orange), vitesse (it/s), temps écoulé, ETA calculée, degré SH et taux d'apprentissage. Colonne de droite : texte de statut, chaîne d'informations temporelles, graphique de loss en ligne (voir C-28) et une incitation à la découverte (voir C-32). Toutes les valeurs sont lues depuis l'état d'entraînement, mis à jour à chaque tick d'entraînement.

OÙ

Barre de navigation inférieure, visible uniquement pendant l'étape d'entraînement (PAS pendant le SfM) et tant que le traitement est en cours.

TECHNIQUE

Bouton à bordure. Appelle Pause ou Resume selon le statut. Le libellé passe de « Pause » (avec icône pause) à « Resume » (icône lecture). Pendant l'étape SfM, le bouton n'est pas affiché, car Apple Photogrammetry ne connaît pas de sémantique de pause. L'état de pause conserve intégralement l'itération, le statut des Gaussians et le momentum de l'optimiseur — Resume reprend exactement là où l'entraînement avait été arrêté.

OÙ

Barre de navigation inférieure, visible pendant que le traitement est en cours (SfM ou entraînement).

TECHNIQUE

Bouton à bordure rouge. Ouvre une boîte de dialogue de confirmation avec le titre « Stop and discard progress? », les boutons « Discard Progress » (destructeur) et « Keep Running » (annuler). Sur confirmation, l'indicateur d'annulation est activé, la tâche d'entraînement est terminée, le sous-processus SfM est arrêté si nécessaire, et une ligne de résumé avec le statut d'annulation est écrite dans le journal JSONL. Contrairement à Pause, les tampons d'entraînement et le statut sont abandonnés.

OÙ

Barre de navigation inférieure, visible lorsque le pipeline a échoué (le statut SfM commence par « SfM failed » ou l'entraînement est en état d'erreur).

TECHNIQUE

Bouton d'accentuation. Redémarre l'ensemble du pipeline. Avant le démarrage, on vérifie si des images/vidéos importées sont encore présentes. Les journaux d'erreurs précédents restent conservés dans le répertoire JSONL ; une nouvelle exécution écrit un nouveau fichier journal avec l'horodatage actuel.

OÙ

Dans le panneau d'informations, colonne de droite, visible uniquement pendant l'entraînement avec un historique non vide.

TECHNIQUE

Zone de dessin compacte (40 pixels de haut), trace l'historique du loss sous forme de ligne de 1 pixel dans la couleur d'accent. Les données sont filtrées pour ne garder que les valeurs finies (protection anti-NaN pour les entraînements instables). Le min/max sont calculés sur l'ensemble de l'historique — le graphique zoome donc automatiquement sur la plage de valeurs. La dernière valeur de loss figure en haut à droite au-dessus du graphique. L'historique lui-même est constitué dans l'état de l'application à chaque tick d'entraînement (typiquement toutes les 100 itérations).

OÙ

Dans le panneau d'informations, colonne de droite en bas, visible uniquement pendant l'entraînement ET en mode débutant.

TECHNIQUE

Petite ligne avec icône œil et texte de légende « Switch to Expert Mode (⌘2) for live splat preview », dans une tonalité discrète et une police de 10 points. Aucun élément interactif, simple indication. Ne réagit pas au clic — l'utilisateur doit réellement appuyer sur Cmd+2 ou cliquer sur le menu Mode → Expert Mode.

OÙ

Arrière-plan plein écran de l'étape d'aperçu.

TECHNIQUE

Visionneuse 3D basée sur Metal qui rend le nuage de points terminé. Le moteur de rendu est le rasteriseur ForwardPass PROPRE à RadianceKit — le même qui rend déjà les splats pendant l'entraînement — donc un véritable WYSIWYG (ce qui est entraîné est affiché et exporté exactement tel quel). Pipeline de rendu par tuiles avec transparence indépendante de l'ordre (Order-Independent Transparency). Si le moteur de rendu ne peut pas être initialisé (par ex. parce que Metal n'est pas disponible sur le système), un arrière-plan noir apparaît à la place avec le texte « Metal not available ». La vue ignore la zone de sécurité (Safe Area), si bien que le modèle s'étend jusqu'au bord de la fenêtre.

OÙ

Au-dessus du viewport, en flottant : deux boutons d'icônes en haut à gauche, en dessous en bas à gauche le panneau d'informations.

TECHNIQUE

L'overlay se compose exactement de deux boutons : « Scene Info » affiche et masque le panneau d'informations en bas à gauche, le second bascule le mode caméra entre « Orbit » (rotation autour d'un point cible) et « Fly-Through » (vol libre). Le panneau d'informations affiche la fréquence d'images, le nombre de Gaussians, le mode caméra, l'angle de vue, la résolution de rendu et l'échantillonnage ; pendant un entraînement en cours, une ligne d'état d'entraînement s'ajoute, et après sa fin une ligne de fin. Les chargements de scène échoués ou en cours sont affichés comme une ligne de statut propre, indépendamment du commutateur d'info. La rotation automatique, la réinitialisation de la caméra, la couleur d'arrière-plan et la capture d'écran ne sont pas des boutons d'overlay, mais des entrées du menu « Viewport ».

OÙ

Barre de navigation inférieure dans Z3.

TECHNIQUE

Bouton d'accentuation avec le libellé « Export » et une icône de partage. Un clic déclenche le passage à Z4. Auparavant, la vue parente vérifie si la version complète est déverrouillée — sinon, c'est la vue de verrouillage qui s'affiche à la place de l'étape d'export (voir U-06).

OÙ

Page principale gauche de l'étape d'export.

TECHNIQUE

Grille de cartes à deux colonnes flexibles avec un espacement de 12 points. Itère sur les formats proposés en mode Débutant — un sous-ensemble filtré de la liste complète des formats, ne contenant que les 6 formats les plus importants : PLY, SPZ, glTF, .splat, vidéo Orbit, visionneuse Web. Les autres formats ne sont proposés qu'en mode Expert.

OÙ

Chaque carte de la grille.

TECHNIQUE

Bouton sobre au format carte : icône (p. ex. document à fermeture éclair pour PLY, boîte d'archive pour SPZ, icône vidéo pour Orbit Video) en haut, nom du format en titre, légende descriptive (tronquée sur 2 lignes), en dessous la taille de fichier estimée (calculée en direct à partir du format, du nombre de gaussiennes et du degré SH, formatée en Ko/Mo). Un clic sélectionne le format. La carte sélectionnée reçoit un fond d'accentuation, une bordure d'accentuation et une icône de coche en haut à droite. L'info-bulle affiche la description du format.

OÙ

Sous la grille de formats, visible uniquement lorsqu'un format vidéo est choisi (vidéo Orbit ou vidéo pour réseaux sociaux).

TECHNIQUE

Curseur de 3 à 30 secondes par pas de 1 seconde, lié à la durée vidéo dans l'état de l'app. Largeur maximale 300 pixels. N'est affiché que si un format vidéo est sélectionné. Pour les formats non vidéo, le curseur est complètement retiré de la vue — pas d'espace mort.

OÙ

Sous la grille de formats (et sous le curseur de durée, si une vidéo est choisie).

TECHNIQUE

Grand bouton d'accentuation. Libellé : « Export {nom du format} », icône de partage. Un clic ouvre la boîte de dialogue d'enregistrement macOS avec l'extension de fichier correspondant au format. Le nom de fichier proposé provient du nom de la scène actuelle ; si aucun n'est défini (par exemple parce que la scène n'a jamais été enregistrée), il s'appelle « scene ». À la confirmation, l'export est écrit à l'emplacement choisi. Désactivé si aucun résultat d'entraînement n'est disponible ou si un export est déjà en cours. Sous le bouton figure l'indicateur du résultat (« 2 991 Gaussians • SH degree 3 »).

OÙ

Sous le bouton Export, visible uniquement pendant qu'un export est en cours.

TECHNIQUE

Indicateur de progression avec largeur maximale de 300 pixels, avec en dessous la légende « Exporting… N % ». La valeur va de 0 à 1 et est mise à jour pendant l'écriture — pour PLY par blocs de 10 000 gaussiennes, pour SPZ une seule fois après la quantification, pour la vidéo Orbit par intervalles d'images.

OÙ

Sous la barre de progression, visible uniquement si le dernier export a rencontré une erreur.

TECHNIQUE

Ligne rouge avec triangle d'avertissement et le texte « Export failed: … » accompagné de la description de l'erreur. Fond rouge avec 8 % d'opacité, coins arrondis. Largeur maximale 400 pixels. Causes d'erreur fréquentes : erreur d'écriture en cas de disque plein ; erreur de sandbox pour des emplacements d'enregistrement hors de la zone autorisée.

OÙ

Côté droit de l'étape d'export.

TECHNIQUE

Liste de l'historique des exports (enregistrée durablement dans les réglages de l'app, mise à jour après chaque export réussi). Chaque ligne affiche un badge de format (petit, en couleur d'accentuation), un horodatage (HH:mm), un nom de fichier (tronqué sur 1 ligne) et la taille de fichier formatée. Un clic sur une ligne ouvre le Finder avec le fichier sélectionné. État vide : « No exports yet ».

OÙ

Clic droit sur une ligne de l'historique.

TECHNIQUE

Menu contextuel sur chaque entrée de la liste avec deux actions : « Reveal in Finder » (ouvre le Finder avec le fichier sélectionné, comme un simple clic) et « Copy Path » (copie le chemin de fichier complet en tant que texte dans le presse-papiers). Cette dernière action est utile pour un glisser-déposer vers d'autres apps ou pour le transmettre à la ligne de commande.