dali-toolkit/internal/text/decorator/text-decorator.cpp

   1 /*
   2  * Copyright (c) 2015 Samsung Electronics Co., Ltd.
   3  *
   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
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  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.
  15  *
  16  */
  17
  18 // CLASS HEADER
  19 #include <dali-toolkit/internal/text/decorator/text-decorator.h>
  20
  21 // EXTERNAL INCLUDES
  22 #include <dali/integration-api/debug.h>
  23 #include <dali/public-api/actors/actor.h>
  24 #include <dali/public-api/adaptor-framework/timer.h>
  25 #include <dali/public-api/actors/image-actor.h>
  26 #include <dali/public-api/actors/layer.h>
  27 #include <dali/public-api/animation/constraint.h>
  28 #include <dali/public-api/common/constants.h>
  29 #include <dali/public-api/common/stage.h>
  30 #include <dali/public-api/events/tap-gesture.h>
  31 #include <dali/public-api/events/tap-gesture-detector.h>
  32 #include <dali/public-api/events/touch-event.h>
  33 #include <dali/public-api/events/pan-gesture.h>
  34 #include <dali/public-api/events/pan-gesture-detector.h>
  35 #include <dali/public-api/images/resource-image.h>
  36 #include <dali/public-api/math/rect.h>
  37 #include <dali/public-api/math/vector2.h>
  38 #include <dali/public-api/math/vector4.h>
  39 #include <dali/public-api/object/property-notification.h>
  40 #include <dali/public-api/signals/connection-tracker.h>
  41
  42 #include <dali/devel-api/object/property-buffer.h>
  43 #include <dali/devel-api/rendering/geometry.h>
  44 #include <dali/devel-api/rendering/material.h>
  45 #include <dali/devel-api/rendering/renderer.h>
  46 #include <dali/devel-api/rendering/shader.h>
  47
  48 // INTERNAL INCLUDES
  49 #include <dali-toolkit/public-api/controls/control.h>
  50 #include <dali-toolkit/public-api/controls/control-depth-index-ranges.h>
  51 #include <dali-toolkit/public-api/controls/control-impl.h>
  52 #include <dali-toolkit/public-api/controls/buttons/push-button.h>
  53 #include <dali-toolkit/public-api/controls/default-controls/solid-color-actor.h>
  54 #include <dali-toolkit/public-api/controls/text-controls/text-label.h>
  55 #include <dali-toolkit/devel-api/controls/text-controls/text-selection-popup.h>
  56
  57 #ifdef DEBUG_ENABLED
  58 #define DECORATOR_DEBUG
  59
  60 #endif
  61
  62 #define MAKE_SHADER(A)#A
  63
  64 namespace
  65 {
  66 const char* VERTEX_SHADER = MAKE_SHADER(
  67 attribute mediump vec2    aPosition;
  68 uniform   mediump mat4    uMvpMatrix;
  69 uniform   mediump vec3    uSize;
  70
  71 void main()
  72 {
  73   mediump vec4 position = vec4( aPosition, 0.0, 1.0 );
  74   position.xyz *= uSize;
  75   gl_Position = uMvpMatrix * position;
  76 }
  77 );
  78
  79 const char* FRAGMENT_SHADER = MAKE_SHADER(
  80 uniform      lowp vec4 uColor;
  81
  82 void main()
  83 {
  84   gl_FragColor = uColor;
  85 }
  86 );
  87 }
  88
  89 namespace Dali
  90 {
  91 namespace Internal
  92 {
  93 namespace
  94 {
  95 #ifdef DECORATOR_DEBUG
  96 Integration::Log::Filter* gLogFilter( Integration::Log::Filter::New(Debug::NoLogging, false, "LOG_TEXT_DECORATOR") );
  97 #endif
  98 }
  99 }
 100 }
 101
 102
 103 // Local Data
 104 namespace
 105 {
 106
 107 const char* DEFAULT_GRAB_HANDLE_IMAGE_RELEASED( DALI_IMAGE_DIR "insertpoint-icon.png" );
 108 const char* DEFAULT_GRAB_HANDLE_IMAGE_PRESSED( DALI_IMAGE_DIR "insertpoint-icon-pressed.png" );
 109 const char* DEFAULT_SELECTION_HANDLE_ONE_RELEASED( DALI_IMAGE_DIR "text-input-selection-handle-left.png" );
 110 const char* DEFAULT_SELECTION_HANDLE_ONE_PRESSED( DALI_IMAGE_DIR "text-input-selection-handle-left-press.png" );
 111 const char* DEFAULT_SELECTION_HANDLE_TWO_RELEASED( DALI_IMAGE_DIR "text-input-selection-handle-right.png" );
 112 const char* DEFAULT_SELECTION_HANDLE_TWO_PRESSED( DALI_IMAGE_DIR "text-input-selection-handle-right-press.png" );
 113
 114 const int DEFAULT_POPUP_OFFSET( -100.0f ); // Vertical offset of Popup from cursor or handles position.
 115
 116 const Dali::Vector3 DEFAULT_GRAB_HANDLE_RELATIVE_SIZE( 1.25f, 1.5f, 1.0f );
 117 const Dali::Vector3 DEFAULT_SELECTION_HANDLE_RELATIVE_SIZE( 1.25f, 1.5f, 1.0f );
 118
 119 const Dali::Vector4 LIGHT_BLUE( (0xb2 / 255.0f), (0xeb / 255.0f), (0xf2 / 255.0f), 0.5f ); // The text highlight color.
 120
 121 const unsigned int CURSOR_BLINK_INTERVAL = 500u; // Cursor blink interval
 122 const float TO_MILLISECONDS = 1000.f;
 123 const float TO_SECONDS = 1.f / TO_MILLISECONDS;
 124
 125 const float DISPLAYED_HIGHLIGHT_Z_OFFSET( -0.05f );
 126
 127 const unsigned int SCROLL_TICK_INTERVAL = 50u;
 128
 129 const float SCROLL_THRESHOLD = 10.f;
 130 const float SCROLL_SPEED = 300.f;
 131 const float SCROLL_DISTANCE = SCROLL_SPEED * SCROLL_TICK_INTERVAL * TO_SECONDS;
 132
 133 /**
 134  * structure to hold coordinates of each quad, which will make up the mesh.
 135  */
 136 struct QuadCoordinates
 137 {
 138   /**
 139    * Default constructor
 140    */
 141   QuadCoordinates()
 142   {
 143   }
 144
 145   /**
 146    * Constructor
 147    * @param[in] x1 left co-ordinate
 148    * @param[in] y1 top co-ordinate
 149    * @param[in] x2 right co-ordinate
 150    * @param[in] y2 bottom co-ordinate
 151    */
 152   QuadCoordinates(float x1, float y1, float x2, float y2)
 153   : min(x1, y1),
 154     max(x2, y2)
 155   {
 156   }
 157
 158   Dali::Vector2 min;                          ///< top-left (minimum) position of quad
 159   Dali::Vector2 max;                          ///< bottom-right (maximum) position of quad
 160 };
 161
 162 typedef std::vector<QuadCoordinates> QuadContainer;
 163
 164 /**
 165  * @brief Takes a bounding rectangle in the local coordinates of an actor and returns the world coordinates Bounding Box.
 166  * @param[in] boundingRectangle local bounding
 167  * @param[out] Vector4 World coordinate bounding Box.
 168  */
 169 void LocalToWorldCoordinatesBoundingBox( const Dali::Rect<int>& boundingRectangle, Dali::Vector4& boundingBox )
 170 {
 171   // Convert to world coordinates and store as a Vector4 to be compatible with Property Notifications.
 172   Dali::Vector2 stageSize = Dali::Stage::GetCurrent().GetSize();
 173
 174   const float originX = boundingRectangle.x - 0.5f * stageSize.width;
 175   const float originY = boundingRectangle.y - 0.5f * stageSize.height;
 176
 177   boundingBox = Dali::Vector4( originX,
 178                                originY,
 179                                originX + boundingRectangle.width,
 180                                originY + boundingRectangle.height );
 181 }
 182
 183
 184 } // end of namespace
 185
 186 namespace Dali
 187 {
 188
 189 namespace Toolkit
 190 {
 191
 192 namespace Text
 193 {
 194
 195 struct Decorator::Impl : public ConnectionTracker
 196 {
 197   enum ScrollDirection
 198   {
 199     SCROLL_NONE,
 200     SCROLL_RIGHT,
 201     SCROLL_LEFT,
 202     SCROLL_TOP,
 203     SCROLL_BOTTOM
 204   };
 205
 206   struct CursorImpl
 207   {
 208     CursorImpl()
 209     : color( Dali::Color::BLACK ),
 210       position(),
 211       cursorHeight( 0.0f ),
 212       lineHeight( 0.0f )
 213     {
 214     }
 215
 216     Vector4 color;
 217     Vector2 position;
 218     float cursorHeight;
 219     float lineHeight;
 220   };
 221
 222   struct HandleImpl
 223   {
 224     HandleImpl()
 225     : position(),
 226       lineHeight( 0.0f ),
 227       grabDisplacementX( 0.f ),
 228       grabDisplacementY( 0.f ),
 229       active( false ),
 230       visible( false ),
 231       pressed( false ),
 232       flipped( false )
 233     {
 234     }
 235
 236     ImageActor actor;
 237     Actor grabArea;
 238
 239     Vector2 position;
 240     float lineHeight; ///< Not the handle height
 241     float grabDisplacementX;
 242     float grabDisplacementY;
 243     bool active  : 1;
 244     bool visible : 1;
 245     bool pressed : 1;
 246     bool flipped : 1;
 247   };
 248
 249   struct PopupImpl
 250   {
 251     PopupImpl()
 252     : position(),
 253       offset( DEFAULT_POPUP_OFFSET )
 254     {
 255     }
 256
 257     TextSelectionPopup actor;
 258     Vector3 position;
 259     int offset;
 260   };
 261
 262   Impl( ControllerInterface& controller,
 263         TextSelectionPopupCallbackInterface& callbackInterface )
 264   : mController( controller ),
 265     mEnabledPopupButtons( TextSelectionPopup::NONE ),
 266     mTextSelectionPopupCallbackInterface( callbackInterface ),
 267     mBoundingBox( Rect<int>() ),
 268     mHighlightColor( LIGHT_BLUE ),
 269     mHighlightPosition( Vector2::ZERO ),
 270     mActiveCursor( ACTIVE_CURSOR_NONE ),
 271     mCursorBlinkInterval( CURSOR_BLINK_INTERVAL ),
 272     mCursorBlinkDuration( 0.0f ),
 273     mHandleScrolling( HANDLE_TYPE_COUNT ),
 274     mScrollDirection( SCROLL_NONE ),
 275     mScrollThreshold( SCROLL_THRESHOLD ),
 276     mScrollSpeed( SCROLL_SPEED ),
 277     mScrollDistance( SCROLL_DISTANCE ),
 278     mActiveCopyPastePopup( false ),
 279     mCursorBlinkStatus( true ),
 280     mPrimaryCursorVisible( false ),
 281     mSecondaryCursorVisible( false ),
 282     mSwapSelectionHandles( false ),
 283     mNotifyEndOfScroll( false )
 284   {
 285     mQuadVertexFormat[ "aPosition" ] = Property::VECTOR2;
 286     mQuadIndexFormat[ "indices" ] = Property::UNSIGNED_INTEGER;
 287     mHighlightMaterial = Material::New( Shader::New( VERTEX_SHADER, FRAGMENT_SHADER ) );
 288   }
 289
 290   /**
 291    * Relayout of the decorations owned by the decorator.
 292    * @param[in] size The Size of the UI control the decorator is adding it's decorations to.
 293    */
 294   void Relayout( const Vector2& size )
 295   {
 296     // TODO - Remove this if nothing is active
 297     CreateActiveLayer();
 298
 299     // Show or hide the cursors
 300     CreateCursors();
 301     if( mPrimaryCursor )
 302     {
 303       const CursorImpl& cursor = mCursor[PRIMARY_CURSOR];
 304       mPrimaryCursorVisible = ( cursor.position.x <= size.width ) && ( cursor.position.x >= 0.f );
 305       if( mPrimaryCursorVisible )
 306       {
 307         Vector2 position = cursor.position;
 308
 309         mPrimaryCursor.SetPosition( position.x,
 310                                     position.y );
 311         mPrimaryCursor.SetSize( Size( 1.0f, cursor.cursorHeight ) );
 312       }
 313       mPrimaryCursor.SetVisible( mPrimaryCursorVisible );
 314     }
 315     if( mSecondaryCursor )
 316     {
 317       const CursorImpl& cursor = mCursor[SECONDARY_CURSOR];
 318       mSecondaryCursorVisible = ( cursor.position.x <= size.width ) && ( cursor.position.x >= 0.f );
 319       if( mSecondaryCursorVisible )
 320       {
 321         mSecondaryCursor.SetPosition( cursor.position.x,
 322                                       cursor.position.y );
 323         mSecondaryCursor.SetSize( Size( 1.0f, cursor.cursorHeight ) );
 324       }
 325       mSecondaryCursor.SetVisible( mSecondaryCursorVisible );
 326     }
 327
 328     // Show or hide the grab handle
 329     HandleImpl& grabHandle = mHandle[GRAB_HANDLE];
 330     if( grabHandle.active )
 331     {
 332       Vector2 position = grabHandle.position;
 333
 334       const bool isVisible = ( position.x <= size.width ) && ( position.x >= 0.f );
 335
 336       if( isVisible )
 337       {
 338         SetupTouchEvents();
 339
 340         CreateGrabHandle();
 341
 342         grabHandle.actor.SetPosition( position.x,
 343                                       position.y + grabHandle.lineHeight );
 344       }
 345       grabHandle.actor.SetVisible( isVisible );
 346     }
 347     else if( grabHandle.actor )
 348     {
 349       UnparentAndReset( grabHandle.actor );
 350     }
 351
 352     // Show or hide the selection handles/highlight
 353     HandleImpl& primary = mHandle[ LEFT_SELECTION_HANDLE ];
 354     HandleImpl& secondary = mHandle[ RIGHT_SELECTION_HANDLE ];
 355     if( primary.active || secondary.active )
 356     {
 357       Vector2 primaryPosition = primary.position;
 358       Vector2 secondaryPosition = secondary.position;
 359
 360       const bool isPrimaryVisible = ( primaryPosition.x <= size.width ) && ( primaryPosition.x >= 0.f );
 361       const bool isSecondaryVisible = ( secondaryPosition.x <= size.width ) && ( secondaryPosition.x >= 0.f );
 362
 363       if( isPrimaryVisible || isSecondaryVisible )
 364       {
 365         SetupTouchEvents();
 366
 367         CreateSelectionHandles();
 368
 369         if( isPrimaryVisible )
 370         {
 371           primary.actor.SetPosition( primaryPosition.x,
 372                                      primaryPosition.y + primary.lineHeight );
 373         }
 374
 375         if( isSecondaryVisible )
 376         {
 377           secondary.actor.SetPosition( secondaryPosition.x,
 378                                        secondaryPosition.y + secondary.lineHeight );
 379         }
 380       }
 381       primary.actor.SetVisible( isPrimaryVisible );
 382       secondary.actor.SetVisible( isSecondaryVisible );
 383
 384       // Shouldn't be needed......
 385       UnparentAndReset( mHighlightActor );
 386
 387       CreateHighlight();
 388       UpdateHighlight();
 389     }
 390     else
 391     {
 392       UnparentAndReset( primary.actor );
 393       UnparentAndReset( secondary.actor );
 394       UnparentAndReset( mHighlightActor );
 395     }
 396
 397     if ( mActiveCopyPastePopup )
 398     {
 399       // todo Swap UnparentAndReset for DeterminePositionPopup() if mCopyPastePopup.actor valid Once the issue with the labels disappearing is fixed.
 400       UnparentAndReset( mCopyPastePopup.actor );
 401       if ( !mCopyPastePopup.actor )
 402       {
 403         mCopyPastePopup.actor = TextSelectionPopup::New( mEnabledPopupButtons, &mTextSelectionPopupCallbackInterface );
 404 #ifdef DECORATOR_DEBUG
 405         mCopyPastePopup.actor.SetName("mCopyPastePopup");
 406 #endif
 407         mCopyPastePopup.actor.SetAnchorPoint( AnchorPoint::CENTER );
 408         mCopyPastePopup.actor.OnRelayoutSignal().Connect( this,  &Decorator::Impl::PopupRelayoutComplete  ); // Position popup after size negotiation
 409         mActiveLayer.Add ( mCopyPastePopup.actor );
 410       }
 411     }
 412     else
 413     {
 414      if ( mCopyPastePopup.actor )
 415      {
 416        UnparentAndReset( mCopyPastePopup.actor );
 417      }
 418     }
 419   }
 420
 421   void UpdatePositions( const Vector2& scrollOffset )
 422   {
 423     mCursor[PRIMARY_CURSOR].position += scrollOffset;
 424     mCursor[SECONDARY_CURSOR].position += scrollOffset;
 425     mHandle[ GRAB_HANDLE ].position += scrollOffset;
 426     mHandle[ LEFT_SELECTION_HANDLE ].position += scrollOffset;
 427     mHandle[ RIGHT_SELECTION_HANDLE ].position += scrollOffset;
 428     mHighlightPosition += scrollOffset;
 429   }
 430
 431   void DeterminePositionPopup()
 432   {
 433     if ( !mActiveCopyPastePopup )
 434     {
 435       return;
 436     }
 437
 438     if ( mHandle[LEFT_SELECTION_HANDLE].active || mHandle[RIGHT_SELECTION_HANDLE].active )
 439     {
 440       float minHandleXPosition = std::min (  mHandle[LEFT_SELECTION_HANDLE].position.x, mHandle[RIGHT_SELECTION_HANDLE].position.x );
 441       float maxHandleXPosition = std::max (  mHandle[LEFT_SELECTION_HANDLE].position.x, mHandle[RIGHT_SELECTION_HANDLE].position.x );
 442
 443       float minHandleYPosition = std::min (  mHandle[LEFT_SELECTION_HANDLE].position.y, mHandle[RIGHT_SELECTION_HANDLE].position.y );
 444
 445       mCopyPastePopup.position.x = minHandleXPosition + ( ( maxHandleXPosition - minHandleXPosition ) *0.5f );
 446       mCopyPastePopup.position.y = minHandleYPosition + mCopyPastePopup.offset;
 447     }
 448     else
 449     {
 450       mCopyPastePopup.position = Vector3( mCursor[PRIMARY_CURSOR].position.x, mCursor[PRIMARY_CURSOR].position.y -100.0f , 0.0f ); //todo 100 to be an offset Property
 451     }
 452
 453     Vector3 popupSize = Vector3( mCopyPastePopup.actor.GetRelayoutSize( Dimension::WIDTH ), mCopyPastePopup.actor.GetRelayoutSize( Dimension::HEIGHT ), 0.0f );
 454
 455     GetConstrainedPopupPosition( mCopyPastePopup.position, popupSize, AnchorPoint::CENTER, mActiveLayer, mBoundingBox );
 456
 457     SetUpPopupPositionNotifications();
 458
 459     mCopyPastePopup.actor.SetPosition( mCopyPastePopup.position );
 460   }
 461
 462   void PopupRelayoutComplete( Actor actor )
 463   {
 464     // Size negotiation for CopyPastePopup complete so can get the size and constrain position within bounding box.
 465     mCopyPastePopup.actor.OnRelayoutSignal().Disconnect( this, &Decorator::Impl::PopupRelayoutComplete  );
 466
 467     DeterminePositionPopup();
 468   }
 469
 470   void CreateCursor( ImageActor& cursor, const Vector4& color )
 471   {
 472     cursor = CreateSolidColorActor( color );
 473     cursor.SetSortModifier( DECORATION_DEPTH_INDEX );
 474     cursor.SetParentOrigin( ParentOrigin::TOP_LEFT ); // Need to set the default parent origin as CreateSolidColorActor() sets a different one.
 475     cursor.SetAnchorPoint( AnchorPoint::TOP_CENTER );
 476   }
 477
 478   // Add or Remove cursor(s) from parent
 479   void CreateCursors()
 480   {
 481     if( mActiveCursor == ACTIVE_CURSOR_NONE )
 482     {
 483       UnparentAndReset( mPrimaryCursor );
 484       UnparentAndReset( mSecondaryCursor );
 485     }
 486     else
 487     {
 488       // Create Primary and or Secondary Cursor(s) if active and add to parent
 489       if ( mActiveCursor == ACTIVE_CURSOR_PRIMARY ||
 490            mActiveCursor == ACTIVE_CURSOR_BOTH )
 491       {
 492         if ( !mPrimaryCursor )
 493         {
 494           CreateCursor( mPrimaryCursor, mCursor[PRIMARY_CURSOR].color );
 495 #ifdef DECORATOR_DEBUG
 496           mPrimaryCursor.SetName( "PrimaryCursorActor" );
 497 #endif
 498           mActiveLayer.Add( mPrimaryCursor );
 499         }
 500       }
 501
 502       if ( mActiveCursor == ACTIVE_CURSOR_BOTH )
 503       {
 504         if ( !mSecondaryCursor )
 505         {
 506           CreateCursor( mSecondaryCursor, mCursor[SECONDARY_CURSOR].color );
 507 #ifdef DECORATOR_DEBUG
 508           mSecondaryCursor.SetName( "SecondaryCursorActor" );
 509 #endif
 510           mActiveLayer.Add( mSecondaryCursor );
 511         }
 512       }
 513       else
 514       {
 515         UnparentAndReset( mSecondaryCursor );
 516       }
 517     }
 518   }
 519
 520   bool OnCursorBlinkTimerTick()
 521   {
 522     // Cursor blinking
 523     if ( mPrimaryCursor )
 524     {
 525       mPrimaryCursor.SetVisible( mPrimaryCursorVisible && mCursorBlinkStatus );
 526     }
 527     if ( mSecondaryCursor )
 528     {
 529       mSecondaryCursor.SetVisible( mSecondaryCursorVisible && mCursorBlinkStatus );
 530     }
 531
 532     mCursorBlinkStatus = !mCursorBlinkStatus;
 533
 534     return true;
 535   }
 536
 537   void SetupTouchEvents()
 538   {
 539     if ( !mTapDetector )
 540     {
 541       mTapDetector = TapGestureDetector::New();
 542       mTapDetector.DetectedSignal().Connect( this, &Decorator::Impl::OnTap );
 543     }
 544
 545     if ( !mPanGestureDetector )
 546     {
 547       mPanGestureDetector = PanGestureDetector::New();
 548       mPanGestureDetector.DetectedSignal().Connect( this, &Decorator::Impl::OnPan );
 549     }
 550   }
 551
 552   void CreateActiveLayer()
 553   {
 554     if( !mActiveLayer )
 555     {
 556       mActiveLayer = Layer::New();
 557 #ifdef DECORATOR_DEBUG
 558       mActiveLayer.SetName ( "ActiveLayerActor" );
 559 #endif
 560
 561       mActiveLayer.SetParentOrigin( ParentOrigin::CENTER );
 562       mActiveLayer.SetResizePolicy( ResizePolicy::FILL_TO_PARENT, Dimension::ALL_DIMENSIONS );
 563       mActiveLayer.SetPositionInheritanceMode( USE_PARENT_POSITION );
 564
 565       // Add the active layer telling the controller it doesn't need clipping.
 566       mController.AddDecoration( mActiveLayer, false );
 567     }
 568
 569     mActiveLayer.RaiseToTop();
 570   }
 571
 572   void CreateGrabHandle()
 573   {
 574     HandleImpl& grabHandle = mHandle[GRAB_HANDLE];
 575     if( !grabHandle.actor )
 576     {
 577       if( !mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_RELEASED] )
 578       {
 579         mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_RELEASED] = ResourceImage::New( DEFAULT_GRAB_HANDLE_IMAGE_RELEASED );
 580       }
 581       if( !mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_PRESSED] )
 582       {
 583         mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_PRESSED] = ResourceImage::New( DEFAULT_GRAB_HANDLE_IMAGE_PRESSED );
 584       }
 585
 586       grabHandle.actor = ImageActor::New( mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_RELEASED] );
 587       grabHandle.actor.SetSortModifier( DECORATION_DEPTH_INDEX );
 588       grabHandle.actor.SetAnchorPoint( AnchorPoint::TOP_CENTER );
 589       // Area that Grab handle responds to, larger than actual handle so easier to move
 590 #ifdef DECORATOR_DEBUG
 591       grabHandle.actor.SetName( "GrabHandleActor" );
 592       if ( Dali::Internal::gLogFilter->IsEnabledFor( Debug::Verbose ) )
 593       {
 594         grabHandle.grabArea = Toolkit::CreateSolidColorActor( Vector4(0.0f, 0.0f, 0.0f, 0.0f), true, Color::RED, 1 );
 595         grabHandle.grabArea.SetName( "GrabArea" );
 596       }
 597       else
 598       {
 599         grabHandle.grabArea = Actor::New();
 600         grabHandle.grabArea.SetName( "GrabArea" );
 601       }
 602 #else
 603       grabHandle.grabArea = Actor::New();
 604 #endif
 605
 606       grabHandle.grabArea.SetParentOrigin( ParentOrigin::TOP_CENTER );
 607       grabHandle.grabArea.SetAnchorPoint( AnchorPoint::TOP_CENTER );
 608       grabHandle.grabArea.SetResizePolicy( ResizePolicy::SIZE_RELATIVE_TO_PARENT, Dimension::ALL_DIMENSIONS );
 609       grabHandle.grabArea.SetSizeModeFactor( DEFAULT_GRAB_HANDLE_RELATIVE_SIZE );
 610       grabHandle.actor.Add( grabHandle.grabArea );
 611
 612       grabHandle.grabArea.TouchedSignal().Connect( this, &Decorator::Impl::OnGrabHandleTouched );
 613       mTapDetector.Attach( grabHandle.grabArea );
 614       mPanGestureDetector.Attach( grabHandle.grabArea );
 615
 616       mActiveLayer.Add( grabHandle.actor );
 617     }
 618   }
 619
 620   void CreateSelectionHandles()
 621   {
 622     HandleImpl& primary = mHandle[ LEFT_SELECTION_HANDLE ];
 623     if( !primary.actor )
 624     {
 625       if( !mHandleImages[LEFT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED] )
 626       {
 627         mHandleImages[LEFT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED] = ResourceImage::New( DEFAULT_SELECTION_HANDLE_ONE_RELEASED );
 628       }
 629       if( !mHandleImages[LEFT_SELECTION_HANDLE][HANDLE_IMAGE_PRESSED] )
 630       {
 631         mHandleImages[LEFT_SELECTION_HANDLE][HANDLE_IMAGE_PRESSED] = ResourceImage::New( DEFAULT_SELECTION_HANDLE_ONE_PRESSED );
 632       }
 633
 634       primary.actor = ImageActor::New( mHandleImages[LEFT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED] );
 635 #ifdef DECORATOR_DEBUG
 636       primary.actor.SetName("SelectionHandleOne");
 637 #endif
 638       primary.actor.SetAnchorPoint( AnchorPoint::TOP_RIGHT ); // Change to BOTTOM_RIGHT if Look'n'Feel requires handle above text.
 639       primary.actor.SetSortModifier( DECORATION_DEPTH_INDEX );
 640       primary.flipped = false;
 641
 642       primary.grabArea = Actor::New(); // Area that Grab handle responds to, larger than actual handle so easier to move
 643 #ifdef DECORATOR_DEBUG
 644       primary.grabArea.SetName("SelectionHandleOneGrabArea");
 645 #endif
 646       primary.grabArea.SetResizePolicy( ResizePolicy::SIZE_RELATIVE_TO_PARENT, Dimension::ALL_DIMENSIONS );
 647       primary.grabArea.SetParentOrigin( ParentOrigin::TOP_CENTER );
 648       primary.grabArea.SetAnchorPoint( AnchorPoint::TOP_CENTER );
 649       primary.grabArea.SetSizeModeFactor( DEFAULT_SELECTION_HANDLE_RELATIVE_SIZE );
 650
 651       mTapDetector.Attach( primary.grabArea );
 652       mPanGestureDetector.Attach( primary.grabArea );
 653       primary.grabArea.TouchedSignal().Connect( this, &Decorator::Impl::OnHandleOneTouched );
 654
 655       primary.actor.Add( primary.grabArea );
 656       mActiveLayer.Add( primary.actor );
 657     }
 658
 659     HandleImpl& secondary = mHandle[ RIGHT_SELECTION_HANDLE ];
 660     if( !secondary.actor )
 661     {
 662       if( !mHandleImages[RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED] )
 663       {
 664         mHandleImages[RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED] = ResourceImage::New( DEFAULT_SELECTION_HANDLE_TWO_RELEASED );
 665       }
 666       if( !mHandleImages[RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_PRESSED] )
 667       {
 668         mHandleImages[RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_PRESSED] = ResourceImage::New( DEFAULT_SELECTION_HANDLE_TWO_PRESSED );
 669       }
 670
 671       secondary.actor = ImageActor::New( mHandleImages[RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED] );
 672 #ifdef DECORATOR_DEBUG
 673       secondary.actor.SetName("SelectionHandleTwo");
 674 #endif
 675       secondary.actor.SetAnchorPoint( AnchorPoint::TOP_LEFT ); // Change to BOTTOM_LEFT if Look'n'Feel requires handle above text.
 676       secondary.actor.SetSortModifier( DECORATION_DEPTH_INDEX );
 677       secondary.flipped = false;
 678
 679       secondary.grabArea = Actor::New(); // Area that Grab handle responds to, larger than actual handle so easier to move
 680 #ifdef DECORATOR_DEBUG
 681       secondary.grabArea.SetName("SelectionHandleTwoGrabArea");
 682 #endif
 683       secondary.grabArea.SetResizePolicy( ResizePolicy::SIZE_RELATIVE_TO_PARENT, Dimension::ALL_DIMENSIONS );
 684       secondary.grabArea.SetParentOrigin( ParentOrigin::TOP_CENTER );
 685       secondary.grabArea.SetAnchorPoint( AnchorPoint::TOP_CENTER );
 686       secondary.grabArea.SetSizeModeFactor( DEFAULT_SELECTION_HANDLE_RELATIVE_SIZE );
 687
 688       mTapDetector.Attach( secondary.grabArea );
 689       mPanGestureDetector.Attach( secondary.grabArea );
 690       secondary.grabArea.TouchedSignal().Connect( this, &Decorator::Impl::OnHandleTwoTouched );
 691
 692       secondary.actor.Add( secondary.grabArea );
 693       mActiveLayer.Add( secondary.actor );
 694     }
 695   }
 696
 697   void CreateHighlight()
 698   {
 699     if ( !mHighlightActor )
 700     {
 701       mHighlightActor = Actor::New();
 702
 703 #ifdef DECORATOR_DEBUG
 704       mHighlightActor.SetName( "HighlightActor" );
 705 #endif
 706       mHighlightActor.SetAnchorPoint( AnchorPoint::TOP_LEFT );
 707       mHighlightActor.SetPosition( 0.0f, 0.0f, DISPLAYED_HIGHLIGHT_Z_OFFSET );
 708       mHighlightActor.SetSize( 1.0f, 1.0f );
 709       mHighlightActor.SetColor( mHighlightColor );
 710       mHighlightActor.SetColorMode( USE_OWN_COLOR );
 711
 712       // Add the highlight box telling the controller it needs clipping.
 713       mController.AddDecoration( mHighlightActor, true );
 714     }
 715   }
 716
 717   void UpdateHighlight()
 718   {
 719
 720     if ( mHighlightActor && !mHighlightQuadList.empty() )
 721     {
 722       Vector< Vector2 > vertices;
 723       Vector< unsigned int> indices;
 724       Vector2 vertex;
 725
 726       std::vector<QuadCoordinates>::iterator iter = mHighlightQuadList.begin();
 727       std::vector<QuadCoordinates>::iterator endIter = mHighlightQuadList.end();
 728
 729       for(std::size_t v = 0; iter != endIter; ++iter,v+=4 )
 730       {
 731
 732         QuadCoordinates& quad = *iter;
 733
 734         // top-left (v+0)
 735         vertex.x = quad.min.x;
 736         vertex.y = quad.min.y;
 737         vertices.PushBack( vertex );
 738
 739         // top-right (v+1)
 740         vertex.x = quad.max.x;
 741         vertex.y = quad.min.y;
 742         vertices.PushBack( vertex );
 743
 744         // bottom-left (v+2)
 745         vertex.x = quad.min.x;
 746         vertex.y = quad.max.y;
 747         vertices.PushBack( vertex );
 748
 749         // bottom-right (v+3)
 750         vertex.x = quad.max.x;
 751         vertex.y = quad.max.y;
 752         vertices.PushBack( vertex );
 753
 754         // triangle A (3, 1, 0)
 755         indices.PushBack( v + 3 );
 756         indices.PushBack( v + 1 );
 757         indices.PushBack( v );
 758
 759         // triangle B (0, 2, 3)
 760         indices.PushBack( v );
 761         indices.PushBack( v + 2 );
 762         indices.PushBack( v + 3 );
 763       }
 764
 765       PropertyBuffer quadVertices = PropertyBuffer::New( mQuadVertexFormat, vertices.Size() );
 766       PropertyBuffer quadIndices = PropertyBuffer::New( mQuadIndexFormat, indices.Size() );
 767
 768       quadVertices.SetData( &vertices[ 0 ] );
 769       quadIndices.SetData( &indices[ 0 ] );
 770
 771       Geometry quadGeometry = Geometry::New();
 772       quadGeometry.AddVertexBuffer( quadVertices );
 773       quadGeometry.SetIndexBuffer( quadIndices );
 774
 775  //     if ( mHighlightRenderer )
 776  //     {
 777  //       mHighlightRenderer.SetGeometry( quadGeometry );
 778  //     }
 779  //     else
 780  //     {
 781         mHighlightRenderer = Dali::Renderer::New( quadGeometry, mHighlightMaterial );
 782         mHighlightRenderer.SetDepthIndex( DECORATION_DEPTH_INDEX - 1 );
 783  //     }
 784       mHighlightActor.AddRenderer( mHighlightRenderer );
 785     }
 786   }
 787
 788   void OnTap( Actor actor, const TapGesture& tap )
 789   {
 790     if( actor == mHandle[GRAB_HANDLE].actor )
 791     {
 792       // TODO
 793     }
 794   }
 795
 796   void DoPan( HandleImpl& handle, HandleType type, const PanGesture& gesture )
 797   {
 798     if( Gesture::Started == gesture.state )
 799     {
 800       handle.grabDisplacementX = handle.grabDisplacementY = 0;
 801     }
 802
 803     handle.grabDisplacementX += gesture.displacement.x;
 804     handle.grabDisplacementY += gesture.displacement.y;
 805
 806     const float x = handle.position.x + handle.grabDisplacementX;
 807     const float y = handle.position.y + handle.lineHeight*0.5f + handle.grabDisplacementY;
 808
 809     if( Gesture::Started    == gesture.state ||
 810         Gesture::Continuing == gesture.state )
 811     {
 812       Vector2 targetSize;
 813       mController.GetTargetSize( targetSize );
 814
 815       if( x < mScrollThreshold )
 816       {
 817         mScrollDirection = SCROLL_RIGHT;
 818         mHandleScrolling = type;
 819         StartScrollTimer();
 820       }
 821       else if( x > targetSize.width - mScrollThreshold )
 822       {
 823         mScrollDirection = SCROLL_LEFT;
 824         mHandleScrolling = type;
 825         StartScrollTimer();
 826       }
 827       else
 828       {
 829         mHandleScrolling = HANDLE_TYPE_COUNT;
 830         StopScrollTimer();
 831         mController.DecorationEvent( type, HANDLE_PRESSED, x, y );
 832       }
 833     }
 834     else if( Gesture::Finished  == gesture.state ||
 835              Gesture::Cancelled == gesture.state )
 836     {
 837       if( mScrollTimer &&
 838           ( mScrollTimer.IsRunning() || mNotifyEndOfScroll ) )
 839       {
 840         mNotifyEndOfScroll = false;
 841         mHandleScrolling = HANDLE_TYPE_COUNT;
 842         StopScrollTimer();
 843         mController.DecorationEvent( type, HANDLE_STOP_SCROLLING, x, y );
 844       }
 845       else
 846       {
 847         mController.DecorationEvent( type, HANDLE_RELEASED, x, y );
 848       }
 849
 850       if( GRAB_HANDLE == type )
 851       {
 852         handle.actor.SetImage( mHandleImages[type][HANDLE_IMAGE_RELEASED] );
 853       }
 854       else
 855       {
 856         HandleType selectionHandleType = type;
 857
 858         if( mSwapSelectionHandles != handle.flipped )
 859         {
 860           selectionHandleType = ( LEFT_SELECTION_HANDLE == type ) ? RIGHT_SELECTION_HANDLE : LEFT_SELECTION_HANDLE;
 861         }
 862
 863         handle.actor.SetImage( mHandleImages[selectionHandleType][HANDLE_IMAGE_RELEASED] );
 864       }
 865       handle.pressed = false;
 866     }
 867   }
 868
 869   void OnPan( Actor actor, const PanGesture& gesture )
 870   {
 871     HandleImpl& grabHandle = mHandle[GRAB_HANDLE];
 872     HandleImpl& primarySelectionHandle = mHandle[LEFT_SELECTION_HANDLE];
 873     HandleImpl& secondarySelectionHandle = mHandle[RIGHT_SELECTION_HANDLE];
 874
 875     if( actor == grabHandle.grabArea )
 876     {
 877       DoPan( grabHandle, GRAB_HANDLE, gesture );
 878     }
 879     else if( actor == primarySelectionHandle.grabArea )
 880     {
 881       DoPan( primarySelectionHandle, LEFT_SELECTION_HANDLE, gesture );
 882     }
 883     else if( actor == secondarySelectionHandle.grabArea )
 884     {
 885       DoPan( secondarySelectionHandle, RIGHT_SELECTION_HANDLE, gesture );
 886     }
 887   }
 888
 889   bool OnGrabHandleTouched( Actor actor, const TouchEvent& event )
 890   {
 891     // Switch between pressed/release grab-handle images
 892     if( event.GetPointCount() > 0 &&
 893         mHandle[GRAB_HANDLE].actor )
 894     {
 895       const TouchPoint& point = event.GetPoint(0);
 896
 897       if( TouchPoint::Down == point.state )
 898       {
 899         mHandle[GRAB_HANDLE].pressed = true;
 900         Image imagePressed = mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_PRESSED];
 901         if( imagePressed )
 902         {
 903           mHandle[GRAB_HANDLE].actor.SetImage( imagePressed );
 904         }
 905       }
 906       else if( ( TouchPoint::Up == point.state ) ||
 907                ( TouchPoint::Interrupted == point.state ) )
 908       {
 909         mHandle[GRAB_HANDLE].pressed = false;
 910         Image imageReleased = mHandleImages[GRAB_HANDLE][HANDLE_IMAGE_RELEASED];
 911         if( imageReleased )
 912         {
 913           mHandle[GRAB_HANDLE].actor.SetImage( imageReleased );
 914         }
 915       }
 916     }
 917
 918     // Consume to avoid pop-ups accidentally closing, when handle is outside of pop-up area
 919     return true;
 920   }
 921
 922   bool OnHandleOneTouched( Actor actor, const TouchEvent& event )
 923   {
 924     // Switch between pressed/release selection handle images
 925     if( event.GetPointCount() > 0 &&
 926         mHandle[LEFT_SELECTION_HANDLE].actor )
 927     {
 928       const TouchPoint& point = event.GetPoint(0);
 929
 930       const bool flip = mSwapSelectionHandles != mHandle[LEFT_SELECTION_HANDLE].flipped;
 931       if( TouchPoint::Down == point.state )
 932       {
 933         mHandle[LEFT_SELECTION_HANDLE].pressed = true;
 934         Image imagePressed = mHandleImages[flip ? RIGHT_SELECTION_HANDLE : LEFT_SELECTION_HANDLE][HANDLE_IMAGE_PRESSED];
 935         if( imagePressed )
 936         {
 937           mHandle[LEFT_SELECTION_HANDLE].actor.SetImage( imagePressed );
 938         }
 939       }
 940       else if( ( TouchPoint::Up == point.state ) ||
 941                ( TouchPoint::Interrupted == point.state ) )
 942       {
 943         mHandle[LEFT_SELECTION_HANDLE].pressed = false;
 944         Image imageReleased = mHandleImages[flip ? RIGHT_SELECTION_HANDLE : LEFT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED];
 945         if( imageReleased )
 946         {
 947           mHandle[LEFT_SELECTION_HANDLE].actor.SetImage( imageReleased );
 948         }
 949       }
 950     }
 951
 952     // Consume to avoid pop-ups accidentally closing, when handle is outside of pop-up area
 953     return true;
 954   }
 955
 956   bool OnHandleTwoTouched( Actor actor, const TouchEvent& event )
 957   {
 958     // Switch between pressed/release selection handle images
 959     if( event.GetPointCount() > 0 &&
 960         mHandle[RIGHT_SELECTION_HANDLE].actor )
 961     {
 962       const TouchPoint& point = event.GetPoint(0);
 963
 964       const bool flip = mSwapSelectionHandles != mHandle[RIGHT_SELECTION_HANDLE].flipped;
 965       if( TouchPoint::Down == point.state )
 966       {
 967         Image imagePressed = mHandleImages[flip ? LEFT_SELECTION_HANDLE : RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_PRESSED];
 968         mHandle[RIGHT_SELECTION_HANDLE].pressed = true;
 969         if( imagePressed )
 970         {
 971           mHandle[RIGHT_SELECTION_HANDLE].actor.SetImage( imagePressed );
 972         }
 973       }
 974       else if( ( TouchPoint::Up == point.state ) ||
 975                ( TouchPoint::Interrupted == point.state ) )
 976       {
 977         Image imageReleased = mHandleImages[flip ? LEFT_SELECTION_HANDLE : RIGHT_SELECTION_HANDLE][HANDLE_IMAGE_RELEASED];
 978         mHandle[RIGHT_SELECTION_HANDLE].pressed = false;
 979         if( imageReleased )
 980         {
 981           mHandle[RIGHT_SELECTION_HANDLE].actor.SetImage( imageReleased );
 982         }
 983       }
 984     }
 985
 986     // Consume to avoid pop-ups accidentally closing, when handle is outside of pop-up area
 987     return true;
 988   }
 989
 990   // Popup
 991
 992   float AlternatePopUpPositionRelativeToCursor()
 993   {
 994     float alternativePosition=0.0f;;
 995
 996     if ( mPrimaryCursor ) // Secondary cursor not used for paste
 997     {
 998       Cursor cursor = PRIMARY_CURSOR;
 999       alternativePosition = mCursor[cursor].position.y;
1000     }
1001
1002     const float popupHeight = 120.0f; // todo Set as a MaxSize Property in Control or retrieve from CopyPastePopup class.
1003
1004     if( mHandle[GRAB_HANDLE].active )
1005     {
1006       // If grab handle enabled then position pop-up below the grab handle.
1007       const Vector2 grabHandleSize( 59.0f, 56.0f ); // todo
1008       const float BOTTOM_HANDLE_BOTTOM_OFFSET = 1.5; //todo Should be a property
1009       alternativePosition +=  grabHandleSize.height  + popupHeight + BOTTOM_HANDLE_BOTTOM_OFFSET ;
1010     }
1011     else
1012     {
1013       alternativePosition += popupHeight;
1014     }
1015
1016     return alternativePosition;
1017   }
1018
1019   void PopUpLeavesVerticalBoundary( PropertyNotification& source )
1020   {
1021     float alternativeYPosition=0.0f;
1022     // todo use AlternatePopUpPositionRelativeToSelectionHandles() if text is highlighted
1023     // if can't be positioned above, then position below row.
1024     alternativeYPosition = AlternatePopUpPositionRelativeToCursor();
1025
1026     mCopyPastePopup.actor.SetY( alternativeYPosition );
1027   }
1028
1029
1030   void SetUpPopupPositionNotifications( )
1031   {
1032     // Note Property notifications ignore any set anchor point so conditions must allow for this.  Default is Top Left.
1033
1034     // Exceeding vertical boundary
1035
1036     Vector4 worldCoordinatesBoundingBox;
1037     LocalToWorldCoordinatesBoundingBox( mBoundingBox, worldCoordinatesBoundingBox );
1038
1039     float popupHeight = mCopyPastePopup.actor.GetRelayoutSize( Dimension::HEIGHT);
1040
1041     PropertyNotification verticalExceedNotification = mCopyPastePopup.actor.AddPropertyNotification( Actor::Property::WORLD_POSITION_Y,
1042                                                       OutsideCondition( worldCoordinatesBoundingBox.y + popupHeight * 0.5f,
1043                                                                         worldCoordinatesBoundingBox.w - popupHeight * 0.5f ) );
1044
1045     verticalExceedNotification.NotifySignal().Connect( this, &Decorator::Impl::PopUpLeavesVerticalBoundary );
1046   }
1047
1048   void GetConstrainedPopupPosition( Vector3& requiredPopupPosition, Vector3& popupSize, Vector3 anchorPoint, Actor& parent, Rect<int>& boundingBox )
1049   {
1050     DALI_ASSERT_DEBUG ( "Popup parent not on stage" && parent.OnStage() )
1051
1052     // Parent must already by added to Stage for these Get calls to work
1053     Vector3 parentAnchorPoint = parent.GetCurrentAnchorPoint();
1054     Vector3 parentWorldPositionLeftAnchor = parent.GetCurrentWorldPosition() - parent.GetCurrentSize()*parentAnchorPoint;
1055     Vector3 popupWorldPosition = parentWorldPositionLeftAnchor + requiredPopupPosition;  // Parent World position plus popup local position gives World Position
1056     Vector3 popupDistanceFromAnchorPoint = popupSize*anchorPoint;
1057
1058     // Bounding rectangle is supplied as screen coordinates, bounding will be done in world coordinates.
1059     Vector4 boundingRectangleWorld;
1060     LocalToWorldCoordinatesBoundingBox( boundingBox, boundingRectangleWorld );
1061
1062     // Calculate distance to move popup (in local space) so fits within the boundary
1063     float xOffSetToKeepWithinBounds = 0.0f;
1064     if( popupWorldPosition.x - popupDistanceFromAnchorPoint.x < boundingRectangleWorld.x )
1065     {
1066       xOffSetToKeepWithinBounds = boundingRectangleWorld.x - ( popupWorldPosition.x - popupDistanceFromAnchorPoint.x );
1067     }
1068     else if ( popupWorldPosition.x +  popupDistanceFromAnchorPoint.x > boundingRectangleWorld.z )
1069     {
1070       xOffSetToKeepWithinBounds = boundingRectangleWorld.z - ( popupWorldPosition.x +  popupDistanceFromAnchorPoint.x );
1071     }
1072
1073     // Ensure initial display of Popup is in alternative position if can not fit above. As Property notification will be a frame behind.
1074     if ( popupWorldPosition.y - popupDistanceFromAnchorPoint.y < boundingRectangleWorld.y )
1075     {
1076       requiredPopupPosition.y = AlternatePopUpPositionRelativeToCursor();
1077     }
1078
1079     requiredPopupPosition.x = requiredPopupPosition.x + xOffSetToKeepWithinBounds;
1080
1081     // Prevent pixel mis-alignment by rounding down.
1082     requiredPopupPosition.x = static_cast<int>( requiredPopupPosition.x );
1083     requiredPopupPosition.y = static_cast<int>( requiredPopupPosition.y );
1084
1085   }
1086
1087   void FlipSelectionHandleImages()
1088   {
1089     SetupTouchEvents();
1090
1091     CreateSelectionHandles();
1092
1093     HandleImpl& leftHandle = mHandle[LEFT_SELECTION_HANDLE];
1094     HandleImpl& rightHandle = mHandle[RIGHT_SELECTION_HANDLE];
1095
1096     const HandleImageType leftImageType = leftHandle.pressed ? HANDLE_IMAGE_PRESSED : HANDLE_IMAGE_RELEASED;
1097     const HandleImageType rightImageType = rightHandle.pressed ? HANDLE_IMAGE_PRESSED : HANDLE_IMAGE_RELEASED;
1098     const bool leftFlipped = mSwapSelectionHandles != leftHandle.flipped;
1099     const bool rightFlipped = mSwapSelectionHandles != rightHandle.flipped;
1100
1101     leftHandle.actor.SetImage( leftFlipped ? mHandleImages[RIGHT_SELECTION_HANDLE][leftImageType] : mHandleImages[LEFT_SELECTION_HANDLE][leftImageType] );
1102
1103     leftHandle.actor.SetAnchorPoint( leftFlipped ? AnchorPoint::TOP_LEFT : AnchorPoint::TOP_RIGHT );
1104
1105     rightHandle.actor.SetImage( rightFlipped ? mHandleImages[LEFT_SELECTION_HANDLE][rightImageType] : mHandleImages[RIGHT_SELECTION_HANDLE][rightImageType] );
1106
1107     rightHandle.actor.SetAnchorPoint( rightFlipped ? AnchorPoint::TOP_RIGHT : AnchorPoint::TOP_LEFT );
1108   }
1109
1110   void SetScrollThreshold( float threshold )
1111   {
1112     mScrollThreshold = threshold;
1113   }
1114
1115   float GetScrollThreshold() const
1116   {
1117     return mScrollThreshold;
1118   }
1119
1120   void SetScrollSpeed( float speed )
1121   {
1122     mScrollSpeed = speed;
1123     mScrollDistance = speed * SCROLL_TICK_INTERVAL * TO_SECONDS;
1124   }
1125
1126   float GetScrollSpeed() const
1127   {
1128     return mScrollSpeed;
1129   }
1130
1131   void NotifyEndOfScroll()
1132   {
1133     StopScrollTimer();
1134
1135     if( mScrollTimer )
1136     {
1137       mNotifyEndOfScroll = true;
1138     }
1139   }
1140
1141   /**
1142    * Creates and starts a timer to scroll the text when handles are close to the edges of the text.
1143    *
1144    * It only starts the timer if it's already created.
1145    */
1146   void StartScrollTimer()
1147   {
1148     if( !mScrollTimer )
1149     {
1150       mScrollTimer = Timer::New( SCROLL_TICK_INTERVAL );
1151       mScrollTimer.TickSignal().Connect( this, &Decorator::Impl::OnScrollTimerTick );
1152     }
1153
1154     if( !mScrollTimer.IsRunning() )
1155     {
1156       mScrollTimer.Start();
1157     }
1158   }
1159
1160   /**
1161    * Stops the timer used to scroll the text.
1162    */
1163   void StopScrollTimer()
1164   {
1165     if( mScrollTimer )
1166     {
1167       mScrollTimer.Stop();
1168     }
1169   }
1170
1171   /**
1172    * Callback called by the timer used to scroll the text.
1173    *
1174    * It calculates and sets a new scroll position.
1175    */
1176   bool OnScrollTimerTick()
1177   {
1178     if( HANDLE_TYPE_COUNT != mHandleScrolling )
1179     {
1180       mController.DecorationEvent( mHandleScrolling,
1181                                    HANDLE_SCROLLING,
1182                                    mScrollDirection == SCROLL_RIGHT ? mScrollDistance : -mScrollDistance,
1183                                    0.f );
1184     }
1185
1186     return true;
1187   }
1188
1189   ControllerInterface& mController;
1190
1191   TapGestureDetector  mTapDetector;
1192   PanGestureDetector  mPanGestureDetector;
1193   Timer               mCursorBlinkTimer;          ///< Timer to signal cursor to blink
1194   Timer               mScrollTimer;               ///< Timer used to scroll the text when the grab handle is moved close to the edges.
1195
1196   Layer               mActiveLayer;               ///< Layer for active handles and alike that ensures they are above all else.
1197   ImageActor          mPrimaryCursor;
1198   ImageActor          mSecondaryCursor;
1199
1200   Actor               mHighlightActor;        ///< Actor to display highlight
1201   Renderer            mHighlightRenderer;
1202   Material            mHighlightMaterial;         ///< Material used for highlight
1203   Property::Map       mQuadVertexFormat;
1204   Property::Map       mQuadIndexFormat;
1205   PopupImpl           mCopyPastePopup;
1206   TextSelectionPopup::Buttons mEnabledPopupButtons; /// Bit mask of currently enabled Popup buttons
1207   TextSelectionPopupCallbackInterface& mTextSelectionPopupCallbackInterface;
1208
1209   Image               mHandleImages[HANDLE_TYPE_COUNT][HANDLE_IMAGE_TYPE_COUNT];
1210   Image               mCursorImage;
1211
1212   CursorImpl          mCursor[CURSOR_COUNT];
1213   HandleImpl          mHandle[HANDLE_TYPE_COUNT];
1214   QuadContainer       mHighlightQuadList;         ///< Sub-selections that combine to create the complete selection highlight
1215
1216   Rect<int>           mBoundingBox;
1217   Vector4             mHighlightColor;            ///< Color of the highlight
1218   Vector2             mHighlightPosition;         ///< The position of the highlight actor.
1219
1220   unsigned int        mActiveCursor;
1221   unsigned int        mCursorBlinkInterval;
1222   float               mCursorBlinkDuration;
1223   HandleType          mHandleScrolling;         ///< The handle which is scrolling.
1224   ScrollDirection     mScrollDirection;         ///< The direction of the scroll.
1225   float               mScrollThreshold;         ///< Defines a square area inside the control, close to the edge. A cursor entering this area will trigger scroll events.
1226   float               mScrollSpeed;             ///< The scroll speed in pixels per second.
1227   float               mScrollDistance;          ///< Distance the text scrolls during a scroll interval.
1228
1229   bool                mActiveCopyPastePopup   : 1;
1230   bool                mCursorBlinkStatus      : 1; ///< Flag to switch between blink on and blink off.
1231   bool                mPrimaryCursorVisible   : 1; ///< Whether the primary cursor is visible.
1232   bool                mSecondaryCursorVisible : 1; ///< Whether the secondary cursor is visible.
1233   bool                mSwapSelectionHandles   : 1; ///< Whether to swap the selection handle images.
1234   bool                mNotifyEndOfScroll      : 1; ///< Whether to notify the end of the scroll.
1235 };
1236
1237 DecoratorPtr Decorator::New( ControllerInterface& controller,
1238                              TextSelectionPopupCallbackInterface& callbackInterface )
1239 {
1240   return DecoratorPtr( new Decorator( controller,
1241                                       callbackInterface ) );
1242 }
1243
1244 void Decorator::SetBoundingBox( const Rect<int>& boundingBox )
1245 {
1246   mImpl->mBoundingBox = boundingBox;
1247 }
1248
1249 const Rect<int>& Decorator::GetBoundingBox() const
1250 {
1251   return mImpl->mBoundingBox;
1252 }
1253
1254 void Decorator::Relayout( const Vector2& size )
1255 {
1256   mImpl->Relayout( size );
1257 }
1258
1259 void Decorator::UpdatePositions( const Vector2& scrollOffset )
1260 {
1261   mImpl->UpdatePositions( scrollOffset );
1262 }
1263
1264 /** Cursor **/
1265
1266 void Decorator::SetActiveCursor( ActiveCursor activeCursor )
1267 {
1268   mImpl->mActiveCursor = activeCursor;
1269 }
1270
1271 unsigned int Decorator::GetActiveCursor() const
1272 {
1273   return mImpl->mActiveCursor;
1274 }
1275
1276 void Decorator::SetPosition( Cursor cursor, float x, float y, float cursorHeight, float lineHeight )
1277 {
1278   mImpl->mCursor[cursor].position.x = x;
1279   mImpl->mCursor[cursor].position.y = y;
1280   mImpl->mCursor[cursor].cursorHeight = cursorHeight;
1281   mImpl->mCursor[cursor].lineHeight = lineHeight;
1282 }
1283
1284 void Decorator::GetPosition( Cursor cursor, float& x, float& y, float& cursorHeight, float& lineHeight ) const
1285 {
1286   x = mImpl->mCursor[cursor].position.x;
1287   y = mImpl->mCursor[cursor].position.y;
1288   cursorHeight = mImpl->mCursor[cursor].cursorHeight;
1289   lineHeight = mImpl->mCursor[cursor].lineHeight;
1290 }
1291
1292 const Vector2& Decorator::GetPosition( Cursor cursor ) const
1293 {
1294   return mImpl->mCursor[cursor].position;
1295 }
1296
1297 void Decorator::SetColor( Cursor cursor, const Dali::Vector4& color )
1298 {
1299   mImpl->mCursor[cursor].color = color;
1300 }
1301
1302 const Dali::Vector4& Decorator::GetColor( Cursor cursor ) const
1303 {
1304   return mImpl->mCursor[cursor].color;
1305 }
1306
1307 void Decorator::StartCursorBlink()
1308 {
1309   if ( !mImpl->mCursorBlinkTimer )
1310   {
1311     mImpl->mCursorBlinkTimer = Timer::New( mImpl->mCursorBlinkInterval );
1312     mImpl->mCursorBlinkTimer.TickSignal().Connect( mImpl, &Decorator::Impl::OnCursorBlinkTimerTick );
1313   }
1314
1315   if ( !mImpl->mCursorBlinkTimer.IsRunning() )
1316   {
1317     mImpl->mCursorBlinkTimer.Start();
1318   }
1319 }
1320
1321 void Decorator::StopCursorBlink()
1322 {
1323   if ( mImpl->mCursorBlinkTimer )
1324   {
1325     mImpl->mCursorBlinkTimer.Stop();
1326   }
1327 }
1328
1329 void Decorator::SetCursorBlinkInterval( float seconds )
1330 {
1331   mImpl->mCursorBlinkInterval = static_cast<unsigned int>( seconds * TO_MILLISECONDS ); // Convert to milliseconds
1332 }
1333
1334 float Decorator::GetCursorBlinkInterval() const
1335 {
1336   return static_cast<float>( mImpl->mCursorBlinkInterval ) * TO_SECONDS;
1337 }
1338
1339 void Decorator::SetCursorBlinkDuration( float seconds )
1340 {
1341   mImpl->mCursorBlinkDuration = seconds;
1342 }
1343
1344 float Decorator::GetCursorBlinkDuration() const
1345 {
1346   return mImpl->mCursorBlinkDuration;
1347 }
1348
1349 /** Handles **/
1350
1351 void Decorator::SetHandleActive( HandleType handleType, bool active )
1352 {
1353   mImpl->mHandle[handleType].active = active;
1354
1355   if( !active )
1356   {
1357     // TODO: this is a work-around.
1358     // The problem is the handle actor does not receive the touch event with the Interrupt
1359     // state when the power button is pressed and the application goes to background.
1360     mImpl->mHandle[handleType].pressed = false;
1361     Image imageReleased = mImpl->mHandleImages[handleType][HANDLE_IMAGE_RELEASED];
1362     ImageActor imageActor = mImpl->mHandle[handleType].actor;
1363     if( imageReleased && imageActor )
1364     {
1365        imageActor.SetImage( imageReleased );
1366     }
1367   }
1368 }
1369
1370 bool Decorator::IsHandleActive( HandleType handleType ) const
1371 {
1372   return mImpl->mHandle[handleType].active ;
1373 }
1374
1375 void Decorator::SetHandleImage( HandleType handleType, HandleImageType handleImageType, Dali::Image image )
1376 {
1377   mImpl->mHandleImages[handleType][handleImageType] = image;
1378 }
1379
1380 Dali::Image Decorator::GetHandleImage( HandleType handleType, HandleImageType handleImageType ) const
1381 {
1382   return mImpl->mHandleImages[handleType][handleImageType];
1383 }
1384
1385 void Decorator::SetPosition( HandleType handleType, float x, float y, float height )
1386 {
1387   // Adjust grab handle displacement
1388   Impl::HandleImpl& handle = mImpl->mHandle[handleType];
1389
1390   handle.grabDisplacementX -= x - handle.position.x;
1391   handle.grabDisplacementY -= y - handle.position.y;
1392
1393   handle.position.x = x;
1394   handle.position.y = y;
1395   handle.lineHeight = height;
1396 }
1397
1398 void Decorator::GetPosition( HandleType handleType, float& x, float& y, float& height ) const
1399 {
1400   Impl::HandleImpl& handle = mImpl->mHandle[handleType];
1401
1402   x = handle.position.x;
1403   y = handle.position.y;
1404   height = handle.lineHeight;
1405 }
1406
1407 const Vector2& Decorator::GetPosition( HandleType handleType ) const
1408 {
1409   return mImpl->mHandle[handleType].position;
1410 }
1411
1412 void Decorator::SwapSelectionHandlesEnabled( bool enable )
1413 {
1414   mImpl->mSwapSelectionHandles = enable;
1415
1416   mImpl->FlipSelectionHandleImages();
1417 }
1418
1419 void Decorator::AddHighlight( float x1, float y1, float x2, float y2 )
1420 {
1421   mImpl->mHighlightQuadList.push_back( QuadCoordinates(x1, y1, x2, y2) );
1422 }
1423
1424 void Decorator::ClearHighlights()
1425 {
1426   mImpl->mHighlightQuadList.clear();
1427   mImpl->mHighlightPosition = Vector2::ZERO;
1428 }
1429
1430 void Decorator::SetHighlightColor( const Vector4& color )
1431 {
1432   mImpl->mHighlightColor = color;
1433 }
1434
1435 const Vector4& Decorator::GetHighlightColor() const
1436 {
1437   return mImpl->mHighlightColor;
1438 }
1439
1440 void Decorator::SetPopupActive( bool active )
1441 {
1442   mImpl->mActiveCopyPastePopup = active;
1443 }
1444
1445 bool Decorator::IsPopupActive() const
1446 {
1447   return mImpl->mActiveCopyPastePopup ;
1448 }
1449
1450 void Decorator::SetEnabledPopupButtons( TextSelectionPopup::Buttons& enabledButtonsBitMask )
1451 {
1452    mImpl->mEnabledPopupButtons = enabledButtonsBitMask;
1453 }
1454
1455 TextSelectionPopup::Buttons& Decorator::GetEnabledPopupButtons()
1456 {
1457   return mImpl->mEnabledPopupButtons;
1458 }
1459
1460 /** Scroll **/
1461
1462 void Decorator::SetScrollThreshold( float threshold )
1463 {
1464   mImpl->SetScrollThreshold( threshold );
1465 }
1466
1467 float Decorator::GetScrollThreshold() const
1468 {
1469   return mImpl->GetScrollThreshold();
1470 }
1471
1472 void Decorator::SetScrollSpeed( float speed )
1473 {
1474   mImpl->SetScrollSpeed( speed );
1475 }
1476
1477 float Decorator::GetScrollSpeed() const
1478 {
1479   return mImpl->GetScrollSpeed();
1480 }
1481
1482 void Decorator::NotifyEndOfScroll()
1483 {
1484   mImpl->NotifyEndOfScroll();
1485 }
1486
1487 Decorator::~Decorator()
1488 {
1489   delete mImpl;
1490 }
1491
1492 Decorator::Decorator( ControllerInterface& controller,
1493                       TextSelectionPopupCallbackInterface& callbackInterface )
1494 : mImpl( NULL )
1495 {
1496   mImpl = new Decorator::Impl( controller, callbackInterface );
1497 }
1498
1499 } // namespace Text
1500
1501 } // namespace Toolkit
1502
1503 } // namespace Dali