dali-toolkit/internal/controls/image-view/image-view-impl.cpp

   1 /*
   2  * Copyright (c) 2018 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 "image-view-impl.h"
  20
  21 // EXTERNAL INCLUDES
  22 #include <dali/public-api/images/resource-image.h>
  23 #include <dali/public-api/object/type-registry.h>
  24 #include <dali/public-api/object/type-registry-helper.h>
  25 #include <dali/devel-api/scripting/scripting.h>
  26
  27 // INTERNAL INCLUDES
  28 #include <dali-toolkit/public-api/controls/image-view/image-view.h>
  29 #include <dali-toolkit/devel-api/controls/control-devel.h>
  30 #include <dali-toolkit/public-api/visuals/visual-properties.h>
  31 #include <dali-toolkit/devel-api/visual-factory/visual-factory.h>
  32 #include <dali-toolkit/internal/visuals/visual-string-constants.h>
  33 #include <dali-toolkit/internal/visuals/visual-base-impl.h>
  34 #include <dali-toolkit/internal/visuals/visual-base-data-impl.h>
  35
  36 namespace Dali
  37 {
  38
  39 namespace Toolkit
  40 {
  41
  42 namespace Internal
  43 {
  44
  45 namespace
  46 {
  47
  48 BaseHandle Create()
  49 {
  50   return Toolkit::ImageView::New();
  51 }
  52
  53 // Setup properties, signals and actions using the type-registry.
  54 DALI_TYPE_REGISTRATION_BEGIN( Toolkit::ImageView, Toolkit::Control, Create );
  55 DALI_PROPERTY_REGISTRATION( Toolkit, ImageView, "resourceUrl", STRING, RESOURCE_URL )
  56 DALI_PROPERTY_REGISTRATION( Toolkit, ImageView, "image", MAP, IMAGE )
  57 DALI_PROPERTY_REGISTRATION( Toolkit, ImageView, "preMultipliedAlpha", BOOLEAN, PRE_MULTIPLIED_ALPHA )
  58
  59 DALI_ANIMATABLE_PROPERTY_REGISTRATION_WITH_DEFAULT( Toolkit, ImageView, "pixelArea", Vector4(0.f, 0.f, 1.f, 1.f), PIXEL_AREA )
  60 DALI_TYPE_REGISTRATION_END()
  61
  62 } // anonymous namespace
  63
  64 using namespace Dali;
  65
  66 ImageView::ImageView()
  67 : Control( ControlBehaviour( CONTROL_BEHAVIOUR_DEFAULT ) ),
  68   mImageSize()
  69 {
  70 }
  71
  72 ImageView::~ImageView()
  73 {
  74 }
  75
  76 Toolkit::ImageView ImageView::New()
  77 {
  78   ImageView* impl = new ImageView();
  79
  80   Toolkit::ImageView handle = Toolkit::ImageView( *impl );
  81
  82   // Second-phase init of the implementation
  83   // This can only be done after the CustomActor connection has been made...
  84   impl->Initialize();
  85
  86   return handle;
  87 }
  88
  89 /////////////////////////////////////////////////////////////
  90
  91 void ImageView::OnInitialize()
  92 {
  93   // ImageView can relayout in the OnImageReady, alternative to a signal would be to have a upcall from the Control to ImageView
  94   Dali::Toolkit::Control handle( GetOwner() );
  95   handle.ResourceReadySignal().Connect( this, &ImageView::OnResourceReady );
  96 }
  97
  98 void ImageView::SetImage( Image image )
  99 {
 100   // Don't bother comparing if we had a visual previously, just drop old visual and create new one
 101   mImage = image;
 102   mUrl.clear();
 103   mPropertyMap.Clear();
 104
 105   Toolkit::Visual::Base visual =  Toolkit::VisualFactory::Get().CreateVisual( image );
 106   if( visual )
 107   {
 108     if( !mVisual )
 109     {
 110       mVisual = visual;
 111     }
 112
 113     if( !mShaderMap.Empty() )
 114     {
 115       Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
 116       visualImpl.SetCustomShader( mShaderMap );
 117     }
 118
 119     DevelControl::RegisterVisual( *this, Toolkit::ImageView::Property::IMAGE, visual );
 120   }
 121   else
 122   {
 123     // Unregister the exsiting visual
 124     DevelControl::UnregisterVisual( *this, Toolkit::ImageView::Property::IMAGE );
 125
 126     // Trigger a size negotiation request that may be needed when unregistering a visual.
 127     RelayoutRequest();
 128   }
 129
 130   Toolkit::DevelControl::RequestLayout( *this );
 131 }
 132
 133 void ImageView::SetImage( const Property::Map& map )
 134 {
 135   // Comparing a property map is too expensive so just creating a new visual
 136   mPropertyMap = map;
 137   mUrl.clear();
 138   mImage.Reset();
 139
 140   Toolkit::Visual::Base visual =  Toolkit::VisualFactory::Get().CreateVisual( mPropertyMap );
 141   if( visual )
 142   {
 143     // Don't set mVisual until it is ready and shown. Getters will still use current visual.
 144     if( !mVisual )
 145     {
 146       mVisual = visual;
 147     }
 148
 149     if( !mShaderMap.Empty() )
 150     {
 151       Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
 152       visualImpl.SetCustomShader( mShaderMap );
 153     }
 154
 155     DevelControl::RegisterVisual( *this, Toolkit::ImageView::Property::IMAGE, visual  );
 156   }
 157   else
 158   {
 159     // Unregister the exsiting visual
 160     DevelControl::UnregisterVisual( *this, Toolkit::ImageView::Property::IMAGE );
 161
 162     // Trigger a size negotiation request that may be needed when unregistering a visual.
 163     RelayoutRequest();
 164   }
 165
 166   Toolkit::DevelControl::RequestLayout( *this );
 167 }
 168
 169 void ImageView::SetImage( const std::string& url, ImageDimensions size )
 170 {
 171   // Don't bother comparing if we had a visual previously, just drop old visual and create new one
 172   mUrl = url;
 173   mImageSize = size;
 174   mImage.Reset();
 175   mPropertyMap.Clear();
 176
 177   // Don't set mVisual until it is ready and shown. Getters will still use current visual.
 178   Toolkit::Visual::Base visual =  Toolkit::VisualFactory::Get().CreateVisual( url, size );
 179   if( visual )
 180   {
 181     if( !mVisual )
 182     {
 183       mVisual = visual;
 184     }
 185
 186     if( !mShaderMap.Empty() )
 187     {
 188       Internal::Visual::Base& visualImpl = Toolkit::GetImplementation( visual );
 189       visualImpl.SetCustomShader( mShaderMap );
 190     }
 191
 192     DevelControl::RegisterVisual( *this, Toolkit::ImageView::Property::IMAGE, visual );
 193   }
 194   else
 195   {
 196     // Unregister the exsiting visual
 197     DevelControl::UnregisterVisual( *this, Toolkit::ImageView::Property::IMAGE );
 198
 199     // Trigger a size negotiation request that may be needed when unregistering a visual.
 200     RelayoutRequest();
 201   }
 202
 203   Toolkit::DevelControl::RequestLayout( *this );
 204 }
 205
 206 Image ImageView::GetImage() const
 207 {
 208   return mImage;
 209 }
 210
 211 void ImageView::EnablePreMultipliedAlpha( bool preMultipled )
 212 {
 213   if( mVisual )
 214   {
 215     Toolkit::GetImplementation( mVisual ).EnablePreMultipliedAlpha( preMultipled );
 216   }
 217 }
 218
 219 bool ImageView::IsPreMultipliedAlphaEnabled() const
 220 {
 221   if( mVisual )
 222   {
 223     return Toolkit::GetImplementation( mVisual ).IsPreMultipliedAlphaEnabled();
 224   }
 225   return false;
 226 }
 227
 228 void ImageView::SetDepthIndex( int depthIndex )
 229 {
 230   if( mVisual )
 231   {
 232     mVisual.SetDepthIndex( depthIndex );
 233   }
 234 }
 235
 236 Vector3 ImageView::GetNaturalSize()
 237 {
 238   if( mVisual )
 239   {
 240     Vector2 rendererNaturalSize;
 241     mVisual.GetNaturalSize( rendererNaturalSize );
 242
 243     Extents padding;
 244     padding = Self().GetProperty<Extents>( Toolkit::Control::Property::PADDING );
 245
 246     rendererNaturalSize.width += ( padding.start + padding.end );
 247     rendererNaturalSize.height += ( padding.top + padding.bottom );
 248     return Vector3( rendererNaturalSize );
 249   }
 250
 251   // if no visual then use Control's natural size
 252   return Control::GetNaturalSize();
 253 }
 254
 255 float ImageView::GetHeightForWidth( float width )
 256 {
 257   Extents padding;
 258   padding = Self().GetProperty<Extents>( Toolkit::Control::Property::PADDING );
 259
 260   if( mVisual )
 261   {
 262     return mVisual.GetHeightForWidth( width ) + padding.top + padding.bottom;
 263   }
 264   else
 265   {
 266     return Control::GetHeightForWidth( width ) + padding.top + padding.bottom;
 267   }
 268 }
 269
 270 float ImageView::GetWidthForHeight( float height )
 271 {
 272   Extents padding;
 273   padding = Self().GetProperty<Extents>( Toolkit::Control::Property::PADDING );
 274
 275   if( mVisual )
 276   {
 277     return mVisual.GetWidthForHeight( height ) + padding.start + padding.end;
 278   }
 279   else
 280   {
 281     return Control::GetWidthForHeight( height ) + padding.start + padding.end;
 282   }
 283 }
 284
 285 void ImageView::OnRelayout( const Vector2& size, RelayoutContainer& container )
 286 {
 287   Control::OnRelayout( size, container );
 288
 289   if( mVisual )
 290   {
 291     Property::Map transformMap = Property::Map();
 292
 293     Extents padding = Self().GetProperty<Extents>( Toolkit::Control::Property::PADDING );
 294     const Visual::FittingMode fittingMode = Toolkit::GetImplementation(mVisual).GetFittingMode();
 295
 296     if( ( padding != Extents() ) || // If padding is not zero
 297         ( fittingMode == Visual::FittingMode::FIT_KEEP_ASPECT_RATIO ) )
 298     {
 299       Dali::LayoutDirection::Type layoutDirection = static_cast<Dali::LayoutDirection::Type>(
 300             Self().GetProperty( Dali::Actor::Property::LAYOUT_DIRECTION ).Get<int>() );
 301
 302       if( Dali::LayoutDirection::RIGHT_TO_LEFT == layoutDirection )
 303       {
 304         std::swap( padding.start, padding.end );
 305       }
 306
 307       auto finalOffset = Vector2( padding.start, padding.top );
 308
 309       // remove padding from the size to know how much is left for the visual
 310       auto finalSize = size - Vector2( padding.start + padding.end, padding.top + padding.bottom );
 311
 312       // Should provide a transform that handles aspect ratio according to image size
 313       if( fittingMode == Visual::FittingMode::FIT_KEEP_ASPECT_RATIO )
 314       {
 315         auto availableVisualSize = finalSize;
 316
 317         Vector2 naturalSize;
 318         mVisual.GetNaturalSize( naturalSize );
 319
 320         // scale to fit the padded area
 321         finalSize = naturalSize * std::min( ( naturalSize.width  ? ( availableVisualSize.width  / naturalSize.width  ) : 0 ),
 322                                             ( naturalSize.height ? ( availableVisualSize.height / naturalSize.height ) : 0 ) );
 323
 324         // calculate final offset within the padded area
 325         finalOffset += ( availableVisualSize - finalSize ) * .5f;
 326       }
 327
 328       // populate the transform map
 329       transformMap.Add( Toolkit::Visual::Transform::Property::OFFSET, finalOffset )
 330                   .Add( Toolkit::Visual::Transform::Property::OFFSET_POLICY,
 331                       Vector2( Toolkit::Visual::Transform::Policy::ABSOLUTE, Toolkit::Visual::Transform::Policy::ABSOLUTE ) )
 332                   .Add( Toolkit::Visual::Transform::Property::ORIGIN, Toolkit::Align::TOP_BEGIN )
 333                   .Add( Toolkit::Visual::Transform::Property::ANCHOR_POINT, Toolkit::Align::TOP_BEGIN )
 334                   .Add( Toolkit::Visual::Transform::Property::SIZE, finalSize )
 335                   .Add( Toolkit::Visual::Transform::Property::SIZE_POLICY,
 336                       Vector2( Toolkit::Visual::Transform::Policy::ABSOLUTE, Toolkit::Visual::Transform::Policy::ABSOLUTE ) );
 337     }
 338
 339     mVisual.SetTransformAndSize( transformMap, size );
 340   }
 341 }
 342
 343 void ImageView::OnResourceReady( Toolkit::Control control )
 344 {
 345   // Visual ready so update visual attached to this ImageView, following call to RelayoutRequest will use this visual.
 346   mVisual = DevelControl::GetVisual( *this, Toolkit::ImageView::Property::IMAGE );
 347   Toolkit::DevelControl::RequestLayout( *this );
 348 }
 349
 350 ///////////////////////////////////////////////////////////
 351 //
 352 // Properties
 353 //
 354
 355 void ImageView::SetProperty( BaseObject* object, Property::Index index, const Property::Value& value )
 356 {
 357   Toolkit::ImageView imageView = Toolkit::ImageView::DownCast( Dali::BaseHandle( object ) );
 358
 359   if ( imageView )
 360   {
 361     ImageView& impl = GetImpl( imageView );
 362     switch ( index )
 363     {
 364       case Toolkit::ImageView::Property::RESOURCE_URL:
 365       {
 366         std::string imageUrl;
 367         if( value.Get( imageUrl ) )
 368         {
 369           impl.SetImage( imageUrl, ImageDimensions() );
 370         }
 371         break;
 372       }
 373
 374       case Toolkit::ImageView::Property::IMAGE:
 375       {
 376         std::string imageUrl;
 377         Property::Map* map;
 378         if( value.Get( imageUrl ) )
 379         {
 380           impl.SetImage( imageUrl, ImageDimensions() );
 381         }
 382         // if its not a string then get a Property::Map from the property if possible.
 383         else
 384         {
 385           map = value.GetMap();
 386           if( map )
 387           {
 388             Property::Value* shaderValue = map->Find( Toolkit::Visual::Property::SHADER, CUSTOM_SHADER );
 389             // set image only if property map contains image information other than custom shader
 390             if( map->Count() > 1u ||  !shaderValue )
 391             {
 392               impl.SetImage( *map );
 393             }
 394             // the property map contains only the custom shader
 395             else if( ( map->Count() == 1u )&&( shaderValue ) )
 396             {
 397               Property::Map* shaderMap = shaderValue->GetMap();
 398               if( shaderMap )
 399               {
 400                 impl.mShaderMap = *shaderMap;
 401
 402                 if( !impl.mUrl.empty() )
 403                 {
 404                   impl.SetImage( impl.mUrl, impl.mImageSize );
 405                 }
 406                 else if( impl.mImage )
 407                 {
 408                   impl.SetImage( impl.mImage );
 409                 }
 410                 else if( !impl.mPropertyMap.Empty() )
 411                 {
 412                   impl.SetImage( impl.mPropertyMap );
 413                 }
 414               }
 415             }
 416           }
 417         }
 418         break;
 419       }
 420
 421       case Toolkit::ImageView::Property::PRE_MULTIPLIED_ALPHA:
 422       {
 423         bool isPre;
 424         if( value.Get( isPre ) )
 425         {
 426           impl.EnablePreMultipliedAlpha( isPre );
 427         }
 428         break;
 429       }
 430     }
 431   }
 432 }
 433
 434 Property::Value ImageView::GetProperty( BaseObject* object, Property::Index propertyIndex )
 435 {
 436   Property::Value value;
 437
 438   Toolkit::ImageView imageview = Toolkit::ImageView::DownCast( Dali::BaseHandle( object ) );
 439
 440   if ( imageview )
 441   {
 442     ImageView& impl = GetImpl( imageview );
 443     switch ( propertyIndex )
 444     {
 445       case Toolkit::ImageView::Property::RESOURCE_URL:
 446       {
 447         if ( !impl.mUrl.empty() )
 448         {
 449           value = impl.mUrl;
 450         }
 451         break;
 452       }
 453
 454       case Toolkit::ImageView::Property::IMAGE:
 455       {
 456         if ( !impl.mUrl.empty() )
 457         {
 458           value = impl.mUrl;
 459         }
 460         else if( impl.mImage )
 461         {
 462           Property::Map map;
 463           Scripting::CreatePropertyMap( impl.mImage, map );
 464           value = map;
 465         }
 466         else
 467         {
 468           Property::Map map;
 469           Toolkit::Visual::Base visual = DevelControl::GetVisual( impl, Toolkit::ImageView::Property::IMAGE );
 470           if( visual )
 471           {
 472             visual.CreatePropertyMap( map );
 473           }
 474           value = map;
 475         }
 476         break;
 477       }
 478
 479       case Toolkit::ImageView::Property::PRE_MULTIPLIED_ALPHA:
 480       {
 481         value = impl.IsPreMultipliedAlphaEnabled();
 482         break;
 483       }
 484     }
 485   }
 486
 487   return value;
 488 }
 489
 490 } // namespace Internal
 491 } // namespace Toolkit
 492 } // namespace Dali