#include <PlacementSystem.h>

类
struct	PlacementHit

Public 类型
using	ValidateFn = std::function< bool(const PlacementWorld &world, const PlacementQuery &q, std::string *reason)>

using	SnapFn = std::function< SnapResult(const PlacementWorld &world, float worldX, float worldY)>

using	ChangeHook = std::function< void(const BuildingChangeEvent &ev)>

using	SurfaceFn = std::function< bool(const PlacementWorld &world, float x, float y, PlacementHit *hit)>

静态 Public 成员函数
static PlacementSystem &	inst ()
	Process singleton holding all PlacementSystem state.

static void	registerValidateRule (const std::string &name, ValidateFn fn)

static void	unregisterValidateRule (const std::string &name)

static bool	hasValidateRule (const std::string &name)

static void	registerSnapRule (const std::string &name, SnapFn fn)

static void	unregisterSnapRule (const std::string &name)

static bool	hasSnapRule (const std::string &name)

static void	registerChangeHook (const std::string &name, ChangeHook fn)

static void	unregisterChangeHook (const std::string &name)

static bool	hasChangeHook (const std::string &name)

static void	registerSurface (const std::string &name, SurfaceFn fn)

static void	unregisterSurface (const std::string &name)

static bool	hasSurface (const std::string &name)

static bool	surfaceHit (const PlacementWorld &world, const std::string &name, float x, float y, PlacementHit *hit)

static std::vector< std::string >	surfaceNames ()

static void	setPlaneSurfaceHeight (float h)

static float	getPlaneSurfaceHeight ()

static void	ensureBuiltins ()
	确保内置规则已注册（模块首次使用时自动调用）。

static SnapResult	snap (const PlacementWorld &world, const std::string &buildingId, float worldX, float worldY)

static SnapResult	snap3D (const PlacementWorld &world, const std::string &buildingId, float worldX, float worldY, float worldZ)

static SnapResult	snapWithMode (const PlacementWorld &world, const std::string &mode, float worldX, float worldY)

static float	normalizeRotation (const std::string &buildingId, float rotationDeg)
	规范化旋转角（cardinal → 0/90/180/270；none → 0）。

static void	effectiveFootprint (const BuildingDefinition &def, float rotationDeg, int outW, int outH)
	旋转后的占地宽高（cardinal 90/270 交换）。

static bool	foreachFootprintCell (const BuildingDefinition &def, int originCellX, int originCellY, float rotationDeg, const std::function< bool(int cx, int cy)> &fn)
	枚举占地格子（旋转后局部 → 世界格子）。返回 false 若定义未知。

static bool	canPlace (PlacementWorld world, const std::string &buildingId, int cellX, int cellY, float rotationDeg=0.f, int excludeInstanceId=0, std::string reason=nullptr)

static bool	canPlaceElev (PlacementWorld world, const std::string &buildingId, int cellX, int cellY, float elevation, float rotationDeg=0.f, int excludeInstanceId=0, std::string reason=nullptr)

static int	placeAt (PlacementWorld *world, const std::string &buildingId, int cellX, int cellY, float rotationDeg=0.f)
	成功返回 instanceId；失败返回 0。

static int	placeAtWorld (PlacementWorld *world, const std::string &buildingId, float worldX, float worldY, float rotationDeg=0.f)
	先吸附再放置；free/自定义 snap 会保留吸附后的世界坐标。

static int	placeAtWorld3D (PlacementWorld *world, const std::string &buildingId, float worldX, float worldY, float worldZ, float rotationDeg=0.f)

static int	placeGhost (PlacementWorld world, Ghost ghost)

static bool	removeBuilding (PlacementWorld *world, int instanceId)

static bool	moveBuilding (PlacementWorld *world, int instanceId, int cellX, int cellY, float rotationDeg=-1.f)

static void	clearBuildings (PlacementWorld *world)

static void	pushEvent (BuildingChangeEvent ev)

static void	pollEvents (std::vector< BuildingChangeEvent > &out)

static void	clearEvents ()

static const std::vector< BuildingChangeEvent > &	events ()

static int	nextInstanceId ()

详细描述

在文件 PlacementSystem.h 第 19 行定义.

