Frees an image buffer allocated by loadImage().

Parameters

image

Pointer previously returned by loadImage()

Tests whether a directory exists at the given path or URI.

Parameters

uri

URI.

Returns

True if the file exists; false otherwise.

Tests whether a regular file exists at the given path or URI.

Parameters

uri

URI.

Returns

True if the file exists; false otherwise.

Iterates over the entries of a directory, transparent pack/filesystem.

Parameters

uri	Directory URI.
callback	Called for each entry with its type and its path relative to uri (a plain file name for the first level).
recursive	If true, also traverses the sub-directories.

Returns the configured Lua script directory

Returns the configured Lua script URI

Builds a Lua script URI from a script name

Resolves a path or app:// URI to a concrete OS path.

Implementations may expand environment variables, normalize separators, and map app:// to the application data/assets directory.

Loads the entire file contents into a byte buffer.

Parameters

uri	URI.
out	Destination buffer; its contents are replaced by the file bytes.

Loads an image and returns an allocated RGBA (8‑bit per channel) buffer.

The caller owns the returned memory and must release it with destroyImage().

Parameters

uri	URI.
width	Output image width in pixels.
height	Output image height in pixels.
size	Output total buffer size in bytes (width*height*4).

Returns

Pointer to the newly allocated pixel buffer in RGBA8888 format, or nullptr on failure.

Loads a Lua script from the configured script directory

Parameters

scriptName	Script name without extension, relative to the script directory
out	Output buffer, its contents are replaced by the file bytes.

Loads a SPIR-V or DXIL shader from the configured shader directory

Parameters

shaderName	Shader name without extension and without path
out	Output buffer, its contents are replaced by the file bytes.

Opens an input stream for reading a file, transparent pack/filesystem.

When a pack is active, returns a stream backed by a PackStreambuf (zero intermediate copy). When no pack is loaded, wraps the ifstream. Callers own the returned objects and must keep them alive together.

Parameters

uri	app:// URI.

Returns

pair<unique_ptr<streambuf>, unique_ptr<istream>> — streambuf must outlive the istream.

Opens an output stream for writing the file at URI.

The returned stream is typically opened in binary mode and may create intermediate directories depending on platform support. Callers should check stream.is_open() (or its state) to ensure the file was successfully opened.

Parameters

uri

URI.

Returns

std::ofstream positioned at the start of the file.

Returns the parent directory of the provided path or URI.

For app:// URIs, the parent is computed after resolution. Trailing separators are ignored.

Parameters

uri

URI.

Returns

Parent directory path, or an empty string if none.

Removes the app:// prefix from an URI

Removes the user:// prefix from an URI

Returns true if the virtual FS use a binary resource pack instead of files

URI scheme used to reference files relative to the application root.

URI scheme used to reference files in the platform-specific user data directory. Windows : %APPDATA%%\Lysa\userdata\[userDirectory] Linux : ~/.local/share/lysa/userdata/[userDirectory]