# Aannames — Meteors Waar de specificatie ruimte liet, staat hier hoe we het hebben ingevuld. Als iets onduidelijk was, volgden we de geest van Meteos en (voor de selectie-tween) Tim's bestaande KWin-effecten. ## Fase 1 — physics-fixes (t1098u, t1100u, t1101u) ### 1. Vallende blokken landen op vliegende clusters Een gespawnd (vallend) blok ging soms door een vliegende cluster heen, omdat de val alleen keek naar stilliggende/settling/locked blokken. Aanname: het vallende blok botst alleen in dezelfde kolom. Het landt op het hoogste vliegende clustermlid onder hem, wordt vracht van die cluster (`state = flying`, zelfde `clusterId` en `vy`, geen vlam) en vliegt mee, inclusief omhoog als de cluster nog stijgt. Nieuwe vracht zit precies 1 tegel boven het hoogste clustermlid in die kolom. Omgekeerd, als een stijgende cluster een vallend blok inrijdt, geldt hetzelfde. Een cluster die al geland is (rigid settling) telt als vaste ondergrond: daar landt een vallend blok gewoon op, het wordt geen vracht. ### 2. Grijze clusters landen als starre groep Voorheen werd elke kolom bij landing platgedrukt op de stapel, waardoor gaten verdwenen. Aanname: zodra één lid de vloer of een stil blok raakt, stopt de hele cluster als star lichaam. De relatieve posities blijven; een deel kan dus boven een gat blijven hangen. Gekleurde vracht (meegedragen blokken) blijft tot het einde van de settle-tijd van 3 s bij de groep — ze verkleuren niet opnieuw, maar vallen ook niet eerder. Na de conversie van de grijze blokken naar willekeurige kleuren laat de hele groep los. Blokken mét steun blijven liggen; blokken zónder steun vallen afzonderlijk, vanuit rust, met dezelfde zwaartekracht als een gewone val (eerst versnellen tot `fallSpeed`, zie punt 3). Gestapelde hangende blokken vallen als stapel (ze blijven op elkaar rusten, zonder te overlappen). ### 3. Vloeiende snelheidsovergang op de apex Voorheen sprong `vy` op de apex in één frame naar `-fallSpeed`. Aanname: vanaf de apex (vy = 0) versnelt de cluster (en een handmatige sprong) met constante `fallAccel` totdat `fallSpeed` is bereikt; daarna constante daalsnelheid. `apexEaseTime = 0.15 * fallTime` en `fallAccel = fallSpeed / apexEaseTime`. Lage luchtweerstand (kleine `fallTime`) geeft dus een kortere, snellere overgang. Voor Terra (`fallTime = 3`) is dat 0,45 s. Hetzelfde geldt voor hangende blokken die na conversie uit rust gaan vallen. Blokken die van boven het veld binnenkomen (spawn) starten al op `fallSpeed` — die vallen al een tijdje. ### 4. Bounce bij landing (planeetparameter) Aanname: de bounce is visueel (squash van de sprite, plus een heel klein optisch terugveren in Y) en verandert de simulatiefysica niet. Elk blok dat op de vloer of op een ander blok landt, krijgt een bounce; hangende leden van een starre groep die niets raken, niet. Snelheid hangt af van de luchtweerstand van het veld, via `fallTime` (1 = weinig lucht, 5 = veel lucht): - `bounceDuration = 0.12 * fallTime` (Terra: 0,36 s; bij `fallTime = 1` twee keer zo snel als bij `fallTime = 2`, enz.) - `bounceSquash = 0.16` (subtiele verticale squash naar 84%, met lichte horizontale compensatie) Beide zijn planeetparameters, klaar voor fase 3. ### 5. Handmatige sprong van het bovenste blok (t1100u) Het naar boven slepen van een blok dat al het bovenste van zijn kolom is, moest een handmatige sprong starten (tot net onder de bovenrand). De core vroeg eerder dat de aanwijzer in de lege ruimte boven de stapel kwam (`y > top + 1 + 0,25`). Wie het bovenste blok vasthad en het voorbij zijn eigen positie trok, maar niet een hele tegel het gat in, kreeg geen sprong. Op touch kon `lostpointercapture` de sleep ook te vroeg beëindigen. Aanname: - Begon de sleep al op het bovenste blok, dan is een trek van `LAUNCH_PULL = 0,35` tegel omhoog vanaf het drukpunt genoeg (“voorbij zijn eigen positie”), voor muis én touch (zelfde Pointer-Events-pad). - Begon de sleep lager in de stapel, dan blijft de oude drempel gelden: eerst wisselen, en pas lanceren als de aanwijzer in de lege ruimte boven de (nieuwe) top zit. Zo lanceer je niet per ongeluk een blok dat je alleen naar de bovenste plek wilt schuiven. - De view luistert na `pointerdown` op `window` voor `pointermove` / `pointerup` / `pointercancel`, zodat een sleep boven het canvas (nodig bij een volle kolom) niet verloren gaat. `lostpointercapture` beëindigt de sleep niet meer. ### 6. Selectie-tween (t1101u) Een vastgehouden (geselecteerd) blok krijgt dezelfde schaal-animatie als de **DEFAULT**-instellingen van Tim's KWin Click Tween-effect. Bron (op deze box): `/workspace/click-tween/`, specifiek: - `settings.h`: `clickTime = 150` ms, `releaseTime = 720` ms, `clickEasing = easeOutBack`, `releaseEasing = easeOutElastic` - `clicktween.cpp`: pers-doel `0.8`, loslaat-doel `1.0`; een onderbroken animatie start vanaf de huidige schaal (`QVariantAnimation`) - `README.md`: “krimpt naar 80% in 150 ms”, “groeit in 720 ms terug”, “curveparameters zijn Qt-standaardwaarden” Qt `QEasingCurve`-standaardwaarden, ook in de README genoemd: - Back-overshoot: `1.70158` - Elastic: amplitude `1.0`, periode `0.3` Het blok blijft op 80% zolang het geselecteerd is, en veert bij loslaten terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken dezelfde tween. ## Fase 2 — multiplayer (volgt) Zie latere secties zodra fase 2 landt. De miss-kans van 30% wordt een parameter (`missChance`, standaard 0,30); de planeetformule `Planet.missChance` (60%–5% via Power) is voor fase 3.