1 #ifndef DALI_TOOLKIT_SCENE3D_VIEW_H
\r
2 #define DALI_TOOLKIT_SCENE3D_VIEW_H
\r
5 * Copyright (c) 2018 Samsung Electronics Co., Ltd.
\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
11 * http://www.apache.org/licenses/LICENSE-2.0
\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
21 // EXTERNAL INCLUDES
\r
22 #include <dali/public-api/actors/camera-actor.h>
\r
24 // INTERNAL INCLUDES
\r
25 #include <dali-toolkit/public-api/controls/control.h>
\r
33 namespace Internal DALI_INTERNAL
\r
37 * Scene3dView implementation class
\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
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
60 * void Scene3dViewExample::Create( Application& application )
\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
65 * Stage::GetCurrent().Add( scene3dView );
\r
66 * scene3dView.PlayAnimations();
\r
68 * scene3dView.SetLight( Scene3dView::LightType::DIRECTIONAL_LIGHT, Vector3( 1.0, 1.0, -1.0 ), Vector3( 0.3, 0.3, 0.3 ) );
\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
78 class DALI_TOOLKIT_API Scene3dView : public Control
\r
84 // Scene doesn't use both of point and directional light
\r
86 // Scene use point light
\r
88 // Scene use directional light
\r
90 // Scene use Image Based Lighting
\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
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
105 * @brief Copy constructor. Creates another handle that points to the same real object
\r
107 Scene3dView( const Scene3dView& handle );
\r
110 * @brief Assignment operator. Changes this handle to point to another real object
\r
112 Scene3dView& operator=( const Scene3dView& handle );
\r
115 * @brief Destructor
\r
116 * This is non-virtual since derived Handle types must not contain data or virtual methods.
\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
126 static Scene3dView DownCast( BaseHandle handle );
\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
133 static Scene3dView New( const std::string& filePath );
\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
143 static Scene3dView New( const std::string& filePath, const std::string& diffuseTexturePath, const std::string& specularTexturePath, Vector4 scaleFactor );
\r
146 * @brief Get animation count.
\r
147 * @return number of animations.
\r
149 uint32_t GetAnimationCount();
\r
152 * @brief Play an animation.
\r
153 * @param[in] index Animation index
\r
154 * @return true if animation is played.
\r
156 bool PlayAnimation( uint32_t index );
\r
159 * @brief Play all animations.
\r
160 * @return true if animations are played.
\r
162 bool PlayAnimations();
\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
173 bool SetLight( LightType type, Vector3 lightVector, Vector3 lightColor );
\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
179 CameraActor GetDefaultCamera();
\r
182 * @brief Get camera count.
\r
183 * @return number of cameras.
\r
185 uint32_t GetCameraCount();
\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
192 CameraActor GetCamera( uint32_t cameraIndex );
\r
194 // Not intended for developer use
\r
198 * @brief Creates a handle using the Toolkit::Internal implementation.
\r
199 * @param[in] implementation The UI Control implementation.
\r
201 DALI_INTERNAL Scene3dView( Toolkit::Internal::Scene3dView& implementation );
\r
203 explicit DALI_INTERNAL Scene3dView( Dali::Internal::CustomActor* internal );
\r
206 } // namespace Toolkit
\r
208 } // namespace Dali
\r
210 #endif // DALI_TOOLKIT_SCENE3D_VIEW_H
\r