su.whs.watl.text

Class TextLayout

java.lang.Object

su.whs.watl.text.TextLayout

All Implemented Interfaces:

ContentView.OptionsChangeListener, ITextLayout

Direct Known Subclasses:

TextLayoutEx

public class TextLayout
extends java.lang.Object
implements ITextLayout, ContentView.OptionsChangeListener

* states: measured (invalidates on change base font size) layouted (depends on 'measured' and 'width', 'lineBreaker', 'imagePlacementHandler' + if requested height > reflowed Height)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TextLayout.DefaultLineBreaker default LineBreaker implementation
class	TextLayout.LinesIterator iterator to quick access to lines properties developed to support MultiColumnTextViewEx's height==MeasureSpec.UNSPECIFIED
class	TextLayout.Options

Field Summary

Fields

Modifier and Type	Field and Description
protected char[]	chars
protected int	height
protected java.util.List<TextLine>	lines
protected su.whs.watl.text.LineSpan	lineSpan
protected TextLayoutListener	listener
protected int	mViewsCount
protected int	reflowedHeight
protected int	reflowedWidth
protected int	requestedHeight
protected int	viewHeight
protected int	width

Constructor Summary

Constructors

Constructor and Description
TextLayout()
TextLayout(android.text.Spanned text, int start, int end, android.text.TextPaint paint, ContentView.Options options, TextLayoutListener invalidateListener)
TextLayout(android.text.Spanned text, int start, int end, android.text.TextPaint paint, TextLayoutListener invalidateListener)
TextLayout(android.text.Spanned text, android.text.TextPaint paint)
TextLayout(android.text.Spanned text, android.text.TextPaint paint, TextLayoutListener invalidateListener)

Method Summary

Modifier and Type	Method and Description
void	addHighlight(int start, int end, int color)
void	draw(android.graphics.Canvas canvas, int left, int top, int right, int bottom)
void	draw(android.graphics.Canvas canvas, int left, int top, int right, int bottom, int startLine, int endLine)
int	draw(java.util.List<TextLine> lines, int startLine, int endLine, char[] text, android.graphics.Canvas canvas, android.graphics.Rect clipRect, float width, float height, android.text.TextPaint paint, int selectionStart, int selectionEnd, int selectionColor, int highlightStart, int highlightEnd, int highlightColor, boolean justification)
void	finalize()
protected char[]	getChars()
android.graphics.drawable.Drawable.Callback	getDrawableCallbacks()
int	getDynamicDrawablePosition(android.text.style.DynamicDrawableSpan span)
boolean	getDynamicDrawableSpanRect(android.text.style.DynamicDrawableSpan dds, android.graphics.Rect out)
int	getEnd()
int	getHeight()
TextLayoutListener	getInvalidateListener()
int	getLineBottom(int line)
float	getLineDescent(int line)
int	getLineEnd(int line)
int	getLineForPosition(int position) find line for character position
int	getLineForVertical(float y)
int	getLineForVertical(float y, int startLine)
float	getLineHeight(int line)
int	getLinesCount()
TextLayout.LinesIterator	getLinesIterator()
protected su.whs.watl.text.LineSpan	getLineSpan()
int	getLineStart(int line)
int	getLineTop(int line)
int	getOffsetForCoordinates(android.view.View view, float x, float y, int startsFromLine)
int	getOffsetForHorizontal(TextLine line, int x)
ContentView.Options	getOptions() return layout's Options
android.text.TextPaint	getPaint()
android.graphics.drawable.Drawable.Callback	getPlaceholderCallbacks()
int	getPrimaryHorizontal(int line, int position) calculate horizontal offset of character with index 'position'
protected int	getSelectionColor()
int	getSelectionEnds()
int	getSelectionStarts()
int	getStart()
java.lang.String	getState()
java.lang.CharSequence	getText()
android.text.TextPaint	getTextPaint()
int	getWidth()
void	invalidate() invalidate layout actually, invalidate() works only if width/font size changed
void	invalidateLines() called when layout geometry was changed, or some handlers replaced
void	invalidateLinesFrom(int position)
void	invalidateMeasurement() called when font size was changed
void	invalidateMeasurementFrom(int position)
protected void	invalidateMeasurementInternal()
protected void	invalidateMeasurementInternal(int line, su.whs.watl.text.LineSpan span)
boolean	isLayouted()
boolean	isLineAreWrap(int line)
protected boolean	isReflowBackgroundTaskCancelled()
boolean	isReflowBackgroundTaskRunning()
protected boolean	isReflowFinished()
protected java.lang.String	log_single_line(int line)
void	notifyTextHeightChanged()
protected void	notifyTextInfoInvalidated()
protected void	notifyTextReady()
void	onFinish(java.util.List<TextLine> lines, int height) method, where handles layout finish
boolean	onProgress(java.util.List<TextLine> lines, int collectedHeight, boolean viewHeightExceed) method where handles interaction with TextLayoutListener when overriden - onProgress() must increments mViewsCount on every viewHeightExceed==true
protected void	reflow(char[] text, int lineStartAt, int textEnd, su.whs.watl.text.LineSpan _startSpan, float x, int width, int y, int height, int viewHeight, android.text.TextPaint paint, ContentView.Options options) main method used for calculating spans geometry with given base TextPaint, width and height limit, and so on
void	registerDrawable(android.text.style.DynamicDrawableSpan dds, int placement, int position)
void	release()
void	removeHighlight(int start, int end)
void	resetHighlight() reset hightlits (similar to setHighlight(0,0,0))
void	setDrawableBounds(android.graphics.drawable.Drawable d, int left, int top, int right, int bottom)
void	setHighlight(int start, int end, int color) set highlight text range
void	setInvalidateListener(TextLayoutListener listener)
protected void	setIsLayoutedInternal(boolean value)
void	setMaxLines(int maxLines)
protected void	setPaint(android.text.TextPaint paint)
protected void	setReflowBackgroundTaskCancelled(boolean cancelled)
protected void	setReflowBackgroundTaskRunning(boolean running)
protected void	setReflowFinished(boolean finished)
void	setSelection(int start, int end) set selected text range
void	setSize(int width, int height)
void	setSize(int width, int height, int viewHeight) set size for layout where 'visible height' < available height used for split layout to pages
void	setTextSize(float size)
protected void	stopReflowIfNeed() stop background thread, if running
boolean	updateGeometry(int[] geometry) default implementation does not supports geometry change supports

