designsystem/com.midnight.kuira.core.designsystem.effect/StarField

StarField

@Composable
fun StarField(modifier: Modifier = Modifier, color: Color = Color.White, alpha: Float = 1.0f, starCount: Int = 25, drift: Float = 1.0f, meteors: Boolean = true)

Ambient depth-parallax star field. Each star has a depth z (0 = far, 1 = near); the whole field drifts slowly with per-star speed ∝ z (nearer stars sweep faster — the parallax cue that reads as gliding through 3-D space), wrapping toroidally for an endless field. Realism without hue (brand monochrome): power-law size/brightness, soft glow halos, a diffraction cross on the brightest few, organic two-octave scintillation, and a rare shooting star. Honors the system "remove animations" setting (freezes to a static sky).

Parameters

color

star color (its alpha is ignored — alpha caps brightness). White (dark) / Black (light).

alpha

max brightness. ~1f dark; ~0.25–0.45f keeps it a subtle texture under content.

drift

parallax speed multiplier; 0f = a still field.

meteors

draw the occasional faint shooting star.