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

#include <Card.h>

类 eve::card::Card 继承关系图:

Public 成员函数
	Module_REG (Card)

	Card ()
	Declared out of line so the incomplete `CardControl` member needs no deleter here.

	~Card () override
	Card.

	Card (const Card &)=delete

Card &	operator= (const Card &)=delete

	Card (Card &&) noexcept
	Card.

Card &	operator= (Card &&) noexcept
	Operator =.

int	registerCardsFromJson (const std::string &json)
	从 JSON 注册卡牌类型；返回成功注册数量。

void	clearCardDefinitions ()
	清空全部卡牌类型定义。

int	getCardDefinitionCount ()
	已注册卡牌类型数量。

std::string	getCardDefinitionId (int index) const
	Return a definition ID in deterministic sorted order.

bool	hasCardDefinition (const std::string &id)
	卡牌类型查询。

bool	setCardDefinition (const std::string &id, const std::string &name, const std::string &kind, int cost, int attack, int health, float tintR, float tintG, float tintB)
	Insert or replace one definition for project-owned authoring tools.

bool	removeCardDefinition (const std::string &id)
	Remove one definition by stable identifier.

eve::Result< void >	setCardPlayCondition (const std::string &id, decision::Condition condition)
	Replace the side-effect-free condition required to play a definition.

std::string	getCardDefinitionName (const std::string &id)

std::string	getCardDefinitionKind (const std::string &id)
	Returns the card definition kind.

int	getCardDefinitionCost (const std::string &id)
	Returns the card definition cost.

int	getCardDefinitionAttack (const std::string &id)
	Returns the card definition attack.

int	getCardDefinitionHealth (const std::string &id)
	Returns the card definition health.

float	getCardDefinitionTintR (const std::string &id)
	Returns the card definition tint r.

float	getCardDefinitionTintG (const std::string &id)
	Returns the card definition tint g.

float	getCardDefinitionTintB (const std::string &id)
	Returns the card definition tint b.

LayoutConfig *	newConfig ()
	工厂：对象由 ECS 表持有，脚本持有的是非拥有句柄。

CardData *	newCard (const std::string &defId)
	Creates a card. @ownership Caller deletes unless documented otherwise.

Deck *	newDeck ()
	Creates a deck. @ownership Caller deletes unless documented otherwise.

Zone *	newZone (const std::string &id, const std::string &label, float x, float y, float w, float h)
	创建一个落牌区。

Hand *	newHand (LayoutConfig *cfg)
	创建一个手牌布局。

CardPlaneMapper *	newPlaneMapper ()
	Create a reusable logical-card-canvas to 3D plane mapper.

void	setConfig (LayoutConfig *cfg)
	游戏状态：当前布局、手牌、落牌区、牌库。

LayoutConfig *	getConfig () const
	Returns the config.

int	handCount () const
	Hand count.

Hand *	getHand (int index) const
	Returns the hand.

Hand *	findHand (const std::string &owner) const
	Finds hand.

int	zoneCount () const
	Zone count.

Zone *	getZone (int index) const
	Returns the zone.

Deck *	getDeck () const
	Returns the deck.

CardData *	drawCard (const std::string &handOwner)
	从牌库抽一张牌加入指定手牌；无牌时返回 nullptr。

decision::ConditionResult	evaluatePlay (const CardData *card, CardPlayConditionQueries queries={}) const
	Evaluate a card's pure play condition through the shared protocol.

eve::Result< double >	getCardAttribute (CardData &card, std::string_view attribute) const
	Read one canonical combat attribute through the Card facade.

eve::Result< void >	setCardAttribute (CardData &card, std::string_view attribute, double value) const
	Set one canonical combat attribute through the Card facade.

eve::Result< effects::EffectHandle >	applyEffect (CardData &card, const CardEffectDefinition &definition, eve::SubjectRef subject) const
	Apply a domain card effect to the card-owned lifecycle component.

eve::Result< std::size_t >	step (const eve::SimulationStep &step)
	Advance all card-owned effects and project current health.

eve::Result< eve::transaction::TransactionReceipt >	play (CardData &card, eve::resource::IResourceAccount &playerAccount, CardPlayComposition composition={}, std::string transactionId={})
	Play a card through the facade's condition, container and payment transaction.

