Package com.jme3.material

The com.jme3.material package contains classes for manipulating jMonkeyEngine materials.

See: Description

Class Summary

Class	Description
Material	Material describes the rendering style for a given Geometry.
MaterialDef	Describes a J3MD (Material definition).
MaterialList	A map from material name to a material.
MaterialProcessor
Materials	This class is to provide some constants materials.
MatParam	Describes a material parameter.
MatParamOverride	MatParamOverride is a mechanism by which material parameters can be overridden on the scene graph.
MatParamTexture
RenderState	RenderState specifies material rendering properties that cannot be controlled by a shader on a Material.
ShaderGenerationInfo	This class is basically a struct that contains the ShaderNodes information in an appropriate way to ease the shader generation process and make it faster.
Technique	Represents a technique instance.
TechniqueDef	Describes a technique definition.

Enum Summary

Enum	Description
RenderState.BlendEquation	BlendEquation specifies the blending equation to combine pixels.
RenderState.BlendEquationAlpha	BlendEquationAlpha specifies the blending equation to combine pixels for the alpha component.
RenderState.BlendFunc	BlendFunc defines the blending functions for use with BlendMode.Custom.
RenderState.BlendMode	BlendMode specifies the blending operation to use.
RenderState.FaceCullMode	FaceCullMode specifies the criteria for faces to be culled.
RenderState.StencilOperation	StencilOperation specifies the stencil operation to use in a certain scenario as specified in RenderState.setStencil(boolean, com.jme3.material.RenderState.StencilOperation, com.jme3.material.RenderState.StencilOperation, com.jme3.material.RenderState.StencilOperation, com.jme3.material.RenderState.StencilOperation, com.jme3.material.RenderState.StencilOperation, com.jme3.material.RenderState.StencilOperation, com.jme3.material.RenderState.TestFunction, com.jme3.material.RenderState.TestFunction)
RenderState.TestFunction	TestFunction specifies the testing function for stencil test function.
TechniqueDef.LightMode	Describes light rendering mode.
TechniqueDef.LightSpace	Define in what space the light data should be sent to the shader.
TechniqueDef.ShadowMode

Package com.jme3.material Description

The com.jme3.material package contains classes for manipulating jMonkeyEngine materials. Materials are applied to geometries in the scene. Each geometry has a single material which is used to render that geometry.

Materials (also known as material instances) are extended from material definitions.

Material definitions

Material definitions provide the "logic" for the material. Usually a shader that will handle drawing the object, and corresponding parameters that allow configuration of the shader. Material definitions can be created through J3MD files. The J3MD file abstracts the shader and its configuration away from the user, allowing a simple interface where one can simply set a few parameters on the material to change its appearance and the way its handled.

Techniques

Techniques specify a specific way of rendering a material. Typically a technique is used to implement the same material for each configuration of the system. For GPUs that do not support shaders, a "fixed function pipeline" technique could exist to take care of rendering for that configuration

Render states

See RenderState.

Example Usage

Creating a textured material // Create a material instance Material mat = new Material(assetManager, "Common/MatDefs/Misc/Unshaded.j3md"); // Load the texture. Texture tex = assetManager.loadTexture("Textures/Test/Test.jpg"); // Set the parameters mat.setTexture("ColorMap", tex);