eve::filesystem 命名空间参考

命名空间
namespace	cppfs
namespace	physfs

类
class	File
	A File interface, providing generic means of reading from and writing to files. 更多...
class	FileData
	Data buffer paired with a filename (used for type identification). 更多...
class	Filesystem
	EVENGINE_API_FOUNDATION public API. 更多...
class	FileWatch
	OS directory watch with a main-thread event queue. Desktop/mobile: backed by Poco::DirectoryWatcher (see FileWatch.cpp). WebGPU (Emscripten): the browser VFS has no native file watching, so this is a no-op stub — add()/remove() return false, poll() returns false. 更多...
class	HotReload
	Path→reload dispatcher for soft hot reload. Driven from load.nut via pollWatch → tryReload; also used by watchTree. 更多...
class	ResourceReader
	Reads project resources through the filesystem capability. 更多...

函数
	Module_IMPL (Filesystem, new physfs::Filesystem())
	Module_IMPL (HotReload, new HotReload())
Result< void >	requestPreparedFile (const std::string &path)
	Queue immutable file bytes in the canonical ResourceManager cache.
Result< std::shared_ptr< const FileData > >	readPreparedFile (const std::string &path, size_t limit)
	Join a queued read or synchronously read an immutable file snapshot.
void	exposePreparedFileBindings (ssq::Class &cls)
	Install game-thread script submission bindings; retains no class borrow.

函数说明

exposePreparedFileBindings()

void eve::filesystem::exposePreparedFileBindings

(

ssq::Class &

cls

)

Install game-thread script submission bindings; retains no class borrow.

在文件 PreparedFile.cpp 第 75 行定义.

引用了 cls, path , 以及 vm.

Module_IMPL() [1/2]

eve::filesystem::Module_IMPL	(	Filesystem	,
		new	physfs::Filesystem()
	)

Module_IMPL() [2/2]

eve::filesystem::Module_IMPL	(	HotReload	,
		new	HotReload()
	)

readPreparedFile()

EVENGINE_API_FOUNDATION Result< std::shared_ptr< const FileData > > eve::filesystem::readPreparedFile	(	const std::string &	path,
		size_t	limit
	)

Join a queued read or synchronously read an immutable file snapshot.

参数

path	VFS path.
limit	Maximum accepted byte length, at most 1 GiB.

返回

Shared immutable bytes, valid after cache unload/reload until the last reader releases them. @thread Game-thread read; no callbacks. Failure publishes no partial snapshot.

在文件 PreparedFile.cpp 第 59 行定义.

引用了 bytes, eve::Diagnostic::error(), eve::Failed, eve::ResourceManager::getInstance(), eve::InvalidArgument, limit, path , 以及 eve::ResourceManager::waitFor().

requestPreparedFile()

EVENGINE_API_FOUNDATION Result< void > eve::filesystem::requestPreparedFile

(

const std::string &

path

)

Queue immutable file bytes in the canonical ResourceManager cache.

参数

path	VFS path, copied before submission; query suffixes are reserved.

返回

Submission diagnostic; requires an initialized Filesystem and worker executor. @ownership ResourceManager owns the job and its snapshot. Workers do no VM/GPU work. @thread Game-thread submission; no callbacks. Decode jobs finish before filesystem teardown.

在文件 PreparedFile.cpp 第 49 行定义.

引用了 eve::Diagnostic::error(), eve::Result< T >::failure(), eve::ResourceManager::getInstance(), eve::InvalidArgument, path, eve::ResourceManager::request() , 以及 eve::Unsupported.