LifePlay-Revival/Docs/Migration/etat/VQ/VQ1/VQ1-SPEC.md

# VQ1-SPEC — Spécification `DefaultScalability.ini` (Low → Epic)

**Fiche :** VQ1-T1  
**Rôle :** A-ARCH  
**Modèle attendu :** claude-sonnet-5-5-high (M2)  
**Date :** 07 octobre 2026  
**Workspace :** `d:\Game\LifePlay-master 5.5`  
**Statut :** Spécification — prête pour implémentation (VQ1-T2)  
**Dépend de :** `VQ0-CART.md` (cartographie des réglages Video), lot L7c (`Config/DefaultEngine.ini`)

---

## 1. Objectif

Définir, pour le projet, un fichier `Config/DefaultScalability.ini` qui précise explicitement les cvars appliqués par les niveaux de qualité **0 (Low) → 3 (Epic)** pour **quatre groupes seulement** :

| Groupe | cvar de niveau | Section INI (par niveau) |
|---|---|---|
| Ombres | `sg.ShadowQuality` | `[ShadowQuality@0]` … `[ShadowQuality@3]` |
| Textures | `sg.TextureQuality` | `[TextureQuality@0]` … `[TextureQuality@3]` |
| Effets | `sg.EffectsQuality` | `[EffectsQuality@0]` … `[EffectsQuality@3]` |
| Anti-aliasing (qualité) | `sg.AntiAliasingQuality` | `[AntiAliasingQuality@0]` … `[AntiAliasingQuality@3]` |

Ces quatre groupes préparent le futur bloc `LPVideo*` (VQ0-CART §7) et remplacent la dépendance implicite aux valeurs par défaut du moteur par des valeurs **lisibles, versionnées et revues**.

## 2. Périmètre et interdits

### 2.1 Dans le périmètre

