org.extex.typesetter.impl
Class NullTypesetterImpl

java.lang.Object
  org.extex.typesetter.impl.NullTypesetterImpl

All Implemented Interfaces:

ListMaker, TokenDelegateListMaker, Typesetter

public class NullTypesetterImpl
extends java.lang.Object
implements Typesetter, TokenDelegateListMaker

The dummy typesetter which does nothing but provide the appropriate interface.

Version:

$Revision:4526 $

Author:

Gerd Neugebauer

Constructor Summary

NullTypesetterImpl()
Creates a new object.

Method Summary

void	add(FixedGlue g) Add a glue node to the list.
void	add(Node node) Add an arbitrary node to the internal list of nodes gathered so far.
void	addAndAdjust(NodeList list, TypesetterOptions options) Add a node list to the current list maker and adjust the spacing between the elements of the list.
void	addSpace(TypesettingContext typesettingContext, FixedCount spacefactor) Add a space node to the list.
void	afterParagraph(ParagraphObserver observer) Register an observer to be invoked at the end of the paragraph.
void	clearShipoutMark() Clear the internal state about ship-outs.
NodeList	complete(TypesetterOptions context) Close the node list.
void	configure(Configuration config) Configure an object according to a given Configuration.
void	cr(Context context, TypesettingContext tc, UnicodeChar uc) Process a carriage return.
ListMaker	ensureHorizontalMode(Locator locator) Switch to horizontal mode if necessary.
void	finish() Instructs the typesetter to perform any actions necessary for cleaning up everything at the end of processing.
BackendDriver	getBackendDriver() Getter for the back-end driver.
Node	getLastNode() Access the last node on the list.
ListMaker	getListMaker() Getter for the current list maker.
Locator	getLocator() Getter for the locator.
ListManager	getManager() Getter for the manager of the list maker stack.
Mode	getMode() Getter for the current mode.
NodeFactory	getNodeFactory() Getter for the NodeFactory.
FixedDimen	getPrevDepth() Getter for the previous depth parameter.
long	getSpacefactor() Getter for the space factor.
boolean	isShipoutMark() Query the ship-out mark.
void	leftBrace() Notification method to deal the case that a left brace has been encountered.
boolean	letter(UnicodeChar uc, TypesettingContext tc, Context context, TokenSource source, Locator locator) Add a letter to the current list or treat it in some other appropriate way.
void	mathShift(Context context, TokenSource source, Token t) Treat a math shift character.
void	par() Emit a new paragraph.
void	push(ListMaker listMaker) Open a new list maker and put it in the top of the stack as current box.
ListMaker	pushListMaker(ListMakerType type, Locator locator) Push a list maker onto the stack and return the old value.
void	removeLastNode() Removes the last node from the list.
void	rightBrace() Notification method to deal the case that a right brace has been encountered.
void	setBackend(BackendDriver driver) Setter for the back-end driver.
void	setNodeFactory(NodeFactory nodeFactory) Setter for the node factory.
void	setOptions(TypesetterOptions options) Setter for the typesetter specific options.
void	setOutputRoutine(OutputRoutine output) Setter for the output routine.
void	setPageBuilder(PageBuilder pageBuilder) Setter for the page builder.
void	setParagraphBuilder(ParagraphBuilder paragraphBuilder) Setter for the paragraph builder.
void	setPrevDepth(FixedDimen pd) Setter for the previous depth parameter.
void	setSpacefactor(FixedCount sf) Setter for the space factor.
void	shipout(NodeList nodes) Send a list of nodes to the document writer.
void	showlist(java.lang.StringBuffer sb, long depth, long breadth) Print the status for \showlists.
void	showlists(java.lang.StringBuffer sb, long depth, long breadth) This method produces a diagnostic representation of the current lists in a StringBuffer.
void	subscriptMark(Context context, TokenSource source, Typesetter typesetter, Token t) Treat a subscript mark.
void	superscriptMark(Context context, TokenSource source, Typesetter typesetter, Token t) Treat a superscript mark.
void	tab(Context context, TokenSource source, Token t) Treat a alignment tab character.

