org.gvsig.fmap.mapcontext.rendering.symbols

Interface ISymbol

All Superinterfaces:

java.lang.Cloneable, IPrintable, org.gvsig.tools.persistence.Persistent

All Known Subinterfaces:

IMultiLayerSymbol, ITextSymbol, IWarningSymbol

public interface ISymbol
extends org.gvsig.tools.persistence.Persistent, IPrintable, org.gvsig.tools.lang.Cloneable

Interface for symbols.It is the most general one which is implemented by other specific symbols.For this reason this interface has a method to obtain the derived version of a common symbol(apart from others). The main purpose is to offer a set of symbols that will be part of the FMap kernel and allow the developer to add new symbols without changes in the initial implementation.

Author:

jaume dominguez faus - jaume.dominguez@iver.es

Field Summary

Fields

Modifier and Type	Field and Description
static java.awt.Color	SELECTION_COLOR

Method Summary

Methods

Modifier and Type	Method and Description
void	draw(java.awt.Graphics2D g, java.awt.geom.AffineTransform affineTransform, org.gvsig.fmap.geom.Geometry geom, org.gvsig.fmap.dal.feature.Feature f, org.gvsig.tools.task.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, org.gvsig.compat.print.PrintAttributes properties) Useful to render the symbol inside the TOC, or inside little rectangles.
java.awt.Color	getColor() Returns the Color to use to render the symbol.
java.lang.String	getDescription() The description is a human-readable text used to label it when show in a symbol menu or something like that.
int	getOnePointRgb() Returns the rgb of the symbol when it is drawn like a point.
void	getPixExtentPlus(org.gvsig.fmap.geom.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.
ISymbol	getSymbolForSelection() Returns the derived version of the symbol that will be used to draw the feature when it is selected.
int	getSymbolType() The use of this method -and its mechanism- is being valorated.
boolean	isOneDotOrPixel(org.gvsig.fmap.geom.Geometry geom, double[] positionOfDotOrPixel, ViewPort viewPort, int dpi) Informs that the geometry will be represented with that symbol in just one pixel or dot
boolean	isShapeVisible() Tells whether the shape of the symbol will be drawn or not.
boolean	isSuitableFor(org.gvsig.fmap.geom.Geometry geom) True if this symbol is ok for the geometry.
void	setColor(java.awt.Color color) Sets the Color to use to render the symbol.
void	setDescription(java.lang.String desc) Sets the description of this symbol

Methods inherited from interface org.gvsig.tools.persistence.Persistent

loadFromState, saveToState

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

print

Methods inherited from interface org.gvsig.tools.lang.Cloneable

clone

Field Detail

SELECTION_COLOR

static final java.awt.Color SELECTION_COLOR

Method Detail

draw

void draw(java.awt.Graphics2D g,
        java.awt.geom.AffineTransform affineTransform,
        org.gvsig.fmap.geom.Geometry geom,
        org.gvsig.fmap.dal.feature.Feature f,
        org.gvsig.tools.task.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.

Parameters:

g -

affineTransform -

shp -

cancel - TODO

drawInsideRectangle

void drawInsideRectangle(java.awt.Graphics2D g,
                       java.awt.geom.AffineTransform scaleInstance,
                       java.awt.Rectangle r,
                       org.gvsig.compat.print.PrintAttributes properties)
                         throws SymbolDrawingException

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.

Parameters:

scaleInstance -

r -

properties - TODO

g2 -

Throws:

SymbolDrawingException - TODO

getColor

java.awt.Color getColor()

Returns the Color to use to render the symbol.

Parameters:

-

Returns:

the Color to use to render the symbol

getDescription

java.lang.String getDescription()

The description is a human-readable text used to label it when show in a symbol menu or something like that.

Returns:

description of this symbol.

getOnePointRgb

int getOnePointRgb()

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

Returns:

rgb of the symbol.

getPixExtentPlus

void getPixExtentPlus(org.gvsig.fmap.geom.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.

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.

Parameters:

ViewPort - viewPort

Shape - shp

int - dpi

float[] - distances, the array of floats where to store the distances in x and y axis

getSymbolForSelection

ISymbol getSymbolForSelection()

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

Returns:

ISymbol applied to a feature when it has been selected.

getSymbolType

int getSymbolType()

The use of this method -and its mechanism- is being valorated. It probably will be deprecated.

Returns:

FSymbol constants. I think it is better to use isSuitableFor

isOneDotOrPixel

boolean isOneDotOrPixel(org.gvsig.fmap.geom.Geometry geom,
                      double[] positionOfDotOrPixel,
                      ViewPort viewPort,
                      int dpi)

Informs that the geometry will be represented with that symbol in just one pixel or dot

Parameters:

geom -

positionOfDotOrPixel - (out) filled with pixel or dot location

viewPort -

dpi -

Returns:

isShapeVisible

boolean isShapeVisible()

Tells whether the shape of the symbol will be drawn or not.

Returns:

true if Shape must be drawn. Useful if you are labelling

isSuitableFor

boolean isSuitableFor(org.gvsig.fmap.geom.Geometry geom)

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

Parameters:

geom -

Returns:

setColor

void setColor(java.awt.Color color)

Sets the Color to use to render the symbol.

Parameters:

color - to render the symbol

setDescription

void setDescription(java.lang.String desc)

Sets the description of this symbol

Parameters:

desc, - a string with the description

See Also:

ISymbol.getDescription();