LifePlay-Revival/Docs/Migration/etat/CAM/CAM-B2b-AMENDEMENT.md

CAM-B2b : amendement de la SPEC après les essais de B2 (brouillon, 2026-10-13)

Brouillon de la session CAM, à reporter dans CAM-SPEC.md (§ (a) B2, § (e) C2, § (f), § 7 V5) après l'accord de Big Boss. Copie d'avant prévue : D:\Game\LifePlay_Backup_5.5\CAM\SPEC-avant-B2b\CAM-SPEC.md. Aucun asset touché par ce document.

1. Entrées

• Essais de B2 (utilisateur, relayés par Big Boss, 2026-10-13) :
  • « quand on est près d'un mur la camera est trop proche » ;
  • « J'ai perdu la capacité de me déplacer ou de déplacer la caméra » ;
  • « les 2 caméra dans les scène de sexe sont toujours oprationnelles » (point 7 conforme).
• Exigence de l'utilisateur (relayée par Big Boss) : « la caméra doit toujours être placée dans la pièce et jamais dehors sinon le mur fait obstruction quand on change de vue ».
• Diagnostic : CAM-B2-journal.txt, section « Essais utilisateur ».

2. Faits relus (lecture seule)

Fait	Preuve
Room sait déjà définir son volume : isPointInsideRoom(Point) = IsPointInBox(Point, O, E). Origine O = (Room.X, Room.Y, Room.Z + H/2). Étendue E = (Wall2.X − sol.X, Wall4.Y − sol.Y, H/2), avec H = WallT.Z − sol.Z et sol = StaticMeshComponent. Boîte alignée sur les axes du monde	dump CAM-B2-VAL_LPDumpFunction_20261013-132919.txt:4051-4162
En extérieur, l'échelle Z de la racine vaut 0,01 : WallT descend à ≈ 20 cm du sol, donc la hauteur de la boîte vaut ≈ 20 cm. Les positions X/Y des murs ne changent pas (seul Z est mis à l'échelle)	LPOutdoorRoomSubsystem.cpp:13-16, 55 ; journal des essais l. 1269 « Piece exterieure (echelle Z 0.010) »
La ruelle de la capture est une pièce extérieure	même ligne 1269
Les murs Wall1-4 ne bloquent le canal Camera que par estimation (réponses par défaut, R5) ; le plafond WallT ignore Camera	SPEC R5 (RCOMP:17-19, copie 5.5)
Les flèches, la molette et la souris de pièce déplacent SceneCamera = ChargenCameras[0] (ScrollDownUp, LeftRight, DownUp, CircleCamera, RotateCamera, sous BuilderOn OR SexOn OR SpaceOn)	CAM-T2 § 3 ; ROOM:1326-1340, 394-700
La marche ZQSD (Walk) ne dépend pas de la cible de vue ; elle est bloquée par un menu de MenuClasses ou par GI.CurrentScene non vide	LPDirectControlSubsystem.cpp:51-55, 606, 840-895