Methods inherited from class java.lang.Object

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

Constructor Detail

NullTypesetterImpl

public NullTypesetterImpl()

Creates a new object.

Method Detail

add

public void add(FixedGlue g)
         throws TypesetterException

Add a glue node to the list.

Specified by:

add in interface ListMaker

Parameters:

g - the glue to add

Throws:

TypesetterException - in case of an error

See Also:

ListMaker.add( org.extex.core.glue.FixedGlue)

add

public void add(Node node)
         throws TypesetterException

Add an arbitrary node to the internal list of nodes gathered so far. The node should not be one of the special nodes treated by methods of their own.

Specified by:

add in interface ListMaker

Parameters:

node - the node to add

Throws:

TypesetterException - in case of an error

ConfigurationException - in case of a configuration error

See Also:

ListMaker.add( org.extex.typesetter.type.Node)

addAndAdjust

public void addAndAdjust(NodeList list,
                         TypesetterOptions options)
                  throws TypesetterException

Add a node list to the current list maker and adjust the spacing between the elements of the list.

Specified by:

addAndAdjust in interface ListMaker

Parameters:

list - the list

options - the options to use

Throws:

TypesetterException - in case of an error

ConfigurationException - in case of a configuration error

See Also:

ListMaker.addAndAdjust( org.extex.typesetter.type.NodeList, org.extex.typesetter.TypesetterOptions)

addSpace

public void addSpace(TypesettingContext typesettingContext,
                     FixedCount spacefactor)
              throws TypesetterException,
                     ConfigurationException

Add a space node to the list.

Specified by:

addSpace in interface ListMaker

Parameters:

typesettingContext - the typesetting context for the space

spacefactor - the space factor to use for this space or null to indicate that the default space factor should be used.

Throws:

TypesetterException - in case of an error

ConfigurationException - in case of a configuration error

See Also:

ListMaker.addSpace( org.extex.typesetter.tc.TypesettingContext, FixedCount)

afterParagraph

public void afterParagraph(ParagraphObserver observer)

Register an observer to be invoked at the end of the paragraph.

Specified by:

afterParagraph in interface ListMaker

Parameters:

observer - the observer to register

See Also:

ListMaker.afterParagraph(ParagraphObserver)

clearShipoutMark

public void clearShipoutMark()

Clear the internal state about ship-outs. The ship-out mark is reset to false.

Specified by:

clearShipoutMark in interface Typesetter

See Also:

Typesetter.clearShipoutMark()

complete

public NodeList complete(TypesetterOptions context)
                  throws TypesetterException,
                         ConfigurationException

Close the node list. This means that everything is done to ship the closed node list to the document writer. Nevertheless the invoking application might decide not to modify the node list and continue processing. In the other case some nodes might be taken from the node list returned by this method. Then the processing has to continue with the reduced node list.

Specified by:

complete in interface ListMaker

Parameters:

context - the typesetter options mapping a fragment of the interpreter context

Returns:

the node list enclosed in this instance

Throws:

TypesetterException - in case of an error

ConfigurationException - in case of a configuration error

See Also:

ListMaker.complete(TypesetterOptions)

configure

public void configure(Configuration config)

Configure an object according to a given Configuration.

Parameters:

config - the configuration object to consider

Throws:

ConfigurationException - in case that something went wrong

See Also:

Configurable.configure( org.extex.framework.configuration.Configuration)

cr

public void cr(Context context,
               TypesettingContext tc,
               UnicodeChar uc)
        throws TypesetterException

Process a carriage return.

Specified by:

cr in interface TokenDelegateListMaker

Parameters:

context - the interpreter context

tc - the typesetting context

uc - the character

Throws:

TypesetterException - in case of an error

See Also:

TokenDelegateListMaker.cr( org.extex.interpreter.context.Context, org.extex.typesetter.tc.TypesettingContext, org.extex.core.UnicodeChar)

ensureHorizontalMode