int	capturePresentation ()
	Capture all live cards into a contiguous presentation snapshot buffer.

int	getPresentationCount () const
	Return the number of entries in the most recently captured buffer.

CardPresentationSnapshot *	getPresentation (int index)
	Return an entry from the most recently captured buffer, or nullptr.

void	update (float dt, float mx, float my, bool down)
	每帧更新布局与交互。

void	render (graphics::Graphics *gfx)
	绘制手牌/落牌区（与牌库）。

void	renderDeck (graphics::Graphics *gfx)
	Renders deck.

void	setBuiltInVisuals (bool enabled)
	Enable or disable the built-in card visuals while retaining layout and interaction.

bool	getBuiltInVisuals () const
	Return whether Card::render draws the built-in card faces.

eve::Result< void >	publishGameplay (const std::string &instanceId, const std::string &ownerId, Hand hand, eve::resource::IResourceAccount account=nullptr)
	把一副手牌发布到共享玩法协议（`eve_gameplay` / MCP）。

eve::Result< void >	unpublishGameplay (const std::string &instanceId)
	取消发布一个实例；该实例未发布（或 id 非法）时返回诊断。

void	clearGameplayControls ()
	取消发布本模块持有的全部玩法实例。

int	gameplayControlCount () const
	已发布的玩法实例数量。

std::vector< std::string >	gameplayInstances () const
	已发布的玩法实例标识（发布顺序）。

Public 成员函数继承自 eve::Module
virtual	~Module ()
	Module.

virtual std::string	getName () const =0
	Returns the name.

详细描述

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

在文件 Card.h 第 91 行定义.

构造及析构函数说明

◆ Card() [1/3]

eve::card::Card::Card ( )

default

Declared out of line so the incomplete CardControl member needs no deleter here.

◆ ~Card()

eve::card::Card::~Card ( )

override

Card.

在文件 Card.cpp 第 153 行定义.

◆ Card() [2/3]

eve::card::Card::Card ( const Card & )

delete

◆ Card() [3/3]

eve::card::Card::Card ( Card && )

defaultnoexcept

Card.

成员函数说明

◆ applyEffect()

eve::Result< effects::EffectHandle > eve::card::Card::applyEffect	(	CardData &	card,
		const CardEffectDefinition &	definition,
		eve::SubjectRef	subject
	)		const

Apply a domain card effect to the card-owned lifecycle component.

参数

card	Borrowed CardData whose Effects component owns the instance.
definition	Effect policy and card-specific interpretation.
subject	Stable subject identity used by the common effect store.

返回: Generation-qualified effect handle owned by the caller.

在文件 Card.cpp 第 307 行定义.

引用了 eve::card::CardAttributeAdapter::ensure(), eve::Diagnostic::error(), eve::Result< T >::failure(), eve::StaleHandle , 以及 subject.

◆ capturePresentation()

int eve::card::Card::capturePresentation ( )

Capture all live cards into a contiguous presentation snapshot buffer.

在文件 Card.cpp 第 518 行定义.

引用了 eve::card::cardStateName(), handle, layout , 以及 state.

◆ clearCardDefinitions()

void eve::card::Card::clearCardDefinitions ( )

清空全部卡牌类型定义。

在文件 Card.cpp 第 223 行定义.

◆ clearGameplayControls()

void eve::card::Card::clearGameplayControls ( )

取消发布本模块持有的全部玩法实例。

在文件 Card.cpp 第 191 行定义.

◆ drawCard()

CardData * eve::card::Card::drawCard ( const std::string & handOwner )

从牌库抽一张牌加入指定手牌；无牌时返回 nullptr。

在文件 Card.cpp 第 504 行定义.

引用了 c, eve::card::Deck, eve::card::LayoutConfig::deckX, eve::card::LayoutConfig::deckY, eve::card::Deck::draw(), findHand() , 以及 h.

被这些函数引用 eve::card::CardControl::submitGameplay().

◆ evaluatePlay()

decision::ConditionResult eve::card::Card::evaluatePlay	(	const CardData *	card,
		CardPlayConditionQueries	queries = `{}`
	)		const

