2 * Copyright (c) 2019 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 "control-data-impl.h"
22 #include <dali-toolkit/public-api/dali-toolkit-common.h>
23 #include <dali/integration-api/debug.h>
24 #include <dali/devel-api/object/handle-devel.h>
25 #include <dali/devel-api/scripting/enum-helper.h>
26 #include <dali/devel-api/scripting/scripting.h>
27 #include <dali/integration-api/debug.h>
28 #include <dali/public-api/object/type-registry-helper.h>
33 #include <dali-toolkit/internal/visuals/visual-base-impl.h>
34 #include <dali-toolkit/public-api/visuals/image-visual-properties.h>
35 #include <dali-toolkit/public-api/visuals/visual-properties.h>
36 #include <dali-toolkit/devel-api/controls/control-depth-index-ranges.h>
37 #include <dali-toolkit/devel-api/controls/control-devel.h>
38 #include <dali-toolkit/devel-api/controls/control-wrapper-impl.h>
39 #include <dali-toolkit/internal/styling/style-manager-impl.h>
40 #include <dali-toolkit/internal/visuals/visual-string-constants.h>
51 extern const Dali::Scripting::StringEnum ControlStateTable[];
52 extern const unsigned int ControlStateTableCount;
55 // Not static or anonymous - shared with other translation units
56 const Scripting::StringEnum ControlStateTable[] = {
57 { "NORMAL", Toolkit::DevelControl::NORMAL },
58 { "FOCUSED", Toolkit::DevelControl::FOCUSED },
59 { "DISABLED", Toolkit::DevelControl::DISABLED },
61 const unsigned int ControlStateTableCount = sizeof( ControlStateTable ) / sizeof( ControlStateTable[0] );
68 #if defined(DEBUG_ENABLED)
69 Debug::Filter* gLogFilter = Debug::Filter::New( Debug::NoLogging, false, "LOG_CONTROL_VISUALS");
74 void Remove( Dictionary<T>& keyValues, const std::string& name )
76 keyValues.Remove(name);
79 void Remove( DictionaryKeys& keys, const std::string& name )
81 DictionaryKeys::iterator iter = std::find( keys.begin(), keys.end(), name );
82 if( iter != keys.end())
88 Toolkit::Visual::Type GetVisualTypeFromMap( const Property::Map& map )
90 Property::Value* typeValue = map.Find( Toolkit::Visual::Property::TYPE, VISUAL_TYPE );
91 Toolkit::Visual::Type type = Toolkit::Visual::IMAGE;
94 Scripting::GetEnumerationProperty( *typeValue, VISUAL_TYPE_TABLE, VISUAL_TYPE_TABLE_COUNT, type );
100 * Finds visual in given array, returning true if found along with the iterator for that visual as a out parameter
102 bool FindVisual( Property::Index targetIndex, const RegisteredVisualContainer& visuals, RegisteredVisualContainer::Iterator& iter )
104 for ( iter = visuals.Begin(); iter != visuals.End(); iter++ )
106 if ( (*iter)->index == targetIndex )
114 void FindChangableVisuals( Dictionary<Property::Map>& stateVisualsToAdd,
115 Dictionary<Property::Map>& stateVisualsToChange,
116 DictionaryKeys& stateVisualsToRemove)
118 DictionaryKeys copyOfStateVisualsToRemove = stateVisualsToRemove;
120 for( DictionaryKeys::iterator iter = copyOfStateVisualsToRemove.begin();
121 iter != copyOfStateVisualsToRemove.end(); ++iter )
123 const std::string& visualName = (*iter);
124 Property::Map* toMap = stateVisualsToAdd.Find( visualName );
127 stateVisualsToChange.Add( visualName, *toMap );
128 stateVisualsToAdd.Remove( visualName );
129 Remove( stateVisualsToRemove, visualName );
134 Toolkit::Visual::Base GetVisualByName(
135 const RegisteredVisualContainer& visuals,
136 const std::string& visualName )
138 Toolkit::Visual::Base visualHandle;
140 RegisteredVisualContainer::Iterator iter;
141 for ( iter = visuals.Begin(); iter != visuals.End(); iter++ )
143 Toolkit::Visual::Base visual = (*iter)->visual;
144 if( visual && visual.GetName() == visualName )
146 visualHandle = visual;
154 * Move visual from source to destination container
156 void MoveVisual( RegisteredVisualContainer::Iterator sourceIter, RegisteredVisualContainer& source, RegisteredVisualContainer& destination )
158 Toolkit::Visual::Base visual = (*sourceIter)->visual;
161 RegisteredVisual* rv = source.Release( sourceIter );
162 destination.PushBack( rv );
167 * Performs actions as requested using the action name.
168 * @param[in] object The object on which to perform the action.
169 * @param[in] actionName The action to perform.
170 * @param[in] attributes The attributes with which to perfrom this action.
171 * @return true if action has been accepted by this control
173 const char* ACTION_ACCESSIBILITY_ACTIVATED = "accessibilityActivated";
174 static bool DoAction( BaseObject* object, const std::string& actionName, const Property::Map& attributes )
178 if( object && ( 0 == strcmp( actionName.c_str(), ACTION_ACCESSIBILITY_ACTIVATED ) ) )
180 Toolkit::Control control = Toolkit::Control::DownCast( BaseHandle( object ) );
183 // if cast succeeds there is an implementation so no need to check
184 ret = Internal::GetImplementation( control ).OnAccessibilityActivated();
192 * Connects a callback function with the object's signals.
193 * @param[in] object The object providing the signal.
194 * @param[in] tracker Used to disconnect the signal.
195 * @param[in] signalName The signal to connect to.
196 * @param[in] functor A newly allocated FunctorDelegate.
197 * @return True if the signal was connected.
198 * @post If a signal was connected, ownership of functor was passed to CallbackBase. Otherwise the caller is responsible for deleting the unused functor.
200 const char* SIGNAL_KEY_EVENT = "keyEvent";
201 const char* SIGNAL_KEY_INPUT_FOCUS_GAINED = "keyInputFocusGained";
202 const char* SIGNAL_KEY_INPUT_FOCUS_LOST = "keyInputFocusLost";
203 const char* SIGNAL_TAPPED = "tapped";
204 const char* SIGNAL_PANNED = "panned";
205 const char* SIGNAL_PINCHED = "pinched";
206 const char* SIGNAL_LONG_PRESSED = "longPressed";
207 static bool DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor )
209 Dali::BaseHandle handle( object );
211 bool connected( false );
212 Toolkit::Control control = Toolkit::Control::DownCast( handle );
215 Internal::Control& controlImpl( Internal::GetImplementation( control ) );
218 if ( 0 == strcmp( signalName.c_str(), SIGNAL_KEY_EVENT ) )
220 controlImpl.KeyEventSignal().Connect( tracker, functor );
222 else if( 0 == strcmp( signalName.c_str(), SIGNAL_KEY_INPUT_FOCUS_GAINED ) )
224 controlImpl.KeyInputFocusGainedSignal().Connect( tracker, functor );
226 else if( 0 == strcmp( signalName.c_str(), SIGNAL_KEY_INPUT_FOCUS_LOST ) )
228 controlImpl.KeyInputFocusLostSignal().Connect( tracker, functor );
230 else if( 0 == strcmp( signalName.c_str(), SIGNAL_TAPPED ) )
232 controlImpl.EnableGestureDetection( Gesture::Tap );
233 controlImpl.GetTapGestureDetector().DetectedSignal().Connect( tracker, functor );
235 else if( 0 == strcmp( signalName.c_str(), SIGNAL_PANNED ) )
237 controlImpl.EnableGestureDetection( Gesture::Pan );
238 controlImpl.GetPanGestureDetector().DetectedSignal().Connect( tracker, functor );
240 else if( 0 == strcmp( signalName.c_str(), SIGNAL_PINCHED ) )
242 controlImpl.EnableGestureDetection( Gesture::Pinch );
243 controlImpl.GetPinchGestureDetector().DetectedSignal().Connect( tracker, functor );
245 else if( 0 == strcmp( signalName.c_str(), SIGNAL_LONG_PRESSED ) )
247 controlImpl.EnableGestureDetection( Gesture::LongPress );
248 controlImpl.GetLongPressGestureDetector().DetectedSignal().Connect( tracker, functor );
255 * Creates control through type registry
259 return Internal::Control::New();
261 // Setup signals and actions using the type-registry.
262 DALI_TYPE_REGISTRATION_BEGIN( Control, CustomActor, Create );
264 // Note: Properties are registered separately below.
266 SignalConnectorType registerSignal1( typeRegistration, SIGNAL_KEY_EVENT, &DoConnectSignal );
267 SignalConnectorType registerSignal2( typeRegistration, SIGNAL_KEY_INPUT_FOCUS_GAINED, &DoConnectSignal );
268 SignalConnectorType registerSignal3( typeRegistration, SIGNAL_KEY_INPUT_FOCUS_LOST, &DoConnectSignal );
269 SignalConnectorType registerSignal4( typeRegistration, SIGNAL_TAPPED, &DoConnectSignal );
270 SignalConnectorType registerSignal5( typeRegistration, SIGNAL_PANNED, &DoConnectSignal );
271 SignalConnectorType registerSignal6( typeRegistration, SIGNAL_PINCHED, &DoConnectSignal );
272 SignalConnectorType registerSignal7( typeRegistration, SIGNAL_LONG_PRESSED, &DoConnectSignal );
274 TypeAction registerAction( typeRegistration, ACTION_ACCESSIBILITY_ACTIVATED, &DoAction );
276 DALI_TYPE_REGISTRATION_END()
279 * @brief Iterate through given container and setOffScene any visual found
281 * @param[in] container Container of visuals
282 * @param[in] parent Parent actor to remove visuals from
284 void SetVisualsOffScene( const RegisteredVisualContainer& container, Actor parent )
286 for( auto iter = container.Begin(), end = container.End() ; iter!= end; iter++)
288 if( (*iter)->visual )
290 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Control::SetOffScene Setting visual(%d) off stage\n", (*iter)->index );
291 Toolkit::GetImplementation((*iter)->visual).SetOffScene( parent );
296 } // unnamed namespace
299 // Properties registered without macro to use specific member variables.
300 const PropertyRegistration Control::Impl::PROPERTY_1( typeRegistration, "styleName", Toolkit::Control::Property::STYLE_NAME, Property::STRING, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
301 const PropertyRegistration Control::Impl::PROPERTY_4( typeRegistration, "keyInputFocus", Toolkit::Control::Property::KEY_INPUT_FOCUS, Property::BOOLEAN, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
302 const PropertyRegistration Control::Impl::PROPERTY_5( typeRegistration, "background", Toolkit::Control::Property::BACKGROUND, Property::MAP, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
303 const PropertyRegistration Control::Impl::PROPERTY_6( typeRegistration, "margin", Toolkit::Control::Property::MARGIN, Property::EXTENTS, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
304 const PropertyRegistration Control::Impl::PROPERTY_7( typeRegistration, "padding", Toolkit::Control::Property::PADDING, Property::EXTENTS, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
305 const PropertyRegistration Control::Impl::PROPERTY_8( typeRegistration, "tooltip", Toolkit::DevelControl::Property::TOOLTIP, Property::MAP, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
306 const PropertyRegistration Control::Impl::PROPERTY_9( typeRegistration, "state", Toolkit::DevelControl::Property::STATE, Property::STRING, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
307 const PropertyRegistration Control::Impl::PROPERTY_10( typeRegistration, "subState", Toolkit::DevelControl::Property::SUB_STATE, Property::STRING, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
308 const PropertyRegistration Control::Impl::PROPERTY_11( typeRegistration, "leftFocusableActorId", Toolkit::DevelControl::Property::LEFT_FOCUSABLE_ACTOR_ID, Property::INTEGER, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
309 const PropertyRegistration Control::Impl::PROPERTY_12( typeRegistration, "rightFocusableActorId", Toolkit::DevelControl::Property::RIGHT_FOCUSABLE_ACTOR_ID,Property::INTEGER, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
310 const PropertyRegistration Control::Impl::PROPERTY_13( typeRegistration, "upFocusableActorId", Toolkit::DevelControl::Property::UP_FOCUSABLE_ACTOR_ID, Property::INTEGER, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
311 const PropertyRegistration Control::Impl::PROPERTY_14( typeRegistration, "downFocusableActorId", Toolkit::DevelControl::Property::DOWN_FOCUSABLE_ACTOR_ID, Property::INTEGER, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
312 const PropertyRegistration Control::Impl::PROPERTY_15( typeRegistration, "shadow", Toolkit::DevelControl::Property::SHADOW, Property::MAP, &Control::Impl::SetProperty, &Control::Impl::GetProperty );
315 Control::Impl::Impl( Control& controlImpl )
316 : mControlImpl( controlImpl ),
317 mState( Toolkit::DevelControl::NORMAL ),
319 mLeftFocusableActorId( -1 ),
320 mRightFocusableActorId( -1 ),
321 mUpFocusableActorId( -1 ),
322 mDownFocusableActorId( -1 ),
324 mBackgroundColor(Color::TRANSPARENT),
325 mStartingPinchScale( NULL ),
326 mMargin( 0, 0, 0, 0 ),
327 mPadding( 0, 0, 0, 0 ),
329 mKeyInputFocusGainedSignal(),
330 mKeyInputFocusLostSignal(),
331 mResourceReadySignal(),
332 mVisualEventSignal(),
333 mPinchGestureDetector(),
334 mPanGestureDetector(),
335 mTapGestureDetector(),
336 mLongPressGestureDetector(),
338 mInputMethodContext(),
339 mFlags( Control::ControlBehaviour( CONTROL_BEHAVIOUR_DEFAULT ) ),
340 mIsKeyboardNavigationSupported( false ),
341 mIsKeyboardFocusGroup( false )
345 Control::Impl::~Impl()
347 // All gesture detectors will be destroyed so no need to disconnect.
348 delete mStartingPinchScale;
351 Control::Impl& Control::Impl::Get( Internal::Control& internalControl )
353 return *internalControl.mImpl;
356 const Control::Impl& Control::Impl::Get( const Internal::Control& internalControl )
358 return *internalControl.mImpl;
361 // Gesture Detection Methods
362 void Control::Impl::PinchDetected(Actor actor, const PinchGesture& pinch)
364 mControlImpl.OnPinch(pinch);
367 void Control::Impl::PanDetected(Actor actor, const PanGesture& pan)
369 mControlImpl.OnPan(pan);
372 void Control::Impl::TapDetected(Actor actor, const TapGesture& tap)
374 mControlImpl.OnTap(tap);
377 void Control::Impl::LongPressDetected(Actor actor, const LongPressGesture& longPress)
379 mControlImpl.OnLongPress(longPress);
382 void Control::Impl::RegisterVisual( Property::Index index, Toolkit::Visual::Base& visual )
384 RegisterVisual( index, visual, VisualState::ENABLED, DepthIndexValue::NOT_SET );
387 void Control::Impl::RegisterVisual( Property::Index index, Toolkit::Visual::Base& visual, int depthIndex )
389 RegisterVisual( index, visual, VisualState::ENABLED, DepthIndexValue::SET, depthIndex );
392 void Control::Impl::RegisterVisual( Property::Index index, Toolkit::Visual::Base& visual, bool enabled )
394 RegisterVisual( index, visual, ( enabled ? VisualState::ENABLED : VisualState::DISABLED ), DepthIndexValue::NOT_SET );
397 void Control::Impl::RegisterVisual( Property::Index index, Toolkit::Visual::Base& visual, bool enabled, int depthIndex )
399 RegisterVisual( index, visual, ( enabled ? VisualState::ENABLED : VisualState::DISABLED ), DepthIndexValue::SET, depthIndex );
402 void Control::Impl::RegisterVisual( Property::Index index, Toolkit::Visual::Base& visual, VisualState::Type enabled, DepthIndexValue::Type depthIndexValueSet, int depthIndex )
404 DALI_LOG_INFO( gLogFilter, Debug::Concise, "RegisterVisual:%d \n", index );
406 bool visualReplaced ( false );
407 Actor self = mControlImpl.Self();
409 // Set the depth index, if not set by caller this will be either the current visual depth, max depth of all visuals
411 int requiredDepthIndex = visual.GetDepthIndex();
413 if( depthIndexValueSet == DepthIndexValue::SET )
415 requiredDepthIndex = depthIndex;
418 // Visual replacement, existing visual should only be removed from stage when replacement ready.
419 if( !mVisuals.Empty() )
421 RegisteredVisualContainer::Iterator registeredVisualsiter;
422 // Check if visual (index) is already registered, this is the current visual.
423 if( FindVisual( index, mVisuals, registeredVisualsiter ) )
425 Toolkit::Visual::Base& currentRegisteredVisual = (*registeredVisualsiter)->visual;
426 if( currentRegisteredVisual )
428 // Store current visual depth index as may need to set the replacement visual to same depth
429 const int currentDepthIndex = (*registeredVisualsiter)->visual.GetDepthIndex();
431 // No longer required to know if the replaced visual's resources are ready
432 StopObservingVisual( currentRegisteredVisual );
434 // If control staged and visual enabled then visuals will be swapped once ready
435 if( self.GetProperty< bool >( Actor::Property::CONNECTED_TO_SCENE ) && enabled )
437 // Check if visual is currently in the process of being replaced ( is in removal container )
438 RegisteredVisualContainer::Iterator visualQueuedForRemoval;
439 if ( FindVisual( index, mRemoveVisuals, visualQueuedForRemoval ) )
441 // Visual with same index is already in removal container so current visual pending
442 // Only the the last requested visual will be displayed so remove current visual which is staged but not ready.
443 Toolkit::GetImplementation( currentRegisteredVisual ).SetOffScene( self );
444 mVisuals.Erase( registeredVisualsiter );
448 // current visual not already in removal container so add now.
449 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "RegisterVisual Move current registered visual to removal Queue: %d \n", index );
450 MoveVisual( registeredVisualsiter, mVisuals, mRemoveVisuals );
455 // Control not staged or visual disabled so can just erase from registered visuals and new visual will be added later.
456 mVisuals.Erase( registeredVisualsiter );
459 // If we've not set the depth-index value and the new visual does not have a depth index applied to it, then use the previously set depth-index for this index
460 if( ( depthIndexValueSet == DepthIndexValue::NOT_SET ) &&
461 ( visual.GetDepthIndex() == 0 ) )
463 requiredDepthIndex = currentDepthIndex;
467 visualReplaced = true;
471 // If not set, set the name of the visual to the same name as the control's property.
472 // ( If the control has been type registered )
473 if( visual.GetName().empty() )
475 // returns empty string if index is not found as long as index is not -1
476 std::string visualName = self.GetPropertyName( index );
477 if( !visualName.empty() )
479 DALI_LOG_INFO( gLogFilter, Debug::Concise, "Setting visual name for property %d to %s\n",
480 index, visualName.c_str() );
481 visual.SetName( visualName );
485 if( !visualReplaced ) // New registration entry
487 // If we've not set the depth-index value, we have more than one visual and the visual does not have a depth index, then set it to be the highest
488 if( ( depthIndexValueSet == DepthIndexValue::NOT_SET ) &&
489 ( mVisuals.Size() > 0 ) &&
490 ( visual.GetDepthIndex() == 0 ) )
492 int maxDepthIndex = std::numeric_limits< int >::min();
494 RegisteredVisualContainer::ConstIterator iter;
495 const RegisteredVisualContainer::ConstIterator endIter = mVisuals.End();
496 for ( iter = mVisuals.Begin(); iter != endIter; iter++ )
498 const int visualDepthIndex = (*iter)->visual.GetDepthIndex();
499 if ( visualDepthIndex > maxDepthIndex )
501 maxDepthIndex = visualDepthIndex;
504 ++maxDepthIndex; // Add one to the current maximum depth index so that our added visual appears on top
505 requiredDepthIndex = std::max( 0, maxDepthIndex ); // Start at zero if maxDepth index belongs to a background
511 // Set determined depth index
512 visual.SetDepthIndex( requiredDepthIndex );
514 // Monitor when the visual resources are ready
515 StartObservingVisual( visual );
517 DALI_LOG_INFO( gLogFilter, Debug::Concise, "New Visual registration index[%d] depth[%d]\n", index, requiredDepthIndex );
518 RegisteredVisual* newRegisteredVisual = new RegisteredVisual( index, visual,
519 ( enabled == VisualState::ENABLED ? true : false ),
520 ( visualReplaced && enabled ) ) ;
521 mVisuals.PushBack( newRegisteredVisual );
523 Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
524 // Put on stage if enabled and the control is already on the stage
525 if( ( enabled == VisualState::ENABLED ) && self.GetProperty< bool >( Actor::Property::CONNECTED_TO_SCENE ) )
527 visualImpl.SetOnScene( self );
529 else if( visualImpl.IsResourceReady() ) // When not being staged, check if visual already 'ResourceReady' before it was Registered. ( Resource may have been loaded already )
531 ResourceReady( visualImpl );
536 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Control::RegisterVisual() Registered %s(%d), enabled:%s\n", visual.GetName().c_str(), index, enabled?"true":"false" );
539 void Control::Impl::UnregisterVisual( Property::Index index )
541 RegisteredVisualContainer::Iterator iter;
542 if ( FindVisual( index, mVisuals, iter ) )
544 // stop observing visual
545 StopObservingVisual( (*iter)->visual );
547 Actor self( mControlImpl.Self() );
548 Toolkit::GetImplementation((*iter)->visual).SetOffScene( self );
549 (*iter)->visual.Reset();
550 mVisuals.Erase( iter );
553 if( FindVisual( index, mRemoveVisuals, iter ) )
555 Actor self( mControlImpl.Self() );
556 Toolkit::GetImplementation( (*iter)->visual ).SetOffScene( self );
557 (*iter)->pending = false;
558 (*iter)->visual.Reset();
559 mRemoveVisuals.Erase( iter );
563 Toolkit::Visual::Base Control::Impl::GetVisual( Property::Index index ) const
565 RegisteredVisualContainer::Iterator iter;
566 if ( FindVisual( index, mVisuals, iter ) )
568 return (*iter)->visual;
571 return Toolkit::Visual::Base();
574 void Control::Impl::EnableVisual( Property::Index index, bool enable )
576 DALI_LOG_INFO( gLogFilter, Debug::General, "Control::EnableVisual(%d, %s)\n", index, enable?"T":"F");
578 RegisteredVisualContainer::Iterator iter;
579 if ( FindVisual( index, mVisuals, iter ) )
581 if ( (*iter)->enabled == enable )
583 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Control::EnableVisual Visual %s(%d) already %s\n", (*iter)->visual.GetName().c_str(), index, enable?"enabled":"disabled");
587 (*iter)->enabled = enable;
588 Actor parentActor = mControlImpl.Self();
589 if ( mControlImpl.Self().GetProperty< bool >( Actor::Property::CONNECTED_TO_SCENE ) ) // If control not on Scene then Visual will be added when SceneConnection is called.
593 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Control::EnableVisual Setting %s(%d) on stage \n", (*iter)->visual.GetName().c_str(), index );
594 Toolkit::GetImplementation((*iter)->visual).SetOnScene( parentActor );
598 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Control::EnableVisual Setting %s(%d) off stage \n", (*iter)->visual.GetName().c_str(), index );
599 Toolkit::GetImplementation((*iter)->visual).SetOffScene( parentActor ); // No need to call if control not staged.
605 DALI_LOG_WARNING( "Control::EnableVisual(%d, %s) FAILED - NO SUCH VISUAL\n", index, enable?"T":"F" );
609 bool Control::Impl::IsVisualEnabled( Property::Index index ) const
611 RegisteredVisualContainer::Iterator iter;
612 if ( FindVisual( index, mVisuals, iter ) )
614 return (*iter)->enabled;
619 void Control::Impl::StopObservingVisual( Toolkit::Visual::Base& visual )
621 Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
623 // Stop observing the visual
624 visualImpl.RemoveEventObserver( *this );
627 void Control::Impl::StartObservingVisual( Toolkit::Visual::Base& visual)
629 Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
631 // start observing the visual for events
632 visualImpl.AddEventObserver( *this );
635 // Called by a Visual when it's resource is ready
636 void Control::Impl::ResourceReady( Visual::Base& object)
638 DALI_LOG_INFO( gLogFilter, Debug::Verbose, "Control::Impl::ResourceReady() replacements pending[%d]\n", mRemoveVisuals.Count() );
640 Actor self = mControlImpl.Self();
642 // A resource is ready, find resource in the registered visuals container and get its index
643 for( auto registeredIter = mVisuals.Begin(), end = mVisuals.End(); registeredIter != end; ++registeredIter )
645 Internal::Visual::Base& registeredVisualImpl = Toolkit::GetImplementation( (*registeredIter)->visual );
647 if( &object == ®isteredVisualImpl )
649 RegisteredVisualContainer::Iterator visualToRemoveIter;
650 // Find visual with the same index in the removal container
651 // Set if off stage as it's replacement is now ready.
652 // Remove if from removal list as now removed from stage.
653 // Set Pending flag on the ready visual to false as now ready.
654 if( FindVisual( (*registeredIter)->index, mRemoveVisuals, visualToRemoveIter ) )
656 (*registeredIter)->pending = false;
657 Toolkit::GetImplementation( (*visualToRemoveIter)->visual ).SetOffScene( self );
658 mRemoveVisuals.Erase( visualToRemoveIter );
664 // A visual is ready so control may need relayouting if staged
665 if ( self.GetProperty< bool >( Actor::Property::CONNECTED_TO_SCENE ) )
667 mControlImpl.RelayoutRequest();
670 // Emit signal if all enabled visuals registered by the control are ready.
671 if( IsResourceReady() )
673 Dali::Toolkit::Control handle( mControlImpl.GetOwner() );
674 mResourceReadySignal.Emit( handle );
678 void Control::Impl::NotifyVisualEvent( Visual::Base& object, Property::Index signalId )
680 for( auto registeredIter = mVisuals.Begin(), end = mVisuals.End(); registeredIter != end; ++registeredIter )
682 Internal::Visual::Base& registeredVisualImpl = Toolkit::GetImplementation( (*registeredIter)->visual );
683 if( &object == ®isteredVisualImpl )
685 Dali::Toolkit::Control handle( mControlImpl.GetOwner() );
686 mVisualEventSignal.Emit( handle, (*registeredIter)->index, signalId );
692 bool Control::Impl::IsResourceReady() const
694 // Iterate through and check all the enabled visuals are ready
695 for( auto visualIter = mVisuals.Begin();
696 visualIter != mVisuals.End(); ++visualIter )
698 const Toolkit::Visual::Base visual = (*visualIter)->visual;
699 const Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
701 // one of the enabled visuals is not ready
702 if( !visualImpl.IsResourceReady() && (*visualIter)->enabled )
710 Toolkit::Visual::ResourceStatus Control::Impl::GetVisualResourceStatus( Property::Index index ) const
712 RegisteredVisualContainer::Iterator iter;
713 if ( FindVisual( index, mVisuals, iter ) )
715 const Toolkit::Visual::Base visual = (*iter)->visual;
716 const Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
717 return visualImpl.GetResourceStatus( );
720 return Toolkit::Visual::ResourceStatus::PREPARING;
725 void Control::Impl::AddTransitions( Dali::Animation& animation,
726 const Toolkit::TransitionData& handle,
727 bool createAnimation )
729 // Setup a Transition from TransitionData.
730 const Internal::TransitionData& transitionData = Toolkit::GetImplementation( handle );
731 TransitionData::Iterator end = transitionData.End();
732 for( TransitionData::Iterator iter = transitionData.Begin() ;
733 iter != end; ++iter )
735 TransitionData::Animator* animator = (*iter);
737 Toolkit::Visual::Base visual = GetVisualByName( mVisuals, animator->objectName );
741 #if defined(DEBUG_ENABLED)
742 Dali::TypeInfo typeInfo;
743 ControlWrapper* controlWrapperImpl = dynamic_cast<ControlWrapper*>(&mControlImpl);
744 if( controlWrapperImpl )
746 typeInfo = controlWrapperImpl->GetTypeInfo();
749 DALI_LOG_INFO( gLogFilter, Debug::Concise, "CreateTransition: Found %s visual for %s\n",
750 visual.GetName().c_str(), typeInfo?typeInfo.GetName().c_str():"Unknown" );
752 Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
753 visualImpl.AnimateProperty( animation, *animator );
757 DALI_LOG_INFO( gLogFilter, Debug::Concise, "CreateTransition: Could not find visual. Trying actors");
758 // Otherwise, try any actor children of control (Including the control)
759 Actor child = mControlImpl.Self().FindChildByName( animator->objectName );
762 Property::Index propertyIndex = DevelHandle::GetPropertyIndex( child, animator->propertyKey );
763 if( propertyIndex != Property::INVALID_INDEX )
765 if( animator->animate == false )
767 if( animator->targetValue.GetType() != Property::NONE )
769 child.SetProperty( propertyIndex, animator->targetValue );
772 else // animate the property
774 if( animator->initialValue.GetType() != Property::NONE )
776 child.SetProperty( propertyIndex, animator->initialValue );
779 if( createAnimation && !animation )
781 animation = Dali::Animation::New( 0.1f );
784 animation.AnimateTo( Property( child, propertyIndex ),
785 animator->targetValue,
786 animator->alphaFunction,
787 TimePeriod( animator->timePeriodDelay,
788 animator->timePeriodDuration ) );
796 Dali::Animation Control::Impl::CreateTransition( const Toolkit::TransitionData& transitionData )
798 Dali::Animation transition;
800 if( transitionData.Count() > 0 )
802 AddTransitions( transition, transitionData, true );
809 void Control::Impl::DoAction( Dali::Property::Index visualIndex, Dali::Property::Index actionId, const Dali::Property::Value attributes )
811 RegisteredVisualContainer::Iterator iter;
812 if ( FindVisual( visualIndex, mVisuals, iter ) )
814 Toolkit::GetImplementation((*iter)->visual).DoAction( actionId, attributes );
818 void Control::Impl::SetProperty( BaseObject* object, Property::Index index, const Property::Value& value )
820 Toolkit::Control control = Toolkit::Control::DownCast( BaseHandle( object ) );
824 Control& controlImpl( GetImplementation( control ) );
828 case Toolkit::Control::Property::STYLE_NAME:
830 controlImpl.SetStyleName( value.Get< std::string >() );
834 case Toolkit::DevelControl::Property::STATE:
836 bool withTransitions=true;
837 const Property::Value* valuePtr=&value;
838 Property::Map* map = value.GetMap();
841 Property::Value* value2 = map->Find("withTransitions");
844 withTransitions = value2->Get<bool>();
847 valuePtr = map->Find("state");
852 Toolkit::DevelControl::State state( controlImpl.mImpl->mState );
853 if( Scripting::GetEnumerationProperty< Toolkit::DevelControl::State >( *valuePtr, ControlStateTable, ControlStateTableCount, state ) )
855 controlImpl.mImpl->SetState( state, withTransitions );
861 case Toolkit::DevelControl::Property::SUB_STATE:
863 std::string subState;
864 if( value.Get( subState ) )
866 controlImpl.mImpl->SetSubState( subState );
871 case Toolkit::DevelControl::Property::LEFT_FOCUSABLE_ACTOR_ID:
874 if( value.Get( focusId ) )
876 controlImpl.mImpl->mLeftFocusableActorId = focusId;
881 case Toolkit::DevelControl::Property::RIGHT_FOCUSABLE_ACTOR_ID:
884 if( value.Get( focusId ) )
886 controlImpl.mImpl->mRightFocusableActorId = focusId;
891 case Toolkit::DevelControl::Property::UP_FOCUSABLE_ACTOR_ID:
894 if( value.Get( focusId ) )
896 controlImpl.mImpl->mUpFocusableActorId = focusId;
901 case Toolkit::DevelControl::Property::DOWN_FOCUSABLE_ACTOR_ID:
904 if( value.Get( focusId ) )
906 controlImpl.mImpl->mDownFocusableActorId = focusId;
911 case Toolkit::Control::Property::KEY_INPUT_FOCUS:
913 if ( value.Get< bool >() )
915 controlImpl.SetKeyInputFocus();
919 controlImpl.ClearKeyInputFocus();
924 case Toolkit::Control::Property::BACKGROUND:
928 const Property::Map* map = value.GetMap();
929 if( map && !map->Empty() )
931 controlImpl.SetBackground( *map );
933 else if( value.Get( url ) )
935 // don't know the size to load
936 Toolkit::Visual::Base visual = Toolkit::VisualFactory::Get().CreateVisual( url, ImageDimensions() );
939 controlImpl.mImpl->RegisterVisual( Toolkit::Control::Property::BACKGROUND, visual, DepthIndex::BACKGROUND );
942 else if( value.Get( color ) )
944 controlImpl.SetBackgroundColor(color);
948 // The background is an empty property map, so we should clear the background
949 controlImpl.ClearBackground();
954 case Toolkit::Control::Property::MARGIN:
957 if( value.Get( margin ) )
959 controlImpl.mImpl->SetMargin( margin );
964 case Toolkit::Control::Property::PADDING:
967 if( value.Get( padding ) )
969 controlImpl.mImpl->SetPadding( padding );
974 case Toolkit::DevelControl::Property::TOOLTIP:
976 TooltipPtr& tooltipPtr = controlImpl.mImpl->mTooltip;
979 tooltipPtr = Tooltip::New( control );
981 tooltipPtr->SetProperties( value );
985 case Toolkit::DevelControl::Property::SHADOW:
987 const Property::Map* map = value.GetMap();
988 if( map && !map->Empty() )
990 controlImpl.mImpl->SetShadow( *map );
994 // The shadow is an empty property map, so we should clear the shadow
995 controlImpl.mImpl->ClearShadow();
1004 Property::Value Control::Impl::GetProperty( BaseObject* object, Property::Index index )
1006 Property::Value value;
1008 Toolkit::Control control = Toolkit::Control::DownCast( BaseHandle( object ) );
1012 Control& controlImpl( GetImplementation( control ) );
1016 case Toolkit::Control::Property::STYLE_NAME:
1018 value = controlImpl.GetStyleName();
1022 case Toolkit::DevelControl::Property::STATE:
1024 value = controlImpl.mImpl->mState;
1028 case Toolkit::DevelControl::Property::SUB_STATE:
1030 value = controlImpl.mImpl->mSubStateName;
1034 case Toolkit::DevelControl::Property::LEFT_FOCUSABLE_ACTOR_ID:
1036 value = controlImpl.mImpl->mLeftFocusableActorId;
1040 case Toolkit::DevelControl::Property::RIGHT_FOCUSABLE_ACTOR_ID:
1042 value = controlImpl.mImpl->mRightFocusableActorId;
1046 case Toolkit::DevelControl::Property::UP_FOCUSABLE_ACTOR_ID:
1048 value = controlImpl.mImpl->mUpFocusableActorId;
1052 case Toolkit::DevelControl::Property::DOWN_FOCUSABLE_ACTOR_ID:
1054 value = controlImpl.mImpl->mDownFocusableActorId;
1058 case Toolkit::Control::Property::KEY_INPUT_FOCUS:
1060 value = controlImpl.HasKeyInputFocus();
1064 case Toolkit::Control::Property::BACKGROUND:
1067 Toolkit::Visual::Base visual = controlImpl.mImpl->GetVisual( Toolkit::Control::Property::BACKGROUND );
1070 visual.CreatePropertyMap( map );
1077 case Toolkit::Control::Property::MARGIN:
1079 value = controlImpl.mImpl->GetMargin();
1083 case Toolkit::Control::Property::PADDING:
1085 value = controlImpl.mImpl->GetPadding();
1089 case Toolkit::DevelControl::Property::TOOLTIP:
1092 if( controlImpl.mImpl->mTooltip )
1094 controlImpl.mImpl->mTooltip->CreatePropertyMap( map );
1100 case Toolkit::DevelControl::Property::SHADOW:
1103 Toolkit::Visual::Base visual = controlImpl.mImpl->GetVisual( Toolkit::DevelControl::Property::SHADOW );
1106 visual.CreatePropertyMap( map );
1119 void Control::Impl::CopyInstancedProperties( RegisteredVisualContainer& visuals, Dictionary<Property::Map>& instancedProperties )
1121 for(RegisteredVisualContainer::Iterator iter = visuals.Begin(); iter!= visuals.End(); iter++)
1123 if( (*iter)->visual )
1125 Property::Map instanceMap;
1126 Toolkit::GetImplementation((*iter)->visual).CreateInstancePropertyMap(instanceMap);
1127 instancedProperties.Add( (*iter)->visual.GetName(), instanceMap );
1133 void Control::Impl::RemoveVisual( RegisteredVisualContainer& visuals, const std::string& visualName )
1135 Actor self( mControlImpl.Self() );
1137 for ( RegisteredVisualContainer::Iterator visualIter = visuals.Begin();
1138 visualIter != visuals.End(); ++visualIter )
1140 Toolkit::Visual::Base visual = (*visualIter)->visual;
1141 if( visual && visual.GetName() == visualName )
1143 Toolkit::GetImplementation(visual).SetOffScene( self );
1144 (*visualIter)->visual.Reset();
1145 visuals.Erase( visualIter );
1151 void Control::Impl::RemoveVisuals( RegisteredVisualContainer& visuals, DictionaryKeys& removeVisuals )
1153 Actor self( mControlImpl.Self() );
1154 for( DictionaryKeys::iterator iter = removeVisuals.begin(); iter != removeVisuals.end(); ++iter )
1156 const std::string visualName = *iter;
1157 RemoveVisual( visuals, visualName );
1161 void Control::Impl::RecreateChangedVisuals( Dictionary<Property::Map>& stateVisualsToChange,
1162 Dictionary<Property::Map>& instancedProperties )
1164 Dali::CustomActor handle( mControlImpl.GetOwner() );
1165 for( Dictionary<Property::Map>::iterator iter = stateVisualsToChange.Begin();
1166 iter != stateVisualsToChange.End(); ++iter )
1168 const std::string& visualName = (*iter).key;
1169 const Property::Map& toMap = (*iter).entry;
1171 // is it a candidate for re-creation?
1172 bool recreate = false;
1174 Toolkit::Visual::Base visual = GetVisualByName( mVisuals, visualName );
1177 Property::Map fromMap;
1178 visual.CreatePropertyMap( fromMap );
1180 Toolkit::Visual::Type fromType = GetVisualTypeFromMap( fromMap );
1181 Toolkit::Visual::Type toType = GetVisualTypeFromMap( toMap );
1183 if( fromType != toType )
1189 if( fromType == Toolkit::Visual::IMAGE || fromType == Toolkit::Visual::N_PATCH
1190 || fromType == Toolkit::Visual::SVG || fromType == Toolkit::Visual::ANIMATED_IMAGE )
1192 Property::Value* fromUrl = fromMap.Find( Toolkit::ImageVisual::Property::URL, IMAGE_URL_NAME );
1193 Property::Value* toUrl = toMap.Find( Toolkit::ImageVisual::Property::URL, IMAGE_URL_NAME );
1195 if( fromUrl && toUrl )
1197 std::string fromUrlString;
1198 std::string toUrlString;
1199 fromUrl->Get(fromUrlString);
1200 toUrl->Get(toUrlString);
1202 if( fromUrlString != toUrlString )
1210 const Property::Map* instancedMap = instancedProperties.FindConst( visualName );
1211 if( recreate || instancedMap )
1213 RemoveVisual( mVisuals, visualName );
1214 Style::ApplyVisual( handle, visualName, toMap, instancedMap );
1218 // @todo check to see if we can apply toMap without recreating the visual
1219 // e.g. by setting only animatable properties
1220 // For now, recreate all visuals, but merge in instance data.
1221 RemoveVisual( mVisuals, visualName );
1222 Style::ApplyVisual( handle, visualName, toMap, instancedMap );
1228 void Control::Impl::ReplaceStateVisualsAndProperties( const StylePtr oldState, const StylePtr newState, const std::string& subState )
1230 // Collect all old visual names
1231 DictionaryKeys stateVisualsToRemove;
1234 oldState->visuals.GetKeys( stateVisualsToRemove );
1235 if( ! subState.empty() )
1237 const StylePtr* oldSubState = oldState->subStates.FindConst(subState);
1240 DictionaryKeys subStateVisualsToRemove;
1241 (*oldSubState)->visuals.GetKeys( subStateVisualsToRemove );
1242 Merge( stateVisualsToRemove, subStateVisualsToRemove );
1247 // Collect all new visual properties
1248 Dictionary<Property::Map> stateVisualsToAdd;
1251 stateVisualsToAdd = newState->visuals;
1252 if( ! subState.empty() )
1254 const StylePtr* newSubState = newState->subStates.FindConst(subState);
1257 stateVisualsToAdd.Merge( (*newSubState)->visuals );
1262 // If a name is in both add/remove, move it to change list.
1263 Dictionary<Property::Map> stateVisualsToChange;
1264 FindChangableVisuals( stateVisualsToAdd, stateVisualsToChange, stateVisualsToRemove);
1266 // Copy instanced properties (e.g. text label) of current visuals
1267 Dictionary<Property::Map> instancedProperties;
1268 CopyInstancedProperties( mVisuals, instancedProperties );
1270 // For each visual in remove list, remove from mVisuals
1271 RemoveVisuals( mVisuals, stateVisualsToRemove );
1273 // For each visual in add list, create and add to mVisuals
1274 Dali::CustomActor handle( mControlImpl.GetOwner() );
1275 Style::ApplyVisuals( handle, stateVisualsToAdd, instancedProperties );
1277 // For each visual in change list, if it requires a new visual,
1278 // remove old visual, create and add to mVisuals
1279 RecreateChangedVisuals( stateVisualsToChange, instancedProperties );
1282 void Control::Impl::SetState( DevelControl::State newState, bool withTransitions )
1284 DevelControl::State oldState = mState;
1285 Dali::CustomActor handle( mControlImpl.GetOwner() );
1286 DALI_LOG_INFO(gLogFilter, Debug::Concise, "Control::Impl::SetState: %s\n",
1287 (mState == DevelControl::NORMAL ? "NORMAL" :(
1288 mState == DevelControl::FOCUSED ?"FOCUSED" : (
1289 mState == DevelControl::DISABLED?"DISABLED":"NONE" ))));
1291 if( mState != newState )
1293 // If mState was Disabled, and new state is Focused, should probably
1294 // store that fact, e.g. in another property that FocusManager can access.
1297 // Trigger state change and transitions
1298 // Apply new style, if stylemanager is available
1299 Toolkit::StyleManager styleManager = Toolkit::StyleManager::Get();
1302 const StylePtr stylePtr = GetImpl( styleManager ).GetRecordedStyle( Toolkit::Control( mControlImpl.GetOwner() ) );
1306 std::string oldStateName = Scripting::GetEnumerationName< Toolkit::DevelControl::State >( oldState, ControlStateTable, ControlStateTableCount );
1307 std::string newStateName = Scripting::GetEnumerationName< Toolkit::DevelControl::State >( newState, ControlStateTable, ControlStateTableCount );
1309 const StylePtr* newStateStyle = stylePtr->subStates.Find( newStateName );
1310 const StylePtr* oldStateStyle = stylePtr->subStates.Find( oldStateName );
1311 if( oldStateStyle && newStateStyle )
1313 // Only change if both state styles exist
1314 ReplaceStateVisualsAndProperties( *oldStateStyle, *newStateStyle, mSubStateName );
1321 void Control::Impl::SetSubState( const std::string& subStateName, bool withTransitions )
1323 if( mSubStateName != subStateName )
1325 // Get existing sub-state visuals, and unregister them
1326 Dali::CustomActor handle( mControlImpl.GetOwner() );
1328 Toolkit::StyleManager styleManager = Toolkit::StyleManager::Get();
1331 const StylePtr stylePtr = GetImpl( styleManager ).GetRecordedStyle( Toolkit::Control( mControlImpl.GetOwner() ) );
1335 std::string stateName = Scripting::GetEnumerationName< Toolkit::DevelControl::State >( mState, ControlStateTable, ControlStateTableCount );
1337 const StylePtr* state = stylePtr->subStates.Find( stateName );
1340 StylePtr stateStyle(*state);
1342 const StylePtr* newStateStyle = stateStyle->subStates.Find( subStateName );
1343 const StylePtr* oldStateStyle = stateStyle->subStates.Find( mSubStateName );
1344 if( oldStateStyle && newStateStyle )
1347 ReplaceStateVisualsAndProperties( *oldStateStyle, *newStateStyle, empty );
1353 mSubStateName = subStateName;
1357 void Control::Impl::OnSceneDisconnection()
1359 Actor self = mControlImpl.Self();
1361 // Any visuals set for replacement but not yet ready should still be registered.
1362 // Reason: If a request was made to register a new visual but the control removed from scene before visual was ready
1363 // then when this control appears back on stage it should use that new visual.
1365 // Iterate through all registered visuals and set off scene
1366 SetVisualsOffScene( mVisuals, self );
1368 // Visuals pending replacement can now be taken out of the removal list and set off scene
1369 // Iterate through all replacement visuals and add to a move queue then set off scene
1370 for( auto removalIter = mRemoveVisuals.Begin(), end = mRemoveVisuals.End(); removalIter != end; removalIter++ )
1372 Toolkit::GetImplementation((*removalIter)->visual).SetOffScene( self );
1375 for( auto replacedIter = mVisuals.Begin(), end = mVisuals.End(); replacedIter != end; replacedIter++ )
1377 (*replacedIter)->pending = false;
1380 mRemoveVisuals.Clear();
1383 void Control::Impl::SetMargin( Extents margin )
1385 mControlImpl.mImpl->mMargin = margin;
1387 // Trigger a size negotiation request that may be needed when setting a margin.
1388 mControlImpl.RelayoutRequest();
1391 Extents Control::Impl::GetMargin() const
1393 return mControlImpl.mImpl->mMargin;
1396 void Control::Impl::SetPadding( Extents padding )
1398 mControlImpl.mImpl->mPadding = padding;
1400 // Trigger a size negotiation request that may be needed when setting a padding.
1401 mControlImpl.RelayoutRequest();
1404 Extents Control::Impl::GetPadding() const
1406 return mControlImpl.mImpl->mPadding;
1409 void Control::Impl::SetInputMethodContext( InputMethodContext& inputMethodContext )
1411 mInputMethodContext = inputMethodContext;
1414 bool Control::Impl::FilterKeyEvent( const KeyEvent& event )
1416 bool consumed ( false );
1418 if ( mInputMethodContext )
1420 consumed = mInputMethodContext.FilterEventKey( event );
1425 DevelControl::VisualEventSignalType& Control::Impl::VisualEventSignal()
1427 return mVisualEventSignal;
1430 void Control::Impl::SetShadow( const Property::Map& map )
1432 Toolkit::Visual::Base visual = Toolkit::VisualFactory::Get().CreateVisual( map );
1433 visual.SetName("shadow");
1437 mControlImpl.mImpl->RegisterVisual( Toolkit::DevelControl::Property::SHADOW, visual, DepthIndex::BACKGROUND_EFFECT );
1439 mControlImpl.RelayoutRequest();
1443 void Control::Impl::ClearShadow()
1445 mControlImpl.mImpl->UnregisterVisual( Toolkit::DevelControl::Property::SHADOW );
1447 // Trigger a size negotiation request that may be needed when unregistering a visual.
1448 mControlImpl.RelayoutRequest();
1451 } // namespace Internal
1453 } // namespace Toolkit