LifePlay-Revival/Docs/Migration/etat/sandbox/SB2/SB2-CART.md

SB2-CART — Carte de découpe (SB2-T1)

• Fiche : SB2-T1 — Agent : A-CART — Modèle : prévu opus (M3) | utilisé opus (session principale)
• Dépôt : addon D:\Game\LifePlay-Sandbox, branche lot/SB2-bibliotheques, tag d'entrée lot-SB2-avant = b8fe6b3
• Entrée : Docs/SB0-conception.md § 2, 3 et 5 (addon) ; SB1-SPEC.md, SB1-IMPL.md ; sources lues en entier : LPPairSandbox.h/.cpp, LPCoupleSim.cpp, LPSandboxInteraction.cpp, LPSandboxRoomBuilder.cpp, début de LPSandboxMeasure.cpp ; relevés par recherche : LPSandboxMeasure.cpp, LPSandboxMeasureTour.cpp, LPSandboxActionVM.cpp.

1. Principe

Comportement inchangé : le code des méthodes est déplacé, pas réécrit. Seuls changent le propriétaire (classe) et les accès à l'état partagé, qui passent par des services du contexte. Les écarts inévitables sont listés en § 7.

2. Classes cibles

Classe (fichier)	Module	Nature	Rôle
ALPSandboxScene (LPSandboxScene.h/.cpp, ex-LPSandboxRoomBuilder.cpp)	lps_lib_scene	AActor (ex-ALPPairSandboxStage)	pièce, mobilier, coque, sol, lumières, ciel ; points de départ ; hôte des composants des mods (outer et racine d'attache, comme la scène aujourd'hui)
FLPSandboxActors (LPSandboxActors.h/.cpp)	lps_lib_actors	C++ (instance unique par session, possédée par le GameMode)	joueur et partenaire, capsule copiée de Person, scan Quaternius, corps, lecture de clips, masquage des personnages
FLPSandboxCamera (LPSandboxCamera.h/.cpp)	lps_system_core	C++, enveloppe du bras et de la caméra du pion	longueur et décalage du bras, focale, rotation de contrôle, bornes de tangage, ResetView
ALPPairSandboxCharacter (LPPairSandbox.h/.cpp)	core (pion) + actors (corps)	ACharacter, garde son nom (GameMode, config)	composants Arm/Camera ; menu (barre des mods, rangée Corps, emplacement du panneau du mod ouvert) ; Tick réduit à l'aiguillage
ALPPairSandboxGameMode	core	inchangé de nom	crée scène, acteurs, contexte
ULPSandboxCoupleMod (LPSandboxCoupleMod.h/.cpp, ex-partie de LPCoupleSim.cpp)	lps_couple	UObject (outer : la scène)	couple : soudure, boîte, déplacement, animations de paire, interrupteurs 1/2, messages du mode Pair
ULPSandboxInteractionMod (LPSandboxInteractionMod.h/.cpp, ex-LPSandboxInteraction.cpp)	lps_interaction	UObject	filtres, chat, pastille de touche, vues, marche
ULPSandboxMeasureMod (LPSandboxMeasure.cpp, LPSandboxMeasureTour.cpp, nouveau LPSandboxMeasureMod.h)	lps_asset_integration	UObject	tout l'état Mesure (≈ 70 membres) ; AddUObject des captures conservé

Les enveloppes ILPSandboxMod (LPSandboxModWrappers.cpp) tiennent chacune un TStrongObjectPtr vers l'objet du mod, créé à la première ouverture (outer = scène). UObject plutôt que C++ pur : OnScreenshotCaptured().AddUObject et les TObjectPtr (composants, caméras) gardent leur sémantique actuelle.

2.1 Contexte et interface (révision de LPSandboxMod.h)

struct FLPSandboxContext
{
    UWorld* World = nullptr;
    ALPPairSandboxCharacter* Player = nullptr;   // pion (lecture des touches, menu)
    FLPSandboxCamera* Camera = nullptr;          // core
    ALPSandboxScene* Scene = nullptr;            // lps_lib_scene, nul si non requis
    FLPSandboxActors* Actors = nullptr;          // lps_lib_actors, nul si non requis
};

