org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.impl

Class MultiLayerMarkerSymbol

java.lang.Object

org.gvsig.symbology.fmap.mapcontext.rendering.symbol.impl.AbstractSymbol

org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.impl.AbstractMarkerSymbol

org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.impl.MultiLayerMarkerSymbol

All Implemented Interfaces:

java.lang.Cloneable, CartographicSupport, IMultiLayerSymbol, IPrintable, ISymbol, ISymbol_v2, IMarkerSymbol, IMultiLayerMarkerSymbol, Persistent

public class MultiLayerMarkerSymbol
extends AbstractMarkerSymbol
implements IMarkerSymbol, IMultiLayerSymbol, IMultiLayerMarkerSymbol

MultiLayerMarkerSymbol allows to group several marker symbols (xxxMarkerSymbol implementing IMarkerSymbol)in one and treat it as an only one symbol.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MultiLayerMarkerSymbol.RegisterPersistence
static class	MultiLayerMarkerSymbol.RegisterSymbol

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MULTILAYER_MARKER_SYMBOL_PERSISTENCE_DEFINITION_NAME

Fields inherited from class org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.impl.AbstractMarkerSymbol

MARKER_SYMBOL_PERSISTENCE_DEFINITION_NAME

Fields inherited from class org.gvsig.symbology.fmap.mapcontext.rendering.symbol.impl.AbstractSymbol

SYMBOL_PERSISTENCE_DEFINITION_NAME

Fields inherited from interface org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.IMarkerSymbol

CIRCLE_STYLE, CROSS_STYLE, DIAMOND_STYLE, SQUARE_STYLE, STAR_STYLE, SYMBOL_NAME, TRIANGLE_STYLE, VERTICAL_LINE_STYLE, X_STYLE

Fields inherited from interface org.gvsig.fmap.mapcontext.rendering.symbols.CartographicSupport

PAPER, WORLD

Fields inherited from interface org.gvsig.fmap.mapcontext.rendering.symbols.ISymbol

SELECTION_COLOR

Constructor Summary

Constructors

Constructor and Description
MultiLayerMarkerSymbol()

Method Summary

Methods

Modifier and Type	Method and Description
void	addLayer(ISymbol newLayer) Stacks a new symbol to the symbol list.
void	addLayer(ISymbol newLayer, int layerIndex) Stacks a new symbol to the symbol list.
java.lang.Object	clone() Creates a copy of the object.
void	draw(java.awt.Graphics2D g, java.awt.geom.AffineTransform affineTransform, Geometry geom, Feature feature, Cancellable cancel) Used when a symbol is going to be drawn.The method to do it will depend on the derived version of the symbol.
void	drawInsideRectangle(java.awt.Graphics2D g, java.awt.geom.AffineTransform scaleInstance, java.awt.Rectangle r, PrintAttributes properties) Useful to render the symbol inside the TOC, or inside little rectangles.
java.lang.String	getClassName()
java.awt.Color	getColor() Returns the color of the marker symbol.
ISymbol	getLayer(int layerIndex) Obtains the symbol that "contains" a layer whose index is the argument of the method.
int	getLayerCount() Returns the number of layers
int	getOnePointRgb() Returns the rgb of the symbol when it is drawn like a point.
void	getPixExtentPlus(Geometry geom, float[] distances, ViewPort viewPort, int dpi) Returns the distance between the shape's bounding box and the symbol-that-represents-this-shape's bounding box in a two-length-float array passed as parameter.
double	getRotation() Returns the rotation (in radians, counter-clockwise) of the marker symbol
double	getSize() Obtains the size of a marker symbol
ISymbol	getSymbolForSelection() Returns the derived version of the symbol that will be used to draw the feature when it is selected.
boolean	isSuitableFor(Geometry geom) True if this symbol is ok for the geometry.
void	loadFromState(PersistentState state) Set the state of the object from the state passed as parameter.
void	print(java.awt.Graphics2D g, java.awt.geom.AffineTransform at, Geometry geom, PrintAttributes properties)
boolean	removeLayer(ISymbol layer) TODO maybe push it up to ISymbol
void	saveToState(PersistentState state) Saves the internal state of the object on the provided PersistentState object.
void	setAlpha(int alpha) Defines the transparency of a line symbol.
void	setColor(java.awt.Color color) Establishes a color for the marker symbol
void	setLayer(int index, ISymbol layer) Establishes a concret symbol for a layer
void	setReferenceSystem(int system) Sets the Reference System that defines how this units have to be handled.
void	setRotation(double rotation) Sets the rotation of the marker symbol
void	setSize(double size) Sets the size of marker symbol
void	setUnit(int unit) Defines the unit used to express measures.
void	swapLayers(int index1, int index2) Changes the position of two layers in a multilayersymbol