Methods inherited from class java.lang.Object

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

Field Detail

chars

protected char[] chars

lineSpan

protected su.whs.watl.text.LineSpan lineSpan

width

protected int width

reflowedWidth

protected int reflowedWidth

height

protected int height

reflowedHeight

protected int reflowedHeight

requestedHeight

protected int requestedHeight

listener

protected TextLayoutListener listener

viewHeight

protected int viewHeight

lines

protected java.util.List<TextLine> lines

mViewsCount

protected int mViewsCount

Constructor Detail

TextLayout

public TextLayout(android.text.Spanned text,
                  int start,
                  int end,
                  android.text.TextPaint paint,
                  TextLayoutListener invalidateListener)

TextLayout

public TextLayout(android.text.Spanned text,
                  int start,
                  int end,
                  android.text.TextPaint paint,
                  ContentView.Options options,
                  TextLayoutListener invalidateListener)

Parameters:

text - - Spanned instance

start - - begin of text whe want to layout

end - - end of text

paint - - default paint

invalidateListener -

TextLayout

public TextLayout()

TextLayout

public TextLayout(android.text.Spanned text,
                  android.text.TextPaint paint)

TextLayout

public TextLayout(android.text.Spanned text,
                  android.text.TextPaint paint,
                  TextLayoutListener invalidateListener)

Method Detail

getDynamicDrawablePosition

public int getDynamicDrawablePosition(android.text.style.DynamicDrawableSpan span)

isLayouted

public boolean isLayouted()

setIsLayoutedInternal

protected void setIsLayoutedInternal(boolean value)

notifyTextHeightChanged

public void notifyTextHeightChanged()

notifyTextInfoInvalidated

protected void notifyTextInfoInvalidated()

notifyTextReady

protected void notifyTextReady()

getLineForVertical

public int getLineForVertical(float y,
                              int startLine)

Parameters:

y -

startLine -

Returns:

0 if y above startLine, getLinesCount()-1 if y below lastLine

isLineAreWrap

public boolean isLineAreWrap(int line)

getLineForVertical

public int getLineForVertical(float y)

Parameters:

y-coordinate - on canvas

Returns:

number of line for y-coordinate

setInvalidateListener

public void setInvalidateListener(TextLayoutListener listener)

getInvalidateListener

public TextLayoutListener getInvalidateListener()

getWidth

public int getWidth()

getLinesIterator

