com.jme3.shader

Class ShaderGenerator

java.lang.Object

com.jme3.shader.ShaderGenerator

Direct Known Subclasses:

Glsl100ShaderGenerator

public abstract class ShaderGenerator
extends java.lang.Object

This class is the base for a shader generator using the ShaderNodes system, it contains basis mechanism of generation, but no actual generation code. This class is abstract, any Shader generator must extend it.

Field Summary

Fields

Modifier and Type	Field and Description
protected AssetManager	assetManager the asset manager
protected int	indent indentation value for generation
static java.lang.String	NAME_SPACE_GLOBAL
static java.lang.String	NAME_SPACE_MAT_PARAM
static java.lang.String	NAME_SPACE_VERTEX_ATTRIBUTE
static java.lang.String	NAME_SPACE_WORLD_PARAM
protected TechniqueDef	techniqueDef the technique def to use for the shader generation

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ShaderGenerator(AssetManager assetManager) Build a shaderGenerator

Method Summary

Modifier and Type	Method and Description
protected void	appendNodeDeclarationAndMain(java.lang.String loadedSource, java.lang.StringBuilder sourceDeclaration, java.lang.StringBuilder source, ShaderNode shaderNode, ShaderGenerationInfo info, java.lang.String shaderPath) Appends declaration and main part of a node to the shader declaration and main part.
protected java.lang.String	buildShader(java.util.List<ShaderNode> shaderNodes, ShaderGenerationInfo info, Shader.ShaderType type) This method is responsible for the shader generation.
protected int	findShaderIndexFromVersion(ShaderNode shaderNode, Shader.ShaderType type) returns the shaderpath index according to the version of the generator.
protected abstract void	generateAttributes(java.lang.StringBuilder source, ShaderGenerationInfo info) generates the attributes declaration for the vertex shader.
protected void	generateDeclarationAndMainBody(java.util.List<ShaderNode> shaderNodes, java.lang.StringBuilder sourceDeclaration, java.lang.StringBuilder source, ShaderGenerationInfo info, Shader.ShaderType type) iterates through shader nodes to load them and generate the shader declaration part and main body extracted from the shader nodes, for the given shader type
protected abstract void	generateDeclarativeSection(java.lang.StringBuilder source, ShaderNode shaderNode, java.lang.String nodeDecalarationSource, ShaderGenerationInfo info) Appends the given shaderNode declarative part to the shader declarative part.
protected abstract void	generateEndOfMainSection(java.lang.StringBuilder source, ShaderGenerationInfo info, Shader.ShaderType type) generates the end of the shader main section.
protected abstract void	generateNodeMainSection(java.lang.StringBuilder source, ShaderNode shaderNode, java.lang.String nodeSource, ShaderGenerationInfo info) Appends the given shaderNode main part to the shader declarative part.
Shader	generateShader(java.lang.String definesSourceCode) Generate vertex and fragment shaders for the given technique
protected abstract void	generateStartOfMainSection(java.lang.StringBuilder source, ShaderGenerationInfo info, Shader.ShaderType type) generates the start of the shader main section.
protected abstract void	generateUniforms(java.lang.StringBuilder source, ShaderGenerationInfo info, Shader.ShaderType type) generates the uniforms declaration for a shader of the given type.
protected abstract void	generateVaryings(java.lang.StringBuilder source, ShaderGenerationInfo info, Shader.ShaderType type) generates the varyings for the given shader type shader.
protected abstract java.lang.String	getLanguageAndVersion(Shader.ShaderType type) returns the language + version of the shader should be something like "GLSL100" for glsl 1.0 "GLSL150" for glsl 1.5.
void	initialize(TechniqueDef techniqueDef)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NAME_SPACE_GLOBAL

public static final java.lang.String NAME_SPACE_GLOBAL

See Also:

Constant Field Values

NAME_SPACE_VERTEX_ATTRIBUTE

public static final java.lang.String NAME_SPACE_VERTEX_ATTRIBUTE

See Also:

Constant Field Values

NAME_SPACE_MAT_PARAM

public static final java.lang.String NAME_SPACE_MAT_PARAM

See Also:

Constant Field Values

NAME_SPACE_WORLD_PARAM

public static final java.lang.String NAME_SPACE_WORLD_PARAM

See Also:

Constant Field Values

assetManager

protected AssetManager assetManager

the asset manager

indent

protected int indent

indentation value for generation

techniqueDef

protected TechniqueDef techniqueDef

the technique def to use for the shader generation

Constructor Detail

ShaderGenerator

protected ShaderGenerator(AssetManager assetManager)

Build a shaderGenerator

Parameters:

assetManager - for loading assets (alias created)

Method Detail

initialize

public void initialize(TechniqueDef techniqueDef)

generateShader

public Shader generateShader(java.lang.String definesSourceCode)

Generate vertex and fragment shaders for the given technique

Parameters:

definesSourceCode - (may be null)

Returns:

a Shader program

buildShader

protected java.lang.String buildShader(java.util.List<ShaderNode> shaderNodes,
                                       ShaderGenerationInfo info,
                                       Shader.ShaderType type)

This method is responsible for the shader generation.

Parameters:

shaderNodes - the list of shader nodes

info - the ShaderGenerationInfo filled during the Technique loading

type - the type of shader to generate

Returns:

the code of the generated vertex shader

generateDeclarationAndMainBody

protected void generateDeclarationAndMainBody(java.util.List<ShaderNode> shaderNodes,
                                              java.lang.StringBuilder sourceDeclaration,
                                              java.lang.StringBuilder source,
                                              ShaderGenerationInfo info,
                                              Shader.ShaderType type)

