/[schmitzm]/trunk/src/skrueger/geotools/StyledLayerUtil.java
ViewVC logotype

Diff of /trunk/src/skrueger/geotools/StyledLayerUtil.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/src/skrueger/geotools/StyledMapUtil.java revision 52 by mojays, Fri Apr 17 13:57:14 2009 UTC branches/1.0-gt2-2.6/src/skrueger/geotools/StyledLayerUtil.java revision 516 by alfonx, Wed Nov 11 21:17:33 2009 UTC
# Line 1  Line 1 
1  package skrueger.geotools;  /*******************************************************************************
2     * Copyright (c) 2009 Martin O. J. Schmitz.
3  import java.text.DecimalFormat;   *
4  import java.util.Map;   * This file is part of the SCHMITZM library - a collection of utility
5  import java.util.HashMap;   * classes based on Java 1.6, focusing (not only) on Java Swing
6  import java.util.List;   * and the Geotools library.
7  import java.util.SortedMap;   *
8  import java.util.TreeMap;   * The SCHMITZM project is hosted at:
9  import java.net.URL;   * http://wald.intevation.org/projects/schmitzm/
10     *
11  import org.geotools.feature.FeatureCollection;   * This program is free software; you can redistribute it and/or
12  import org.geotools.map.MapLayer;   * modify it under the terms of the GNU Lesser General Public License
13  import org.geotools.map.DefaultMapLayer;   * as published by the Free Software Foundation; either version 3
14  import org.geotools.coverage.grid.GridCoverage2D;   * of the License, or (at your option) any later version.
15  import org.geotools.coverage.grid.io.AbstractGridCoverage2DReader;   *
16  import org.geotools.data.FeatureSource;   * This program is distributed in the hope that it will be useful,
17  import org.geotools.styling.ColorMap;   * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  import org.geotools.styling.ColorMapEntry;   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  import org.geotools.styling.Style;   * GNU General Public License for more details.
20     *
21  import org.apache.log4j.Logger;   * You should have received a copy of the GNU Lesser General Public License (license.txt)
22     * along with this program; if not, write to the Free Software
23  import org.jdom.Element;   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
24  import org.jdom.Document;   * or try this link: http://www.gnu.org/licenses/lgpl.html
25  import org.jdom.input.SAXBuilder;   *
26  import org.jdom.output.XMLOutputter;   * Contributors:
27     *     Martin O. J. Schmitz - initial API and implementation
28  import schmitzm.geotools.styling.StylingUtil;   *     Stefan A. Krüger - additional utility classes
29  import skrueger.AttributeMetaData;   ******************************************************************************/
30  import skrueger.RasterLegendData;  package skrueger.geotools;
31  import skrueger.i8n.Translation;  
32  import schmitzm.io.IOUtil;  import java.awt.Color;
33  import java.io.File;  import java.awt.Dimension;
34  import java.io.FileNotFoundException;  import java.awt.Graphics2D;
35  import schmitzm.lang.LangUtil;  import java.awt.Rectangle;
36  import schmitzm.swing.SwingUtil;  import java.awt.geom.AffineTransform;
37    import java.awt.image.BufferedImage;
38  import java.io.FileWriter;  import java.awt.image.ColorModel;
39    import java.awt.image.ComponentColorModel;
40  /**  import java.awt.image.DataBuffer;
41   * This class provides static helper methods for dealing with  import java.io.File;
42   * {@link StyledMapInterface} stuff.  import java.io.FileNotFoundException;
43   * @author <a href="mailto:[email protected]">Martin Schmitz</a> (University of Bonn/Germany)  import java.io.FileWriter;
44   * @version 1.0  import java.net.URL;
45   */  import java.text.DecimalFormat;
46  public class StyledMapUtil {  import java.util.List;
47    private static final Logger LOGGER = Logger.getLogger(StyledMapUtil.class.getName());  import java.util.Map;
48    private static final SAXBuilder SAX_BUILDER = new SAXBuilder();  
49    private static final XMLOutputter XML_OUTPUTTER = new XMLOutputter();  import javax.swing.BorderFactory;
50    import javax.swing.ImageIcon;
51    /** URL for Atlas XML schema */  import javax.swing.JComponent;
52    public static final String AMLURI = "http://www.wikisquare.de/AtlasML";  import javax.swing.JLabel;
53    /** Name of the XML Element for the attribute meta data map */  
54    public static final String ELEM_NAME_AMD = "attributeMetaData";  import net.miginfocom.swing.MigLayout;
55    /** Name of the XML Element for the raster legend data */  
56    public static final String ELEM_NAME_RLD = "rasterLegendData";  import org.apache.log4j.Logger;
57    /** Name of the XML Element for an attribute meta data map entry */  import org.geotools.coverage.grid.GeneralGridEnvelope;
58    public static final String ELEM_NAME_ATTRIBUTE = "dataAttribute";  import org.geotools.coverage.grid.GridCoverage2D;
59    /** Name of the XML Element for an raster legend data entry */  import org.geotools.coverage.grid.GridGeometry2D;
60    public static final String ELEM_NAME_RASTERLEGEND = "rasterLegendItem";  import org.geotools.coverage.grid.io.AbstractGridCoverage2DReader;
61    /** Name of the XML Element for a translation */  import org.geotools.coverage.grid.io.AbstractGridFormat;
62    public static final String ELEM_NAME_TRANSLATION = "translation";  import org.geotools.feature.FeatureCollection;
63    import org.geotools.feature.NameImpl;
64    /**  import org.geotools.geometry.jts.ReferencedEnvelope;
65     * Creates a Geotools {@link MapLayer} from an object. If the object is a  import org.geotools.map.DefaultMapLayer;
66     * {@link StyledMapInterface} then its sytle is used. In case of direct  import org.geotools.map.MapLayer;
67     * Geotools objects ({@link GridCoverage2D}, {@link AbstractGridCoverage2DReader},  import org.geotools.parameter.Parameter;
68     * {@link FeatureCollection}) a default style is generated.  import org.geotools.renderer.lite.gridcoverage2d.GridCoverageRenderer;
69     * @param object an Object  import org.geotools.styling.ColorMap;
70     * @exception Exception if {@code null} is given as object or an error occurs during layer creation  import org.geotools.styling.ColorMapEntry;
71     */  import org.geotools.styling.FeatureTypeStyle;
72    public static MapLayer createMapLayer(Object object) throws Exception {  import org.geotools.styling.RasterSymbolizer;
73      return createMapLayer(object,null);  import org.geotools.styling.Rule;
74    }  import org.geotools.styling.Style;
75    import org.jdom.Document;
76    /**  import org.jdom.Element;
77     * Creates a Geotools {@link MapLayer} from an object. If the object is a  import org.jdom.input.SAXBuilder;
78     * {@link StyledMapInterface} then its sytle is used. In case of direct  import org.jdom.output.XMLOutputter;
79     * Geotools objects ({@link GridCoverage2D}, {@link AbstractGridCoverage2DReader},  import org.opengis.feature.simple.SimpleFeature;
80     * {@link FeatureCollection}) a default style is generated.  import org.opengis.feature.simple.SimpleFeatureType;
81     * @param object an Object  import org.opengis.feature.type.Name;
82     * @param forcedStyle (SLD-)Style to force for the object  import org.opengis.parameter.GeneralParameterValue;
83     * @exception Exception if {@code null} is given as object or an error occurs during layer creation  
84     */  import schmitzm.geotools.JTSUtil;
85    public static MapLayer createMapLayer(Object object, Style forcedStyle) throws Exception {  import schmitzm.geotools.feature.FeatureUtil;
86      MapLayer layer     = null;  import schmitzm.geotools.styling.StylingUtil;
87      Style    style     = null;  import schmitzm.io.IOUtil;
88      if ( object instanceof StyledMapInterface ) {  import schmitzm.lang.LangUtil;
89        style =  ((StyledMapInterface<?>)object).getStyle();  import schmitzm.swing.JPanel;
90        object = ((StyledMapInterface<?>)object).getGeoObject();  import schmitzm.swing.SwingUtil;
91      }  import skrueger.AttributeMetadata;
92      if ( forcedStyle != null )  import skrueger.RasterLegendData;
93        style = forcedStyle;  import skrueger.i8n.Translation;
94      if ( style == null )  
95        style = StylingUtil.createDefaultStyle(object);  /**
96     * This class provides static helper methods for dealing with
97      if (object instanceof GridCoverage2D)   * {@link StyledLayerInterface} stuff.
98        layer = new DefaultMapLayer( (GridCoverage2D) object, style);   *
99      if (object instanceof AbstractGridCoverage2DReader)   * @author <a href="mailto:[email protected]">Martin Schmitz</a>
100        layer = new DefaultMapLayer( (AbstractGridCoverage2DReader) object, style);   *         (University of Bonn/Germany)
101      if (object instanceof FeatureCollection)   * @version 1.0
102        layer = new DefaultMapLayer( (FeatureCollection) object, style);   */
103    public class StyledLayerUtil {
104      if ( layer == null )          private static final Logger LOGGER = Logger.getLogger(StyledLayerUtil.class
105        throw new Exception("Can not create MapLayer from "+(object == null ? "null" : object.getClass()));                          .getName());
106            private static final SAXBuilder SAX_BUILDER = new SAXBuilder();
107      return layer;          private static final XMLOutputter XML_OUTPUTTER = new XMLOutputter();
108    }  
109            /** URL for Atlas XML schema */
110    /**          public static final String AMLURI = "http://www.wikisquare.de/AtlasML";
111     * Creates an default instance of {@link StyledMapInterface} for a Geotools          /** Name of the XML Element for the attribute meta data map */
112     * object ({@link GridCoverage2D}, {@link FeatureCollection}) with a default          public static final String ELEM_NAME_AMD = "attributeMetaData";
113     * style.          /** Name of the XML Element for the raster legend data */
114     * @param object an Object          public static final String ELEM_NAME_RLD = "rasterLegendData";
115     * @param title  title for the object          /** Name of the XML Element for an attribute meta data map entry */
116     * @exception UnsupportedOperationException if {@code null} is given as object or an error occurs during creation          public static final String ELEM_NAME_ATTRIBUTE = "dataAttribute";
117     */          /** Name of the XML Element for an raster legend data entry */
118    public static StyledMapInterface<?> createStyledMap(Object object, String title) {          public static final String ELEM_NAME_RASTERLEGEND = "rasterLegendItem";
119       return createStyledMap(object, title, null);          /** Name of the XML Element for a translation */
120    }          public static final String ELEM_NAME_TRANSLATION = "translation";
121    
122    /**          /**
123     * Creates an default instance of {@link StyledMapInterface} for a Geotools           * Creates a Geotools {@link MapLayer} from an object. If the object is a
124     * object ({@link GridCoverage2D}, {@link FeatureCollection}) with a given           * {@link StyledLayerInterface} then its sytle is used. In case of direct
125     * style.           * Geotools objects ({@link GridCoverage2D},
126     * @param object an Object           * {@link AbstractGridCoverage2DReader}, {@link FeatureCollection}) a
127     * @param title  title for the object           * default style is generated.
128     * @param style  style and meta data for the object           *
129     * @exception UnsupportedOperationException if {@code null} is given as object or an error occurs during creation           * @param object
130     */           *            an Object
131    public static StyledMapInterface<?> createStyledMap(Object object, String title, StyledMapStyle style) {           * @exception Exception
132      StyledMapInterface<?> styledObject = null;           *                if {@code null} is given as object or an error occurs
133             *                during layer creation
134      String id = (title != null) ? title : "defaultID";           */
135            public static MapLayer createMapLayer(final Object object) throws Exception {
136      if ( object instanceof GridCoverage2D )                  return createMapLayer(object, null);
137        styledObject = new StyledGridCoverage(          }
138            (GridCoverage2D)object,  
139            id,          /**
140            title,           * Creates a Geotools {@link MapLayer} from an object. If the object is a
141            style           * {@link StyledLayerInterface} then its sytle is used. In case of direct
142        );           * Geotools objects ({@link GridCoverage2D},
143      else if ( object instanceof AbstractGridCoverage2DReader )           * {@link AbstractGridCoverage2DReader}, {@link FeatureCollection}) a
144             styledObject = new StyledGridCoverageReader(           * default style is generated.
145                 (AbstractGridCoverage2DReader)object,           *
146                 id,           * @param object
147                 title,           *            an Object
148                 style           * @param forcedStyle
149             );           *            (SLD-)Style to force for the object
150      else if ( object instanceof FeatureCollection )           * @exception Exception
151        styledObject = new StyledFeatureCollection(           *                if {@code null} is given as object or an error occurs
152            (FeatureCollection)object,           *                during layer creation
153            id,           */
154            title,          public static MapLayer createMapLayer(Object object, final Style forcedStyle)
155            style                          throws Exception {
156        );                  MapLayer layer = null;
157                        Style style = null;
158      if ( styledObject == null )                  if (object instanceof StyledLayerInterface) {
159        throw new UnsupportedOperationException("Can not create StyledMapInterface object from "+(object == null ? "null" : object.getClass()));                          style = ((StyledLayerInterface<?>) object).getStyle();
160                            object = ((StyledLayerInterface<?>) object).getGeoObject();
161      return styledObject;                  }
162    }                  if (forcedStyle != null)
163                            style = forcedStyle;
164    /**                  if (style == null)
165     * Return only the visible or invisible entries of an AttributeMetaData-Map.                          style = StylingUtil.createDefaultStyle(object);
166     * @param amdMap AttributeMetaData-Map  
167     * @param visible indicated whether the visible or invisible entries are                  if (object instanceof GridCoverage2D)
168     *                returned                          layer = new DefaultMapLayer((GridCoverage2D) object, style);
169     */                  if (object instanceof AbstractGridCoverage2DReader)
170    public static Map<Integer,AttributeMetaData> getVisibleAttributeMetaData(Map<Integer,AttributeMetaData> amdMap, boolean visible) {                          layer = new DefaultMapLayer((AbstractGridCoverage2DReader) object,
171      SortedMap<Integer,AttributeMetaData> filteredMap = new TreeMap<Integer,AttributeMetaData>();                                          style);
172      for (AttributeMetaData amd : amdMap.values())                  if (object instanceof FeatureCollection)
173        if ( amd.isVisible() )                          layer = new DefaultMapLayer((FeatureCollection) object, style);
174          filteredMap.put(amd.getColIdx(), amd);  
175                        if (layer == null)
176      return filteredMap;                          throw new Exception("Can not create MapLayer from "
177    }                                          + (object == null ? "null" : object.getClass()));
178      
179                      return layer;
180    /**          }
181     * Parses a {@link AttributeMetaData} object from an JDOM-{@link Element}.  
182     * This method works like {@link AMLImport#parseDataAttribute(org.w3c.dom.Node},          /**
183     * but for JDOM.           * Creates an default instance of {@link StyledLayerInterface} for a
184     * @param element {@link Element} to parse           * Geotools object ({@link GridCoverage2D}, {@link FeatureCollection}) with
185     */           * a default style.
186    public static AttributeMetaData parseAttributeMetaData(final Element element) {           *
187      final Integer col = Integer.valueOf(element.getAttributeValue("col"));           * @param object
188      final Boolean visible = Boolean.valueOf(element.getAttributeValue("visible"));           *            an Object
189      final String unit = element.getAttributeValue("unit");           * @param title
190             *            title for the object
191      Translation name = new Translation();           * @exception UnsupportedOperationException
192      Translation desc = new Translation();           *                if {@code null} is given as object or an error occurs
193      for (final Element childElement : (List<Element>)element.getChildren()) {           *                during creation
194        if (childElement.getName() == null)           */
195          continue;          public static StyledLayerInterface<?> createStyledLayer(
196                            final Object object, final String title) {
197        if (childElement.getName().equals("name"))                  return createStyledLayer(object, title, null);
198          name = parseTranslation(childElement);          }
199        else if (childElement.getName().equals("desc"))  
200          desc = parseTranslation(childElement);          /**
201      }           * Creates an default instance of {@link StyledLayerInterface} for a
202      return new AttributeMetaData(col, visible, name, desc, unit);           * Geotools object ({@link GridCoverage2D}, {@link FeatureCollection}) with
203    }           * a given style.
204             *
205    /**           * @param object
206     * Parses a {@link AttributeMetaData} map from an JDOM-{@link Element}           *            an Object
207     * with {@code <attribute>}-childs.           * @param title
208     * @param element {@link Element} to parse           *            title for the object
209     */           * @param style
210    public static Map<Integer,AttributeMetaData> parseAttributeMetaDataMap(final Element element) {           *            style and meta data for the object
211      HashMap<Integer,AttributeMetaData> metaData = new HashMap<Integer,AttributeMetaData>();           * @exception UnsupportedOperationException
212      List<Element> attributesElements = element.getChildren( ELEM_NAME_ATTRIBUTE );           *                if {@code null} is given as object or an error occurs
213      for (Element attibuteElement : attributesElements)           *                during creation
214      {           */
215        AttributeMetaData attrMetaData = parseAttributeMetaData( attibuteElement );          public static StyledLayerInterface<?> createStyledLayer(
216        metaData.put( attrMetaData.getColIdx(), attrMetaData );                          final Object object, final String title,
217      }                          final StyledLayerStyle style) {
218      return metaData;                  StyledLayerInterface<?> styledLayer = null;
219    }  
220                    final String id = (title != null) ? title : "defaultID";
221    /**  
222     * Loads a {@link AttributeMetaData} object from an URL.                  if (object instanceof GridCoverage2D)
223     * @param documentUrl {@link URL} to parse                          styledLayer = new StyledGridCoverage((GridCoverage2D) object, id,
224     * @see #parseAttributeMetaData(Element)                                          title, style);
225     */                  else if (object instanceof AbstractGridCoverage2DReader)
226    public static Map<Integer,AttributeMetaData> loadAttributeMetaDataMap(final URL documentUrl) throws Exception {                          styledLayer = new StyledGridCoverageReader(
227      Document document = SAX_BUILDER.build(documentUrl);                                          (AbstractGridCoverage2DReader) object, id, title, style);
228      return parseAttributeMetaDataMap( document.getRootElement() );                  else if (object instanceof FeatureCollection)
229    }                          styledLayer = new StyledFeatureCollection(
230                                            (FeatureCollection) object, id, title, style);
231    /**  
232     * Creates an JDOM {@link Element} for the given {@link AttributeMetaData}                  if (styledLayer == null)
233     * object.                          throw new UnsupportedOperationException(
234     * @param amd meta data for one attribute                                          "Can not create StyledLayerInterface object from "
235     */                                                          + (object == null ? "null" : object.getClass()));
236    public static Element createAttributeMetaDataElement(final AttributeMetaData amd) {  
237      final Element element = new Element( ELEM_NAME_ATTRIBUTE , AMLURI);                  return styledLayer;
238      element.setAttribute("col", String.valueOf( amd.getColIdx() ) );          }
239      element.setAttribute("visible", String.valueOf( amd.isVisible() ) );  
240      element.setAttribute("unit", amd.getUnit() );          /**
241      // Creating a aml:name tag...           * Return only the visible or invisible entries of an AttributeMetaData-Map.
242      element.addContent( createTranslationElement("name", amd.getTitle()) );           *
243      // Creating a aml:desc tag...           * @param amdMap
244      element.addContent( createTranslationElement("desc", amd.getDesc()) );           *            AttributeMetaData-Map
245      return element;           * @param visible
246    }           *            indicated whether the visible or invisible entries are
247             *            returned
248    /**           */
249     * Creates an JDOM {@link Element} for the given {@link AttributeMetaData}          public static AttributeMetadataMap getVisibleAttributeMetaData(
250     * map.                          final AttributeMetadataMap amdMap, final boolean visible) {
251     * @param amdMap map of attribute meta data  
252     */                  final AttributeMetadataMap filteredMap = new AttributeMetadataMap();
253    public static Element createAttributeMetaDataMapElement(final Map<Integer,AttributeMetaData> amdMap) {                  for (final AttributeMetadata amd : amdMap.values())
254      final Element element = new Element( ELEM_NAME_AMD , AMLURI);                          if (amd.isVisible() == visible)
255      for (AttributeMetaData amd : amdMap.values())                                  filteredMap.put(amd.getName(), amd);
256        element.addContent( createAttributeMetaDataElement( amd ) );  
257      return element;                  return filteredMap;
258    }          }
259    
260    /**          /**
261     * Saves a {@link AttributeMetaData AttributeMetaData-Map} to an URL.           * Parses a {@link AttributeMetadata} object from an JDOM-{@link Element}.
262     * @param amdMap map of {@link AttributeMetaData}           * This method works like {@link
263     * @param documentUrl {@link URL} to store the XML           * AMLImport#parseDataAttribute(org.w3c.dom.Node}, but for JDOM.
264     */           *
265    public static void saveAttributeMetaDataMap(final Map<Integer,AttributeMetaData> amdMap, final URL documentUrl) throws Exception {           * @param element
266      // Create XML-Document           *            {@link Element} to parse
267      final FileWriter out = new FileWriter( new File(documentUrl.toURI()) );           */
268      XML_OUTPUTTER.output(          public static AttributeMetadata parseAttributeMetaData(final Element element) {
269        createAttributeMetaDataMapElement(amdMap),                  final String namespace = String.valueOf(element
270        out                                  .getAttributeValue("namespace"));
271      );                  final String localname = String.valueOf(element
272      out.flush();                                  .getAttributeValue("localname"));
273      out.close();                  final Name aName = new NameImpl(namespace, localname);
274    }                  final Boolean visible = Boolean.valueOf(element
275                                    .getAttributeValue("visible"));
276                    final String unit = element.getAttributeValue("unit");
277    
278    /**                  Translation name = new Translation();
279     * Parses a {@link RasterLegendData} object from an JDOM-{@link Element}.                  Translation desc = new Translation();
280     * This method works like {@link AMLImport#parseRasterLegendData(org.w3c.dom.Node},                  for (final Element childElement : (List<Element>) element.getChildren()) {
281     * but for JDOM.                          if (childElement.getName() == null)
282     * @param element {@link Element} to parse                                  continue;
283     */  
284    public static RasterLegendData parseRasterLegendData(Element element) {                          if (childElement.getName().equals("name"))
285                                    name = parseTranslation(childElement);
286      final boolean paintGaps = Boolean.valueOf( element.getAttributeValue("paintGaps") );                          else if (childElement.getName().equals("desc"))
287                                    desc = parseTranslation(childElement);
288      RasterLegendData rld = new RasterLegendData(paintGaps);                  }
289                    return new AttributeMetadata(aName, visible, name, desc, unit);
290      for ( Element childElement : (List<Element>)element.getChildren() ) {          }
291        final String name = childElement.getName();  
292        // Cancel if it's an attribute          /**
293        if ( childElement.getChildren().size() == 0 )           * Parses a {@link AttributeMetadata} map from an JDOM-{@link Element} with
294          continue;           * {@code <attribute>}-childs.
295             *
296        if (name.equals( ELEM_NAME_RASTERLEGEND )) {           * @param element
297          final String valueAttr = childElement.getAttributeValue("value");           *            {@link Element} to parse
298          if ( valueAttr == null )           */
299            throw new UnsupportedOperationException("Attribute 'value' missing for definition of <"+ELEM_NAME_RASTERLEGEND+">");          public static AttributeMetadataMap parseAttributeMetaDataMap(
300          final double value = Double.valueOf(valueAttr);                          final Element element) {
301                    final AttributeMetadataMap metaData = new AttributeMetadataMap();
302          // first and only item should be the label                  final List<Element> attributesElements = element
303          final Element labelElement = childElement.getChild("label");                                  .getChildren(ELEM_NAME_ATTRIBUTE);
304          // id label element is missing, the translation is searched directly                  for (final Element attibuteElement : attributesElements) {
305          // as childs of the rasterLegendItem element                          final AttributeMetadata attrMetaData = parseAttributeMetaData(attibuteElement);
306          Translation label = parseTranslation( labelElement != null ? labelElement : childElement );                          metaData.put(attrMetaData.getName(), attrMetaData);
307          rld.put(value, label);                  }
308        }                  return metaData;
309      }          }
310    
311      return rld;          /**
312    }           * Loads a {@link AttributeMetadata} object from an URL.
313             *
314    /**           * @param documentUrl
315     * Loads a {@link RasterLegendData} object from an URL.           *            {@link URL} to parse
316     * @param documentUrl {@link URL} to parse           * @see #parseAttributeMetaData(Element)
317     * @see #parseAttributeMetaData(Element)           */
318     */          public static AttributeMetadataMap loadAttributeMetaDataMap(
319    public static RasterLegendData loadRasterLegendData(final URL documentUrl) throws Exception {                          final URL documentUrl) throws Exception {
320      Document document = SAX_BUILDER.build(documentUrl);                  final Document document = SAX_BUILDER.build(documentUrl);
321      return parseRasterLegendData( document.getRootElement() );                  return parseAttributeMetaDataMap(document.getRootElement());
322    }          }
323    
324   /**          /**
325     * Creates an JDOM {@link Element} for the given {@link RasterLegendData}           * Creates an JDOM {@link Element} for the given {@link AttributeMetadata}
326     * map.           * object.
327     * @param rld raster legend data           *
328     */           * @param amd
329    public static Element createRasterLegendDataElement(final RasterLegendData rld) {           *            meta data for one attribute
330      final Element element = new Element( ELEM_NAME_RLD , AMLURI);           */
331      element.setAttribute("paintGaps", rld.isPaintGaps().toString());          public static Element createAttributeMetaDataElement(
332      for (Double key : rld.getSortedKeys()) {                          final AttributeMetadata amd) {
333        Element item = new Element( ELEM_NAME_RASTERLEGEND, AMLURI);                  final Element element = new Element(ELEM_NAME_ATTRIBUTE, AMLURI);
334        item.setAttribute("value", key.toString());                  element.setAttribute("namespace", String.valueOf(amd.getName()
335        item.addContent( createTranslationElement("label", rld.get(key)) );                                  .getNamespaceURI()));
336        element.addContent(item);                  element.setAttribute("localname", String.valueOf(amd.getLocalName()));
337      }                  element.setAttribute("visible", String.valueOf(amd.isVisible()));
338      return element;                  element.setAttribute("unit", amd.getUnit());
339    }                  // Creating a aml:name tag...
340                    element.addContent(createTranslationElement("name", amd.getTitle()));
341    /**                  // Creating a aml:desc tag...
342     * Creates {@link RasterLegendData} from a {@link ColorMap}.                  element.addContent(createTranslationElement("desc", amd.getDesc()));
343     * @param colorMap  a color map                  return element;
344     * @param paintGaps indicated whether gaps are painted between the legend items          }
345     * @param digits    number of digits the grid value classes (and legend) are  
346     *                  rounded to (null means no round; >= 0 means digits after comma;          /**
347     *                  < 0 means digits before comma)    */           * Creates an JDOM {@link Element} for the given {@link AttributeMetadata}
348    public static RasterLegendData generateRasterLegendData(ColorMap colorMap, boolean paintGaps, Integer digits) {           * map.
349      DecimalFormat    decFormat = digits != null ? new DecimalFormat( SwingUtil.getNumberFormatPattern(digits) ) : null;           *
350      RasterLegendData rld       = new RasterLegendData(paintGaps);           * @param amdMap
351      for (ColorMapEntry cme : colorMap.getColorMapEntries())           *            map of attribute meta data
352      {           */
353        double value = StylingUtil.getQuantityFromColorMapEntry(cme);          public static Element createAttributeMetaDataMapElement(
354        String label = cme.getLabel();                          final AttributeMetadataMap amdMap) {
355        // if no label is set (e.g. quantitative style),                  final Element element = new Element(ELEM_NAME_AMD, AMLURI);
356        // use the value as label                  for (final AttributeMetadata amd : amdMap.values())
357        if ( label == null || label.equals("") )                          element.addContent(createAttributeMetaDataElement(amd));
358          if ( digits == null )                  return element;
359            label = String.valueOf(value);          }
360          else  
361            label = decFormat.format( LangUtil.round(value, digits) );          /**
362        rld.put( value, new Translation("   "+label) );           * Saves a {@link AttributeMetadata AttributeMetaData-Map} to an URL.
363      }           *
364      return rld;           * @param amdMap
365    }           *            map of {@link AttributeMetadata}
366             * @param documentUrl
367    /**           *            {@link URL} to store the XML
368     * Creates {@link RasterLegendData} from the {@link ColorMap} of a style.           */
369     * @param style     a raster style (must contain a  {@link RasterSymbolizer})          public static void saveAttributeMetaDataMap(
370     * @param paintGaps indicated whether gaps are painted between the legend items                          final AttributeMetadataMap amdMap, final URL documentUrl)
371     * @param digits    number of digits the grid value classes (and legend) are                          throws Exception {
372     *                  rounded to (null means no round; >= 0 means digits after comma;                  // Create XML-Document
373     *                  < 0 means digits before comma)    */                  final FileWriter out = new FileWriter(new File(documentUrl.toURI()));
374    public static RasterLegendData generateRasterLegendData(Style style, boolean paintGaps, Integer digits) {                  XML_OUTPUTTER.output(createAttributeMetaDataMapElement(amdMap), out);
375      ColorMap colorMap = StylingUtil.getColorMapFromStyle(style);                  out.flush();
376      if ( colorMap == null)                  out.close();
377        throw new IllegalArgumentException("Color map can not be determined from style!");          }
378      return generateRasterLegendData(colorMap, paintGaps, digits);  
379    }          /**
380             * Parses a {@link RasterLegendData} object from an JDOM-{@link Element}.
381    /**           * This method works like {@link
382     * Saves a {@link RasterLegendData} to an URL.           * AMLImport#parseRasterLegendData(org.w3c.dom.Node}, but for JDOM.
383     * @param rld raster legend data           *
384     * @param documentUrl {@link URL} to store the XML           * @param element
385     */           *            {@link Element} to parse
386    public static void saveRasterLegendData(final RasterLegendData rld, final URL documentUrl) throws Exception {           */
387      // Create XML-Document          public static RasterLegendData parseRasterLegendData(final Element element) {
388      final FileWriter out = new FileWriter( new File(documentUrl.toURI()) );  
389      XML_OUTPUTTER.output(                  final boolean paintGaps = Boolean.valueOf(element
390        createRasterLegendDataElement(rld),                                  .getAttributeValue("paintGaps"));
391        out  
392      );                  final RasterLegendData rld = new RasterLegendData(paintGaps);
393      out.flush();  
394      out.close();                  for (final Element childElement : (List<Element>) element.getChildren()) {
395    }                          final String name = childElement.getName();
396                            // Cancel if it's an attribute
397    /**                          if (childElement.getChildren().size() == 0)
398     * Parses a {@link Translation} object from an JDOM-{@link Element}.                                  continue;
399     * This method works like {@link AMLImport#parseTranslation(org.w3c.dom.Node},  
400     * but for JDOM.                          if (name.equals(ELEM_NAME_RASTERLEGEND)) {
401     * @param element {@link Element} to parse                                  final String valueAttr = childElement
402     */                                                  .getAttributeValue("value");
403    public final static Translation parseTranslation(final Element element) {                                  if (valueAttr == null)
404      Translation trans = new Translation();                                          throw new UnsupportedOperationException(
405                                                            "Attribute 'value' missing for definition of <"
406      if (element == null)                                                                          + ELEM_NAME_RASTERLEGEND + ">");
407       return trans;                                  final double value = Double.valueOf(valueAttr);
408    
409      for (final Element translationElement : (List<Element>)element.getChildren()) {                                  // first and only item should be the label
410        final String name = translationElement.getName();                                  final Element labelElement = childElement.getChild("label");
411        if (name == null)                                  // id label element is missing, the translation is searched
412          continue;                                  // directly
413                                    // as childs of the rasterLegendItem element
414        // lang attribute                                  final Translation label = parseTranslation(labelElement != null ? labelElement
415        String lang = translationElement.getAttributeValue("lang");                                                  : childElement);
416        // set the default, if no language code is set                                  rld.put(value, label);
417        if ( lang == null )                          }
418          lang = Translation.DEFAULT_KEY;                  }
419    
420        final String translationText = translationElement.getValue();                  return rld;
421        if (translationText == null)          }
422          trans.put(lang, "");  
423        else          /**
424          trans.put(lang, translationText);           * Loads a {@link RasterLegendData} object from an URL.
425      }           *
426             * @param documentUrl
427      // if no <translation> is given, the value of the node should           *            {@link URL} to parse
428      // be used as a default translation           * @see #parseAttributeMetaData(Element)
429      if (trans.size() == 0)           */
430        trans.put( Translation.DEFAULT_KEY, element.getValue() );          public static RasterLegendData loadRasterLegendData(final URL documentUrl)
431      //     trans = new Translation( ((List<Element>)element.getChildren()).get(0).getValue() );                          throws Exception {
432                    final Document document = SAX_BUILDER.build(documentUrl);
433      return trans;                  return parseRasterLegendData(document.getRootElement());
434    }          }
435    
436    /**          /**
437     * Creates an JDOM {@link Element} for the given {@link Translation}.           * Creates an JDOM {@link Element} for the given {@link RasterLegendData}
438     * @param tagname Name of the Element           * map.
439     * @param translation Translation to store in the Element           *
440     */           * @param rld
441    public final static Element createTranslationElement(String tagname, Translation translation) {           *            raster legend data
442      Element element = new Element(tagname, AMLURI);           */
443      if ( translation == null )          public static Element createRasterLegendDataElement(
444        throw new UnsupportedOperationException("Translation element can not be created from null!");                          final RasterLegendData rld) {
445                    final Element element = new Element(ELEM_NAME_RLD, AMLURI);
446      // If only a default translation is set, the <translation lang="..">..</tranlation>                  element.setAttribute("paintGaps", rld.isPaintGaps().toString());
447      // part is not used                  for (final Double key : rld.getSortedKeys()) {
448      if (translation.keySet().size() == 1 && translation.get(Translation.DEFAULT_KEY) != null) {                          final Element item = new Element(ELEM_NAME_RASTERLEGEND, AMLURI);
449        element.addContent( translation.get(Translation.DEFAULT_KEY) );                          item.setAttribute("value", key.toString());
450        return element;                          item.addContent(createTranslationElement("label", rld.get(key)));
451      }                          element.addContent(item);
452                    }
453      // add a <translation lang="..">..</tranlation> part to the element for                  return element;
454      // all languages          }
455      for (String lang : translation.keySet()) {  
456        Element translationElement = new Element( ELEM_NAME_TRANSLATION , AMLURI);          /**
457        translationElement.setAttribute("lang", lang);           * Creates {@link RasterLegendData} from a {@link ColorMap}.
458        String translationString = translation.get(lang);           *
459        if (translationString == null)           * @param colorMap
460         translationString = "";           *            a color map
461        translationElement.addContent( translationString );           * @param paintGaps
462        element.addContent(translationElement);           *            indicated whether gaps are painted between the legend items
463      }           * @param digits
464             *            number of digits the grid value classes (and legend) are
465      return element;           *            rounded to (null means no round; >= 0 means digits after
466    }           *            comma; < 0 means digits before comma)
467             */
468            public static RasterLegendData generateRasterLegendData(
469    /**                          final ColorMap colorMap, final boolean paintGaps,
470     * Sets a style to {@link StyledMapInterface}.                          final Integer digits) {
471     * @param styledObject a styled object                  final DecimalFormat decFormat = digits != null ? new DecimalFormat(
472     * @param style a Style                                  SwingUtil.getNumberFormatPattern(digits)) : null;
473     */                  final RasterLegendData rld = new RasterLegendData(paintGaps);
474    public static void setStyledMapStyle(StyledMapInterface styledObject, StyledMapStyle<?> style) {                  for (final ColorMapEntry cme : colorMap.getColorMapEntries()) {
475      // set SLD style                          final double value = StylingUtil.getQuantityFromColorMapEntry(cme);
476      styledObject.setStyle( style.getGeoObjectStyle() );                          String label = cme.getLabel();
477      // set meta data                          // if no label is set (e.g. quantitative style),
478      if ( styledObject        instanceof StyledGridCoverageInterface &&                          // use the value as label
479           (style.getMetaData() instanceof RasterLegendData || style.getMetaData() == null) ) {                          if (label == null || label.equals(""))
480        RasterLegendData sourceRld = (RasterLegendData)style.getMetaData();                                  if (digits == null)
481        RasterLegendData destRld = ((StyledGridCoverageInterface)styledObject).getLegendMetaData();                                          label = String.valueOf(value);
482        if ( destRld != null && sourceRld != null ) {                                  else
483          destRld.setPaintGaps(sourceRld.isPaintGaps());                                          label = decFormat.format(LangUtil.round(value, digits));
484          destRld.clear();                          rld.put(value, new Translation("   " + label));
485          destRld.putAll( sourceRld );                  }
486        }                  return rld;
487        return;          }
488      }  
489      if ( styledObject        instanceof StyledFeatureCollectionInterface &&          /**
490           (style.getMetaData() instanceof Map || style.getMetaData() == null) ) {           * Creates {@link RasterLegendData} from the {@link ColorMap} of a style.
491        Map<Integer, AttributeMetaData> sourceAmd = (Map<Integer, AttributeMetaData>)style.getMetaData();           *
492        Map<Integer, AttributeMetaData> destAmd   = ((StyledFeatureCollectionInterface)styledObject).getAttributeMetaDataMap();           * @param style
493        if ( destAmd != null && sourceAmd != null ) {           *            a raster style (must contain a {@link RasterSymbolizer})
494          destAmd.clear();           * @param paintGaps
495          destAmd.putAll( sourceAmd );           *            indicated whether gaps are painted between the legend items
496        }           * @param digits
497        return;           *            number of digits the grid value classes (and legend) are
498      }           *            rounded to (null means no round; >= 0 means digits after
499             *            comma; < 0 means digits before comma)
500      throw new UnsupportedOperationException("Style is not compatible to object: " +           */
501                                              (style.getMetaData() == null ? null : style.getMetaData().getClass().getSimpleName()) +          public static RasterLegendData generateRasterLegendData(final Style style,
502                                              " <-> " +                          final boolean paintGaps, final Integer digits) {
503                                              (styledObject == null ? null : styledObject.getClass().getSimpleName()));                  final ColorMap colorMap = StylingUtil.getColorMapFromStyle(style);
504    }                  if (colorMap == null)
505                            throw new IllegalArgumentException(
506    /**                                          "Color map can not be determined from style!");
507     * Returns the style a {@link StyledMapInterface} as a {@link StyledMapStyle}.                  return generateRasterLegendData(colorMap, paintGaps, digits);
508     * @param styledObject a styled object          }
509     * @return {@code StyledMapStyle<RasterLegendData>} for {@link StyledGridCoverageInterface}  
510     *         or {@code StyledMapStyle<Map<Integer,AttributeMetaData>>} for          /**
511     *         {@link StyledFeatureCollectionInterface}           * Saves a {@link RasterLegendData} to an URL.
512     */           *
513    public static StyledMapStyle<?> getStyledMapStyle(StyledMapInterface styledObject) {           * @param rld
514      if ( styledObject instanceof StyledGridCoverageInterface )           *            raster legend data
515        return getStyledMapStyle( (StyledGridCoverageInterface)styledObject );           * @param documentUrl
516      if ( styledObject instanceof StyledFeatureCollectionInterface )           *            {@link URL} to store the XML
517        return getStyledMapStyle( (StyledFeatureCollectionInterface)styledObject );           */
518      throw new UnsupportedOperationException("Unknown type of StyledMapInterface: "+(styledObject == null ? null : styledObject.getClass().getSimpleName()));          public static void saveRasterLegendData(final RasterLegendData rld,
519    }                          final URL documentUrl) throws Exception {
520                    // Create XML-Document
521    /**                  final FileWriter out = new FileWriter(new File(documentUrl.toURI()));
522     * Returns the style and raster meta data of a {@link StyledGridCoverageInterface}                  XML_OUTPUTTER.output(createRasterLegendDataElement(rld), out);
523     * as a {@link StyledMapStyle}.                  out.flush();
524     * @param styledGC a styled grid coverage                  out.close();
525     */          }
526    public static StyledMapStyle<RasterLegendData> getStyledMapStyle(StyledGridCoverageInterface styledGC) {  
527      return new StyledMapStyle<RasterLegendData>(          /**
528        styledGC.getStyle(),           * Parses a {@link Translation} object from an JDOM-{@link Element}. This
529        styledGC.getLegendMetaData()           * method works like {@link AMLImport#parseTranslation(org.w3c.dom.Node},
530      );           * but for JDOM.
531    }           *
532             * @param element
533    /**           *            {@link Element} to parse
534     * Returns the style and attribute meta data of a {@link StyledFeatureCollectionInterface}           */
535     * as a {@link StyledMapStyle}.          public final static Translation parseTranslation(final Element element) {
536     * @param styledFC a styled feature collection                  final Translation trans = new Translation();
537     */  
538    public static StyledMapStyle<Map<Integer,AttributeMetaData>> getStyledMapStyle(StyledFeatureCollectionInterface styledFC) {                  if (element == null)
539      return new StyledMapStyle<Map<Integer,AttributeMetaData>>(                          return trans;
540        styledFC.getStyle(),  
541        styledFC.getAttributeMetaDataMap()                  for (final Element translationElement : (List<Element>) element
542      );                                  .getChildren()) {
543    }                          final String name = translationElement.getName();
544                            if (name == null)
545    /**                                  continue;
546     * Loads a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData Raster-LegendData}  
547     * for a given geo-object (raster) source. The SLD file must be present. A missing                          // lang attribute
548     * raster legend-data file is tolerated.                          String lang = translationElement.getAttributeValue("lang");
549     * @param geoObjectURL URL of the (already read) raster object                          // set the default, if no language code is set
550     * @param sldExt file extention for the SLD file                          if (lang == null)
551     * @param rldExt file extention for the raster legend-data file                                  lang = Translation.DEFAULT_KEY;
552     * @return {@code null} in case of any error  
553     */                          final String translationText = translationElement.getValue();
554    public static StyledMapStyle<RasterLegendData> loadStyledRasterStyle(URL geoObjectURL, String sldExt, String rldExt) {                          if (translationText == null)
555      RasterLegendData metaData = null;                                  trans.put(lang, "");
556      Style sldStyle = null;                          else
557      try {                                  trans.put(lang, translationText);
558        Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(geoObjectURL, sldExt));                  }
559        // SLD must be present  
560        if ( styles == null || styles.length == 0 )                  // if no <translation> is given, the value of the node should
561          return null;                  // be used as a default translation
562        sldStyle = styles[0];                  if (trans.size() == 0)
563      }                          trans.put(Translation.DEFAULT_KEY, element.getValue());
564      catch (Exception err) {                  // trans = new Translation(
565        // SLD must be present                  // ((List<Element>)element.getChildren()).get(0).getValue() );
566        LangUtil.logDebugError(LOGGER,err);  
567        return null;                  return trans;
568      }          }
569    
570      try {          /**
571        metaData = StyledMapUtil.loadRasterLegendData( IOUtil.changeUrlExt(geoObjectURL,rldExt) );           * Creates an JDOM {@link Element} for the given {@link Translation}.
572      } catch (FileNotFoundException err) {           *
573        // ignore missing raster legend data           * @param tagname
574      } catch (Exception err) {           *            Name of the Element
575        // any other error during legend data creation leads to error           * @param translation
576        LangUtil.logDebugError(LOGGER,err);           *            Translation to store in the Element
577        return null;           */
578      }          public final static Element createTranslationElement(final String tagname,
579      return new StyledMapStyle<RasterLegendData>(sldStyle, metaData);                          final Translation translation) {
580    }                  final Element element = new Element(tagname, AMLURI);
581                    if (translation == null)
582    /**                          throw new UnsupportedOperationException(
583     * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and                                          "Translation element can not be created from null!");
584     * {@linkplain RasterLegendData Raster-LegendData} from a {@code .rld} file  
585     * for a given geo-object (raster) source. The SLD file must be present. A missing                  // If only a default translation is set, the <translation
586     * raster legend-data file is tolerated.                  // lang="..">..</tranlation>
587     * @param geoObjectURL URL of the (already read) raster object                  // part is not used
588     * @param sldExt file extention for the SLD file                  if (translation.keySet().size() == 1
589     * @param rldExt file extention for the raster legend-data file                                  && translation.get(Translation.DEFAULT_KEY) != null) {
590     * @return {@code null} in case of any error                          element.addContent(translation.get(Translation.DEFAULT_KEY));
591     */                          return element;
592    public static StyledMapStyle<RasterLegendData> loadStyledRasterStyle(URL geoObjectURL) {                  }
593      return loadStyledRasterStyle(geoObjectURL, "sld", "rld");  
594    }                  // add a <translation lang="..">..</tranlation> part to the element for
595                    // all languages
596    /**                  for (final String lang : translation.keySet()) {
597     * Loads a {@linkplain Style SLD-Style} and a {@linkplain AttributeMetaData AttributeMetaData-Map}                          final Element translationElement = new Element(
598     * for a given geo-object (feature) source. The SLD file must be present. A missing                                          ELEM_NAME_TRANSLATION, AMLURI);
599     * attribute meta-data file is tolerated.                          translationElement.setAttribute("lang", lang);
600     * @param geoObjectURL URL of the (already read) feature object                          String translationString = translation.get(lang);
601     * @param sldExt file extention for the SLD file                          if (translationString == null)
602     * @param rldExt file extention for the raster legend-data file                                  translationString = "";
603     * @return {@code null} in case of any error                          translationElement.addContent(translationString);
604     */                          element.addContent(translationElement);
605    public static StyledMapStyle<Map<Integer,AttributeMetaData>> loadStyledFeatureStyle(URL geoObjectURL, String sldExt, String rldExt) {                  }
606      Map<Integer,AttributeMetaData> metaData = null;  
607      Style                          sldStyle = null;                  return element;
608      try {          }
609        Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(geoObjectURL, sldExt));  
610        // SLD must be present          /**
611        if ( styles == null || styles.length == 0 )           * Sets a style to {@link StyledLayerInterface}.
612          return null;           *
613        sldStyle = styles[0];           * @param styledObject
614      } catch (Exception err) {           *            a styled object
615        // SLD must be present           * @param style
616        LangUtil.logDebugError(LOGGER,err);           *            a Style
617        return null;           */
618      }          public static void setStyledLayerStyle(
619                            final StyledLayerInterface styledObject,
620      try {                          final StyledLayerStyle<?> style) {
621        metaData = StyledMapUtil.loadAttributeMetaDataMap( IOUtil.changeUrlExt(geoObjectURL,rldExt) );                  // set SLD style
622      } catch (FileNotFoundException err) {                  styledObject.setStyle(style.getGeoObjectStyle());
623        // ignore missing attribute meta data                  // set meta data
624      } catch (Exception err) {                  if (styledObject instanceof StyledGridCoverageInterface
625        // any other error during meta data creation leads to error                                  && (style.getMetaData() instanceof RasterLegendData || style
626        LangUtil.logDebugError(LOGGER,err);                                                  .getMetaData() == null)) {
627        return null;                          final RasterLegendData sourceRld = (RasterLegendData) style
628      }                                          .getMetaData();
629                            final RasterLegendData destRld = ((StyledGridCoverageInterface) styledObject)
630      return new StyledMapStyle<Map<Integer,AttributeMetaData>>(sldStyle, metaData);                                          .getLegendMetaData();
631    }                          if (destRld != null && sourceRld != null) {
632                                    destRld.setPaintGaps(sourceRld.isPaintGaps());
633    /**                                  destRld.clear();
634     * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and                                  destRld.putAll(sourceRld);
635     * {@linkplain AttributeMetaData AttributeMetaData-Map} from a {@code .amd} file                          }
636     * for a given geo-object (feature) source. The SLD file must be present. A missing                          return;
637     * attribute meta-data file is tolerated.                  }
638     * @param geoObjectURL URL of the (already read) feature object                  if (styledObject instanceof StyledFeatureCollectionInterface
639     * @param sldExt file extention for the SLD file                                  && (style.getMetaData() instanceof Map || style.getMetaData() == null)) {
640     * @param rldExt file extention for the raster legend-data file                          final AttributeMetadataMap sourceAmd = (AttributeMetadataMap) style
641     * @return {@code null} in case of any error                                          .getMetaData();
642     */                          final AttributeMetadataMap destAmd = ((StyledFeatureCollectionInterface) styledObject)
643    public static StyledMapStyle<Map<Integer,AttributeMetaData>> loadStyledFeatureStyle(URL geoObjectURL) {                                          .getAttributeMetaDataMap();
644      return loadStyledFeatureStyle(geoObjectURL, "sld", "amd");                          if (destAmd != null && sourceAmd != null) {
645    }                                  destAmd.clear();
646                                    destAmd.putAll(sourceAmd);
647    /**                          }
648     * Stores a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData Raster-LegendData}                          return;
649     * for a given geo-object (raster) source.                  }
650     * @param style  style to save  
651     * @param geoObjectURL URL of the raster object                  throw new UnsupportedOperationException(
652     * @param sldExt file extention for the SLD file                                  "Style is not compatible to object: "
653     * @param mdExt file extention for the meta-data file                                                  + (style.getMetaData() == null ? null : style
654     */                                                                  .getMetaData().getClass().getSimpleName())
655    public static <T> void saveStyledMapStyle(StyledMapStyle<T> style, URL geoObjectURL, String sldExt, String mdExt) throws Exception {                                                  + " <-> "
656      // Store the SLD                                                  + (styledObject == null ? null : styledObject
657      Style sldStyle = style.getGeoObjectStyle();                                                                  .getClass().getSimpleName()));
658      if ( sldStyle != null ) {          }
659        StylingUtil.saveStyleToSLD(  
660           sldStyle,          /**
661           IOUtil.changeFileExt(           * Returns the style a {@link StyledLayerInterface} as a
662                new File(geoObjectURL.toURI()),           * {@link StyledLayerStyle}.
663                sldExt           *
664           )           * @param styledObject
665        );           *            a styled object
666      }           * @return {@code StyledLayerStyle<RasterLegendData>} for
667             *         {@link StyledGridCoverageInterface} or {@code
668      // Store the meta data           *         StyledLayerStyle<Map<Integer,AttributeMetaData>>} for
669      T metaData = style.getMetaData();           *         {@link StyledFeatureCollectionInterface}
670      if ( metaData != null ) {           */
671        if ( metaData instanceof RasterLegendData ) {          public static StyledLayerStyle<?> getStyledLayerStyle(
672          saveRasterLegendData(                          final StyledLayerInterface styledObject) {
673              (RasterLegendData)metaData,                  if (styledObject instanceof StyledGridCoverageInterface)
674              IOUtil.changeUrlExt(geoObjectURL,mdExt)                          return getStyledLayerStyle((StyledGridCoverageInterface) styledObject);
675          );                  if (styledObject instanceof StyledFeatureCollectionInterface)
676  //      } else if ( metaData instanceof Map<Integer,AttributeMetaData> ) { // LEIDER NICHT KOMPILIERBAR!!                          return getStyledLayerStyle((StyledFeatureCollectionInterface) styledObject);
677        } else if ( metaData instanceof Map ) {                  throw new UnsupportedOperationException(
678          saveAttributeMetaDataMap(                                  "Unknown type of StyledLayerInterface: "
679              (Map<Integer,AttributeMetaData>)metaData,                                                  + (styledObject == null ? null : styledObject
680              IOUtil.changeUrlExt(geoObjectURL,mdExt)                                                                  .getClass().getSimpleName()));
681          );          }
682        } else  
683          throw new UnsupportedOperationException("Export for meta data not yet supported: "+metaData.getClass().getSimpleName());          /**
684      }           * Returns the style and raster meta data of a
685    }           * {@link StyledGridCoverageInterface} as a {@link StyledLayerStyle}.
686             *
687    /**           * @param styledGC
688     * Stores the {@linkplain Style SLD-Style} to a {@code .sld} file and           *            a styled grid coverage
689     * the meta data ({@link RasterLegendData} or {@link AttributeMetaData})           */
690     * to a {@code .rld} or {@code .amd} file.          public static StyledLayerStyle<RasterLegendData> getStyledLayerStyle(
691     * for a given geo-object source.                          final StyledGridCoverageInterface styledGC) {
692     * @param style  style to save                  return new StyledLayerStyle<RasterLegendData>(styledGC.getStyle(),
693     * @param geoObjectURL URL of the (already read) raster object                                  styledGC.getLegendMetaData());
694     */          }
695    public static void saveStyledMapStyle(StyledMapStyle<?> style, URL geoObjectURL) throws Exception {  
696      if ( style.getMetaData() instanceof RasterLegendData )          /**
697        saveStyledMapStyle(style,geoObjectURL, "sld", "rld");           * Returns the style and attribute meta data of a
698      else           * {@link StyledFeatureCollectionInterface} as a {@link StyledLayerStyle}.
699        saveStyledMapStyle(style,geoObjectURL, "sld", "amd");           *
700    }           * @param styledFC
701             *            a styled feature collection
702  }           */
703            public static StyledLayerStyle<AttributeMetadataMap> getStyledLayerStyle(
704                            final StyledFeatureCollectionInterface styledFC) {
705                    return new StyledLayerStyle<AttributeMetadataMap>(styledFC.getStyle(),
706                                    styledFC.getAttributeMetaDataMap());
707            }
708    
709            /**
710             * Loads a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData
711             * Raster-LegendData} for a given geo-object (raster) source. The SLD file
712             * must be present. A missing raster legend-data file is tolerated.
713             *
714             * @param geoObjectURL
715             *            URL of the (already read) raster object
716             * @param sldExt
717             *            file extention for the SLD file
718             * @param rldExt
719             *            file extention for the raster legend-data file
720             * @return {@code null} in case of any error
721             */
722            public static StyledLayerStyle<RasterLegendData> loadStyledRasterStyle(
723                            final URL geoObjectURL, final String sldExt, final String rldExt) {
724                    RasterLegendData metaData = null;
725                    Style sldStyle = null;
726                    try {
727                            final Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(
728                                            geoObjectURL, sldExt));
729                            // SLD must be present
730                            if (styles == null || styles.length == 0)
731                                    return null;
732                            sldStyle = styles[0];
733                    } catch (final Exception err) {
734                            // SLD must be present
735                            LangUtil.logDebugError(LOGGER, err);
736                            return null;
737                    }
738    
739                    try {
740                            metaData = StyledLayerUtil.loadRasterLegendData(IOUtil
741                                            .changeUrlExt(geoObjectURL, rldExt));
742                    } catch (final FileNotFoundException err) {
743                            // ignore missing raster legend data
744                    } catch (final Exception err) {
745                            // any other error during legend data creation leads to error
746                            LangUtil.logDebugError(LOGGER, err);
747                            return null;
748                    }
749                    return new StyledLayerStyle<RasterLegendData>(sldStyle, metaData);
750            }
751    
752            /**
753             * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and
754             * {@linkplain RasterLegendData Raster-LegendData} from a {@code .rld} file
755             * for a given geo-object (raster) source. The SLD file must be present. A
756             * missing raster legend-data file is tolerated.
757             *
758             * @param geoObjectURL
759             *            URL of the (already read) raster object
760             * @param sldExt
761             *            file extention for the SLD file
762             * @param rldExt
763             *            file extention for the raster legend-data file
764             * @return {@code null} in case of any error
765             */
766            public static StyledLayerStyle<RasterLegendData> loadStyledRasterStyle(
767                            final URL geoObjectURL) {
768                    return loadStyledRasterStyle(geoObjectURL, "sld", "rld");
769            }
770    
771            /**
772             * Loads a {@linkplain Style SLD-Style} and a {@linkplain AttributeMetadata
773             * AttributeMetaData-Map} for a given geo-object (feature) source. The SLD
774             * file must be present. A missing attribute meta-data file is tolerated.
775             *
776             * @param geoObjectURL
777             *            URL of the (already read) feature object
778             * @param sldExt
779             *            file extention for the SLD file
780             * @param rldExt
781             *            file extention for the raster legend-data file
782             * @return {@code null} in case of any error
783             */
784            public static StyledLayerStyle<AttributeMetadataMap> loadStyledFeatureStyle(
785                            final URL geoObjectURL, final String sldExt, final String rldExt) {
786                    AttributeMetadataMap metaData = null;
787                    Style sldStyle = null;
788                    try {
789                            final Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(
790                                            geoObjectURL, sldExt));
791                            // SLD must be present
792                            if (styles == null || styles.length == 0)
793                                    return null;
794                            sldStyle = styles[0];
795                    } catch (final Exception err) {
796                            // SLD must be present
797                            LangUtil.logDebugError(LOGGER, err);
798                            return null;
799                    }
800    
801                    try {
802                            metaData = StyledLayerUtil.loadAttributeMetaDataMap(IOUtil
803                                            .changeUrlExt(geoObjectURL, rldExt));
804                    } catch (final FileNotFoundException err) {
805                            // ignore missing attribute meta data
806                    } catch (final Exception err) {
807                            // any other error during meta data creation leads to error
808                            LangUtil.logDebugError(LOGGER, err);
809                            return null;
810                    }
811    
812                    return new StyledLayerStyle<AttributeMetadataMap>(sldStyle, metaData);
813            }
814    
815            /**
816             * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and
817             * {@linkplain AttributeMetadata AttributeMetaData-Map} from a {@code .amd}
818             * file for a given geo-object (feature) source. The SLD file must be
819             * present. A missing attribute meta-data file is tolerated.
820             *
821             * @param geoObjectURL
822             *            URL of the (already read) feature object
823             * @param sldExt
824             *            file extention for the SLD file
825             * @param rldExt
826             *            file extention for the raster legend-data file
827             * @return {@code null} in case of any error
828             */
829            public static StyledLayerStyle<AttributeMetadataMap> loadStyledFeatureStyle(
830                            final URL geoObjectURL) {
831                    return loadStyledFeatureStyle(geoObjectURL, "sld", "amd");
832            }
833    
834            /**
835             * Stores a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData
836             * Raster-LegendData} for a given geo-object (raster) source.
837             *
838             * @param style
839             *            style to save
840             * @param geoObjectURL
841             *            URL of the raster object
842             * @param sldExt
843             *            file extention for the SLD file
844             * @param mdExt
845             *            file extention for the meta-data file
846             */
847            public static <T> void saveStyledLayerStyle(
848                            final StyledLayerStyle<T> style, final URL geoObjectURL,
849                            final String sldExt, final String mdExt) throws Exception {
850                    // Store the SLD
851                    final Style sldStyle = style.getGeoObjectStyle();
852                    if (sldStyle != null) {
853                            StylingUtil.saveStyleToSLD(sldStyle, IOUtil.changeFileExt(new File(
854                                            geoObjectURL.toURI()), sldExt));
855                    }
856    
857                    // Store the meta data
858                    final T metaData = style.getMetaData();
859                    if (metaData != null) {
860                            if (metaData instanceof RasterLegendData) {
861                                    saveRasterLegendData((RasterLegendData) metaData, IOUtil
862                                                    .changeUrlExt(geoObjectURL, mdExt));
863                                    // } else if ( metaData instanceof
864                                    // Map<Integer,AttributeMetaData> ) { // LEIDER NICHT
865                                    // KOMPILIERBAR!!
866                            } else if (metaData instanceof Map) {
867                                    saveAttributeMetaDataMap((AttributeMetadataMap) metaData,
868                                                    IOUtil.changeUrlExt(geoObjectURL, mdExt));
869                            } else
870                                    throw new UnsupportedOperationException(
871                                                    "Export for meta data not yet supported: "
872                                                                    + metaData.getClass().getSimpleName());
873                    }
874            }
875    
876            /**
877             * Stores the {@linkplain Style SLD-Style} to a {@code .sld} file and the
878             * meta data ({@link RasterLegendData} or {@link AttributeMetadata}) to a
879             * {@code .rld} or {@code .amd} file. for a given geo-object source.
880             *
881             * @param style
882             *            style to save
883             * @param geoObjectURL
884             *            URL of the (already read) raster object
885             */
886            public static void saveStyledLayerStyle(final StyledLayerStyle<?> style,
887                            final URL geoObjectURL) throws Exception {
888                    if (style.getMetaData() instanceof RasterLegendData)
889                            saveStyledLayerStyle(style, geoObjectURL, "sld", "rld");
890                    else
891                            saveStyledLayerStyle(style, geoObjectURL, "sld", "amd");
892            }
893    
894            /**
895             * Creates a {@link JPanel} that shows a legend for a list of
896             * {@link FeatureTypeStyle}s and a targeted featureType
897             *
898             * @param featureType
899             *            If this a legend for Point, Polygon or Line?
900             * @param list
901             *            The Styles to presented in this legend
902             *
903             * @author <a href="mailto:[email protected]">Stefan Alfons
904             *         Kr&uuml;ger</a>
905             */
906            public static JPanel createLegendPanel(Style style,
907                            final SimpleFeatureType featureType, final int iconWidth,
908                            final int iconHeight) {
909    
910                    final List<FeatureTypeStyle> list = style.featureTypeStyles();
911    
912                    final JPanel panel = new JPanel(new MigLayout("wrap 2","[]:3:[]"));
913    
914                    if (style == null) {
915                            // No Style => no legend
916                            return panel;
917                    }
918    
919                    for (final FeatureTypeStyle ftStyle : list) {
920    
921                            // One child-node for every rule
922                            final List<Rule> rules = ftStyle.rules();
923                            for (final Rule rule : rules) {
924    
925                                    /**
926                                     * Let's not create a hbox for Rules that only contain
927                                     * TextSymbolizers
928                                     */
929                                    if (StylingUtil.getTextSymbolizers(rule.getSymbolizers())
930                                                    .size() == rule.getSymbolizers().length)
931                                            continue;
932    
933                                    final BufferedImage imageForRule = LegendIconFeatureRenderer
934                                                    .getInstance().createImageForRule(rule, featureType,
935                                                                    new Dimension(iconWidth, iconHeight));
936    
937                                    final ImageIcon legendIcon = new ImageIcon(imageForRule);
938    
939                                    final JLabel iconLabel = new JLabel(legendIcon);
940                                    panel.add(iconLabel,"sgx1");
941    //                              hbox.setAlignmentX(0f);
942    //                              hbox.add(iconLabel);
943    //                              hbox.add(Box.createHorizontalStrut(3));
944    
945                                    final Translation labelT = new Translation();
946                                    labelT.fromOneLine(rule.getDescription().getTitle());
947                                    final JLabel classTitleLabel = new JLabel(labelT.toString());
948                                    
949                                    panel.add(classTitleLabel,"sgx2");
950                                    classTitleLabel.setLabelFor(iconLabel);
951                            }
952                    }
953    
954                    return panel;
955            }
956    
957            /**
958             * Creates a {@link JComponent} that contains a legend for a given
959             * rasterLayer and a given {@link Style}.
960             *
961             * @param style
962             *            if <code>null</code>, the default {@link Style} is extracetd
963             *            from the {@link StyledRasterInterface}
964             */
965            public static JPanel createLegendPanel(
966                            final StyledRasterInterface<?> styledRaster, Style style,
967                            final int iconWidth, final int iconHeight) {
968    
969                    // If no style is given, we use the default style for this layer
970                    if (style == null)
971                            style = styledRaster.getStyle();
972    
973                    /**
974                     * Determine whether a Style is responsible for the coloring
975                     */
976                    ColorModel colorModel = null;
977                    if (!isStyleable(styledRaster)
978                                    || (isStyleable(styledRaster) && style == null)) {
979                            colorModel = getColorModel(styledRaster);
980                    }
981    
982                    final RasterLegendData rasterLegendData = styledRaster
983                                    .getLegendMetaData();
984                    final List<Double> legendRasterValues = rasterLegendData
985                                    .getSortedKeys();
986                    final Map<Double, GridCoverage2D> sampleRasters = rasterLegendData
987                                    .createSampleRasters();
988    
989                    final JPanel panel = new JPanel(new MigLayout("wrap 2"));
990    
991                    for (final Double rValue : legendRasterValues) {
992    
993                            // final Dimension ICON_SIZE = new Dimension(iconWidth,
994                            // new JLabel().getFontMetrics(new JLabel().getFont())
995                            // .getHeight() > 5 ? new JLabel().getFontMetrics(
996                            // new JLabel().getFont()).getHeight() : iconHeight);
997    
998                            // ****************************************************************************
999                            // Create the actual icon
1000                            // ****************************************************************************
1001                            final BufferedImage buffImage = new BufferedImage(iconWidth,
1002                                            iconHeight, BufferedImage.TYPE_INT_ARGB);
1003                            
1004                            final Graphics2D graphics = buffImage.createGraphics();
1005    
1006                            if (colorModel != null) {
1007                                    // The colors come from the ColorModel!
1008                                    
1009                                    try {
1010                                            Object inData = null;
1011                                            switch (colorModel.getTransferType()) {
1012                                            case DataBuffer.TYPE_BYTE:
1013                                                    inData = new byte[] { rValue.byteValue() };
1014                                                    break;
1015                                            case DataBuffer.TYPE_USHORT:
1016                                                    inData = new short[] { rValue.shortValue() };
1017                                                    break;
1018                                            case DataBuffer.TYPE_INT:
1019                                                    inData = new int[] { rValue.intValue() };
1020                                                    break;
1021                                            case DataBuffer.TYPE_SHORT:
1022                                                    inData = new short[] { rValue.shortValue() };
1023                                                    break;
1024                                            case DataBuffer.TYPE_FLOAT:
1025                                                    inData = new float[] { rValue.floatValue() };
1026                                                    break;
1027                                            case DataBuffer.TYPE_DOUBLE:
1028                                                    inData = new double[] { rValue.doubleValue() };
1029                                                    break;
1030                                            default:
1031                                                    inData = rValue.intValue();
1032                                            }
1033                                            final Color color = new Color(colorModel.getRGB(inData));
1034                                            graphics.setBackground(color);
1035                                            graphics.setColor(color);
1036                                            graphics.fillRect(0, 0, iconWidth, iconHeight);
1037                                    } catch (final Exception e) {
1038                                            LOGGER.info(
1039                                                            "Dann nehmen wir halt den GridCoverageRenderer", e);
1040                                            colorModel = null;
1041                                    }
1042                            } else {
1043                                    // The colors come from the Style
1044    
1045                                    /**
1046                                     * The coverage contains only one value of value rValue
1047                                     */
1048                                    final GridCoverage2D sampleCov = sampleRasters.get(rValue);
1049                                    GridCoverageRenderer renderer;
1050                                    try {
1051                                            renderer = new GridCoverageRenderer(sampleCov
1052                                                            .getCoordinateReferenceSystem(), JTSUtil
1053                                                            .createEnvelope(sampleCov.getEnvelope()),
1054                                                            new Rectangle(iconWidth, iconHeight),
1055                                                            (AffineTransform) null);
1056                                    } catch (final Exception e1) {
1057                                            throw new RuntimeException(
1058                                                            "Creating a GridCoverageRenderer failed:", e1);
1059                                    }
1060    
1061                                    /**
1062                                     * Iterate over all FeatureTypeStyles.
1063                                     */
1064                                    final List<RasterSymbolizer> rSymbols = StylingUtil
1065                                                    .getRasterSymbolizers(style);
1066    
1067                                    for (final RasterSymbolizer symbolizer : rSymbols) {
1068                                            try {
1069                                                    renderer.paint(graphics, sampleCov, symbolizer);
1070                                            } catch (final Exception ee) {
1071                                                    LOGGER.error("Unable to paint " + symbolizer
1072                                                                    + " into the legend image", ee);
1073                                            }
1074                                    }
1075                            }
1076    
1077                            final JLabel iconLabel = new JLabel(new ImageIcon(buffImage));
1078    //                      hbox.setAlignmentX(0f);
1079                            panel.add(iconLabel,"sgx1");
1080    //                      hbox.add(Box.createHorizontalStrut(3));
1081    
1082                            final Translation labelT = rasterLegendData.get(rValue);
1083                            final JLabel classTitleLabel = new JLabel(labelT.toString());
1084                            panel.add(classTitleLabel,"sgx2" + (rasterLegendData.getPaintGaps()? ", gapy 0 3":""));
1085                            classTitleLabel.setLabelFor(iconLabel);
1086    
1087    //                      box.add(hbox);
1088    
1089                            if (rasterLegendData.getPaintGaps()) {
1090                                    iconLabel
1091                                                    .setBorder(BorderFactory.createLineBorder(Color.black));
1092                            }
1093    
1094                    }
1095    
1096                    return panel;
1097            }
1098    
1099            /**
1100             * Extracts the {@link ColorModel} of any {@link StyledRasterInterface}. May
1101             * return <code>null</code> if the geoobject can not be accessed.
1102             */
1103            @SuppressWarnings("unchecked")
1104            public static ColorModel getColorModel(
1105                            final StyledRasterInterface<?> styledGrid) {
1106                    ColorModel colorModel = null;
1107                    try {
1108                            final Object geoObject = styledGrid.getGeoObject();
1109                            if (geoObject instanceof GridCoverage2D) {
1110                                    final GridCoverage2D cov = (GridCoverage2D) geoObject;
1111                                    colorModel = cov.getRenderedImage().getColorModel();
1112                            } else if (styledGrid instanceof StyledRasterPyramidInterface) {
1113    
1114                                    final Parameter readGG = new Parameter(
1115                                                    AbstractGridFormat.READ_GRIDGEOMETRY2D);
1116    
1117                                    final ReferencedEnvelope mapExtend = new org.geotools.geometry.jts.ReferencedEnvelope(
1118                                                    styledGrid.getEnvelope(), styledGrid.getCrs());
1119    
1120                                    readGG.setValue(new GridGeometry2D(new GeneralGridEnvelope(
1121                                                    new Rectangle(0, 0, 1, 1)), mapExtend));
1122    
1123                                    final FeatureCollection<SimpleFeatureType, SimpleFeature> rFc = (FeatureCollection<SimpleFeatureType, SimpleFeature>) geoObject;
1124    
1125                                    final AbstractGridCoverage2DReader aReader = (AbstractGridCoverage2DReader) FeatureUtil
1126                                                    .getWrappedGeoObject(rFc);
1127                                    final GridCoverage2D cov = (GridCoverage2D) aReader
1128                                                    .read(new GeneralParameterValue[] { readGG });
1129                                    colorModel = cov.getRenderedImage().getColorModel();
1130                            }
1131                    } catch (final Exception e) {
1132                            LOGGER.error("Error reading the colormodel from " + styledGrid, e);
1133                            return null;
1134                    }
1135                    return colorModel;
1136            }
1137    
1138            /**
1139             * @return <code>true</code> if a {@link RasterSymbolizer} can be applied
1140             *         and will have an effect. Some rasters (e.g. GeoTIFF) can come
1141             *         with their own {@link ColorModel} and will ignore any
1142             *         {@link RasterSymbolizer} = SLD.
1143             */
1144            public static boolean isStyleable(
1145                            final StyledRasterInterface<?> styledRaster) {
1146                    final ColorModel colorModel = getColorModel(styledRaster);
1147    
1148                    LOGGER.info("The colormodel of " + styledRaster.getTitle() + " is "
1149                                    + colorModel.getClass().getSimpleName());
1150    
1151                    if (colorModel == null)
1152                            return true;
1153                    if (colorModel instanceof ComponentColorModel)
1154                            return true;
1155                    return false;
1156            }
1157    }

Legend:
Removed from v.52  
changed lines
  Added in v.516

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26