Methods inherited from class org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.impl.AbstractMarkerSymbol

getCartographicSize, getMask, getOffset, getSymbolType, setCartographicSize, setMask, setOffset, toCartographicSize

Methods inherited from class org.gvsig.symbology.fmap.mapcontext.rendering.symbol.impl.AbstractSymbol

cloneForSelection, equals, getDescription, getID, getReferenceSystem, getUnit, isOneDotOrPixel, isShapeVisible, setDescription, setID, setIsShapeVisible

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gvsig.symbology.fmap.mapcontext.rendering.symbol.marker.IMarkerSymbol

getMask, getOffset, setMask, setOffset

Methods inherited from interface org.gvsig.fmap.mapcontext.rendering.symbols.CartographicSupport

getCartographicSize, getReferenceSystem, getUnit, setCartographicSize, toCartographicSize

Methods inherited from interface org.gvsig.fmap.mapcontext.rendering.symbols.ISymbol

getDescription, getSymbolType, isOneDotOrPixel, isShapeVisible, setDescription

Field Detail

MULTILAYER_MARKER_SYMBOL_PERSISTENCE_DEFINITION_NAME

public static final java.lang.String MULTILAYER_MARKER_SYMBOL_PERSISTENCE_DEFINITION_NAME

See Also:

Constant Field Values

Constructor Detail

MultiLayerMarkerSymbol

public MultiLayerMarkerSymbol()

Method Detail

getColor

public java.awt.Color getColor()

Description copied from interface: IMarkerSymbol

Returns the color of the marker symbol.

Specified by:

getColor in interface ISymbol

Specified by:

getColor in interface IMarkerSymbol

Overrides:

getColor in class AbstractMarkerSymbol

Returns:

Color

getRotation

public double getRotation()

Description copied from interface: IMarkerSymbol

Returns the rotation (in radians, counter-clockwise) of the marker symbol

Specified by:

getRotation in interface IMarkerSymbol

Overrides:

getRotation in class AbstractMarkerSymbol

Returns:

double (rotation)

setColor

public void setColor(java.awt.Color color)

Description copied from interface: IMarkerSymbol

Establishes a color for the marker symbol

Specified by:

setColor in interface ISymbol

Specified by:

setColor in interface IMarkerSymbol

Overrides:

setColor in class AbstractMarkerSymbol

Parameters:

color - to render the symbol

setRotation

public void setRotation(double rotation)

Description copied from interface: IMarkerSymbol

Sets the rotation of the marker symbol

Specified by:

setRotation in interface IMarkerSymbol

Overrides:

setRotation in class AbstractMarkerSymbol

getSize

public double getSize()

Description copied from interface: IMarkerSymbol

Obtains the size of a marker symbol

Specified by:

getSize in interface IMarkerSymbol

Overrides:

getSize in class AbstractMarkerSymbol

setSize

public void setSize(double size)

Description copied from interface: IMarkerSymbol

Sets the size of marker symbol

Specified by:

setSize in interface IMarkerSymbol