3. Règle de confinement (nouvelle, s'applique à toute vue de pièce posée par CAM)

Volume de la pièce = boîte de isPointInsideRoom, réduite d'une marge m = 30 cm (rayon de balayage 20 + 10) :

• X dans [O.X − |E.X| + m, O.X + |E.X| − m] ; même règle pour Y avec E.Y ;
• intérieur (échelle Z ≥ 0,05) : Z dans [sol.Z + 50, WallT.Z − 25] ;
• extérieur (échelle Z < 0,05) : Z ≥ sol.Z + 50, sans borne haute (pas de plafond).

En extérieur, « dans la pièce » veut donc dire : dans l'emprise au sol de Room (positions de Wall2 / Wall4) et du côté du personnage par rapport aux façades. Les façades de la rue ne sont pas des murs de Room ; c'est le balayage (canal Camera) qui les traite. Que cette emprise coïncide avec l'espace de la ruelle entre les façades reste estimé : à mesurer à l'essai (point (f) ajouté ci-dessous).

Une boîte reste vide si la pièce est plus étroite que 2 m. Dans ce cas, la borne retenue est le centre O sur cet axe.

4. Modifications de C2 (remplacent B2-3 et B2-6 pour la partie position)

• B2b-1 Cible confinée (ComputeC2Target) : Desired → Clamp dans le volume (§ 3) → balayage de la tête vers la cible bornée (rayon 20, au lieu de 12). En cas d'impact : Location + Normal × 20, puis Clamp → C2Target.
• B2b-2 Repli vers l'intérieur et vers le haut : si Distance(C2Target, tête) < 80, on recalcule un second point Desired2 = tête + (0, 0, 100) − F × 60. Ce point est borné (Clamp), balayé de la tête vers lui, puis borné à nouveau. Il devient C2Target. La vue plonge alors sur le personnage au lieu de coller au mur. La hauteur plafond − 25 reste respectée à l'intérieur.
• B2b-3 Trajectoire protégée (UpdateRoomCam, poursuite) : après VInterpTo, on balaie de la tête vers Next (rayon 20) ; en cas d'impact, Next := Location + Normal × 20, puis Clamp. Le lissage ne passe donc jamais derrière un mur ni hors de la boîte, même pendant un demi-tour du personnage.
• B2b-4 Commutation sans lissage : PlaceC2 pose déjà la caméra sans lissage avant SetViewTargetWithBlend. Le point posé est désormais celui de B2b-1 / B2b-2, donc dans le volume. CamRoom naît à la position du personnage (B2-2), ce qui est sans effet puisque PlaceC2 la replace avant la bascule de vue. Vérification : V5 relit l'ordre PlaceC2 → SetViewTargetWithBlend (466).

5. Contrôle des autres vues (exigence « jamais dehors »)

Vue	Position	Dans la pièce ?
Entrée en pièce, touche C vers C2	PlaceC2 (B2b-1, B2b-2)	oui, par construction
C2 pendant la poursuite	B2b-3	oui, par construction
C1	yeux du personnage	oui
C3 provisoire (jusqu'à B3)	ChargenCameras[0] = ancienne caméra de pièce, placée par l'ancienne logique	non garanti : c'est l'ancienne vue, qui peut se trouver derrière un mur. C'est vraisemblablement le « mur qui fait obstruction quand on change de vue » (estimé)
C3 de B3, intérieur	(O.X, O.Y, plafond − 5)	oui, si B3 prend la boîte du § 3 et non GetActorBounds (le mobilier peut élargir les bornes de l'acteur)
C3 de B3, extérieur	O + s·(E.A − 50)·Â, Z = sol + 380	oui en XY si la boîte du § 3 est utilisée ; Z libre dehors

Amendement de B3, à reporter : remplacer GetActorBounds(Room) par la boîte du § 3 (B3-1, § (e) C3), avec la même marge.

6. Pilotage de la caméra en C2 (choix de l'utilisateur en attente)

• Option 1 (recommandée) : en C2, LeftRight / CircleCamera (flèches gauche/droite, souris X) font varier un décalage de lacet C2Yaw. DownUp / RotateCamera (flèches haut/bas, souris Y) font varier un décalage de hauteur C2Pitch, borné. La molette (ScrollDownUp) fait varier la distance C2Dist, entre 100 et 300 cm (175 au départ). Desired tourne avec C2Yaw autour du personnage. Le confinement du § 3 et le repli s'appliquent ensuite, sans changement. Relais : en tête des 5 événements de déplacement de Room, une branche « vue = CamRoom » vrai → réglage de C2 ; faux → chaîne actuelle (déplacement de SceneCamera).
• Option 2 : en C2, le premier appui sur une commande de caméra rend la vue manuelle (SceneCamera, comme avant B2), puis la touche C reprend le cycle. C'est plus simple, mais la poursuite est perdue jusqu'au prochain C.

7. Marche du personnage

Hors périmètre de cet amendement tant que le test qui tranche n'est pas fait : C3 (ancienne vue) puis ZQSD, dans le build B2. Si le personnage marche en C3 et pas en C2, la cause est CAM et une section 7 sera écrite. Sinon, la cause est hors CAM et se signale au lot concerné (B-SOL, menu ou scène restés actifs).

8. Critères ajoutés

• V5 (dump de Room) : SphereTraceSingle 3 (cible, repli, trajectoire) ; FClamp ou Clamp ≥ 3 ; Vector_Distance ≥ 1 ; VInterpTo 1 ; RInterpTo 1 ; SetViewTargetWithBlend 3 ; ordre 465 → 466 inchangé.
• Essais (§ (f)) :
  • dos à un mur, coin de pièce, couloir étroit : la caméra reste dans la pièce et se relève au lieu de coller au mur ;
  • demi-tour rapide : aucune image derrière un mur ;
  • C1 → C2 : la première image est déjà dans la pièce ;
  • ruelle extérieure : la caméra reste entre les façades (mesure de l'emprise, § 3) ;
  • option 1 : flèches, souris et molette font tourner et éloigner C2.

9. Coût estimé (copie UE)

Partie	Nœuds	MCP	Contrôles et build
B2b-1 à B2b-4 (confinement, repli, trajectoire)	≈ 40	≈ 45 min	V5, V6 ≈ 5 min ; V7 ≈ 5 min
Option 1 (pilotage)	≈ 30	≈ 35 min	dans le même build
Option 2 (pilotage)	≈ 10	≈ 15 min	dans le même build
Total avec l'option 1 : ≈ 1 h 30 de copie UE, puis un nouvel essai.