public ListMaker ensureHorizontalMode(Locator locator)

Switch to horizontal mode if necessary. If the current mode is a horizontal mode then nothing is done.

Specified by:

ensureHorizontalMode in interface Typesetter

Parameters:

locator - the locator

Returns:

the horizontal list maker

See Also:

Typesetter.ensureHorizontalMode( org.extex.core.Locator)

finish

public void finish()

Instructs the typesetter to perform any actions necessary for cleaning up everything at the end of processing. This should involve a ship-out of any material still left unprocessed.

Specified by:

finish in interface Typesetter

See Also:

Typesetter.finish()

getBackendDriver

public BackendDriver getBackendDriver()

Getter for the back-end driver.

Specified by:

getBackendDriver in interface Typesetter

Returns:

the back-end driver

See Also:

Typesetter.getBackendDriver()

getLastNode

public Node getLastNode()

Access the last node on the list.

Specified by:

getLastNode in interface ListMaker

Returns:

the last node in the current list or null if the list is empty

See Also:

ListMaker.getLastNode()

getListMaker

public ListMaker getListMaker()

Getter for the current list maker.

Specified by:

getListMaker in interface Typesetter

Returns:

the top list maker or null if the stack is empty

See Also:

Typesetter.getListMaker()

getLocator

public Locator getLocator()

Getter for the locator.

Specified by:

getLocator in interface ListMaker

Returns:

the locator

See Also:

ListMaker.getLocator()

getManager

public ListManager getManager()

Getter for the manager of the list maker stack.

Specified by:

getManager in interface Typesetter

Returns:

the manager

See Also:

Typesetter.getManager()

getMode

public Mode getMode()

Getter for the current mode.

Specified by:

getMode in interface ListMaker

Returns:

the mode which is one of the values defined in Mode.

See Also:

ListMaker.getMode()

getNodeFactory

public NodeFactory getNodeFactory()

Getter for the NodeFactory.

Specified by:

getNodeFactory in interface Typesetter

Returns:

the node factory

See Also:

Typesetter.getNodeFactory()

getPrevDepth

public FixedDimen getPrevDepth()
                        throws TypesetterUnsupportedException

Getter for the previous depth parameter.

Specified by:

getPrevDepth in interface ListMaker

Returns:

the previous depth

Throws:

TypesetterUnsupportedException - in case of an error

See Also:

ListMaker.getPrevDepth()

getSpacefactor

public long getSpacefactor()
                    throws TypesetterUnsupportedException

Getter for the space factor.

Specified by:

getSpacefactor in interface ListMaker

Returns:

the space factor

Throws:

TypesetterUnsupportedException - in case of an error

See Also:

ListMaker.getSpacefactor()

isShipoutMark

public boolean isShipoutMark()

Query the ship-out mark. The ship-out mark is an internal state which records whether or not the ship-out method has been called recently. This method can be used to get the current state. The method clearShipoutMark() can be used to reset the ship-out mark to false. Initially the ship-out mark is false.

Specified by:

isShipoutMark in interface Typesetter

Returns:

true iff there has been an invocation to the method shipout() since the last clearing

See Also:

Typesetter.isShipoutMark()

leftBrace

public void leftBrace()

Notification method to deal the case that a left brace has been encountered.

Specified by:

leftBrace in interface ListMaker

See Also:

ListMaker.leftBrace()

letter

public boolean letter(UnicodeChar uc,
                      TypesettingContext tc,
                      Context context,
                      TokenSource source,
                      Locator locator)
               throws TypesetterException

Add a letter to the current list or treat it in some other appropriate way.

Specified by:

letter in interface TokenDelegateListMaker

Parameters:

uc - the character

tc - the typesetting context

context - the interpreter context

source - the source for new tokens

locator - the locator

Returns:

true iff the character has been discarded because it is not defined in the current font.

Throws:

TypesetterException - in case of an error

See Also:

TokenDelegateListMaker.letter( org.extex.core.UnicodeChar, org.extex.typesetter.tc.TypesettingContext, org.extex.interpreter.context.Context, org.extex.interpreter.TokenSource, org.extex.core.Locator)

