/*
- * Copyright(c) 2019 Samsung Electronics Co., Ltd.
+ * Copyright(c) 2020 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.
using global::System.Runtime.InteropServices;
using System.ComponentModel;
using System.Collections.Generic;
-
-#if (NUI_DEBUG_ON)
-using tlog = Tizen.Log;
-#endif
+using System.Globalization;
namespace Tizen.NUI.BaseComponents
{
/// <summary>
/// LottieAnimationView renders an animated vector image (Lottie file).
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
- public class LottieAnimationView : ImageView
+ /// <since_tizen> 7 </since_tizen>
+ public partial class LottieAnimationView : ImageView
{
- #region Constructor, Distructor, Dispose
+ #region Constructor, Destructor, Dispose
/// <summary>
- /// LottieAnimationView
+ /// LottieAnimationView constructor
/// </summary>
/// <param name="scale">The factor of scaling image, default : 1.0f</param>
- /// <param name="shown">false : Not displayed (hidden), true : displayed (shown), default : true</param>
- /// This will be public opened in next release of tizen after ACR done. Before ACR, it is used as HiddenAPI (InhouseAPI).
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <param name="shown">false : not displayed (hidden), true : displayed (shown), default : true</param>
+ /// <remarks>
+ /// If the shown parameter is false, the animation is not visible even if the LottieAnimationView instance is created.
+ /// </remarks>
+ /// <example>
+ /// <code>
+ /// LottieAnimationView myLottie = new LottieAnimationView();
+ /// LottieAnimationView myLottie2 = new LottieAnimationView(2.0f);
+ /// LottieAnimationView myLottie3 = new LottieAnimationView(1.0f, false);
+ /// </code>
+ /// </example>
+ /// <since_tizen> 7 </since_tizen>
public LottieAnimationView(float scale = 1.0f, bool shown = true) : base()
{
- tlog.Fatal(tag, $"< constructor GetId={GetId()} >");
+ ActionPlay = Interop.LottieAnimationView.AnimatedVectorImageVisualActionPlayGet();
+ ActionPause = Interop.LottieAnimationView.AnimatedVectorImageVisualActionPauseGet();
+ ActionStop = Interop.LottieAnimationView.AnimatedVectorImageVisualActionStopGet();
+
+ NUILog.Debug($"< constructor GetId={GetId()} >");
currentStates.url = "";
currentStates.frame = -1;
currentStates.loopCount = 1;
currentStates.changed = false;
currentStates.totalFrame = -1;
currentStates.scale = scale;
+ currentStates.redrawInScalingDown = true;
SetVisible(shown);
}
return;
}
- tlog.Fatal(tag, $"<[{GetId()}] type={type}");
-
//Release your own unmanaged resources here.
//You should not access any managed member here except static instance.
//because the execution order of Finalizes is non-deterministic.
{
VisualEventSignal().Disconnect(visualEventSignalCallback);
finishedEventHandler = null;
- tlog.Fatal(tag, $"disconnect event signal");
+ NUILog.Debug($"disconnect event signal");
}
base.Dispose(type);
- tlog.Fatal(tag, $"[{GetId()}]>");
}
- #endregion Constructor, Distructor, Dispose
+ #endregion Constructor, Destructor, Dispose
#region Property
/// <summary>
- /// URL
+ /// Set or Get resource URL of Lottie file.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public string URL
{
+ get
+ {
+ return GetValue(URLProperty) as string;
+ }
+ set
+ {
+ SetValue(URLProperty, value);
+ NotifyPropertyChanged();
+ }
+ }
+
+ private string InternalURL
+ {
set
{
string ret = (value == null ? "" : value);
currentStates.url = ret;
currentStates.changed = true;
- tlog.Fatal(tag, $"<[{GetId()}]SET url={currentStates.url}");
+ NUILog.Debug($"<[{GetId()}]SET url={currentStates.url}");
PropertyMap map = new PropertyMap();
map.Add(Visual.Property.Type, new PropertyValue((int)DevelVisual.Type.AnimatedVectorImage))
currentStates.contentInfo = null;
- if(currentStates.scale != 1.0f)
+ if (currentStates.scale != 1.0f)
{
Scale = new Vector3(currentStates.scale, currentStates.scale, 0.0f);
}
- tlog.Fatal(tag, $"<[{GetId()}]>");
+ NUILog.Debug($"<[{GetId()}]>");
}
get
{
string ret = currentStates.url;
- tlog.Fatal(tag, $"<[{GetId()}] GET");
+ NUILog.Debug($"<[{GetId()}] GET");
- PropertyMap map = Image;
+ PropertyMap map = base.Image;
if (map != null)
{
PropertyValue val = map.Find(ImageVisualProperty.URL);
{
if (val.Get(out ret))
{
- tlog.Fatal(tag, $"gotten url={ret} >");
+ NUILog.Debug($"gotten url={ret} >");
return ret;
}
}
}
/// <summary>
- /// The playing state
+ /// Gets the playing state
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public PlayStateType PlayState
{
get
{
- tlog.Fatal(tag, $"< Get!");
+ NUILog.Debug($"< Get!");
PropertyMap map = base.Image;
var ret = 0;
if (map != null)
if (val.Get(out ret))
{
currentStates.playState = (PlayStateType)ret;
- tlog.Fatal(tag, $"gotten play state={ret} >");
- return currentStates.playState;
+ NUILog.Debug($"gotten play state={ret} >");
}
}
}
- Tizen.Log.Error(tag, $"<[ERROR][{GetId()}]Fail to get PlayState from dali currentStates.playState={currentStates.playState}>");
+ else
+ {
+ Tizen.Log.Error(tag, $"<[ERROR][{GetId()}]Fail to get PlayState from dali currentStates.playState={currentStates.playState}>");
+ }
return currentStates.playState;
}
}
/// <summary>
- /// The number of total frame
+ /// Get the number of total frames
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public int TotalFrame
{
get
{
int ret = -1;
- PropertyMap map = Image;
+ PropertyMap map = base.Image;
if (map != null)
{
PropertyValue val = map.Find(ImageVisualProperty.TotalFrameNumber);
{
if (val.Get(out ret))
{
- //tlog.Fatal(tag, $"TotalFrameNumber get! ret={ret}");
+ //NUILog.Debug( $"TotalFrameNumber get! ret={ret}");
currentStates.totalFrame = ret;
return ret;
}
}
/// <summary>
- /// CurrentFrameNumber
+ /// Set or get the current frame. When setting a specific frame, it is displayed as a still image.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <remarks>
+ /// Gets the value set by a user. If the setting value is out-ranged, it is reset as a minimum frame or a maximum frame.
+ /// </remarks>
+ /// <example>
+ /// We assume that the animation in myLottie.json file has 100 frames originally. If so, its frame index will be 0 - 99.
+ /// <code>
+ /// LottieAnimationView myLottie = new LottieAnimationView();
+ /// myLottie.URL = Tizen.Applications.Application.Current.DirectoryInfo.Resource + "myLottie.json"; //myLottie.json's total frame is 100 (frame: 0~99)
+ /// NUIApplication.GetDefaultWindow().GetDefaultLayer().Add(myLottie);
+ /// myLottie.CurrentFrame = 200; //display 99 frame
+ /// myLottie.SetMinMaxFrame(10, 20);
+ /// myLottie.CurrentFrame = 15; //display 15 frame
+ /// myLottie.CurrentFrame = 50; //display 20 frame, because the MinMax is set (10,20) above
+ /// </code>
+ /// </example>
+ /// <since_tizen> 7 </since_tizen>
public int CurrentFrame
{
+ get
+ {
+ return (int)GetValue(CurrentFrameProperty);
+ }
+ set
+ {
+ SetValue(CurrentFrameProperty, value);
+ NotifyPropertyChanged();
+ }
+ }
+
+ private int InternalCurrentFrame
+ {
set
{
currentStates.frame = value;
- tlog.Fatal(tag, $"<[{GetId()}]SET frame={currentStates.frame}>");
- DoAction(vectorImageVisualIndex, (int)actionType.jumpTo, new PropertyValue(currentStates.frame));
+ NUILog.Debug($"<[{GetId()}]SET frame={currentStates.frame}>");
+ DoAction(ImageView.Property.IMAGE, ActionJumpTo, new PropertyValue(currentStates.frame));
}
get
{
int ret = 0;
- PropertyMap map = Image;
+ PropertyMap map = base.Image;
if (map != null)
{
PropertyValue val = map.Find(ImageVisualProperty.CurrentFrameNumber);
{
if (val.Get(out ret))
{
- //tlog.Fatal(tag, $"CurrentFrameNumber get! val={ret}");
+ //NUILog.Debug( $"CurrentFrameNumber get! val={ret}");
return ret;
}
}
}
/// <summary>
- /// Loop Mode of animation.
+ /// Sets or gets the looping mode of Lottie animation.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public LoopingModeType LoopingMode
{
+ get
+ {
+ return (LoopingModeType)GetValue(LoopingModeProperty);
+ }
+ set
+ {
+ SetValue(LoopingModeProperty, value);
+ NotifyPropertyChanged();
+ }
+ }
+
+ private LoopingModeType InternalLoopingMode
+ {
set
{
currentStates.loopMode = (LoopingModeType)value;
currentStates.changed = true;
- tlog.Fatal(tag, $"<[{GetId()}] SET loopMode={currentStates.loopMode}>");
+ NUILog.Debug($"<[{GetId()}] SET loopMode={currentStates.loopMode}>");
PropertyMap map = new PropertyMap();
map.Add(ImageVisualProperty.LoopingMode, new PropertyValue((int)currentStates.loopMode));
- DoAction(vectorImageVisualIndex, (int)actionType.updateProperty, new PropertyValue(map));
+ DoAction(ImageView.Property.IMAGE, ActionUpdateProperty, new PropertyValue(map));
}
get
{
- //tlog.Fatal(tag, $"LoopMode get!");
+ //NUILog.Debug( $"LoopMode get!");
PropertyMap map = base.Image;
var ret = 0;
if (map != null)
{
if (val.Get(out ret))
{
- //tlog.Fatal(tag, $"gotten LoopMode={ret}");
+ //NUILog.Debug( $"gotten LoopMode={ret}");
if (ret != (int)currentStates.loopMode && ret > 0)
{
- tlog.Fatal(tag, $" [ERROR][{GetId()}](LottieAnimationView) different LoopMode! gotten={ret}, loopMode={currentStates.loopMode}");
+ NUILog.Debug($" [ERROR][{GetId()}](LottieAnimationView) different LoopMode! gotten={ret}, loopMode={currentStates.loopMode}");
}
currentStates.loopMode = (LoopingModeType)ret;
return (LoopingModeType)ret;
}
/// <summary>
- /// LoopCount
+ /// Sets or gets the loop count.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <remarks>
+ /// The minus value means the infinite loop count.
+ /// </remarks>
+ /// <example>
+ /// <code>
+ /// LottieAnimationView myLottie = new LottieAnimationView();
+ /// myLottie.URL = Tizen.Applications.Application.Current.DirectoryInfo.Resource + "myLottie.json"; //myLottie.json's total frame is 100 (frame: 0~99)
+ /// NUIApplication.GetDefaultWindow().GetDefaultLayer().Add(myLottie);
+ /// myLottie.LoopCount = -1; //infinite loop
+ /// myLottie.Play();
+ /// myLottie.Stop(); //it plays continuously unless Stop() is called
+ /// myLottie.LoopCount = 2;
+ /// myLottie.Play(); //it plays only 2 times and stops automatically
+ /// </code>
+ /// </example>
+ /// <since_tizen> 7 </since_tizen>
public int LoopCount
{
+ get
+ {
+ return (int)GetValue(LoopCountProperty);
+ }
+ set
+ {
+ SetValue(LoopCountProperty, value);
+ NotifyPropertyChanged();
+ }
+ }
+
+ private int InternalLoopCount
+ {
set
{
currentStates.changed = true;
currentStates.loopCount = value;
- tlog.Fatal(tag, $"<[{GetId()}]SET currentStates.loopCount={currentStates.loopCount}>");
+ NUILog.Debug($"<[{GetId()}]SET currentStates.loopCount={currentStates.loopCount}>");
PropertyMap map = new PropertyMap();
map.Add(ImageVisualProperty.LoopCount, new PropertyValue(currentStates.loopCount));
- DoAction(vectorImageVisualIndex, (int)actionType.updateProperty, new PropertyValue(map));
+ DoAction(ImageView.Property.IMAGE, ActionUpdateProperty, new PropertyValue(map));
}
get
{
- //tlog.Fatal(tag, $"LoopCount get!");
+ //NUILog.Debug( $"LoopCount get!");
PropertyMap map = base.Image;
var ret = 0;
if (map != null)
{
if (val.Get(out ret))
{
- //tlog.Fatal(tag, $"gotten loop count={ret}");
+ //NUILog.Debug( $"gotten loop count={ret}");
if (ret != currentStates.loopCount && ret > 0)
{
- tlog.Fatal(tag, $"<[ERROR][{GetId()}](LottieAnimationView) different loop count! gotten={ret}, loopCount={currentStates.loopCount}>");
+ NUILog.Debug($"<[ERROR][{GetId()}](LottieAnimationView) different loop count! gotten={ret}, loopCount={currentStates.loopCount}>");
}
currentStates.loopCount = ret;
return currentStates.loopCount;
}
/// <summary>
- /// Stop Behavior (Stop End Action)
+ /// Sets or gets the stop behavior.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public StopBehaviorType StopBehavior
{
+ get
+ {
+ return (StopBehaviorType)GetValue(StopBehaviorProperty);
+ }
+ set
+ {
+ SetValue(StopBehaviorProperty, value);
+ NotifyPropertyChanged();
+ }
+ }
+
+ private StopBehaviorType InternalStopBehavior
+ {
set
{
currentStates.stopEndAction = (StopBehaviorType)value;
currentStates.changed = true;
- tlog.Fatal(tag, $"<[{GetId()}]SET val={currentStates.stopEndAction}>");
+ NUILog.Debug($"<[{GetId()}]SET val={currentStates.stopEndAction}>");
PropertyMap map = new PropertyMap();
map.Add(ImageVisualProperty.StopBehavior, new PropertyValue((int)currentStates.stopEndAction));
- DoAction(vectorImageVisualIndex, (int)actionType.updateProperty, new PropertyValue(map));
+ DoAction(ImageView.Property.IMAGE, ActionUpdateProperty, new PropertyValue(map));
}
get
{
- //tlog.Fatal(tag, $"StopBehavior get!");
+ //NUILog.Debug( $"StopBehavior get!");
PropertyMap map = base.Image;
var ret = 0;
if (map != null)
{
if (val.Get(out ret))
{
- //tlog.Fatal(tag, $"gotten StopBehavior={ret}");
+ //NUILog.Debug( $"gotten StopBehavior={ret}");
if (ret != (int)currentStates.stopEndAction)
{
- tlog.Fatal(tag, $"<[ERROR][{GetId()}](LottieAnimationView) different StopBehavior! gotten={ret}, StopBehavior={currentStates.stopEndAction}>");
+ NUILog.Debug($"<[ERROR][{GetId()}](LottieAnimationView) different StopBehavior! gotten={ret}, StopBehavior={currentStates.stopEndAction}>");
}
currentStates.stopEndAction = (StopBehaviorType)ret;
return (StopBehaviorType)ret;
return currentStates.stopEndAction;
}
}
+
+ /// <summary>
+ /// Whether to redraw the image when the visual is scaled down.
+ /// </summary>
+ /// <remarks>
+ /// Inhouse API.
+ /// It is used in the AnimatedVectorImageVisual.The default is true.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public bool RedrawInScalingDown
+ {
+ get
+ {
+ return (bool)GetValue(RedrawInScalingDownProperty);
+ }
+ set
+ {
+ SetValue(RedrawInScalingDownProperty, value);
+ NotifyPropertyChanged();
+ }
+ }
+
+ private bool InternalRedrawInScalingDown
+ {
+ set
+ {
+ currentStates.changed = true;
+ currentStates.redrawInScalingDown = value;
+ NUILog.Debug($"<[{GetId()}]SET currentStates.redrawInScalingDown={currentStates.redrawInScalingDown}>");
+ PropertyMap map = new PropertyMap();
+ map.Add(ImageVisualProperty.RedrawInScalingDown, new PropertyValue(currentStates.redrawInScalingDown));
+ DoAction(ImageView.Property.IMAGE, ActionUpdateProperty, new PropertyValue(map));
+ }
+ get
+ {
+ PropertyMap map = base.Image;
+ var ret = true;
+ if (map != null)
+ {
+ PropertyValue val = map.Find(ImageVisualProperty.RedrawInScalingDown);
+ if (val != null)
+ {
+ if (val.Get(out ret))
+ {
+ if (ret != currentStates.redrawInScalingDown)
+ {
+ NUILog.Debug($"<[ERROR][{GetId()}](LottieAnimationView) different redrawInScalingDown! gotten={ret}, redrawInScalingDown={currentStates.redrawInScalingDown}>");
+ }
+ currentStates.redrawInScalingDown = ret;
+ return currentStates.redrawInScalingDown;
+ }
+ }
+ }
+ Tizen.Log.Error(tag, $"<[ERROR][{GetId()}](LottieAnimationView) Fail to get redrawInScalingDown from dali currentStates.redrawInScalingDown={currentStates.redrawInScalingDown}>");
+ return currentStates.redrawInScalingDown;
+ }
+ }
+
+
+ /// <summary>
+ /// Actions property value to Jump to the specified frame.
+ /// This property can be redefined by child class if it use different value.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ protected int ActionJumpTo { get; set; } = Interop.LottieAnimationView.AnimatedVectorImageVisualActionJumpToGet();
#endregion Property
#region Method
/// <summary>
- /// SetMinMaxFrame(int startFrame, int endFrame)
+ /// Set the minimum and the maximum frame.
/// </summary>
- /// <param name="minFrame"></param>
- /// <param name="maxFrame"></param>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <param name="minFrame">minimum frame</param>
+ /// <param name="maxFrame">maximum frame</param>
+ /// <since_tizen> 7 </since_tizen>
public void SetMinMaxFrame(int minFrame, int maxFrame)
{
- tlog.Fatal(tag, $"< [{GetId()}] SetPlayRange({minFrame}, {maxFrame})");
+ NUILog.Debug($"< [{GetId()}] SetPlayRange({minFrame}, {maxFrame})");
currentStates.changed = true;
currentStates.framePlayRangeMin = minFrame;
PropertyMap map = new PropertyMap();
map.Add(ImageVisualProperty.PlayRange, new PropertyValue(array));
- DoAction(vectorImageVisualIndex, (int)actionType.updateProperty, new PropertyValue(map));
- tlog.Fatal(tag, $" [{GetId()}] currentStates.min:({currentStates.framePlayRangeMin}, max:{currentStates.framePlayRangeMax})>");
+ DoAction(ImageView.Property.IMAGE, ActionUpdateProperty, new PropertyValue(map));
+ NUILog.Debug($" [{GetId()}] currentStates.min:({currentStates.framePlayRangeMin}, max:{currentStates.framePlayRangeMax})>");
}
/// <summary>
/// Play Animation.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public new void Play()
{
- tlog.Fatal(tag, $"<[{GetId()}] Play()");
+ NUILog.Debug($"<[{GetId()}] Play()");
debugPrint();
base.Play();
- tlog.Fatal(tag, $"[{GetId()}]>");
+ NUILog.Debug($"[{GetId()}]>");
}
/// <summary>
/// Pause Animation.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public new void Pause()
{
- tlog.Fatal(tag, $"<[{GetId()}] Pause()>");
+ NUILog.Debug($"<[{GetId()}] Pause()>");
debugPrint();
base.Pause();
- tlog.Fatal(tag, $"[{GetId()}]>");
+ NUILog.Debug($"[{GetId()}]>");
}
/// <summary>
/// Stop Animation.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public new void Stop()
{
- tlog.Fatal(tag, $"<[{GetId()}] Stop()");
+ NUILog.Debug($"<[{GetId()}] Stop()");
debugPrint();
base.Stop();
- tlog.Fatal(tag, $"[{GetId()}]>");
+ NUILog.Debug($"[{GetId()}]>");
}
/// <summary>
- /// GetContentInfo()
+ /// Get the list of layers' information such as the start frame and the end frame in the Lottie file.
/// </summary>
- /// <returns>list of Tuple (string of layer name, integer of start frame, integer of end frame)</returns>
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <returns>List of Tuple (string of layer name, integer of start frame, integer of end frame)</returns>
+ /// <since_tizen> 7 </since_tizen>
public List<Tuple<string, int, int>> GetContentInfo()
{
- tlog.Fatal(tag, $"<");
- if(currentStates.contentInfo != null)
+ NUILog.Debug($"<");
+ if (currentStates.contentInfo != null)
{
return currentStates.contentInfo;
}
{
if (val.Get(contentMap))
{
+ currentStates.contentInfo = new List<Tuple<string, int, int>>();
for (uint i = 0; i < contentMap.Count(); i++)
{
string key = contentMap.GetKeyAt(i).StringKey;
arr.GetElementAt(0).Get(out startFrame);
arr.GetElementAt(1).Get(out endFrame);
- tlog.Fatal(tag, $"[{i}] layer name={key}, startFrame={startFrame}, endFrame={endFrame}");
+ NUILog.Debug($"[{i}] layer name={key}, startFrame={startFrame}, endFrame={endFrame}");
- Tuple<string, int, int> item = new Tuple<string, int, int>(key, startFrame, endFrame );
+ Tuple<string, int, int> item = new Tuple<string, int, int>(key, startFrame, endFrame);
currentStates.contentInfo?.Add(item);
}
}
}
}
- tlog.Fatal(tag, $">");
+ NUILog.Debug($">");
return currentStates.contentInfo;
}
- #endregion Method
+ /// <summary>
+ /// A marker has its start frame and end frame.
+ /// Animation will play between the start frame and the end frame of the marker if one marker is specified.
+ /// Or animation will play between the start frame of the first marker and the end frame of the second marker if two markers are specified. *
+ /// </summary>
+ /// <param name="marker1">First marker</param>
+ /// <param name="marker2">Second marker</param>
+ // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public void SetMinMaxFrameByMarker(string marker1, string marker2 = null)
+ {
+ NUILog.Debug($"< [{GetId()}] SetMinMaxFrameByMarker({marker1}, {marker2})");
+
+ currentStates.changed = true;
+ currentStates.mark1 = marker1;
+ currentStates.mark2 = marker2;
+
+ PropertyArray array = new PropertyArray();
+ array.PushBack(new PropertyValue(currentStates.mark1));
+ if (marker2 != null)
+ {
+ array.PushBack(new PropertyValue(currentStates.mark2));
+ }
+
+ PropertyMap map = new PropertyMap();
+ map.Add(ImageVisualProperty.PlayRange, new PropertyValue(array));
+ DoAction(ImageView.Property.IMAGE, ActionUpdateProperty, new PropertyValue(map));
+ NUILog.Debug($" [{GetId()}] currentStates.mark1:{currentStates.mark1}, mark2:{currentStates.mark2} >");
+ }
- #region Event, Enum, Struct, ETC
/// <summary>
- /// Animation finished event
+ /// Get MinMax Frame
/// </summary>
+ /// <returns>Tuple of Min and Max frames</returns>
// This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
[EditorBrowsable(EditorBrowsableState.Never)]
+ public Tuple<int, int> GetMinMaxFrame()
+ {
+ NUILog.Debug($"< [{GetId()}] GetMinMaxFrame()! total frame={currentStates.totalFrame}");
+
+ PropertyMap map = Image;
+ if (map != null)
+ {
+ PropertyValue val = map.Find(ImageVisualProperty.PlayRange);
+ if (val != null)
+ {
+ PropertyArray array = new PropertyArray();
+ if (val.Get(array))
+ {
+ uint cnt = array.Count();
+ int item1 = -1, item2 = -1;
+ for (uint i = 0; i < cnt; i++)
+ {
+ PropertyValue v = array.GetElementAt(i);
+ int intRet;
+ if (v.Get(out intRet))
+ {
+ NUILog.Debug($"Got play range of string [{i}]: {intRet}");
+ if (i == 0)
+ {
+ item1 = intRet;
+ }
+ else if (i == 1)
+ {
+ item2 = intRet;
+ }
+ }
+ else
+ {
+ Tizen.Log.Error("NUI", $"[ERR] fail to get play range from dali! case#1");
+ }
+ }
+ NUILog.Debug($" [{GetId()}] GetMinMaxFrame(min:{item1}, max:{item2})! >");
+ return new Tuple<int, int>(item1, item2);
+ }
+ }
+ }
+ Tizen.Log.Error("NUI", $"[ERR] fail to get play range from dali! case#2");
+ return new Tuple<int, int>(-1, -1);
+ }
+ #endregion Method
+
+
+ #region Event, Enum, Struct, ETC
+ /// <summary>
+ /// Animation finished event.
+ /// </summary>
+ /// <since_tizen> 7 </since_tizen>
public event EventHandler Finished
{
add
{
if (finishedEventHandler == null)
{
- tlog.Fatal(tag, $"<[{GetId()}] Finished eventhandler added>");
+ NUILog.Debug($"<[{GetId()}] Finished eventhandler added>");
visualEventSignalCallback = onVisualEventSignal;
VisualEventSignal().Connect(visualEventSignalCallback);
}
}
remove
{
- tlog.Fatal(tag, $"<[{GetId()}] Finished eventhandler removed>");
+ NUILog.Debug($"<[{GetId()}] Finished eventhandler removed>");
finishedEventHandler -= value;
if (finishedEventHandler == null && visualEventSignalCallback != null)
{
/// <summary>
/// Enumeration for what state the vector animation is in
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public enum PlayStateType
{
/// <summary>
/// Invalid
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
Invalid = -1,
/// <summary>
/// Vector Animation has stopped
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
Stopped = 0,
/// <summary>
/// The vector animation is playing
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
Playing = 1,
/// <summary>
/// The vector animation is paused
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
Paused = 2
}
/// <summary>
- /// @brief Enumeration for what to do when the animation is stopped.
+ /// Enumeration for what to do when the animation is stopped.
/// </summary>
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
- [EditorBrowsable(EditorBrowsableState.Never)]
+ /// <since_tizen> 7 </since_tizen>
public enum StopBehaviorType
{
/// <summary>
/// When the animation is stopped, the current frame is shown.
/// </summary>
- [EditorBrowsable(EditorBrowsableState.Never)]
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ /// <since_tizen> 7 </since_tizen>
CurrentFrame,
/// <summary>
/// When the animation is stopped, the min frame (first frame) is shown.
/// </summary>
- [EditorBrowsable(EditorBrowsableState.Never)]
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ /// <since_tizen> 7 </since_tizen>
MinimumFrame,
/// <summary>
/// When the animation is stopped, the max frame (last frame) is shown.
/// </summary>
- [EditorBrowsable(EditorBrowsableState.Never)]
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ /// <since_tizen> 7 </since_tizen>
MaximumFrame
}
/// <summary>
- /// @brief Enumeration for what looping mode is in.
+ /// Enumeration for what looping mode is in.
/// </summary>
- [EditorBrowsable(EditorBrowsableState.Never)]
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ /// <since_tizen> 7 </since_tizen>
public enum LoopingModeType
{
/// <summary>
/// When the animation arrives at the end in looping mode, the animation restarts from the beginning.
/// </summary>
- [EditorBrowsable(EditorBrowsableState.Never)]
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ /// <since_tizen> 7 </since_tizen>
Restart,
/// <summary>
/// When the animation arrives at the end in looping mode, the animation reverses direction and runs backwards again.
/// </summary>
- [EditorBrowsable(EditorBrowsableState.Never)]
- // This will be public opened after ACR done. (Before ACR, need to be hidden as Inhouse API)
+ /// <since_tizen> 7 </since_tizen>
AutoReverse
}
#endregion Event, Enum, Struct, ETC
internal float scale;
internal PlayStateType playState;
internal List<Tuple<string, int, int>> contentInfo;
+ internal string mark1, mark2;
+ internal bool redrawInScalingDown;
};
private states currentStates;
- private enum actionType
- {
- play,
- pause,
- stop,
- jumpTo,
- updateProperty,
- };
-
private struct DevelVisual
{
internal enum Type
}
private const string tag = "NUITEST";
- private const int vectorImageVisualIndex = 10000000 + 1000 + 2;
private event EventHandler finishedEventHandler;
private void OnFinished()
{
- tlog.Fatal(tag, $"<[{GetId()}] OnFinished()>");
+ NUILog.Debug($"<[{GetId()}] OnFinished()>");
finishedEventHandler?.Invoke(this, null);
}
View v = Registry.GetManagedBaseHandleFromNativePtr(targetView) as View;
if (v != null)
{
- tlog.Fatal(tag, $"targetView is not null! name={v.Name}");
+ NUILog.Debug($"targetView is not null! name={v.Name}");
}
else
{
- tlog.Fatal(tag, $"target is something created from dali");
+ NUILog.Debug($"target is something created from dali");
}
}
VisualEventSignalArgs e = new VisualEventSignalArgs();
e.SignalId = signalId;
visualEventSignalHandler?.Invoke(this, e);
- tlog.Fatal(tag, $"<[{GetId()}] onVisualEventSignal()! visualIndex={visualIndex}, signalId={signalId}>");
+ NUILog.Debug($"<[{GetId()}] onVisualEventSignal()! visualIndex={visualIndex}, signalId={signalId}>");
}
[UnmanagedFunctionPointer(CallingConvention.StdCall)]
private void debugPrint()
{
- tlog.Fatal(tag, $"===================================");
- tlog.Fatal(tag, $"<[{GetId()}] get currentStates : url={currentStates.url}, loopCount={currentStates.loopCount}, framePlayRangeMin/Max({currentStates.framePlayRangeMin},{currentStates.framePlayRangeMax}) ");
- tlog.Fatal(tag, $" get from Property : StopBehavior={StopBehavior}, LoopMode={LoopingMode}, LoopCount={LoopCount}, PlayState={PlayState} >");
- tlog.Fatal(tag, $"===================================");
+ NUILog.Debug($"===================================");
+ NUILog.Debug($"<[{GetId()}] get currentStates : url={currentStates.url}, loopCount={currentStates.loopCount}, \nframePlayRangeMin/Max({currentStates.framePlayRangeMin},{currentStates.framePlayRangeMax}) ");
+ NUILog.Debug($" get from Property : StopBehavior={StopBehavior}, LoopMode={LoopingMode}, LoopCount={LoopCount}, PlayState={PlayState}");
+ NUILog.Debug($" RedrawInScalingDown={RedrawInScalingDown} >");
+ NUILog.Debug($"===================================");
}
#endregion Private
}
-}
\ No newline at end of file
+
+ /// <summary>
+ /// A class containing frame informations for a LottieAnimationView.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public class LottieFrameInfo : ICloneable
+ {
+ /// <summary>
+ /// Creates a new instance with a playing range.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public LottieFrameInfo(int startFrame, int endFrame)
+ {
+ StartFrame = startFrame;
+ EndFrame = endFrame;
+ }
+
+ /// <summary>
+ /// Creates a new instance with a still image frame.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public LottieFrameInfo(int stillImageFrame) : this(stillImageFrame, stillImageFrame)
+ {
+ }
+
+ /// <summary>
+ /// Create a new instance from a pair notation.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public static implicit operator LottieFrameInfo((int, int) pair)
+ {
+ return new LottieFrameInfo(pair.Item1, pair.Item2);
+ }
+
+ /// <summary>
+ /// Create a new instance from an int value.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public static implicit operator LottieFrameInfo(int stillImageFrame)
+ {
+ return new LottieFrameInfo(stillImageFrame);
+ }
+
+ /// <summary>
+ /// Create a new instance from string.
+ /// Possible input : "0, 10", "10"
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public static implicit operator LottieFrameInfo(string pair)
+ {
+ if (pair == null)
+ {
+ return null;
+ }
+
+ string[] parts = pair.Split(',');
+ if (parts.Length == 1)
+ {
+ return new LottieFrameInfo(Int32.Parse(parts[0].Trim(), CultureInfo.InvariantCulture));
+ }
+ else if (parts.Length == 2)
+ {
+ return new LottieFrameInfo(Int32.Parse(parts[0].Trim(), CultureInfo.InvariantCulture), Int32.Parse(parts[1].Trim(), CultureInfo.InvariantCulture));
+ }
+
+ Tizen.Log.Error("NUI", $"Can not convert string {pair} to LottieFrameInfo");
+ return null;
+ }
+
+ /// <summary>
+ /// The start frame of the lottie animation.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public int StartFrame { get; }
+
+ /// <summary>
+ /// The end frame of the lottie animation.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public int EndFrame { get; }
+
+ /// <summary>
+ /// Create LottieFrameInfo struct with animation range information
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public static LottieFrameInfo CreateAnimationRange(int startFrame, int endFrame)
+ {
+ return new LottieFrameInfo(startFrame, endFrame);
+ }
+
+ /// <summary>
+ /// Create LottieFrameInfo struct with still image information
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public static LottieFrameInfo CreateStillImage(int stillImageFrame)
+ {
+ return new LottieFrameInfo(stillImageFrame, stillImageFrame);
+ }
+
+ /// <summary>
+ /// Inhouse API.
+ /// Whether this LottieFrameInfo represents one frame or more.
+ /// </summary>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public bool IsStillImage()
+ {
+ return StartFrame == EndFrame;
+ }
+
+ /// <summary>
+ /// Inhouse API.
+ /// Play specified LottieAnimationView with this frame information.
+ /// </summary>
+ /// <param name="lottieView">The target LottieAnimationView to play.</param>
+ /// <param name="noPlay">Whether go direct to the EndFrame. It is false by default.</param>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public void Show(LottieAnimationView lottieView, bool noPlay = false)
+ {
+ if (!BeReadyToShow(lottieView))
+ {
+ return;
+ }
+
+ lottieView.SetMinMaxFrame(StartFrame, Math.Min(EndFrame, lottieView.TotalFrame - 1));
+
+ if (IsStillImage() || noPlay)
+ {
+ lottieView.CurrentFrame = EndFrame;
+ }
+ else
+ {
+ lottieView.CurrentFrame = StartFrame;
+ lottieView.Play();
+ }
+ }
+
+ /// <inheritdoc/>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public object Clone() => new LottieFrameInfo(StartFrame, EndFrame);
+
+ private bool BeReadyToShow(LottieAnimationView lottieView)
+ {
+ // Validate input lottieView
+ if (null == lottieView || lottieView.PlayState == LottieAnimationView.PlayStateType.Invalid)
+ {
+ return false;
+ }
+
+ // Stop if it was playing
+ if (lottieView.PlayState == LottieAnimationView.PlayStateType.Playing)
+ {
+ lottieView.Stop();
+ }
+
+ return true;
+ }
+ }
+}