org.eclipse.birt.chart.device
Interface IDisplayServer

All Known Implementing Classes:
DisplayAdapter

public interface IDisplayServer

Provides generic services to a device renderer for computing metrics and centralized creation of device specific resources. This class is analogus to an X server interface associated with a device.


Method Summary
 java.lang.Object createFont(FontDefinition fd)
          Attempts to create a new font resource associated with a specific device for use in rendering or computations
 void debug()
          Lists out all resources that were previously logged explicitly by the logCreation(Object) method or those internally created by each of the resource creation methods.
 void dispose()
          A notification sent to the device to free all allocated system resources.
 java.lang.Object getColor(ColorDefinition cd)
          Attempts to create a new color resource associated with a specific device
 int getDpiResolution()
          Returns the resolution of the device in dots per inch As an example, for a display screen, the dots correspond to pixels and a typical value for a Win32 OS is 96 DPI.
 java.util.Locale getLocale()
          Deprecated. use getULocale() instead.
 java.lang.Object getObserver()
          An observer is typically associated with certain device types to aid in image loading and image metadata retrieval.
 Size getSize(java.lang.Object oImage)
          Returns the size(width, height) of the device specific image that was previously loaded by the loadImage(URL) method
 ITextMetrics getTextMetrics(Label la)
          An instance of a text metrics computation class capable of providing text metric information associated with a given Label to aid in typically computing the size of rendered text
 ITextMetrics getTextMetrics(Label la, boolean autoReuse)
          An instance of a text metrics computation class capable of providing text metric information associated with a given Label to aid in typically computing the size of rendered text
 com.ibm.icu.util.ULocale getULocale()
          Provides the locale to display server implementations as needed to retrieve localized resources for presentation.
 java.lang.Object loadImage(java.net.URL url)
          Attempts to use device specific libraries to load an image for use with the device renderer
 void logCreation(java.lang.Object o)
          Log creation of a resource for which leaks are to be tracked
 void setDpiResolution(int dpi)
          Sets the dpi resolution.
 void setGraphicsContext(java.lang.Object graphicsContext)
          Set the graphic context on the device renderer, which is required for font computations (SWT uses org.eclipse.swt.graphics.GC and Swing uses java.awt.Graphics2D) It is the responsibility of the caller to dispose the Graphics Context
 void setResourceFinder(org.eclipse.birt.chart.factory.IResourceFinder resourceFinder)
          Set the resource finder, which will be used by loading image.
 

Method Detail

debug

void debug()
Lists out all resources that were previously logged explicitly by the logCreation(Object) method or those internally created by each of the resource creation methods. Once this method is invoked, all entries written into the log should be flushed.


logCreation

void logCreation(java.lang.Object o)
Log creation of a resource for which leaks are to be tracked

Parameters:
o - A device-specific object being created

createFont

java.lang.Object createFont(FontDefinition fd)
Attempts to create a new font resource associated with a specific device for use in rendering or computations

Parameters:
fd - An font description for which a device specific resource is being requested
Returns:
A device specific font

getColor

java.lang.Object getColor(ColorDefinition cd)
Attempts to create a new color resource associated with a specific device

Parameters:
cd - A color description for which a device specific resource is being requested
Returns:
A device specific color

getDpiResolution

int getDpiResolution()
Returns the resolution of the device in dots per inch As an example, for a display screen, the dots correspond to pixels and a typical value for a Win32 OS is 96 DPI.

Returns:
The integral dots per inch associated with the device

setDpiResolution

void setDpiResolution(int dpi)
Sets the dpi resolution. This defines how many dots per inch to use for rendering the chart. This is optional, the display server will compute the default dpi resolution of the display where the chart is rendered. It is mostly intended to be used for creating high resolution images.

Parameters:
dpi - The number of dots per inch

loadImage

java.lang.Object loadImage(java.net.URL url)
                           throws ChartException
Attempts to use device specific libraries to load an image for use with the device renderer

Parameters:
url - The URL associated with the image location
Returns:
An instance of an image associated with the specified URL
Throws:
ChartException

getSize

Size getSize(java.lang.Object oImage)
Returns the size(width, height) of the device specific image that was previously loaded by the loadImage(URL) method

Parameters:
oImage - The image for which the size is being requested
Returns:
The size of the image

getObserver

java.lang.Object getObserver()
An observer is typically associated with certain device types to aid in image loading and image metadata retrieval.

Returns:
An image observer associated with a specific device renderer

getTextMetrics

ITextMetrics getTextMetrics(Label la)
An instance of a text metrics computation class capable of providing text metric information associated with a given Label to aid in typically computing the size of rendered text

Parameters:
la - The Label instance for which text metrics are being requested
Returns:
Text metrics associated with the specified Label instance

getTextMetrics

ITextMetrics getTextMetrics(Label la,
                            boolean autoReuse)
An instance of a text metrics computation class capable of providing text metric information associated with a given Label to aid in typically computing the size of rendered text

Parameters:
la - The Label instance for which text metrics are being requested
autoReuse -
Returns:
Text metrics associated with the specified Label instance

getLocale

java.util.Locale getLocale()
Deprecated. use getULocale() instead.

Provides the locale to display server implementations as needed to retrieve localized resources for presentation.

Returns:
locale

getULocale

com.ibm.icu.util.ULocale getULocale()
Provides the locale to display server implementations as needed to retrieve localized resources for presentation.

Returns:
ulocale
Since:
2.1

dispose

void dispose()
A notification sent to the device to free all allocated system resources.

Since:
2.2

setGraphicsContext

void setGraphicsContext(java.lang.Object graphicsContext)
Set the graphic context on the device renderer, which is required for font computations (SWT uses org.eclipse.swt.graphics.GC and Swing uses java.awt.Graphics2D) It is the responsibility of the caller to dispose the Graphics Context

Parameters:
graphicContext -
Since:
2.3

setResourceFinder

void setResourceFinder(org.eclipse.birt.chart.factory.IResourceFinder resourceFinder)
Set the resource finder, which will be used by loading image. If the chart is not running in stand alone mode, the ChartReportItemImpl will be set, which will resuse the find resource of the report engine, and feature like resource folder will be supported.

Parameters:
resourceFinder -


Copyright © 2005-2008 Actuate Corp. All rights reserved.