类
class	MaterialCatalog
	Owning immutable material and reaction table used by one PixelWorld. 更多...

struct	MaterialDefinition
	Immutable validated properties for one catalog material. 更多...

struct	MaterialPhaseRule
	Data-driven phase transition evaluated after heat diffusion. 更多...

struct	MaterialReactionRule
	Deterministically ordered binary material reaction. 更多...

struct	PixelCatalogReloadReceipt
	Receipt for one transactional compatible material Catalog hot reload. 更多...

struct	PixelCell
	Compact authoritative state for one simulated world pixel. 更多...

struct	PixelChunkApplyReceipt
	Receipt for one all-or-nothing authoritative Chunk batch application. 更多...

struct	PixelChunkBatch
	Owning authoritative Chunk correction with source world metadata. 更多...

struct	PixelChunkDiagnostic
	Read-only per-Chunk simulation diagnostics for tooling and overlays. 更多...

struct	PixelChunkRegion
	Inclusive finite rectangle expressed in Chunk coordinates. 更多...

struct	PixelChunkSnapshot
	Owning, immutable projection of one authoritative simulation chunk. 更多...

struct	PixelEditCommand
	Owning replayable edit command. Sequence must be exactly previous + 1. 更多...

struct	PixelEditReceipt
	Deterministic receipt for one atomically accepted edit command. 更多...

struct	PixelFragment
	Owning material bitmap detached atomically from a PixelWorld. 更多...

struct	PixelFragmentRasterReceipt
	Receipt for one all-or-nothing fragment rasterization. 更多...

struct	PixelGeneratedChunkSummary
	Deterministic diagnostics for one generated Chunk. 更多...

struct	PixelMaterialStamp
	Owning row-major material stamp applied after terrain and cave generation. 更多...

struct	PixelRegion
	Finite inclusive world-space rectangle used by structural queries. 更多...

class	PixelWorkScheduler
	Synchronous executor for owning PixelWorld candidate buffers. 更多...

class	PixelWorld
	Sparse, chunked, deterministic 2D falling-material world. 更多...

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

struct	PixelWorldGenerationOutput
	Owning generated correction plus reproducibility evidence. 更多...

struct	PixelWorldGenerationRequest
	Versioned bounded request for deterministic biome and cave generation. 更多...

struct	PixelWorldLink
	Runtime identity of the world epoch from which a fragment was detached. 更多...

class	PixelWorldModule
	Script-facing owner/factory for deterministic pixel material worlds. 更多...

struct	PixelWorldPerformanceSample
	One bounded process-local simulation performance sample. 更多...

struct	PixelWorldStepReceipt
	Receipt for an explicit bounded tooling step. 更多...

struct	PixelWorldSummary
	Stable summary of one live PixelWorld registered for local tooling. 更多...

struct	StepStats
	Counters produced by one deterministic simulation step. 更多...

枚举
enum class	MaterialId : std::uint16_t { Air = 0 , Stone , Sand , Water , Oil , Fire , Steam , Wood , Ice , Lava , Smoke , Gunpowder , Acid }
	Compact stable material identifier stored in each authoritative cell. 更多...

enum class	MaterialState : std::uint8_t { Empty , Solid , Powder , Liquid , Gas , Energy }
	Broad movement class for one pixel material. 更多...

enum class	TemperatureDirection : std::uint8_t { AtOrBelow , AtOrAbove }
	Comparison direction for a deterministic temperature transition. 更多...

enum class	PixelEditKind : std::uint8_t { PaintCircle , HeatCircle , Explosion }
	Canonical deterministic edit operation admitted at a Tick boundary. 更多...

enum class	PixelBiome : std::uint8_t { Forest , Desert , Fungal , Volcanic }
	Stable coarse biome selected from deterministic world coordinates. 更多...

函数
eve::Result< std::string >	encodeMaterialCatalogJson (const MaterialCatalog &catalog)
	Encode schema `eve.pixelworld.material-catalog` version 1 canonically.

eve::Result< MaterialCatalog >	decodeMaterialCatalogJson (std::string_view json)
	Decode and validate schema `eve.pixelworld.material-catalog` version 1.

void	registerPixelWorldAutomation ()

void	unregisterPixelWorldAutomation ()

PixelWorldControlService &	pixelWorldControlService ()
	Process-lifetime PixelWorld tooling registry.

eve::Result< PixelWorldGenerationOutput >	generatePixelWorld (const PixelWorldGenerationRequest &request, const MaterialCatalog &catalog, std::uint64_t sourceRevision, eve::SimulationTick sourceTick=eve::SimulationTick::zero(), std::uint64_t sourceLastEditSequence=0)
	Generate a seamless canonical Chunk batch without mutating a PixelWorld.

eve::Result< std::string >	encodePixelWorldGenerationRequestJson (const PixelWorldGenerationRequest &request)
	Encode schema `eve.pixelworld.generation-request` version 1 canonically.

eve::Result< PixelWorldGenerationRequest >	decodePixelWorldGenerationRequestJson (std::string_view json)
	Decode schema `eve.pixelworld.generation-request` version 1.

	Module_IMPL (PixelWorldModule, new PixelWorldModule())

变量
constexpr int	kPixelChunkSize = 64

constexpr std::uint8_t	kPixelSleepHysteresisTicks = 3

