/* * Copyright 2004-2005 The Apache Software Foundation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /* $Id$ */ package org.apache.fop.layoutmgr; import java.util.ArrayList; import java.util.LinkedList; import java.util.ListIterator; import org.apache.fop.layoutmgr.AbstractBreaker.PageBreakPosition; import org.apache.fop.traits.MinOptMax; class PageBreakingAlgorithm extends BreakingAlgorithm { private LayoutManager topLevelLM; private PageSequenceLayoutManager.PageViewportProvider pageViewportProvider; private LinkedList pageBreaks = null; private ArrayList footnotesList = null; private ArrayList lengthList = null; private int totalFootnotesLength = 0; private int insertedFootnotesLength = 0; private boolean footnotesPending = false; /** * newFootnotes is true if the elements met after the previous break point * contain footnote citations */ private boolean newFootnotes = false; /** * firstNewFootnoteIndex is the index of the first footnote met after the * previous break point */ private int firstNewFootnoteIndex = 0; private int footnoteListIndex = 0; private int footnoteElementIndex = -1; // demerits for a page break that splits a footnote private int splitFootnoteDemerits = 5000; // demerits for a page break that defers a whole footnote to the following page private int deferredFootnoteDemerits = 10000; private MinOptMax footnoteSeparatorLength = null; // the method noBreakBetween(int, int) uses thise variables // to store parameters and result of the last call, in order // to reuse them and take less time private int storedPrevBreakIndex = -1; private int storedBreakIndex = -1; private boolean storedValue = false; public PageBreakingAlgorithm(LayoutManager topLevelLM, PageSequenceLayoutManager.PageViewportProvider pageViewportProvider, int alignment, int alignmentLast, MinOptMax footnoteSeparatorLength, boolean partOverflowRecovery) { super(alignment, alignmentLast, true, partOverflowRecovery); this.topLevelLM = topLevelLM; this.pageViewportProvider = pageViewportProvider; best = new BestPageRecords(); this.footnoteSeparatorLength = (MinOptMax) footnoteSeparatorLength.clone(); // add some stretch, to avoid a restart for every page containing footnotes if (footnoteSeparatorLength.min == footnoteSeparatorLength.max) { footnoteSeparatorLength.max += 10000; } } /** * this class represent a feasible breaking point * with extra information about footnotes */ protected class KnuthPageNode extends KnuthNode { // additional length due to footnotes public int totalFootnotes; // index of the last inserted footnote public int footnoteListIndex; // index of the last inserted element of the last inserted footnote public int footnoteElementIndex; public KnuthPageNode(int position, int line, int fitness, int totalWidth, int totalStretch, int totalShrink, int totalFootnotes, int footnoteListIndex, int footnoteElementIndex, double adjustRatio, int availableShrink, int availableStretch, int difference, double totalDemerits, KnuthNode previous) { super(position, line, fitness, totalWidth, totalStretch, totalShrink, adjustRatio, availableShrink, availableStretch, difference, totalDemerits, previous); this.totalFootnotes = totalFootnotes; this.footnoteListIndex = footnoteListIndex; this.footnoteElementIndex = footnoteElementIndex; } } /** * this class stores information about how the nodes * which could start a line ending at the current element */ protected class BestPageRecords extends BestRecords { private int bestFootnotesLength[] = new int[4]; private int bestFootnoteListIndex[] = new int[4]; private int bestFootnoteElementIndex[] = new int[4]; public void addRecord(double demerits, KnuthNode node, double adjust, int availableShrink, int availableStretch, int difference, int fitness) { super.addRecord(demerits, node, adjust, availableShrink, availableStretch, difference, fitness); bestFootnotesLength[fitness] = insertedFootnotesLength; bestFootnoteListIndex[fitness] = footnoteListIndex; bestFootnoteElementIndex[fitness] = footnoteElementIndex; } public int getFootnotesLength(int fitness) { return bestFootnotesLength[fitness]; } public int getFootnoteListIndex(int fitness) { return bestFootnoteListIndex[fitness]; } public int getFootnoteElementIndex(int fitness) { return bestFootnoteElementIndex[fitness]; } } protected void initialize() { super.initialize(); insertedFootnotesLength = 0; footnoteListIndex = 0; footnoteElementIndex = -1; } protected KnuthNode createNode(int position, int line, int fitness, int totalWidth, int totalStretch, int totalShrink, double adjustRatio, int availableShrink, int availableStretch, int difference, double totalDemerits, KnuthNode previous) { return new KnuthPageNode(position, line, fitness, totalWidth, totalStretch, totalShrink, insertedFootnotesLength, footnoteListIndex, footnoteElementIndex, adjustRatio, availableShrink, availableStretch, difference, totalDemerits, previous); } protected KnuthNode createNode(int position, int line, int fitness, int totalWidth, int totalStretch, int totalShrink) { return new KnuthPageNode(position, line, fitness, totalWidth, totalStretch, totalShrink, ((BestPageRecords) best).getFootnotesLength(fitness), ((BestPageRecords) best).getFootnoteListIndex(fitness), ((BestPageRecords) best).getFootnoteElementIndex(fitness), best.getAdjust(fitness), best.getAvailableShrink(fitness), best.getAvailableStretch(fitness), best.getDifference(fitness), best.getDemerits(fitness), best.getNode(fitness)); } protected void handleBox(KnuthBox box) { if (box instanceof KnuthBlockBox && ((KnuthBlockBox) box).hasAnchors()) { handleFootnotes(((KnuthBlockBox) box).getElementLists()); if (!newFootnotes) { newFootnotes = true; firstNewFootnoteIndex = footnotesList.size() - 1; } } } private void handleFootnotes(LinkedList elementLists) { // initialization if (!footnotesPending) { footnotesPending = true; footnotesList = new ArrayList(); lengthList = new ArrayList(); totalFootnotesLength = 0; } if (!newFootnotes) { newFootnotes = true; firstNewFootnoteIndex = footnotesList.size(); } // compute the total length of the footnotes ListIterator elementListsIterator = elementLists.listIterator(); while (elementListsIterator.hasNext()) { LinkedList noteList = (LinkedList) elementListsIterator.next(); int noteLength = 0; footnotesList.add(noteList); ListIterator noteListIterator = noteList.listIterator(); while (noteListIterator.hasNext()) { KnuthElement element = (KnuthElement) noteListIterator.next(); if (element.isBox() || element.isGlue()) { noteLength += element.getW(); } } int prevLength = (lengthList.size() == 0 ? 0 : ((Integer) lengthList.get(lengthList.size() - 1)).intValue()); lengthList.add(new Integer(prevLength + noteLength)); totalFootnotesLength += noteLength; } } protected void restartFrom(KnuthNode restartingNode, int currentIndex) { super.restartFrom(restartingNode, currentIndex); newFootnotes = false; if (footnotesPending) { // remove from footnotesList the note lists that will be met // after the restarting point for (int j = currentIndex; j >= restartingNode.position; j--) { KnuthElement resettedElement = getElement(j); if (resettedElement instanceof KnuthBlockBox && ((KnuthBlockBox) resettedElement).hasAnchors()) { resetFootnotes(((KnuthBlockBox) resettedElement).getElementLists()); } } } } private void resetFootnotes(LinkedList elementLists) { for (int i = 0; i < elementLists.size(); i++) { LinkedList removedList = (LinkedList) footnotesList.remove(footnotesList.size() - 1); lengthList.remove(lengthList.size() - 1); // update totalFootnotesLength if (lengthList.size() > 0) { totalFootnotesLength = ((Integer) lengthList.get(lengthList.size() - 1)).intValue(); } else { totalFootnotesLength = 0; } } // update footnotesPending; if (footnotesList.size() == 0) { footnotesPending = false; } } protected void considerLegalBreak(KnuthElement element, int elementIdx) { super.considerLegalBreak(element, elementIdx); newFootnotes = false; } /** * Return the difference between the line width and the width of the break that * ends in 'element'. * @param activeNode * @param element * @param elementIndex * @return The difference in width. Positive numbers mean extra space in the line, * negative number that the line overflows. */ protected int computeDifference(KnuthNode activeNode, KnuthElement element, int elementIndex) { KnuthPageNode pageNode = (KnuthPageNode) activeNode; int actualWidth = totalWidth - pageNode.totalWidth; int footnoteSplit; boolean canDeferOldFootnotes; if (element.isPenalty()) { actualWidth += element.getW(); } if (footnotesPending) { // compute the total length of the footnotes not yet inserted int allFootnotes = totalFootnotesLength - pageNode.totalFootnotes; if (allFootnotes > 0) { // this page contains some footnote citations // add the footnote separator width actualWidth += footnoteSeparatorLength.opt; if (actualWidth + allFootnotes <= getLineWidth()) { // there is enough space to insert all footnotes: // add the whole allFootnotes length actualWidth += allFootnotes; insertedFootnotesLength = pageNode.totalFootnotes + allFootnotes; footnoteListIndex = footnotesList.size() - 1; footnoteElementIndex = ((LinkedList) footnotesList.get(footnoteListIndex)).size() - 1; } else if (((canDeferOldFootnotes = checkCanDeferOldFootnotes(pageNode, elementIndex)) || newFootnotes) && (footnoteSplit = getFootnoteSplit(pageNode, getLineWidth() - actualWidth, canDeferOldFootnotes)) > 0) { // it is allowed to break or even defer footnotes if either: // - there are new footnotes in the last piece of content, and // there is space to add at least a piece of the first one // - or the previous page break deferred some footnote lines, and // this is the first feasible break; in this case it is allowed // to break and defer, if necessary, old and new footnotes actualWidth += footnoteSplit; insertedFootnotesLength = pageNode.totalFootnotes + footnoteSplit; // footnoteListIndex has been set in getFootnoteSplit() // footnoteElementIndex has been set in getFootnoteSplit() } else { // there is no space to add the smallest piece of footnote, // or we are trying to add a piece of content with no footnotes and // it does not fit in the page, because of previous footnote bodies // that cannot be broken: // add the whole allFootnotes length, so this breakpoint will be discarded actualWidth += allFootnotes; insertedFootnotesLength = pageNode.totalFootnotes + allFootnotes; footnoteListIndex = footnotesList.size() - 1; footnoteElementIndex = ((LinkedList) footnotesList.get(footnoteListIndex)).size() - 1; } } else { // all footnotes have already been placed on previous pages } } else { // there are no footnotes } return getLineWidth(activeNode.line) - actualWidth; } private boolean checkCanDeferOldFootnotes(KnuthPageNode node, int contentElementIndex) { return (noBreakBetween(node.position, contentElementIndex) && deferredFootnotes(node.footnoteListIndex, node.footnoteElementIndex, node.totalFootnotes)); } private boolean noBreakBetween(int prevBreakIndex, int breakIndex) { // this method stores the parameters and the return value from previous calls // in order to avoid scanning the element list unnecessarily: // - if there is no break between element #i and element #j // there will not be a break between #(i+h) and #j too // - if there is a break between element #i and element #j // there will be a break between #(i-h) and #(j+k) too if (storedPrevBreakIndex != -1 && ((prevBreakIndex >= storedPrevBreakIndex && breakIndex == storedBreakIndex && storedValue) || (prevBreakIndex <= storedPrevBreakIndex && breakIndex >= storedBreakIndex && !storedValue))) { // use the stored value, do nothing } else { // compute the new value int index; // ignore suppressed elements for (index = prevBreakIndex + 1; !par.getElement(index).isBox(); index ++) { } // find the next break for (; index <= breakIndex; index ++) { if (par.getElement(index).isGlue() && par.getElement(index - 1).isBox() || par.getElement(index).isPenalty() && par.getElement(index).getP() < KnuthElement.INFINITE) { // break found break; } } // update stored parameters and value storedPrevBreakIndex = prevBreakIndex; storedBreakIndex = breakIndex; storedValue = (index == breakIndex); } return storedValue; } private boolean deferredFootnotes(int listIndex, int elementIndex, int length) { return ((newFootnotes && firstNewFootnoteIndex != 0 && (listIndex < firstNewFootnoteIndex - 1 || elementIndex < ((LinkedList) footnotesList.get(listIndex)).size() - 1)) || length < totalFootnotesLength); } private int getFootnoteSplit(KnuthPageNode activeNode, int availableLength, boolean canDeferOldFootnotes) { return getFootnoteSplit(activeNode.footnoteListIndex, activeNode.footnoteElementIndex, activeNode.totalFootnotes, availableLength, canDeferOldFootnotes); } private int getFootnoteSplit(int prevListIndex, int prevElementIndex, int prevLength, int availableLength, boolean canDeferOldFootnotes) { if (availableLength <= 0) { return 0; } else { // the split should contain a piece of the last footnote // together with all previous, not yet inserted footnotes; // but if this is not possible, try adding as much content as possible int splitLength = 0; ListIterator noteListIterator = null; KnuthElement element = null; boolean somethingAdded = false; // prevListIndex and prevElementIndex points to the last footnote element // already placed in a page: advance to the next element int listIndex = prevListIndex; int elementIndex = prevElementIndex; if (elementIndex == ((LinkedList) footnotesList.get(listIndex)).size() - 1) { listIndex ++; elementIndex = 0; } else { elementIndex ++; } // try adding whole notes if (footnotesList.size() - 1 > listIndex) { // add the previous footnotes: these cannot be broken or deferred if (!canDeferOldFootnotes && newFootnotes && firstNewFootnoteIndex > 0) { splitLength = ((Integer) lengthList.get(firstNewFootnoteIndex - 1)).intValue() - prevLength; listIndex = firstNewFootnoteIndex; elementIndex = 0; } // try adding the new footnotes while (((Integer) lengthList.get(listIndex)).intValue() - prevLength <= availableLength) { splitLength = ((Integer) lengthList.get(listIndex)).intValue() - prevLength; somethingAdded = true; listIndex ++; elementIndex = 0; } // as this method is called only if it is not possible to insert // all footnotes, at this point listIndex and elementIndex points to // an existing element, the next one we will try to insert } // try adding a split of the next note noteListIterator = ((LinkedList) footnotesList.get(listIndex)).listIterator(elementIndex); int prevSplitLength = 0; int prevIndex = -1; int index = -1; while (!(somethingAdded && splitLength > availableLength)) { if (!somethingAdded) { somethingAdded = true; } else { prevSplitLength = splitLength; prevIndex = index; } // get a sub-sequence from the note element list boolean bPrevIsBox = false; while (noteListIterator.hasNext()) { // as this method is called only if it is not possible to insert // all footnotes, and we have already tried (and failed) to insert // this whole footnote, the while loop will never reach the end // of the note sequence element = (KnuthElement) noteListIterator.next(); if (element.isBox()) { // element is a box splitLength += element.getW(); bPrevIsBox = true; } else if (element.isGlue()) { // element is a glue if (bPrevIsBox) { // end of the sub-sequence index = noteListIterator.previousIndex(); break; } bPrevIsBox = false; splitLength += element.getW(); } else { // element is a penalty if (element.getP() < KnuthElement.INFINITE) { // end of the sub-sequence index = noteListIterator.previousIndex(); break; } } } } // if prevSplitLength is 0, this means that the available length isn't enough // to insert even the smallest split of the last footnote, so we cannot end a // page here // if prevSplitLength is > 0 we can insert some footnote content in this page // and insert the remaining in the following one if (!somethingAdded) { // there was not enough space to add a piece of the first new footnote // this is not a good break prevSplitLength = 0; } else if (prevSplitLength > 0) { // prevIndex is -1 if we have added only some whole footnotes footnoteListIndex = (prevIndex != -1) ? listIndex : listIndex - 1; footnoteElementIndex = (prevIndex != -1) ? prevIndex : ((LinkedList) footnotesList.get(footnoteListIndex)).size() - 1; } return prevSplitLength; } } /** * Return the adjust ration needed to make up for the difference. A ratio of * * @param activeNode * @param difference * @return The ration. */ protected double computeAdjustmentRatio(KnuthNode activeNode, int difference) { // compute the adjustment ratio if (difference > 0) { int maxAdjustment = totalStretch - activeNode.totalStretch; // add the footnote separator stretch if some footnote content will be added if (((KnuthPageNode) activeNode).totalFootnotes < totalFootnotesLength) { maxAdjustment += footnoteSeparatorLength.max - footnoteSeparatorLength.opt; } if (maxAdjustment > 0) { return (double) difference / maxAdjustment; } else { return INFINITE_RATIO; } } else if (difference < 0) { int maxAdjustment = totalShrink - activeNode.totalShrink; // add the footnote separator shrink if some footnote content will be added if (((KnuthPageNode) activeNode).totalFootnotes < totalFootnotesLength) { maxAdjustment += footnoteSeparatorLength.opt - footnoteSeparatorLength.min; } if (maxAdjustment > 0) { return (double) difference / maxAdjustment; } else { return -INFINITE_RATIO; } } else { return 0; } } protected double computeDemerits(KnuthNode activeNode, KnuthElement element, int fitnessClass, double r) { double demerits = 0; // compute demerits double f = Math.abs(r); f = 1 + 100 * f * f * f; if (element.isPenalty() && element.getP() >= 0) { f += element.getP(); demerits = f * f; } else if (element.isPenalty() && !element.isForcedBreak()) { double penalty = element.getP(); demerits = f * f - penalty * penalty; } else { demerits = f * f; } if (element.isPenalty() && ((KnuthPenalty) element).isFlagged() && getElement(activeNode.position).isPenalty() && ((KnuthPenalty) getElement(activeNode.position)).isFlagged()) { // add demerit for consecutive breaks at flagged penalties demerits += repeatedFlaggedDemerit; } if (Math.abs(fitnessClass - activeNode.fitness) > 1) { // add demerit for consecutive breaks // with very different fitness classes demerits += incompatibleFitnessDemerit; } if (footnotesPending) { if (footnoteListIndex < footnotesList.size() - 1) { // add demerits for the deferred footnotes demerits += (footnotesList.size() - 1 - footnoteListIndex) * deferredFootnoteDemerits; } if (footnoteElementIndex < ((LinkedList) footnotesList.get(footnoteListIndex)).size() - 1) { // add demerits for the footnote split between pages demerits += splitFootnoteDemerits; } } demerits += activeNode.totalDemerits; return demerits; } protected void finish() { for (int i = startLine; i < endLine; i++) { for (KnuthPageNode node = (KnuthPageNode) getNode(i); node != null; node = (KnuthPageNode) node.next) { if (node.totalFootnotes < totalFootnotesLength) { // layout remaining footnote bodies createFootnotePages(node); } } } } private void createFootnotePages(KnuthPageNode lastNode) { insertedFootnotesLength = lastNode.totalFootnotes; footnoteListIndex = lastNode.footnoteListIndex; footnoteElementIndex = lastNode.footnoteElementIndex; int availableBPD = getLineWidth(); int split = 0; KnuthPageNode prevNode = lastNode; // create pages containing the remaining footnote bodies while (insertedFootnotesLength < totalFootnotesLength) { // try adding some more content if (((Integer) lengthList.get(footnoteListIndex)).intValue() - insertedFootnotesLength <= availableBPD) { // add a whole footnote availableBPD -= ((Integer) lengthList.get(footnoteListIndex)).intValue() - insertedFootnotesLength; insertedFootnotesLength = ((Integer) lengthList.get(footnoteListIndex)).intValue(); footnoteElementIndex = ((LinkedList) footnotesList.get(footnoteListIndex)).size() - 1; } else if ((split = getFootnoteSplit(footnoteListIndex, footnoteElementIndex, insertedFootnotesLength, availableBPD, true)) > 0) { // add a piece of a footnote availableBPD -= split; insertedFootnotesLength += split; // footnoteListIndex has already been set in getFootnoteSplit() // footnoteElementIndex has already been set in getFootnoteSplit() } else { // cannot add any content: create a new node and start again KnuthPageNode node = (KnuthPageNode) createNode(lastNode.position, prevNode.line + 1, 1, insertedFootnotesLength - prevNode.totalFootnotes, 0, 0, 0, 0, 0, 0, 0, prevNode); addNode(node.line, node); removeNode(prevNode.line, prevNode); prevNode = node; availableBPD = getLineWidth(); } } // create the last node KnuthPageNode node = (KnuthPageNode) createNode(lastNode.position, prevNode.line + 1, 1, totalFootnotesLength - prevNode.totalFootnotes, 0, 0, 0, 0, 0, 0, 0, prevNode); addNode(node.line, node); removeNode(prevNode.line, prevNode); } /** * Remove the first node in line 'line'. If the line then becomes empty, adjust the * startLine accordingly. * @param line * @param node */ protected void removeNode(int line, KnuthNode node) { KnuthNode n = getNode(line); if (n != node) { if (footnotesPending) { // nodes could be rightly deactivated in a different order KnuthNode prevNode = null; while (n != node) { prevNode = n; n = n.next; } prevNode.next = n.next; if (prevNode.next == null) { activeLines[line*2+1] = prevNode; } } else { log.error("Should be first"); } } else { activeLines[line*2] = node.next; if (node.next == null) { activeLines[line*2+1] = null; } while (startLine < endLine && getNode(startLine) == null) { startLine++; } } activeNodeCount--; } public LinkedList getPageBreaks() { return pageBreaks; } public void insertPageBreakAsFirst(PageBreakPosition pageBreak) { if (pageBreaks == null) { pageBreaks = new LinkedList(); } pageBreaks.addFirst(pageBreak); } public void updateData1(int total, double demerits) { } public void updateData2(KnuthNode bestActiveNode, KnuthSequence sequence, int total) { //int difference = (bestActiveNode.line < total) ? bestActiveNode.difference : bestActiveNode.difference + fillerMinWidth; int difference = bestActiveNode.difference; int blockAlignment = (bestActiveNode.line < total) ? alignment : alignmentLast; // it is always allowed to adjust space, so the ratio must be set regardless of // the value of the property display-align; the ratio must be <= 1 double ratio = bestActiveNode.adjustRatio; if (ratio < 0) { // page break with a negative difference: // spaces always have enough shrink difference = 0; } else if (ratio <= 1 && bestActiveNode.line < total) { // not-last page break with a positive difference smaller than the available stretch: // spaces can stretch to fill the whole difference difference = 0; } else if (ratio > 1) { // not-last page with a positive difference greater than the available stretch // spaces can stretch to fill the difference only partially ratio = 1; difference -= bestActiveNode.availableStretch; } else { // last page with a positive difference: // spaces do not need to stretch ratio = 0; } // compute the indexes of the first footnote list and the first element in that list int firstListIndex = ((KnuthPageNode) bestActiveNode.previous).footnoteListIndex; int firstElementIndex = ((KnuthPageNode) bestActiveNode.previous).footnoteElementIndex; if (footnotesList != null && firstElementIndex == ((LinkedList) footnotesList.get(firstListIndex)).size() - 1) { // advance to the next list firstListIndex ++; firstElementIndex = 0; } else { firstElementIndex ++; } // add nodes at the beginning of the list, as they are found // backwards, from the last one to the first one if (log.isDebugEnabled()) { log.debug("BBA> difference=" + difference + " ratio=" + ratio + " position=" + bestActiveNode.position); } insertPageBreakAsFirst(new PageBreakPosition(this.topLevelLM, bestActiveNode.position, firstListIndex, firstElementIndex, ((KnuthPageNode) bestActiveNode).footnoteListIndex, ((KnuthPageNode) bestActiveNode).footnoteElementIndex, ratio, difference)); } protected int filterActiveNodes() { // leave only the active node with fewest total demerits KnuthNode bestActiveNode = null; for (int i = startLine; i < endLine; i++) { for (KnuthNode node = getNode(i); node != null; node = node.next) { bestActiveNode = compareNodes(bestActiveNode, node); if (node != bestActiveNode) { removeNode(i, node); } } } return bestActiveNode.line; } public LinkedList getFootnoteList(int index) { return (LinkedList) footnotesList.get(index); } /** @see org.apache.fop.layoutmgr.BreakingAlgorithm#getLineWidth(int) */ protected int getLineWidth(int line) { int bpd; if (pageViewportProvider != null) { bpd = pageViewportProvider.getAvailableBPD(line); } else { bpd = super.getLineWidth(line); } if (log.isTraceEnabled()) { log.trace("getLineWidth(" + line + ") -> " + bpd); } return bpd; } }