org.axsl.text.line

Interface LineText

All Superinterfaces:

LineContent

All Known Subinterfaces:

CharacterSequence, FoLineText

public interface LineText
extends LineContent

This interface should be used by classes who wish to present themselves to the line-breaking system as containing text.

Method Summary

Modifier and Type	Method and Description
int	inlineFauxSmallCapsFontSize() Tells the line-breaking system what font-size should be used on faux small-caps text.
FontOptions	inlineFontOptions() Returns the font options that should be used during text size computations.
int	inlineFontSize() Tells the line-breaking system the size of the Font that should be used in the character size computations.
boolean	inlineHyphenate() Tells the line-breaking system whether the text can be hyphenated or not.
int	inlineHyphenationCharacter() Tells the line-breaking system what character to use as the hyphen for purposes of hyphenation.
int	inlineHyphenationPushCount() Tells the line-breaking system the minimum number of characters in a hyphenated word after the hyphenation character.
int	inlineHyphenationRemainCount() Tells the line-breaking system the minimum number of characters in a hyphenated word before the hyphenation character.
boolean	inlineIsFauxSmallCaps() Tells the line-breaking system whether faux small-caps should be applied to this text.
int	inlineLetterSpacingOptimum() Tells the line-breaking system the optimum amount of letter-spacing that should be used the line-breaking computations.
Orthography	inlineOrthography() Tells the line-breaking system what language, country, and script information to use for purposes of hyphenation and other line-breaking decisions.
FontUse	inlinePrimaryFont() Tells the line-breaking sytem which FontUse instance should be considered the primary font to use in the text size computations.
FontUse	inlineSecondaryFont(char c) Provides a way to obtain a secondary FontUse instance for characters that cannot be encoded by the primary font.
java.lang.CharSequence	inlineText() Tells the line-breaking system what char array to use as the text for which the line-breaks should be computed.
int	inlineWordSpacingOptimum() Tells the line-breaking system the optimum amount of extra word-spacing that should be used the line-breaking computations.
boolean	inlineWrapOption() Tells the line-breaking system whether the text should wrap to a new line (true), or whether it should be overflowed (false).
LineText	nextContiguousLineText() Gives the line-breaking system the next contiguous LineText instance, if any.
LineText	previousContiguousLineText() Gives the line-breaking system the preceding contiguous LineText instance, if any.

Methods inherited from interface org.axsl.text.line.LineContent

isLastItemInBlock

Method Detail

inlineText

java.lang.CharSequence inlineText()

Tells the line-breaking system what char array to use as the text for which the line-breaks should be computed.

Returns:

A char array containing the text which represents the content of this item.

inlinePrimaryFont

FontUse inlinePrimaryFont()

Tells the line-breaking sytem which FontUse instance should be considered the primary font to use in the text size computations.

Returns:

The primary FontUse instance that should be used in character size computations for this text.

inlineSecondaryFont

FontUse inlineSecondaryFont(char c)

Provides a way to obtain a secondary FontUse instance for characters that cannot be encoded by the primary font. Note that this method should only be used if the FontUse returned by inlinePrimaryFont() is incapable of encoding c.

Parameters:

c - The character for which a secondary font is desired.

Returns:

The best FontUse instance possible for c, which can be used in character size computations for this text.

inlineFontOptions

FontOptions inlineFontOptions()

Returns the font options that should be used during text size computations.

Returns:

The font options.

inlineFontSize

int inlineFontSize()

Tells the line-breaking system the size of the Font that should be used in the character size computations.

Returns:

The size of the font, in millipoints.

inlineLetterSpacingOptimum

int inlineLetterSpacingOptimum()

Tells the line-breaking system the optimum amount of letter-spacing that should be used the line-breaking computations.

Returns:

The optimum amount of letter-spacing, in millipoints.

inlineWordSpacingOptimum

int inlineWordSpacingOptimum()

Tells the line-breaking system the optimum amount of extra word-spacing that should be used the line-breaking computations.

Returns:

The optimum amount of word-spacing, in millipoints.

inlineWrapOption

boolean inlineWrapOption()

Tells the line-breaking system whether the text should wrap to a new line (true), or whether it should be overflowed (false).

Returns:

True if text should be wrapped.

inlineHyphenate

boolean inlineHyphenate()

Tells the line-breaking system whether the text can be hyphenated or not.

Returns:

True if the text can be hyphenated.

inlineOrthography

Orthography inlineOrthography()

Tells the line-breaking system what language, country, and script information to use for purposes of hyphenation and other line-breaking decisions.

Returns:

The language for this text.

inlineHyphenationRemainCount

int inlineHyphenationRemainCount()

Tells the line-breaking system the minimum number of characters in a hyphenated word before the hyphenation character. This is the minumum number of characters in the word left on the line ending with the hyphenation character.

Returns:

The minimum number of characters in the word that can be left on the line.

inlineHyphenationPushCount

int inlineHyphenationPushCount()

Tells the line-breaking system the minimum number of characters in a hyphenated word after the hyphenation character. This is the minumum number of characters in the word pushed to the next line after the line ending with the hyphenation character.

Returns:

The minimum number of characters in the word that can be pushed to the next line.

inlineHyphenationCharacter

int inlineHyphenationCharacter()

Tells the line-breaking system what character to use as the hyphen for purposes of hyphenation.

Returns:

The hyphenation character that should be used for discretionary hyphens for this text, as an unsigned 21-bit Unicode code point.

inlineIsFauxSmallCaps

boolean inlineIsFauxSmallCaps()

Tells the line-breaking system whether faux small-caps should be applied to this text.

Returns:

True iff this text should have faux small-caps applied.

inlineFauxSmallCapsFontSize

int inlineFauxSmallCapsFontSize()

Tells the line-breaking system what font-size should be used on faux small-caps text.

Returns:

The font size for lowercase characters when faux small-caps is applied.

nextContiguousLineText

LineText nextContiguousLineText()

Gives the line-breaking system the next contiguous LineText instance, if any. Only LineText items that are contextual to this instance should be returned. If the nearest LineText item is in a different paragraph or if something is between the two, null should be returned.

Returns:

The next contiguous LineText item, or null if there is none.

previousContiguousLineText

LineText previousContiguousLineText()

Gives the line-breaking system the preceding contiguous LineText instance, if any. Only LineText items that are contextual to this instance should be returned. If the nearest LineText item is in a different paragraph or if something is between the two, null should be returned.

Returns:

The previous contiguous LineText item, or null if there is none.