Main-thread-affine control surface shared by editor, CLI and MCP adapters. 更多...

#include <PixelWorldControl.h>

类
struct	Impl

Public 成员函数
std::vector< PixelWorldSummary >	worlds () const
	Return canonical world-id-ordered summaries of all live worlds.

eve::Result< PixelWorldSummary >	world (std::uint64_t worldId) const
	Query one live world summary.

eve::Result< void >	setPaused (std::uint64_t worldId, bool paused)
	Pause or resume one live world.

eve::Result< PixelWorldStepReceipt >	step (std::uint64_t worldId, std::uint32_t count=1)
	Advance a live world explicitly even while paused; count is limited to 1024.

eve::Result< PixelEditReceipt >	applyEdit (std::uint64_t worldId, const PixelEditCommand &command)
	Apply the world's canonical strictly sequenced edit operation.

eve::Result< PixelCatalogReloadReceipt >	reloadMaterialCatalog (std::uint64_t worldId, std::string_view catalogJson, std::uint64_t expectedFingerprint)
	Validate JSON and transactionally hot-reload a compatible paused world Catalog.

eve::Result< std::vector< PixelChunkDiagnostic > >	chunkDiagnostics (std::uint64_t worldId, PixelChunkRegion region) const
	Copy a bounded read-only Chunk diagnostic region.

eve::Result< std::vector< PixelWorldPerformanceSample > >	performanceSamples (std::uint64_t worldId, std::uint32_t limit=120) const
	Copy up to the latest 256 simulation performance samples.

eve::Result< std::vector< std::byte > >	captureSnapshot (std::uint64_t worldId) const
	Capture an owning canonical world snapshot.

eve::Result< void >	restoreSnapshot (std::uint64_t worldId, std::span< const std::byte > bytes)
	Transactionally restore a captured world snapshot.

友元
class	PixelWorld

详细描述

Main-thread-affine control surface shared by editor, CLI and MCP adapters.

备注: The service borrows live worlds only while they are registered by their constructors. PixelWorld destruction and move rebinding prevent stale retention.

在文件 PixelWorldControl.h 第 47 行定义.

成员函数说明

◆ applyEdit()

eve::Result< PixelEditReceipt > eve::pixelworld::PixelWorldControlService::applyEdit	(	std::uint64_t	worldId,
		const PixelEditCommand &	command
	)

Apply the world's canonical strictly sequenced edit operation.

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

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

◆ captureSnapshot()

eve::Result< std::vector< std::byte > > eve::pixelworld::PixelWorldControlService::captureSnapshot ( std::uint64_t worldId ) const

Capture an owning canonical world snapshot.

在文件 PixelWorldControl.cpp 第 169 行定义.

引用了 eve::Diagnostic::error(), eve::NotFound , 以及 value.

◆ chunkDiagnostics()

eve::Result< std::vector< PixelChunkDiagnostic > > eve::pixelworld::PixelWorldControlService::chunkDiagnostics	(	std::uint64_t	worldId,
		PixelChunkRegion	region
	)		const

Copy a bounded read-only Chunk diagnostic region.

在文件 PixelWorldControl.cpp 第 141 行定义.

引用了 eve::Diagnostic::error(), eve::NotFound , 以及 value.

◆ performanceSamples()

eve::Result< std::vector< PixelWorldPerformanceSample > > eve::pixelworld::PixelWorldControlService::performanceSamples	(	std::uint64_t	worldId,
		std::uint32_t	limit = `120`
	)		const

Copy up to the latest 256 simulation performance samples.

在文件 PixelWorldControl.cpp 第 150 行定义.

引用了 begin, eve::Diagnostic::error(), found, eve::InvalidArgument, limit, eve::NotFound , 以及 eve::pixelworld::PixelWorldControlService::Impl::samples.

被这些函数引用 eve::pixelworld_graphics::PixelWorldAtlasRenderer::drawDiagnostics().

◆ reloadMaterialCatalog()

eve::Result< PixelCatalogReloadReceipt > eve::pixelworld::PixelWorldControlService::reloadMaterialCatalog	(	std::uint64_t	worldId,
		std::string_view	catalogJson,
		std::uint64_t	expectedFingerprint
	)

Validate JSON and transactionally hot-reload a compatible paused world Catalog.

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

引用了 eve::pixelworld::decodeMaterialCatalogJson(), eve::Diagnostic::error(), eve::Result< T >::failure(), eve::NotFound , 以及 value.

被这些函数引用 eve::pixelworld_editor::PixelWorldCatalogPanel::apply().

◆ restoreSnapshot()

eve::Result< void > eve::pixelworld::PixelWorldControlService::restoreSnapshot	(	std::uint64_t	worldId,
		std::span< const std::byte >	bytes
	)

Transactionally restore a captured world snapshot.

在文件 PixelWorldControl.cpp 第 177 行定义.

引用了 bytes, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::NotFound , 以及 value.

◆ setPaused()

eve::Result< void > eve::pixelworld::PixelWorldControlService::setPaused	(	std::uint64_t	worldId,
		bool	paused
	)

Pause or resume one live world.

在文件 PixelWorldControl.cpp 第 84 行定义.

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

◆ step()

eve::Result< PixelWorldStepReceipt > eve::pixelworld::PixelWorldControlService::step	(	std::uint64_t	worldId,
		std::uint32_t	count = `1`
	)

Advance a live world explicitly even while paused; count is limited to 1024.

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

引用了 count, eve::pixelworld::PixelWorldStepReceipt::elapsedMicroseconds, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::pixelworld::PixelWorldStepReceipt::finalStep, eve::pixelworld::PixelWorldStepReceipt::firstTick, index, eve::InvalidArgument, eve::pixelworld::PixelWorldStepReceipt::lastTick, eve::NotFound, start, eve::pixelworld::PixelWorldStepReceipt::steps, eve::Result< T >::success(), value , 以及 eve::pixelworld::PixelWorldStepReceipt::world.

◆ world()

eve::Result< PixelWorldSummary > eve::pixelworld::PixelWorldControlService::world ( std::uint64_t worldId ) const

Query one live world summary.

在文件 PixelWorldControl.cpp 第 77 行定义.

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

◆ worlds()

std::vector< PixelWorldSummary > eve::pixelworld::PixelWorldControlService::worlds ( ) const

Return canonical world-id-ordered summaries of all live worlds.

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

引用了 a, b, world, eve::pixelworld::PixelWorldControlService::Impl::worlds , 以及 worlds().

被这些函数引用 worlds().

友元及相关函数文档

◆ PixelWorld

friend class PixelWorld

friend

在文件 PixelWorldControl.h 第 78 行定义.

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

src/modules/pixelworld/PixelWorldControl.h
src/modules/pixelworld/PixelWorldControl.cpp

类

Public 成员函数

友元