struct FLPSandboxInput        // rempli par le Tick du pion, une fois par image
{
    APlayerController* PC = nullptr;
    float DeltaSeconds = 0.f;
    float MouseX = 0.f, MouseY = 0.f;   // clic droit tenu, sinon 0
    FVector Direction = FVector::ZeroVector; // ZQSD/WASD dans le repère de la caméra (non normalisé)
};

class ILPSandboxMod
{
    // existants : GetId, Activate, Deactivate
    virtual TSharedPtr<SWidget> BuildPanel();              // construit une fois, mis en cache par l'enveloppe
    virtual void TickInput(const FLPSandboxInput& Input);  // remplace l'aiguillage du Tick du pion
    virtual void OnFellOff();                              // pion sous z = -50
    virtual void OnBodyChanged(ACharacter* Who);           // choix MC / PNJ dans la rangée Corps
};

Remplissage selon MODULE_REQUIREMENTS : lps_asset_integration ne requiert pas lps_lib_scene dans son descripteur actuel mais utilise la scène comme hôte de ses composants et masque la pièce → ajouter lps_lib_scene à ses prérequis (décision D2, § 6). Pas d'accès de mod à mod : les seuls points de contact sont scène, acteurs, caméra.

3. Destination de chaque membre

3.1 ALPPairSandboxStage → ALPSandboxScene, FLPSandboxActors, mods

Membre / méthode (lignes LPPairSandbox.h)	Destination
Build (RoomBuilder 105–316), LoadWorldFile, Token, FProp	Scene ; la lecture de la capsule Person (119–127) part dans Actors (ReadPersonCapsule) ; Build(World, Radius, Half, bCopied) reçoit la capsule pour la recherche du départ et le journal (texte inchangé) ; l'appel final LoadChat() + PairSandbox::LoadActions() (314–315) part dans le mod interaction
Furniture, RoomShell (124–125), bFurnitureBlocks (104)	Scene ; services SetFurnitureBlocksPawn(bool) (boucle de Apply 74–77), HideRoom() / ShowRoom() (copies exactes des boucles de BeginMeasure 172–187 et EndMeasure 85–98)
PlayerSpot, PartnerSpot (205–206)	Scene (GetPlayerSpot, GetPartnerSpot)
Possess (cpp 43–72)	GameMode / Actors : Actors.Spawn(Scene, PlayerPawn) ; l'appel Apply() (67) devient « ouvrir le mod initial » ; ShowAnimMenu reste appelé
Player, Partner (201–202), GetPartner	Actors (GetPlayer, GetPartner)
CapsuleRadius, CapsuleHalf, bCopiedPerson (207–209), ConfigureCapsule	Actors
PlayIdle	aucun appelant : supprimé (vérifié par recherche)
bCapsulesOn (105), CoupleBox (129), CurrentPair (203), Apply, Weld, FitCoupleBox, MoveCouple, PlayPair, ToggleFurniture, ToggleCapsules	ULPSandboxCoupleMod ; Apply appelle Scene->SetFurnitureBlocksPawn(bFurnitureBlocks) où bFurnitureBlocks reste lu dans la scène (l'interrupteur 1 bascule l'état de la scène)
BeginInteraction, LoadChat, ChatLabel	ULPSandboxInteractionMod
BeginMeasure … WritePlanche, MeasureBodies … AutoStatus, FTourStep, FLPMeasureFigure, bShowMannequin (106)	ULPSandboxMeasureMod (substitutions § 4)

3.2 ALPPairSandboxCharacter

