2 * Copyright (c) 2016 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include <dali-toolkit/internal/controls/progress-bar/progress-bar-impl.h>
22 #include <cstring> // for strcmp
25 #include <dali/public-api/object/type-registry-helper.h>
26 #include <dali/public-api/size-negotiation/relayout-container.h>
27 #include <dali/public-api/math/math-utils.h>
28 #include <dali-toolkit/devel-api/align-enums.h>
29 #include <dali-toolkit/devel-api/visual-factory/visual-base.h>
30 #include <dali-toolkit/public-api/visuals/color-visual-properties.h>
31 #include <dali-toolkit/public-api/visuals/image-visual-properties.h>
32 #include <dali-toolkit/devel-api/visuals/text-visual-properties.h>
33 #include <dali-toolkit/devel-api/visuals/visual-properties-devel.h>
34 #include <dali-toolkit/devel-api/visual-factory/visual-factory.h>
36 #include <dali/integration-api/debug.h>
47 namespace // Unnamed namespace
52 return Dali::Toolkit::ProgressBar::New();
55 // Setup properties, signals and actions using the type-registry.
56 DALI_TYPE_REGISTRATION_BEGIN( Toolkit::ProgressBar, Toolkit::Control, Create )
58 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "progressValue", FLOAT, PROGRESS_VALUE )
59 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "secondaryProgressValue", FLOAT, SECONDARY_PROGRESS_VALUE )
60 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "indeterminate", BOOLEAN, INDETERMINATE )
61 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "trackVisual", MAP, TRACK_VISUAL )
62 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "progressVisual", MAP, PROGRESS_VISUAL )
63 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "secondaryProgressVisual", MAP, SECONDARY_PROGRESS_VISUAL )
64 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "indeterminateVisual", MAP, INDETERMINATE_VISUAL )
65 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "indeterminateVisualAnimation", ARRAY, INDETERMINATE_VISUAL_ANIMATION )
66 DALI_PROPERTY_REGISTRATION( Toolkit, ProgressBar, "labelVisual", MAP, LABEL_VISUAL )
67 DALI_SIGNAL_REGISTRATION( Toolkit, ProgressBar, "valueChanged", SIGNAL_VALUE_CHANGED )
69 DALI_TYPE_REGISTRATION_END()
71 struct ProgressDepthIndex
73 // Enum to make sure the visual order
77 SECONDARY_PROGRESS_VISUAL,
84 float DEFAULT_VALUE = 0.0f;
85 float DEFAULT_LOWER_BOUND = 0.0f;
86 float DEFAULT_UPPER_BOUND = 1.0f;
87 float DEFAULT_FONT_SIZE = 12.0f;
89 } // Unnamed namespace
91 ///////////////////////////////////////////////////////////////////////////////////////////////////
93 ///////////////////////////////////////////////////////////////////////////////////////////////////
95 Dali::Toolkit::ProgressBar ProgressBar::New()
97 // Create the implementation
98 ProgressBarPtr progressBar( new ProgressBar() );
100 // Pass ownership to CustomActor via derived handle
101 Dali::Toolkit::ProgressBar handle( *progressBar );
103 // Second-phase init of the implementation
104 // This can only be done after the CustomActor connection has been made...
105 progressBar->Initialize();
110 ProgressBar::ProgressBar()
111 : Control( ControlBehaviour( CONTROL_BEHAVIOUR_DEFAULT ) ),
112 mProgressValue( DEFAULT_VALUE ),
113 mSecondaryProgressValue( DEFAULT_VALUE ),
114 mIndeterminate( false )
118 ProgressBar::~ProgressBar()
122 void ProgressBar::OnInitialize()
126 void ProgressBar::OnRelayout( const Vector2& size, RelayoutContainer& container )
129 Vector2 trackSize( size );
130 mDomain = CalcDomain( size );
132 trackSize.width = std::max( 0.0f, size.width ); // Ensure we don't go negative
134 Toolkit::Visual::Base trackVisual = GetVisual( Toolkit::ProgressBar::Property::TRACK_VISUAL );
135 Toolkit::Visual::Base secondProgressVisual = GetVisual( Toolkit::ProgressBar::Property::SECONDARY_PROGRESS_VISUAL );
136 Toolkit::Visual::Base progressVisual = GetVisual( Toolkit::ProgressBar::Property::PROGRESS_VISUAL );
137 Toolkit::Visual::Base labelVisual = GetVisual( Toolkit::ProgressBar::Property::LABEL_VISUAL );
138 Toolkit::Visual::Base indeterminateVisual = GetVisual( Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL );
142 Property::Map visualTransform;
144 visualTransform.Add( Toolkit::DevelVisual::Transform::Property::SIZE, trackSize )
145 .Add( Toolkit::DevelVisual::Transform::Property::OFFSET_SIZE_MODE, Vector4( 1.0f, 1.0f, 1.0f, 1.0f ) ); // Use Absolute size
146 trackVisual.SetTransformAndSize( visualTransform, trackSize );
149 if( secondProgressVisual )
151 Property::Map visualTransform;
153 visualTransform.Add( Toolkit::DevelVisual::Transform::Property::SIZE, Vector2( mDomain.from.x + mSecondaryProgressValue * ( mDomain.to.x - mDomain.from.x ), trackSize.height ) )
154 .Add( Toolkit::DevelVisual::Transform::Property::OFFSET_SIZE_MODE, Vector4( 1.0f, 1.0f, 1.0f, 1.0f ) ) // Use Absolute size
155 .Add( Toolkit::DevelVisual::Transform::Property::ORIGIN, Toolkit::Align::TOP_BEGIN )
156 .Add( Toolkit::DevelVisual::Transform::Property::ANCHOR_POINT, Toolkit::Align::TOP_BEGIN );
157 secondProgressVisual.SetTransformAndSize( visualTransform, trackSize );
162 Property::Map visualTransform;
164 visualTransform.Add( Toolkit::DevelVisual::Transform::Property::SIZE, Vector2( mDomain.from.x + mProgressValue * ( mDomain.to.x - mDomain.from.x ), trackSize.height ) )
165 .Add( Toolkit::DevelVisual::Transform::Property::OFFSET_SIZE_MODE, Vector4( 1.0f, 1.0f, 1.0f, 1.0f ) ) // Use Absolute size
166 .Add( Toolkit::DevelVisual::Transform::Property::ORIGIN, Toolkit::Align::TOP_BEGIN )
167 .Add( Toolkit::DevelVisual::Transform::Property::ANCHOR_POINT, Toolkit::Align::TOP_BEGIN );
168 progressVisual.SetTransformAndSize( visualTransform, trackSize );
173 Property::Map visualTransform;
175 visualTransform.Add( Toolkit::DevelVisual::Transform::Property::SIZE, trackSize )
176 .Add( Toolkit::DevelVisual::Transform::Property::OFFSET_SIZE_MODE, Vector4( 1.0f, 1.0f, 1.0f, 1.0f ) ); // Use Absolute size
178 labelVisual.SetTransformAndSize( visualTransform, trackSize );
181 if( indeterminateVisual )
183 Property::Map visualTransform;
185 visualTransform.Add( Toolkit::DevelVisual::Transform::Property::SIZE, trackSize )
186 .Add( Toolkit::DevelVisual::Transform::Property::OFFSET_SIZE_MODE, Vector4( 1.0f, 1.0f, 1.0f, 1.0f ) ); // Use Absolute size
187 indeterminateVisual.SetTransformAndSize( visualTransform, trackSize );
192 Vector3 ProgressBar::GetNaturalSize()
194 // Return the bigger size after comparing trackVisual naturalSize and labelVisual naturalSize
195 Toolkit::Visual::Base trackVisual = GetVisual( Toolkit::ProgressBar::Property::TRACK_VISUAL );
196 Toolkit::Visual::Base labelVisual = GetVisual( Toolkit::ProgressBar::Property::LABEL_VISUAL );
203 trackVisual.GetNaturalSize( trackSize );
207 labelVisual.GetNaturalSize( labelSize );
211 naturalSize.width = ( trackSize.width > labelSize.width ) ? trackSize.width: labelSize.width;
212 naturalSize.height = ( trackSize.height > labelSize.height ) ? trackSize.height: labelSize.height;
217 ProgressBar::Domain ProgressBar::CalcDomain( const Vector2& currentSize )
219 return Domain( Vector2( 0.0f, 0.0f ), currentSize );
222 Toolkit::ProgressBar::ValueChangedSignalType& ProgressBar::ValueChangedSignal()
224 return mValueChangedSignal;
227 void ProgressBar::SetProgressValue( float value )
229 // update the progress bar value (taking float precision errors into account)
230 // TODO : it seems 0.0f cannot into this statement.
231 if( ( mProgressValue != value ) &&
232 ( ( value >= DEFAULT_LOWER_BOUND ) || ( Equals( value, DEFAULT_LOWER_BOUND ) ) ) &&
233 ( ( value <= DEFAULT_UPPER_BOUND ) || ( Equals( value, DEFAULT_UPPER_BOUND ) ) ) )
235 mProgressValue = Clamp( value, DEFAULT_LOWER_BOUND, DEFAULT_UPPER_BOUND );
237 Toolkit::ProgressBar self = Toolkit::ProgressBar::DownCast( Self() );
238 mValueChangedSignal.Emit( self, mProgressValue, mSecondaryProgressValue );
243 float ProgressBar::GetProgressValue() const
245 return mProgressValue;
248 void ProgressBar::SetSecondaryProgressValue( float value )
250 // update the progress bar value (taking float precision errors into account)
251 // TODO : it seems 0.0f cannot into this statement.
252 if( ( mSecondaryProgressValue != value ) &&
253 ( ( value >= DEFAULT_LOWER_BOUND ) || ( Equals( value, DEFAULT_LOWER_BOUND ) ) ) &&
254 ( ( value <= DEFAULT_UPPER_BOUND ) || ( Equals( value, DEFAULT_UPPER_BOUND ) ) ) )
256 mSecondaryProgressValue = Clamp( value, DEFAULT_LOWER_BOUND, DEFAULT_UPPER_BOUND );
258 Toolkit::ProgressBar self = Toolkit::ProgressBar::DownCast( Self() );
259 mValueChangedSignal.Emit( self, mProgressValue, mSecondaryProgressValue );
265 float ProgressBar::GetSecondaryProgressValue() const
267 return mSecondaryProgressValue;
270 void ProgressBar::SetIndeterminate( bool value )
272 mIndeterminate = value;
273 EnableVisual( Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL, mIndeterminate );
278 if( mIndeterminateVisualTransition )
280 PlayIndeterminateVisualTransition();
285 if( mIndeterminateVisualAni )
287 mIndeterminateVisualAni.Stop();
292 bool ProgressBar::GetIndeterminate() const
294 return mIndeterminate;
297 void ProgressBar::SetIndeterminateVisualTransition( Toolkit::TransitionData transition )
299 mIndeterminateVisualTransition = transition;
302 PlayIndeterminateVisualTransition();
306 void ProgressBar::PlayIndeterminateVisualTransition()
308 if( mIndeterminateVisualAni )
310 mIndeterminateVisualAni.Stop();
311 mIndeterminateVisualAni.Clear();
314 mIndeterminateVisualAni = CreateTransition( mIndeterminateVisualTransition );
316 if( mIndeterminate && mIndeterminateVisualAni )
318 mIndeterminateVisualAni.SetLooping(true);
319 mIndeterminateVisualAni.Play();
323 Toolkit::TransitionData ProgressBar::ConvertPropertyToTransition( const Property::Value& value )
325 Toolkit::TransitionData transitionData;
327 if( value.GetType() == Property::ARRAY )
329 transitionData = Toolkit::TransitionData::New( *value.GetArray() );
331 else if( value.GetType() == Property::MAP )
333 transitionData = Toolkit::TransitionData::New( *value.GetMap() );
336 return transitionData;
340 * Create Visual for given index from a property map or url.
341 * 1) Check if value passed in is a url and create visual
342 * 2) Create visual from map if step (1) is false
343 * 3) Register visual with control with false for enable flag.
344 * 4) Unregister visual if empty map was provided. This is the method to remove a visual
347 void ProgressBar::CreateVisualsForComponent( Property::Index index, const Property::Value& value, const float visualDepth )
349 Toolkit::VisualFactory visualFactory = Toolkit::VisualFactory::Get();
350 Toolkit::Visual::Base progressVisual;
352 std::string imageUrl;
353 if( value.Get( imageUrl ) )
355 if ( !imageUrl.empty() )
357 progressVisual = visualFactory.CreateVisual( imageUrl, ImageDimensions() );
360 else // Does this code make text-visual can be accepted as visual?
362 // if its not a string then get a Property::Map from the property if possible.
363 Property::Map *map = value.GetMap();
364 if( map && !map->Empty() ) // Empty map results in current visual removal.
366 progressVisual = visualFactory.CreateVisual( *map );
370 if ( progressVisual )
372 progressVisual.SetDepthIndex( visualDepth );
373 if( index == Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL )
375 RegisterVisual( index, progressVisual, mIndeterminate );
379 RegisterVisual( index, progressVisual, true );
384 UnregisterVisual( index );
388 bool ProgressBar::GetPropertyMapForVisual( Property::Index visualIndex, Property::Map& retreivedMap ) const
390 bool success = false;
391 Toolkit::Visual::Base visual = GetVisual( visualIndex );
395 visual.CreatePropertyMap( retreivedMap );
402 // Static class method to support script connecting signals
403 bool ProgressBar::DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor )
405 Dali::BaseHandle handle( object );
407 bool connected = true;
408 Toolkit::ProgressBar ProgressBar = Toolkit::ProgressBar::DownCast( handle );
410 if( 0 == strcmp( signalName.c_str(), SIGNAL_VALUE_CHANGED ) )
412 ProgressBar.ValueChangedSignal().Connect( tracker, functor );
416 // signalName does not match any signal
423 void ProgressBar::SetProperty( BaseObject* object, Property::Index propertyIndex, const Property::Value& value )
425 Toolkit::ProgressBar progressBar = Toolkit::ProgressBar::DownCast( Dali::BaseHandle( object ) );
429 ProgressBar& progressBarImpl( GetImpl( progressBar ) );
431 switch ( propertyIndex )
433 case Toolkit::ProgressBar::Property::TRACK_VISUAL:
435 progressBarImpl.CreateVisualsForComponent( propertyIndex, value, ProgressDepthIndex::TRACK_VISUAL );
439 case Toolkit::ProgressBar::Property::SECONDARY_PROGRESS_VISUAL:
441 progressBarImpl.CreateVisualsForComponent( propertyIndex, value, ProgressDepthIndex::SECONDARY_PROGRESS_VISUAL );
445 case Toolkit::ProgressBar::Property::PROGRESS_VISUAL:
447 progressBarImpl.CreateVisualsForComponent( propertyIndex, value, ProgressDepthIndex::PROGRESS_VISUAL );
451 case Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL:
453 progressBarImpl.CreateVisualsForComponent( propertyIndex, value, ProgressDepthIndex::INDETERMINATE_VISUAL );
457 case Toolkit::ProgressBar::Property::LABEL_VISUAL:
460 std::string textString;
462 if ( value.Get( textString ) )
464 // set new text string as TEXT property
465 Property::Map newTextMap;
466 Toolkit::Visual::Base label = progressBarImpl.GetVisual( Toolkit::ProgressBar::Property::LABEL_VISUAL );
470 label.CreatePropertyMap( map );
473 // if LABEL_VISUAL doesn't set before, add Visual property "TYPE" to create new text Visual
476 newTextMap.Add( Toolkit::Visual::Property::TYPE, Toolkit::DevelVisual::TEXT );
477 newTextMap.Add( Toolkit::TextVisual::Property::POINT_SIZE, DEFAULT_FONT_SIZE );
479 newTextMap.Add( Toolkit::TextVisual::Property::TEXT, textString );
481 map.Merge( newTextMap );
490 progressBarImpl.CreateVisualsForComponent( propertyIndex, map, ProgressDepthIndex::LABEL_VISUAL );
495 case Toolkit::ProgressBar::Property::PROGRESS_VALUE:
497 progressBarImpl.SetProgressValue( value.Get< float >() );
501 case Toolkit::ProgressBar::Property::SECONDARY_PROGRESS_VALUE:
503 progressBarImpl.SetSecondaryProgressValue( value.Get< float >() );
507 case Toolkit::ProgressBar::Property::INDETERMINATE:
509 progressBarImpl.SetIndeterminate( value.Get< bool >() );
513 case Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL_ANIMATION:
515 progressBarImpl.SetIndeterminateVisualTransition( progressBarImpl.ConvertPropertyToTransition( value ) );
522 Property::Value ProgressBar::GetProperty( BaseObject* object, Property::Index propertyIndex )
524 Property::Value value;
526 Toolkit::ProgressBar progressBar = Toolkit::ProgressBar::DownCast( Dali::BaseHandle( object ) );
530 ProgressBar& progressBarImpl( GetImpl( progressBar ) );
532 switch ( propertyIndex )
534 case Toolkit::ProgressBar::Property::TRACK_VISUAL:
535 case Toolkit::ProgressBar::Property::PROGRESS_VISUAL:
536 case Toolkit::ProgressBar::Property::SECONDARY_PROGRESS_VISUAL:
537 case Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL:
538 case Toolkit::ProgressBar::Property::LABEL_VISUAL:
540 Property::Map visualProperty;
541 if ( progressBarImpl.GetPropertyMapForVisual( propertyIndex, visualProperty ) )
543 value = visualProperty;
548 case Toolkit::ProgressBar::Property::PROGRESS_VALUE:
550 value = progressBarImpl.GetProgressValue();
554 case Toolkit::ProgressBar::Property::SECONDARY_PROGRESS_VALUE:
556 value = progressBarImpl.GetSecondaryProgressValue();
560 case Toolkit::ProgressBar::Property::INDETERMINATE:
562 value = progressBarImpl.GetIndeterminate();
566 case Toolkit::ProgressBar::Property::INDETERMINATE_VISUAL_ANIMATION:
568 //TODO: Return INDETERMINATE_VISUAL_TRANSITION;
576 void ProgressBar::OnStageConnection( int depth )
578 // Chain up first (ensures visuals are ready to draw)
579 Control::OnStageConnection( depth );
583 PlayIndeterminateVisualTransition();
587 } // namespace Internal
589 } // namespace Toolkit