Class MeasurementUtils

Utility class for measuring text size using cached labels and font management.

Index

Constructors

Properties

appConfig fontManager holder labelCache simpleLabelCache

Methods

getFontWithKey getSimpleTextSize getTextSize getTextSizeByRenderer getTextSizeBySimpleLabelRenderer

Constructors

constructor

new MeasurementUtils(): MeasurementUtils.MeasurementUtils
Constructs a new MeasurementUtils instance. Initializes the label cache and creates an off-screen holder group.

Returns MeasurementUtils.MeasurementUtils

Properties

`Private`appConfig

appConfig: IAppConfig

Style registry for resolving font styles.

`Private`fontManager

fontManager: IFontManager

Font manager for retrieving fonts.

holder

holder: ISGNGroup

Holder group for off-screen label measurement.

`Private`labelCache

labelCache: Record<string, ISGNLabel>

Cache of label instances, keyed by font or style key.

`Private`simpleLabelCache

simpleLabelCache: Record<string, ISGNSimpleLabel>

Cache of SimpleLabel instances for measurement (keyed by font uri + size + origins).

Methods

`Private`getFontWithKey

getFontWithKey(key: string): undefined | ISGNFont
Retrieves a font object using the specified key.
Parameters
- key: string
  The font key to look up.
Returns undefined | ISGNFont
The font object if found, otherwise undefined.

getSimpleTextSize

getSimpleTextSize(params: SimpleTextSizeParams): TextSize
Measures text using a cached SimpleLabel, matching ISGNSimpleLabel layout.
Parameters
- params: SimpleTextSizeParams
Returns TextSize

getTextSize

getTextSize(params: TextSizeParams): TextSize
Measures the size of the given text using the specified parameters. Uses cached labels and resolves fonts/styles as needed.
Parameters
- params: TextSizeParams
  The parameters for text measurement.
Returns TextSize
The measured width and height of the text.

getTextSizeByRenderer

getTextSizeByRenderer(renderer: ISGNLabel | ISGNSimpleLabel): TextSize
Measures the size of the given label using the specified renderer.
Parameters
- renderer: ISGNLabel | ISGNSimpleLabel
  The renderer to use for text measurement.
Returns TextSize
The measured width and height of the text.

getTextSizeBySimpleLabelRenderer

getTextSizeBySimpleLabelRenderer(renderer: ISGNSimpleLabel): TextSize
Measures the size of text using a SimpleLabel renderer’s current fields.
Parameters
- renderer: ISGNSimpleLabel
Returns TextSize