Application: gvSIG desktop

/* 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 13733 2007-09-17 09:32:05Z jaume $

* $Log$

* 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.Color;

import java.awt.Font;

import org.apache.log4j.Logger;

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.v02.FSymbol;

import com.iver.utiles.IPersistance;

import com.iver.utiles.NotExistInXMLEntity;

import com.iver.utiles.XMLEntity;

/**

 * 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 {

        public static Color DefaultSymbolColor = Color.DARK_GRAY;

        public static Color DefaultFillSymbolColor = new Color(60, 235, 235);

        public static Font DefaultTextFont = new Font("SansSerif", Font.PLAIN, 9);

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

        /**

         * 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;

                IPersistance obj = null;

                try {

                        clazz = Class.forName(className);

                        // TODO remove the patch the day we deprecate FSymbol

                        // begin patch

                        if (clazz.equals(FSymbol.class))

                                obj = FSymbol.createFromXML(xml);

                        else {

                        // end patch

                                obj = (IPersistance) clazz.newInstance();

                                obj.setXMLEntity(xml);

                        }

                } 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) {

                switch (shapeType) {

                case FShape.POINT:

                        return new MultiLayerMarkerSymbol();

                case FShape.LINE:

                        return new MultiLayerLineSymbol();

                case FShape.POLYGON:

                        return new MultiLayerFillSymbol();

                default:

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

                }

        }

        /**

         * 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(2);

                sms.setUnit(-1); // pixels

                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);

                sls.setUnit(-1); // Pixels

                return sls;

        }

        /**

         * 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

                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);

                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();

                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;

        }

}