Evaluate a card's pure play condition through the shared protocol.

参数

card	Borrowed card instance observed synchronously; it is not moved.
queries	Optional read-only resource, authority and policy providers.

返回: Stable passed/rejected result with evidence and UI details.

在文件 Card.cpp 第 286 行定义.

引用了 eve::card::CardPlayConditionAdapter::evaluate(), eve::decision::ConditionResult::failed() , 以及 eve::decision::InvalidCondition.

◆ findHand()

Hand * eve::card::Card::findHand ( const std::string & owner ) const

Finds hand.

在文件 Card.cpp 第 487 行定义.

引用了 h.

被这些函数引用 drawCard().

◆ gameplayControlCount()

int eve::card::Card::gameplayControlCount ( ) const

已发布的玩法实例数量。

在文件 Card.cpp 第 195 行定义.

◆ gameplayInstances()

std::vector< std::string > eve::card::Card::gameplayInstances ( ) const

已发布的玩法实例标识（发布顺序）。

在文件 Card.cpp 第 197 行定义.

◆ getBuiltInVisuals()

bool eve::card::Card::getBuiltInVisuals ( ) const

inline

Return whether Card::render draws the built-in card faces.

在文件 Card.h 第 273 行定义.

◆ getCardAttribute()

eve::Result< double > eve::card::Card::getCardAttribute	(	CardData &	card,
		std::string_view	attribute
	)		const

Read one canonical combat attribute through the Card facade.

参数

card	Borrowed live CardData owned by this ECS world.
attribute	Selected attribute name such as `attack` or `health`.

返回: The canonical final value, or a structured rejection.

在文件 Card.cpp 第 293 行定义.

引用了 eve::Diagnostic::error(), eve::Result< T >::failure(), eve::card::CardAttributeAdapter::read() , 以及 eve::StaleHandle.

◆ getCardDefinitionAttack()

int eve::card::Card::getCardDefinitionAttack ( const std::string & id )

Returns the card definition attack.

在文件 Card.cpp 第 369 行定义.

引用了 d.

◆ getCardDefinitionCost()

int eve::card::Card::getCardDefinitionCost ( const std::string & id )

Returns the card definition cost.

在文件 Card.cpp 第 364 行定义.

引用了 d.

◆ getCardDefinitionCount()

int eve::card::Card::getCardDefinitionCount ( )

已注册卡牌类型数量。

在文件 Card.cpp 第 229 行定义.

◆ getCardDefinitionHealth()

int eve::card::Card::getCardDefinitionHealth ( const std::string & id )

Returns the card definition health.

在文件 Card.cpp 第 374 行定义.

引用了 d.

◆ getCardDefinitionId()

std::string eve::card::Card::getCardDefinitionId ( int index ) const

Return a definition ID in deterministic sorted order.

参数

index Zero-based index in the sorted definition view.

返回: Definition ID, or an empty string when the index is invalid.

在文件 Card.cpp 第 231 行定义.

引用了 index.

◆ getCardDefinitionKind()

std::string eve::card::Card::getCardDefinitionKind ( const std::string & id )

Returns the card definition kind.

在文件 Card.cpp 第 359 行定义.

引用了 d.

◆ getCardDefinitionName()

std::string eve::card::Card::getCardDefinitionName ( const std::string & id )

在文件 Card.cpp 第 354 行定义.

引用了 d.

◆ getCardDefinitionTintB()

float eve::card::Card::getCardDefinitionTintB ( const std::string & id )

Returns the card definition tint b.

在文件 Card.cpp 第 389 行定义.

引用了 d.

◆ getCardDefinitionTintG()

float eve::card::Card::getCardDefinitionTintG ( const std::string & id )

Returns the card definition tint g.

在文件 Card.cpp 第 384 行定义.

引用了 d.

◆ getCardDefinitionTintR()

float eve::card::Card::getCardDefinitionTintR ( const std::string & id )

Returns the card definition tint r.

在文件 Card.cpp 第 379 行定义.

引用了 d.

◆ getConfig()

LayoutConfig * eve::card::Card::getConfig ( ) const

Returns the config.

在文件 Card.cpp 第 478 行定义.

◆ getDeck()

Deck * eve::card::Card::getDeck ( ) const