成员类型定义说明

◆ ChangeHook

using eve::building::PlacementSystem::ChangeHook = std::function<void(const BuildingChangeEvent &ev)>

在文件 PlacementSystem.h 第 25 行定义.

◆ SnapFn

using eve::building::PlacementSystem::SnapFn = std::function<SnapResult(const PlacementWorld &world, float worldX, float worldY)>

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

◆ SurfaceFn

using eve::building::PlacementSystem::SurfaceFn = std::function<bool(const PlacementWorld &world, float x, float y, PlacementHit *hit)>

放置表面：把指针坐标（2D 场景为鼠标世界坐标；3D 场景由游戏自行做射线/高度采样后传入平面坐标）换算成真实世界命中点。引擎只提供接口 + 内置 "plane"（Y=常数平面），物理射线 / 高度场等表面由游戏侧按接口实现。

在文件 PlacementSystem.h 第 39 行定义.

◆ ValidateFn

using eve::building::PlacementSystem::ValidateFn = std::function<bool(const PlacementWorld &world, const PlacementQuery &q, std::string *reason)>

在文件 PlacementSystem.h 第 21 行定义.

成员函数说明

◆ canPlace()

bool eve::building::PlacementSystem::canPlace	(	PlacementWorld *	world,
		const std::string &	buildingId,
		int	cellX,
		int	cellY,
		float	rotationDeg = `0.f`,
		int	excludeInstanceId = `0`,
		std::string *	reason = `nullptr`
	)

static

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

被这些函数引用 eve::building::PlacementWorld::canPlace() , 以及 eve::building::PlacementWorld::canPlaceReason().

◆ canPlaceElev()

bool eve::building::PlacementSystem::canPlaceElev	(	PlacementWorld *	world,
		const std::string &	buildingId,
		int	cellX,
		int	cellY,
		float	elevation,
		float	rotationDeg = `0.f`,
		int	excludeInstanceId = `0`,
		std::string *	reason = `nullptr`
	)

static

带 elevation 的校验（校验语义仍按 2D 占用/地形，elevation 只进 query 上下文）。

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

引用了 eve::building::PlacementQuery::buildingId, eve::building::PlacementWorld::cellToWorldPlane(), eve::building::PlacementQuery::cellX, eve::building::PlacementQuery::cellY, eve::building::PlacementQuery::elevation, eve::building::PlacementQuery::excludeInstanceId, eve::building::PlacementQuery::rotationDeg, eve::building::PlacementQuery::worldX , 以及 eve::building::PlacementQuery::worldY.

被这些函数引用 eve::building::Ghost::validate().

◆ clearBuildings()

void eve::building::PlacementSystem::clearBuildings ( PlacementWorld * world )

static

在文件 PlacementSystem.cpp 第 676 行定义.

引用了 eve::building::PlacementWorld::allChannels() , 以及 eve::building::PlacementWorld::buildings().

被这些函数引用 eve::building::PlacementWorld::clearBuildings().

◆ clearEvents()

void eve::building::PlacementSystem::clearEvents ( )

static

在文件 PlacementSystem.cpp 第 233 行定义.

被这些函数引用 eve::building::Building::clearChangeEvents().

◆ effectiveFootprint()

void eve::building::PlacementSystem::effectiveFootprint	(	const BuildingDefinition &	def,
		float	rotationDeg,
		int *	outW,
		int *	outH
	)

static

旋转后的占地宽高（cardinal 90/270 交换）。

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

引用了 eve::building::BuildingDefinition::footprintH, eve::building::BuildingDefinition::footprintMask, eve::building::BuildingDefinition::footprintW, h, eve::grid::rotatedFootprintSize(), eve::building::BuildingDefinition::rotationMode , 以及 w.

被这些函数引用 eve::buildingfx::BuildingFx::updateGhost().

◆ ensureBuiltins()

void eve::building::PlacementSystem::ensureBuiltins ( )

static

确保内置规则已注册（模块首次使用时自动调用）。

在文件 PlacementSystem.cpp 第 136 行定义.

