kimcinoo
/
efl
forked from enlightenment/efl
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: Improve Spotlight.Animation_Manager docs

This commit is contained in:
Xavi Artigas 2020-03-17 11:39:41 +01:00
parent 60f8495d80
commit 84e561f4dd
1 changed files with 33 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
src/lib/elementary/efl_ui_spotlight_animation_manager.eo
View File

@ -1,51 +1,62 @@
class @beta Efl.Ui.Spotlight.Animation_Manager extends Efl.Ui.Spotlight.Manager
{
[[A spotlight manager that uses animation objects to react to different @Efl.Ui.Spotlight.Manager.switch_to situations.
[[A spotlight manager that uses animation objects to react to different @Efl.Ui.Spotlight.Manager.switch_to
situations.
Animations are played forward when they are on the $to argument, they are played backward when they are on the $from argument.
Animations are played forward when they are on the $to argument and they are played backward when they are on the
$from argument.
Pop animations are always played backwards, Push animations are always played forward.
Reason for this is, the reusability. You should be able to pass in 1 animation to all sitatuations, which should cover the turn arround effect that "moving in" and "moving out" has. This means, when you have a alpha channel animation, the pop animation can be the same as the jump-in and out animation, and both will look like fading out.
The reason for this is reusability: you can use the same animation in all situations and this covers the
inverted effect that "moving in" and "moving out" has.
For example, when you have an alpha channel animation, the Pop animation can be the same as the Jump-In and Out
animation, and both will look like fading out.
]]
c_prefix: efl_ui_spotlight_manager_animation;
methods {
@property push_setup{
[[Animation that is used to animate the $to argument of a switch_to request when the passed $reason is push.
@property push_setup {
[[Animation that is used to animate the $to argument of a @Efl.Ui.Spotlight.Manager.switch_to request when
the passed $reason is @Efl.Ui.Spotlight.Manager_Switch_Reason.push.
If these animations are $null, then the $in and $out animation of @.jump_setup will be taken instead.
If these animations are $null, then the $in and $out animation of @.jump_setup will be used instead.
]]
values {
in : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference]]
out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference. Can be the same as $in.]]
out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference.
Can be the same as $in.]]
}
set { }
set {}
}
@property pop_setup{
[[Animation that is used to animate the $from argument of a switch_to request when the passed $reason is pop.
Note: this animations is always played backwards, see the class documentation for the reasoning.
@property pop_setup {
[[Animation that is used to animate the $from argument of a @Efl.Ui.Spotlight.Manager.switch_to request when
the passed $reason is @Efl.Ui.Spotlight.Manager_Switch_Reason.pop.
If these animations are $null, then the $in and $out animation of @.jump_setup will be taken instead.
Note: These animations are always played backwards, see the class documentation for the reasoning.
If these animations are $null, then the $in and $out animation of @.jump_setup will be used instead.
]]
values {
in : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference]]
out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference. Can be the same as $in.]]
out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference.
Can be the same as $in.]]
}
set { }
set {}
}
@property jump_setup{
[[Set the animation objects you want to play on a jump in or jump out.
When a switch to request is issued, two arguments are getting animated. The $from object, and the $to objects. The $from object will be playing the out animation. The $pop object will be playing the in animation.
@property jump_setup {
[[Sets the animation objects you want to play on a jump in or jump out.
The out animation will always be played backwards, this is to support passing the same animation object to both parameters. (A fade animation will fade in the new object, and fade out the old object).
When a @Efl.Ui.Spotlight.Manager.switch_to request is issued, two arguments are getting animated.
The $from object, and the $to object. The $from object will play the $out animation whereas the $to object
will play the $in animation.
The $out animation will always be played backwards. See the class documentation for the reasoning.
]]
values {
in : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference]]
out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference. Can be the same as $in.]]
out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference.
Can be the same as $in.]]
}
set {