| gvSIG desktop 1

/* 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: SymbologyFactory.java 18621 2008-02-08 07:59:54Z jdominguez $

* $Log$

* Revision 1.11  2007-09-20 09:33:15  jaume

* Refactored: fixed name of IPersistAnce to IPersistence

*

* Revision 1.10  2007/09/17 14:16:11  jaume

* multilayer symbols sizing bug fixed

*

* Revision 1.9  2007/09/17 09:32:05  jaume

* view refresh frame rate now configurable

*

* Revision 1.8  2007/07/18 06:54:34  jaume

* continuing with cartographic support

*

* Revision 1.7  2007/04/26 11:41:00  jaume

* attempting to let defining size in world units

*

* Revision 1.6  2007/03/27 09:28:40  jaume

* *** empty log message ***

*

* Revision 1.5  2007/03/21 11:02:51  jaume

* javadoc

*

* Revision 1.4  2007/03/20 15:59:03  jaume

* improved factory toolkit

*

* Revision 1.3  2007/03/13 16:58:36  jaume

* Added QuantityByCategory (Multivariable legend) and some bugfixes in symbols

*

* Revision 1.2  2007/03/09 11:20:57  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/12 15:15:20  jaume

* refactored interval legend and added graduated symbol legend

*

* Revision 1.1.2.3  2007/02/09 07:47:05  jaume

* Isymbol moved

*

* Revision 1.1.2.2  2007/02/01 11:42:47  jaume

* *** empty log message ***

*

* Revision 1.1.2.1  2007/01/26 13:48:05  jaume

* patch for opening old projects

*

* Revision 1.1  2007/01/10 16:39:41  jaume

* ISymbol now belongs to com.iver.cit.gvsig.fmap.core.symbols package

*

* Revision 1.3  2006/11/06 16:06:52  jaume

* *** empty log message ***

*

* Revision 1.2  2006/11/06 07:33:54  jaume

* javadoc, source style

*

* Revision 1.1  2006/10/30 19:30:35  jaume

* *** empty log message ***

*

*

*/

package com.iver.cit.gvsig.fmap.core;

import java.awt.BasicStroke;

import java.awt.Color;

import java.awt.Font;

import java.awt.Graphics;

import java.awt.Graphics2D;

import java.awt.Rectangle;

import java.awt.geom.AffineTransform;

import java.io.File;

import javax.print.attribute.PrintRequestAttributeSet;

import javax.swing.JFrame;

import javax.swing.JPanel;

import org.apache.log4j.Logger;

import com.hardcode.gdbms.driver.exceptions.ReadDriverException;

import com.iver.cit.gvsig.fmap.Messages;

import com.iver.cit.gvsig.fmap.ViewPort;

import com.iver.cit.gvsig.fmap.core.styles.IStyle;

import com.iver.cit.gvsig.fmap.core.symbols.IFillSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.ILineSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.IMarkerSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.IMultiLayerSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.ISymbol;

import com.iver.cit.gvsig.fmap.core.symbols.ITextSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.MultiLayerFillSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.MultiLayerLineSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.MultiLayerMarkerSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.MultiShapeSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.SimpleFillSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.SimpleLineSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.SimpleMarkerSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.SimpleTextSymbol;

import com.iver.cit.gvsig.fmap.core.symbols.SymbolDrawingException;

import com.iver.cit.gvsig.fmap.core.v02.FSymbol;

import com.iver.utiles.IPersistence;

import com.iver.utiles.NotExistInXMLEntity;

import com.iver.utiles.XMLEntity;

import com.iver.utiles.swing.threads.Cancellable;

/**

 * Factory for obtaining symbology of any kind from several sources like.

 * <ol>

 *         <li>

 *                 <b>XMLEntity's</b> that, at least, contains a full class name

 *                         string property that defines which class handles such symbol.

 *  </li>

 * </ol>

 *

 * @author jaume dominguez faus - jaume.dominguez@iver.es

 */

public class SymbologyFactory {

        /**

         * This Constants are only used in SymbologyPage (preferences page for symbology), 

         * do not use in other context.

         */

        public static final Color FactoryDefaultSymbolColor = Color.GRAY;

        public static final Color FactoryDefaultFillSymbolColor = new Color(60, 235, 235);

        public static final Font FactoryDefaultTextFont =  new Font("Serif", Font.PLAIN, 8);

        public static final String FactorySymbolLibraryPath =

                System.getProperty("user.home") +

                File.separator +

                "gvSIG" +

                File.separator +

                "Symbols";

        public static Color DefaultSymbolColor = FactoryDefaultSymbolColor;

