dali-toolkit/devel-api/controls/scene3d-view/scene3d-view.h

   1 #ifndef DALI_TOOLKIT_SCENE3D_VIEW_H\r
   2 #define DALI_TOOLKIT_SCENE3D_VIEW_H\r
   3 \r
   4 /*\r
   5  * Copyright (c) 2018 Samsung Electronics Co., Ltd.\r
   6  *\r
   7  * Licensed under the Apache License, Version 2.0 (the "License");\r
   8  * you may not use this file except in compliance with the License.\r
   9  * You may obtain a copy of the License at\r
  10  *\r
  11  * http://www.apache.org/licenses/LICENSE-2.0\r
  12  *\r
  13  * Unless required by applicable law or agreed to in writing, software\r
  14  * distributed under the License is distributed on an "AS IS" BASIS,\r
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
  16  * See the License for the specific language governing permissions and\r
  17  * limitations under the License.\r
  18  *\r
  19  */\r
  20 \r
  21 // EXTERNAL INCLUDES\r
  22 #include <dali/public-api/actors/camera-actor.h>\r
  23 \r
  24 // INTERNAL INCLUDES\r
  25 #include <dali-toolkit/public-api/controls/control.h>\r
  26 \r
  27 namespace Dali\r
  28 {\r
  29 \r
  30 namespace Toolkit\r
  31 {\r
  32 \r
  33 namespace Internal DALI_INTERNAL\r
  34 {\r
  35 \r
  36 /**\r
  37  * Scene3dView implementation class\r
  38  */\r
  39 class Scene3dView;\r
  40 \r
  41 }\r
  42 \r
  43 /**\r
  44  *\r
  45  * Scene3dView is a class for containing scene elements loaded from scene format file(e.g., glTF). Scene elements mean scene graph, cameras, and animations.\r
  46  *\r
  47  * Basic idea:-\r
  48  *\r
  49  * 1) The Scene3dView is initialized with diffuse and specular cube map for the Image Based Lighting.\n\r
  50  *    If the Scene3dView initialized without cube map, the objects of the Scene3dView cannot be rendered with IBL.\n\r
  51  * 2) The Scene3dView is loaded from each scene format file(e.g., glTF).\n\r
  52  * 3) The Scene3dView can have a point light or a directional light.(optional)\n\r
  53  * 4) The Scene3dView playes each actor's animation.\n\r
  54  *\r
  55  *\r
  56  * Usage example: -\r
  57  *\r
  58  * @code\r
  59  *\r
  60  * void Scene3dViewExample::Create( Application& application )\r
  61  * {\r
  62  *   // Use 'Scene3dView::New( URL_SCENE_FILE )', if you don't want to render with IBL.\r
  63  *   Scene3dView scene3dView = Scene3dView::New( URL_SCENE_FILE, URL_DIFFUSE_TEXTURE, URL_SPECULAR_TEXTURE );\r
  64  *\r
  65  *   Stage::GetCurrent().Add( scene3dView );\r
  66  *   scene3dView.PlayAnimations();\r
  67  *\r
  68  *   scene3dView.SetLight( Scene3dView::LightType::DIRECTIONAL_LIGHT, Vector3( 1.0, 1.0, -1.0 ), Vector3( 0.3, 0.3, 0.3 ) );\r
  69  * }\r
  70  *\r
  71  * @endcode\r
  72  *\r
  73  * @remarks This control makes 3D Layer internally. Therefore, if any 2D UI\r
  74  * control is added as a child of this Scene3dView, the functionality of the 2D UI\r
  75  * may not work well.\r
  76  */\r
  77 \r
  78 class DALI_TOOLKIT_API Scene3dView : public Control\r
  79 {\r
  80 public:\r
  81 \r
  82   enum LightType\r
  83   {\r
  84     // Scene doesn't use both of point and directional light\r
  85     NONE = 0,\r
  86     // Scene use point light\r
  87     POINT_LIGHT,\r
  88     // Scene use directional light\r
  89     DIRECTIONAL_LIGHT,\r
  90     // Scene use Image Based Lighting\r
  91     IMAGE_BASED_LIGHT,\r
  92     // Scene use Image Based Lighting and point light\r
  93     IMAGE_BASED_LIGHT_AND_POINT_LIGHT,\r
  94     // Scene use Image Based Lighting and directional light\r
  95     IMAGE_BASED_LIGHT_AND_DIRECTIONAL_LIGHT\r
  96   };\r
  97 \r
  98   /**\r
  99    * @brief Create an uninitialized Scene3dView; this can be initialized with Scene3dView::New()\r
 100    * Calling member functions with an uninitialized Dali::Object is not allowed.\r
 101    */\r
 102   Scene3dView();\r
 103 \r
 104   /**\r
 105    * @brief Copy constructor. Creates another handle that points to the same real object\r
 106    */\r
 107   Scene3dView( const Scene3dView& handle );\r
 108 \r
 109   /**\r
 110    * @brief Assignment operator. Changes this handle to point to another real object\r
 111    */\r
 112   Scene3dView& operator=( const Scene3dView& handle );\r
 113 \r
 114   /**\r
 115    * @brief Destructor\r
 116    * This is non-virtual since derived Handle types must not contain data or virtual methods.\r
 117    */\r
 118   ~Scene3dView();\r
 119 \r
 120   /**\r
 121    * @brief Downcast an Object handle to Scene3dView. If handle points to a Scene3dView the\r
 122    * downcast produces valid handle. If not the returned handle is left uninitialized.\r
 123    * @param[in] handle Handle to an object\r
 124    * @return handle to a Scene3dView or an uninitialized handle\r
 125    */\r
 126   static Scene3dView DownCast( BaseHandle handle );\r
 127 \r
 128   /**\r
 129    * @brief Create an initialized Scene3dView.\r
 130    * @param[in] filePath File path of scene format file (e.g., glTF).\r
 131    * @return A handle to a newly allocated Dali resource\r
 132    */\r
 133   static Scene3dView New( const std::string& filePath );\r
 134 \r
 135   /**\r
 136    * @brief Create an initialized Scene3dView.\r
 137    * @param[in] filePath File path of scene format file (e.g., glTF).\r
 138    * @param[in] diffuseTexturePath The texture path of diffuse cube map that used to render with Image Based Lighting.\r
 139    * @param[in] specularTexturePath The texture path of specular cube map that used to render with Image Based Lighting.\r
 140    * @param[in] scaleFactor Scaling factor for the Image Based Lighting.\r
 141    * @return A handle to a newly allocated Dali resource\r
 142    */\r
 143   static Scene3dView New( const std::string& filePath, const std::string& diffuseTexturePath, const std::string& specularTexturePath, Vector4 scaleFactor );\r
 144 \r
 145   /**\r
 146    * @brief Get animation count.\r
 147    * @return number of animations.\r
 148    */\r
 149   uint32_t GetAnimationCount();\r
 150 \r
 151   /**\r
 152    * @brief Play an animation.\r
 153    * @param[in] index Animation index\r
 154    * @return true if animation is played.\r
 155    */\r
 156   bool PlayAnimation( uint32_t index );\r
 157 \r
 158   /**\r
 159    * @brief Play all animations.\r
 160    * @return true if animations are played.\r
 161    */\r
 162   bool PlayAnimations();\r
 163 \r
 164   /**\r
 165    * @brief Set point light or directional light. If SetLight is not called, this scene doesn't use these kind of light.\r
 166    * @param[in] type The light type. If the light is point light set this LightType::POINT_LIGHT,\r
 167    * or if the light is directional light set this LightType::DIRECTIONAL_LIGHT.\r
 168    * @param[in] lightVector The point light position when light type is LightType::POINT_LIGHT.\r
 169    * The light direction when light type is LightType::DIRECTIONAL_LIGHT.\r
 170    * @param[in] lightColor Vector3 value that denotes the light color of point light or directional light. Since this is the light color, we don't need to use alpha value.\r
 171    * @return true if point light or directional light is set.\r
 172    */\r
 173   bool SetLight( LightType type, Vector3 lightVector, Vector3 lightColor );\r
 174 \r
 175   /**\r
 176    * @brief Get default CameraActor. Dali::Camera::Type = Dali::Camera::LOOK_AT_TARGET , near clipping plane = 0.1, and camera position = Vector3( 0.0, 0.0, 0.0 ).\r
 177    * @return CameraActor.\r
 178    */\r
 179   CameraActor GetDefaultCamera();\r
 180 \r
 181   /**\r
 182    * @brief Get camera count.\r
 183    * @return number of cameras.\r
 184    */\r
 185   uint32_t GetCameraCount();\r
 186 \r
 187   /**\r
 188    * @brief Get CameraActor. If there is no CameraActor in the list, then returns default CameraActor.\r
 189    * @param[in] cameraIndex Index of CameraActor list.\r
 190    * @return CameraActor.\r
 191    */\r
 192   CameraActor GetCamera( uint32_t cameraIndex );\r
 193 \r
 194   // Not intended for developer use\r
 195 public:\r
 196 \r
 197   /**\r
 198    * @brief Creates a handle using the Toolkit::Internal implementation.\r
 199    * @param[in]  implementation  The UI Control implementation.\r
 200    */\r
 201   DALI_INTERNAL Scene3dView( Toolkit::Internal::Scene3dView& implementation );\r
 202 \r
 203   explicit DALI_INTERNAL Scene3dView( Dali::Internal::CustomActor* internal );\r
 204 };\r
 205 \r
 206 } // namespace Toolkit\r
 207 \r
 208 } // namespace Dali\r
 209 \r
 210 #endif // DALI_TOOLKIT_SCENE3D_VIEW_H\r