Remove deprecated APIs in Tizen 3.0
[platform/core/uifw/dali-core.git] / dali / public-api / actors / actor-enumerations.h
index 72d3d42..7b82148 100644 (file)
@@ -2,7 +2,7 @@
 #define DALI_ACTOR_ENUMERATIONS_H
 
 /*
- * Copyright (c) 2016 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -41,45 +41,34 @@ enum ColorMode
 };
 
 /**
- * @DEPRECATED_1_1.24 Use SetInheritPosition instead
- * @brief Enumeration for Actor position inheritance mode.
+ * @brief Enumeration for layout Dimensions.
+ * @SINCE_1_0.0
+ */
+namespace Dimension
+{
+
+/**
+ * @brief Enumeration for Dimension types.
  * @SINCE_1_0.0
  */
-enum PositionInheritanceMode
+enum Type
 {
-  INHERIT_PARENT_POSITION,                 ///< Actor will inherit its parent position. This is the default @SINCE_1_0.0
-  USE_PARENT_POSITION,                     ///< Actor will copy its parent position. This is useful if many actors are stacked together in the same place. This option ignores parent origin and anchor point. @SINCE_1_0.0
-  USE_PARENT_POSITION_PLUS_LOCAL_POSITION, ///< Actor will copy its parent position and add local position. This is useful if many actors are stacked together in the same place with an offset.  This option ignores parent origin and anchor point. @SINCE_1_0.0
-  DONT_INHERIT_POSITION                    ///< Actor will not inherit position. Local position is treated as world position. This is useful if a constraint is used to override local position or if an actor is positioned globally. This option ignores parent origin, anchor point and local position. @SINCE_1_0.0
+  WIDTH  = 0x1,       ///< Width dimension @SINCE_1_0.0
+  HEIGHT = 0x2,       ///< Height dimension @SINCE_1_0.0
+
+  ALL_DIMENSIONS = 0x3  ///< Mask to cover all flags @SINCE_1_0.0
 };
 
 /**
- * @brief Enumeration for layout Dimensions.
+ * @brief Enumeration for Dimension number.
  * @SINCE_1_0.0
  */
-namespace Dimension
+enum Meta
 {
-  /**
-   * @brief Enumeration for Dimension types.
-   * @SINCE_1_0.0
-   */
-  enum Type
-  {
-    WIDTH  = 0x1,       ///< Width dimension @SINCE_1_0.0
-    HEIGHT = 0x2,       ///< Height dimension @SINCE_1_0.0
-
-    ALL_DIMENSIONS = 0x3  ///< Mask to cover all flags @SINCE_1_0.0
-  };
-
-  /**
-   * @brief Enumeration for Dimension number.
-   * @SINCE_1_0.0
-   */
-  enum Meta
-  {
-    DIMENSION_COUNT = 2  ///< Number of dimensions - update this if adding new dimension @SINCE_1_0.0
-  };
-}
+  DIMENSION_COUNT = 2  ///< Number of dimensions - update this if adding new dimension @SINCE_1_0.0
+};
+
+} // namespace Dimension
 
 /**
  * @brief Enumeration for size negotiation resize policies.
@@ -87,23 +76,25 @@ namespace Dimension
  */
 namespace ResizePolicy
 {
-  /**
-   * @brief Enumeration for ResizePolicy types.
-   * @SINCE_1_0.0
-   */
-  enum Type
-  {
-    FIXED,                 ///< Size is fixed as set by SetSize @SINCE_1_0.0
-    USE_NATURAL_SIZE,      ///< Size is to use the actor's natural size @SINCE_1_0.0 @see Actor::GetNaturalSize()
-    FILL_TO_PARENT,        ///< Size is to fill up to the actor's parent's bounds. Aspect ratio is not maintained. @SINCE_1_0.0
-    SIZE_RELATIVE_TO_PARENT,        ///< The actors size will be ( ParentSize * SizeRelativeToParentFactor ). @SINCE_1_0.0
-    SIZE_FIXED_OFFSET_FROM_PARENT,  ///< The actors size will be ( ParentSize + SizeRelativeToParentFactor ). @SINCE_1_0.0
-    FIT_TO_CHILDREN,       ///< Size will adjust to wrap around all children @SINCE_1_0.0
-    DIMENSION_DEPENDENCY,  ///< One dimension is dependent on the other @SINCE_1_0.0
-    USE_ASSIGNED_SIZE      ///< The size will be assigned to the actor @SINCE_1_0.0
-  };
-  const Type DEFAULT = USE_NATURAL_SIZE; ///< Default resize policy
-}
+
+/**
+ * @brief Enumeration for ResizePolicy types.
+ * @SINCE_1_0.0
+ */
+enum Type
+{
+  FIXED,                 ///< Size is fixed as set by SetSize @SINCE_1_0.0
+  USE_NATURAL_SIZE,      ///< Size is to use the actor's natural size @SINCE_1_0.0 @see Actor::GetNaturalSize()
+  FILL_TO_PARENT,        ///< Size is to fill up to the actor's parent's bounds. Aspect ratio is not maintained. @SINCE_1_0.0
+  SIZE_RELATIVE_TO_PARENT,        ///< The actors size will be ( ParentSize * SizeRelativeToParentFactor ). @SINCE_1_0.0
+  SIZE_FIXED_OFFSET_FROM_PARENT,  ///< The actors size will be ( ParentSize + SizeRelativeToParentFactor ). @SINCE_1_0.0
+  FIT_TO_CHILDREN,       ///< Size will adjust to wrap around all children @SINCE_1_0.0
+  DIMENSION_DEPENDENCY,  ///< One dimension is dependent on the other @SINCE_1_0.0
+  USE_ASSIGNED_SIZE      ///< The size will be assigned to the actor @SINCE_1_0.0
+};
+const Type DEFAULT = USE_NATURAL_SIZE; ///< Default resize policy
+
+} // namespace ResizePolicy
 
 /**
  * @brief Enumeration for policies to determine how an actor should resize itself when having its size set in size negotiation.
@@ -111,17 +102,19 @@ namespace ResizePolicy
  */
 namespace SizeScalePolicy
 {
-  /**
-   * @brief Enumeration for SizeScalePolicy types.
-   * @SINCE_1_0.0
-   */
-  enum Type
-  {
-    USE_SIZE_SET,                ///< Use the size that was set @SINCE_1_0.0
-    FIT_WITH_ASPECT_RATIO,       ///< Fit within the size set maintaining natural size aspect ratio @SINCE_1_0.0
-    FILL_WITH_ASPECT_RATIO       ///< Fill up the size set maintaining natural size aspect ratio. May exceed size bounds in one dimension. @SINCE_1_0.0
-  };
-}
+
+/**
+ * @brief Enumeration for SizeScalePolicy types.
+ * @SINCE_1_0.0
+ */
+enum Type
+{
+  USE_SIZE_SET,                ///< Use the size that was set @SINCE_1_0.0
+  FIT_WITH_ASPECT_RATIO,       ///< Fit within the size set maintaining natural size aspect ratio @SINCE_1_0.0
+  FILL_WITH_ASPECT_RATIO       ///< Fill up the size set maintaining natural size aspect ratio. May exceed size bounds in one dimension. @SINCE_1_0.0
+};
+
+} // namespace SizeScalePolicy
 
 /**
  * @brief Enumeration for horizontal alignment types.
@@ -129,17 +122,19 @@ namespace SizeScalePolicy
  */
 namespace HorizontalAlignment
 {
-  /**
-   * @brief Enumeration for HorizontalAlignment types.
-   * @SINCE_1_0.0
-   */
-  enum Type
-  {
-    LEFT,         ///< Align horizontally left @SINCE_1_0.0
-    CENTER,       ///< Align horizontally center @SINCE_1_0.0
-    RIGHT         ///< Align horizontally right @SINCE_1_0.0
-  };
-}
+
+/**
+ * @brief Enumeration for HorizontalAlignment types.
+ * @SINCE_1_0.0
+ */
+enum Type
+{
+  LEFT,         ///< Align horizontally left @SINCE_1_0.0
+  CENTER,       ///< Align horizontally center @SINCE_1_0.0
+  RIGHT         ///< Align horizontally right @SINCE_1_0.0
+};
+
+} // namespace HorizontalAlignment
 
 /**
  * @brief Enumeration for vertical alignment types.
@@ -147,17 +142,19 @@ namespace HorizontalAlignment
  */
 namespace VerticalAlignment
 {
-  /**
-   * @brief Enumeration for VerticalAlignment types.
-   * @SINCE_1_0.0
-   */
-  enum Type
-  {
-    TOP,          ///< Align vertically top @SINCE_1_0.0
-    CENTER,       ///< Align vertically center @SINCE_1_0.0
-    BOTTOM        ///< Align vertically bottom @SINCE_1_0.0
-  };
-}
+
+/**
+ * @brief Enumeration for VerticalAlignment types.
+ * @SINCE_1_0.0
+ */
+enum Type
+{
+  TOP,          ///< Align vertically top @SINCE_1_0.0
+  CENTER,       ///< Align vertically center @SINCE_1_0.0
+  BOTTOM        ///< Align vertically bottom @SINCE_1_0.0
+};
+
+} // namespace VerticalAlignment
 
 /**
  * @brief Enumeration for ClippingMode describing how this Actor's children will be clipped against it.
@@ -165,17 +162,37 @@ namespace VerticalAlignment
  */
 namespace ClippingMode
 {
-  /**
-   * @brief Enumeration for ClippingMode types.
-   * @SINCE_1_2_5
-   */
-  enum Type
-  {
-    DISABLED,                     ///< This Actor will not clip its children. @SINCE_1_2_5
-    CLIP_CHILDREN,                ///< This Actor will clip all children to within its boundaries (the actor will also be visible itself). @SINCE_1_2_5
-  };
-}
+/**
+ * @brief Enumeration for ClippingMode types.
+ * @SINCE_1_2_5
+ */
+enum Type
+{
+  DISABLED,                     ///< This Actor will not clip its children. @SINCE_1_2_5
+  CLIP_CHILDREN,                ///< This Actor will clip itself and all children to within the pixel areas of this actors renderers. @SINCE_1_2_5
+  CLIP_TO_BOUNDING_BOX          ///< This Actor will clip itself and all children to within a screen-aligned rectangle encompassing its boundaries. @SINCE_1_2.61
+};
+
+} // namespace ClippingMode
+
+/**
+ * @brief Enumeration for the direction of the layout.
+ * @SINCE_1_2.60
+ */
+namespace LayoutDirection
+{
+
+/**
+ * @brief Enumeration for the LayoutDirection types.
+ * @SINCE_1_2.60
+ */
+enum Type
+{
+  LEFT_TO_RIGHT,   ///< Layout direction is from Left to Right direction. @SINCE_1_2.60
+  RIGHT_TO_LEFT    ///< Layout direction is from Right to Left direction. @SINCE_1_2.60
+};
 
+} // namespace LayoutDirection
 
 /**
  * @}