gz/rendering/ogre/OgreMaterial.hh

Go to the documentation of this file.

/*
 * Copyright (C) 2015 Open Source Robotics Foundation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */
#ifndef GZ_RENDERING_OGRE_OGREMATERIAL_HH_
#define GZ_RENDERING_OGRE_OGREMATERIAL_HH_
 
#include <memory>
#include <string>
 
#include <gz/utils/SuppressWarning.hh>
 
#include <gz/common/Image.hh>
 
#include "gz/rendering/base/BaseMaterial.hh"
#include "gz/rendering/ogre/OgreObject.hh"
#include "gz/rendering/ogre/OgreIncludes.hh"
 
namespace gz
{
  namespace rendering
  {
    inline namespace GZ_RENDERING_VERSION_NAMESPACE {
    // TODO(anyone): use a better way to find shader configurations
    const std::string depth_vertex_shader_file =
      "depth_vertex_shader.glsl";
    const std::string depth_fragment_shader_file =
      "depth_fragment_shader.glsl";
 
    class GZ_RENDERING_OGRE_VISIBLE OgreMaterial :
      public BaseMaterial<OgreObject>
    {
      protected: OgreMaterial();
 
      public: virtual ~OgreMaterial();
 
      // Documentation inherited
      public: virtual void Destroy() override;
 
      public: virtual bool LightingEnabled() const override;
 
      public: virtual void SetLightingEnabled(const bool _enabled) override;
 
      // Documentation inherited
      public: virtual bool DepthCheckEnabled() const override;
 
      // Documentation inherited
      public: virtual void SetDepthCheckEnabled(bool _enabled) override;
 
      // Documentation inherited
      public: virtual bool DepthWriteEnabled() const override;
 
      // Documentation inherited
      public: virtual void SetDepthWriteEnabled(bool _enabled) override;
 
      public: virtual math::Color Ambient() const override;
 
      public: virtual void SetAmbient(const math::Color &_color) override;
 
      public: virtual math::Color Diffuse() const override;
 
      public: virtual void SetDiffuse(const math::Color &_color) override;
 
      public: virtual math::Color Specular() const override;
 
      public: virtual void SetSpecular(const math::Color &_color) override;
 
      public: virtual math::Color Emissive() const override;
 
      public: virtual void SetEmissive(const math::Color &_color) override;
 
      public: virtual double Shininess() const override;
 
      public: virtual void SetShininess(const double _shininess) override;
 
      public: virtual double Transparency() const override;
 
      public: virtual void SetTransparency(const double _transparency)
                  override;
 
      // Documentation inherited
      public: virtual void SetAlphaFromTexture(bool _enabled,
          double _alpha = 0.5, bool _twoSided = true) override;
 
      public: virtual double Reflectivity() const override;
 
      public: virtual void SetReflectivity(const double _reflectivity)
                  override;
 
      public: virtual bool CastShadows() const override;
 
      // Documentation inherited.
      public: virtual void SetCastShadows(const bool _castShadows) override;
 
      public: virtual bool ReceiveShadows() const override;
 
      public: virtual void SetReceiveShadows(const bool _receiveShadows)
                  override;
 
      // Documentation inherited
      public: virtual float RenderOrder() const override;
 
      // Documentation inherited
      // Review the official documentation to get more details about this
      // parameter, in particular Ogre::Pass::setDepthBias()
      // https://www.ogre3d.org/docs/api/1.8/class_ogre_1_1_pass.html
      public: virtual void SetRenderOrder(const float _renderOrder) override;
 
      public: virtual bool ReflectionEnabled() const override;
 
      public: virtual void SetReflectionEnabled(const bool _enabled) override;
 
      public: virtual bool HasTexture() const override;
 
      public: virtual std::string Texture() const override;
 
      // Documentation inherited.
      public: virtual void SetTexture(const std::string &_texture,
        const std::shared_ptr<const common::Image> &_img = nullptr) override;
 
      public: virtual void ClearTexture() override;
 
      public: virtual std::shared_ptr<const common::Image> TextureData()
          const override;
 
      public: virtual bool HasNormalMap() const override;
 
      public: virtual std::string NormalMap() const override;
 
      public: virtual std::shared_ptr<const common::Image> NormalMapData()
          const override;
 
      // Documentation inherited.
      public: virtual void SetNormalMap(const std::string &_normalMap,
        const std::shared_ptr<const common::Image> &_img = nullptr) override;
 
      public: virtual void ClearNormalMap() override;
 
      public: virtual enum ShaderType ShaderType() const override;
 
      // Documentation inherited.
      public: virtual void SetShaderType(enum ShaderType _type) override;
 
      public: virtual Ogre::MaterialPtr Material() const;
 
      // Documentation inherited.
      // \sa Material::Set3DMaterial()
      public: virtual void SetDepthMaterial(const double far,
                const double near) override;
 
      // Documentation inherited.
      // \sa Material::SetVertexShader(const std::string &)
      public: virtual void SetVertexShader(const std::string &_path) override;
 
      // Documentation inherited.
      // \sa Material::VertexShader() const
      public: virtual std::string VertexShader() const override;
 
      // Documentation inherited.
      // \sa Material::VertexShaderParams()
      public: virtual ShaderParamsPtr VertexShaderParams() override;
 
      // Documentation inherited.
      // \sa Material::SetFragmentShader(const std::string &)
      public: virtual void SetFragmentShader(const std::string &_path)
                  override;
 
      // Documentation inherited.
      // \sa Material::FragmentShader() const
      public: virtual std::string FragmentShader() const override;
 
      // Documentation inherited.
      // \sa Material::FragmentShaderParams()
      public: virtual ShaderParamsPtr FragmentShaderParams() override;
 
      // Documentation inherited.
      // \sa BaseMaterial::PreRender()
      public: virtual void PreRender() override;
 
      protected: virtual void LoadOneImage(const std::string &_name,
                     Ogre::Image &_image);
 
      protected: virtual void SetTextureImpl(const std::string &_texture);
 
      protected: void SetTextureDataImpl(const std::string &_texture,
                     const std::shared_ptr<const common::Image> &_img);
 
      protected: virtual Ogre::TexturePtr Texture(const std::string &_name);
 
      protected: virtual Ogre::TexturePtr CreateTexture(
                     const std::string &_name);
 
      protected: virtual void UpdateTransparency();
 
      protected: virtual void UpdateColorOperation();
 
      protected: void UpdateShaderParams();
 
      protected: void UpdateShaderParams(ConstShaderParamsPtr _params,
        Ogre::GpuProgramParametersSharedPtr _ogreParams);
 
      protected: virtual void Init() override;
 
      GZ_UTILS_WARN_IGNORE__DLL_INTERFACE_MISSING
      protected: Ogre::MaterialPtr ogreMaterial;
 
      protected: Ogre::Technique *ogreTechnique = nullptr;
 
      protected: Ogre::Pass *ogrePass = nullptr;
 
      protected: Ogre::TextureUnitState *ogreTexState = nullptr;
 
      protected: Ogre::String ogreGroup;
 
#if OGRE_VERSION_MAJOR == 1 && OGRE_VERSION_MINOR <= 7
      protected: math::Color emissiveColor;
#endif
      protected: std::string textureName;
 
      protected: std::shared_ptr<const common::Image> textureData;
 
      protected: std::string normalMapName;
 
      protected: std::shared_ptr<const common::Image> normalMapData;
 
      protected: enum ShaderType shaderType = ST_PIXEL;
 
      protected: std::string vertexShaderPath;
 
      protected: std::string fragmentShaderPath;
 
      protected: ShaderParamsPtr vertexShaderParams;
 
      protected: ShaderParamsPtr fragmentShaderParams;
      GZ_UTILS_WARN_RESUME__DLL_INTERFACE_MISSING
 
      private: friend class OgreScene;
    };
    }
  }
}
#endif