        public static Color DefaultFillSymbolColor = FactoryDefaultFillSymbolColor;

        public static Font DefaultTextFont = FactoryDefaultTextFont;

        public static String SymbolLibraryPath = FactorySymbolLibraryPath;

        private static Logger logger = Logger.getLogger(SymbologyFactory.class.getName());

        private static WarningSymbol warningSymbol;

        /**

         * Factory that allows to create <b>ISymbol</b>'s from an ISymbol xml

         * descriptor. A barely specific XMLEntity object. The string passed in the

         * second argument is the description text that will be used in case no description

         * is supplied by the symbol's xml descriptor.

         *

         * @param xml, the symbol's xml descriptor

         * @param defaultDescription, a human readable description string for the symbol.

         * @return ISymbol

         */

        public static ISymbol createSymbolFromXML(XMLEntity xml, String defaultDescription) {

                if (!xml.contains("desc")) {

                        if (defaultDescription == null) defaultDescription = "";

                        xml.putProperty("desc", defaultDescription);

                }

                return (ISymbol) createFromXML(xml);

        }

        /**

         * Factory that allows to create <b>IStyle</b>'s from an <b>IStyle</b> xml descriptor. A barely

         * specific <b>XMLEntity</b> object. The string passed in the second argument is the

         * description text that will be used in case no description is supplied by the

         * style's xml descriptor.

         *

         * @param xml, the style's xml descriptor

         * @param defaultDescription, a human readable description string for the style

         * @return IStyle

         */

        public static IStyle createStyleFromXML(XMLEntity xml, String defaultDescription) {

                if (!xml.contains("desc"))

                        if (defaultDescription == null) defaultDescription = "";

                        xml.putProperty("desc", defaultDescription);

                return (IStyle) createFromXML(xml);

        }

        /**

         * Creates an <b>Object</b> described by the <b>XMLEntity</b> xml, please reffer to the

         * XMLEntity definition contract to know what is the format of the xml argument.

         * The result of this method is an <b>Object</b> that you can cast to the type you were

         * looking for by means of the xml entity.

         *

         * @param xml

         * @return Object

         */

        private static Object createFromXML(XMLEntity xml) {

                String className = null;

                try {

                        className = xml.getStringProperty("className");

                } catch (NotExistInXMLEntity e) {

                        logger.error("Class name not set.\n" +

                                                " Maybe you forgot to add the" +

                                                " putProperty(\"className\", yourClassName)" +

                                                " call in the getXMLEntity method of your class", e);

                }

                Class clazz = null;

                IPersistence obj = null;

                String s = className;

                try {

                        clazz = Class.forName(className);

                        if (xml.contains("desc")) {

                                s += " \"" + xml.getStringProperty("desc") +"\"";

                        }

                        // TODO remove the patch the day we deprecate FSymbol

                        // begin patch

                        if (clazz.equals(FSymbol.class))

                                obj = FSymbol.createFromXML(xml);

                        else {

                        // end patch

                                obj = (IPersistence) clazz.newInstance();

                                logger.info(Messages.getString("creating")+"....... "+s);

                                try {

                                        obj.setXMLEntity(xml);

                                } catch (NotExistInXMLEntity neiXML) {

                                        logger.error(Messages.getString("failed_creating_object")+": "+s);

                                        throw neiXML;

                                }

                        }

                } catch (InstantiationException e) {

                        logger.error("Trying to instantiate an interface" +

                                                " or abstract class + "+className, e);

                } catch (IllegalAccessException e) {

                        logger.error("IllegalAccessException: does your class have an" +

                                        " anonymous constructor?", e);

                } catch (ClassNotFoundException e) {

                        logger.error("No class called " + className +

                                        " was found.\nCheck the following.\n<br>" +

                                        "\t- The fullname of the class you're looking " +

                                                "for matches the value in the className " +

                                                "property of the XMLEntity ("+className+").\n<br>" +

                                        "\t- The jar file containing your symbol class is in" +

                                                "the application classpath<br>", e);

                }

                return obj;

        }

        /**

         * Returns a new empty instance of a <b>IMultiLayer</b> that can be one of:

         * <b>MultiLayerMarkerSymbol</b>, <b>MultiLayerLineSymbol</b>, or

         * <b>MultiLayerFillSymbol</b> depending on the shape type passed.

         *

         * @param shapeType, one of FShape.POINT, FShape.LINE, or FShape.POLYGON

         * @return IMultiLayerSymbol

         */

