Class TLcdGXYViewComponentPrintable

java.lang.Object
com.luciad.view.swing.ALcdViewComponentPrintable
com.luciad.view.gxy.swing.TLcdGXYViewComponentPrintable
All Implemented Interfaces:
ILcdChangeSource, ILcdDisposable, ILcdStatusSource, Printable, AutoCloseable

public class TLcdGXYViewComponentPrintable extends ALcdViewComponentPrintable implements ILcdStatusSource
Prints the contents of a given Component containing a GXY view component. This view component is used to avoid changing the original view.

By default, the component is scaled to fit in the imageable part of the page. If the component no longer fits on a single page, a multi-page print is created, with optional crop marks and positioning marks indicating where and how the pages should be joined (setCropMarks(boolean), setPositioningMarks(boolean)). The methods getPageCountX and getPageCountY allow to see how many pages will be required.

There are two ways to define the number of pages printed.

  • By calling the usePageCount(int, int) method: When using this method, this class will try to use the number of pages specified. Because the aspect ratio of the view component does not necessarily match the aspect ratio of the printable area on the pages, it is possible that less pages are used.
  • By calling the useMapScale(double) method: When using this method, this class will make sure the map scale is preserved by adjusting the number of pages.

By default, the component is centered on the page or the set of pages. Alternatively, its position can also be set explicitly (setOrigin(Point)).

Note that the effects of rounding to integer AWT coordinates during painting may become more obvious in print. The component's print method must never overwrite the transformation of the Graphics using the setTransform method. Instead, it must always use relative transformation methods, such as scale.

