Aspect visuel

config.radius désigne la silhouette totale de la planète (sol + atmo). atmosphereThickness ∈ [0, 1] est la fraction radiale occupée par l'atmosphère, comptée depuis l'extérieur : le sol s'étend de 0 à radius × (1 - atmosphereThickness), l'atmo de là jusqu'à radius. Avec atmosphereThickness = 0, le sol prend toute la silhouette ; avec 0.6, l'atmo occupe 60 % du rayon et le sol les 40 % intérieurs.

Plus l'épaisseur monte, plus le shader adoucit le relief, ajoute la diffusion Rayleigh et étend le halo derrière le terminateur.

Pour la version jouable (bandes hex atmo cliquables), voir Atmosphère jouable.

Comment ça marche

const body = useBody({
  // ...
  atmosphereThickness: 0.6, // 0 = aucune, 1 = très épaisse
}, DEFAULT_TILE_SIZE)

L'épaisseur est résolue au build : changer la valeur en runtime nécessite de reconstruire le corps (la démo Three.js ci-dessus le fait via un dispose() puis useBody()). Pour une animation atmo (jour/nuit, météo), passez plutôt par un shader override sur les uniforms standards (uAtmoDensity, uAtmoColor).

Couleur du halo

La lib est agnostique du climat — elle ne dérive jamais une couleur d'atmosphère depuis une température. Quand aucun override n'est fourni, le halo prend une teinte neutre (bleu pâle universel). Pour un look climatique, le caller calcule la couleur côté jeu et la pousse via :

import { buildAtmoShell } from '@cedric-pouilleux/stellexjs/core'

const shell = buildAtmoShell({
  config,
  radius:  config.radius,
  opacity: 0.6,
  tint:    deriveAtmoTint(localClimateModel),  // votre helper caller
  tiles:   sim.tiles,
  params:  { /* … */ },
})

Le playground fournit une implémentation de référence (deriveTemperatureAnchors dans playground/src/lib/temperaturePalette.ts) qui mappe une plage de température sur des couleurs.

Paramètres clés

Prop	Plage	Effet
radius	unités monde	Rayon de la silhouette totale (sol + atmo)
atmosphereThickness	0–1	Fraction radiale de radius occupée par l'atmo (sol = radius × (1 - thickness))
atmosphereOpacity	0–1	Opacité du halo en mode shader
bandColors	4 stops	Palette 4 couleurs (géantes gazeuses)
tint (option de buildAtmoShell)	hex string	Couleur résolue caller-side du halo