Que fait Empilement de sprites ?
Un objet est une bande horizontale de tranches plates vues de dessus, la tranche de sol à gauche, le toit à droite. Dessinez-les de bas en haut, chacune pivotée du même angle, compressée verticalement pour l'inclinaison de la caméra, et soulevée de 1 px par tranche. Une petite feuille donne chaque angle en pixels nets.
Ne mettez jamais en production un empilement que vous n'avez pas rendu et observé. Les chemins ci-dessous sont relatifs au dossier de cette compétence.
0. Choisir le chemin
Qu'avez-vous ?
├── Bande de tranches PNG ou export de couches MagicaVoxel ──▶ Étape 3 (Rendu)
├── Feuille 4 vues (dessus, côté, devant, derrière) ────────▶ Étape 1 porte ─▶ Étape 2 (Découpage)
└── Une consigne ou une idée ──────────────────────────────────▶ Étape 1 ─▶ Étape 2 ─▶ Étape 3
Dans un projet existant, lisez d'abord le moteur de rendu : moteur, échelle de pixels, comment les sprites sont dessinés et triés, quels objets tournent. Adaptez l'empilement à ce moteur de rendu. N'ajoutez jamais un deuxième canvas ou pipeline de rendu.
1. Obtenir une feuille 4 vues
La feuille : une rangée 1x4 dans l'ordre DESSUS, CÔTÉ, DEVANT, DERRIÈRE, sur fond blanc uni, avec des espaces nets entre les vues. DESSUS regarde droit vers le bas, l'avant pointant vers le bas. CÔTÉ a l'avant pointant vers la gauche. Même échelle dans les quatre.
Choisissez un niveau :
- Rétro épais : 15-20 tranches, environ 25×48 px. Silhouettes audacieuses, rayures de 3-4 px, affichées à 8-10x.
- Hi-bit détaillé : 26-44 tranches, 36×72 à 46×107 px. Contient des évents, logos, jantes à rayons, reflets de verre, ailerons surélevés.
- Vitrine / Vidéo 1080p : 36-56 tranches, 30×30 à 148×148 px, affichées à une échelle entière de 4-6x. Évite les marches de silhouette épaisses et les oscillations de rotation lorsque de petits sprites sont agrandis à 7-9x sur une vidéo HD. Micro-détails architecturaux qui se lisent proprement à 360° (volets, bacs à fleurs, balustrades de balcon, mousse de toit, nénuphars, lampadaires, vrilles de falaise, cascades) élèvent les dioramas sans briser la discipline de la palette.
Prenez ensuite la première source qui s'applique.
a. Vous avez un outil de génération d'images. Utilisez cette consigne. Remplacez le sujet, gardez le reste textuellement :
Feuille de modèle orthographique pixel art épais de [SUJET] avec un ombrage pixel riche à 3 tons décalés en teinte (ombres profondes à dominante froide, tons moyens saturés, reflets chauds et lumineux le long des arêtes et des bords), rayures/accents 3-4 px audacieux, et pixels spéculaires nets sur le verre. Quatre vues dans une rangée horizontale 1x4 (ou grille 2x2) propre sur fond blanc uni ou gris pâle complètement plat :
1. Vue de DESSUS regardant droit vers le bas, l'avant pointant VERS LE BAS.
2. Vue de CÔTÉ, l'avant pointant VERS LA GAUCHE.
3. Vue de DEVANT.
4. Vue de DERRIÈRE.
Strictement orthographique : zéro perspective, zéro inclinaison, zéro angle 3/4. Échelle identique dans les quatre vues afin que la longueur, la largeur et la hauteur correspondent pixel pour pixel. Contour foncé de 1 px audacieux autour de chaque vue, amas de couleurs unies solides, ombrage de panneaux interne net, zéro anti-crénelage, zéro bords doux, zéro ombres au sol, zéro lignes de grille, zéro texte, espace vide généreux entre les vues.
b. L'utilisateur a une feuille. Utilisez-la.
c. Ni l'un ni l'autre. Dessinez vous-même les quatre vues comme pixel art dans un court script Python/PIL à la résolution native, un pixel par pixel d'art (tableaux numpy ou ImageDraw). Donnez à chaque vue un contour foncé de 1 px, gardez la longueur, la largeur et la hauteur identiques entre les vues, agrandissez 8x avec Image.NEAREST, et collez-les en une rangée sur fond blanc avec au moins 40 px entre les vues. Découpez-la avec --slices défini sur la hauteur native de la vue CÔTÉ y compris son contour, afin que les tranches retombent sur vos pixels.
Le découpeur ne conserve un voxel que là où chaque vue le couvre, donc pour (c) :
-
Les objets ronds (pots, auvents, dômes, roues vues de dessus) ont besoin d'un cercle de pixels dans la vue DESSUS. Un carré DESSUS découpe une boîte. Si une partie ronde est plus étroite que la partie la plus large (une tour sur une base large, un ballon au-dessus de son panier), découpez aussi avec
--round, sinon elle sort carrée. -
Les ailerons, feuilles, ailes et tout plan irrégulier ont besoin de leur contour réel dans la vue DESSUS, sinon ils se découpent en blocs.
-
Les silhouettes CÔTÉ et DEVANT définissent le profil : un rectangle fait un cylindre, donc arrondissez-les pour une balle.
-
Les détails de mur (fenêtres, portes, lignes de panneaux) vont dans CÔTÉ, DEVANT et DERRIÈRE. Les détails de toit vont dans DESSUS.
-
Tout ce qui dépasse d'un mur (bac à fleurs, porche, panneau) découpe une corniche le long de tout ce mur. Peignez les petites protubérances à plat, et donnez à une cheminée une bande plate de crête sur laquelle se tenir.
-
Ombrez avec une rampe de 3-4 tons décalés en teinte : ombre profonde froide, moyen saturé, reflet chaud. Pas de dégradés, pas d'anti-crénelage.
-
Centrez l'objet : l'empilement tourne autour du milieu de sa boîte englobante, donc une base qui s'étend plus loin d'un côté le fait orbiter hors axe.
Porte : regardez la feuille avant de découper
- Orientation : DESSUS avant pointe vers le bas. CÔTÉ avant pointe vers la gauche (si c'est la droite, passez
--side-nose right). - Proportions : Longueur DESSUS = Longueur CÔTÉ, Largeur DESSUS = Largeur DEVANT/DERRIÈRE, Hauteur CÔTÉ = Hauteur DEVANT/DERRIÈRE.
- Bords durs : remplissages plats, contours nets. Les bords doux airbrush ou les fines lignes internes de 1 px se brouillent une fois les tranches pivotées. Régénérez ou redessinez plutôt que de récupérer.
- Trous : les surplombs qui montrent le jour dans la vue CÔTÉ (un aileron arrière surélevé) survivent. Les cavités cachées des quatre silhouettes (lits de camion, arcs creux) se remplissent. Corrigez ces tranches à la main après le découpage.
- Leçons : parcourez le tableau des Leçons à la fin de ce fichier.
2. Découper et inspecter
scripts/views_to_slices.py nécessite Python 3 avec Pillow et NumPy. Il supprime l'arrière-plan (transparent ou plat), supprime les contours de 1 px des vues, quantifie en une palette partagée, découpe les tranches et écrit une feuille de vérification et une visionneuse autonome.
python3 scripts/views_to_slices.py views.png slices.png \
--slices 36 --shade 0.2 --preview check.png --html viewer.html
| Drapeau | Défaut | Quand le changer |
|---|---|---|
--slices N | auto (36 si la vue CÔTÉ est plus haute que 64 px, sinon native) | 15-20 épais, 32-48 hi-bit, hauteur native pour les feuilles dessinées, 0 garde les pixels bruts de la feuille |
--order | auto | auto choisit DESSUS et CÔTÉ en faisant correspondre les proportions (Longueur DESSUS = Longueur CÔTÉ, Largeur DESSUS = Largeur DEVANT, Hauteur CÔTÉ = Hauteur DEVANT) ; l'ordre de lecture gagne les égalités. reading force DESSUS, CÔTÉ, DEVANT, DERRIÈRE |
--round | désactivé | Tours, ballons, pots, bouteilles : coupe chaque tranche à l'ellipse que ses étendues CÔTÉ et DEVANT décrivent. Laissez désactivé pour les ailerons, ailes et boîtes |
--side-nose | left | right si la vue CÔTÉ fait face à droite |
--top-nose | auto | Auto lit les cabines de voiture. Passez down pour tout ce qui n'est pas un véhicule, et up ou down si cela retourne une voiture |
--shade | 0.2 | 0.12-0.15 pour les vues richement ombrées, 0.25 pour les plates, 0 pour aucune |
--colours | 24 | 32-48 pour les livrées détaillées, 0 pour garder toutes les couleurs |
--bg-tol | 28 | Augmentez un peu si le bruit JPEG laisse une frange |
--dark-thresh | 70 | 0 pour conserver les contours sur les silhouettes très sombres |
--normals | (aucun) | Enregistre une bande PNG de carte de normales 3D correspondante |
--emissive | (aucun) | Enregistre une bande PNG de masque émissif auto-détecté |
Ouvrez check.png et regardez-le juste après le découpage : les quatre vues extraites, quatre angles de table tournante et la vue éclatée. Faites cela avant d'écrire du code d'intégration. viewer.html s'ouvre dans un navigateur avec les modes Table tournante, Scène (Diorama vivant : Rue Néon / Île Prairie avec accessoires empilés procéduraux + dépôts multi-PNG d'accessoires), Scan de tranche, Éclaté, et Jouer (Conduire à travers des mondes infinis Rue/Prairie/Grille, Vent, Briser), Heure du jour en direct (Jour → Coucher de soleil → Nuit avec lueur émissive automatique et ombres 3D projetées), Météo (Pluie avec reflets mouillés ondulés et ondulations, Neige avec accumulation de calotte neigeuse normZ), et exportation PNG 16 directions.
3. Rendu : la boucle et ses nombres
Chaque moteur de rendu exécute la même boucle, de bas en haut :
// sheet : bande horizontale de `count` tranches, chacune w × h, tranche de sol à z = 0
// pos : centre de contact au sol, arrondi aux pixels entiers
for (let z = 0; z < count; z++) {
// 1. faire pivoter la tranche autour de son centre (-floor(w/2), -floor(h/2)) de `turn`
// 2. mettre à l'échelle y par `squash` (inclinaison de la caméra)
// 3. soulever de -round(z * spacing)
// 4. translater vers `pos` en pixels entiers, dessiner avec un filtrage au plus proche
}
Ne devinez pas ceux-ci :
spacing = 1.0px écran à l'échelle du pixel d'art.squash = 0.75pour une caméra inclinée vers le bas. 1.0 regarde droit vers le bas ; en dessous de 0.6, les toits s'aplatissent en lamelles. Pour une caméra inclinable,squash = sin(élévation),spacing = cos(élévation).- Centres de rotation symétriques. Dans les rastériseurs logiciels/tampons de pixels, échantillonnez autour de
(w - 1) * 0.5, (h - 1) * 0.5avec un échantillonnage au plus procheMath.round(...). UtiliserMath.floor(... + w / 2)sur des tranches de taille paire décale le centre de 0.5 px d'art et crée une oscillation de rotation visible aux tours de 90°/180°/270°. - Placement fluide à 60 ips. Gardez le mouvement continu (bobinage, flottement, orbite, projection parent-enfant) en pixels écran en virgule flottante et n'arrondissez qu'une seule fois au blit final de 1 pixel écran (
Math.round(dx), Math.round(dy)) avec unscaled'affichage entier. Ne quantifiez jamais le mouvement en pas de pixels d'art (Math.round(...) * scale) ni n'arrondissez les projections enfants indépendamment — les deux provoquent des sauts multi-pixels brusques et des secousses accessoire-sol. - Validez les comptes de bandes au moment du chargement. Affirmez
sheet.width % count === 0(et les dimensions de tranche attendues) lors du découpage d'une bande afin que la mise à niveau du nombre de tranches d'une bande ne découpe jamais silencieusement au milieu d'une image. - Filtrage au plus proche voisin.
imageSmoothingEnabled = falseetimage-rendering: pixelatedsur le web, filtre Nearest/Point dans les moteurs. - Ombre au sol : pour les véhicules, l'empreinte de l'union à z = 0, décalée de +2, +3 px d'art, dessinée avant la tranche 0. Pour les grands accessoires, projetez les tranches empilées le long du vecteur solaire par couche, avec des bords tramés Bayer 4×4, pas un ovale générique.
- Contournez l'empilement fini une fois, jamais par tranche. Les contours par tranche dessinent des coutures et des taches à travers le corps. Rendez dans un tampon de 1x px d'art, tracez un contour de 1 px autour de son alpha, puis agrandissez.
- Cap : le devant de la feuille pointe vers le bas (+y), donc
turn = atan2(vy, vx) - PI / 2. Pour tout ce qui inverse, pilotezturnà partir d'un cap stocké, pas de la vitesse brute. - Triez-Y les empilements entiers par point au sol. N'intercalez jamais les tranches de deux objets.
- Cuisez les empilements statiques en sprites simples au moment du chargement. 200 arbres × 30 tranches = 6 000 dessins par image.
- Animez les entrées avec des tranches, pas des fondus d'opacité. Fondre un empilement dans les airs semble plat ; faites croître les accessoires au sol de bas en haut via des
liftspar tranche (éclosion de tranche avec un léger ressort et un anneau au sol), et faites glisser les empilements aériens/flottants (nuages, bateaux) le long de leur arc de déplacement. Étendez la frantère de révélationliftsau-delà decountpar la largeur de mélange par tranche (mix(start, count + width, ...)) afin que les tranches supérieures atteignentspacingcomplet avant de repasserliftsànull— sinon les tranches supérieures se figent en une seule image. Ne floutez jamais les empilements nets avec des coupes dedefocusen vidéo — utilisez plutôt des mouvements de caméra continus. - Basculement organique, inclinaison de tangage 3D et ondulation du corps via des décalages par tranche. Pour les accessoires flexibles ancrés (varech, herbe, bannières), décalez chaque tranche horizontalement par
sin(t * freq - z * wave + phase) * amp * (z / (count - 1))²afin quez = 0reste fixe tandis que les pointes se balancent en douceur. Pour les créatures bondissantes (dauphins cabrant le nez vers le haut à la sortie → niveau à l'apex → nez vers le bas à la rentrée) ou les navires roulant, appliquez des décalages d'inclinaison longitudinale/latérale par tranche(xOffsets, yOffsets)proportionnels à(z - centerZ) * sin(pitchAngle)le long de l'axe du corps afin que le tangage et le roulis soient lus comme une véritable inclinaison 3D plutôt qu'un soulèvement vertical plat. - Vérifiez l'axe du nez natif et atténuez en profondeur les empilements submergés. Confirmez si le nez de chaque bande fait face à
+x,+you-yavant de lierturn = atan2(vy, vx)afin que les navires et les créatures se déplacent nez en premier. Pour les empilements submergés sous l'eau (accessoires de fond marin, manta profonde, phase de dauphin submergée), appliquez une teinte de profondeur Beer-Lambert (désaturation des rouges vers la teinte de l'eau) et adoucissez ou omettez le contour extérieur dur ; pilotez le tangage, le roulis et le pompage des empilements flottants à partir d'une réponse masse-ressort amortie au champ de vagues partagé (pas la hauteur de vague instantanée).
Ouvrez references/engines.md lors de la connexion au Canvas Web, React, Godot, Unity ou Phaser. scripts/viewer.html est la référence web complète : tampon, contour, orbite, scan, éclaté, export.
4. Fini quand
- Droit vers le bas : à
squash = 1,turn = 0, le rendu a une tranche de large etsliceHeight + count - 1px de haut. - Inclinaison et 90° : 0.75 est visiblement plus court que 1.0 ; à 90°, la largeur égale
sliceHeight. - Espacement : 0 dessine à plat (dessus seulement), 2.5 sépare chaque couche proprement.
- Diagonales propres : pas de rayures horizontales ni de taches sombres à l'intérieur du corps à 45°.
- Cap : conduire un cercle maintient l'avant sur le chemin ; la marche arrière maintient le cap.
- Virages lents : si les petits sprites semblent saccadés, augmentez d'abord l'échelle d'affichage entière. Essayez RotSprite seulement si les longues arêtes droites rampent encore, et comparez à l'œil : il arrondit les tout petits sprites.
- Tour complet : regardez chaque angle, pas quatre. Une partie qui apparaît et disparaît est une ligne de Leçons.
Leçons
Lorsqu'un empilement est erroné, corrigez-le, puis corrigez la cause pour qu'elle ne puisse pas se reproduire : modifiez le découpeur pour que l'erreur ne puisse pas se produire, ou faites-le avertir avec la correction dans le message, et ajoutez un cas à tests/check.py construit à partir de l'erreur réelle qui échoue avant la modification. Seuls les jugements que le code ne peut pas voir deviennent une règle. Ajoutez une ligne ici ; supprimez-la une fois que le code rend l'erreur impossible.
| Date | Erreur | Règle | Appliquée par |
|---|---|---|---|
| 2026-11-20 | Les poteaux de 1 px, cordes et antennes clignotent et disparaissent lorsque l'empilement tourne | Dessinez les parties fines d'au moins 2 px de large | Avertissement du découpeur (thin_runs), cas de test 5 |
| 2026-11-20 | Une partie ronde plus étroite que sa base (tour, ballon, pot) se découpe carrée | Découpez avec --round ; il garde les rangées espacées comme les poteaux carrés | --round, cas de test 4 |
| 2026-11-20 | --top-nose automatique retourne tout ce qui n'est pas un véhicule | Passez --top-nose down | Règle |
| 2026-11-20 | Quelque chose qui dépasse d'un mur découpe une corniche sur tout le mur | Peignez les petites protubérances à plat ; donnez à … |
…
[abrégé pour la traduction]