mathShift

public void mathShift(Context context,
                      TokenSource source,
                      Token t)
               throws TypesetterException,
                      ConfigurationException,
                      HelpingException

Treat a math shift character. Usually this leads to entering or leaving math mode – maybe after inspection of a following token.

Specified by:

mathShift in interface TokenDelegateListMaker

Parameters:

context - the interpreter context

source - the source for new tokens

t - the actual math shift character token

Throws:

TypesetterException - in case of an error

ConfigurationException - in case of a configuration error

HelpingException - in case of an error

See Also:

TokenDelegateListMaker.mathShift( org.extex.interpreter.context.Context, org.extex.interpreter.TokenSource, org.extex.scanner.type.token.Token)

par

public void par()
         throws TypesetterException,
                ConfigurationException

Emit a new paragraph. This might be a noop under certain circumstances.

Specified by:

par in interface ListMaker

Throws:

TypesetterException - in case of an error

ConfigurationException - in case of a configuration error

See Also:

ListMaker.par()

push

public void push(ListMaker listMaker)
          throws TypesetterException

Open a new list maker and put it in the top of the stack as current box.

Specified by:

push in interface Typesetter

Parameters:

listMaker - the list maker

Throws:

TypesetterException - in case of an error

See Also:

Typesetter.push( org.extex.typesetter.ListMaker)

removeLastNode

public void removeLastNode()

Removes the last node from the list. If the list is empty then nothing is done.

Specified by:

removeLastNode in interface ListMaker

See Also:

ListMaker.removeLastNode()

rightBrace

public void rightBrace()
                throws TypesetterException

Notification method to deal the case that a right brace has been encountered.

Specified by:

rightBrace in interface ListMaker

Throws:

TypesetterException - in case of an error

See Also:

ListMaker.rightBrace()

setBackend

public void setBackend(BackendDriver driver)

Setter for the back-end driver. The back-end driver is addressed whenever a complete page has to be shipped out.

Specified by:

setBackend in interface Typesetter

Parameters:

driver - the new back-end driver

See Also:

Typesetter.setBackend( org.extex.backend.BackendDriver)

setNodeFactory

public void setNodeFactory(NodeFactory nodeFactory)

Setter for the node factory.

Specified by:

setNodeFactory in interface Typesetter

Parameters:

nodeFactory - the node factory

See Also:

Typesetter.setNodeFactory( org.extex.typesetter.type.node.factory.NodeFactory)

setOptions

public void setOptions(TypesetterOptions options)

Setter for the typesetter specific options.

Specified by:

setOptions in interface Typesetter

Parameters:

options - the options to use

See Also:

Typesetter.setOptions( org.extex.typesetter.TypesetterOptions)

setOutputRoutine

public void setOutputRoutine(OutputRoutine output)

Setter for the output routine.

Specified by:

setOutputRoutine in interface Typesetter

Parameters:

output - the output routine

See Also:

Typesetter.setOutputRoutine( org.extex.typesetter.output.OutputRoutine)

setPageBuilder

public void setPageBuilder(PageBuilder pageBuilder)

Setter for the page builder. Since the page builder is not needed this is a noop.

Specified by:

setPageBuilder in interface Typesetter

Parameters:

pageBuilder - the new page builder

See Also:

Typesetter.setPageBuilder( org.extex.typesetter.pageBuilder.PageBuilder)

setParagraphBuilder

public void setParagraphBuilder(ParagraphBuilder paragraphBuilder)

Setter for the paragraph builder.

Specified by:

setParagraphBuilder in interface Typesetter

Parameters:

paragraphBuilder - the paragraph builder to set.

See Also:

Typesetter.setParagraphBuilder( org.extex.typesetter.paragraphBuilder.ParagraphBuilder)

setPrevDepth

public void setPrevDepth(FixedDimen pd)

Setter for the previous depth parameter.

Specified by:

setPrevDepth in interface ListMaker