        public static IMultiLayerSymbol createEmptyMultiLayerSymbol(int shapeType) {

                IMultiLayerSymbol mSym;

                switch (shapeType) {

                case FShape.POINT:

                        mSym = new MultiLayerMarkerSymbol();

                        break;

                case FShape.LINE:

                        mSym = new MultiLayerLineSymbol();

                        break;

                case FShape.POLYGON:

                        mSym =new MultiLayerFillSymbol();

                        break;

                default:

                        throw new Error("Shape type not yet supported for multilayer symbols");

                }

                if (mSym instanceof CartographicSupport) {

                        CartographicSupport cs = (CartographicSupport) mSym;

                        cs.setUnit(CartographicSupportToolkit.DefaultMeasureUnit);

                        cs.setReferenceSystem(CartographicSupportToolkit.DefaultReferenceSystem);

                }

                return mSym;

        }

        /**

         * Returns a new instance of an <b>IMarkerSymbol</b>.

         * @return IMarkerSymbol, the default symbol for markers

         */

        public static IMarkerSymbol createDefaultMarkerSymbol() {

                SimpleMarkerSymbol sms = new SimpleMarkerSymbol();

                sms.setColor(DefaultSymbolColor);

                sms.setSize(4);

                toDefaultCartographicProperties(sms);

                return sms;

        }

        /**

         * Returns a new instance of an <b>ILineSymbol</b>. A black line.

         * @return ILineSymbol, the default symbol for lines.

         */

        public static ILineSymbol createDefaultLineSymbol() {

                SimpleLineSymbol sls = new SimpleLineSymbol();

                sls.setLineColor(DefaultSymbolColor);

                sls.setLineWidth(1);

                toDefaultCartographicProperties(sls);

                return sls;

        }

        private static void toDefaultCartographicProperties(CartographicSupport cs) {

                cs.setUnit(CartographicSupportToolkit.DefaultMeasureUnit);

                cs.setReferenceSystem(CartographicSupportToolkit.DefaultReferenceSystem);

        }

        /**

         * Returns a new instance of an <b>IFillSymbol</b>. Black outline,

         * and transparent fill.

         * @return IFillSymbol, the default symbol for polygons

         */

        public static IFillSymbol createDefaultFillSymbol() {

                SimpleFillSymbol sfs = new SimpleFillSymbol();

                // Default symbol for polygons

                sfs.setOutline(createDefaultLineSymbol());

                sfs.setFillColor(DefaultFillSymbolColor); // transparent fill

                toDefaultCartographicProperties(sfs);

                return sfs;

    }

        /**

         * Returns a new instance of an <b>ITextSymbol</b>.

         * @return ITextSymbol, the default symbol for texts

         */

        public static ITextSymbol createDefaultTextSymbol() {

                SimpleTextSymbol sts = new SimpleTextSymbol();

                sts.setFont(DefaultTextFont);

                sts.setTextColor(DefaultSymbolColor);

                toDefaultCartographicProperties(sts);

                return sts;

        }

        /**

         * Creates a new instance of the default symbol whose type is defined

         * by the parameter <b>shapeType</b>

         * @param shapeType, one of FShape.POINT, FShape.LINE, FShape.POLYGON,

         * FShape.MULTIPOINT, FShape.TEXT, or FShape.MULTI.

         * @return ISymbol, the default symbol for the shape type defined by <b>shapeType</b>

         */

        public static ISymbol createDefaultSymbolByShapeType(int shapeType) {

                switch (shapeType) {

                case FShape.POINT:

                        return createDefaultMarkerSymbol();

                case FShape.LINE:

                        return createDefaultLineSymbol();

                case FShape.POLYGON:

                        return createDefaultFillSymbol();

                case FShape.MULTIPOINT:

                        return createDefaultMarkerSymbol();

                case FShape.TEXT:

                        return createDefaultTextSymbol();

                case FShape.MULTI:

                        return new MultiShapeSymbol();

                case FShape.NULL:

                        return null;

                default:

                        throw new Error("shape type not yet supported");

                }

        }

        /**

         * Creates a new instance of the default symbol whose type is defined

         * by the parameter <b>shapeType</b> and uses the color defined by the

         * parameter color.

         * @param shapeType, one of FShape.POINT, FShape.LINE, FShape.POLYGON,

         * @param color, the color to be applied to the new ISymbol.

         *

         * FShape.MULTIPOINT, FShape.TEXT, or FShape.MULTI.

         * @return ISymbol, the default symbol for the shape type defined by <b>shapeType</b>

         */