public TextLayout.LinesIterator getLinesIterator()

getState

public java.lang.String getState()

release

public void release()

getOffsetForCoordinates

public int getOffsetForCoordinates(android.view.View view,
                                   float x,
                                   float y,
                                   int startsFromLine)

Parameters:

view - - view we attached to

x - - x coordinate

y - - y coordinate

startsFromLine -

Returns:

clicked character offset

WARNING: getOffsetForCoordinates() does not use paddings! (yet)

getDynamicDrawableSpanRect

public boolean getDynamicDrawableSpanRect(android.text.style.DynamicDrawableSpan dds,
                                          android.graphics.Rect out)

Parameters:

dds - - DynamicDrawableSpan

out - - Rect instance

Returns:

true, if dds are visible on layout

getLinesCount

public int getLinesCount()

getLineStart

public int getLineStart(int line)

getLineEnd

public int getLineEnd(int line)

getLineTop

public int getLineTop(int line)

getLineBottom

public int getLineBottom(int line)

getPrimaryHorizontal

public int getPrimaryHorizontal(int line,
                                int position)

calculate horizontal offset of character with index 'position'

Parameters:

line -

position -

Returns:

getHeight

public int getHeight()

Returns:

getTextPaint

public android.text.TextPaint getTextPaint()

Specified by:

getTextPaint in interface ContentView.OptionsChangeListener

setTextSize

public void setTextSize(float size)

Specified by:

setTextSize in interface ContentView.OptionsChangeListener

Parameters:

size -

setSize

public void setSize(int width,
                    int height)

Parameters:

width - - width of view

height - - height of view or -1, if need height of all text

setSize

public void setSize(int width,
                    int height,
                    int viewHeight)

set size for layout where 'visible height' < available height

used for split layout to pages

Parameters:

width - - width of view

height - - height (-1 if unlimited height)

viewHeight - - 'visible height'

invalidate

public void invalidate()

invalidate layout actually, invalidate() works only if width/font size changed

Specified by:

invalidate in interface ContentView.OptionsChangeListener

setPaint

protected void setPaint(android.text.TextPaint paint)

getOptions

public ContentView.Options getOptions()

return layout's Options

Specified by:

getOptions in interface ITextLayout

Returns:

draw

public void draw(android.graphics.Canvas canvas,
                 int left,
                 int top,
                 int right,
                 int bottom,
                 int startLine,
                 int endLine)

draw

public void draw(android.graphics.Canvas canvas,
                 int left,
                 int top,
                 int right,
                 int bottom)

Parameters:

canvas -

left -

top -

right -

bottom -

getChars

protected char[] getChars()

Returns:

char[] content of getText()

getLineSpan

protected su.whs.watl.text.LineSpan getLineSpan()

Returns:

LineSpan chain

setHighlight

public void setHighlight(int start,
                         int end,
                         int color)

set highlight text range

Parameters:

start - - range start

end - - - range end

color - - color (ARGB)

addHighlight

public void addHighlight(int start,
                         int end,
                         int color)

Parameters:

start -

end -

color -

removeHighlight

public void removeHighlight(int start,
                            int end)

Parameters:

start -

end -

setSelection

public void setSelection(int start,
                         int end)

set selected text range

Parameters:

start - - range start

end - - range end

getSelectionColor

protected int getSelectionColor()

resetHighlight

public void resetHighlight()

reset hightlits (similar to setHighlight(0,0,0))

getSelectionStarts

public int getSelectionStarts()

Returns:

begin of selection range

getSelectionEnds

public int getSelectionEnds()

Returns:

end of selection range

getLineDescent

public float getLineDescent(int line)

Parameters:

line -

Returns:

line descent (actually = bottom - baseline)

getLineForPosition

public int getLineForPosition(int position)

find line for character position

Parameters:

position - - character position in text

Returns:

number of line

getLineHeight

public float getLineHeight(int line)

Parameters:

line -

Returns:

line height (bottom - top)

getText

public java.lang.CharSequence getText()

Returns:

char sequence, actually same object, that was passed to constructor

getStart

public int getStart()

Returns:

start of working range in getText()

getEnd

public int getEnd()

Returns:

end of working range in getText()

getPaint

public android.text.TextPaint getPaint()

Returns:

paint instance

isReflowBackgroundTaskRunning

public boolean isReflowBackgroundTaskRunning()

isReflowBackgroundTaskCancelled

protected boolean isReflowBackgroundTaskCancelled()