Membre / méthode	Destination
Arm, Camera, ResetView, SavedArmLength	composants : pion ; manipulation : FLPSandboxCamera ; SavedArmLength → mod Mesure
SetStage, Stage	remplacés par le contexte ; réglage souris/caméra de SetStage (109–121) → FLPSandboxCamera::Init
ApplyBody, BodyLabel, SelectBody, QuaterniusMesh, QuaterniusClips, LoadQuaternius	Actors (scan unique par session ; ApplyBody(Who, Label)) ; SelectBody reste dans le menu du pion puis appelle OpenMod->OnBodyChanged(Who)
RefreshPose	coupé en deux services Actors : PlayClip(Who, Clip) (branche Quaternius B_/M_, 315–349) et PlayPairClip(Who, Pair) (branche paire 352–371) ; la logique de choix part dans couple (paire / Idle_Loop) et interaction (marche / Idle_Loop)
PlayWalk, WalkLabel, SelectWalk, bWasMoving, EyesIdle, bResumeEyes, CurrentView, SelectView, ApplyInteractionView, ApplyFilters, ShowChat, HideChat, ChatLine, bChatOpen, RefreshInteractKey, ShowKeyMark, HideKeyMark, PlaceKeyMark, KeyMark, bKeyVisible, InteractKey, InteractLetter, bInteract*, bPrevE, Who1Name … bSpouses, ListedActions, BuildFilterPanel	ULPSandboxInteractionMod (pointeurs sur membre de Flag : bool ULPSandboxInteractionMod::*)
SelectAnim, CurrentAnim, liste des 38 noms (ShowAnimMenu 290–313), bPrevOne, bPrevTwo	ULPSandboxCoupleMod (panneau : liste des paires)
BuildMeasurePanel, TickMeasureInput	ULPSandboxMeasureMod (BuildPanel, TickInput)
SelectMode, ModeLabel, bMeasure, bInteraction, IsInteraction, IsMeasure, GetModeLabel, ModeCombo, Menu->Modes/Mode/AnimRow/ViewRow/FilterRow/MeasureRow	supprimés : le registre et Activate/Deactivate les remplacent ; OpenModeLabel / IdForModeLabel gardés pour sandbox_mode.txt et [Sandbox.Mode]
OpenNeutral	scène neutre = aucun mod : personnages à l'arrêt, pas de TickInput (D3)
Menu (FPairSandboxMenu)	réduit à Widget, BodyRow, ModPanel (emplacement), Bodies ; Views, Walks, Who1/2, Places, Whens, Races → interaction ; Options/Selected → couple
Tick (638–855)	pion : chute (653–668) → OnFellOff, souris (676–682), direction (684–703), Échap (818–821) ; le reste → TickInput du mod ouvert (tableau 3.3)

3.3 Découpe du Tick du pion

Lignes	Condition actuelle	Destination
645–652 boîte de débogage	Pair	couple TickInput
653–668 chute	interaction / sinon	OnFellOff : interaction (BeginInteraction + PlayWalk), couple (Apply), Mesure : rien (D4)
704–714 déplacement	Pair : MoveCouple ; Interaction : AddMovementInput	couple / interaction
715–749 marche, yeux	Interaction	interaction
750–764 touches 1, 2	Pair	couple
765–817 pastille, chat	Interaction	interaction
823–835 touches Mesure, étiquettes	Mesure	Mesure
836–854 messages à l'écran	Pair	couple

3.4 Transitions (SelectMode 175–257) → Activate / Deactivate

