159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/* 259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Copyright (c) 2009-2010 jMonkeyEngine 359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * All rights reserved. 459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Redistribution and use in source and binary forms, with or without 659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * modification, are permitted provided that the following conditions are 759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * met: 859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions of source code must retain the above copyright 1059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer. 1159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions in binary form must reproduce the above copyright 1359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer in the 1459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * documentation and/or other materials provided with the distribution. 1559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Neither the name of 'jMonkeyEngine' nor the names of its contributors 1759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * may be used to endorse or promote products derived from this software 1859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * without specific prior written permission. 1959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 2059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 2259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 2359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 2459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 2559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 2759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 2859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 2959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 3059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 3259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3359b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapackage com.jme3.material; 3459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3559b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.export.*; 3659b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.renderer.Caps; 3759b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.renderer.Renderer; 3859b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.shader.DefineList; 3959b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.shader.UniformBinding; 4059b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.shader.VarType; 4159b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.io.IOException; 4259b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.util.ArrayList; 4359b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.util.EnumSet; 4459b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.util.HashMap; 4559b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.util.List; 4659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 4759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/** 4859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Describes a technique definition. 4959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 5059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Kirill Vainer 5159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 5259b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapublic class TechniqueDef implements Savable { 5359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 5559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Describes light rendering mode. 5659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 5759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public enum LightMode { 5859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 5959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Disable light-based rendering 6059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Disable, 6259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 6359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 6459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Enable light rendering by using a single pass. 6559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <p> 6659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * An array of light positions and light colors is passed to the shader 6759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * containing the world light list for the geometry being rendered. 6859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta SinglePass, 7059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Enable light rendering by using multi-pass rendering. 7359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <p> 7459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * The geometry will be rendered once for each light. Each time the 7559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * light position and light color uniforms are updated to contain 7659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the values for the current light. The ambient light color uniform 7759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * is only set to the ambient light color on the first pass, future 7859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * passes have it set to black. 7959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 8059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta MultiPass, 8159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 8259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 8359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Enable light rendering by using the 8459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * {@link Renderer#setLighting(com.jme3.light.LightList) renderer's setLighting} 8559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * method. 8659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <p> 8759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * The specific details of rendering the lighting is up to the 8859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * renderer implementation. 8959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 9059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta FixedPipeline, 9159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public enum ShadowMode { 9459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Disable, 9559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta InPass, 9659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta PostPass, 9759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private EnumSet<Caps> requiredCaps = EnumSet.noneOf(Caps.class); 10059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private String name; 10159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 10259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private String vertName; 10359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private String fragName; 10459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private String shaderLang; 10559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private DefineList presetDefines; 10659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private boolean usesShaders; 10759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 10859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private RenderState renderState; 10959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private LightMode lightMode = LightMode.Disable; 11059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private ShadowMode shadowMode = ShadowMode.Disable; 11159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 11259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private HashMap<String, String> defineParams; 11359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private ArrayList<UniformBinding> worldBinds; 11459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 11559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 11659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Creates a new technique definition. 11759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <p> 11859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Used internally by the J3M/J3MD loader. 11959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 12059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param name The name of the technique, should be set to <code>null</code> 12159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * for default techniques. 12259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 12359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public TechniqueDef(String name){ 12459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.name = name == null ? "Default" : name; 12559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 12759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 12859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Serialization only. Do not use. 12959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public TechniqueDef(){ 13159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 13259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 13359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 13459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the name of this technique as specified in the J3MD file. 13559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Default techniques have the name "Default". 13659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 13759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the name of this technique 13859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String getName(){ 14059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return name; 14159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 14259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 14359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 14459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the light mode. 14559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the light mode. 14659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see LightMode 14759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 14859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public LightMode getLightMode() { 14959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return lightMode; 15059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 15159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 15259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 15359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Set the light mode 15459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 15559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param lightMode the light mode 15659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 15759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see LightMode 15859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 15959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setLightMode(LightMode lightMode) { 16059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.lightMode = lightMode; 16159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 16259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 16359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 16459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the shadow mode. 16559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the shadow mode. 16659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 16759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public ShadowMode getShadowMode() { 16859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return shadowMode; 16959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 17059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 17159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 17259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Set the shadow mode. 17359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 17459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param shadowMode the shadow mode. 17559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 17659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see ShadowMode 17759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 17859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setShadowMode(ShadowMode shadowMode) { 17959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.shadowMode = shadowMode; 18059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 18159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 18259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 18359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the render state that this technique is using 18459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the render state that this technique is using 18559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see #setRenderState(com.jme3.material.RenderState) 18659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 18759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public RenderState getRenderState() { 18859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return renderState; 18959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 19059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 19159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 19259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets the render state that this technique is using. 19359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 19459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param renderState the render state that this technique is using. 19559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 19659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see RenderState 19759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 19859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setRenderState(RenderState renderState) { 19959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.renderState = renderState; 20059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 20159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 20259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 20359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns true if this technique uses shaders, false otherwise. 20459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 20559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return true if this technique uses shaders, false otherwise. 20659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 20759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see #setShaderFile(java.lang.String, java.lang.String, java.lang.String) 20859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 20959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public boolean isUsingShaders(){ 21059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return usesShaders; 21159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 21259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 21359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 21459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Gets the {@link Caps renderer capabilities} that are required 21559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * by this technique. 21659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 21759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the required renderer capabilities 21859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 21959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public EnumSet<Caps> getRequiredCaps() { 22059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return requiredCaps; 22159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 22259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 22359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 22459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets the shaders that this technique definition will use. 22559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 22659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vertexShader The name of the vertex shader 22759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param fragmentShader The name of the fragment shader 22859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param shaderLanguage The shader language 22959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 23059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setShaderFile(String vertexShader, String fragmentShader, String shaderLanguage){ 23159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.vertName = vertexShader; 23259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.fragName = fragmentShader; 23359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.shaderLang = shaderLanguage; 23459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 23559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Caps langCap = Caps.valueOf(shaderLanguage); 23659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta requiredCaps.add(langCap); 23759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 23859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta usesShaders = true; 23959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 24059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 24159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 24259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the define name which the given material parameter influences. 24359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 24459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param paramName The parameter name to look up 24559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return The define name 24659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 24759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see #addShaderParamDefine(java.lang.String, java.lang.String) 24859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 24959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String getShaderParamDefine(String paramName){ 25059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (defineParams == null) 25159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 25259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 25359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return defineParams.get(paramName); 25459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 25559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 25659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 25759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Adds a define linked to a material parameter. 25859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <p> 25959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Any time the material parameter on the parent material is altered, 26059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the appropriate define on the technique will be modified as well. 26159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * See the method 26259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * {@link DefineList#set(java.lang.String, com.jme3.shader.VarType, java.lang.Object) } 26359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * on the exact details of how the material parameter changes the define. 26459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 26559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param paramName The name of the material parameter to link to. 26659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param defineName The name of the define parameter, e.g. USE_LIGHTING 26759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 26859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void addShaderParamDefine(String paramName, String defineName){ 26959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (defineParams == null) 27059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta defineParams = new HashMap<String, String>(); 27159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 27259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta defineParams.put(paramName, defineName); 27359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 27459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 27559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 27659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the {@link DefineList} for the preset defines. 27759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 27859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the {@link DefineList} for the preset defines. 27959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 28059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @see #addShaderPresetDefine(java.lang.String, com.jme3.shader.VarType, java.lang.Object) 28159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 28259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public DefineList getShaderPresetDefines() { 28359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return presetDefines; 28459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 28559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 28659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 28759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Adds a preset define. 28859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <p> 28959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Preset defines do not depend upon any parameters to be activated, 29059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * they are always passed to the shader as long as this technique is used. 29159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 29259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param defineName The name of the define parameter, e.g. USE_LIGHTING 29359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param type The type of the define. See 29459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * {@link DefineList#set(java.lang.String, com.jme3.shader.VarType, java.lang.Object) } 29559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * to see why it matters. 29659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 29759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param value The value of the define 29859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 29959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void addShaderPresetDefine(String defineName, VarType type, Object value){ 30059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (presetDefines == null) 30159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta presetDefines = new DefineList(); 30259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 30359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta presetDefines.set(defineName, type, value); 30459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 30559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 30659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 30759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the name of the fragment shader used by the technique, or null 30859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * if no fragment shader is specified. 30959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 31059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the name of the fragment shader to be used. 31159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 31259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String getFragmentShaderName() { 31359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return fragName; 31459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 31559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 31659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 31759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 31859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the name of the vertex shader used by the technique, or null 31959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * if no vertex shader is specified. 32059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 32159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the name of the vertex shader to be used. 32259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 32359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String getVertexShaderName() { 32459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return vertName; 32559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 32659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 32759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 32859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns the shader language of the shaders used in this technique. 32959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 33059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the shader language of the shaders used in this technique. 33159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 33259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String getShaderLanguage() { 33359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return shaderLang; 33459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 33559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 33659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 33759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Adds a new world parameter by the given name. 33859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 33959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param name The world parameter to add. 34059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return True if the world parameter name was found and added 34159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * to the list of world parameters, false otherwise. 34259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 34359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public boolean addWorldParam(String name) { 34459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (worldBinds == null){ 34559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta worldBinds = new ArrayList<UniformBinding>(); 34659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 34759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 34859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta try { 34959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta worldBinds.add( UniformBinding.valueOf(name) ); 35059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return true; 35159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } catch (IllegalArgumentException ex){ 35259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return false; 35359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 35459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 35559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 35659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 35759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns a list of world parameters that are used by this 35859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * technique definition. 35959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 36059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return The list of world parameters 36159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 36259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public List<UniformBinding> getWorldBindings() { 36359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return worldBinds; 36459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 36559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 36659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void write(JmeExporter ex) throws IOException{ 36759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta OutputCapsule oc = ex.getCapsule(this); 36859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(name, "name", null); 36959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(vertName, "vertName", null); 37059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(fragName, "fragName", null); 37159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(shaderLang, "shaderLang", null); 37259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(presetDefines, "presetDefines", null); 37359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(lightMode, "lightMode", LightMode.Disable); 37459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(shadowMode, "shadowMode", ShadowMode.Disable); 37559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(renderState, "renderState", null); 37659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta oc.write(usesShaders, "usesShaders", false); 37759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // TODO: Finish this when Map<String, String> export is available 37859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// oc.write(defineParams, "defineParams", null); 37959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // TODO: Finish this when List<Enum> export is available 38059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// oc.write(worldBinds, "worldBinds", null); 38159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 38259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 38359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void read(JmeImporter im) throws IOException{ 38459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta InputCapsule ic = im.getCapsule(this); 38559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta name = ic.readString("name", null); 38659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta vertName = ic.readString("vertName", null); 38759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta fragName = ic.readString("fragName", null); 38859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta shaderLang = ic.readString("shaderLang", null); 38959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta presetDefines = (DefineList) ic.readSavable("presetDefines", null); 39059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta lightMode = ic.readEnum("lightMode", LightMode.class, LightMode.Disable); 39159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta shadowMode = ic.readEnum("shadowMode", ShadowMode.class, ShadowMode.Disable); 39259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta renderState = (RenderState) ic.readSavable("renderState", null); 39359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta usesShaders = ic.readBoolean("usesShaders", false); 39459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 39559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 39659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta} 397