setReflowBackgroundTaskRunning

protected void setReflowBackgroundTaskRunning(boolean running)

setReflowBackgroundTaskCancelled

protected void setReflowBackgroundTaskCancelled(boolean cancelled)

setReflowFinished

protected void setReflowFinished(boolean finished)

isReflowFinished

protected boolean isReflowFinished()

invalidateMeasurement

public void invalidateMeasurement()

called when font size was changed

Specified by:

invalidateMeasurement in interface ContentView.OptionsChangeListener

invalidateMeasurementFrom

public void invalidateMeasurementFrom(int position)

invalidateLines

public void invalidateLines()

called when layout geometry was changed, or some handlers replaced

Specified by:

invalidateLines in interface ContentView.OptionsChangeListener

invalidateLinesFrom

public void invalidateLinesFrom(int position)

invalidateMeasurementInternal

protected void invalidateMeasurementInternal()

invalidateMeasurementInternal

protected void invalidateMeasurementInternal(int line,
                                             su.whs.watl.text.LineSpan span)

stopReflowIfNeed

protected void stopReflowIfNeed()

stop background thread, if running

updateGeometry

public boolean updateGeometry(int[] geometry)

default implementation does not supports geometry change supports

Specified by:

updateGeometry in interface ITextLayout

Parameters:

geometry -

Returns:

log_single_line

protected java.lang.String log_single_line(int line)

onProgress

public boolean onProgress(java.util.List<TextLine> lines,
                          int collectedHeight,
                          boolean viewHeightExceed)

method where handles interaction with TextLayoutListener when overriden - onProgress() must increments mViewsCount on every viewHeightExceed==true

Specified by:

onProgress in interface ITextLayout

Parameters:

lines -

collectedHeight -

viewHeightExceed -

Returns:

registerDrawable

public void registerDrawable(android.text.style.DynamicDrawableSpan dds,
                             int placement,
                             int position)

Specified by:

registerDrawable in interface ITextLayout

getPlaceholderCallbacks

public android.graphics.drawable.Drawable.Callback getPlaceholderCallbacks()

Specified by:

getPlaceholderCallbacks in interface ITextLayout

getDrawableCallbacks

public android.graphics.drawable.Drawable.Callback getDrawableCallbacks()

Specified by:

getDrawableCallbacks in interface ITextLayout

onFinish

public void onFinish(java.util.List<TextLine> lines,
                     int height)

method, where handles layout finish

Specified by:

onFinish in interface ITextLayout

Parameters:

lines -

height -

reflow

protected void reflow(char[] text,
                      int lineStartAt,
                      int textEnd,
                      su.whs.watl.text.LineSpan _startSpan,
                      float x,
                      int width,
                      int y,
                      int height,
                      int viewHeight,
                      android.text.TextPaint paint,
                      ContentView.Options options)

main method used for calculating spans geometry with given base TextPaint, width and height limit, and so on

Parameters:

text - - array of chars

lineStartAt - - first character of line we starts

textEnd - - last available character (so, we process only slice text[lineStartAt:textEnd]

_startSpan - - if not null - will continue reflow from _startSpan (used for lasy reflow)

x - - start from given x coord

width - - available width limit in pixels

y - - start from given y coord

height - - available height limit (or -1 if no known height - i.e. for scrollable) : TODO

viewHeight - - used for lazy reflow (we reflow at least viewHeight*1.5 for performance) : TODO

paint - - base Paint

options - - options

draw

public int draw(java.util.List<TextLine> lines,
                int startLine,
                int endLine,
                char[] text,
                android.graphics.Canvas canvas,
                android.graphics.Rect clipRect,
                float width,
                float height,
                android.text.TextPaint paint,
                int selectionStart,
                int selectionEnd,
                int selectionColor,
                int highlightStart,
                int highlightEnd,
                int highlightColor,
                boolean justification)

setDrawableBounds

public void setDrawableBounds(android.graphics.drawable.Drawable d,
                              int left,
                              int top,
                              int right,
                              int bottom)

Specified by:

setDrawableBounds in interface ITextLayout

setMaxLines

public void setMaxLines(int maxLines)

Specified by:

setMaxLines in interface ITextLayout

getOffsetForHorizontal

public final int getOffsetForHorizontal(TextLine line,
                                        int x)

Parameters:

line - - number of line (

x - - x-coordinate from line starts

Returns:

finalize

public void finalize()
              throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable