X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=capi%2Fdali-toolkit%2Fpublic-api%2Fshader-effects%2Fpage-turn-effect.h;h=124777c7349dbeda037c4f06db447f82221b0273;hp=97f5c38628a81d3c03868ea970ab8040d700d702;hb=e2e00e5c207b546067d57a0a747f4803a18c27bd;hpb=e2eda444afbe82e9591fe198eef339227f90a616 diff --git a/capi/dali-toolkit/public-api/shader-effects/page-turn-effect.h b/capi/dali-toolkit/public-api/shader-effects/page-turn-effect.h index 97f5c38..124777c 100644 --- a/capi/dali-toolkit/public-api/shader-effects/page-turn-effect.h +++ b/capi/dali-toolkit/public-api/shader-effects/page-turn-effect.h @@ -18,7 +18,7 @@ // /** - * @addtogroup CAPI_DALI_FRAMEWORK + * @addtogroup CAPI_DALI_TOOLKIT_SHADER_EFFECTS_MODULE * @{ */ @@ -35,14 +35,14 @@ namespace Internal DALI_INTERNAL { /** - * PageTurnEffect implementation class + * @brief PageTurnEffect implementation class. */ class PageTurnEffect; } // namespace Internal /** - * PageTurnEffect is a custom shader effect to achieve page turn effect for Image actors + * @brief PageTurnEffect is a custom shader effect to achieve page turn effect for Image actors. * * Usage example:- * @@ -76,18 +76,20 @@ class PageTurnEffect : public ShaderEffect { public: /** - * Create an uninitialized PageTurnEffect; this can be initialized with PageTurnEffect::New() + * @brief Create an uninitialized PageTurnEffect; this can be initialized with PageTurnEffect::New(). + * * Calling member functions with an uninitialized Dali::Object is not allowed. */ PageTurnEffect(); /** - * Virtual destructor. + * @brief Virtual destructor. */ virtual ~PageTurnEffect(); /** - * Create an initialized PageTurnEffect. + * @brief Create an initialized PageTurnEffect. + * * If fake shadow is used, need to apply the ShaderEffect::HINT_BLENDING * @param[in] enableBlending If true, apply HINT_BLENDING when creating the shader object; If false, disable the HINT_BLENDING * @return A handle to a newly allocated Dali resource. @@ -95,37 +97,43 @@ public: static PageTurnEffect New( bool enableBlending = true ); /** - * Set the page size of the PageTurnEffect. + * @brief Set the page size of the PageTurnEffect. + * * @param [in] pageSize The page size. */ void SetPageSize(const Vector2& pageSize); /** - * Set the origin point of the PageTurnEffect, the position where the mouse/finger is pushed from. + * @brief Set the origin point of the PageTurnEffect, the position where the mouse/finger is pushed from. + * * @param [in] originalCenter The new origin point. */ void SetOriginalCenter(const Vector2& originalCenter); /** - * Set the center point of the PageTurnEffect, the current position of touch motion. + * @brief Set the center point of the PageTurnEffect, the current position of touch motion. + * * @param [in] currentCenter The new center point. */ void SetCurrentCenter(const Vector2& currentCenter); /** - * Set whether the current page is turning forward or backward + * @brief Set whether the current page is turning forward or backward. + * * @param [in] isTurningBack True for turning backward or False for turning forward */ void SetIsTurningBack(bool isTurningBack); /** - * Set the width of shadow to be pageSize * shadowWidth + * @brief Set the width of shadow to be pageSize * shadowWidth. + * * @param [in] shadowWidth The width for the simulated shadow */ void SetShadowWidth(float shadowWidth); /** - * Set the spine shadow parameter + * @brief Set the spine shadow parameter. + * * The two parameters are the major&minor radius (in pixels) to form an ellipse shape * The top-left quarter of this ellipse is used to calculate spine normal for simulating shadow * @param [in] spineShadowParameter The major&minor ellipse radius for the simulated spine shadow @@ -133,19 +141,22 @@ public: void SetSpineShadowParameter(const Vector2& spineShadowParameter); /** - * Get the name for the page size property + * @brief Get the name for the page size property. + * * @return A std::string containing the property name */ const std::string& GetPageSizePropertyName() const; /** - * Get the name for the origin center property + * @brief Get the name for the origin center property. + * * @return A std::string containing the property name */ const std::string& GetOriginalCenterPropertyName() const; /** - * Get the name for the current center property + * @brief Get the name for the current center property. + * * which can be used in Animation API's * @return A std::string containing the property name */