001    //$HeadURL: svn+ssh://jwilden@svn.wald.intevation.org/deegree/base/branches/2.5_testing/src/org/deegree/ogcwebservices/wpvs/j3d/TerrainModel.java $
002    /*----------------------------------------------------------------------------
003     This file is part of deegree, http://deegree.org/
004     Copyright (C) 2001-2009 by:
005     Department of Geography, University of Bonn
006     and
007     lat/lon GmbH
008    
009     This library is free software; you can redistribute it and/or modify it under
010     the terms of the GNU Lesser General Public License as published by the Free
011     Software Foundation; either version 2.1 of the License, or (at your option)
012     any later version.
013     This library is distributed in the hope that it will be useful, but WITHOUT
014     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
015     FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
016     details.
017     You should have received a copy of the GNU Lesser General Public License
018     along with this library; if not, write to the Free Software Foundation, Inc.,
019     59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
020    
021     Contact information:
022    
023     lat/lon GmbH
024     Aennchenstr. 19, 53177 Bonn
025     Germany
026     http://lat-lon.de/
027    
028     Department of Geography, University of Bonn
029     Prof. Dr. Klaus Greve
030     Postfach 1147, 53001 Bonn
031     Germany
032     http://www.geographie.uni-bonn.de/deegree/
033    
034     e-mail: info@deegree.org
035     ----------------------------------------------------------------------------*/
036    
037    package org.deegree.ogcwebservices.wpvs.j3d;
038    
039    import java.awt.image.BufferedImage;
040    
041    import javax.media.j3d.Appearance;
042    import javax.media.j3d.Material;
043    import javax.media.j3d.RenderingAttributes;
044    import javax.media.j3d.Shape3D;
045    import javax.vecmath.Color3f;
046    
047    import org.deegree.ogcwebservices.wpvs.configuration.RenderingConfiguration;
048    
049    /**
050     * The <code>TerrainModel</code> class is a base class for all dgm's (terrains). It is capable of loading a texture onto
051     * the geometry of it's subclasses.
052     * 
053     * @author <a href="mailto:bezema@lat-lon.de">Rutger Bezema</a>
054     * 
055     * @author last edited by: $Author: rbezema $
056     * 
057     * @version $Revision: 20601 $, $Date: 2009-11-05 16:25:55 +0100 (Do, 05 Nov 2009) $
058     * 
059     */
060    
061    public abstract class TerrainModel extends Shape3D {
062    
063        private BufferedImage textureImage = null;
064    
065        /**
066         * Creates a TerrainModel with a default Appearance set.
067         * <p>
068         * The default apearance of this terrain is defined as:
069         * <ul>
070         * <li>specularColor = new Color3f( 0.7f, 0.7f, 0.7f )</li>
071         * <li>ambientColor = white</li>
072         * <li>diffuseColor = white</li>
073         * <li>shininess = 75f</li>
074         * <li>lighting is enabled</li>
075         * <li>matieral is writable (Material.ALLOW_COMPONENT_WRITE)</li>
076         * </ul>
077         * </p>
078         */
079        protected TerrainModel() {
080            setCapability( Shape3D.ALLOW_GEOMETRY_WRITE );
081            setAppearance( createDefaultApperance() );
082        }
083    
084        /**
085         * Create a terrain from the given buffered image
086         * 
087         * @param textureImage
088         */
089        protected TerrainModel( BufferedImage textureImage ) {
090            this();
091            this.textureImage = textureImage;
092        }
093    
094        /**
095         * This method implements all the necessary steps to generate a Shape3D Terrain (Elevation model). Before rendering
096         * this Class this method should therefor be called prior.
097         */
098        public abstract void createTerrain();
099    
100        /**
101         * Creates a J3D Appearance for the surface
102         * 
103         * @return a new Appearance object
104         */
105        private Appearance createDefaultApperance() {
106            Appearance appearance = new Appearance();
107    
108            // create a material
109            Color3f specular = new Color3f( 0.2f, 0.2f, 0.2f );
110            Color3f white = new Color3f( 1, 1, 1 );
111            Material targetMaterial = new Material();
112            targetMaterial.setAmbientColor( white );
113            targetMaterial.setDiffuseColor( white );
114    
115            targetMaterial.setSpecularColor( specular );
116            targetMaterial.setShininess( 65f );
117            targetMaterial.setCapability( Material.ALLOW_COMPONENT_WRITE );
118            targetMaterial.setCapability( Material.ALLOW_COMPONENT_READ );
119            RenderingConfiguration rc = RenderingConfiguration.getInstance();
120            targetMaterial.setLightingEnable( rc.isTerrainShadingEnabled() );
121    
122            // targetMaterial.setColorTarget( Material.AMBIENT_AND_DIFFUSE );
123            appearance.setMaterial( targetMaterial );
124    
125            appearance.setColoringAttributes( rc.getColoringAttributes() );
126    
127            appearance.setPolygonAttributes( rc.getTerrainPolygonAttributes() );
128    
129            RenderingAttributes ra = new RenderingAttributes();
130            ra.setDepthBufferEnable( true );
131            appearance.setRenderingAttributes( ra );
132    
133            return appearance;
134        }
135    
136        /**
137         * @param textureImage
138         *            An other texture value.
139         */
140        public void setTexture( BufferedImage textureImage ) {
141            if ( textureImage != null ) {
142                this.textureImage = textureImage;
143                Appearance appearance = getAppearance();
144                RenderingConfiguration rc = RenderingConfiguration.getInstance();
145    
146                appearance.setTextureAttributes( rc.getTextureAttributes() );
147                appearance.setTexture( rc.getTexture( textureImage ) );
148    
149                setAppearance( appearance );
150            }
151    
152        }
153    
154        /**
155         * @return the BufferedImage which can be used as a texture or <code>null</code>if no texture was defined.
156         */
157        public BufferedImage getTexture() {
158            return this.textureImage;
159        }
160    
161        @Override
162        public String toString() {
163            StringBuilder sb = new StringBuilder( 512 );
164            sb.append( "Elevationmodel as a J3D terrainModel: " );
165            if ( textureImage != null ) {
166                sb.append( " with textureImage and " );
167            }
168            sb.append( "Appearance: " ).append( getAppearance() ).append( "\n" );
169            return sb.toString();
170        }
171    
172    }