Examples of com.jme3.material.Material.render()

• com.jme3.material.Material.render()
  Called by {@link RenderManager} to render the geometry byusing this material.

  The material is rendered as follows:

  • Determine which technique to use to render the material - either what the user selected via {@link #selectTechnique(java.lang.String,com.jme3.renderer.RenderManager) Material.selectTechnique()}, or the first default technique that the renderer supports (based on the technique's {@link TechniqueDef#getRequiredCaps() requested rendering capabilities})
    • If the technique has been changed since the last frame, then it is notified via {@link Technique#makeCurrent(com.jme3.asset.AssetManager,boolean,java.util.EnumSet) Technique.makeCurrent()}. If the technique wants to use a shader to render the model, it should load it at this part - the shader should have all the proper defines as declared in the technique definition, including those that are bound to material parameters. The technique can re-use the shader from the last frame if no changes to the defines occurred.
  • Set the {@link RenderState} to use for rendering. The render states are applied in this order (later RenderStates override earlier RenderStates):
    1. {@link TechniqueDef#getRenderState() Technique Definition's RenderState}- i.e. specific renderstate that is required for the shader.
    2. {@link #getAdditionalRenderState() Material Instance Additional RenderState}- i.e. ad-hoc renderstate set per model
    3. {@link RenderManager#getForcedRenderState() RenderManager's Forced RenderState}- i.e. renderstate requested by a {@link com.jme3.post.SceneProcessor} orpost-processing filter.
  • If the technique {@link TechniqueDef#isUsingShaders() uses a shader}, then the uniforms of the shader must be updated.
    • Uniforms bound to material parameters are updated based on the current material parameter values.
    • Uniforms bound to world parameters are updated from the RenderManager. Internally {@link UniformBindingManager} is used for this task.
    • Uniforms bound to textures will cause the texture to be uploaded as necessary. The uniform is set to the texture unit where the texture is bound.
  • If the technique uses a shader, the model is then rendered according to the lighting mode specified on the technique definition.
    • {@link LightMode#SinglePass single pass light mode} fills the shader's light uniform arrays with the first 4 lights and renders the model once.
    • {@link LightMode#MultiPass multi pass light mode} light mode renders the model multiple times, for the first light it is rendered opaque, on subsequent lights it is rendered with {@link BlendMode#AlphaAdditive alpha-additive} blending and depth writing disabled.
  • For techniques that do not use shaders, fixed function OpenGL is used to render the model (see {@link GL1Renderer} interface):
    • OpenGL state ( {@link FixedFuncBinding}) that is bound to material parameters is updated.
    • The texture set on the material is uploaded and bound. Currently only 1 texture is supported for fixed function techniques.
    • If the technique uses lighting, then OpenGL lighting state is updated based on the light list on the geometry, otherwise OpenGL lighting is disabled.
    • The mesh is uploaded and rendered.

  @param geom The geometry to render @param rm The render manager requesting the rendering