LifePlay-Revival/Docs/Migration/etat/CAM/CAM-B2n-FICHE.md

CAM-B2n : orbite de la caméra de scène autour du couple (Room, fiche lp-mcp-bp, 2026-10-14)

Origine : CAM-COMMUN5-DIAG.md § 3. Défaut d'origine : en mode Scene, la souris fait tourner la caméra sur place au lieu de tourner autour du couple. Gel des scènes levé pour l'alpha. Room seul.

Barème

a0 b1 c1 d0 e1 f1 = 4 → N1, ajusté à N3 (MCP) ; S = C3 1 + f 1 (choix du pivot) = 2 < 3 : une fiche, sans SPEC séparée. 7 nœuds, environ 14 liens, environ 35 appels. Case C9a.

État (dump Room CAM-B2i-VAL_LPDumpFunction_20261013-225125.txt, Room 18565365… ou celui laissé par B2k)

Chemin de la souris sans Maj :

• CircleCamera (CustomEvent_1, sortie DeltaSeconds = lacet souris) → 96 (après B2i : faux pendant le sexe) → IfThenElse_26 (BuilderOn OU SexOn OU SpaceOn) → IfThenElse_19 (MoveObject) faux → K2Node_CallFunction_149 = SceneCamera.K2_SetActorRotation(148) ;
• 148 = MakeRotator(Pitch ← 147.Pitch, Yaw ← CommutativeAssociativeBinaryOperator_26 = 147.Yaw + DeltaSeconds) ;
• 147 = BreakRotator(146 = SceneCamera.GetActorRotation) ;
• 149.then vide. Getters existants :
• VariableGet_102.SceneCamera (self Room ; sorties 146, 149, 229, 228) ;
• VariableGet_86.SexOn (self ← 103.GI ; après B2i : 19.B, 29, 28 et NOT 453) ;
• VariableGet_106.SexPersons (self ← 105.GI ; sortie → MacroInstance_13.Array).

Règle

Pendant le sexe seulement (SexOn vrai), après la rotation de 149 :

• Pivot P = GetActorArrayAverageLocation(GI.SexPersons), la moyenne des personnes du sexe ;
• SceneCamera.SetActorLocation(P + RotateAngleAxis(SceneCamera.GetActorLocation − P, DeltaSeconds, (0, 0, 1))). La position tourne autour de P du même angle que le lacet : la caméra garde son cadrage sur le couple. Hors sexe (constructeur, ancienne vue C3), le comportement est inchangé.

Écritures (préfixe /Game/BPs/Room.Room:EventGraph.)

1. load_asset /Game/BPs/Room. get_node_infos sur 149, 148, 147, 146, 26, 19, 102, 86, 106 et CustomEvent_1. Tout écart avec la section « État » : arrêt. Relever les PinID.
2. Types (find_node_types, puis confirmation par get_node_infos après création) :
   • Branche : Utilitaires|ContrôleDeFlux|Branche ;
   • GameplayStatics::GetActorArrayAverageLocation ;
   • Actor::K2_GetActorLocation ;
   • KismetMathLibrary::Subtract_VectorVector ;
   • KismetMathLibrary::RotateAngleAxis (déjà utilisé : 497) ;
   • KismetMathLibrary::Add_VectorVector ;
   • Actor::K2_SetActorLocation.
3. create_node des 7 nœuds, près de 149.
4. Liens :
   • L1 : 149.then → Branche.execute ;
   • L2 : 86.SexOn → Branche.Condition ;
   • L3 : 106.SexPersons → GetActorArrayAverageLocation.Actors. Si le type est refusé (tableau de Person contre tableau d'Actor) : arrêt et compte rendu. Repli à décider : SexPersons[0], avec un IsValidIndex.
   • L4 : 102.SceneCamera → GetActorLocation.self ;
   • L5 : GetActorLocation.ReturnValue → Subtract.A ; L6 : Average.ReturnValue → Subtract.B ;
   • L7 : Subtract.ReturnValue → RotateAngleAxis.InVect ; L8 : CustomEvent_1.DeltaSeconds → RotateAngleAxis.AngleDeg ; set_pin_value RotateAngleAxis.Axis = 0,0,1 ;
   • L9 : Average.ReturnValue → Add.A ; L10 : RotateAngleAxis.ReturnValue → Add.B ;
   • L11 : Branche.then → SetActorLocation.execute ; L12 : 102.SceneCamera → SetActorLocation.self ; L13 : Add.ReturnValue → SetActorLocation.NewLocation ;
   • SetActorLocation : bSweep et bTeleport faux ; Branche.else vide.
5. Relecture :
   • 149 then → Branche ;
   • 102 : sorties 146, 149, 229, 228, GetActorLocation et SetActorLocation ;
   • 86 : + Branche ; 106 : + Average ;
   • CustomEvent_1.DeltaSeconds : + RotateAngleAxis ;
   • aucun autre lien modifié (19, 26, 29, 96 et la boucle SexPersons 13 et 153 inchangés).
6. is_dirty = vrai ; compilation stricte ; save_assets de Room seul ; MD5.

Garde Accessed None

• SceneCamera est déjà lu sans garde par 146 et 149 sur ce même chemin : comportement inchangé.
• SexPersons vide pendant SexOn : GetActorArrayAverageLocation rend (0, 0, 0), sans Accessed None. La caméra tournerait alors autour de l'origine. Cas non observé, à surveiller à l'essai.

Limite connue (non traitée ici, à décider)

Si la scène part de C2, la vue reste sur CamRoom jusqu'au premier C (CAM-COMMUN4-DIAG.md § 2). L'orbite ne se voit qu'après un premier passage Scene → POV → Scene, quand la vue est SceneCamera. Pour l'avoir dès le début, il faudrait poser SceneCamera en vue à l'entrée du sexe : branche SexOn dans la voie C2 de UpdateRoomCam, avec environ 4 nœuds. Ce serait une fiche B2o, à décider par l'utilisateur.

VAL

• V5 : dump Room ; seules différences : 7 nœuds et les liens ci-dessus ; EventGraph = nœuds avant + 7.
• V6 : CompileAllBlueprints = référence.
• V7 : voir CAM-COMMUN-6-TESTS.md.

Retour arrière

.\Tools\Restore.ps1 -Lot CAM-B2n -Only Content\BPs\Room.uasset (ou l'instantané commun du passage), éditeur fermé.

Amendement B2n-a (2026-10-14, arrêt de lp-mcp-bp à l'étape 3, décision de l'orchestrateur)

• E1 : GameplayStatics::GetActorArrayAverageLocation est BlueprintCallable, pas pur (GameplayStatics.h:76). Il a execute et then. Option A retenue : le mettre dans le fil, après la Branche.
  • L11a : Branche.then → GetActorArrayAverageLocation.execute (K2Node_CallFunction_535, déjà créé) ;
  • L11b : 535.then → SetActorLocation.execute. Le reste ne change pas : SexPersons n'est lu que si SexOn est vrai.
• E2 : la soustraction et l'addition de vecteurs se font par les opérateurs génériques Utilitaires|Opérateurs| Soustraire et Ajouter, typés vecteur au branchement. C'est la même fonction (Subtract_VectorVector, Add_VectorVector), dans une autre classe de nœud.
• Nœuds déjà créés et gardés : Branche K2Node_IfThenElse_101, moyenne K2Node_CallFunction_535.
• L3 (SexPersons vers Actors) reste la condition d'arrêt prévue : si le type est refusé, arrêt sans repli.
• V5 : EventGraph = nœuds avant B2n + 7, avec un lien d'exécution de plus (L11a et L11b au lieu de L11).