xartigas pushed a commit to branch master.

http://git.enlightenment.org/core/efl.git/commit/?id=0e71e0e286d97c4aaee76f1c079e2f00fc616cbf

commit 0e71e0e286d97c4aaee76f1c079e2f00fc616cbf
Author: Xavi Artigas <xavierarti...@yahoo.es>
Date:   Wed Oct 30 15:26:08 2019 +0100

    docs: Polish Efl.Canvas.Animation_Group and sons
    
    Summary: These docs were almost empty.
    
    Reviewers: bu5hm4n, zmike, cedric, Jaehyun_Cho
    
    Reviewed By: cedric
    
    Subscribers: #reviewers, #committers
    
    Tags: #efl
    
    Differential Revision: https://phab.enlightenment.org/D10564
---
 src/lib/evas/canvas/efl_canvas_animation_group.eo     | 19 ++++++++++++-------
 .../canvas/efl_canvas_animation_group_parallel.eo     |  9 ++++++++-
 .../canvas/efl_canvas_animation_group_sequential.eo   | 10 +++++++++-
 3 files changed, 29 insertions(+), 9 deletions(-)

diff --git a/src/lib/evas/canvas/efl_canvas_animation_group.eo 
b/src/lib/evas/canvas/efl_canvas_animation_group.eo
index fdf42e2d88..f9cada25a7 100644
--- a/src/lib/evas/canvas/efl_canvas_animation_group.eo
+++ b/src/lib/evas/canvas/efl_canvas_animation_group.eo
@@ -1,24 +1,29 @@
 abstract @beta Efl.Canvas.Animation_Group extends Efl.Canvas.Animation
 {
-   [[Efl group animation abstract class]]
+   [[Base class for combined animations (groups of animations that are played 
together).
+
+     This class provides methods to add, remove and retrieve individual 
animations from the group.
+   
+     See for example @Efl.Canvas.Animation_Group_Parallel and 
@Efl.Canvas.Animation_Group_Sequential.
+   ]]
    c_prefix: efl_animation_group;
    data: Efl_Canvas_Animation_Group_Data;
    methods {
       animation_add {
-         [[Add the given animation to the animation group.]]
+         [[Adds the given animation to the animation group.]]
          params {
-            @in animation: Efl.Canvas.Animation; [[The animation which needs 
to be added to the animation group]]
+            @in animation: Efl.Canvas.Animation; [[Animation to add to the 
group.]]
          }
       }
       animation_del {
-         [[Delete the given animation from the animation group.]]
+         [[Removes the given animation from the animation group.]]
          params {
-            @in animation: Efl.Canvas.Animation; [[The animation which needs 
to be deleted from the animation group]]
+            @in animation: Efl.Canvas.Animation; [[Animation to remove from 
the group.]]
          }
       }
       animations_get @const {
-         [[Get the animations of the animation group.]]
-         return: list<Efl.Canvas.Animation>; [[The animations of the animation 
group]]
+         [[Gets the list of animations currently in the animation group.]]
+         return: list<Efl.Canvas.Animation>; [[List of animations in the 
group.]]
       }
    }
    implements {
diff --git a/src/lib/evas/canvas/efl_canvas_animation_group_parallel.eo 
b/src/lib/evas/canvas/efl_canvas_animation_group_parallel.eo
index 63773ddac3..e0434e7ad4 100644
--- a/src/lib/evas/canvas/efl_canvas_animation_group_parallel.eo
+++ b/src/lib/evas/canvas/efl_canvas_animation_group_parallel.eo
@@ -1,6 +1,13 @@
 class @beta Efl.Canvas.Animation_Group_Parallel extends 
Efl.Canvas.Animation_Group
 {
-   [[Efl group parallel animation class]]
+   [[Combined animation which plays its individual animations in parallel
+     (all of them simultaneously).
+
+     For instance, this could be used to move an @Efl.Canvas.Object from one 
position to another
+     while rotating it along the way.
+
+     Use @Efl.Canvas.Animation_Group.animation_add to append individual 
animations.
+   ]]
    c_prefix: efl_animation_group_parallel;
    data: null;
    methods {
diff --git a/src/lib/evas/canvas/efl_canvas_animation_group_sequential.eo 
b/src/lib/evas/canvas/efl_canvas_animation_group_sequential.eo
index 415a87f999..aebd70ede5 100644
--- a/src/lib/evas/canvas/efl_canvas_animation_group_sequential.eo
+++ b/src/lib/evas/canvas/efl_canvas_animation_group_sequential.eo
@@ -1,6 +1,14 @@
 class @beta Efl.Canvas.Animation_Group_Sequential extends 
Efl.Canvas.Animation_Group
 {
-   [[Efl group sequential animation class]]
+   [[Combined animation which plays its individual animations in a sequential 
order
+     (one after the other).
+
+     For instance, this could be used to move an @Efl.Canvas.Object from one 
position to another
+     and then start rotating it once it reaches its destination.
+
+     Use @Efl.Canvas.Animation_Group.animation_add to append individual 
animations.
+     Animations are played in the order in which they are added.
+   ]]
    data: null;
    methods {
    }

-- 


Reply via email to