Aller au contenu

Pipeline de prévisualisation 3D

Artist Alley génère plusieurs artefacts de prévisualisation par asset 3D, afin que le viewer ait immédiatement quelque chose à afficher et que le flux de navigation puisse faire défiler un turntable au survol. Le rendu s’exécute à l’intérieur du conteneur de l’application : la tâche de prévisualisation Go lance un worker Node qui pilote un Chromium sans interface graphique ; il n’y a donc aucun conteneur de rendu distinct à déployer.

Le moteur de rendu est un Chromium sans interface graphique avec WebGL logiciel, piloté par scripts/threejs/worker.mjs et orchestré par le ModelHandler Go dans app/internal/preview/model.go. Aucun GPU n’est nécessaire.

flowchart LR
  upload["Asset 3D envoyé"] --> probe["preview.3d : préparation du modèle + compagnons"]
  probe --> render["worker.mjs<br/>three.js sans interface"]
  render --> poster[poster.png]
  render --> frames["turntable/frame_0000..NNNN.png"]
  render --> views["views/top.png<br/>views/bottom.png"]
  poster --> col["Miniatures col / preview / screen / hires"]
  frames --> sheet["Sprite sheet 6×6 + repères WebVTT"]
  sheet --> hover["Défilement au survol dans le flux de navigation"]

Le pipeline reposait auparavant sur un conteneur Blender sans interface graphique. Il a été remplacé dans la v0.6.0, Blender étant conservé comme solution de repli, puis retiré complètement de l’image dans la v0.7.0, ce qui a réduit de moitié la taille de l’image du serveur, de 3,64 Go à 1,82 Go.

Lors de l’évaluation à l’origine de ce changement (#497), le remplaçant s’est montré environ 18 à 24 fois plus rapide que le moteur de rendu Cycles de Blender. Il n’a pas besoin de GPU et fonctionne sur arm64 ; le chemin Blender n’existait que pour amd64, si bien que les déploiements arm64 n’avaient aucune prévisualisation 3D avant la v0.6.0.

Il charge aussi les modèles avec le même code que le viewer interactif : la page du worker importe le module de chargement propre au viewer (web/src/lib/3d/modelLoader.js) et ses valeurs d’éclairage par défaut. C’est la propriété la plus importante : le rendu hors ligne et la vue dans le navigateur sont censés concorder.

Jusqu’à la v0.8.0, le moteur de rendu avait sa propre copie du chemin de chargement, et les deux ont divergé : les modèles OBJ et les fichiers glTF non éclairés étaient rendus sans texture ou à plat dans les miniatures, alors que le viewer les affichait correctement (#689). Le partage du module a supprimé cette source de divergence.

Le worker écrit une arborescence fixe sur le disque, que le côté Go répartit ensuite en variantes stockées :

<output>/poster.png
<output>/turntable/frame_0000.png … frame_{N-1}.png
<output>/views/top.png
<output>/views/bottom.png
ArtefactDevientRemarques
poster.pngl’échelle de rasters col / preview / screen / hires (les paliers par défaut), plus iso/source.pngLa miniature que vous voyez dans la grille.
turntable/frame_NNNN.pngVariantes par frame (turntable/0000.png …)36 frames par défaut, une tous les 10°.
Sprite sheetsprites.jpg + repères WebVTT sprites.vttGrille de 6×6 cellules de 240px, soit une planche de 1440×1440. Même mécanisme que pour les sprites vidéo : le flux de navigation fait défiler un turntable comme il fait défiler une vidéo.
views/top.png, views/bottom.pngVues de référenceNe font pas partie du défilement.

Avant le rendu, la tâche vérifie dans le stockage la présence d’un marqueur pour chaque groupe : col, sprites.jpg, turntable/0000.png, views/top.png et iso/source.png. Si les cinq existent, elle se termine sans rendre. Sinon, le worker refait le rendu complet dans un nouveau répertoire temporaire, supprimé à la fin de la tâche.

Lors d’une remise en file d’attente ordinaire, les envois sont eux aussi conditionnés par ces marqueurs de groupe. Une frame 0 existante fait ignorer toutes les frames ; une vue top existante fait ignorer les deux vues de référence. Les vérifications frame par frame et vue par vue ne s’exécutent que lorsque le marqueur de leur groupe est absent. Un sprites.jpg existant fait ignorer à la fois la planche et sprites.vtt ; si le JPEG est absent, les deux sont écrits, même si le VTT existe déjà. Des fichiers manquants peuvent donc le rester tant que leur marqueur représentatif existe. Un nouveau rendu forcé les remplace tous.

Rendus directement par le worker :

ExtensionChargeur
glb, gltfGLTFLoader
fbxFBXLoader
objOBJLoader
stlSTLLoader
plyPLYLoader
daeColladaLoader

glb / gltf / fbx / obj sont aussi les formats que charge le viewer interactif. stl / ply / dae ne sont que rendus.

Convertis d’abord, puis rendus : md2, md3, mdl, ms3d, mview sont décodés par des importeurs en Go pur qui produisent un .glb, lequel suit ensuite le chemin normal décrit plus haut. Parmi eux, seul mview s’ouvre dans le viewer interactif, via le lecteur propre à Marmoset.

Actuellement non rendus : blend, 3ds, x3d, wrl, usd / usda / usdc / usdz, abc. Le worker n’a pas de chargeur pour ces formats. Ils sont envoyés, téléchargés et servis normalement, mais n’ont aucune prévisualisation générée. Un convertisseur qui ajouterait des prévisualisations pour certains d’entre eux est prévu comme module complémentaire facultatif (#499) ; il n’est pas encore disponible.

La liste des extensions du module de chargement partagé (LOADABLE_EXTS dans modelLoader.js) fait référence ; le côté Go en tient sa propre copie, maintenue à la main. Un test de fumée (scripts/threejs/smoke.mjs) s’exécute dans l’image construite et rend des fixtures générées couvrant chaque format de cette liste. Il vérifie que les sorties existent, que le poster n’est pas vide, que les matériaux ont été normalisés et, pour les fixtures texturées, que les textures ont été décodées et que le poster contient des couleurs saturées. La CI l’exécute sur l’image de production pour les changements qui touchent la chaîne de rendu. Il ne compare pas la copie Go à la liste.

Les assets 3D sont souvent accompagnés de fichiers voisins : un .mtl à côté d’un .obj, un .bin à côté d’un .gltf, des textures envoyées séparément. Le gestionnaire Go place le modèle et ses compagnons dans le même répertoire de travail avant le rendu, de sorte que les chargeurs les trouvent sans aucune configuration de la part de l’opérateur.

Ce sont les options du worker. Le gestionnaire Go les passe toutes les six, avec les mêmes valeurs que les valeurs par défaut ci-dessous ; ce ne sont pas des paramètres d’opérateur.

OptionValeur par défautRemarques
--inputobligatoireChemin du modèle source.
--workdirle répertoire du modèleDoit contenir le modèle et ses compagnons.
--outputobligatoireRépertoire racine des artefacts ci-dessus.
--frames36Nombre de frames du turntable. 36 remplit exactement la grille 6×6 de la sprite sheet ; avec moins, des cellules restent vides, et les frames au-delà de 36 sont laissées hors de la planche.
--res512Résolution carrée du rendu des frames et des vues.
--poster-res2048Résolution du poster.

Le nombre de rendus simultanés est fixé par la file de tâches, et non par ces options : c’est le paramètre système jobs.type_concurrency.preview.3d, qui vaut 2 par défaut.

  • ADR 0069 : la décision d’abandonner Blender.
  • Architecture : où se place le worker de prévisualisation.