被这些函数引用 hasSnapRule(), hasSurface(), hasValidateRule(), eve::building::Building::newGhost(), eve::building::Building::newSession(), eve::building::Building::newWorld(), eve::building::PlacementWorld::PlacementWorld(), eve::building::Building::registerBuildingsFromJson(), snap(), snapWithMode(), surfaceHit() , 以及 surfaceNames().

◆ events()

const std::vector< BuildingChangeEvent > & eve::building::PlacementSystem::events ( )

static

在文件 PlacementSystem.cpp 第 235 行定义.

◆ foreachFootprintCell()

bool eve::building::PlacementSystem::foreachFootprintCell	(	const BuildingDefinition &	def,
		int	originCellX,
		int	originCellY,
		float	rotationDeg,
		const std::function< bool(int cx, int cy)> &	fn
	)

static

枚举占地格子（旋转后局部 → 世界格子）。返回 false 若定义未知。

在文件 PlacementSystem.cpp 第 316 行定义.

引用了 fn, eve::building::BuildingDefinition::footprintH, eve::building::BuildingDefinition::footprintMask, eve::building::BuildingDefinition::footprintW, eve::grid::foreachRotatedFootprint(), ok , 以及 eve::building::BuildingDefinition::rotationMode.

◆ getPlaneSurfaceHeight()

float eve::building::PlacementSystem::getPlaneSurfaceHeight ( )

static

在文件 PlacementSystem.cpp 第 130 行定义.

被这些函数引用 eve::building::Building::getPlaneSurfaceHeight().

◆ hasChangeHook()

bool eve::building::PlacementSystem::hasChangeHook ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 95 行定义.

引用了 name.

◆ hasSnapRule()

bool eve::building::PlacementSystem::hasSnapRule ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 83 行定义.

引用了 ensureBuiltins() , 以及 name.

被这些函数引用 eve::building::Building::hasSnapRule().

◆ hasSurface()

bool eve::building::PlacementSystem::hasSurface ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 106 行定义.

引用了 ensureBuiltins() , 以及 name.

被这些函数引用 eve::building::Building::hasSurface().

◆ hasValidateRule()

bool eve::building::PlacementSystem::hasValidateRule ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 71 行定义.

引用了 ensureBuiltins() , 以及 name.

被这些函数引用 eve::building::Building::hasValidateRule().

◆ inst()

PlacementSystem & eve::building::PlacementSystem::inst ( )

static

Process singleton holding all PlacementSystem state.

Rules / hooks / events / counters used to live in one function-local static per accessor, which made the state invisible, non-destructible and hard to reason about across hot-reload and tests. State now lives in this single instance's members; the static API below delegates to it.

在文件 PlacementSystem.cpp 第 29 行定义.

◆ moveBuilding()

bool eve::building::PlacementSystem::moveBuilding	(	PlacementWorld *	world,
		int	instanceId,
		int	cellX,
		int	cellY,
		float	rotationDeg = `-1.f`
	)

static

在文件 PlacementSystem.cpp 第 635 行定义.

被这些函数引用 eve::building::PlacementWorld::moveBuilding().

◆ nextInstanceId()

int eve::building::PlacementSystem::nextInstanceId ( )

static

在文件 PlacementSystem.cpp 第 224 行定义.

◆ normalizeRotation()

float eve::building::PlacementSystem::normalizeRotation	(	const std::string &	buildingId,
		float	rotationDeg
	)

static

规范化旋转角（cardinal → 0/90/180/270；none → 0）。

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

引用了 d, eve::building::BuildingRegistry::find() , 以及 eve::building::BuildingDefinition::rotationMode.

被这些函数引用 eve::building::Ghost::validate().

◆ placeAt()

int eve::building::PlacementSystem::placeAt	(	PlacementWorld *	world,
		const std::string &	buildingId,
		int	cellX,
		int	cellY,
		float	rotationDeg = `0.f`
	)

static

成功返回 instanceId；失败返回 0。

在文件 PlacementSystem.cpp 第 520 行定义.

被这些函数引用 eve::building::PlacementWorld::placeAt().

◆ placeAtWorld()

int eve::building::PlacementSystem::placeAtWorld	(	PlacementWorld *	world,
		const std::string &	buildingId,
		float	worldX,
		float	worldY,
		float	rotationDeg = `0.f`
	)