Parameters:

pd - the previous depth parameter

See Also:

ListMaker.setPrevDepth( org.extex.core.dimen.FixedDimen)

setSpacefactor

public void setSpacefactor(FixedCount sf)

Setter for the space factor.

Specified by:

setSpacefactor in interface ListMaker

Parameters:

sf - the space factor to set

See Also:

ListMaker.setSpacefactor( org.extex.core.count.FixedCount)

shipout

public void shipout(NodeList nodes)

Send a list of nodes to the document writer. As a side effect the ship-out mark is set.

Specified by:

shipout in interface Typesetter

Parameters:

nodes - the nodes to send to the typesetter

See Also:

Typesetter.shipout( org.extex.typesetter.type.NodeList)

showlist

public void showlist(java.lang.StringBuffer sb,
                     long depth,
                     long breadth)

Print the status for \showlists.

Specified by:

showlist in interface ListMaker

Parameters:

sb - the target buffer

depth - the depth of the list display

breadth - the breadth of the list display

See Also:

ListMaker.showlist( java.lang.StringBuffer, long, long)

showlists

public void showlists(java.lang.StringBuffer sb,
                      long depth,
                      long breadth)

This method produces a diagnostic representation of the current lists in a StringBuffer.

Specified by:

showlists in interface Typesetter

Parameters:

sb - the target string buffer

depth - the depth for the display

breadth - the breadth of the display

See Also:

Typesetter.showlists( java.lang.StringBuffer, long, long)

subscriptMark

public void subscriptMark(Context context,
                          TokenSource source,
                          Typesetter typesetter,
                          Token t)
                   throws TypesetterException,
                          HelpingException

Treat a subscript mark. This might be meaningful in math mode only.

Specified by:

subscriptMark in interface TokenDelegateListMaker

Parameters:

context - the interpreter context

source - the source for new tokens

typesetter - the typesetter

t - the actual sub mark token

Throws:

TypesetterException - in case of an error

HelpingException - in case of an error

See Also:

TokenDelegateListMaker.subscriptMark( org.extex.interpreter.context.Context, org.extex.interpreter.TokenSource, org.extex.typesetter.Typesetter, org.extex.scanner.type.token.Token)

superscriptMark

public void superscriptMark(Context context,
                            TokenSource source,
                            Typesetter typesetter,
                            Token t)
                     throws TypesetterException,
                            HelpingException

Treat a superscript mark. This might be meaningful in math mode only.

Specified by:

superscriptMark in interface TokenDelegateListMaker

Parameters:

context - the interpreter context

source - the source for new tokens

typesetter - the typesetter

t - the actual super mark token

Throws:

TypesetterException - in case of an error

HelpingException - in case of an error

See Also:

TokenDelegateListMaker.superscriptMark( org.extex.interpreter.context.Context, org.extex.interpreter.TokenSource, org.extex.typesetter.Typesetter, org.extex.scanner.type.token.Token)

tab

public void tab(Context context,
                TokenSource source,
                Token t)
         throws TypesetterException

Treat a alignment tab character.

Specified by:

tab in interface TokenDelegateListMaker

Parameters:

context - the interpreter context

source - the source for new tokens

t - the actual tab token

Throws:

TypesetterException - in case of an error

See Also:

TokenDelegateListMaker.tab( org.extex.interpreter.context.Context, org.extex.interpreter.TokenSource, org.extex.scanner.type.token.Token)

pushListMaker

public ListMaker pushListMaker(ListMakerType type,
                               Locator locator)
                        throws java.lang.UnsupportedOperationException,
                               TypesetterException

Push a list maker onto the stack and return the old value.

Specified by:

pushListMaker in interface Typesetter

Parameters:

type - the type of the list maker

locator - the locator

Returns:

the new list maker

Throws:

java.lang.UnsupportedOperationException - in case that the type is now known

TypesetterException - in case of an error in the typesetter

See Also:

Typesetter.pushListMaker( org.extex.typesetter.ListMakerType, org.extex.core.Locator)