/trunk/libraries/libFMap/src/com/iver/cit/gvsig/fmap/core/symbols/ISymbol.java - Diff - | gvSIG desktop 1 - gvSIG

Revision 18621 trunk/libraries/libFMap/src/com/iver/cit/gvsig/fmap/core/symbols/ISymbol.java

     import java.awt.Color;
     import java.awt.Graphics2D;
     import java.awt.Rectangle;
     import java.awt.Shape;
     import java.awt.geom.AffineTransform;
     import com.iver.cit.gvsig.fmap.ViewPort;
     import com.iver.cit.gvsig.fmap.core.FShape;
     import com.iver.cit.gvsig.fmap.core.IGeometry;
     import com.iver.cit.gvsig.fmap.core.IPrintable;
-...
+     *
      * @author   jaume dominguez faus - jaume.dominguez@iver.es
      */
     public interface ISymbol extends IPersistence, IPrintable{
     public interface ISymbol extends IPersistence, IPrintable {
     	public static Color SELECTION_COLOR = Color.YELLOW;
     	/**
-...
     	 */
     	public void draw(Graphics2D g, AffineTransform affineTransform, FShape shp, Cancellable cancel);
     	// In the future, we may need something like that, but now if
     	// I put it, we should change the rendering process, and it will
     	// be slowly.
     	// El problema es que antes de renderizar algo, tenemos que calcular
     	// c�mo va a quedar en pantalla, para saber su bounding box real y si
     	// hay que dibujarlo o no. Pasa con los textos, pero en general
     	// con cualquier s�mbolo de tipo puntual, tambi�n. En menor medida con
     	// l�neas y pol�gonos.
     	//
     	// IDEA!!!:
     	// Para no depender de leer un shape y pedirle al s�mbolo que toca
     	// el bounding box para ver si hay que dibujarlo, se puede hacer una
     	// pasada previa por la leyenda y ver los pixels que a�ade al bounding
     	// box. (Se coge un punto, una l�nea o un pol�gono, y se calcula
     	// su bounding box para esa escala. Si es mayor que el original del
     	// shape, se calculan los pixels. Luego se pasan esos pixels a
     	// coordenadas de mundo real, y se le suman al visibleExtent para que
     	// se dibujen los trozos de texto que no se pintan, etc, etc.
     	public int getPixExtentPlus(Graphics2D g, AffineTransform affineTransform, Shape shp);
     	/**
     	 * <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(FShape shp, float[] distances, ViewPort viewPort, int dpi);
     	/**
     	 * Returns the rgb of the symbol when it is drawn like a point.
+    	 *
     	 * @return rgb of the symbol.
-...
     	 * @param g2
     	 * @param scaleInstance
     	 * @param r
     	 * @throws SymbolDrawingException TODO
     	 */
     	public void drawInsideRectangle(Graphics2D g, AffineTransform scaleInstance, Rectangle r);
     	public void drawInsideRectangle(Graphics2D g, AffineTransform scaleInstance, Rectangle r) throws SymbolDrawingException;
+    }

Also available in: Unified diff