MechanismVisuals.h File Reference

Correspondance état logique d'un mécanisme → nom de clip d'animation (LOT-47 TACHE-01). More...

#include <optional>
#include <set>
#include <string>
#include <vector>
#include "Core/Levels/TileType.h"
#include "HMI/Graphics/AnimationCatalog.h"
#include "HMI/Graphics/RenderMode.h"

Go to the source code of this file.

Classes
struct	hmi::MechanismVisualState
	État de présentation d'un mécanisme animé, par instance (LOT-47 TACHE-02). More...

Namespaces
namespace	hmi

Functions
bool	hmi::isStatefulMechanism (core::TileType type) noexcept
	Indique si un type de tuile est un mécanisme à état, dont l'apparence dépend d'une donnée lue en lecture seule dans Core (EX-ARCH-012).
std::optional< std::string >	hmi::mechanismTargetClip (core::TileType type, bool active) noexcept
	Nom du clip d'état cible d'un mécanisme, d'après son type et son état logique courant.
std::optional< std::string >	hmi::mechanismTransitionClip (core::TileType type, bool wasActive, bool isActive) noexcept
	Nom du clip de transition joué une fois lors d'un changement d'état (LOT-47 TACHE-02), s'il y a lieu.
std::vector< std::string >	hmi::mechanismExpectedClips (core::TileType type)
	Noms de clip attendus par la correspondance pour un type de mécanisme, dans l'ordre du tableau ci-dessus (utilisé par le diagnostic du panneau « Textures », LOT-47 TACHE-04).
core::AtlasRegion	hmi::advanceMechanismVisual (MechanismVisualState &state, const AnimationDescription &description, core::TileType type, bool active, const std::string &assetKey, float fixedDelta, std::set< std::string > &warnedMissingClips)
	Fait progresser l'animation d'une instance de mécanisme d'un pas fixe : détecte un changement d'état, choisit le clip approprié (transition ou état cible, avec repli sur clip manquant), avance l'image courante, et renvoie la région à afficher (LOT-47 TACHE-02).
float	hmi::mechanismDiagnosticAlpha (RenderMode mode, bool active, float activeAlpha, float inactiveAlpha) noexcept
	Alpha de diagnostic, réservé au mode Physique (LOT-47 TACHE-03).

Variables
constexpr const char *	hmi::MECHANISM_CLIP_DOOR_CLOSED = "closed"
	Noms de clip conventionnels, documentés dans Source/Elements/Assets/README.md — c'est le contrat qu'un auteur d'asset doit respecter pour que son animation soit reconnue.
constexpr const char *	hmi::MECHANISM_CLIP_DOOR_OPENING = "opening"
constexpr const char *	hmi::MECHANISM_CLIP_DOOR_OPEN = "open"
constexpr const char *	hmi::MECHANISM_CLIP_DOOR_CLOSING = "closing"
constexpr const char *	hmi::MECHANISM_CLIP_SWITCH_INACTIVE = "inactive"
constexpr const char *	hmi::MECHANISM_CLIP_SWITCH_ACTIVE = "active"
constexpr const char *	hmi::MECHANISM_CLIP_PLATE_RELEASED = "released"
constexpr const char *	hmi::MECHANISM_CLIP_PLATE_PRESSED = "pressed"
constexpr const char *	hmi::MECHANISM_CLIP_KEY_PRESENT = "present"
constexpr const char *	hmi::MECHANISM_CLIP_KEY_COLLECTED = "collected"
constexpr const char *	hmi::MECHANISM_CLIP_LOCKED_DOOR_CLOSED = "closed"
constexpr const char *	hmi::MECHANISM_CLIP_LOCKED_DOOR_OPEN = "open"

Detailed Description

Correspondance état logique d'un mécanisme → nom de clip d'animation (LOT-47 TACHE-01).