Overrides:

setSize in class AbstractMarkerSymbol

draw

public void draw(java.awt.Graphics2D g,
        java.awt.geom.AffineTransform affineTransform,
        Geometry geom,
        Feature feature,
        Cancellable cancel)

Description copied from interface: ISymbol

Used when a symbol is going to be drawn.The method to do it will depend on the derived version of the symbol.

Specified by:

draw in interface ISymbol

cancel - TODO

drawInsideRectangle

public void drawInsideRectangle(java.awt.Graphics2D g,
                       java.awt.geom.AffineTransform scaleInstance,
                       java.awt.Rectangle r,
                       PrintAttributes properties)
                         throws SymbolDrawingException

Description copied from interface: ISymbol

Useful to render the symbol inside the TOC, or inside little rectangles. For example, think about rendering a Label with size in meters => You will need to specify a size in pixels. Of course, you can also to choose to render a prepared image, etc.

Specified by:

drawInsideRectangle in interface ISymbol

Overrides:

drawInsideRectangle in class AbstractMarkerSymbol

properties - TODO

Throws:

SymbolDrawingException - TODO

getOnePointRgb

public int getOnePointRgb()

Description copied from interface: ISymbol

Returns the rgb of the symbol when it is drawn like a point.

Specified by:

getOnePointRgb in interface ISymbol

Overrides:

getOnePointRgb in class AbstractMarkerSymbol

Returns:

rgb of the symbol.

getPixExtentPlus

public void getPixExtentPlus(Geometry geom,
                    float[] distances,
                    ViewPort viewPort,
                    int dpi)

Description copied from interface: ISymbol

Returns the distance between the shape's bounding box and the symbol-that-represents-this-shape's bounding box in a two-length-float array passed as parameter.

After this method returns, the float array passed will contain two values representing the amount of pixels separating each of the X (first element) and Y (second element) axes.

This distance maybe dependent on:

1. The ViewPort: if the symbol is an instance of CartographicSupport the units it uses are not pixels and the reference system is CarthographicSupport.WORLD.
2. The target rendering context's dpi (dots-per-inch): if the symbol is an instance of CartographicSupport the units it uses are not pixels and CarthographicSupport.PAPER.

And in any other case, if the unit of the symbol is pixels or the symbol is not even an instance of CartographicSupport, the returning values are only defined by the symbol and are not calculated.

Specified by:

getPixExtentPlus in interface ISymbol

Overrides:

getPixExtentPlus in class AbstractMarkerSymbol

getSymbolForSelection

public ISymbol getSymbolForSelection()

Description copied from interface: ISymbol

Returns the derived version of the symbol that will be used to draw the feature when it is selected.

Specified by:

getSymbolForSelection in interface ISymbol

Returns:

ISymbol applied to a feature when it has been selected.

isSuitableFor

public boolean isSuitableFor(Geometry geom)

Description copied from interface: ISymbol

True if this symbol is ok for the geometry. For example, a FillSymbol will be suitable for a Polygon.

Specified by:

isSuitableFor in interface ISymbol

Overrides:

isSuitableFor in class AbstractMarkerSymbol

Returns:

getClassName

public java.lang.String getClassName()

print

public void print(java.awt.Graphics2D g,
         java.awt.geom.AffineTransform at,
         Geometry geom,
         PrintAttributes properties)

Specified by:

print in interface IPrintable

Overrides:

print in class AbstractMarkerSymbol

setLayer

public void setLayer(int index,
            ISymbol layer)
              throws java.lang.IndexOutOfBoundsException

Description copied from interface: IMultiLayerSymbol

Establishes a concret symbol for a layer

Specified by:

setLayer in interface IMultiLayerSymbol

Throws:

java.lang.IndexOutOfBoundsException

swapLayers

public void swapLayers(int index1,
              int index2)

Description copied from interface: IMultiLayerSymbol

