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

Legend:
Removed from v.127  
changed lines
  Added in v.403

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26