Returns the deck.

在文件 Card.cpp 第 502 行定义.

◆ getHand()

Hand * eve::card::Card::getHand ( int index ) const

Returns the hand.

在文件 Card.cpp 第 482 行定义.

引用了 index.

◆ getPresentation()

CardPresentationSnapshot * eve::card::Card::getPresentation ( int index )

Return an entry from the most recently captured buffer, or nullptr.

在文件 Card.cpp 第 548 行定义.

引用了 index.

◆ getPresentationCount()

int eve::card::Card::getPresentationCount ( ) const

Return the number of entries in the most recently captured buffer.

在文件 Card.cpp 第 546 行定义.

◆ getZone()

Zone * eve::card::Card::getZone ( int index ) const

Returns the zone.

在文件 Card.cpp 第 497 行定义.

引用了 index.

◆ handCount()

int eve::card::Card::handCount ( ) const

Hand count.

在文件 Card.cpp 第 480 行定义.

◆ hasCardDefinition()

bool eve::card::Card::hasCardDefinition ( const std::string & id )

卡牌类型查询。

在文件 Card.cpp 第 244 行定义.

◆ Module_REG()

eve::card::Card::Module_REG ( Card )

◆ newCard()

CardData * eve::card::Card::newCard ( const std::string & defId )

Creates a card. @ownership Caller deletes unless documented otherwise.

在文件 Card.cpp 第 406 行定义.

引用了 c, eve::card::CardData::createCard(), d, eve::card::CardAttributeAdapter::ensure(), eve::card::CardEffectTarget::health , 以及 target.

◆ newConfig()

LayoutConfig * eve::card::Card::newConfig ( )

工厂：对象由 ECS 表持有，脚本持有的是非拥有句柄。

在文件 Card.cpp 第 398 行定义.

◆ newDeck()

Deck * eve::card::Card::newDeck ( )

Creates a deck. @ownership Caller deletes unless documented otherwise.

在文件 Card.cpp 第 436 行定义.

引用了 eve::card::Deck::createDeck() , 以及 d.

◆ newHand()

Hand * eve::card::Card::newHand ( LayoutConfig * cfg )

创建一个手牌布局。

在文件 Card.cpp 第 456 行定义.

引用了 eve::card::Hand::createHand() , 以及 h.

◆ newPlaneMapper()

CardPlaneMapper * eve::card::Card::newPlaneMapper ( )

Create a reusable logical-card-canvas to 3D plane mapper.

在文件 Card.cpp 第 463 行定义.

◆ newZone()

Zone * eve::card::Card::newZone	(	const std::string &	id,
		const std::string &	label,
		float	x,
		float	y,
		float	w,
		float	h
	)

创建一个落牌区。

在文件 Card.cpp 第 443 行定义.

引用了 eve::card::Zone::createZone(), h, id, label, w, x, y , 以及 z.

◆ operator=() [1/2]

Card & eve::card::Card::operator= ( Card && )

defaultnoexcept

Operator =.

◆ operator=() [2/2]

Card & eve::card::Card::operator= ( const Card & )

delete

◆ play()

eve::Result< eve::transaction::TransactionReceipt > eve::card::Card::play	(	CardData &	card,
		eve::resource::IResourceAccount &	playerAccount,
		CardPlayComposition	composition = `{}`,
		std::string	transactionId = `{}`
	)

Play a card through the facade's condition, container and payment transaction.

参数

card	Borrowed CardData whose definition is registered by this module.
playerAccount	Borrowed authoritative player account.
composition	Optional caller-owned container/effect ports.
transactionId	Optional non-empty transaction correlation id.

返回: Committed transaction receipt, or a failure with no partial play.

在文件 Card.cpp 第 334 行定义.

引用了 eve::card::CardPlayRequest::card, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::NotFound, eve::card::CardPlayPaymentAdapter::play(), request , 以及 eve::StaleHandle.

被这些函数引用 eve::card::CardControl::submitGameplay().

◆ publishGameplay()

eve::Result< void > eve::card::Card::publishGameplay	(	const std::string &	instanceId,
		const std::string &	ownerId,
		Hand *	hand,
		eve::resource::IResourceAccount *	account = `nullptr`
	)

