examples/particles/utils.h

   1 #ifndef PARTICLES_UTILS_H_
   2 #define PARTICLES_UTILS_H_
   3 /*
   4  * Copyright (c) 2021 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 #include <cmath>
  21 #include "dali/public-api/actors/actor.h"
  22 #include "dali/public-api/math/vector3.h"
  23 #include "dali/public-api/rendering/geometry.h"
  24 #include "dali/public-api/rendering/renderer.h"
  25 #include "dali/public-api/rendering/shader.h"
  26 #include "dali/public-api/rendering/texture.h"
  27
  28 //
  29 // Maths
  30 //
  31 inline float FastFloor(float x)
  32 {
  33   return static_cast<int>(x) - static_cast<int>(x < 0);
  34 }
  35
  36 ///@brief Converts RGB values (in the 0..1 range) to HSL, where hue is in degrees,
  37 /// in the 0..360 range, and saturation and lightness are in the 0..1 range.
  38 Dali::Vector3 ToHueSaturationLightness(Dali::Vector3 rgb);
  39
  40 ///@brief Converts HSL values, where hue is in degrees, in the 0..360 range, and
  41 /// saturation and lightness are in 0..1  to RGB (in the 0..1 range)
  42 Dali::Vector3 FromHueSaturationLightness(Dali::Vector3 hsl);
  43
  44 //
  45 // Dali entities
  46 //
  47 ///@brief Creates geometry for a unit cube wireframe (i.e. vertex positions between
  48 /// -.5 and .5)..
  49 Dali::Geometry CreateCuboidWireframeGeometry();
  50
  51 enum RendererOptions
  52 {
  53   OPTION_NONE        = 0x0,
  54   OPTION_BLEND       = 0x01,
  55   OPTION_DEPTH_TEST  = 0x02,
  56   OPTION_DEPTH_WRITE = 0x04
  57 };
  58
  59 ///@brief Creates a renderer with the given @a textures set, @a geometry, @a shader
  60 /// and @a options from above.
  61 ///@note Back face culling is on.
  62 ///@note If textures is not a valid handle, an empty texture set will be created.
  63 Dali::Renderer CreateRenderer(Dali::TextureSet textures, Dali::Geometry geometry, Dali::Shader shader, uint32_t options = OPTION_NONE);
  64
  65 ///@brief Sets @a actor's anchor point and parent origin to center.
  66 void CenterActor(Dali::Actor actor);
  67
  68 ///@brief Creates an empty and centered actor.
  69 Dali::Actor CreateActor();
  70
  71 ///@brief Creates a copy of @a original, sharing the same geometry and shader and
  72 /// copying each properties.
  73 ///@note Breaks if @a original has any custom properties. TODO: fix.
  74 Dali::Renderer CloneRenderer(Dali::Renderer original);
  75
  76 ///@brief Creates a copy of @a original, cloning each renderer, and a select set
  77 /// of properties: parent origin, anchor point, size, position, orientation, scale,
  78 /// visible, color and name.
  79 ///@note Does not copy resize policy related properties, as setting those, even if
  80 /// default, will break the ability to specify a size for the actor in Z.
  81 Dali::Actor CloneActor(Dali::Actor original);
  82
  83 #endif //PARTICLES_UTILS_H_