Since:
2013.0
  • Constructor Details

    • TLcdGXYViewComponentPrintable

      public TLcdGXYViewComponentPrintable(Component aComponent)
      Creates a new printable for the given component.
      Parameters:
      aComponent - the component to print. This component should contain a view component. If not, an exception is thrown. The component does not have to be part
  • Method Details

    • dispose

      public void dispose()
      Cleans up
      Specified by:
      dispose in interface ILcdDisposable
    • createViewComponent

      public static Component createViewComponent(ILcdGXYView aView, ILcdFilter<ILcdGXYLayer> aLayerFilter)
      Creates a Component representing the given view. The component passed to the constructor of this class should either be, or contain this component. The component can be laid out, along with other components, and passed to this class.

      Note that this component only stays valid when the given ILcdGXYView stays the same. If for example, layers are added/removed from the given ILcdGXYView, or if the scale/viewOrigin/worldOrigin/... changes, the component that is created in this method will stay unchanged. In that case it is needed to recreate this component.

      Parameters:
      aView - the view for which to create a component.
      aLayerFilter - a filter that determines which layers are printed. Can be null.
      Returns:
      a component for the view.
    • usePageCount

      public void usePageCount(int aPageCountX, int aPageCountY)
      Sets the number of pages in the x and y direction. Note that either this method or the useMapScale(double) method should be used. When calling useMapScale(double) after this method was called, this method will have no effect.

      Note that after calling this method, getPageCountX and getPageCountY may differ from aPageCountX and aPageCountY. This is because the aspect ratio of the view component is most likely not the same as the aspect ratio of the pages.

      Parameters:
      aPageCountX - the page count in the x direction.
      aPageCountY - the page count in the y direction.
      See Also:
    • useMapScale

      public void useMapScale(double aMapScale)
      Sets the map scale to use when printing. Note that either this method or the usePageCount(int, int) method should be used. When calling usePageCount(int, int) after this method was called, this method will have no effect.
      Parameters:
      aMapScale - a ratio that represents 1 / denominator. For example: a MapScale of 1:50000 can be created using 0.00002 (=1.0/50_000) as value.
    • invalidate

      public void invalidate()
      Invalidates this printable. This is for example needed when a component was added or removed from getComponent(), or when a component was resized.
    • getPrintArea

      public ILcdBounds getPrintArea(PageFormat aPageFormat)
      Returns the used printing area.
      Parameters:
      aPageFormat - the page format.
      Returns:
      the used printing area.
    • getPageCountX

      public int getPageCountX(PageFormat aPageFormat)
      Description copied from class: ALcdViewComponentPrintable
      Returns the page count in the x-direction.
      Specified by:
      getPageCountX in class ALcdViewComponentPrintable
      Parameters:
      aPageFormat - the page format
      Returns:
      the page count in the x-direction.
    • getPageCountY

      public int getPageCountY(PageFormat aPageFormat)
      Description copied from class: ALcdViewComponentPrintable
      Returns the page count in the y-direction.
      Specified by:
      getPageCountY in class ALcdViewComponentPrintable
      Parameters:
      aPageFormat - the page format
      Returns:
      the page count in the y-direction.
    • getMapScale

      public double getMapScale(PageFormat aPageFormat)
      Description copied from class: ALcdViewComponentPrintable
      Returns the map scale (e.g. 1:25.000).
      Specified by:
      getMapScale in class ALcdViewComponentPrintable
      Parameters:
      aPageFormat - the page format
      Returns:
      the map scale.
    • setPrintAreaBounds

      public void setPrintAreaBounds(ILcdBounds aBounds)
      Sets the bounds area to use when printing the view. The given bounds should be defined in the world reference of the printed view. Since the aspect ratio of the given area may be modified during printing, the actual print area can be queried using the getPrintArea(PageFormat) method.

      When setting this value to null, the view extents of the printed view area used instead.

      The default is null.

      Parameters:
      aBounds - the print area bounds in world coordinates.
      See Also:
    • getPrintAreaBounds

      public ILcdBounds getPrintAreaBounds()
      Returns the print area bounds.
      Returns:
      the print area bounds.
      See Also:
    • setSnapToFullPages

      public void setSnapToFullPages(boolean aUseSnapToFullPages)
      Specifies weather the content should fill the entire pages. By default this value is true.
      Parameters:
      aUseSnapToFullPages - true to specify that the content should fill the entire pages.
      See Also:
    • isSnapToFullPages

      public boolean isSnapToFullPages()
      Returns if snap to full pages is used.
      Returns:
      if snap to full pages is used.
      See Also:
    • setDPI

      public void setDPI(int aDPI)
      Sets the rasterization quality in DPI. The default is 144.
      Parameters:
      aDPI - the rasterization quality in dpi.
      See Also:
    • getDPI

      public int getDPI()
      Returns the rasterization quality in dpi.
      Specified by:
      getDPI in class ALcdViewComponentPrintable
      Returns:
      the rasterization quality in dpi.
      See Also:
    • setFeatureScale

      public void setFeatureScale(double aFeatureScale)
      Changes the relative size of features (such as icons, labels or line widths) in a view. The default value is 1.

      Lower values will make features proportionally smaller (allowing, for instance, more labels to be placed). Higher values will make features proportionally larger (for instance, to make text more readable on very high-resolution displays).

      Feature scale may also affect level-of-detail decisions, e.g. for raster layers. Lower feature scales may cause higher detail levels to be shown (and vice versa).

      A possible use case is printing a complex CAD drawing, where you would like to reduce the line widths to get a detailed print-out. Use for example 0.25. Another use case is to make a print-out that will be looked at from a distance. A larger value (e.g. 2.0) makes sure the lines are still visible from a distance.

      Parameters:
      aFeatureScale - the size factor for line widths, icons sizes, font sizes ...
      See Also:
    • getFeatureScale

      public double getFeatureScale()
      Returns the relative size of features (such as icons, labels or line widths) in a view. The default value is 1.

      Lower values will make features proportionally smaller (allowing, for instance, more labels to be placed). Higher values will make features proportionally larger (for instance, to make text more readable on very high-resolution displays).

      Feature scale may also affect level-of-detail decisions, e.g. for raster layers. Lower feature scales may cause higher detail levels to be shown (and vice versa).

      A possible use case is printing a complex CAD drawing, where you would like to reduce the line widths to get a detailed print-out. Use for example 0.25. Another use case is to make a print-out that will be looked at from a distance. A larger value (e.g. 2.0) makes sure the lines are still visible from a distance.

      Specified by:
      getFeatureScale in class ALcdViewComponentPrintable
      Returns:
      the used feature scale.
      See Also:
    • setCropMarks

      public void setCropMarks(boolean aCropMarks)
      Specifies whether to draw crop marks on multi-page prints. The default is true.
      Parameters:
      aCropMarks - true to draw crop marks on multi-page prints.
    • hasCropMarks

      public boolean hasCropMarks()
      Returns whether crop marks are drawn on multi-page prints.
      Returns:
      whether crop marks are drawn on multi-page prints.
    • setPositioningMarks

      public void setPositioningMarks(boolean aPositioningMarks)
      Specifies whether to draw positioning marks on multi-page prints. The default is true.
      Parameters:
      aPositioningMarks - true to draw positioning marks on multi-page prints.
    • hasPositioningMarks

      public boolean hasPositioningMarks()
      Returns whether positioning marks are drawn on multi-page prints.
      Returns:
      whether positioning marks are drawn on multi-page prints.
    • setOrigin

      public void setOrigin(Point aOrigin)
      Sets the origin of the component on the page. The default is null, meaning that the component is automatically centered on the page. This setting is mostly useful when disabling snap to full pages.
      Parameters:
      aOrigin - the origin, or null.
    • getOrigin

      public Point getOrigin()
      Returns the origin of the component on the page.
      Returns:
      the origin of the component on the page, or null.
      See Also:
    • setPageDecorator

      public void setPageDecorator(Printable aPageDecorator)

      Sets a Printable that can be used to decorate each page. It is for example possible to add a watermark to each page using this method.

      The default is null, meaning that no decorations are added.

      Parameters:
      aPageDecorator - the page decorator.
    • getPageDecorator

      public Printable getPageDecorator()
      Returns the Printable that is used as page decorator.
      Returns:
      the Printable that is used as page decorator.
    • print

      public int print(Graphics aGraphics, PageFormat aPageFormat, int aPageIndex) throws PrinterException
      Specified by:
      print in interface Printable
      Throws:
      PrinterException
    • createPreview

      public TLcdPrintPreview createPreview(PageFormat aPageFormat)
      Creates a preview panel for the given page format.
      Specified by:
      createPreview in class ALcdViewComponentPrintable
      Parameters:
      aPageFormat - the page format to use
      Returns:
      a panel visualizing the component