把一副手牌发布到共享玩法协议（eve_gameplay / MCP）。

领域动作词表就是本模块自己的操作：card:draw 走牌库到手牌的抽取， card:play 走 Card::play（条件 + 容器 + 支付事务），card:set-attribute 因为会改写权威战斗属性，只对 test-driver / developer-cheat 开放。出牌需要游戏自己的权威账户，适配器不能凭空创造：发布时可以绑定一个借用的 IResourceAccount；未绑定时 card:play 既不广播也不接受，观察结果里 payment 为 unbound，缺口是可见的而不是静默缺失。

参数

instanceId	实例稳定标识，必须是规范持久 id（UUID 文本）。
ownerId	控制该实例的玩家/角色稳定标识，同为规范持久 id。
hand	借用的一副手牌，必须比本次发布存活更久。
account	借用的玩家支付账户，可为 null。

返回: 成功返回空结果；id 非法或实例重复返回诊断。 @ownership 适配器由本模块持有并随模块销毁；hand / account 所有权不变。 @thread 所有者模拟线程。

在文件 Card.cpp 第 163 行定义.

引用了 account, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::SubjectRef::fromPersistentId(), eve::InvalidArgument , 以及 eve::detail::Id128< Tag >::parse().

◆ registerCardsFromJson()

int eve::card::Card::registerCardsFromJson ( const std::string & json )

从 JSON 注册卡牌类型；返回成功注册数量。

在文件 Card.cpp 第 208 行定义.

引用了 n, eve::json::Document::parse(), eve::json::Document::root(), root , 以及 eve::json::Document::valid().

◆ removeCardDefinition()

bool eve::card::Card::removeCardDefinition ( const std::string & id )

Remove one definition by stable identifier.

参数

id	Stable definition identifier.

返回: True when an existing definition was removed.

在文件 Card.cpp 第 263 行定义.

◆ render()

void eve::card::Card::render ( graphics::Graphics * gfx )

绘制手牌/落牌区（与牌库）。

在文件 Card.cpp 第 568 行定义.

引用了 h, eve::card::LayoutConfig::showZones , 以及 z.

◆ renderDeck()

void eve::card::Card::renderDeck ( graphics::Graphics * gfx )

Renders deck.

在文件 Card.cpp 第 628 行定义.

引用了 c, eve::card::LayoutConfig::cardH, eve::card::LayoutConfig::cardW, eve::card::Deck::count(), eve::card::LayoutConfig::deckX, eve::card::LayoutConfig::deckY, eve::graphics::Graphics::getFont(), h, eve::card::printCentered(), eve::card::renderCardBack() , 以及 w.

◆ setBuiltInVisuals()

void eve::card::Card::setBuiltInVisuals ( bool enabled )

inline

Enable or disable the built-in card visuals while retaining layout and interaction.

在文件 Card.h 第 271 行定义.

引用了 enabled.

◆ setCardAttribute()

eve::Result< void > eve::card::Card::setCardAttribute	(	CardData &	card,
		std::string_view	attribute,
		double	value
	)		const

Set one canonical combat attribute through the Card facade.

参数

card	Borrowed live CardData owned by this ECS world.
attribute	Selected attribute name such as `attack` or `health`.
value	New canonical base value.

返回: Applied, or a structured rejection without a legacy side channel.

在文件 Card.cpp 第 300 行定义.

引用了 eve::Diagnostic::error(), eve::Result< T >::failure(), eve::card::CardAttributeAdapter::setBase(), eve::StaleHandle , 以及 value.

被这些函数引用 eve::card::CardControl::submitGameplay().

◆ setCardDefinition()

bool eve::card::Card::setCardDefinition	(	const std::string &	id,
		const std::string &	name,
		const std::string &	kind,
		int	cost,
		int	attack,
		int	health,
		float	tintR,
		float	tintG,
		float	tintB
	)

Insert or replace one definition for project-owned authoring tools.

参数

id	Stable definition identifier.
name	Display name; an empty value falls back to id.
kind	Project-defined card kind; an empty value falls back to creature.
cost	Non-negative resource cost.
attack	Non-negative attack value.
health	Non-negative health value.
tintR	Red tint channel, clamped to [0, 1].
tintG	Green tint channel, clamped to [0, 1].
tintB	Blue tint channel, clamped to [0, 1].

