com.levigo.jadice.document.render

Class BaseRenderSettings

java.lang.Object

com.levigo.jadice.document.render.AbstractListenableRenderSettings

com.levigo.jadice.document.render.BaseRenderSettings

All Implemented Interfaces:

ProcessingSettings, SerializableProcessingSettings, RenderSettings, Serializable

public class BaseRenderSettings
extends AbstractListenableRenderSettings

The BaseRenderSettings, as their name implies, control the most fundamental properties of a rendering. in particular, they include geometry, layering and clipping.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BaseRenderSettings.Clipping An enumeration describing what kind of clipping is applied before rendering a part of the model (which usually starts at the page level).

Field Summary

Fields

Modifier and Type	Field and Description
static String	ALL_LAYERS_ENABLED Identifier key for all-layer enabled state change, used within a RenderSettingsEvent to recognize the kind of change which happen.
static String	ANTI_ALIASING_MODE Identifier key for an anti-aliasing mode change, used within a RenderSettingsEvent to recognize the kind of change which happens.
static String	CLIPPING Identifier key for a clipping type change.
static String	DEVICE_RESOLUTION Identifier key for a change of the device resolution, used within a RenderSettingsEvent to recognize the kind of change which happen.
static String	LAYER_ENABLED Identifier key for a layer enabled state change, used within a RenderSettingsEvent to recognize the kind of change which happens.
static String	ROTATION Identifier key for a rotation change, used within a RenderSettingsEvent to recognize the kind of change which happen.
static String	ZOOM Identifier key for a zoom change, used within a RenderSettingsEvent to recognize the kind of change which happen.

Constructor Summary

Constructors

Constructor and Description
BaseRenderSettings()

Method Summary

Modifier and Type	Method and Description
double	baseToDevice(double value) Utility method: convert base units to device units and apply zoom factor
int	baseToDevice(int value) Utility method: convert base units to device units and apply zoom factor
BaseRenderSettings	createSnapshot() Creates and returns a snapshot copy of this settings instance.
double	deviceToBase(double value) Utility method: convert device units to base units and unapply zoom factor
int	deviceToBase(int value) Utility method: convert device units to base units and unapply zoom factor
void	disableAllLayers() Disables the rendering of all standard layers provided by the DocumentLayer class and explicit enabled layers (defined by a call of setDocumentLayerEnabled(DocumentLayer, boolean) with a true boolean parameter).
void	enableAllLayers() Enables the rendering of all standard layers provided by the DocumentLayer class and explicit disabled layers (defined by a call of setDocumentLayerEnabled(DocumentLayer, boolean) with a false boolean parameter).
boolean	equals(Object obj)
AffineTransform	getAffineTransform() Gets the affine transform for this render context, useful for converting from document to device space.
AffineTransform	getAffineTransform(Dimension2D srcSize) Gets the affine transform for this render setting, useful for converting from document to device space.
AntiAliasingMode	getAntiAliasingMode() Returns the anti-aliasing mode for shape and text rendering
BaseRenderSettings.Clipping	getClipping() Return the clipping type.
int	getDeviceResolution() Gets the device resolution.
AffineTransform	getInverseTransform(Dimension2D pageSize) Gets the inverse affine transform for this render context, useful for converting from device to document space.
List<DocumentLayer>	getOrderedAndActiveLayers(Collection<DocumentLayer> candidateLayers) Returns a collection of candidate layers in an ordering suitable for rendering.
QuadrantRotation	getRotation() Gets the rotation angle.
float	getZoom() Gets the zoom factor.
int	hashCode()
boolean	isDocumentLayerEnabled(DocumentLayer layer) Returns whether layer class should be rendered or not.
boolean	isEnlargeThinStrokeRendering() Return whether 0 width lines should be rendered as 1 pixel width lines
void	setAntiAliasingMode(AntiAliasingMode antiAliasingMode) Sets the anti-aliasing mode for shape and text rendering.
void	setClipping(BaseRenderSettings.Clipping clipping) Set the clipping type.
void	setDeviceResolution(int deviceResolution) Sets the device resolution.
void	setDocumentLayerEnabled(DocumentLayer layer, boolean value) Sets a flag whether document layer of given class should be rendered or not.
void	setEnlargeThinStrokeRendering(boolean enlargeThinStrokeRendering) Sets if 0 width lines should be rendered as 1 pixel width lines
void	setRotation(QuadrantRotation r) Sets the rotation angle.
void	setZoom(float zoomFactor) Sets the zoom factor.
void	update(String propertyName, RenderSettings other, Object... details) Updates this instance property specified by given property name with the value provided by the other processing setting.