static

先吸附再放置；free/自定义 snap 会保留吸附后的世界坐标。

在文件 PlacementSystem.cpp 第 560 行定义.

引用了 eve::building::PlacementWorld::buildings(), id , 以及 s.

被这些函数引用 eve::building::PlacementWorld::placeAtWorld().

◆ placeAtWorld3D()

int eve::building::PlacementSystem::placeAtWorld3D	(	PlacementWorld *	world,
		const std::string &	buildingId,
		float	worldX,
		float	worldY,
		float	worldZ,
		float	rotationDeg = `0.f`
	)

static

3D 版本：真实世界坐标 (wx, wy, wz)，按平面轴吸附后放置。

在文件 PlacementSystem.cpp 第 576 行定义.

引用了 eve::building::PlacementWorld::buildings(), id , 以及 s.

被这些函数引用 eve::building::PlacementWorld::placeAtWorld3D().

◆ placeGhost()

int eve::building::PlacementSystem::placeGhost	(	PlacementWorld *	world,
		Ghost *	ghost
	)

static

在文件 PlacementSystem.cpp 第 593 行定义.

引用了 eve::building::PlacementWorld::buildings(), eve::building::Ghost::getBuildingId(), eve::building::Ghost::getCellX(), eve::building::Ghost::getCellY(), eve::building::Ghost::getElevation(), eve::building::Ghost::getRotationDeg(), eve::building::Ghost::getWorldX(), eve::building::Ghost::getWorldY(), id , 以及 eve::building::Ghost::validate().

被这些函数引用 eve::building::PlacementWorld::placeGhost().

◆ pollEvents()

void eve::building::PlacementSystem::pollEvents ( std::vector< BuildingChangeEvent > & out )

static

在文件 PlacementSystem.cpp 第 228 行定义.

◆ pushEvent()

void eve::building::PlacementSystem::pushEvent ( BuildingChangeEvent ev )

static

在文件 PlacementSystem.cpp 第 226 行定义.

◆ registerChangeHook()

void eve::building::PlacementSystem::registerChangeHook	(	const std::string &	name,
		ChangeHook	fn
	)

static

在文件 PlacementSystem.cpp 第 88 行定义.

引用了 fn , 以及 name.

◆ registerSnapRule()

void eve::building::PlacementSystem::registerSnapRule	(	const std::string &	name,
		SnapFn	fn
	)

static

在文件 PlacementSystem.cpp 第 76 行定义.

引用了 fn , 以及 name.

被这些函数引用 ensureBuiltins().

◆ registerSurface()

void eve::building::PlacementSystem::registerSurface	(	const std::string &	name,
		SurfaceFn	fn
	)

static

在文件 PlacementSystem.cpp 第 99 行定义.

引用了 fn , 以及 name.

被这些函数引用 ensureBuiltins().

◆ registerValidateRule()

void eve::building::PlacementSystem::registerValidateRule	(	const std::string &	name,
		ValidateFn	fn
	)

static

在文件 PlacementSystem.cpp 第 62 行定义.

引用了 fn , 以及 name.

被这些函数引用 ensureBuiltins().

◆ removeBuilding()

bool eve::building::PlacementSystem::removeBuilding	(	PlacementWorld *	world,
		int	instanceId
	)

static

在文件 PlacementSystem.cpp 第 609 行定义.

被这些函数引用 eve::building::PlacementWorld::removeBuilding().

◆ setPlaneSurfaceHeight()

void eve::building::PlacementSystem::setPlaneSurfaceHeight ( float h )

static

内置 "plane" 表面的常量高度（默认 0）。

在文件 PlacementSystem.cpp 第 128 行定义.

引用了 h.

被这些函数引用 eve::building::Building::setPlaneSurfaceHeight().

◆ snap()

SnapResult eve::building::PlacementSystem::snap	(	const PlacementWorld &	world,
		const std::string &	buildingId,
		float	worldX,
		float	worldY
	)

static

在文件 PlacementSystem.cpp 第 261 行定义.

引用了 ensureBuiltins(), eve::building::BuildingRegistry::find(), eve::building::PlacementWorld::getSnapMode() , 以及 snapWithMode().