Changes the position of two layers in a multilayersymbol

Specified by:

swapLayers in interface IMultiLayerSymbol

getLayer

public ISymbol getLayer(int layerIndex)

Description copied from interface: IMultiLayerSymbol

Obtains the symbol that "contains" a layer whose index is the argument of the method.

Specified by:

getLayer in interface IMultiLayerSymbol

Returns:

getLayerCount

public int getLayerCount()

Description copied from interface: IMultiLayerSymbol

Returns the number of layers

Specified by:

getLayerCount in interface IMultiLayerSymbol

Returns:

int

addLayer

public void addLayer(ISymbol newLayer)

Description copied from interface: IMultiLayerSymbol

Stacks a new symbol to the symbol list. The symbol is appended to the list and, in terms of use, it will be the last symbol to be processed.

Specified by:

addLayer in interface IMultiLayerSymbol

addLayer

public void addLayer(ISymbol newLayer,
            int layerIndex)
              throws java.lang.IndexOutOfBoundsException

Description copied from interface: IMultiLayerSymbol

Stacks a new symbol to the symbol list. The symbol is appended to the list in the specified position.

Specified by:

addLayer in interface IMultiLayerSymbol

Throws:

java.lang.IndexOutOfBoundsException

removeLayer

public boolean removeLayer(ISymbol layer)

Description copied from interface: IMultiLayerSymbol

TODO maybe push it up to ISymbol

Specified by:

removeLayer in interface IMultiLayerSymbol

Returns:

true if this symbol contains the removed one

setUnit

public void setUnit(int unit)

Description copied from interface: CartographicSupport

Defines the unit used to express measures. It is the position of the unit in the MapContext.NAMES array.

Specified by:

setUnit in interface CartographicSupport

Overrides:

setUnit in class AbstractSymbol

setReferenceSystem

public void setReferenceSystem(int system)

Description copied from interface: CartographicSupport

Sets the Reference System that defines how this units have to be handled. Possible values are:

1. CartographySupport.WORLD: Defines that the unit values refer to distances in the world. So, the size of the element displayed depends directly on the scale and CRS used by the map. The size of the elements defined to use CartographicSupport.WORLD will match exactly to their actual size in the real world.
2. CartographySupport.PAPER: Defines that the unit values refer to the length that the element will have regardless where it appears. If ReferenceSystem is CartographySupport.PAPER, and the length is (e.g.) millimeters the element will be displayed with the same amount of millimeters of length whether in the screen or the printer (screen DPI and printer DPI must be correctly configured).

Specified by:

setReferenceSystem in interface CartographicSupport

Overrides:

setReferenceSystem in class AbstractSymbol

setAlpha

public void setAlpha(int alpha)

Description copied from interface: IMarkerSymbol

Defines the transparency of a line symbol.

Specified by:

setAlpha in interface IMarkerSymbol

Overrides:

setAlpha in class AbstractMarkerSymbol

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Description copied from interface: Cloneable

Creates a copy of the object.

Overrides:

clone in class AbstractMarkerSymbol

Returns:

a copy of the object

Throws:

java.lang.CloneNotSupportedException - if the instance of the object cannot be cloned. As this is extending Cloneable so its sure it implements it, so this exception may be used for problems on specific object instances.

See Also:

Object#clone()}.

loadFromState

public void loadFromState(PersistentState state)
                   throws PersistenceException

Description copied from interface: Persistent

Set the state of the object from the state passed as parameter.

Specified by:

loadFromState in interface Persistent

Overrides:

loadFromState in class AbstractMarkerSymbol

Throws:

PersistenceException

saveToState

public void saveToState(PersistentState state)
                 throws PersistenceException

Description copied from interface: Persistent

Saves the internal state of the object on the provided PersistentState object.

Specified by:

saveToState in interface Persistent

Overrides:

saveToState in class AbstractMarkerSymbol

Throws:

PersistenceException