[Tizen] Restore public API change
[platform/core/uifw/dali-core.git] / doc / dali-core-doc.h
1 #ifndef __DALI_DOC_H__
2 #define __DALI_DOC_H__
3
4 /*
5  * Copyright (c) 2016 Samsung Electronics Co., Ltd.
6  *
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  *
11  * http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  *
19  */
20
21 /**
22  * @defgroup dali_core DALi Core
23  *
24  * @brief DALi Core provides core functionalities such as scene graph-based rendering, animation, and event handling.
25  *
26  * It is a base module and forms the biggest part of DALi.
27  *
28  * @section dali_core_overview Overview
29  *
30  * DALi Core consists of the following groups of API:
31  *
32  * <table>
33  * <tr>
34  *    <th>API Group</th>
35  *    <th>Description</th>
36  * </tr>
37  * <tr>
38  *    <td>@ref dali_core_actors</td>
39  *    <td>Actor is the primary object for interaction in DALi applications.</td>
40  * </tr>
41  * <tr>
42  *    <td>@ref dali_core_animation</td>
43  *    <td>Classes for animation which allows your objects to move around / change their properties for a specified duration.</td>
44  * </tr>
45  * <tr>
46  *    <td>@ref dali_core_common</td>
47  *    <td>Common classes for using DALi.</td>
48  * </tr>
49  * <tr>
50  *    <td>@ref dali_core_events</td>
51  *    <td>Classes for input events and gestures supported by DALi.</td>
52  * </tr>
53  * <tr>
54  *    <td>@ref dali_core_images</td>
55  *    <td>Classes for handling images.</td>
56  * </tr>
57  * <tr>
58  *    <td>@ref dali_core_math</td>
59  *    <td>Classes for basic math.</td>
60  * </tr>
61  * <tr>
62  *    <td>@ref dali_core_object</td>
63  *    <td>Classes for the handle/body pattern and property system.</td>
64  * </tr>
65  * <tr>
66  *    <td>@ref dali_core_rendering_effects</td>
67  *    <td>Classes for render task and shader effect.</td>
68  * </tr>
69  * <tr>
70  *    <td>@ref dali_core_signals</td>
71  *    <td>Classes for the signal and slot structure.</td>
72  * </tr>
73  * <tr>
74  *    <td>@ref dali_core_size_negotiation</td>
75  *    <td>Classes for the size negotiation.</td>
76  * </tr>
77  * </table>
78  *
79  * \ifnot show_tizen_feature
80  *
81  * @section dali_toolkit_feature Related Features
82  * This API is related with the following features:\n
83  *    - http://tizen.org/feature/opengles.version.2_0\n
84  *
85  * It is recommended to design feature related codes in your application for reliability.\n
86  *
87  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
88  *
89  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
90  *
91  * More details on featuring your application can be found from <a href="https://docs.tizen.org/application/tizen-studio/native-tools/manifest-text-editor#feature-element"><b>Feature Element</b>.</a>
92  *
93  * \endif
94  *
95  * @ingroup dali
96  * @{
97  *   @defgroup dali_core_actors Actors
98  *   @brief Actor is the primary object for interaction in DALi applications.
99
100  *   @defgroup dali_core_animation Animation
101  *   @brief Classes for animation which allows your objects to move around / change their properties for a specified duration.
102
103  *   @defgroup dali_core_common Common
104  *   @brief Common classes for using DALi.
105
106  *   @defgroup dali_core_events Events
107  *   @brief Classes for input events and gestures supported by DALi.
108
109  *   @defgroup dali_core_images Images
110  *   @brief Classes for handling resource images.
111
112  *   @defgroup dali_core_math Math
113  *   @brief Classes for basic math.
114
115  *   @defgroup dali_core_object Object
116  *   @brief Classes for the handle/body pattern and property system.
117
118  *   @defgroup dali_core_rendering_effects Rendering & Effect
119  *   @brief Classes for render task and shader effect.
120
121  *   @defgroup dali_core_signals Signal
122  *   @brief Classes for the signal and slot structure.
123
124  *   @defgroup dali_core_size_negotiation Size Negotiation
125  *   @brief Classes for the size negotiation.
126  * @}
127  */
128
129 #endif  /* __DALI_DOC_H__ */