枚举类型说明

◆ MaterialId

enum class eve::pixelworld::MaterialId : std::uint16_t

strong

Compact stable material identifier stored in each authoritative cell.

枚举值
Air
Stone
Sand
Water
Oil
Fire
Steam
Wood
Ice
Lava
Smoke
Gunpowder
Acid

在文件 PixelMaterial.h 第 16 行定义.

◆ MaterialState

enum class eve::pixelworld::MaterialState : std::uint8_t

strong

Broad movement class for one pixel material.

枚举值
Empty
Solid
Powder
Liquid
Gas
Energy

在文件 PixelMaterial.h 第 33 行定义.

◆ PixelBiome

enum class eve::pixelworld::PixelBiome : std::uint8_t

strong

Stable coarse biome selected from deterministic world coordinates.

枚举值
Forest
Desert
Fungal
Volcanic

在文件 PixelWorldGeneration.h 第 13 行定义.

◆ PixelEditKind

enum class eve::pixelworld::PixelEditKind : std::uint8_t

strong

Canonical deterministic edit operation admitted at a Tick boundary.

枚举值
PaintCircle
HeatCircle
Explosion

在文件 PixelWorld.h 第 148 行定义.

◆ TemperatureDirection

enum class eve::pixelworld::TemperatureDirection : std::uint8_t

strong

Comparison direction for a deterministic temperature transition.

枚举值
AtOrBelow
AtOrAbove

在文件 PixelMaterial.h 第 58 行定义.

函数说明

◆ decodeMaterialCatalogJson()

EVENGINE_API_FOUNDATION eve::Result< MaterialCatalog > eve::pixelworld::decodeMaterialCatalogJson ( std::string_view json )

Decode and validate schema eve.pixelworld.material-catalog version 1.

备注: Unknown fields, versions, invalid references and malformed values are rejected before a MaterialCatalog is returned; no live world is mutated by this operation.

在文件 PixelMaterialCatalogCodec.cpp 第 172 行定义.

被这些函数引用 eve::pixelworld_editor::PixelWorldCatalogPanel::create(), eve::pixelworld_editor::PixelWorldCatalogPanel::loadDocument() , 以及 eve::pixelworld::PixelWorldControlService::reloadMaterialCatalog().

◆ decodePixelWorldGenerationRequestJson()

eve::Result< PixelWorldGenerationRequest > EVENGINE_API_FOUNDATION eve::pixelworld::decodePixelWorldGenerationRequestJson ( std::string_view json )

Decode schema eve.pixelworld.generation-request version 1.

备注: Unknown fields and versions are rejected. The returned request owns every stamp cell, and decoding cannot mutate a live PixelWorld.

在文件 PixelWorldGenerationCodec.cpp 第 142 行定义.

引用了 cell, cells, index, eve::pixelworld::PixelWorldGenerationRequest::kSchemaVersion, material, request, root, stamp, eve::Result< T >::success() , 以及 value.

◆ encodeMaterialCatalogJson()

EVENGINE_API_FOUNDATION eve::Result< std::string > eve::pixelworld::encodeMaterialCatalogJson ( const MaterialCatalog & catalog )

Encode schema eve.pixelworld.material-catalog version 1 canonically.

在文件 PixelMaterialCatalogCodec.cpp 第 131 行定义.

引用了 eve::Array, AtOrBelow, eve::pixelworld::MaterialCatalog::definitions(), material, eve::Object, phase, eve::pixelworld::MaterialCatalog::phaseRules(), eve::pixelworld::MaterialCatalog::reactions(), reactions, root, eve::Result< T >::success(), text , 以及 value.

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

◆ encodePixelWorldGenerationRequestJson()

EVENGINE_API_FOUNDATION eve::Result< std::string > eve::pixelworld::encodePixelWorldGenerationRequestJson ( const PixelWorldGenerationRequest & request )

Encode schema eve.pixelworld.generation-request version 1 canonically.

在文件 PixelWorldGenerationCodec.cpp 第 108 行定义.

引用了 eve::Array, cell, cells, eve::Object, request, root, stamp, eve::Result< T >::success(), text , 以及 value.

◆ generatePixelWorld()

EVENGINE_API_FOUNDATION eve::Result< PixelWorldGenerationOutput > eve::pixelworld::generatePixelWorld	(	const PixelWorldGenerationRequest &	request,
		const MaterialCatalog &	catalog,
		std::uint64_t	sourceRevision,
		eve::SimulationTick	sourceTick = `eve::SimulationTick::zero()`,
		std::uint64_t	sourceLastEditSequence = `0`
	)

Generate a seamless canonical Chunk batch without mutating a PixelWorld.

参数

request	Versioned finite generation request and optional owning stamps.
catalog	Catalog whose ids/default cells give generated materials meaning.
sourceRevision	Positive authority revision assigned to every output Chunk.
sourceTick	Authority Tick carried by the correction batch.
sourceLastEditSequence	Authority edit sequence carried by the correction batch.

返回: Owning canonical batch and summaries, or a structured bounded-input error.

备注: Integer coordinate hashing makes output bit-exact across worker count and backend. The caller may transactionally admit output.batch through PixelWorld::applyChunkBatch. Unknown schema versions are rejected and no world state is observed or changed.

在文件 PixelWorldGeneration.cpp 第 82 行定义.