被这些函数引用 eve::building::Ghost::setFromWorld() , 以及 snap3D().

◆ snap3D()

SnapResult eve::building::PlacementSystem::snap3D	(	const PlacementWorld &	world,
		const std::string &	buildingId,
		float	worldX,
		float	worldY,
		float	worldZ
	)

static

3D 版本：按世界平面轴把 (wx, wy, wz) 映射到网格平面坐标再吸附。

在文件 PlacementSystem.cpp 第 271 行定义.

引用了 eve::building::PlacementWorld::getGrid(), eve::grid::GridConfig::plane, px, s, snap() , 以及 eve::grid::XZ.

被这些函数引用 eve::building::Ghost::setFromWorld3D().

◆ snapWithMode()

SnapResult eve::building::PlacementSystem::snapWithMode	(	const PlacementWorld &	world,
		const std::string &	mode,
		float	worldX,
		float	worldY
	)

static

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

引用了 eve::building::PlacementWorld::cellToWorldX(), eve::building::PlacementWorld::cellToWorldY(), eve::building::SnapResult::cellX, eve::building::SnapResult::cellY, ensureBuiltins(), eve::building::PlacementWorld::worldToCellX(), eve::building::PlacementWorld::worldToCellY(), eve::building::SnapResult::worldX , 以及 eve::building::SnapResult::worldY.

被这些函数引用 snap().

◆ surfaceHit()

bool eve::building::PlacementSystem::surfaceHit	(	const PlacementWorld &	world,
		const std::string &	name,
		float	x,
		float	y,
		PlacementHit *	hit
	)

static

在文件 PlacementSystem.cpp 第 111 行定义.

引用了 ensureBuiltins(), name, x , 以及 y.

被这些函数引用 eve::building::Ghost::setFromSurface().

◆ surfaceNames()

std::vector< std::string > eve::building::PlacementSystem::surfaceNames ( )

static

在文件 PlacementSystem.cpp 第 120 行定义.

引用了 ensureBuiltins().

被这些函数引用 eve::building::Building::getSurfaceCount() , 以及 eve::building::Building::getSurfaceName().

◆ unregisterChangeHook()

void eve::building::PlacementSystem::unregisterChangeHook ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 93 行定义.

引用了 name.

◆ unregisterSnapRule()

void eve::building::PlacementSystem::unregisterSnapRule ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 81 行定义.

引用了 name.

◆ unregisterSurface()

void eve::building::PlacementSystem::unregisterSurface ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 104 行定义.

引用了 name.

◆ unregisterValidateRule()

void eve::building::PlacementSystem::unregisterValidateRule ( const std::string & name )

static

在文件 PlacementSystem.cpp 第 67 行定义.

引用了 name.

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

src/modules/building/PlacementSystem.h
src/modules/building/PlacementSystem.cpp

类

Public 类型

静态 Public 成员函数

详细描述

成员类型定义说明

◆ ChangeHook

◆ SnapFn

◆ SurfaceFn

◆ ValidateFn

成员函数说明

◆ canPlace()

◆ canPlaceElev()

◆ clearBuildings()

◆ clearEvents()

◆ effectiveFootprint()

◆ ensureBuiltins()

◆ events()

◆ foreachFootprintCell()

◆ getPlaneSurfaceHeight()

◆ hasChangeHook()

◆ hasSnapRule()

◆ hasSurface()

◆ hasValidateRule()

◆ inst()

◆ moveBuilding()

◆ nextInstanceId()

◆ normalizeRotation()

◆ placeAt()

◆ placeAtWorld()

◆ placeAtWorld3D()

◆ placeGhost()

◆ pollEvents()

◆ pushEvent()

◆ registerChangeHook()

◆ registerSnapRule()

◆ registerSurface()

◆ registerValidateRule()

◆ removeBuilding()

◆ setPlaneSurfaceHeight()

◆ snap()

◆ snap3D()

◆ snapWithMode()

◆ surfaceHit()

◆ surfaceNames()

◆ unregisterChangeHook()

◆ unregisterSnapRule()

◆ unregisterSurface()

◆ unregisterValidateRule()