From: Yoonsang Lee Date: Wed, 27 Jan 2016 23:11:57 +0000 (+0900) Subject: Update doxygen groups and overview description X-Git-Tag: dali_1.1.29~7 X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=commitdiff_plain;h=e2c0ad1573b105352c195cad70429432f400f58d Update doxygen groups and overview description - Merge "Focus Manager" & "Accessibility Manager" groups into "Managers" - Update overview of DALi - Update overview of DALi Toolkit Change-Id: Iad7d693276b1c13274305a0c73b7ca49e54d9dc4 --- diff --git a/doc/dali-toolkit-doc.h b/doc/dali-toolkit-doc.h index fb83355..784cb4d 100644 --- a/doc/dali-toolkit-doc.h +++ b/doc/dali-toolkit-doc.h @@ -1,6 +1,23 @@ #ifndef __DALI_TOOLKIT_DOC_H__ #define __DALI_TOOLKIT_DOC_H__ +/* + * Copyright (c) 2016 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. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + /** * @defgroup dali DALi * @ingroup CAPI_UI_FRAMEWORK @@ -8,26 +25,101 @@ * @brief DALi is a cross-platform 3D UI Toolkit for embedded systems. * * @section dali-overview Overview + * * DALi's 3D user interface engine enables you to create rich and high-performance * UI applications. DALi is based on OpenGL ES 2.0, but provides a clean * cross-platform C++ framework. * This means that you can use high-level DALi APIs instead of accessing * low-level OpenGL APIs directly. - * + * + * DALi consists of the following modules: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
ModuleDescription
@ref dali_coreDALi Core provides core functionalities such as scene graph-based rendering, animation, and event handling.
@ref dali_adaptorDALi Adaptor is a platform adaptation layer.
@ref dali_toolkitDALi Toolkit provides UI components and various effects on top of the DALi Core.
+ * + * The layer diagram for DALi modules is shown below: + * @image html dali-modules.png "Figure: DALi modules" * * @defgroup dali_toolkit DALi Toolkit - * @ingroup dali * - * @brief This module provides UI components and various effects on top of the DALi Core. + * @brief DALi Toolkit provides UI components and various effects on top of the DALi Core. + * + * @section dali_core_overview Overview + * + * DALi Toolkit consists of the following groups of API: * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
API GroupDescription
@ref dali_toolkit_controlsControls are interactive components for layouting the user interface.
@ref dali_toolkit_controls_alignmentAlignment is a container which provides an easy way to align other actors inside its boundary.
@ref dali_toolkit_controls_buttonsButton is a small object on UI that you can press.
@ref dali_toolkit_controls_gaussian_blur_viewGaussianBlurView provides a render process that blurs an image.
@ref dali_toolkit_controls_image_viewImageView is a control displying an image.
@ref dali_toolkit_controls_scroll_barScrollBar control.
@ref dali_toolkit_controls_scrollableScrollable container controls.
@ref dali_toolkit_controls_item_viewItemView class is a scrollable container that can contain many items.
@ref dali_toolkit_controls_scroll_viewScrollView class provides scrollable view which contains actors and can be scrolled automatically or manually by panning.
@ref dali_toolkit_controls_table_viewTableView class is a layout container for aligning child actors in a grid like layout.
@ref dali_toolkit_controls_text_controlsControls for displaying text or text input.
@ref dali_toolkit_managersSingleton classes for managing application-wide functionalities.
+ * + * @ingroup dali * @{ - * @defgroup dali_toolkit_accessibility_manager Accessibility Manager - * @brief AccessibilityManager manages a accessibility focus chain. - * @defgroup dali_toolkit_controls Controls * @brief Controls are interactive components for layouting the user interface. @@ -65,8 +157,9 @@ * @brief Controls for displaying text or text input. * @} - * @defgroup dali_toolkit_focus_manager Focus Manager - * @brief Classes for handling keyboard navigation and maintaining the two dimensional keyboard focus chain. + + * @defgroup dali_toolkit_managers Managers + * @brief Singleton classes for managing application-wide functionalities. * @} */ diff --git a/docs/content/images/dali-modules.png b/docs/content/images/dali-modules.png new file mode 100644 index 0000000..d85303c Binary files /dev/null and b/docs/content/images/dali-modules.png differ