类
class	Card
	卡牌模块入口（eve.Card）：定义注册、对象工厂与每帧 update/render。更多...

class	CardAttributeAdapter
	Adapts CardData's attack/health values to the canonical AttributeSet. 更多...

class	CardContainerAdapter
	Exposes one card collection through the generic atomic transfer API. 更多...

struct	CardContainerObject
	Generation-qualified reference to one CardData object. 更多...

class	CardControl
	Exposes published card hands through the shared gameplay protocol. 更多...

class	CardData
	单张卡牌：ECS 实体，数据拆成 Identity / Stats / Visual / Layout / State。更多...

struct	CardDefinition
	卡牌类型定义（registerCardsFromJson 注册）。更多...

class	CardDefinitionRuntime
	Binds a typed card runtime to one Definitions registry incarnation. 更多...

class	CardEffectAdapter
	Card adapter composing the common lifecycle container with CardEffectExecutor. 更多...

struct	CardEffectDefinition
	Strong card definition projected into the common effect definition. 更多...

class	CardEffectExecutor
	Card executor: interprets card policy without owning effect instances. 更多...

struct	CardEffectSnapshot
	Serializable in-memory card effect snapshot. 更多...

struct	CardEffectTarget
	Mutable card combat state changed by the card effect executor. 更多...

struct	CardEffectUpdate
	Result of one card effect lifecycle step and its domain settlement. 更多...

struct	CardEvent
	一次交互事件。更多...

class	CardPlaneMapper
	Maps a logical card canvas to a 3D parallelogram without depending on graphics. 更多...

struct	CardPlayComposition
	Optional cross-domain operations that belong to one card play. 更多...

class	CardPlayConditionAdapter
	Evaluates one card play condition without moving or mutating a card. 更多...

class	CardPlayConditionContext
	Read-only EvaluationContext backed by one card instance and definition. 更多...

struct	CardPlayConditionQueries
	Read-only extension points used while evaluating a card play. 更多...

class	CardPlayParticipant
	Transaction participant that publishes one CardData play. 更多...

class	CardPlayPaymentAdapter
	Connects a card's mana field to the owning player's resource account. 更多...

struct	CardPlayRequest
	Complete caller-owned input for one atomic card play. 更多...

struct	CardPresentationSnapshot
	Immutable presentation data captured from one card for external 2D/3D adapters. 更多...

struct	CardRuntimeState
	Typed mutable values owned by one card definition instance. 更多...

class	Deck
	牌库（栈顶在末尾）。更多...

class	Hand
	手牌：扇形布局 + 悬浮 + 拖拽 + 落区判定 + 渲染。更多...

struct	LayoutConfig
	UiCard 风格的布局配置（脚本可实时修改，对应 UiCard 的 Configs 面板）。更多...

class	Zone
	落牌区（手牌区 / 出牌区 / 弃牌区），用于拖放命中判定。更多...

枚举
enum class	CardContainerKind : std::uint8_t { Deck , Hand , Discard }
	CardContainerKind public API. 更多...

enum class	CardEffectKind : std::uint8_t { Damage , Heal , Shield }
	Card-specific interpretation of an effect magnitude. 更多...

enum class	CardState : uint8_t { Deck , Hand , Hovered , Dragging , Returning , Played , Discarded , Disabled }
	单张卡牌的运行时状态。更多...

函数
	Module_IMPL (Card, new Card())

EVENGINE_API_WORLD bool	captureCardState (StateValue &out)
	Compatibility facade for CardData/Hand interaction-state serialization during state hot reload.

EVENGINE_API_WORLD bool	restoreCardState (const StateValue &in, std::string *err=nullptr)
	Restore card state.

EVENGINE_API_WORLD bool	resetCardState ()
	Resets card state.

const char *	cardStateName (CardState state)
	状态枚举的字符串名（用于脚本/调试）。

void	printCentered (graphics::Graphics *gfx, const std::string &text, float cx, float cy, float scale, const glm::vec4 &color)
	渲染辅助（也供 Zone / Deck 复用）。

void	renderCardBack (graphics::Graphics *gfx, float x, float y, float w, float h, float angle, float a)
	绘制牌背。

void	renderCard (graphics::Graphics *gfx, const CardData &card, const LayoutConfig &cfg, bool back)
	绘制单张卡牌（正面或牌背）。

枚举类型说明

◆ CardContainerKind

enum class eve::card::CardContainerKind : std::uint8_t

strong

CardContainerKind public API.

枚举值
Deck
Hand
Discard

在文件 CardContainers.h 第 23 行定义.

◆ CardEffectKind

enum class eve::card::CardEffectKind : std::uint8_t

strong

Card-specific interpretation of an effect magnitude.

枚举值
Damage
Heal
Shield

在文件 CardEffects.h 第 29 行定义.

◆ CardState

enum class eve::card::CardState : uint8_t

strong

单张卡牌的运行时状态。

枚举值
Deck
Hand
Hovered
Dragging
Returning
Played
Discarded
Disabled

在文件 CardTypes.h 第 31 行定义.

函数说明

◆ captureCardState()

bool eve::card::captureCardState ( StateValue & out )

Compatibility facade for CardData/Hand interaction-state serialization during state hot reload.

Captures each card's structural phase (deck/hand/played/discarded/disabled/ returning). Transient hover/drag interaction is dropped on restore. The bool result is kept for the StateProvider compatibility surface; new state systems should expose structured Result diagnostics at their module boundary.

在文件 CardStateProvider.cpp 第 43 行定义.

引用了 eve::StateValue::array(), cardStateName(), id, eve::StateValue::object(), eve::StateValue::pushBack(), eve::StateValue::set(), eve::StateValue::string() , 以及 view.