Class Layer

java.lang.Object
com.openhtmltopdf.layout.Layer
public class Layer extends Object
All positioned content as well as content with an overflow value other than visible creates a layer. Layers which define stacking contexts provide the entry for rendering the box tree to an output device. The main purpose of this class is to provide an implementation of Appendix E of the spec, but it also provides additional utility services including page management and mapping boxes to coordinates (for e.g. links). When rendering to a paged output device, the layer is also responsible for laying out absolute content (which is layed out after its containing block has completed layout).

  • Field Details

  • Constructor Details

    • Layer

      public Layer(Box master, CssContext c)
      Creates the root layer.

    • Layer

      public Layer(Box master, CssContext c, boolean isolated)

    • Layer

      public Layer(Layer parent, Box master, CssContext c)
      Creates a child layer.

  • Method Details

    • propagateCurrentTransformationMatrix

      public void propagateCurrentTransformationMatrix(CssContext c)
      Recursively propagates the transformation matrix. This must be done after layout of the master box and its children as this method relies on the box width and height for relative units in the transforms and transform origins.

    • getCurrentTransformMatrix

      public AffineTransform getCurrentTransformMatrix()
      The document coordinates current transform, this is cumulative from layer to child layer. May be null, if identity transform is in effect. Used to check if a box belonging to this layer sits on a particular page after the transform is applied. This method can only be used after propagateCurrentTransformationMatrix(CssContext) has been called on the root layer.
      Returns:
      null or affine transform.

    • hasLocalTransform

      public boolean hasLocalTransform()

    • setForDeletion

      public void setForDeletion(boolean forDeletion)

    • isForDeletion

      public boolean isForDeletion()

    • hasFixedAncester

      public boolean hasFixedAncester()

    • getParent

      public Layer getParent()

    • isStackingContext

      public boolean isStackingContext()

    • setStackingContext

      public void setStackingContext(boolean stackingContext)

    • getZIndex

      public int getZIndex()

    • isZIndexAuto

      public boolean isZIndexAuto()

    • getMaster

      public Box getMaster()

    • addChild

      public void addChild(Layer layer)

    • createPageBox

      public static PageBox createPageBox(CssContext c, String pseudoPage)

    • removeFloat

      public void removeFloat(BlockBox floater)
      FIXME: Only used when we reset a box, so trying to remove at sometime in the future.

    • addFloat

      public void addFloat(BlockBox floater, BlockFormattingContext bfc)

    • collectLayers

      public List<Layer> collectLayers(int which)
      Called recusively to collect all descendant layers in a layer tree so they can be painted in correct order.
      Parameters:
      which - NEGATIVE ZERO POSITIVE AUTO corresponding to z-index property.

    • getSortedLayers

      public List<Layer> getSortedLayers(int which)

    • getPaintingDimension

      public Dimension getPaintingDimension(LayoutContext c)

    • paint

      @Deprecated public void paint(RenderingContext c)
      Deprecated.

    • getFloats

      public List<BlockBox> getFloats()

    • applyTranform

      @Deprecated protected List<AffineTransform> applyTranform(RenderingContext c, Box box)
      Deprecated.
      Applies the transforms specified for the box and returns a list of inverse transforms that should be applied once the transformed element has been output.

    • find

      @Deprecated public Box find(CssContext cssCtx, int absX, int absY, boolean findAnonymous)
      Deprecated.

    • paintAsLayer

      @Deprecated public void paintAsLayer(RenderingContext c, BlockBox startingPoint)
      Deprecated.

    • positionFixedLayer

      public void positionFixedLayer(RenderingContext c)

    • isRootLayer

      public boolean isRootLayer()

    • positionChildren

      public void positionChildren(LayoutContext c)

    • getChildren

      public List<Layer> getChildren()
      The resulting list should not be modified.

    • detach

      public void detach()

    • isInline

      public boolean isInline()

    • setInline

      public void setInline(boolean inline)

    • getEnd

      public Box getEnd()

    • setEnd

      public void setEnd(Box end)

    • isRequiresLayout

      public boolean isRequiresLayout()

    • setRequiresLayout

      public void setRequiresLayout(boolean requiresLayout)

    • finish

      public void finish(LayoutContext c)

    • getPages

      public List<PageBox> getPages()

    • setPages

      public void setPages(List<PageBox> pages)

    • isLastPage

      public boolean isLastPage(PageBox pageBox)

    • removeLastPage

      public void removeLastPage()

    • addPage

      public void addPage(CssContext c)

    • getFirstPage

      public PageBox getFirstPage(CssContext c, int absY)
      Returns the page box for a Y position. If the y position is less than 0 then the first page will be returned if available. Only returns null if there are no pages available.

      IMPORTANT: If absY is past the end of the last page, pages will be created as required to include absY and the last page will be returned.

    • getFirstPage

      public PageBox getFirstPage(CssContext c, Box box)

    • getLastPage

      public PageBox getLastPage(CssContext c, Box box)

    • ensureHasPage

      public void ensureHasPage(CssContext c, Box box)

    • getPages

      public List<PageBox> getPages(CssContext c, int top, int bottom)
      Tries to return a list of pages that cover top to bottom. If top and bottom are less-than zero returns null.

      IMPORTANT: If bottom is past the end of the last page, pages are created until bottom is included.

    • getPage

      public PageBox getPage(CssContext c, int yOffset)
      Gets the page box for the given document y offset. If y offset is less-than zero returns null.

      IMPORTANT: If y offset is past the end of the last page, pages are created until y offset is included and the last page is returned.

    • trimEmptyPages

      public void trimEmptyPages(CssContext c, int maxYHeight)

    • trimPageCount

      public void trimPageCount(int newPageCount)

    • assignPagePaintingPositions

      public void assignPagePaintingPositions(CssContext cssCtx, short mode)

    • assignPagePaintingPositions

      public void assignPagePaintingPositions(CssContext cssCtx, int mode, int additionalClearance)

    • getMaxPageWidth

      public int getMaxPageWidth(CssContext cssCtx, int additionalClearance)

    • getLastPage

      public PageBox getLastPage()

    • crossesPageBreak

      public boolean crossesPageBreak(LayoutContext c, int top, int bottom)
      Returns whether the a box with the given top and bottom would cross a page break.

      Requirements: top is >= 0.

      Important: This method will take into account any float: bottom content when used in in-flow content. For example, if the top/bottom pair overlaps the footnote area, returns true. It also takes into account space set aside for paginated table header/footer.

      See CssContext.isInFloatBottom() LayoutContext.getExtraSpaceBottom()

    • findRoot

      public Layer findRoot()

    • addRunningBlock

      public void addRunningBlock(BlockBox block)

    • removeRunningBlock

      public void removeRunningBlock(BlockBox block)

    • getRunningBlock

      public BlockBox getRunningBlock(String identifer, PageBox page, PageElementPosition which)

    • layoutPages

      public void layoutPages(LayoutContext c)

    • addPageSequence

      public void addPageSequence(BlockBox start)

    • getRelativePageNo

      public int getRelativePageNo(RenderingContext c, int absY)

    • getRelativePageNo

      public int getRelativePageNo(RenderingContext c)

    • getRelativePageCount

      public int getRelativePageCount(RenderingContext c)

    • getSelectionEnd

      public Box getSelectionEnd()

    • setSelectionEnd

      public void setSelectionEnd(Box selectionEnd)

    • getSelectionStart

      public Box getSelectionStart()

    • setSelectionStart

      public void setSelectionStart(Box selectionStart)

    • getSelectionEndX

      public int getSelectionEndX()

    • setSelectionEndX

      public void setSelectionEndX(int selectionEndX)

    • getSelectionEndY

      public int getSelectionEndY()

    • setSelectionEndY

      public void setSelectionEndY(int selectionEndY)

    • getSelectionStartX

      public int getSelectionStartX()

    • setSelectionStartX

      public void setSelectionStartX(int selectionStartX)

    • getSelectionStartY

      public int getSelectionStartY()

    • setSelectionStartY

      public void setSelectionStartY(int selectionStartY)

    • isIsolated

      public boolean isIsolated()