(Feat) Add Animation Fps Charater

Source/EmberWild/Public/PlayerNameplateComponent.h

@@ -0,0 +1,124 @@
+// Fill out your copyright notice in the Description page of Project Settings.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Components/WidgetComponent.h"
+#include "PlayerNameplateComponent.generated.h"
+
+class APlayerState;
+
+/**
+ * L'etiquette de pseudo posee au-dessus d'un joueur.
+ *
+ * Herite de UWidgetComponent et le configure en espace ECRAN : c'est ce qui la
+ * fait toujours faire face a la camera, gratuitement et exactement, sans le
+ * moindre calcul d'orientation par frame. En espace Monde il faudrait la
+ * reorienter soi-meme a chaque image, et elle serait occultee par le decor --
+ * un pseudo qui disparait derriere un caillou n'aide personne.
+ *
+ * L'espace ecran n'applique AUCUNE echelle de distance -- verifie dans
+ * SWorldWidgetScreenLayer::Tick, qui ne fait que projeter la position. Le
+ * pseudo garderait donc une taille en pixels constante pendant que le
+ * personnage, lui, retrecit : l'oeil lit ca comme une etiquette qui GROSSIT en
+ * s'eloignant. C'est pourquoi l'echelle est calculee ici, a la main, en 1/d
+ * comme le ferait une vraie perspective.
+ *
+ * L'opacite suit le meme chemin : une etiquette qui s'eteint d'un coup a la
+ * distance limite se remarque bien plus qu'un fondu, alors qu'elle est censee
+ * ne pas se faire remarquer du tout.
+ *
+ * Le composant ne replique RIEN : le pseudo vit deja sur le PlayerState, qui
+ * est replique par le moteur. Ajouter une propriete ici enverrait deux fois la
+ * meme chaine sur le reseau.
+ */
+UCLASS(ClassGroup = (Survival), meta = (BlueprintSpawnableComponent))
+class EMBERWILD_API UPlayerNameplateComponent : public UWidgetComponent
+{
+	GENERATED_BODY()
+
+public:
+	UPlayerNameplateComponent();
+
+	virtual void BeginPlay() override;
+
+	/**
+	 * Un Tick ici, contrairement au reste du projet.
+	 *
+	 * La regle "jamais de Tick pour lire un etat" vise les widgets qui
+	 * interrogent une valeur au lieu de s'abonner a un delegue. Ce n'est pas le
+	 * cas : on interpole en continu deux grandeurs geometriques -- echelle et
+	 * opacite -- qui changent a chaque pas du joueur. Sur un timer a 0,25 s
+	 * l'etiquette grossirait par paliers visibles.
+	 *
+	 * Le cout est nul en pratique : UWidgetComponent tick deja en espace ecran
+	 * pour se projeter, on ajoute une distance et deux setters.
+	 */
+	virtual void TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction) override;
+
+protected:
+	/**
+	 * Au-dela de cette distance, l'etiquette disparait. 2500 cm = 25 m, soit un
+	 * peu plus que la portee a laquelle on distingue un coequipier dans un
+	 * decor dense.
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Nameplate", meta = (ClampMin = "100", Units = "cm"))
+	float MaxDrawDistance = 2500.f;
+
+	/**
+	 * Distance a laquelle l'etiquette est a sa taille de reference, c'est-a-dire
+	 * exactement celle dessinee dans le WBP. Plus pres elle grossit, plus loin
+	 * elle retrecit -- en 1/d, comme une vraie perspective.
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Nameplate|Echelle", meta = (ClampMin = "50", Units = "cm"))
+	float ReferenceDistance = 600.f;
+
+	/**
+	 * Bornes de l'echelle. Le minimum evite un pseudo reduit a une bouillie de
+	 * deux pixels ; le maximum evite qu'un coequipier colle a la camera ne
+	 * remplisse l'ecran de son nom.
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Nameplate|Echelle", meta = (ClampMin = "0.05"))
+	float MinScale = 0.4f;
+
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Nameplate|Echelle", meta = (ClampMin = "0.1"))
+	float MaxScale = 1.4f;
+
+	/**
+	 * Longueur du fondu, comptee EN DECA de MaxDrawDistance : l'opacite passe de
+	 * 1 a 0 sur cette bande, puis l'etiquette est carrement eteinte.
+	 *
+	 * Exprimee comme une longueur et non comme une distance de depart : une
+	 * distance de depart superieure a MaxDrawDistance serait un reglage invalide
+	 * silencieux, alors qu'une longueur se borne toute seule.
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Nameplate|Fondu", meta = (ClampMin = "0", Units = "cm"))
+	float FadeLength = 700.f;
+
+	/**
+	 * Cacher l'etiquette de son PROPRE personnage.
+	 *
+	 * Vrai par defaut : en vue premiere personne on ne voit jamais son propre
+	 * corps, mais une etiquette en espace ecran, elle, se projetterait en plein
+	 * milieu du viseur.
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Nameplate")
+	bool bHideOnOwningPlayer = true;
+
+private:
+	/** Le PlayerState du pawn porteur, ou nullptr tant qu'il n'est pas arrive. */
+	APlayerState* GetOwnerPlayerState() const;
+
+	/** Recopie le pseudo dans le widget, uniquement s'il a change. */
+	void RefreshName();
+
+	/**
+	 * Dernier pseudo reellement ecrit dans le widget.
+	 *
+	 * Le PlayerState arrive APRES le pawn chez un client : la premiere passe
+	 * trouve donc un nom vide, et il faut continuer a regarder. Comparer plutot
+	 * que reecrire evite de reconstruire la mise en page du Text Block quatre
+	 * fois par seconde pour une chaine identique.
+	 */
+	FString LastShownName;
+};