dali-scene3d/public-api/loader/environment-definition.h

   1 #ifndef DALI_SCENE3D_LOADER_ENVIRONMENT_DEFINITION_H
   2 #define DALI_SCENE3D_LOADER_ENVIRONMENT_DEFINITION_H
   3 /*
   4  * Copyright (c) 2023 Samsung Electronics Co., Ltd.
   5  *
   6  * Licensed under the Apache License, Version 2.0 (the "License");
   7  * you may not use this file except in compliance with the License.
   8  * You may obtain a copy of the License at
   9  *
  10  * http://www.apache.org/licenses/LICENSE-2.0
  11  *
  12  * Unless required by applicable law or agreed to in writing, software
  13  * distributed under the License is distributed on an "AS IS" BASIS,
  14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  * See the License for the specific language governing permissions and
  16  * limitations under the License.
  17  *
  18  */
  19
  20 // EXTERNAL INCLUDES
  21 #include <dali/public-api/math/quaternion.h>
  22 #include <dali/public-api/rendering/texture.h>
  23 #include <memory>
  24
  25 // INTERNAL INCLUDES
  26 #include <dali-scene3d/public-api/api.h>
  27 #include <dali-scene3d/public-api/loader/environment-map-data.h>
  28
  29 namespace Dali::Scene3D::Loader
  30 {
  31 /**
  32  * @brief Defines an environment map with either or both of radiance
  33  *  and irradiance maps.
  34  */
  35 struct DALI_SCENE3D_API EnvironmentDefinition
  36 {
  37   struct Textures
  38   {
  39     Texture  mDiffuse;  // irradiance
  40     Texture  mSpecular; // radiance
  41     Texture  mBrdf;     // pre-computed brdf
  42     uint32_t mSpecularMipmapLevels{1u};
  43
  44     bool IsLoaded() const
  45     {
  46       return mDiffuse || mSpecular;
  47     }
  48   };
  49
  50   struct RawData
  51   {
  52     EnvironmentMapData mDiffuse;
  53     EnvironmentMapData mSpecular;
  54     PixelData          mBrdf;
  55   };
  56
  57   using EnvironmentData = std::pair<EnvironmentDefinition, Textures>;
  58   using Vector          = std::vector<EnvironmentData>;
  59
  60   EnvironmentDefinition() = default;
  61
  62   EnvironmentDefinition(const EnvironmentDefinition&) = delete;
  63   EnvironmentDefinition& operator=(const EnvironmentDefinition&) = delete;
  64
  65   EnvironmentDefinition(EnvironmentDefinition&&) = default;
  66   EnvironmentDefinition& operator=(EnvironmentDefinition&&) = default;
  67
  68   static Dali::Texture GetBrdfTexture();
  69
  70   /**
  71    * @brief Loads raw pixel data for the given diffuse and specular maps.
  72    * @note This can be done on any thread.
  73    */
  74   RawData LoadRaw(const std::string& environmentsPath);
  75
  76   /**
  77    * @brief Creates DALi cubemap Textures from the pixel data in @a raw, then
  78    *  returns them in a Textures object.
  79    * @note This must only be called from the event thread.
  80    */
  81   Textures Load(RawData&& raw);
  82
  83   /**
  84    * @brief Get default intensity value.
  85    * @return Default intensity. (1.0f)
  86    */
  87   static float GetDefaultIntensity();
  88
  89 private:
  90   static void LoadBrdfTexture();
  91
  92 public: // DATA
  93   std::string              mDiffuseMapPath;
  94   std::string              mSpecularMapPath;
  95   std::shared_ptr<RawData> mRawData;
  96   Quaternion               mCubeOrientation = Quaternion::IDENTITY;
  97   Vector3                  mYDirection      = Vector3::ONE;
  98   float                    mIblIntensity    = 1.0f;
  99   bool                     mUseBrdfTexture  = false;
 100
 101 private:
 102   static PixelData mBrdfPixelData;
 103   static Texture   mBrdfTexture;
 104   static bool      mIsBrdfLoaded;
 105 };
 106
 107 } // namespace Dali::Scene3D::Loader
 108
 109 #endif // DALI_SCENE3D_LOADER_ENVIRONMENT_DEFINITION_H