Package org.apache.fop.layoutmgr
Class KnuthGlue
java.lang.Object
org.apache.fop.layoutmgr.ListElement
org.apache.fop.layoutmgr.KnuthElement
org.apache.fop.layoutmgr.KnuthGlue
An instance of this class represents a piece of content with adjustable
width: for example a space between words of justified text.
A KnuthGlue is a feasible breaking point only if it immediately follows
a KnuthBox.
The represented piece of content is suppressed if either the KnuthGlue
is a chosen breaking point or there isn't any KnuthBox between the
previous breaking point and the KnuthGlue itself.
So, an unsuppressible piece of content with adjustable width, for example
a leader or a word with adjustable letter space, cannot be represented
by a single KnuthGlue; it can be represented using the sequence:
KnuthBox(width = 0)
KnuthPenalty(width = 0, penalty = infinity)
KnuthGlue(...)
KnuthBox(width = 0)
where the infinity penalty avoids choosing the KnuthGlue as a breaking point
and the 0-width KnuthBoxes prevent suppression.
Besides the inherited methods and attributes, this class has two attributes
used to store the stretchability (difference between max and opt width) and
the shrinkability (difference between opt and min width), and the methods
to get these values.
-
Field Summary
Fields inherited from class org.apache.fop.layoutmgr.KnuthElement
INFINITE
-
Constructor Summary
ConstructorDescriptionKnuthGlue
(int width, int stretch, int shrink, Adjustment adjustmentClass, Position pos, boolean auxiliary) Creates a newKnuthGlue
.Creates a newKnuthGlue
.Creates a newKnuthGlue
. -
Method Summary
Methods inherited from class org.apache.fop.layoutmgr.KnuthElement
getPenalty, getWidth, isAuxiliary, isUnresolvedElement
Methods inherited from class org.apache.fop.layoutmgr.ListElement
getLayoutManager, getPosition, isBox, isForcedBreak, isPenalty, setPosition
-
Constructor Details
-
KnuthGlue
Creates a newKnuthGlue
.- Parameters:
minOptMax
- aMinOptMax
where theopt-value
is mapped to the width, thestretchability
is mapped to the stretchability and the theshrinkability
is mapped to the shrinkabilitypos
- the Position stored in this glueauxiliary
- is this glue auxiliary?
-
KnuthGlue
Creates a newKnuthGlue
.- Parameters:
width
- the width of this gluestretch
- the stretchability of this glueshrink
- the shrinkability of this gluepos
- the Position stored in this glueauxiliary
- is this glue auxiliary?
-
KnuthGlue
public KnuthGlue(int width, int stretch, int shrink, Adjustment adjustmentClass, Position pos, boolean auxiliary) Creates a newKnuthGlue
.- Parameters:
width
- the width of this gluestretch
- the stretchability of this glueshrink
- the shrinkability of this glueadjustmentClass
- the adjsutment classpos
- the Position stored in this glueauxiliary
- is this glue auxiliary?
-
-
Method Details
-
isGlue
public boolean isGlue()- Overrides:
isGlue
in classListElement
- Returns:
- true if this element is a KnuthGlue.
-
getStretch
public int getStretch()- Overrides:
getStretch
in classKnuthElement
- Returns:
- the stretchability of this glue.
-
getShrink
public int getShrink()- Overrides:
getShrink
in classKnuthElement
- Returns:
- the shrinkability of this glue.
-
getAdjustmentClass
- Returns:
- the adjustment class (or role) of this glue.
-
toString
-