/ - Diff - Application: gvSIG desktop - gvSIG

     <?xml version="1.0" encoding="UTF-8" ?>
     <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
     <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
     	<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
     		<layout class="org.apache.log4j.PatternLayout">
     			<param name="ConversionPattern" value="%d{HH:mm:ss,SSS} %-5p [%c{2}.%M()]\n  %m%n" />
     		</layout>
     	</appender>
     	<category name="org.gvsig.tools">
     		<priority value="DEBUG" />
     	</category>
     	<category name="org.gvsig.fmap.mapcontext">
     		<priority value="DEBUG" />
     	</category>
     	<root>
     		<priority value="INFO" />
     		<appender-ref ref="CONSOLE" />
     	</root>
     </log4j:configuration>

     package org.gvsig.fmap.mapcontext;
     import java.awt.Graphics2D;
     import java.awt.image.BufferedImage;
     import org.gvsig.compat.print.PrintAttributes;
     import org.gvsig.fmap.dal.exception.ReadException;
     import org.gvsig.fmap.mapcontext.layers.FLayers;
     import org.gvsig.tools.task.Cancellable;
     public interface MapContextDrawer {
     	public void setMapContext(MapContext mapContext);
     	public void setViewPort(ViewPort viewPort);
     	public void draw(FLayers root, BufferedImage image, Graphics2D g, Cancellable cancel,
     			double scale) throws ReadException;
     	public void print(FLayers root, Graphics2D g, Cancellable cancel,
     			double scale, PrintAttributes properties) throws ReadException;
     	public void dispose();
+    }

     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib??ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     package org.gvsig.fmap.mapcontext;
     import java.awt.geom.Rectangle2D;
     import org.gvsig.tools.ToolsLocator;
     import org.gvsig.tools.dynobject.DynStruct;
     import org.gvsig.tools.persistence.PersistenceManager;
     import org.gvsig.tools.persistence.Persistent;
     import org.gvsig.tools.persistence.PersistentState;
     import org.gvsig.tools.persistence.exception.PersistenceException;
     /**
      * <p><code>ExtentHistory</code> is designed for managing a history of extents.</p>
+     *
      * <p>Note: An <i>extent</i> is a re.setMandatory(true)ctangular area, with information of its top-left 2D corner.</p>
+     *
      * @author Vicente Caballero Navarro
      */
     public class ExtentHistory implements Persistent {
     	/**
     	 * <p>Maximum number of extents that can store.</p>
     	 */
     	private int NUMREC;
     	/**
     	 * <p>Array with the extents.</p>
+    	 *
     	 * @see #hasPrevious()
     	 * @see #put(Rectangle2D)
     	 * @see #get()
     	 * @see #removePrev()
     	 */
     	private Rectangle2D[] extents;
     	/**
     	 * <p>Number of extents stored.</p>
+    	 *
     	 * @see #hasPrevious()
     	 * @see #put(Rectangle2D)
     	 * @see #get()
     	 * @see #removePrev()
     	 */
     	private int num = 0;
     	/**
     	 * <p>Creates a new instance of <code>ExtentsHistory</code> with an history of 10 extents.</p>
     	 */
     	public ExtentHistory() {
     		this(10);
+    	}
     	/**
     	 * <p>Creates a new instance of <code>ExtentsHistory</code> with an history of <code>numEntries</code> extents.</p>
+    	 *
     	 * @param numEntries the maximum number of extents that will store the instance
     	 */
     	public ExtentHistory(int numEntries) {
     		NUMREC = numEntries;
     		extents = new Rectangle2D[NUMREC];
+    	}
     	/**
     	 * <p>Appends the specified extent to the end of this history.</p>
+    	 *
     	 * @param ext the new extent
+    	 *
     	 * @see #get()
     	 * @see #hasPrevious()
     	 */
     	public void put(Rectangle2D ext) {
     		if ((ext != null) && ((num < 1) || (ext != extents[num - 1]))) {
     			if (num < (NUMREC)) {
     				extents[num] = ext;
     				num = num + 1;
     			} else {
     				for (int i = 0; i < (NUMREC - 1); i++) {
     					extents[i] = extents[i + 1];
+    				}
     				extents[num - 1] = ext;
+    			}
+    		}
+    	}
     	/**
     	 * <p>Returns <code>true</code> if there are extents registered.</p>
+    	 *
     	 * @return <code>true</code> if there are extents registered; <code>false</code> otherwise
+    	 *
     	 * @see #put(Rectangle2D)
     	 * @see #removePrev()
     	 * @see #get()
     	 */
     	public boolean hasPrevious() {
     		return num > 0;
+    	}
     	/**
     	 * <p>Returns the last extent in the history.</p>
+    	 *
     	 * @return the last extent in the history
+    	 *
     	 * @see #put(Rectangle2D)
     	 * @see #getXMLEntity()
     	 */
     	public Rectangle2D get() {
     		if (num <= 0) {
     			return null;
+    		}
     		Rectangle2D ext = extents[num - 1];
     		return ext;
+    	}
     	/**
     	 * <p>Extracts (removing) the last extent from the history.</p>
+    	 *
     	 * @return last extent in the history
+    	 *
     	 * @see #hasPrevious()
     	 */
     	public Rectangle2D removePrev() {
     		if (num <= 0) {
     			return null;
+    		}
     		Rectangle2D ext = extents[--num];
     		return ext;
+    	}
     	public void loadFromState(PersistentState state)
     			throws PersistenceException {
     		num = state.getInt("num");
     		NUMREC = state.getInt("numrec");
     		extents = (Rectangle2D[]) state.getArray("extents", Rectangle2D.class);
+    	}
     	/**
     	 * <p>
     	 * Returns information of this object. All information is stored as
     	 * properties:<br>
     	 * </p>
     	 * <p>
     	 * <b>Properties:</b>
     	 * <ul>
     	 * <li><i>className</i>: name of this class.
     	 * <li><i>num</i>: number of extents registered.
     	 * <li><i>numrec</i>: maximum number of extents that can register.
     	 * <li><i>extents</i>: .
     	 * </ul>
     	 * </p>
+    	 *
     	 */
     	public void saveToState(PersistentState state) throws PersistenceException {
     		state.set("num", num);
     		state.set("numrec", NUMREC);
     		state.set("extents", extents);
+    	}
     	public static void registerPersistent() {
     		PersistenceManager manager = ToolsLocator.getPersistenceManager();
     		DynStruct definition = manager.addDefinition(
     				ExtentHistory.class,
     				"ExtentHistory",
     				"ExtentHistory Persistence definition",
     				null,
     				null
     		);
     		definition.addDynFieldInt("num").setMandatory(true);
     		definition.addDynFieldInt("numrec").setMandatory(true);
     		definition.addDynFieldArray("extents").setClassOfItems(Rectangle2D.class).setMandatory(true);
+    	}
+    }

     /* gvSIG. Sistema de Informaci�n Geogr�fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2005 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib��ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import org.gvsig.fmap.geom.Geometry;
     import org.gvsig.fmap.mapcontext.ViewPort;
     /**
      * <p>This interface enables Cartographic support for those graphical elements that require
      * additional runtime information rather than the feature itself geometric definitions.<br></p>
+     *
      * <p>It allows to realworld's measure units dimensioning.<br></p>
+     *
      * <p>It also supplies a toolkit to perform operations with centralized static methods.
      * @see CartographicSupportToolkit inner class' methods<br></p>
+     *
      * @author jaume dominguez faus - jaume.dominguez@iver.es
      */
     public interface CartographicSupport {
     	public static final int WORLD = 0;
     	public static final int PAPER = 1;
     	/**
     	 * Defines the unit used to express measures. It is the position of the unit in the <b>MapContext.NAMES</b> array.
     	 * @param unitIndex, the index of the unit in the MapContext.NAMES array
     	 */
     	public abstract void setUnit(int unitIndex);
     	/**
     	 * Returns the unit used to express measures. It is the position of the unit in the <b>MapContext.NAMES</b> array.
     	 * @returns an <b>int</b> with the index of the unit in the MapContext.NAMES array, or -1 if the size is specified in pixel
     	 */
     	public abstract int getUnit();
     	/**
     	 * Returns the <b>Reference System</b> used to draw the elements of the image.<br>
     	 * <p>
     	 * The elements have to be scaled to <b>pixel</b> when the image is bein drawn in
     	 * order to compose the map. The elements of the map may define its size in
     	 * other units than pixel.<br>
     	 * </p>
     	 * <p><b>CartographicSupport</b> enables the elements to define the size in
     	 * measure units but these units may refer to different reference system. Two
     	 * kinds of Reference Systems are allowed in this context: <b>CartographicSupport.WORLD</b>,
     	 * and <b>CartographicSupport.PAPER</b>.
     	 * <br></p>
     	 * <p>
     	 * Depending on which <b>Reference System</b> is used the unit used by this element
     	 * refers to distances in the real world (then they are map's CRS-dependant)
     	 * or screen or printer output (then they are output DPI-dependant)<br>
     	 * </p>
     	 * <p>
     	 * In case the unit used is <b>pixel</b> then the reference system does not
     	 * have any effect since the source unit is the same than the target unit.
     	 * <br>
     	 * </p>
     	 * @return
     	 */
     	public abstract int getReferenceSystem();
     	/**
     	 * Sets the <b>Reference System</b> that defines how this units have to be
     	 * handled. Possible values are:
     	 * <ol>
     	 *   <li><b>CartographySupport.WORLD</b>: Defines that the unit values refer
     	 *   to distances in the world. So, the size of the element displayed <b>depends
     	 *   directly on the scale and CRS</b> 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.</li>
     	 *   <li><b>CartographySupport.PAPER</b>: Defines that the unit values refer
     	 *   to the length that the element will have regardless where it appears. If
     	 *   ReferenceSystem is <b>CartographySupport.PAPER</b>, and the length is (e.g.)
     	 *   millimeters the element will be displayed with the <b>same</b> amount of
     	 *   millimeters of length whether in the <b>screen</b> or the <b>printer</b>
     	 *   (screen DPI and printer DPI must be correctly configured).</li>
     	 * </ol>
     	 */
     	public abstract void setReferenceSystem(int referenceSystem);
     	/**
     	 * Computes and sets the size (in pixels) of the cartographic element according
     	 * to the current rendering context (output dpi, map scale, map units) and the
     	 * symbol cartgraphic settings (unit, size, and unit reference system).
+    	 *
     	 * @param viewPort, the ViewPort containing the symbol.
     	 * @param dpi, current output dpi (screen or printer)
     	 * @param shp, used only for MultiShapeSymbols in order to discriminate the internal symbol to be applied
     	 * @return a double containing the previous defined size
     	 */
     	public abstract double toCartographicSize(ViewPort viewPort, double dpi, Geometry geom);
     	/**
     	 * Sets the size of the cartographic element in pixels.
+    	 *
     	 * @param cartographicSize, the size in pixels of the element
     	 * @param shp, used only for MultiShapeSymbols in order to discriminate the internal symbol to be applied
     	 */
     	public abstract void setCartographicSize(double cartographicSize, Geometry geom);
     	/**
     	 * Gets the size (in pixels) of the cartographic element according
     	 * to the current rendering context (output dpi, map scale, map units) and the
     	 * symbol cartgraphic settings (unit, size, and unit reference system).
     	 * @param viewPort
     	 * @param dpi
     	 * @param shp
     	 * @return double containing the size in [screen/printer] pixels for the current symbol
     	 */
     	public abstract double getCartographicSize(ViewPort viewPort, double dpi, Geometry geom);
+    }

     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import java.awt.Color;
     import java.awt.Font;
     import java.awt.Rectangle;
     import org.gvsig.fmap.geom.Geometry;
     import org.gvsig.fmap.geom.primitive.Point;
     /**
+     *
      * ITextSymbol.java<br>
      * Represents an ISymbol that draws a text.
+     *
      * @author jaume dominguez faus - jaume.dominguez@iver.es Dec 11, 2007
+     *
      */
     public interface ITextSymbol extends ISymbol {
     	public static final String SYMBOL_NAME = "text";
     	public final static int SYMBOL_STYLE_ALIGNMENT_LEFT = 94;
     	public final static int SYMBOL_STYLE_ALIGNMENT_RIGHT = 95;
     	public final static int SYMBOL_STYLE_ALIGNMENT_CENTERED = 96;
     	public final static int SYMBOL_STYLE_ALIGNMENT_JUSTIFY = 97;
     	/**
     	 * Establishes the font that will be used to render this ITextSymbol.
     	 * @param font
     	 */
     	public abstract void setFont(Font font);
     	/**
     	 * Returns the currently set font.
     	 * @return Font
     	 */
     	public abstract Font getFont();
     	/**
     	 * Returns the currently color set to be applied to the text
     	 * @return Color
     	 */
     	public abstract Color getTextColor();
     	/**
     	 * Sets the color of the text
     	 * @param color
     	 */
     	public abstract void setTextColor(Color color);
     	/**
     	 * Returns the text contained by this symbol
     	 * @return
     	 * @deprecated ?do i need it?
     	 */
     	public abstract String getText();
     	/**
     	 * Sets the text to be rendered by this symbol
     	 * @param text, a String
     	 */
     	public abstract void setText(String text);
     	/**
     	 * Sets the font size currently set to this symbol
     	 * @param d
     	 */
     	public abstract void setFontSize(double d);
     	/**
     	 * Computes a Geometry wrapping the text to be applied
     	 * @param p target location
     	 * @return
     	 */
     	public abstract Geometry getTextWrappingShape(Point p);
     	public abstract Rectangle getBounds();
     	public abstract void setAutoresizeEnabled(boolean autoresizeFlag);
     	public abstract boolean isAutoresizeEnabled();
+    }

     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2005 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib??ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     /* CVS MESSAGES:
+    *
     * $Id: ILabelStyle.java 20989 2008-05-28 11:05:57Z jmvivo $
     * $Log$
     * Revision 1.10  2007-08-16 06:55:30  jvidal
     * javadoc updated
+    *
     * Revision 1.9  2007/08/13 11:36:30  jvidal
     * javadoc
+    *
     * Revision 1.8  2007/05/08 08:47:39  jaume
     * *** empty log message ***
+    *
     * Revision 1.7  2007/04/05 16:07:14  jaume
     * Styled labeling stuff
+    *
     * Revision 1.6  2007/04/04 15:42:03  jaume
     * *** empty log message ***
+    *
     * Revision 1.5  2007/04/04 15:41:05  jaume
     * *** empty log message ***
+    *
     * Revision 1.4  2007/04/02 16:34:56  jaume
     * Styled labeling (start commiting)
+    *
     * Revision 1.3  2007/03/29 16:02:01  jaume
     * *** empty log message ***
+    *
     * Revision 1.2  2007/03/09 11:20:56  jaume
     * Advanced symbology (start committing)
+    *
     * Revision 1.1.2.1  2007/02/15 16:23:44  jaume
     * *** empty log message ***
+    *
     * Revision 1.1.2.1  2007/02/09 07:47:05  jaume
     * Isymbol moved
+    *
+    *
     */
     package org.gvsig.fmap.mapcontext.rendering.symbols.styles;
     import java.awt.Dimension;
     import java.awt.geom.Point2D;
     import java.awt.geom.Rectangle2D;
     /**
      * Defines the style that a Label symbol can contain which typically define
      * a background of the label as an Image, the texts that the label holds
      * and their position within the label in rendering time.
+     *
      * @author jaume dominguez faus - jaume.dominguez@iver.es
+     *
      */
     public interface ILabelStyle extends IStyle {
     	/**
     	 * @return int, the amount of fields this style allows
     	 */
     	public int getFieldCount();
     	/**
     	 * Sets the texts that will appear in the label.
     	 * @param texts
     	 */
     	public void setTextFields(String[] texts);
     	/**
     	 * Returns an array of rectangles defining the text boxes where text is
     	 * placed.
     	 * @return
     	 */
     	public Rectangle2D[] getTextBounds();
     	public Dimension getSize();
     	/**
     	 * Returns the position of the point labeled by this label in percent units relative
     	 * to the label bounds. It determines the offset to be applied to the label to be
     	 * placed and allows the user to use custom styles.
     	 */
     	public Point2D getMarkerPoint();
     	/**
     	 * Sets the position of the point labeled by this in percent units relative to the
     	 * label bounds
     	 * @param p
     	 * @throws IllegalArgumentException if the point coordinates are >0.0 or <1.0
     	 */
     	public void setMarkerPoint(Point2D p) throws IllegalArgumentException;
     	/**
     	 * Sets a TextFieldArea using its index. With this method the user can
     	 * modify the size of the rectangle for the TextFieldArea
     	 * @param index
     	 * @param rect
     	 */
     	public void setTextFieldArea(int index, Rectangle2D rect);
     	/**
     	 * Adds a new TextFieldArea with an specific size which is defined as a rectangle.
     	 * @param index,int
     	 * @param rect,Rectangle2D
     	 */
     	public void addTextFieldArea(Rectangle2D rect);
     	/**
     	 * Delete the TextFieldArea specified by its index.
     	 * @param index,int
     	 */
     	public void deleteTextFieldArea(int index);
     	/**
     	 * Sets the size for a laber and stablishes an unit scale factor to not change
     	 * too much its content
     	 * @param width
     	 * @param height
     	 */
     	public void setSize(double width, double height);
+    }

      /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2005 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib??ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     /* CVS MESSAGES:
+    *
     * $Id: IStyle.java 20989 2008-05-28 11:05:57Z jmvivo $
     * $Log$
     * Revision 1.7  2007-09-20 09:33:15  jaume
     * Refactored: fixed name of IPersistAnce to IPersistence
+    *
     * Revision 1.6  2007/09/19 16:19:27  jaume
     * removed unnecessary imports
+    *
     * Revision 1.5  2007/08/22 09:49:00  jvidal
     * javadoc updated
+    *
     * Revision 1.4  2007/08/16 06:55:30  jvidal
     * javadoc updated
+    *
     * Revision 1.3  2007/08/13 11:36:41  jvidal
     * javadoc
+    *
     * Revision 1.2  2007/04/04 15:41:05  jaume
     * *** empty log message ***
+    *
     * Revision 1.1  2007/03/09 11:20:56  jaume
     * Advanced symbology (start committing)
+    *
     * Revision 1.1.2.2  2007/02/15 16:23:44  jaume
     * *** empty log message ***
+    *
     * Revision 1.1.2.1  2007/02/09 07:47:05  jaume
     * Isymbol moved
+    *
+    *
     */
     package org.gvsig.fmap.mapcontext.rendering.symbols.styles;
     import java.awt.Graphics2D;
     import java.awt.Rectangle;
     import org.gvsig.fmap.mapcontext.rendering.symbols.ISymbol;
     import org.gvsig.fmap.mapcontext.rendering.symbols.SymbolDrawingException;
     import org.gvsig.tools.lang.Cloneable;
     import org.gvsig.tools.persistence.Persistent;
     /**
      * Used by Objects that have to define an style for them.This interface has
      * methods to stablish a description and get it,to specify if an object
      * that implements this interface is suitable for a kind of symbol and other
      * methods to draw symbols.
      * @author   jaume dominguez faus - jaume.dominguez@iver.es
      */
     public interface IStyle extends Persistent, Cloneable {
     	/**
     	 * Defines the description of a symbol.It will be specified with an
     	 * string.
     	 * @param desc,String
     	 */
     	public abstract void setDescription(String desc);
     	/**
     	 * Returns the description of a symbol
     	 * @return Description of a symbol
     	 */
     	public abstract String getDescription();
     	/**
     	 * 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 may also preffer to render a prepared image, etc.
     	 * @param g Graphics2D
     	 * @param r Rectangle
     	 */
     	public abstract void drawInsideRectangle(Graphics2D g, Rectangle r) throws SymbolDrawingException;
     	/**
     	 * True if this symbol is ok for the style or class.
     	 * @param symbol ISymbol
     	 */
     	public abstract boolean isSuitableFor(ISymbol symbol);
     	/**
     	 * Used to show an outline of the style to graphically show its properties.
     	 * @param g, the Graphics2D where to draw
     	 * @param r, the bounds of the style inside such Graphics2D
     	 */
     	public abstract void drawOutline(Graphics2D g, Rectangle r) throws SymbolDrawingException;
+    }

     package org.gvsig.fmap.mapcontext.rendering.symbols;
     public interface IWarningSymbol extends ISymbol {
     	public static final String SYMBOL_NAME = "warning";
     	void setDrawExceptionType(int symbolDrawExceptionType);
     	void setMessage(String message);
     	void setDescription(String description);
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+    *
     * Copyright (C) 2007-2008 Infrastructures and Transports Department
     * of the Valencian Government (CIT)
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
     * MA  02110-1301, USA.
+    *
     */
     /*
     * AUTHORS (In addition to CIT):
     * 2009 {gvSIG}  {{Task}}
     */
     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import org.gvsig.fmap.mapcontext.MapContextException;
     import org.gvsig.tools.exception.BaseException;
     /**
      * Parent exception of symbol related exceptions.
      * @author <a href="mailto:cordinyana@gvsig.org">C?sar Ordi?ana</a>
      */
     public abstract class SymbolException extends MapContextException {
     	private static final long serialVersionUID = -5432842435290441524L;
     	/**
     	 * @see BaseException#BaseException(String, String, long)
     	 */
     	public SymbolException(String message, String key, long code) {
     		super(message, key, code);
+    	}
     	/**
     	 * @see BaseException#BaseException(String, Throwable, String, long)
     	 */
     	public SymbolException(String message, Throwable cause, String key,
     			long code) {
     		super(message, cause, key, code);
+    	}
+    }

     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2005 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib??ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     /* CVS MESSAGES:
+     *
      * $Id: IMultiLayerSymbol.java 20989 2008-05-28 11:05:57Z jmvivo $
      * $Log$
      * Revision 1.5  2007-08-16 06:55:19  jvidal
      * javadoc updated
+     *
      * Revision 1.4  2007/08/09 08:04:36  jvidal
      * javadoc
+     *
      * Revision 1.3  2007/08/09 07:57:42  jvidal
      * javadoc
+     *
      * Revision 1.2  2007/03/09 11:20:56  jaume
      * Advanced symbology (start committing)
+     *
      * Revision 1.1.2.1  2007/02/16 10:54:12  jaume
      * multilayer splitted to multilayerline, multilayermarker,and  multilayerfill
+     *
+     *
      */
     package org.gvsig.fmap.mapcontext.rendering.symbols;
     /**
      * Allows to create multi layer symbols using the composition of
      * several symbols of the same type.Depending on the type of the symbols that are
      * used to compose the final symbol, the user will have MultiLayerMarkerSymbol,
      * MultiLayerLineSymbol,...
+     *
      */
     public interface IMultiLayerSymbol extends ISymbol {
     	/**
     	 * Establishes a concret symbol for a layer
+    	 *
     	 * @param index, index of the layer
     	 * @param layer, symbol to be "applied" to the layer
     	 * @throws IndexOutOfBoundsException
     	 */
     	public abstract void setLayer(int index, ISymbol layer)
     	throws IndexOutOfBoundsException;
     	/**
     	 * Changes the position of two layers in a multilayersymbol
     	 * @param index1, index of the layer
     	 * @param index2, index of the layer
     	 */
     	public abstract void swapLayers(int index1, int index2);
     	/**
     	 * Obtains  the symbol that "contains" a layer whose index is the argument of the method.
     	 * @param layerIndex
     	 * @return
     	 */
     	public abstract ISymbol getLayer(int layerIndex);
     	/**
     	 * Returns the number of layers
     	 * @return int
     	 */
     	public abstract int getLayerCount();
     	/**
     	 * 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.
     	 * @param ISymbol newLayer
     	 */
     	public abstract void addLayer(ISymbol newLayer);
     	/**
     	 * Stacks a new symbol to the symbol list. The symbol is appended to the
     	 * list in the specified position.
     	 * @param ISymbol newLayer
     	 */
     	public abstract void addLayer(ISymbol newLayer, int layerIndex)
     	throws IndexOutOfBoundsException;
     	/**
     	 * TODO maybe push it up to ISymbol
     	 * @param layer
     	 * @return true if this symbol contains the removed one
     	 */
     	public abstract boolean removeLayer(ISymbol layer);
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+    *
     * Copyright (C) 2007-2008 Infrastructures and Transports Department
     * of the Valencian Government (CIT)
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
     * MA  02110-1301, USA.
+    *
     */
     /*
     * AUTHORS (In addition to CIT):
     * 2009 {}  {{Task}}
     */
     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import java.awt.Color;
     import java.awt.Font;
     /**
      * Preferences for symbol configuration and default values.
+     *
      * @author 2009- <a href="cordinyana@gvsig.org">C?sar Ordi?ana</a> - gvSIG team
      */
     public interface SymbolPreferences {
     	/**
     	 * Returns the file extension to use for persisted symbols.
+    	 *
     	 * @return the symbol file extension
     	 */
     	String getSymbolFileExtension();
     	/**
     	 * Sets the file extension to use for persisted symbols.
+    	 *
     	 * @param extension
     	 *            the file extension to use for persisted symbols
     	 */
     	void setSymbolFileExtension(String extension);
     	/**
     	 * Returns the default color to use for symbols.
+    	 *
     	 * @return the symbol default color
     	 */
     	Color getDefaultSymbolColor();
     	/**
     	 * Sets the default color to use for symbols.
+    	 *
     	 * @param defaultSymbolColor
     	 *            the symbol default color
     	 */
     	void setDefaultSymbolColor(Color defaultSymbolColor);
     	/**
     	 * Sets the default color for symbols to the original value.
     	 */
     	void resetDefaultSymbolColor();
     	/**
     	 * Returns the default fill color to use for symbols.
+    	 *
     	 * @return the default fill color
     	 */
     	Color getDefaultSymbolFillColor();
     	/**
     	 * Sets the default fill color to use for symbols.
+    	 *
     	 * @param defaultSymbolFillColor
     	 *            the default fill color
     	 */
     	void setDefaultSymbolFillColor(Color defaultSymbolFillColor);
     	/**
     	 * Sets the default fill color for symbols to the original value.
     	 */
     	void resetDefaultSymbolFillColor();
     	/**
     	 * Returns if the default symbol fill color has been generated in a aleatory
     	 * way.
+    	 *
     	 * @return if the default symbol fill color is aleatory
     	 */
     	boolean isDefaultSymbolFillColorAleatory();
     	/**
     	 * Sets if the default symbol fill color has been generated in a aleatory
     	 * way.
+    	 *
     	 * @param defaultSymbolFillColorAleatory
     	 *            if the default symbol fill color is aleatory
     	 */
     	void setDefaultSymbolFillColorAleatory(
     			boolean defaultSymbolFillColorAleatory);
     	/**
     	 * Sets if the default symbol fill color is aleatory to the default value.
     	 */
     	void resetDefaultSymbolFillColorAleatory();
     	/**
     	 * Returns the default font to use for symbols.
+    	 *
     	 * @return the default symbol font
     	 */
     	Font getDefaultSymbolFont();
     	/**
     	 * Sets the default font to use for symbols.
+    	 *
     	 * @param defaultSymbolFont
     	 *            the default symbol font
     	 */
     	void setDefaultSymbolFont(Font defaultSymbolFont);
     	/**
     	 * Sets the default font to use for symbols to the original value.
     	 */
     	void resetDefaultSymbolFont();
     	/**
     	 * Returns the path to the symbol library, where the persisted symbols can
     	 * be found.
+    	 *
     	 * @return the path to the symbol library
     	 */
     	String getSymbolLibraryPath();
     	/**
     	 * Sets the path to the symbol library, where the persisted symbols can be
     	 * found.
+    	 *
     	 * @param symbolLibraryPath
     	 *            the path to the symbol library
     	 */
     	void setSymbolLibraryPath(String symbolLibraryPath);
     	/**
     	 * Sets the path to the symbol library to the original value.
     	 */
     	void resetSymbolLibraryPath();
     	/**
     	 * Returns the unit that will be used when creating new symbols with
     	 * Cartographic support.
+    	 *
     	 * @return the default cartographic support measure unit
     	 * @see CartographicSupport#getUnit()
     	 */
     	int getDefaultCartographicSupportMeasureUnit();
     	/**
     	 * Sets the unit that will be used when creating new symbols with
     	 * Cartographic support.
+    	 *
     	 * @param defaultCartographicSupportMeasureUnit
     	 *            the default cartographic support measure unit
     	 * @see CartographicSupport#setUnit()
     	 */
     	void setDefaultCartographicSupportMeasureUnit(
     			int defaultCartographicSupportMeasureUnit);
     	/**
     	 * Returns the reference system that will be used when creating new symbols
     	 * with Cartographic support.
+    	 *
     	 * @return the cartographic reference system
     	 * @see CartographicSupport#PAPER
     	 * @see CartographicSupport#WORLD
     	 */
     	int getDefaultCartographicSupportReferenceSystem();
     	/**
     	 * Sets the reference system that will be used when creating new symbols
     	 * with Cartographic support.
+    	 *
     	 * @param defaultCartographicSupportReferenceSystem
     	 *            the cartographic reference system
     	 * @see CartographicSupport#PAPER
     	 * @see CartographicSupport#WORLD
     	 */
     	void setDefaultCartographicSupportReferenceSystem(
     			int defaultCartographicSupportReferenceSystem);
+    }

     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import java.awt.Graphics2D;
     import java.awt.geom.AffineTransform;
     import org.gvsig.compat.print.PrintAttributes;
     import org.gvsig.fmap.geom.Geometry;
     public interface IPrintable {
     	public void print(Graphics2D g,
     					  AffineTransform at,
     					  Geometry shape,
     					  PrintAttributes properties);
+    }

     /* gvSIG. Sistema de Informaci�n Geogr�fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib��ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import java.awt.Color;
     import java.awt.Graphics2D;
     import java.awt.Rectangle;
     import java.awt.geom.AffineTransform;
     import org.gvsig.compat.print.PrintAttributes;
     import org.gvsig.fmap.dal.feature.Feature;
     import org.gvsig.fmap.geom.Geometry;
     import org.gvsig.fmap.mapcontext.ViewPort;
     import org.gvsig.tools.persistence.Persistent;
     import org.gvsig.tools.task.Cancellable;
     import 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
      */
     public interface ISymbol extends Persistent, IPrintable, Cloneable {
     	public static Color SELECTION_COLOR = Color.YELLOW;
     	/**
     	 * Returns the derived version of the symbol that will be used to draw the
     	 * feature when it is selected.
     	 * @return <b>ISymbol</b> applied to a feature when it has been selected.
     	 */
     	public ISymbol getSymbolForSelection();
     	/**
     	 * Used when a symbol is going to be drawn.The method to do
     	 * it will depend on the derived version of the symbol.
     	 * @param g
     	 * @param affineTransform
     	 * @param shp
     	 * @param cancel TODO
     	 */
     	public void draw(Graphics2D g, AffineTransform affineTransform, Geometry geom, Feature f, Cancellable cancel);
     	/**
     	 * <p>
     	 * Returns <b>the distance between the shape's bounding box and the
     	 * symbol-that-represents-this-shape's bounding box</b> in a two-length-float
     	 * array passed as parameter.<br>
     	 * </p>
     	 * <p>
     	 * After this method returns, the float array passed will contain two values
     	 * representing <b>the amount of pixels</b> separating each of the X (first element)
     	 * and Y (second element) axes.<br>
     	 * </p>
     	 * <p>
     	 * This distance maybe dependent on:
     	 * 	<ol>
     	 * 		<li>
     	 * 			<b>The ViewPort</b>: if the symbol is an instance of CartographicSupport
     	 * 			the units it uses are not pixels and the reference system is
     	 * 			CarthographicSupport.WORLD.
     	 * 		</li>
     	 * 		<li>
     	 * 			<b>The target rendering context's dpi (dots-per-inch)</b>: if the symbol
     	 * 			is an instance of CartographicSupport the units it uses are not pixels and
     	 * 			CarthographicSupport.PAPER.
     	 * 		</li>
     	 * 	</ol>
     	 * <br>
     	 * </p>
     	 * <p>
     	 * 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.
     	 * </p>
     	 * @param ViewPort viewPort
     	 * @param Shape shp
     	 * @param int dpi
     	 * @param float[] distances, the array of floats where to store the distances in x and y axis
     	 */
     	public void getPixExtentPlus(Geometry geom, float[] distances, ViewPort viewPort, int dpi);
     	/**
     	 * Informs that the geometry will be represented with that symbol in just one pixel or dot
+    	 *
+    	 *
+    	 *
     	 * @param geom
     	 * @param positionOfDotOrPixel (out) filled with pixel or dot location
     	 * @param viewPort
     	 * @param dpi
     	 * @return
     	 */
     	public boolean isOneDotOrPixel(Geometry geom, double[] positionOfDotOrPixel,
     			ViewPort viewPort, int dpi);
     	/**
     	 * Returns the rgb of the symbol when it is drawn like a point.
+    	 *
     	 * @return rgb of the symbol.
     	 */
     	public int getOnePointRgb();
     	/**
     	 * The description is a human-readable text used to label it when show in a symbol menu or something like that.
     	 * @return   description of this symbol.
     	 * @uml.property  name="description"
     	 */
     	public String getDescription();
     	/**
     	 * Tells whether the shape of the symbol will be drawn or not.
+    	 *
     	 * @return <b>true</b> if Shape must be drawn. Useful if you are labelling
     	 */
     	public boolean isShapeVisible();
     	/**
     	 * Sets the description of this symbol
     	 * @param   desc, a string with the description
     	 * @see   ISymbol.getDescription();
     	 * @uml.property  name="description"
     	 */
     	public void setDescription(String desc);
     	/**
     	 * The use of this method -and its mechanism- is being valorated. It probably
     	 * will be <b>deprecated</b>.
     	 * @return FSymbol constants. I think it is better to use isSuitableFor
+    	 *
     	 */
     	public int getSymbolType();
     	/**
     	 * True if this symbol is ok for the geometry. For example, a FillSymbol will
     	 * be suitable for a Polygon.
     	 * @param geom
     	 * @return
     	 */
     	public boolean isSuitableFor(Geometry geom);
     	/**
     	 * 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.
     	 * @param scaleInstance
     	 * @param r
     	 * @param properties TODO
     	 * @param g2
     	 * @throws SymbolDrawingException TODO
     	 */
     	public void drawInsideRectangle(Graphics2D g, AffineTransform scaleInstance, Rectangle r, PrintAttributes properties) throws SymbolDrawingException;
     	/**
     	 * Returns the {@link Color} to use to render the symbol.
     	 * @param
     	 * @return  the {@link Color} to use to render the symbol
     	 */
     	public Color getColor();
     	/**
     	 * Sets the {@link Color} to use to render the symbol.
     	 * @param color to render the symbol
     	 */
     	public void setColor(Color color);
+    }

     package org.gvsig.fmap.mapcontext.rendering.symbols;
     import org.gvsig.fmap.mapcontext.Messages;
     /**
      * Exception thrown when a symbol cannot be drawn. The type of the exception
      * will determine the cause.
      * <ol>
      * 	<li><b>Unsupported set of settings</b>: getType() == SymbolDrawingException.UNSUPPORTED_SET_OF_SETTINGS</li>
      * 	<li><b>Shape type mismatch</b>: getType() == SymbolDrawingException.SHAPETYPE_MISMATCH</li>
      * </ol>
+     *
      * @author jaume dominguez faus - jaume.dominguez@iver.es

Application: gvSIG desktop

Revision 38005