yu.ac.bg.etf.javaqx.qswing.layouts.formlayout.util
Class AbstractUnitConverter

java.lang.Object
  extended byyu.ac.bg.etf.javaqx.qswing.layouts.formlayout.util.AbstractUnitConverter
All Implemented Interfaces:
UnitConverter
Direct Known Subclasses:
DefaultUnitConverter

public abstract class AbstractUnitConverter
extends java.lang.Object
implements UnitConverter

An abstract implementation of the UnitConverter interface that minimizes the effort required to convert font-dependent sizes to pixels.

NOTE: This code is part of the JGoodies Forms port.

Version:
$Revision: 1.2 $, 0.2.0
Author:
Karsten Lentzsch, Slobodan Vrkacevic (slobodan.vrkacevic@gmail.com)

Constructor Summary
AbstractUnitConverter()
           
 
Method Summary
protected  int centimeterAsPixel(double cm, int dpi)
          Converts Centimeters and returns pixels using the specified resolution.
 int centimeterAsPixel(double cm, JQComponent component)
          Converts Centimeters and returns pixels using the resolution of the given component's graphics object.
protected  double computeAverageCharWidth(FontMetrics metrics, java.lang.String testString)
          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 dialogUnitXAsPixel(int dluX, JQComponent c)
          Converts horizontal dialog units and returns pixels.
protected  int dialogUnitYAsPixel(int dluY, double dialogBaseUnitsY)
          Converts vertical dialog units and returns pixels.
 int dialogUnitYAsPixel(int dluY, JQComponent c)
          Converts vertical dialog units and returns pixels.
protected abstract  double getDialogBaseUnitsX(JQComponent component)
          Gets and returns the horizontal dialog base units.
protected abstract  double getDialogBaseUnitsY(JQComponent component)
          Gets and returns the vertical dialog base units.
protected  int getScreenResolution()
          Returns the components screen resolution or the default screen resolution if the component is null or has no toolkit assigned yet.
protected  int inchAsPixel(double in, int dpi)
          Converts Inches and returns pixels using the specified resolution.
 int inchAsPixel(double in, JQComponent component)
          Converts Inches and returns pixels using the specified resolution.
protected  int millimeterAsPixel(double mm, int dpi)
          Converts Millimeters and returns pixels using the specified resolution.
 int millimeterAsPixel(double mm, JQComponent component)
          Converts Millimeters and returns pixels using the resolution of the given component's graphics object.
protected  int pointAsPixel(int pt, int dpi)
          Converts DTP Points and returns pixels using the specified resolution.
 int pointAsPixel(int pt, JQComponent 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 Detail

AbstractUnitConverter

public AbstractUnitConverter()
Method Detail

inchAsPixel

public int inchAsPixel(double in,
                       JQComponent 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,
                             JQComponent component)
Converts Millimeters and returns pixels using the resolution of the given component's graphics object.

Specified by:
millimeterAsPixel in interface UnitConverter
Parameters:
mm - the millimeters
component - the component that provides the graphics object
Returns:
the given millimeters as pixels

centimeterAsPixel

public int centimeterAsPixel(double cm,
                             JQComponent component)
Converts Centimeters and returns pixels using the resolution of the given component's graphics object.

Specified by:
centimeterAsPixel in interface UnitConverter
Parameters:
cm - the centimeters
component - the component that provides the graphics object
Returns:
the given Centimeters as pixels

pointAsPixel

public int pointAsPixel(int pt,
                        JQComponent 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 - the DTP points
component - the component that provides the graphics object
Returns:
the given Points as pixels

dialogUnitXAsPixel

public int dialogUnitXAsPixel(int dluX,
                              JQComponent c)
Converts horizontal dialog units and returns pixels. Honors the resolution, dialog font size, platform, and Style.

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,
                              JQComponent c)
Converts vertical dialog units and returns pixels. Honors the resolution, dialog font size, platform, and Style.

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(JQComponent 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(JQComponent 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 - the 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,
                                         java.lang.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()
Returns the components screen resolution or the default screen resolution if the component is null or has no toolkit assigned yet.

Returns:
the component's screen resolution


Copyright © 2007 ETF and contributors. All Rights Reserved.