Methods inherited from class com.levigo.jadice.document.render.AbstractListenableRenderSettings

fireChanged, getSettingsChangeHandler, setSettingsChangeHandler

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

ANTI_ALIASING_MODE

public static final String ANTI_ALIASING_MODE

Identifier key for an anti-aliasing mode change, used within a RenderSettingsEvent to recognize the kind of change which happens.

See Also:

Constant Field Values

LAYER_ENABLED

public static final String LAYER_ENABLED

Identifier key for a layer enabled state change, used within a RenderSettingsEvent to recognize the kind of change which happens.

See Also:

setDocumentLayerEnabled(DocumentLayer, boolean), isDocumentLayerEnabled(DocumentLayer), Constant Field Values

ALL_LAYERS_ENABLED

public static final String ALL_LAYERS_ENABLED

Identifier key for all-layer enabled state change, used within a RenderSettingsEvent to recognize the kind of change which happen.

See Also:

Constant Field Values

ROTATION

public static final String ROTATION

Identifier key for a rotation change, used within a RenderSettingsEvent to recognize the kind of change which happen.

See Also:

setRotation(QuadrantRotation), getRotation(), Constant Field Values

ZOOM

public static final String ZOOM

Identifier key for a zoom change, used within a RenderSettingsEvent to recognize the kind of change which happen.

See Also:

setZoom(float), getZoom(), Constant Field Values

CLIPPING

public static final String CLIPPING

Identifier key for a clipping type change.

See Also:

setClipping(Clipping), getClipping(), Constant Field Values

DEVICE_RESOLUTION

public static final String DEVICE_RESOLUTION

Identifier key for a change of the device resolution, used within a RenderSettingsEvent to recognize the kind of change which happen.

See Also:

Constant Field Values

Constructor Detail

BaseRenderSettings

public BaseRenderSettings()

Method Detail

setDocumentLayerEnabled

public void setDocumentLayerEnabled(DocumentLayer layer,
                                    boolean value)

Sets a flag whether document layer of given class should be rendered or not.

Parameters:

layer - Document layer.

value - Flag

enableAllLayers

public void enableAllLayers()

Enables the rendering of all standard layers provided by the DocumentLayer class and explicit disabled layers (defined by a call of setDocumentLayerEnabled(DocumentLayer, boolean) with a false boolean parameter).

Standard layers provided by the DocumentLayer class are:

• DocumentLayer.BACKGROUND
• DocumentLayer.ANNOTATIONS
• DocumentLayer.DEFAULT
• DocumentLayer.FORM

Other customized layers, will not be enabled by a call of this method. To enable customized layers the usage of setDocumentLayerEnabled(DocumentLayer, boolean) is advised.

disableAllLayers

public void disableAllLayers()

Disables the rendering of all standard layers provided by the DocumentLayer class and explicit enabled layers (defined by a call of setDocumentLayerEnabled(DocumentLayer, boolean) with a true boolean parameter).

Standard layers provided by the DocumentLayer class are:

• DocumentLayer.BACKGROUND
• DocumentLayer.ANNOTATIONS
• DocumentLayer.DEFAULT
• DocumentLayer.FORM

Other customized layers, will not be disabled by a call of this method. To disable customized layers the usage of setDocumentLayerEnabled(DocumentLayer, boolean) is advised.

isDocumentLayerEnabled

public boolean isDocumentLayerEnabled(DocumentLayer layer)

Returns whether layer class should be rendered or not.

Returns:

indicator whether layer class should be rendered or not

getOrderedAndActiveLayers

public List<DocumentLayer> getOrderedAndActiveLayers(Collection<DocumentLayer> candidateLayers)

Returns a collection of candidate layers in an ordering suitable for rendering. This entails

• filtering the layers to remove disabled ones.
• sorting the layers by their default priority.
• re-ordering as defined by the DocumentLayer.compareTo(DocumentLayer) method.

Returns:

collection of filtered and ordered layers. It is not guaranteed, that the given candidateLayers collection is changed by this method, but it is also not assured that the returned collection is the same instance as the candidateLayers collection.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

createSnapshot

public BaseRenderSettings createSnapshot()

Creates and returns a snapshot copy of this settings instance.

Returns:

snapshot copy

getAntiAliasingMode

public AntiAliasingMode getAntiAliasingMode()

