Xerr API/com.hiusers.xerr.api.container/FontContainer

FontContainer

object FontContainer : BaseContainer<FontMetaEntity> (source)

Registry of custom TTF fonts and semantic GUI positions. Every positioned font uses two fixed providers.

Types

AnchoredTtfCapacityExceeded

class AnchoredTtfCapacityExceeded(message: String) : IllegalArgumentException

data class TtfPlacement(val anchor: GuiAnchor?, val baselineY: Int)

Functions

anchoredTtfPlacements

fun anchoredTtfPlacements(): Map<FontContainer.TtfPlacement, Int>

anchoredTtfSlotsForFont

fun anchoredTtfSlotsForFont(fontId: String): Set<Int>

buildComponentString

fun buildComponentString(fontId: String?, text: String, y: Int, anchor: GuiAnchor? = null): String

fun clear()

清空当前容器。 / Clears this registry.

fun get(key: String): FontMetaEntity?

按 ID 查找实体；不存在时返回 null。 / Looks up an entity by ID, or returns null.

fun getAll(): Map<String, FontMetaEntity>

返回 ID 到实体的映射快照。 / Returns a snapshot of the ID-to-entity map.

fun keys(): Set<String>

返回已注册 ID 的快照。 / Returns a snapshot of registered IDs.

positionedProviderShifts

fun positionedProviderShifts(fontId: String): Map<String, Int>

fun positionId(fontId: String, anchor: GuiAnchor?, y: Int): Int?

Looks up a prepared TTF position from the public top-edge coordinate.

fun put(key: String, value: FontMetaEntity)

按 ID 注册或替换实体。 / Registers or replaces an entity by ID.

registerAnchoredTtfPlacement

fun registerAnchoredTtfPlacement(anchor: GuiAnchor, topY: Int, fontId: String? = null): Int

registerTtfPlacement

fun registerTtfPlacement(anchor: GuiAnchor?, topY: Int, fontId: String? = null): Int

Registers a logical top-edge coordinate. Null anchor keeps the display target's native origin; a non-null anchor is an absolute screen percentage. Native TTF baseline conversion is internal.

resetAnchoredTtfSlots

fun resetAnchoredTtfSlots()

fun ttfPlacements(): Map<FontContainer.TtfPlacement, Int>

fun values(): Collection<FontMetaEntity>

返回实体列表快照。 / Returns a snapshot of the entities.