        public static ISymbol createDefaultSymbolByShapeType(int shapeType, Color color) {

                ISymbol sym = createDefaultSymbolByShapeType(shapeType);

                if (sym instanceof IMarkerSymbol) {

                        ((IMarkerSymbol) sym).setColor(color);

                }

                if (sym instanceof ILineSymbol) {

                        ((ILineSymbol) sym).setLineColor(color);

                }

                if (sym instanceof IFillSymbol) {

                        ((IFillSymbol) sym).setFillColor(color);

                }

                if (sym instanceof ITextSymbol) {

                        ((ITextSymbol) sym).setTextColor(color);

                }

                return sym;

        }

        public static ISymbol getWarningSymbol(String message, String symbolDesc, int symbolDrawExceptionType) {

                if (warningSymbol == null) {

                        warningSymbol = new WarningSymbol();

                }

                warningSymbol.setDescription(symbolDesc);

                warningSymbol.setMessage(message);

                warningSymbol.setDrawExceptionType(symbolDrawExceptionType);

                return warningSymbol;

        }

        private static class WarningSymbol implements ISymbol {

                private String desc;

                private String message;

                private int exceptionType;

                public static void main(String[] args) {

                        JFrame f = new JFrame();

                        final ISymbol warning = SymbologyFactory.getWarningSymbol(SymbolDrawingException.STR_UNSUPPORTED_SET_OF_SETTINGS, "a description", SymbolDrawingException.UNSUPPORTED_SET_OF_SETTINGS);

                        JPanel preview = new JPanel() {

                                @Override

                                protected void paintComponent(Graphics g) {

                                        // TODO Auto-generated method stub

                                        super.paintComponent(g);

                                        Graphics2D g2 = (Graphics2D)g;

                                        try {

                                                warning.drawInsideRectangle(g2, g2.getTransform(), getBounds());

                                        } catch (SymbolDrawingException e) {

                                                // TODO Auto-generated catch block

                                                e.printStackTrace();

                                        }

                                }

                        };

                        f.setContentPane(preview);

                        f.pack();

                        f.setVisible(true);

                }

                public void draw(Graphics2D g, AffineTransform affineTransform,

                                FShape shp, Cancellable cancel) {

                try {

                        drawInsideRectangle(g, g.getTransform(), shp.getBounds());

                } catch (SymbolDrawingException e) {

                        // IMPOSSIBLE

                }

                }

                public void setDrawExceptionType(int symbolDrawExceptionType) {

                        this.exceptionType = symbolDrawExceptionType;

                }

                public void setMessage(String message) {

                        this.message = message;

                }

                public void drawInsideRectangle(Graphics2D g,

                                AffineTransform scaleInstance, Rectangle r)

                                throws SymbolDrawingException {

                        if (message == null) {

                                message = "Symbol undrawable.\nPlease, check errors.";

                        }

                        String[] messageLines = message.split("\n");

                        int strokeWidth = 5;

                        g.setColor(Color.red);

                        g.setStroke(new BasicStroke(strokeWidth, BasicStroke.CAP_BUTT, BasicStroke.JOIN_ROUND));

                        int x = r.x+strokeWidth;

                        int y = r.x+strokeWidth;

                        int width = r.width-(strokeWidth+strokeWidth);

                        int height = r.height-(strokeWidth+strokeWidth);

//                        g.drawOval(x, y, width, height);

//                        g.drawLine(x, y, width, height);

                        int fontSize = 20;

                        int vAlign = (int) (r.getCenterY() - ((fontSize+2)*messageLines.length/2));  

                        g.setFont(new Font("Arial", fontSize, Font.PLAIN));

                        g.setColor(Color.black);

                        for (int i = 0; i < messageLines.length; i++) {

                                g.drawString(messageLines[i], 2, -vAlign);

                                System.out.println(messageLines[i]);

                                vAlign += fontSize + 2;

                        }

                }

                public XMLEntity getXMLEntity() {

                        throw new Error("Found symbology problems, please fix them before saving."); }

                public String getDescription() { return desc; }

                public int getOnePointRgb() { return 0; }

                public ISymbol getSymbolForSelection() { return this; }

                public void getPixExtentPlus(FShape shp, float[] distances, ViewPort viewPort, int dpi) {}

                public int getSymbolType() { return 0; }

                public boolean isShapeVisible() { return false; }

                public boolean isSuitableFor(IGeometry geom) { return true; }

                public void setDescription(String desc) { this.desc = desc; }

                public void setXMLEntity(XMLEntity xml) { }

                public String getClassName() { return null;        }

                public void print(Graphics2D g, AffineTransform at,

                                FShape shape, PrintRequestAttributeSet properties)

                                throws ReadDriverException {

                        throw new ReadDriverException("Your symbology contains errors, please check them before printing.", 

                                        new SymbolDrawingException(exceptionType));

                }

        };

}