Bloc actuel	Destination
HideChat, HideKeyMark, SetOwnerNoSee(false) (189–191)	interaction Deactivate + Camera/Actors au besoin (SetOwnerNoSee(false) dans chaque Activate, comme aujourd'hui à chaque changement)
sortie de Mesure (216–223)	Mesure Deactivate
entrée Mesure (224–239)	Mesure Activate
entrée Interaction (241–251)	interaction Activate
entrée Pair (252–256)	couple Activate (PlayPair(CurrentAnim) + ResetView)
BeginInteraction 97–100 et BeginMeasure 188–192 (boîte du couple coupée)	couple Deactivate (collision coupée et boîte masquée) : un mod ne touche plus l'état d'un autre

4. Substitutions mécaniques dans les fichiers Mesure

Avant (membre de la scène)	Après (dans ULPSandboxMeasureMod)
ALPPairSandboxStage::	ULPSandboxMeasureMod::
Player.Get() / Partner.Get()	Actors->GetPlayer() / Actors->GetPartner()
PlayerSpot, CapsuleHalf	Scene->GetPlayerSpot(), Actors->GetCapsuleHalf()
boucles Furniture / RoomShell	Scene->HideRoom() / Scene->ShowRoom()
CoupleBox (188–192)	supprimé (couple Deactivate)
NewObject<T>(this…), GetRootComponent(), GetWorld(), GetActorLocation()	NewObject<T>(Scene…), Scene->GetRootComponent(), Scene->GetWorld(), Scene->GetActorLocation()
AddUObject(this, &ALPPairSandboxStage::…)	AddUObject(this, &ULPSandboxMeasureMod::…)
Room->… dans TickMeasureInput, Who->Stage dans BuildMeasurePanel	this->… ; Arm/GetMesh() du pion via Camera / Player

Mêmes substitutions pour couple (LPCoupleSim.cpp) et interaction (Player/Partner, PlayerSpot, Arm, Camera, GetController).

5. Ordre de déplacement (fiches IMPL)

1. SB2-T2 (socle et bibliothèques) : LPSandboxMod.h (contexte, entrée, 3 crochets), ALPSandboxScene, FLPSandboxActors, FLPSandboxCamera, GameMode, pion (menu réduit, aiguillage) ; enveloppes adaptées.
2. SB2-T3a couple, T3b interaction, T3c Mesure (≈ 1 600 lignes, substitutions § 4).
3. Une compilation (SB2-T4) après T3c : le code intermédiaire ne compile pas seul (la scène perd ses membres en T2).

Points d'appel croisés à casser : Build → LoadChat/LoadActions ; BeginInteraction → CoupleBox ; BeginMeasure → CoupleBox ; Possess → Apply ; RefreshPose → Stage->CurrentPair / Stage->Player->WalkLabel ; SelectBody → bInteraction, bWasMoving, CurrentView ; ShowAnimMenu → PairSandbox::PlaceChoices/WhenChoices ; Tick → Stage->CoupleBox, bCapsulesOn, bFurnitureBlocks.

6. Décisions proposées

#	Décision	Motif
D1	Les mods sont des UObject (outer = scène) tenus par l'enveloppe	captures d'écran par AddUObject, composants en TObjectPtr
D2	lps_asset_integration requiert lps_lib_scene (descripteur) et lps_lib_actors	il masque la pièce et les personnages et accroche ses composants à la scène ; sinon contexte nul
D3	Scène neutre (aucun mod) : pas de comportement de couple	l'état neutre de SB1 (« Pair sans liste ») dépendait du couple ; un mod ne peut plus servir de défaut
D4	Chute du pion en Mesure : rien	aujourd'hui Apply() du couple ; le pion est figé et à l'intérieur de la pièce pendant la Mesure, cas non atteint
D5	Panneau du mod ouvert placé sous la rangée Corps (MC, PNJ)	aujourd'hui le panneau Mesure est au-dessus de MC/PNJ et les autres en dessous ; un seul emplacement
D6	EndSession vide aussi les instances de mods	l'état des mods vit dans le monde (outer = scène), comme celui de la scène aujourd'hui
D7	Les instances persistent entre deux ouvertures dans la session	l'état actuel (clip Mesure, filtres, paire choisie) survit aux changements de mode

7. Écarts visibles attendus

• Ordre du panneau (D5) ; scène neutre sans couple (D3) ; chargement de chat.lpaction et des actions à la première ouverture d'interaction, plus au démarrage (journal déplacé) ; un seul scan Quaternius par session au lieu de trois (lignes « Sandbox Quaternius » moins nombreuses).

8. Observation hors périmètre (comportement actuel, non corrigé en SB2)

• O1 : EndMeasure (LPSandboxMeasure.cpp 85–98) remet SetVisibility(true) sur meubles et murs sans SetHiddenInGame(false), alors que BeginMeasure a mis SetHiddenInGame(true) : après Mesure, la pièce devrait rester invisible en Couple et Interaction. À confirmer à l'écran ; correction proposée hors SB2 (registre des reports).