Returns the anti-aliasing mode for shape and text rendering

Returns:

AntiAliasingMode

setAntiAliasingMode

public void setAntiAliasingMode(AntiAliasingMode antiAliasingMode)

Sets the anti-aliasing mode for shape and text rendering.

Parameters:

antiAliasingMode - AntiAliasingMode

getRotation

public QuadrantRotation getRotation()

Gets the rotation angle.

Returns:

Returns rotation See also QuadrantRotation

setRotation

public void setRotation(QuadrantRotation r)

Sets the rotation angle. Make sure that a valid rotation argument is passed.

Parameters:

r - The rotation angle to set See also QuadrantRotation

getZoom

public float getZoom()

Gets the zoom factor. This method returns the actual zoom factor. It is greater than zero and smaller or equals 1.0f. A value of 1.0f corresponds a 1:1 rendering.

Returns:

Returns a float scaled so that 1.0f corresponds to a 1:1 rendering.

setZoom

public void setZoom(float zoomFactor)

Sets the zoom factor. This method takes an actual factor, which must be greater zero and smaller or equal 1.0f. A value of 1.0f corresponds a 1:1 rendering.

Parameters:

zoomFactor - The zoomFactor to set

getDeviceResolution

public int getDeviceResolution()

Gets the device resolution.

Returns:

Returns a device resolution as int

setDeviceResolution

public void setDeviceResolution(int deviceResolution)

Sets the device resolution.

Parameters:

deviceResolution - The device resolution to set

baseToDevice

public int baseToDevice(int value)

Utility method: convert base units to device units and apply zoom factor

Parameters:

value - value in base units

Returns:

value in device units, zoomed

baseToDevice

public double baseToDevice(double value)

Utility method: convert base units to device units and apply zoom factor

Parameters:

value - value in base units

Returns:

value in device units, zoomed

deviceToBase

public int deviceToBase(int value)

Utility method: convert device units to base units and unapply zoom factor

Parameters:

value - value in device units

Returns:

value in base units, de-zoomed

deviceToBase

public double deviceToBase(double value)

Utility method: convert device units to base units and unapply zoom factor

Parameters:

value - value in device units

Returns:

value in base units, de-zoomed

getAffineTransform

public AffineTransform getAffineTransform()

Gets the affine transform for this render context, useful for converting from document to device space. Considers only the zoom factor, the rotation .

Returns:

AffineTransform

getAffineTransform

public AffineTransform getAffineTransform(Dimension2D srcSize)

Gets the affine transform for this render setting, useful for converting from document to device space. Considers zoom factor and rotation. If the transform encompasses a rotational component, the rotation will use an origin calculated from the given source size, so that the result of the rendering lies within the first quadrant (in screen coordinates, i.e. 0/0 at the top/left).

Parameters:

srcSize - the size of the object to be rendered in source (document) coordinates.

Returns:

AffineTransform

getInverseTransform

public AffineTransform getInverseTransform(Dimension2D pageSize)

Gets the inverse affine transform for this render context, useful for converting from device to document space. Considers zoom factor and rotation.

Parameters:

pageSize - the pages size in base units

Returns:

AffineTransform

update

public void update(String propertyName,
                   RenderSettings other,
                   Object... details)

Description copied from interface: RenderSettings

Updates this instance property specified by given property name with the value provided by the other processing setting. For each update-supported property the render settings type have to provide a unique property name.

Parameters:

propertyName - the name of the property to update. Update supported properties have unique property identifier provided by the specific render settings implementation.

other - the processing setting which provide the new property value. Therefore the other processing setting have to be of the same type as this instance.

details - (optional) if some describing details are necessary to do a specific update, the details parameter will transport this informations

getClipping

public BaseRenderSettings.Clipping getClipping()

Return the clipping type.

Returns:

the clipping type

setClipping

public void setClipping(BaseRenderSettings.Clipping clipping)

Set the clipping type.

Parameters:

clipping - the clipping type

isEnlargeThinStrokeRendering

public boolean isEnlargeThinStrokeRendering()

Return whether 0 width lines should be rendered as 1 pixel width lines

Returns:

true if 0 width lines should be rendered as 1 pixel width lines , otherwise false

setEnlargeThinStrokeRendering

public void setEnlargeThinStrokeRendering(boolean enlargeThinStrokeRendering)

Sets if 0 width lines should be rendered as 1 pixel width lines

Parameters:

enlargeThinStrokeRendering - true if 0 width lines should be rendered as 1 pixel width lines , otherwise false