Package com.dua3.utility.ui

Class RichTextVisualLayoutHelper

java.lang.Object

com.dua3.utility.ui.RichTextVisualLayoutHelper

public final class RichTextVisualLayoutHelper
extends Object

Shared helper for editor visual-line layout and caret hit testing.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	RichTextVisualLayoutHelper.BlockLayout	Block layout result used to derive editor visual lines.
static interface	RichTextVisualLayoutHelper.LayoutToSourcePosition	Mapping function from layout positions back to source positions.
static final record	RichTextVisualLayoutHelper.LogicalBlock	Logical text block corresponding to one source line without the trailing '\n'.

Method Summary

Modifier and Type	Method	Description
static List<VisualLine>	buildVisualLines(List<RichTextVisualLayoutHelper.LogicalBlock> logicalBlocks, double defaultLineHeight, FontUtil fontUtil, Function<? super RichText,RichTextVisualLayoutHelper.BlockLayout> blockLayoutFactory)	Builds visual lines for logical blocks using the given font metrics backend.
static List<VisualLine>	buildVisualLines(List<RichTextVisualLayoutHelper.LogicalBlock> logicalBlocks, double defaultLineHeight, Function<? super RichText,RichTextVisualLayoutHelper.BlockLayout> blockLayoutFactory)	Builds visual lines for logical blocks.
static int	indexForPoint(List<VisualLine> lines, double x, double y)	Resolves source index for a visual point.
static int	indexForX(VisualLine line, double x)	Resolves source index for x coordinate in a visual line.
static int	lineIndexForCaret(List<VisualLine> lines, int caret)	Finds visual line index for a caret offset.
static List<RichTextVisualLayoutHelper.LogicalBlock>	splitLogicalBlocks(RichText text)	Splits text into logical source blocks, preserving empty lines.
static double	xForIndex(VisualLine line, int index)	Returns the caret x coordinate for the given source index in a visual line.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

splitLogicalBlocks

public static List<RichTextVisualLayoutHelper.LogicalBlock> splitLogicalBlocks(RichText text)

Splits text into logical source blocks, preserving empty lines.

Parameters:

text - source text

Returns:

immutable list of logical blocks

buildVisualLines

public static List<VisualLine> buildVisualLines(List<RichTextVisualLayoutHelper.LogicalBlock> logicalBlocks,
 double defaultLineHeight,
 Function<? super RichText,RichTextVisualLayoutHelper.BlockLayout> blockLayoutFactory)

Builds visual lines for logical blocks.

Parameters:

logicalBlocks - logical blocks

defaultLineHeight - fallback line height

blockLayoutFactory - layout factory per logical block

Returns:

immutable visual lines

buildVisualLines

public static List<VisualLine> buildVisualLines(List<RichTextVisualLayoutHelper.LogicalBlock> logicalBlocks,
 double defaultLineHeight,
 FontUtil fontUtil,
 Function<? super RichText,RichTextVisualLayoutHelper.BlockLayout> blockLayoutFactory)

Builds visual lines for logical blocks using the given font metrics backend.

Parameters:

logicalBlocks - logical blocks

defaultLineHeight - fallback line height

fontUtil - font utility used for glyph metrics

blockLayoutFactory - layout factory per logical block

Returns:

immutable visual lines

indexForPoint

public static int indexForPoint(List<VisualLine> lines,
 double x,
 double y)

Resolves source index for a visual point.

Parameters:

lines - visual lines

x - x coordinate

y - y coordinate

Returns:

nearest source index

lineIndexForCaret

public static int lineIndexForCaret(List<VisualLine> lines,
 int caret)

Finds visual line index for a caret offset.

Parameters:

lines - visual lines

caret - source caret position

Returns:

line index

xForIndex

public static double xForIndex(VisualLine line,
 int index)

Returns the caret x coordinate for the given source index in a visual line.

Parameters:

line - visual line

index - source index

Returns:

x coordinate

indexForX

public static int indexForX(VisualLine line,
 double x)

Resolves source index for x coordinate in a visual line.

Parameters:

line - visual line

x - x coordinate

Returns:

nearest source index