examples/image-scaling-irregular-grid/image-scaling-irregular-grid-example.cpp

   1 /*
   2  * Copyright (c) 2020 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 /**
  19  * @file image-scaling-irregular-grid-example.cpp
  20  * @brief Demonstrates how to use image scaling modes when loading images.
  21  *
  22  * If an image is going to be drawn on-screen at a lower resolution than it is
  23  * stored at on-disk, the scaling feature of the image loader can be used to
  24  * reduce the image to save memory, improve performance, and potentially display
  25  * a better small version of the image than if the default size were loaded.
  26  *
  27  * The functions CreateImage and CreateImageView below show how to build an
  28  * image using a scaling mode to have %Dali resize it during loading.
  29  *
  30  * This demo defaults to the SCALE_TO_FILL mode of ImageAttributes which makes
  31  * sure that every pixel in the loaded image is filled with a source colour
  32  * from the image's central region while losing the minimum number of pixels
  33  * from its periphery.
  34  * It is the best option for producing thumbnails of input images that have
  35  * diverse aspect ratios.
  36  *
  37  * The other four scaling modes of dali can be cycled-through for the whole
  38  * grid  using the button in the top-right of the toolbar.
  39  * A single image can be cycled by clicking the image directly.
  40  *
  41  * @see CreateImage CreateImageView
  42  */
  43
  44 // EXTERNAL INCLUDES
  45 #include <algorithm>
  46 #include <map>
  47 #include <dali-toolkit/dali-toolkit.h>
  48 #include <iostream>
  49 #include <dali-toolkit/devel-api/controls/control-devel.h>
  50 #include <dali-toolkit/devel-api/controls/scroll-bar/scroll-bar.h>
  51
  52 // INTERNAL INCLUDES
  53 #include "grid-flags.h"
  54 #include "shared/view.h"
  55
  56 using namespace Dali;
  57 using namespace Dali::Toolkit;
  58 using namespace Dali::Demo;
  59
  60 namespace
  61 {
  62
  63 /** Controls the output of application logging. */
  64 //#define DEBUG_PRINT_DIAGNOSTICS;
  65
  66 const char* BACKGROUND_IMAGE( DEMO_IMAGE_DIR "background-gradient.jpg" );
  67 const char* TOOLBAR_IMAGE( DEMO_IMAGE_DIR "top-bar.png" );
  68 const char* APPLICATION_TITLE( "Image Scaling Modes" );
  69 const char* TOGGLE_SCALING_IMAGE( DEMO_IMAGE_DIR "icon-change.png" );
  70 const char* TOGGLE_SCALING_IMAGE_SELECTED( DEMO_IMAGE_DIR "icon-change-selected.png" );
  71
  72 /** The width of the grid in whole grid cells. */
  73 const unsigned GRID_WIDTH = 9;
  74 /** Limit the grid to be no higher than this in units of a cell. */
  75 const unsigned GRID_MAX_HEIGHT = 600;
  76
  77 /** The space between the edge of a grid cell and the image embedded within it. */
  78 const unsigned GRID_CELL_PADDING = 4;
  79
  80 /** The aspect ratio of cells in the image grid. */
  81 const float CELL_ASPECT_RATIO = 1.33333333333333333333f;
  82
  83 const Dali::FittingMode::Type DEFAULT_SCALING_MODE = Dali::FittingMode::SCALE_TO_FILL;
  84
  85 /** The number of times to spin an image on touching, each spin taking a second.*/
  86 const float SPIN_DURATION = 1.0f;
  87
  88 /** The target image sizes in grid cells. */
  89 const Vector2 IMAGE_SIZES[] = {
  90  Vector2( 1, 1 ),
  91  Vector2( 2, 1 ),
  92  Vector2( 3, 1 ),
  93  Vector2( 1, 2 ),
  94  Vector2( 1, 3 ),
  95  Vector2( 2, 3 ),
  96  Vector2( 3, 2 ),
  97  // Large, tall configuration:
  98  Vector2( GRID_WIDTH / 2, GRID_WIDTH + GRID_WIDTH / 2 ),
  99  // Large, square-ish images to show shrink-to-fit well with wide and tall images:
 100  Vector2( GRID_WIDTH / 2, GRID_WIDTH / 2.0f * CELL_ASPECT_RATIO + 0.5f ),
 101  Vector2( GRID_WIDTH - 2, (GRID_WIDTH - 2) * CELL_ASPECT_RATIO + 0.5f ),
 102 };
 103 const unsigned NUM_IMAGE_SIZES = sizeof(IMAGE_SIZES) / sizeof(IMAGE_SIZES[0]);
 104
 105 /** Images to load into the grid. These are mostly large and non-square to
 106  *  show the scaling. */
 107 const char* IMAGE_PATHS[] = {
 108
 109   DEMO_IMAGE_DIR "dali-logo.png",
 110   DEMO_IMAGE_DIR "com.samsung.dali-demo.ico",
 111   DEMO_IMAGE_DIR "square_primitive_shapes.bmp",
 112   DEMO_IMAGE_DIR "gallery-large-14.wbmp",
 113
 114   // Images that show aspect ratio changes clearly in primitive shapes:
 115
 116   DEMO_IMAGE_DIR "portrait_screen_primitive_shapes.gif",
 117   DEMO_IMAGE_DIR "landscape_screen_primitive_shapes.gif",
 118
 119   // Images from other demos that are tall, wide or just large:
 120
 121   DEMO_IMAGE_DIR "gallery-large-1.jpg",
 122   DEMO_IMAGE_DIR "gallery-large-2.jpg",
 123   DEMO_IMAGE_DIR "gallery-large-3.jpg",
 124   DEMO_IMAGE_DIR "gallery-large-4.jpg",
 125   DEMO_IMAGE_DIR "gallery-large-5.jpg",
 126   DEMO_IMAGE_DIR "gallery-large-6.jpg",
 127   DEMO_IMAGE_DIR "gallery-large-7.jpg",
 128   DEMO_IMAGE_DIR "gallery-large-8.jpg",
 129   DEMO_IMAGE_DIR "gallery-large-9.jpg",
 130   DEMO_IMAGE_DIR "gallery-large-10.jpg",
 131   DEMO_IMAGE_DIR "gallery-large-11.jpg",
 132   DEMO_IMAGE_DIR "gallery-large-12.jpg",
 133   DEMO_IMAGE_DIR "gallery-large-13.jpg",
 134   DEMO_IMAGE_DIR "gallery-large-14.jpg",
 135   DEMO_IMAGE_DIR "gallery-large-15.jpg",
 136   DEMO_IMAGE_DIR "gallery-large-16.jpg",
 137   DEMO_IMAGE_DIR "gallery-large-17.jpg",
 138   DEMO_IMAGE_DIR "gallery-large-18.jpg",
 139   DEMO_IMAGE_DIR "gallery-large-19.jpg",
 140   DEMO_IMAGE_DIR "gallery-large-20.jpg",
 141   DEMO_IMAGE_DIR "gallery-large-21.jpg",
 142
 143   DEMO_IMAGE_DIR "background-1.jpg",
 144   DEMO_IMAGE_DIR "background-2.jpg",
 145   DEMO_IMAGE_DIR "background-3.jpg",
 146   DEMO_IMAGE_DIR "background-4.jpg",
 147   DEMO_IMAGE_DIR "background-5.jpg",
 148   DEMO_IMAGE_DIR "background-blocks.jpg",
 149   DEMO_IMAGE_DIR "background-magnifier.jpg",
 150
 151   DEMO_IMAGE_DIR "background-1.jpg",
 152   DEMO_IMAGE_DIR "background-2.jpg",
 153   DEMO_IMAGE_DIR "background-3.jpg",
 154   DEMO_IMAGE_DIR "background-4.jpg",
 155   DEMO_IMAGE_DIR "background-5.jpg",
 156   DEMO_IMAGE_DIR "background-blocks.jpg",
 157   DEMO_IMAGE_DIR "background-magnifier.jpg",
 158
 159   DEMO_IMAGE_DIR "book-landscape-cover-back.jpg",
 160   DEMO_IMAGE_DIR "book-landscape-cover.jpg",
 161   DEMO_IMAGE_DIR "book-landscape-p1.jpg",
 162   DEMO_IMAGE_DIR "book-landscape-p2.jpg",
 163
 164   DEMO_IMAGE_DIR "book-portrait-cover.jpg",
 165   DEMO_IMAGE_DIR "book-portrait-p1.jpg",
 166   DEMO_IMAGE_DIR "book-portrait-p2.jpg",
 167   NULL
 168 };
 169 const unsigned NUM_IMAGE_PATHS = sizeof(IMAGE_PATHS) / sizeof(IMAGE_PATHS[0]) - 1u;
 170 const unsigned int INITIAL_IMAGES_TO_LOAD = 10;
 171
 172
 173 /**
 174  * Creates an ImageView
 175  *
 176  * @param[in] filename The path of the image.
 177  * @param[in] width The width of the image in pixels.
 178  * @param[in] height The height of the image in pixels.
 179  * @param[in] fittingMode The mode to use when scaling the image to fit the desired dimensions.
 180  */
 181 ImageView CreateImageView(const std::string& filename, int width, int height, Dali::FittingMode::Type fittingMode )
 182 {
 183
 184   ImageView imageView = ImageView::New();
 185
 186   Property::Map map;
 187   map[Toolkit::ImageVisual::Property::URL] = filename;
 188   map[Toolkit::ImageVisual::Property::DESIRED_WIDTH] = width;
 189   map[Toolkit::ImageVisual::Property::DESIRED_HEIGHT] = height;
 190   map[Toolkit::ImageVisual::Property::FITTING_MODE] = fittingMode;
 191   imageView.SetProperty( Toolkit::ImageView::Property::IMAGE, map );
 192
 193   imageView.SetProperty( Dali::Actor::Property::NAME, filename );
 194   imageView.SetProperty( Actor::Property::PARENT_ORIGIN,ParentOrigin::CENTER);
 195   imageView.SetProperty( Actor::Property::ANCHOR_POINT,AnchorPoint::CENTER);
 196
 197   return imageView;
 198 }
 199
 200 /** Cycle the scaling mode options. */
 201 Dali::FittingMode::Type NextMode( const Dali::FittingMode::Type oldMode )
 202 {
 203   Dali::FittingMode::Type newMode = FittingMode::SHRINK_TO_FIT;
 204   switch ( oldMode )
 205   {
 206     case FittingMode::SHRINK_TO_FIT:
 207       newMode = FittingMode::SCALE_TO_FILL;
 208       break;
 209     case FittingMode::SCALE_TO_FILL:
 210       newMode = FittingMode::FIT_WIDTH;
 211       break;
 212     case FittingMode::FIT_WIDTH:
 213       newMode = FittingMode::FIT_HEIGHT;
 214       break;
 215     case FittingMode::FIT_HEIGHT:
 216       newMode = FittingMode::SHRINK_TO_FIT;
 217       break;
 218   }
 219   return newMode;
 220 }
 221
 222 /**
 223  * Bundle an image path with the rectangle to pack it into.
 224  * */
 225 struct ImageConfiguration
 226 {
 227   ImageConfiguration( const char * const path, const Vector2 dimensions ) :
 228     path( path ),
 229     dimensions( dimensions )
 230   {}
 231   const char * path;
 232   Vector2 dimensions;
 233 };
 234
 235 /**
 236  * Post-layout image data.
 237  */
 238 struct PositionedImage
 239 {
 240   PositionedImage(ImageConfiguration& configuration, unsigned cellX, unsigned cellY, Vector2 imageGridDims) :
 241     configuration( configuration ),
 242     cellX( cellX ),
 243     cellY( cellY ),
 244     imageGridDims( imageGridDims )
 245   {}
 246
 247   ImageConfiguration configuration;
 248   unsigned cellX;
 249   unsigned cellY;
 250   Vector2 imageGridDims;
 251 };
 252
 253 }
 254
 255 /**
 256  * @brief The main class of the demo.
 257  */
 258 class ImageScalingIrregularGridController : public ConnectionTracker
 259 {
 260 public:
 261
 262   ImageScalingIrregularGridController( Application& application )
 263   : mApplication( application ),
 264     mScrolling( false ),
 265     mImagesLoaded( 0 )
 266   {
 267     std::cout << "ImageScalingIrregularGridController::ImageScalingIrregularGridController" << std::endl;
 268
 269     // Connect to the Application's Init signal
 270     mApplication.InitSignal().Connect( this, &ImageScalingIrregularGridController::Create );
 271   }
 272
 273   ~ImageScalingIrregularGridController()
 274   {
 275     // Nothing to do here.
 276   }
 277
 278   /**
 279    * Called everytime an ImageView has loaded it's image
 280    */
 281   void ResourceReadySignal( Toolkit::Control control )
 282   {
 283     mImagesLoaded++;
 284     // To allow fast startup, we only place a small number of ImageViews on window first
 285     if ( mImagesLoaded == INITIAL_IMAGES_TO_LOAD )
 286     {
 287       // Adding the ImageViews to the window will trigger loading of the Images
 288       mGridActor.Add( mOffWindowImageViews );
 289     }
 290   }
 291
 292
 293   /**
 294    * One-time setup in response to Application InitSignal.
 295    */
 296   void Create( Application& application )
 297   {
 298     std::cout << "ImageScalingIrregularGridController::Create" << std::endl;
 299
 300     // Get a handle to the window:
 301     Window window = application.GetWindow();
 302
 303     // Connect to input event signals:
 304     window.KeyEventSignal().Connect(this, &ImageScalingIrregularGridController::OnKeyEvent);
 305
 306     // Create a default view with a default tool bar:
 307     mContentLayer = DemoHelper::CreateView( mApplication,
 308                                             mView,
 309                                             mToolBar,
 310                                             BACKGROUND_IMAGE,
 311                                             TOOLBAR_IMAGE,
 312                                             "" );
 313
 314     // Create an image scaling toggle button. (right of toolbar)
 315     Toolkit::PushButton toggleScalingButton = Toolkit::PushButton::New();
 316     toggleScalingButton.SetProperty( Toolkit::Button::Property::UNSELECTED_BACKGROUND_VISUAL, TOGGLE_SCALING_IMAGE );
 317     toggleScalingButton.SetProperty( Toolkit::Button::Property::SELECTED_BACKGROUND_VISUAL, TOGGLE_SCALING_IMAGE_SELECTED );
 318     toggleScalingButton.ClickedSignal().Connect( this, &ImageScalingIrregularGridController::OnToggleScalingTouched );
 319     mToolBar.AddControl( toggleScalingButton, DemoHelper::DEFAULT_VIEW_STYLE.mToolBarButtonPercentage, Toolkit::Alignment::HorizontalRight, DemoHelper::DEFAULT_MODE_SWITCH_PADDING  );
 320
 321     SetTitle( APPLICATION_TITLE );
 322
 323     mOffWindowImageViews = Actor::New();
 324     mOffWindowImageViews.SetProperty( Actor::Property::ANCHOR_POINT, AnchorPoint::CENTER );
 325     mOffWindowImageViews.SetProperty( Actor::Property::PARENT_ORIGIN,ParentOrigin::CENTER);
 326     mOffWindowImageViews.SetResizePolicy( ResizePolicy::FILL_TO_PARENT, Dimension::ALL_DIMENSIONS );
 327
 328     // Build the main content of the widow:
 329     PopulateContentLayer( DEFAULT_SCALING_MODE );
 330   }
 331
 332   /**
 333    * Build the main part of the application's view.
 334    */
 335   void PopulateContentLayer( const Dali::FittingMode::Type fittingMode )
 336   {
 337     Window window = mApplication.GetWindow();
 338     Vector2 windowSize = window.GetSize();
 339
 340     float fieldHeight;
 341     Actor imageField = BuildImageField( windowSize.x, GRID_WIDTH, GRID_MAX_HEIGHT, fittingMode, fieldHeight );
 342
 343     mScrollView = ScrollView::New();
 344
 345     mScrollView.ScrollStartedSignal().Connect( this, &ImageScalingIrregularGridController::OnScrollStarted );
 346     mScrollView.ScrollCompletedSignal().Connect( this, &ImageScalingIrregularGridController::OnScrollCompleted );
 347
 348     mScrollView.SetProperty( Actor::Property::ANCHOR_POINT,AnchorPoint::CENTER);
 349     mScrollView.SetProperty( Actor::Property::PARENT_ORIGIN,ParentOrigin::CENTER);
 350
 351     mScrollView.SetResizePolicy( ResizePolicy::FILL_TO_PARENT, Dimension::ALL_DIMENSIONS );
 352
 353     mScrollView.SetAxisAutoLock( true );
 354     mScrollView.SetAxisAutoLockGradient( 1.0f );
 355
 356     // Restrict scrolling to mostly vertical only, but with some horizontal wiggle-room:
 357
 358     RulerPtr rulerX = new FixedRuler( windowSize.width ); //< Pull the view back to the grid's centre-line when touch is release using a snapping ruler.
 359     rulerX->SetDomain( RulerDomain( windowSize.width * -0.125f, windowSize.width * 1.125f ) ); //< Scroll slightly left/right of image field.
 360     mScrollView.SetRulerX ( rulerX );
 361
 362     RulerPtr rulerY = new DefaultRuler(); //< Snap in multiples of a screen / window height
 363     rulerY->SetDomain( RulerDomain( - fieldHeight * 0.5f + windowSize.height * 0.5f - GRID_CELL_PADDING, fieldHeight * 0.5f + windowSize.height * 0.5f + GRID_CELL_PADDING ) );
 364     mScrollView.SetRulerY ( rulerY );
 365
 366     mContentLayer.Add( mScrollView );
 367     mScrollView.Add( imageField );
 368     mGridActor = imageField;
 369
 370     // Create the scroll bar
 371     mScrollBarVertical = ScrollBar::New(Toolkit::ScrollBar::Vertical);
 372     mScrollBarVertical.SetProperty( Actor::Property::PARENT_ORIGIN,ParentOrigin::TOP_RIGHT);
 373     mScrollBarVertical.SetProperty( Actor::Property::ANCHOR_POINT,AnchorPoint::TOP_RIGHT);
 374     mScrollBarVertical.SetResizePolicy(Dali::ResizePolicy::FILL_TO_PARENT, Dali::Dimension::HEIGHT);
 375     mScrollBarVertical.SetResizePolicy(Dali::ResizePolicy::FIT_TO_CHILDREN, Dali::Dimension::WIDTH);
 376     mScrollView.Add(mScrollBarVertical);
 377
 378     mScrollBarHorizontal = ScrollBar::New(Toolkit::ScrollBar::Horizontal);
 379     mScrollBarHorizontal.SetProperty( Actor::Property::PARENT_ORIGIN,ParentOrigin::BOTTOM_LEFT);
 380     mScrollBarHorizontal.SetProperty( Actor::Property::ANCHOR_POINT,AnchorPoint::TOP_LEFT);
 381     mScrollBarHorizontal.SetResizePolicy(Dali::ResizePolicy::FIT_TO_CHILDREN, Dali::Dimension::WIDTH);
 382     mScrollBarHorizontal.SetProperty( Actor::Property::ORIENTATION, Quaternion( Quaternion( Radian( 1.5f * Math::PI ), Vector3::ZAXIS) ) );
 383     mScrollView.Add(mScrollBarHorizontal);
 384
 385     mScrollView.OnRelayoutSignal().Connect( this, &ImageScalingIrregularGridController::OnScrollViewRelayout );
 386
 387     // Scroll to top of grid so first images loaded are on-screen:
 388     mScrollView.ScrollTo( Vector2( 0, -1000000 ) );
 389   }
 390
 391   void OnScrollViewRelayout(Actor actor)
 392   {
 393     // Make the height of the horizontal scroll bar to be the same as the width of scroll view.
 394     mScrollBarHorizontal.SetProperty( Actor::Property::SIZE, Vector2(0.0f, mScrollView.GetRelayoutSize( Dimension::WIDTH) ));
 395   }
 396
 397   /**
 398    * Build a field of images scaled into a variety of shapes from very wide,
 399    * through square, to very tall. The images are direct children of the Dali::Actor
 400    * returned.
 401    **/
 402   Actor BuildImageField( const float fieldWidth,
 403                            const unsigned gridWidth,
 404                            const unsigned maxGridHeight,
 405                            Dali::FittingMode::Type fittingMode,
 406                            float & outFieldHeight )
 407   {
 408     // Generate the list of image configurations to be fitted into the field:
 409
 410     std::vector<ImageConfiguration> configurations;
 411     configurations.reserve( NUM_IMAGE_PATHS * NUM_IMAGE_SIZES );
 412     for( unsigned imageIndex = 0; imageIndex < NUM_IMAGE_PATHS; ++imageIndex )
 413     {
 414       for( unsigned dimensionsIndex = 0; dimensionsIndex < NUM_IMAGE_SIZES; ++ dimensionsIndex )
 415       {
 416         configurations.push_back( ImageConfiguration( IMAGE_PATHS[imageIndex], IMAGE_SIZES[dimensionsIndex] ) );
 417       }
 418     }
 419     // Stir-up the list to get some nice irregularity in the generated field:
 420     std::random_shuffle( configurations.begin(), configurations.end() );
 421     std::random_shuffle( configurations.begin(), configurations.end() );
 422
 423     // Place the images in the grid:
 424
 425     std::vector<ImageConfiguration>::iterator config, end;
 426     GridFlags grid( gridWidth, maxGridHeight );
 427     std::vector<PositionedImage> placedImages;
 428
 429     for( config = configurations.begin(), end = configurations.end(); config != end; ++config )
 430     {
 431       unsigned cellX, cellY;
 432       Vector2 imageGridDims;
 433
 434       // Allocate a region of the grid for the image:
 435       bool allocated = grid.AllocateRegion( config->dimensions, cellX, cellY, imageGridDims );
 436       if( !allocated )
 437       {
 438 #ifdef DEBUG_PRINT_DIAGNOSTICS
 439           fprintf( stderr, "Failed to allocate image in grid with dims (%f, %f) and path: %s.\n", config->dimensions.x, config->dimensions.y, config->path );
 440 #endif
 441         continue;
 442       }
 443
 444       placedImages.push_back( PositionedImage( *config, cellX, cellY, imageGridDims ) );
 445     }
 446     DALI_ASSERT_DEBUG( grid.DebugCheckGridValid() && "Cells were set more than once, indicating erroneous overlap in placing images on the grid." );
 447     const unsigned actualGridHeight = grid.GetHighestUsedRow() + 1;
 448
 449     // Take the images images in the grid and turn their logical locations into
 450     // coordinates in a frame defined by a parent actor:
 451
 452     Actor gridActor = Actor::New();
 453     gridActor.SetResizePolicy( ResizePolicy::FILL_TO_PARENT, Dimension::ALL_DIMENSIONS );
 454     gridActor.SetProperty( Actor::Property::PARENT_ORIGIN, ParentOrigin::CENTER );
 455     gridActor.SetProperty( Actor::Property::ANCHOR_POINT, AnchorPoint::CENTER );
 456
 457     // Work out the constants of the grid and cell dimensions and positions:
 458     const float cellWidth = fieldWidth / gridWidth;
 459     const float cellHeight = cellWidth / CELL_ASPECT_RATIO;
 460     const Vector2 cellSize = Vector2( cellWidth, cellHeight );
 461     outFieldHeight = actualGridHeight * cellHeight;
 462     const Vector2 gridOrigin = Vector2( -fieldWidth * 0.5f, -outFieldHeight * 0.5 );
 463
 464      unsigned int count = 0;
 465     // Build the image actors in their right locations in their parent's frame:
 466     for( std::vector<PositionedImage>::const_iterator i = placedImages.begin(), end = placedImages.end(); i != end; ++i, ++count )
 467     {
 468       const PositionedImage& imageSource = *i;
 469       const Vector2 imageSize = imageSource.imageGridDims * cellSize - Vector2( GRID_CELL_PADDING * 2, GRID_CELL_PADDING * 2 );
 470       const Vector2 imageRegionCorner = gridOrigin + cellSize * Vector2( imageSource.cellX, imageSource.cellY );
 471       const Vector2 imagePosition = imageRegionCorner + Vector2( GRID_CELL_PADDING , GRID_CELL_PADDING ) + imageSize * 0.5f;
 472
 473       ImageView image = CreateImageView( imageSource.configuration.path, imageSize.x, imageSize.y, fittingMode );
 474       image.SetProperty( Actor::Property::POSITION, Vector3( imagePosition.x, imagePosition.y, 0 ) );
 475       image.SetProperty( Actor::Property::SIZE, imageSize );
 476       image.TouchSignal().Connect( this, &ImageScalingIrregularGridController::OnTouchImage );
 477       image.ResourceReadySignal().Connect( this, &ImageScalingIrregularGridController::ResourceReadySignal );
 478       mFittingModes[image.GetProperty< int >( Actor::Property::ID )] = fittingMode;
 479       mResourceUrls[image.GetProperty< int >( Actor::Property::ID )] = imageSource.configuration.path;
 480       mSizes[image.GetProperty< int >( Actor::Property::ID )] = imageSize;
 481       if ( count < INITIAL_IMAGES_TO_LOAD )
 482       {
 483         gridActor.Add( image );
 484       }
 485       else
 486       {
 487         // Store the ImageView in an offwindow actor until the inital batch of ImageViews have finished loading their images
 488         // Required
 489         mOffWindowImageViews.Add( image );
 490       }
 491     }
 492
 493     return gridActor;
 494   }
 495
 496  /**
 497   * Upon Touching an image (Release), change its scaling mode and make it spin, provided we're not scrolling.
 498   * @param[in] actor The actor touched
 499   * @param[in] event The Touch information.
 500   */
 501   bool OnTouchImage( Actor actor, const TouchData& event )
 502   {
 503     if( ( event.GetPointCount() > 0 ) && ( !mScrolling ) )
 504     {
 505       if( event.GetState( 0 ) == PointState::UP )
 506       {
 507         // Spin the image a few times:
 508         Animation animation = Animation::New(SPIN_DURATION);
 509         animation.AnimateBy( Property( actor, Actor::Property::ORIENTATION ), Quaternion( Radian( Degree(360.0f * SPIN_DURATION) ), Vector3::XAXIS ), AlphaFunction::EASE_OUT );
 510         animation.Play();
 511
 512         // Change the scaling mode:
 513         const unsigned id = actor.GetProperty< int >( Actor::Property::ID );
 514         Dali::FittingMode::Type newMode = NextMode( mFittingModes[id] );
 515         const Vector2 imageSize = mSizes[actor.GetProperty< int >( Actor::Property::ID )];
 516
 517         ImageView imageView = ImageView::DownCast( actor );
 518         if( imageView)
 519         {
 520           Property::Map map;
 521           map[Visual::Property::TYPE] = Visual::IMAGE;
 522           map[ImageVisual::Property::URL] = mResourceUrls[id];
 523           map[ImageVisual::Property::DESIRED_WIDTH] = imageSize.width + 0.5f;
 524           map[ImageVisual::Property::DESIRED_HEIGHT] =  imageSize.height + 0.5f;
 525           map[ImageVisual::Property::FITTING_MODE] = newMode;
 526           imageView.SetProperty( ImageView::Property::IMAGE, map );
 527         }
 528
 529         mFittingModes[id] = newMode;
 530       }
 531     }
 532     return false;
 533   }
 534
 535  /**
 536   * Main key event handler.
 537   * Quit on escape key.
 538   */
 539   void OnKeyEvent(const KeyEvent& event)
 540   {
 541     if( event.state == KeyEvent::Down )
 542     {
 543       if( IsKey( event, Dali::DALI_KEY_ESCAPE )
 544           || IsKey( event, Dali::DALI_KEY_BACK ) )
 545       {
 546         mApplication.Quit();
 547       }
 548     }
 549   }
 550
 551  /**
 552   * Signal handler, called when the 'Scaling' button has been touched.
 553   *
 554   * @param[in] button The button that was pressed.
 555   */
 556   bool OnToggleScalingTouched( Button button )
 557   {
 558     const unsigned numChildren = mGridActor.GetChildCount();
 559
 560     for( unsigned i = 0; i < numChildren; ++i )
 561     {
 562       ImageView gridImageView = ImageView::DownCast( mGridActor.GetChildAt( i ) );
 563       if( gridImageView )
 564       {
 565         // Cycle the scaling mode options:
 566         unsigned int id = gridImageView.GetProperty< int >( Actor::Property::ID );
 567
 568         const Vector2 imageSize = mSizes[ id ];
 569         Dali::FittingMode::Type newMode = NextMode( mFittingModes[ id ] );
 570
 571         Property::Map map;
 572         map[Visual::Property::TYPE] = Visual::IMAGE;
 573         map[ImageVisual::Property::URL] = mResourceUrls[id];
 574         map[ImageVisual::Property::DESIRED_WIDTH] = imageSize.width;
 575         map[ImageVisual::Property::DESIRED_HEIGHT] =  imageSize.height;
 576         map[ImageVisual::Property::FITTING_MODE] = newMode;
 577         gridImageView.SetProperty( ImageView::Property::IMAGE, map );
 578
 579
 580
 581         mFittingModes[ id ] = newMode;
 582
 583         SetTitle( std::string( newMode == FittingMode::SHRINK_TO_FIT ? "SHRINK_TO_FIT" : newMode == FittingMode::SCALE_TO_FILL ?  "SCALE_TO_FILL" : newMode == FittingMode::FIT_WIDTH ? "FIT_WIDTH" : "FIT_HEIGHT" ) );
 584       }
 585     }
 586     return true;
 587   }
 588
 589   /**
 590    * Sets/Updates the title of the View
 591    * @param[in] title The new title for the view.
 592    */
 593   void SetTitle(const std::string& title)
 594   {
 595     if(!mTitleActor)
 596     {
 597       mTitleActor = DemoHelper::CreateToolBarLabel( "" );
 598       // Add title to the tool bar.
 599       mToolBar.AddControl( mTitleActor, DemoHelper::DEFAULT_VIEW_STYLE.mToolBarTitlePercentage, Alignment::HorizontalCenter );
 600     }
 601
 602     mTitleActor.SetProperty( TextLabel::Property::TEXT, title );
 603   }
 604
 605   /**
 606    * When scroll starts (i.e. user starts to drag scrollview),
 607    * note this state (mScrolling = true)
 608    * @param[in] position Current Scroll Position
 609    */
 610   void OnScrollStarted( const Vector2& position )
 611   {
 612     mScrolling = true;
 613   }
 614
 615   /**
 616    * When scroll starts (i.e. user stops dragging scrollview, and scrollview has snapped to destination),
 617    * note this state (mScrolling = false).
 618    * @param[in] position Current Scroll Position
 619    */
 620   void OnScrollCompleted( const Vector2& position )
 621   {
 622     mScrolling = false;
 623   }
 624
 625 private:
 626   Application&  mApplication;
 627
 628   Layer mContentLayer;                ///< The content layer (contains non gui chrome actors)
 629   Toolkit::Control mView;             ///< The View instance.
 630   Toolkit::ToolBar mToolBar;          ///< The View's Toolbar.
 631   TextLabel mTitleActor;               ///< The Toolbar's Title.
 632   Actor mGridActor;                   ///< The container for the grid of images
 633   Actor mOffWindowImageViews;          ///< ImageViews held off window until the inital batch have loaded their images
 634   ScrollView mScrollView;             ///< ScrollView UI Component
 635   ScrollBar mScrollBarVertical;
 636   ScrollBar mScrollBarHorizontal;
 637   bool mScrolling;                    ///< ScrollView scrolling state (true = scrolling, false = stationary)
 638   std::map<unsigned, Dali::FittingMode::Type> mFittingModes; ///< Stores the current scaling mode of each image, keyed by image actor id.
 639   std::map<unsigned, std::string> mResourceUrls; ///< Stores the url of each image, keyed by image actor id.
 640   std::map<unsigned, Vector2> mSizes; ///< Stores the current size of each image, keyed by image actor id.
 641   unsigned int mImagesLoaded;         ///< How many images have been loaded
 642 };
 643
 644 int DALI_EXPORT_API main( int argc, char **argv )
 645 {
 646   Application application = Application::New( &argc, &argv, DEMO_THEME_PATH );
 647   ImageScalingIrregularGridController test( application );
 648   application.MainLoop();
 649   return 0;
 650 }