minecraft/dev.s7a.strata.runtime.minecraft.font/MinecraftDirectoryFontAssetSource

MinecraftDirectoryFontAssetSource

class MinecraftDirectoryFontAssetSource(directory: Path, val name: String = directory.toString()) : MinecraftBoundedFontAssetSource(source)

Directory-backed pack source that closes each enumeration and read before returning. Reads reject symbolic links whose resolved target escapes the selected directory. The caller must not modify the directory concurrently with snapshot loading.

Parameters

Throws

IllegalArgumentException

when the directory is not a directory.

Throwable

when the directory cannot be resolved.

Constructors

MinecraftDirectoryFontAssetSource

constructor(directory: Path, name: String = directory.toString())

Properties

name

open override val name: String

diagnostic label.

Functions

paths

open override fun paths(): Set<String>

Lists available canonical pack-relative file paths.

open override fun paths(limits: MinecraftFontLoadLimits): Set<String>

Lists paths under inclusive entry and path ceilings, checking while enumerating where possible. The default checks an already bounded original paths result before loader copying.

open override fun paths(limits: MinecraftFontLoadLimits, onEntryExamined: () -> Unit): Set<String>

Enumerates paths while reporting each examined entry before validation or filtering. Directory and ignored entries count even when absent from the returned set; implementations must stop if the callback throws. The callback is synchronous, owner-thread-only, and must not be retained; late or foreign-thread calls fail before changing loader counters. The default reports the bounded original result, so sources that filter physical entries must override this method.

read

open override fun read(path: String): ByteArray?

Reads one complete file without retaining a stream.

open override fun read(path: String, limits: MinecraftFontLoadLimits): ByteArray?

Reads one asset under inclusive encoded-byte and path ceilings. Streaming implementations must stop before allocating oversized input and close streams on success and failure. The default checks the already bounded original read result before a loader copy.