iterates through shader nodes to load them and generate the shader declaration part and main body extracted from the shader nodes, for the given shader type

Parameters:

shaderNodes - the list of shader nodes

sourceDeclaration - the declaration part StringBuilder of the shader to generate

source - the main part StringBuilder of the shader to generate

info - the ShaderGenerationInfo

type - the Shader type

appendNodeDeclarationAndMain

protected void appendNodeDeclarationAndMain(java.lang.String loadedSource,
                                            java.lang.StringBuilder sourceDeclaration,
                                            java.lang.StringBuilder source,
                                            ShaderNode shaderNode,
                                            ShaderGenerationInfo info,
                                            java.lang.String shaderPath)

Appends declaration and main part of a node to the shader declaration and main part. the loadedSource is split by "void main(){" to split declaration from main part of the node source code.The trailing "}" is removed from the main part. Each part is then respectively passed to generateDeclarativeSection and generateNodeMainSection.

Parameters:

loadedSource - the actual source code loaded for this node.

shaderPath - path to the shader file

sourceDeclaration - the Shader declaration part string builder.

source - the Shader main part StringBuilder.

shaderNode - the shader node.

info - the ShaderGenerationInfo.

See Also:

generateDeclarativeSection(java.lang.StringBuilder, com.jme3.shader.ShaderNode, java.lang.String, com.jme3.material.ShaderGenerationInfo), generateNodeMainSection(java.lang.StringBuilder, com.jme3.shader.ShaderNode, java.lang.String, com.jme3.material.ShaderGenerationInfo)

getLanguageAndVersion

protected abstract java.lang.String getLanguageAndVersion(Shader.ShaderType type)

returns the language + version of the shader should be something like "GLSL100" for glsl 1.0 "GLSL150" for glsl 1.5.

Parameters:

type - the shader type for which the version should be returned.

Returns:

the shaderLanguage and version.

generateUniforms

protected abstract void generateUniforms(java.lang.StringBuilder source,
                                         ShaderGenerationInfo info,
                                         Shader.ShaderType type)

generates the uniforms declaration for a shader of the given type.

Parameters:

source - the source StringBuilder to append generated code.

info - the ShaderGenerationInfo.

type - the shader type the uniforms have to be generated for.

generateAttributes

protected abstract void generateAttributes(java.lang.StringBuilder source,
                                           ShaderGenerationInfo info)

generates the attributes declaration for the vertex shader. There is no Shader type passed here as attributes are only used in vertex shaders

Parameters:

source - the source StringBuilder to append generated code.

info - the ShaderGenerationInfo.

generateVaryings

protected abstract void generateVaryings(java.lang.StringBuilder source,
                                         ShaderGenerationInfo info,
                                         Shader.ShaderType type)

generates the varyings for the given shader type shader. Note that varyings are deprecated in glsl 1.3, but this method will still be called to generate all non global inputs and output of the shaders.

Parameters:

source - the source StringBuilder to append generated code.

info - the ShaderGenerationInfo.

type - the shader type the varyings have to be generated for.

generateDeclarativeSection

protected abstract void generateDeclarativeSection(java.lang.StringBuilder source,
                                                   ShaderNode shaderNode,
                                                   java.lang.String nodeDecalarationSource,
                                                   ShaderGenerationInfo info)

Appends the given shaderNode declarative part to the shader declarative part. If needed the shader type can be determined by fetching the shaderNode's definition type.

Parameters:

nodeDecalarationSource - the declaration part of the node

source - the StringBuilder to append generated code.

shaderNode - the shaderNode.

info - the ShaderGenerationInfo.

See Also:

ShaderNode.getDefinition(), ShaderNodeDefinition.getType()

generateStartOfMainSection

protected abstract void generateStartOfMainSection(java.lang.StringBuilder source,
                                                   ShaderGenerationInfo info,
                                                   Shader.ShaderType type)

generates the start of the shader main section. this method is responsible of appending the "void main(){" in the shader and declaring all global outputs of the shader

Parameters:

source - the StringBuilder to append generated code.

info - the ShaderGenerationInfo.

type - the shader type the section has to be generated for.

generateEndOfMainSection

protected abstract void generateEndOfMainSection(java.lang.StringBuilder source,
                                                 ShaderGenerationInfo info,
                                                 Shader.ShaderType type)

generates the end of the shader main section. this method is responsible of appending the last "}" in the shader and mapping all global outputs of the shader

Parameters:

source - the StringBuilder to append generated code.

info - the ShaderGenerationInfo.

type - the shader type the section has to be generated for.

generateNodeMainSection

protected abstract void generateNodeMainSection(java.lang.StringBuilder source,
                                                ShaderNode shaderNode,
                                                java.lang.String nodeSource,
                                                ShaderGenerationInfo info)

Appends the given shaderNode main part to the shader declarative part. If needed the shader type can be determined by fetching the shaderNode's definition type.

Parameters:

source - the StringBuilder to append generated code.

shaderNode - the shaderNode.

nodeSource - the declaration part of the loaded shaderNode source.

info - the ShaderGenerationInfo.

See Also:

ShaderNode.getDefinition(), ShaderNodeDefinition.getType()

findShaderIndexFromVersion

protected int findShaderIndexFromVersion(ShaderNode shaderNode,
                                         Shader.ShaderType type)
                                  throws java.lang.NumberFormatException

returns the shaderpath index according to the version of the generator. This allow to select the higher version of the shader that the generator can handle

Parameters:

shaderNode - the shaderNode being processed

type - the shaderType

Returns:

the index of the shader path in ShaderNodeDefinition shadersPath list

Throws:

java.lang.NumberFormatException - for an invalid version