Class AbstractUnitConverter

java.lang.Object
com.jgoodies.forms.util.AbstractUnitConverter
All Implemented Interfaces:
UnitConverter
Direct Known Subclasses:
DefaultUnitConverter

public abstract class AbstractUnitConverter extends Object implements UnitConverter
An abstract implementation of the UnitConverter interface that minimizes the effort required to convert font-dependent sizes to pixels.
Version:
$Revision: 1.6 $
Author:
Karsten Lentzsch
See Also:
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    protected final int
    centimeterAsPixel(double cm, int dpi)
    Converts Centimeters and returns pixels using the specified resolution.
    int
    centimeterAsPixel(double cm, Component component)
    Converts Centimeters and returns pixels using the resolution of the given component's graphics object.
    protected double
    Computes and returns the average character width of the specified test string using the given FontMetrics.
    protected int
    dialogUnitXAsPixel(int dluX, double dialogBaseUnitsX)
    Converts horizontal dialog units and returns pixels.
    int
    Converts horizontal dialog units and returns pixels.
    protected int
    dialogUnitYAsPixel(int dluY, double dialogBaseUnitsY)
    Converts vertical dialog units and returns pixels.
    int
    Converts vertical dialog units and returns pixels.
    protected int
    Computes and returns the default resolution.
    protected abstract double
    Gets and returns the horizontal dialog base units.
    protected abstract double
    Gets and returns the vertical dialog base units.
    protected int
    Returns the components screen resolution or the default screen resolution if the component is null or has no toolkit assigned yet.
    protected final int
    inchAsPixel(double in, int dpi)
    Converts Inches and returns pixels using the specified resolution.
    int
    inchAsPixel(double in, Component component)
    Converts Inches and returns pixels using the specified resolution.
    protected final int
    millimeterAsPixel(double mm, int dpi)
    Converts Millimeters and returns pixels using the specified resolution.
    int
    millimeterAsPixel(double mm, Component component)
    Converts Millimeters and returns pixels using the resolution of the given component's graphics object.
    protected final int
    pointAsPixel(int pt, int dpi)
    Converts DTP Points and returns pixels using the specified resolution.
    int
    pointAsPixel(int pt, Component component)
    Converts DTP Points and returns pixels using the resolution of the given component's graphics object.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • AbstractUnitConverter

      public AbstractUnitConverter()
  • Method Details

    • inchAsPixel

      public int inchAsPixel(double in, Component component)
      Converts Inches and returns pixels using the specified resolution.
      Specified by:
      inchAsPixel in interface UnitConverter
      Parameters:
      in - the Inches
      component - the component that provides the graphics object
      Returns:
      the given Inches as pixels
    • millimeterAsPixel

      public int millimeterAsPixel(double mm, Component component)
      Converts Millimeters and returns pixels using the resolution of the given component's graphics object.
      Specified by:
      millimeterAsPixel in interface UnitConverter
      Parameters:
      mm - Millimeters
      component - the component that provides the graphics object
      Returns:
      the given Millimeters as pixels
    • centimeterAsPixel

      public int centimeterAsPixel(double cm, Component component)
      Converts Centimeters and returns pixels using the resolution of the given component's graphics object.
      Specified by:
      centimeterAsPixel in interface UnitConverter
      Parameters:
      cm - Centimeters
      component - the component that provides the graphics object
      Returns:
      the given Centimeters as pixels
    • pointAsPixel

      public int pointAsPixel(int pt, Component component)
      Converts DTP Points and returns pixels using the resolution of the given component's graphics object.
      Specified by:
      pointAsPixel in interface UnitConverter
      Parameters:
      pt - DTP Points
      component - the component that provides the graphics object
      Returns:
      the given Points as pixels
    • dialogUnitXAsPixel

      public int dialogUnitXAsPixel(int dluX, Component c)
      Converts horizontal dialog units and returns pixels. Honors the resolution, dialog font size, platform, and l&f.
      Specified by:
      dialogUnitXAsPixel in interface UnitConverter
      Parameters:
      dluX - the horizontal dialog units
      c - a Component that provides the font and graphics
      Returns:
      the given horizontal dialog units as pixels
    • dialogUnitYAsPixel

      public int dialogUnitYAsPixel(int dluY, Component c)
      Converts vertical dialog units and returns pixels. Honors the resolution, dialog font size, platform, and l&f.
      Specified by:
      dialogUnitYAsPixel in interface UnitConverter
      Parameters:
      dluY - the vertical dialog units
      c - a Component that provides the font and graphics
      Returns:
      the given vertical dialog units as pixels
    • getDialogBaseUnitsX

      protected abstract double getDialogBaseUnitsX(Component component)
      Gets and returns the horizontal dialog base units. Implementations are encouraged to cache previously computed dialog base units.
      Parameters:
      component - a Component that provides the font and graphics
      Returns:
      the horizontal dialog base units
    • getDialogBaseUnitsY

      protected abstract double getDialogBaseUnitsY(Component component)
      Gets and returns the vertical dialog base units. Implementations are encouraged to cache previously computed dialog base units.
      Parameters:
      component - a Component that provides the font and graphics
      Returns:
      the vertical dialog base units
    • inchAsPixel

      protected final int inchAsPixel(double in, int dpi)
      Converts Inches and returns pixels using the specified resolution.
      Parameters:
      in - the Inches
      dpi - the resolution
      Returns:
      the given Inches as pixels
    • millimeterAsPixel

      protected final int millimeterAsPixel(double mm, int dpi)
      Converts Millimeters and returns pixels using the specified resolution.
      Parameters:
      mm - Millimeters
      dpi - the resolution
      Returns:
      the given Millimeters as pixels
    • centimeterAsPixel

      protected final int centimeterAsPixel(double cm, int dpi)
      Converts Centimeters and returns pixels using the specified resolution.
      Parameters:
      cm - Centimeters
      dpi - the resolution
      Returns:
      the given Centimeters as pixels
    • pointAsPixel

      protected final int pointAsPixel(int pt, int dpi)
      Converts DTP Points and returns pixels using the specified resolution.
      Parameters:
      pt - DTP Points
      dpi - the resolution in dpi
      Returns:
      the given Points as pixels
    • dialogUnitXAsPixel

      protected int dialogUnitXAsPixel(int dluX, double dialogBaseUnitsX)
      Converts horizontal dialog units and returns pixels.
      Parameters:
      dluX - the horizontal dialog units
      dialogBaseUnitsX - the horizontal dialog base units
      Returns:
      the given dialog base units as pixels
    • dialogUnitYAsPixel

      protected int dialogUnitYAsPixel(int dluY, double dialogBaseUnitsY)
      Converts vertical dialog units and returns pixels.
      Parameters:
      dluY - the vertical dialog units
      dialogBaseUnitsY - the vertical dialog base units
      Returns:
      the given dialog base units as pixels
    • computeAverageCharWidth

      protected double computeAverageCharWidth(FontMetrics metrics, String testString)
      Computes and returns the average character width of the specified test string using the given FontMetrics. The test string shall represent an "average" text.
      Parameters:
      metrics - used to compute the test string's width
      testString - the string that shall represent an "average" text
      Returns:
      the test string's average character width.
    • getScreenResolution

      protected int getScreenResolution(Component c)
      Returns the components screen resolution or the default screen resolution if the component is null or has no toolkit assigned yet.
      Parameters:
      c - the component to ask for a toolkit
      Returns:
      the component's screen resolution
    • getDefaultScreenResolution

      protected int getDefaultScreenResolution()
      Computes and returns the default resolution.
      Returns:
      the default screen resolution