- Niveaux **0, 1, 2, 3** des 4 groupes ci-dessus.
- Cvars de qualité « classiques » UE5 (résolution d'ombres, cascades, pool de textures, anisotropie, qualité de réfraction, qualité du post-AA).

### 2.2 Interdits (hors périmètre — ne doit jamais apparaître dans `DefaultScalability.ini`)

| Interdit | Raison |
|---|---|
| Illumination globale dynamique (`r.DynamicGlobalIlluminationMethod`, `r.Lumen.*`, groupe `GlobalIlluminationQuality`) | Verrouillée à `0` par le lot L7c (rendu 4.27 conservé). |
| Ombres virtuelles / VSM (`r.Shadow.Virtual.*`, y compris `r.Shadow.Virtual.Enable`) | Verrouillées à `0` par L7c. Aucune cvar `r.Shadow.Virtual.*` ne doit être ajoutée, même « inoffensive ». |
| Méthode d'anti-aliasing (`r.AntiAliasingMethod`) | Verrouillée à `2` (TAA) par le lot L6a / L7c : TSR fait scintiller les maillages à morphs. Le groupe `AntiAliasingQuality` ne règle **que** la qualité, pas la méthode. |
| Méthode de reflets (`r.ReflectionMethod`, `r.SSR.*`, groupe `ReflectionQuality`) | Verrouillée à `2` (SSR) par L7c. |
| Groupes `ViewDistanceQuality`, `PostProcessQuality`, `ShadingQuality`, `FoliageQuality`, `LandscapeQuality`, `ResolutionQuality`, `GlobalIlluminationQuality`, `ReflectionQuality`, `SkeletalMeshQuality`, `HeightFieldShadowQuality`… | Non demandés ; les valeurs moteur (`BaseScalability.ini`) restent inchangées. |
| Niveau Cinematic (`@Cine`, niveau 4) | Non exposé au joueur ; valeurs moteur conservées. |
| Toute modification de `Config/DefaultEngine.ini` | Les contraintes L7c/L6a y restent la source de vérité. |

> **Garde-fou L7c (rappel) :** `r.DynamicGlobalIlluminationMethod=0`, `r.ReflectionMethod=2`, `r.Shadow.Virtual.Enable=0`, `r.AntiAliasingMethod=2` dans `[/Script/Engine.RendererSettings]` de `DefaultEngine.ini`. Ces valeurs sont au niveau de priorité *ProjectSetting*, supérieur à *Scalability* : elles ne peuvent pas être écrasées par un niveau de scalabilité, mais la règle ci-dessus évite néanmoins toute tentative.

## 3. Correspondance des niveaux

| Niveau | Nom | Usage |
|---|---|---|
| 0 | Low | Machines faibles / GPU intégrés |
| 1 | Medium | Machines modestes |
| 2 | High | Cible standard |
| 3 | Epic | Qualité maximale proposée ; reste **conservatrice** (pas de valeur au-delà du palier Epic moteur) |

Principe « conservateur » : chaque valeur est choisie **au plus égale** à l'équivalent Epic du moteur UE 5.5 et sans activer de fonctionnalité nouvelle par rapport au rendu 4.27 validé. Aucune cvar susceptible de changer le *look* (volumetric fog, distance-field shadows, capsule shadows, SSS profile, bloom…) n'est incluse : elles restent aux valeurs moteur.

## 4. Tableau niveau → cvars

### 4.1 ShadowQuality (`sg.ShadowQuality`)

| cvar | 0 Low | 1 Medium | 2 High | 3 Epic | Commentaire |
|---|---|---|---|---|---|
| `r.Shadow.CSM.MaxCascades` | 1 | 2 | 3 | 4 | Cascades du soleil |
| `r.Shadow.MaxResolution` | 512 | 1024 | 2048 | 2048 | Résolution max ombre dynamique (plafonnée à 2048) |
| `r.Shadow.MaxCSMResolution` | 512 | 1024 | 2048 | 2048 | Résolution max par cascade |
| `r.Shadow.RadiusThreshold` | 0.06 | 0.05 | 0.04 | 0.03 | Rayon écran min. pour projeter une ombre |
| `r.Shadow.DistanceScale` | 0.6 | 0.7 | 0.85 | 1.0 | Distance de rendu des ombres |
| `r.Shadow.CSM.TransitionScale` | 0.0 | 0.25 | 0.6 | 1.0 | Fondu entre cascades |
| `r.Shadow.PreShadowResolutionFactor` | 0.5 | 0.5 | 0.75 | 1.0 | Résolution des pré-ombres |

Non inclus volontairement : `r.Shadow.Virtual.*` (interdit), `r.DistanceFieldShadowing`, `r.CapsuleShadows`, `r.VolumetricFog*`, `r.LightMaxDrawDistanceScale`, `r.LightFunctionQuality`.  
Cohérence : `r.MinScreenRadiusForCSMDepth=0.010000` reste fixé dans `DefaultEngine.ini` (non touché).

### 4.2 TextureQuality (`sg.TextureQuality`)

| cvar | 0 Low | 1 Medium | 2 High | 3 Epic | Commentaire |
|---|---|---|---|---|---|
| `r.Streaming.MipBias` | 2.5 | 1 | 0 | 0 | Mips abaissés (0 = pleine résolution) |
| `r.MaxAnisotropy` | 0 | 2 | 4 | 8 | Filtrage anisotrope |
| `r.Streaming.PoolSize` | 200 | 400 | 700 | 1000 | Budget pool de streaming (Mo) |
| `r.Streaming.MaxEffectiveScreenSize` | 0 | 0 | 0 | 0 | 0 = comportement moteur |

`r.TextureStreaming=True` reste imposé par `DefaultEngine.ini`.

### 4.3 EffectsQuality (`sg.EffectsQuality`)

| cvar | 0 Low | 1 Medium | 2 High | 3 Epic | Commentaire |
|---|---|---|---|---|---|
| `r.TranslucencyLightingVolumeDim` | 24 | 32 | 48 | 64 | Volume d'éclairage des translucides |
| `r.RefractionQuality` | 0 | 2 | 2 | 3 | Qualité de réfraction |
| `r.SSS.Scale` | 0.25 | 0.5 | 0.75 | 1.0 | Échelle subsurface scattering |
| `r.SSS.SampleSet` | 0 | 1 | 2 | 2 | Jeu d'échantillons SSS |
| `r.DetailMode` | 0 | 1 | 2 | 2 | Seuil des composants « detail mode » |
| `fx.Niagara.QualityLevel` | 0 | 1 | 2 | 3 | Niveau de qualité Niagara |

Non inclus : `r.SSR.Quality`, `r.Lumen.*` (interdits), `r.BloomQuality`, `r.SceneColorFormat`, `r.EmitterSpawnRateScale`.

### 4.4 AntiAliasingQuality (`sg.AntiAliasingQuality`)

| cvar | 0 Low | 1 Medium | 2 High | 3 Epic | Commentaire |
|---|---|---|---|---|---|
| `r.PostProcessAAQuality` | 0 | 2 | 4 | 4 | Qualité du post-AA (échelle moteur 0–6) |

Non inclus : `r.AntiAliasingMethod` (interdit, fixé à 2/TAA), `r.TSR.*` (TSR non utilisé), `r.TemporalAA*`.  
`r.PostProcessAAQuality=4` pour Epic = palier moteur ; la valeur 6 est réservée à Cinematic et n'est pas utilisée.

## 5. Note « Overall »

`sg.OverallQuality` (« Overall ») n'a **pas** de section propre dans `DefaultScalability.ini` : l'application d'un niveau Overall `N` consiste à **appliquer le même niveau `N` aux quatre groupes** (`sg.ShadowQuality`, `sg.TextureQuality`, `sg.EffectsQuality`, `sg.AntiAliasingQuality` = `N`). Les autres groupes de scalabilité restent à leur valeur courante.

Conséquence pour le futur sous-système `LPVideo*` : un sélecteur « Overall » doit écrire `N` sur ces 4 groupes uniquement (via `Scalability::SetQualityLevels` en préservant les autres champs de `FQualityLevels`), et ne pas déclencher d'effet de bord sur GI, reflets, VSM ou méthode d'AA.

## 6. Règles de fusion et de priorité

1. `Config/DefaultScalability.ini` est lu après `Engine/Config/BaseScalability.ini` ; les sections portant le même nom (`[ShadowQuality@2]`…) sont **fusionnées clé par clé** : les clés non listées conservent la valeur moteur.
2. Les cvars appliquées par scalabilité ont la priorité `SetByScalability`, **inférieure** à `SetByProjectSetting` (`DefaultEngine.ini`). Les verrous L7c ne peuvent donc pas être contournés.
3. Les valeurs `sg.*` choisies par le joueur sont persistées dans `GameUserSettings.ini` (`Saved/Config/Windows`) ; elles choisissent le niveau, pas le contenu des sections.
4. Aucun `DeviceProfile` n'est défini dans `Config/` (pas de `DefaultDeviceProfiles.ini`) : pas de surcharge supplémentaire à prévoir.
5. Le fichier ne contient que des sections `@0`–`@3` des 4 groupes, rien d'autre.

## 7. Points d'attention (VQ0-CART §6)

- **Redondance BP :** les curseurs BP `ShadowQuality`, `PostProcessAAQuality` (qui pilote `r.PostProcessAAQuality` directement), `PostProcessQuality` restent actifs. Un curseur BP `AA Quality` qui fixe directement `r.PostProcessAAQuality` aura priorité de dernière écriture sur le niveau `sg.AntiAliasingQuality` ; le futur `LPVideo*` devra les masquer/synchroniser (hors périmètre VQ1).
- **Aucun changement C++/Blueprint** dans VQ1 : uniquement configuration.
- **Vérification des valeurs moteur :** les valeurs de §4 sont fondées sur les paliers usuels de `BaseScalability.ini` UE 5.x ; elles doivent être confrontées au fichier de l'installation 5.5 lors de la validation (VQ1-VAL).

## 8. Critères d'acceptation (pour VQ1-T2 et validation)

- [ ] `Config/DefaultScalability.ini` existe et ne contient que `[ShadowQuality@0..3]`, `[TextureQuality@0..3]`, `[EffectsQuality@0..3]`, `[AntiAliasingQuality@0..3]`.
- [ ] Aucune occurrence de `Virtual`, `Lumen`, `GlobalIllumination`, `AntiAliasingMethod`, `ReflectionMethod`, `SSR` dans le fichier.
- [ ] `Config/DefaultEngine.ini` inchangé (L7c intact).
- [ ] En jeu, `sg.ShadowQuality 0..3` (etc.) modifie `r.Shadow.MaxResolution`, `r.Streaming.PoolSize`, etc. conformément au §4 (`Scalability` console / `stat`/`r.X` en lecture).
- [ ] Rendu à niveau 3 : GI dynamique, VSM et méthode d'AA inchangés (Lumen/VSM off, TAA).