Class LineWrapManager

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Panel
                           |
                           +----java.applet.Applet
                                   |
                                   +----TextScroll
                                           |
                                           +----LineWrapManager

public class LineWrapManager
extends TextScroll

This class does the line wrapping for our text. Line wrapping is complicated in an applet such as this, because the font face and size are dynamic. One cannot simply say, "lines are 20 characters wide." This class actually goes through and renders the entire text presentation off-screen. You would use it like this:


   ... // text is our String[] of data, width is the width of the applet.
   LineWrapManager wrapManager = new LineWrapManager (text, face, size);
   text = wrapManager.wrapForWidth (width);

After that, text would still contain the same data, but each element of the array might hold more or fewer words than it did before, and it might contain more or fewer elements overall.

Wrapping lines that are too long is one thing, but it must be decided whether to bring up the next line if there is room on the previous line. This class decides to do this. This complicates things slightly when you want a new paragraph. There is one simple rule to remember when composing your text file content:

"The first newline is always ignored."

This means when you want to explicitely start a new line, you must put two carriage returns directly next to each other. Three newlines in the text file will give you two newlines in the applet.

It is also important to note that directives always get their own line in the data file. When the applet encounters a directive, it starts a new line, no matter what.

This class basically provides empty implementations for all the methods a DirectiveManager might call. It doesn't actually print anything anywhere, it just uses configuration information to measure lines of text, and wrap them appropriately.

LineWrapManager(String[], Font): Constructor.

nextToken(): This method is used to tokenize the text in the array.
pause(): Doesn't need to do anything in this class.
pause(String): Doesn't need to do anything in this class.
setBold(String): Sets the bold flag for the right pane based on the argument.
setCenter(String): Whether we should center the text in the right pane or not.
setFontFace(String): Note the new font face.
setFontSize(String): Note the new font size.
setInset(String): Sets the text inset.
setItalic(String): Sets the italic flag for the right pane based on the argument.
setLeftBackgroundColor(String): Doesn't need to do anything in this class.
setLeftBold(String): Sets the bold flag for the left pane based on the argument.
setLeftCenter(String): Whether we should center the text in the left pane or not.
setLeftFontFace(String): Ignore.
setLeftFontSize(String): Ignore.
setLeftForegroundColor(String): Doesn't need to do anything in this class.
setLeftItalic(String): Sets the italic flag for the left pane based on the argument.
setRightBackgroundColor(String): Doesn't need to do anything in this class.
setRightBold(String): Sets the bold flag for the right pane based on the argument.
setRightCenter(String): Whether we should center the text in the right pane or not.
setRightFontFace(String): Note the new font face.
setRightFontSize(String): Note the new font size.
setRightForegroundColor(String): Doesn't need to do anything in this class.
setRightItalic(String): Sets the italic flag for the right pane based on the argument.
setSpeed(String): Doesn't need to do anything in this class.
unGet(String): Lets us "un-get" a token.
wrapForWidth(int): This method actually does all the wrapping work.

LineWrapManager

 public LineWrapManager(String text[],
                        Font font)

Constructor. Takes the data to be wrapped, the initial font face, and the intial font size.

Parameters:: text - The String array to have line wrapping performed on it.; font - The initial font to use.