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.
Vue d’ensemble
Section intitulée « Vue d’ensemble »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"]
Pourquoi three.js
Section intitulée « Pourquoi three.js »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.
Artefacts
Section intitulée « Artefacts »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| Artefact | Devient | Remarques |
|---|---|---|
poster.png | l’échelle de rasters col / preview / screen / hires (les paliers par défaut), plus iso/source.png | La miniature que vous voyez dans la grille. |
turntable/frame_NNNN.png | Variantes par frame (turntable/0000.png …) | 36 frames par défaut, une tous les 10°. |
| Sprite sheet | sprites.jpg + repères WebVTT sprites.vtt | Grille 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.png | Vues de référence | Ne 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.
Formats pris en charge
Section intitulée « Formats pris en charge »Rendus directement par le worker :
| Extension | Chargeur |
|---|---|
glb, gltf | GLTFLoader |
fbx | FBXLoader |
obj | OBJLoader |
stl | STLLoader |
ply | PLYLoader |
dae | ColladaLoader |
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.
Fichiers compagnons
Section intitulée « Fichiers compagnons »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.
Paramètres
Section intitulée « Paramètres »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.
| Option | Valeur par défaut | Remarques |
|---|---|---|
--input | obligatoire | Chemin du modèle source. |
--workdir | le répertoire du modèle | Doit contenir le modèle et ses compagnons. |
--output | obligatoire | Répertoire racine des artefacts ci-dessus. |
--frames | 36 | Nombre 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. |
--res | 512 | Résolution carrée du rendu des frames et des vues. |
--poster-res | 2048 | Ré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.
Voir aussi
Section intitulée « Voir aussi »- ADR 0069 : la décision d’abandonner Blender.
- Architecture : où se place le worker de prévisualisation.