返回: True when the definition was accepted.

在文件 Card.cpp 第 246 行定义.

引用了 cost, id, kind , 以及 name.

◆ setCardPlayCondition()

eve::Result< void > eve::card::Card::setCardPlayCondition	(	const std::string &	id,
		decision::Condition	condition
	)

Replace the side-effect-free condition required to play a definition.

参数

id	Stable card definition identifier.
condition	Owning condition tree; it is copied into the definition.

返回: Success, or NotFound/Rejected when the definition or tree is invalid.

在文件 Card.cpp 第 269 行定义.

引用了 condition, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::InvalidArgument, eve::NotFound , 以及 eve::Result< T >::success().

◆ setConfig()

void eve::card::Card::setConfig ( LayoutConfig * cfg )

游戏状态：当前布局、手牌、落牌区、牌库。

在文件 Card.cpp 第 474 行定义.

◆ step()

eve::Result< std::size_t > eve::card::Card::step ( const eve::SimulationStep & step )

Advance all card-owned effects and project current health.

参数

step	Injected deterministic simulation tick and duration.

返回: Number of settled periodic triggers, or a structured failure.

在文件 Card.cpp 第 317 行定义.

引用了 eve::Applied, eve::Result< T >::failure(), handle, eve::card::CardAttributeAdapter::healthAttribute, eve::NoOp, projected, eve::card::CardAttributeAdapter::setBase(), eve::Status::success(), eve::Result< T >::success() , 以及 updated.

◆ unpublishGameplay()

eve::Result< void > eve::card::Card::unpublishGameplay ( const std::string & instanceId )

取消发布一个实例；该实例未发布（或 id 非法）时返回诊断。

在文件 Card.cpp 第 180 行定义.

引用了 eve::Diagnostic::error(), eve::Result< T >::failure(), eve::SubjectRef::fromPersistentId(), eve::InvalidArgument, eve::NotFound , 以及 eve::detail::Id128< Tag >::parse().

◆ update()

void eve::card::Card::update	(	float	dt,
		float	mx,
		float	my,
		bool	down
	)

每帧更新布局与交互。

在文件 Card.cpp 第 557 行定义.

引用了 h , 以及 z.

◆ zoneCount()

int eve::card::Card::zoneCount ( ) const

Zone count.

在文件 Card.cpp 第 495 行定义.

该类的文档由以下文件生成:

src/modules/card/Card.h
src/modules/card/Card.cpp

Public 成员函数

详细描述

构造及析构函数说明

◆ Card() [1/3]

◆ ~Card()

◆ Card() [2/3]

◆ Card() [3/3]

成员函数说明

◆ applyEffect()

◆ capturePresentation()

◆ clearCardDefinitions()

◆ clearGameplayControls()

◆ drawCard()

◆ evaluatePlay()

◆ findHand()

◆ gameplayControlCount()

◆ gameplayInstances()

◆ getBuiltInVisuals()

◆ getCardAttribute()

◆ getCardDefinitionAttack()

◆ getCardDefinitionCost()

◆ getCardDefinitionCount()

◆ getCardDefinitionHealth()

◆ getCardDefinitionId()

◆ getCardDefinitionKind()

◆ getCardDefinitionName()

◆ getCardDefinitionTintB()

◆ getCardDefinitionTintG()

◆ getCardDefinitionTintR()

◆ getConfig()

◆ getDeck()

◆ getHand()

◆ getPresentation()

◆ getPresentationCount()

◆ getZone()

◆ handCount()

◆ hasCardDefinition()

◆ Module_REG()

◆ newCard()

◆ newConfig()

◆ newDeck()

◆ newHand()

◆ newPlaneMapper()

◆ newZone()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ play()

◆ publishGameplay()

◆ registerCardsFromJson()

◆ removeCardDefinition()

◆ render()

◆ renderDeck()

◆ setBuiltInVisuals()

◆ setCardAttribute()

◆ setCardDefinition()

◆ setCardPlayCondition()

◆ setConfig()

◆ step()

◆ unpublishGameplay()

◆ update()

◆ zoneCount()