dali-toolkit/internal/visuals/svg/svg-visual.cpp

   1 /*
   2  * Copyright (c) 2023 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 "svg-visual.h"
  20
  21 // INTERNAL INCLUDES
  22 #include <dali-toolkit/internal/visuals/image-atlas-manager.h>
  23 #include <dali-toolkit/internal/visuals/image-visual-shader-factory.h>
  24 #include <dali-toolkit/internal/visuals/image-visual-shader-feature-builder.h>
  25 #include <dali-toolkit/internal/visuals/svg/svg-task.h>
  26 #include <dali-toolkit/internal/visuals/visual-base-data-impl.h>
  27 #include <dali-toolkit/internal/visuals/visual-string-constants.h>
  28 #include <dali-toolkit/public-api/visuals/image-visual-properties.h>
  29
  30 // EXTERNAL INCLUDES
  31 #include <dali/devel-api/common/stage.h>
  32 #include <dali/integration-api/debug.h>
  33 #include <dali/public-api/rendering/decorated-visual-renderer.h>
  34
  35 namespace Dali
  36 {
  37 namespace Toolkit
  38 {
  39 namespace Internal
  40 {
  41 namespace
  42 {
  43 const int CUSTOM_PROPERTY_COUNT(1); // atlas
  44
  45 // property name
  46 const Dali::Vector4 FULL_TEXTURE_RECT(0.f, 0.f, 1.f, 1.f);
  47
  48 } // namespace
  49
  50 SvgVisualPtr SvgVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl, const Property::Map& properties)
  51 {
  52   SvgVisualPtr svgVisual(new SvgVisual(factoryCache, shaderFactory, imageUrl, ImageDimensions{}));
  53   svgVisual->SetProperties(properties);
  54   svgVisual->Initialize();
  55   return svgVisual;
  56 }
  57
  58 SvgVisualPtr SvgVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl, ImageDimensions size)
  59 {
  60   SvgVisualPtr svgVisual(new SvgVisual(factoryCache, shaderFactory, imageUrl, size));
  61   svgVisual->Initialize();
  62   return svgVisual;
  63 }
  64
  65 SvgVisual::SvgVisual(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl, ImageDimensions size)
  66 : Visual::Base(factoryCache, Visual::FittingMode::FILL, Toolkit::Visual::SVG),
  67   mImageVisualShaderFactory(shaderFactory),
  68   mAtlasRect(FULL_TEXTURE_RECT),
  69   mImageUrl(imageUrl),
  70   mVectorRenderer(VectorImageRenderer::New()),
  71   mDefaultWidth(0),
  72   mDefaultHeight(0),
  73   mPlacementActor(),
  74   mRasterizedSize(Vector2::ZERO),
  75   mDesiredSize(size),
  76   mLoadFailed(false),
  77   mAttemptAtlasing(false)
  78 {
  79   // the rasterized image is with pre-multiplied alpha format
  80   mImpl->mFlags |= Impl::IS_PREMULTIPLIED_ALPHA;
  81 }
  82
  83 SvgVisual::~SvgVisual()
  84 {
  85   if(Stage::IsInstalled())
  86   {
  87     if(mLoadingTask)
  88     {
  89       Dali::AsyncTaskManager::Get().RemoveTask(mLoadingTask);
  90     }
  91     if(mRasterizingTask)
  92     {
  93       Dali::AsyncTaskManager::Get().RemoveTask(mRasterizingTask);
  94     }
  95   }
  96 }
  97
  98 void SvgVisual::OnInitialize()
  99 {
 100   Shader   shader   = GenerateShader();
 101   Geometry geometry = mFactoryCache.GetGeometry(VisualFactoryCache::QUAD_GEOMETRY);
 102   mImpl->mRenderer  = DecoratedVisualRenderer::New(geometry, shader);
 103   mImpl->mRenderer.ReserveCustomProperties(CUSTOM_PROPERTY_COUNT);
 104
 105   Vector2 dpi     = Stage::GetCurrent().GetDpi();
 106   float   meanDpi = (dpi.height + dpi.width) * 0.5f;
 107
 108   mLoadingTask = new SvgLoadingTask(mVectorRenderer, mImageUrl, meanDpi, MakeCallback(this, &SvgVisual::ApplyRasterizedImage));
 109
 110   if(IsSynchronousLoadingRequired() && mImageUrl.IsLocalResource())
 111   {
 112     mLoadingTask->Process();
 113     if(!mLoadingTask->HasSucceeded())
 114     {
 115       mLoadFailed = true;
 116     }
 117     mLoadingTask.Reset(); // We don't need it anymore.
 118   }
 119   else
 120   {
 121     Dali::AsyncTaskManager::Get().AddTask(mLoadingTask);
 122   }
 123 }
 124
 125 void SvgVisual::DoSetProperties(const Property::Map& propertyMap)
 126 {
 127   // url already passed in from constructor
 128   for(Property::Map::SizeType iter = 0; iter < propertyMap.Count(); ++iter)
 129   {
 130     KeyValuePair keyValue = propertyMap.GetKeyValue(iter);
 131     if(keyValue.first.type == Property::Key::INDEX)
 132     {
 133       DoSetProperty(keyValue.first.indexKey, keyValue.second);
 134     }
 135     else if(keyValue.first == IMAGE_ATLASING)
 136     {
 137       DoSetProperty(Toolkit::ImageVisual::Property::ATLASING, keyValue.second);
 138     }
 139     else if(keyValue.first == SYNCHRONOUS_LOADING)
 140     {
 141       DoSetProperty(Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING, keyValue.second);
 142     }
 143     else if(keyValue.first == IMAGE_DESIRED_WIDTH)
 144     {
 145       DoSetProperty(Toolkit::ImageVisual::Property::DESIRED_WIDTH, keyValue.second);
 146     }
 147     else if(keyValue.first == IMAGE_DESIRED_HEIGHT)
 148     {
 149       DoSetProperty(Toolkit::ImageVisual::Property::DESIRED_HEIGHT, keyValue.second);
 150     }
 151   }
 152 }
 153
 154 void SvgVisual::DoSetProperty(Property::Index index, const Property::Value& value)
 155 {
 156   switch(index)
 157   {
 158     case Toolkit::ImageVisual::Property::ATLASING:
 159     {
 160       value.Get(mAttemptAtlasing);
 161       break;
 162     }
 163     case Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING:
 164     {
 165       bool sync = false;
 166       if(value.Get(sync))
 167       {
 168         if(sync)
 169         {
 170           mImpl->mFlags |= Impl::IS_SYNCHRONOUS_RESOURCE_LOADING;
 171         }
 172         else
 173         {
 174           mImpl->mFlags &= ~Impl::IS_SYNCHRONOUS_RESOURCE_LOADING;
 175         }
 176       }
 177       else
 178       {
 179         DALI_LOG_ERROR("ImageVisual: synchronousLoading property has incorrect type\n");
 180       }
 181       break;
 182     }
 183     case Toolkit::ImageVisual::Property::DESIRED_WIDTH:
 184     {
 185       int32_t desiredWidth = 0;
 186       if(value.Get(desiredWidth))
 187       {
 188         mDesiredSize.SetWidth(desiredWidth);
 189       }
 190       break;
 191     }
 192     case Toolkit::ImageVisual::Property::DESIRED_HEIGHT:
 193     {
 194       int32_t desiredHeight = 0;
 195       if(value.Get(desiredHeight))
 196       {
 197         mDesiredSize.SetHeight(desiredHeight);
 198       }
 199       break;
 200     }
 201   }
 202 }
 203
 204 void SvgVisual::DoSetOnScene(Actor& actor)
 205 {
 206   TextureSet textureSet = TextureSet::New();
 207   mImpl->mRenderer.SetTextures(textureSet);
 208
 209   // Register transform properties
 210   mImpl->mTransform.SetUniforms(mImpl->mRenderer, Direction::LEFT_TO_RIGHT);
 211
 212   // Defer the rasterisation task until we get given a size (by Size Negotiation algorithm)
 213
 214   // Hold the weak handle of the placement actor and delay the adding of renderer until the svg rasterization is finished.
 215   mPlacementActor = actor;
 216
 217   if(mLoadFailed)
 218   {
 219     Vector2 imageSize = Vector2::ZERO;
 220     imageSize         = actor.GetProperty(Actor::Property::SIZE).Get<Vector2>();
 221     mFactoryCache.UpdateBrokenImageRenderer(mImpl->mRenderer, imageSize);
 222     actor.AddRenderer(mImpl->mRenderer);
 223
 224     ResourceReady(Toolkit::Visual::ResourceStatus::FAILED);
 225   }
 226   else
 227   {
 228     if(mImpl->mEventObserver)
 229     {
 230       // SVG visual needs it's size set before it can be rasterized hence request relayout once on stage
 231       mImpl->mEventObserver->RelayoutRequest(*this);
 232     }
 233   }
 234 }
 235
 236 void SvgVisual::DoSetOffScene(Actor& actor)
 237 {
 238   // Remove rasterizing task
 239   if(mRasterizingTask)
 240   {
 241     Dali::AsyncTaskManager::Get().RemoveTask(mRasterizingTask);
 242     mRasterizingTask.Reset();
 243   }
 244
 245   actor.RemoveRenderer(mImpl->mRenderer);
 246   mPlacementActor.Reset();
 247
 248   // Reset the visual size to zero so that when adding the actor back to stage the SVG rasterization is forced
 249   mRasterizedSize = Vector2::ZERO;
 250 }
 251
 252 void SvgVisual::GetNaturalSize(Vector2& naturalSize)
 253 {
 254   if(mDesiredSize.GetWidth() > 0 && mDesiredSize.GetHeight() > 0)
 255   {
 256     naturalSize.x = mDesiredSize.GetWidth();
 257     naturalSize.y = mDesiredSize.GetHeight();
 258   }
 259   else if(mLoadFailed && mImpl->mRenderer)
 260   {
 261     // Load failed, use broken image size
 262     auto textureSet = mImpl->mRenderer.GetTextures();
 263     if(textureSet && textureSet.GetTextureCount())
 264     {
 265       auto texture = textureSet.GetTexture(0);
 266       if(texture)
 267       {
 268         naturalSize.x = texture.GetWidth();
 269         naturalSize.y = texture.GetHeight();
 270         return;
 271       }
 272     }
 273   }
 274   else
 275   {
 276     naturalSize.x = mDefaultWidth;
 277     naturalSize.y = mDefaultHeight;
 278   }
 279 }
 280
 281 void SvgVisual::DoCreatePropertyMap(Property::Map& map) const
 282 {
 283   map.Clear();
 284   map.Insert(Toolkit::Visual::Property::TYPE, Toolkit::Visual::SVG);
 285   if(mImageUrl.IsValid())
 286   {
 287     map.Insert(Toolkit::ImageVisual::Property::URL, mImageUrl.GetUrl());
 288     map.Insert(Toolkit::ImageVisual::Property::ATLASING, mAttemptAtlasing);
 289   }
 290   map.Insert(Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING, IsSynchronousLoadingRequired());
 291   map.Insert(Toolkit::ImageVisual::Property::DESIRED_WIDTH, mDesiredSize.GetWidth());
 292   map.Insert(Toolkit::ImageVisual::Property::DESIRED_HEIGHT, mDesiredSize.GetHeight());
 293 }
 294
 295 void SvgVisual::DoCreateInstancePropertyMap(Property::Map& map) const
 296 {
 297   // Do nothing
 298 }
 299
 300 void SvgVisual::EnablePreMultipliedAlpha(bool preMultiplied)
 301 {
 302   // Make always enable pre multiplied alpha whether preMultiplied value is false.
 303   if(!preMultiplied)
 304   {
 305     DALI_LOG_WARNING("Note : SvgVisual cannot disable PreMultipliedAlpha\n");
 306   }
 307 }
 308
 309 void SvgVisual::AddRasterizationTask(const Vector2& size)
 310 {
 311   if(mImpl->mRenderer)
 312   {
 313     // Remove previous task
 314     if(mRasterizingTask)
 315     {
 316       Dali::AsyncTaskManager::Get().RemoveTask(mRasterizingTask);
 317       mRasterizingTask.Reset();
 318     }
 319
 320     unsigned int width  = static_cast<unsigned int>(size.width);
 321     unsigned int height = static_cast<unsigned int>(size.height);
 322
 323     mRasterizingTask = new SvgRasterizingTask(mVectorRenderer, width, height, MakeCallback(this, &SvgVisual::ApplyRasterizedImage));
 324
 325 #ifdef TRACE_ENABLED
 326     reinterpret_cast<SvgRasterizingTask*>(mRasterizingTask.Get())->SetUrl(mImageUrl);
 327 #endif
 328
 329     if(IsSynchronousLoadingRequired() && mImageUrl.IsLocalResource())
 330     {
 331       mRasterizingTask->Process();
 332       ApplyRasterizedImage(mRasterizingTask);
 333       mRasterizingTask.Reset(); // We don't need it anymore.
 334     }
 335     else
 336     {
 337       Dali::AsyncTaskManager::Get().AddTask(mRasterizingTask);
 338     }
 339   }
 340 }
 341
 342 void SvgVisual::ApplyRasterizedImage(SvgTaskPtr task)
 343 {
 344   if(DALI_UNLIKELY(mImpl == nullptr))
 345   {
 346     DALI_LOG_ERROR("Fatal error!! already destroyed object callback called! SvgVisual : %p, url : %s, task : %p\n", this, mImageUrl.GetUrl().c_str(), task.Get());
 347     return;
 348   }
 349
 350   if(task->HasSucceeded())
 351   {
 352     PixelData rasterizedPixelData = task->GetPixelData();
 353     if(mDefaultWidth == 0 || mDefaultHeight == 0)
 354     {
 355       task->GetRenderer().GetDefaultSize(mDefaultWidth, mDefaultHeight);
 356     }
 357
 358     // We don't need to keep tasks anymore. reset now.
 359     if(task == mLoadingTask)
 360     {
 361       mLoadingTask.Reset();
 362     }
 363     if(task == mRasterizingTask)
 364     {
 365       mRasterizingTask.Reset();
 366     }
 367
 368     // Rasterization success
 369     if(rasterizedPixelData && IsOnScene())
 370     {
 371       mRasterizedSize.x = static_cast<float>(rasterizedPixelData.GetWidth());
 372       mRasterizedSize.y = static_cast<float>(rasterizedPixelData.GetHeight());
 373
 374       TextureSet currentTextureSet = mImpl->mRenderer.GetTextures();
 375       if(mImpl->mFlags & Impl::IS_ATLASING_APPLIED)
 376       {
 377         mFactoryCache.GetAtlasManager()->Remove(currentTextureSet, mAtlasRect);
 378       }
 379
 380       TextureSet textureSet;
 381
 382       if(mAttemptAtlasing && !mImpl->mCustomShader)
 383       {
 384         Vector4 atlasRect;
 385         textureSet = mFactoryCache.GetAtlasManager()->Add(atlasRect, rasterizedPixelData);
 386         if(textureSet) // atlasing
 387         {
 388           if(textureSet != currentTextureSet)
 389           {
 390             mImpl->mRenderer.SetTextures(textureSet);
 391           }
 392           mImpl->mRenderer.RegisterProperty(ATLAS_RECT_UNIFORM_NAME, atlasRect);
 393           mAtlasRect = atlasRect;
 394           mImpl->mFlags |= Impl::IS_ATLASING_APPLIED;
 395         }
 396       }
 397
 398       if(!textureSet) // no atlasing - mAttemptAtlasing is false or adding to atlas is failed
 399       {
 400         Texture texture = Texture::New(Dali::TextureType::TEXTURE_2D, Pixel::RGBA8888, rasterizedPixelData.GetWidth(), rasterizedPixelData.GetHeight());
 401         texture.Upload(rasterizedPixelData);
 402         mImpl->mFlags &= ~Impl::IS_ATLASING_APPLIED;
 403
 404         if(mAtlasRect == FULL_TEXTURE_RECT)
 405         {
 406           textureSet = currentTextureSet;
 407         }
 408         else
 409         {
 410           textureSet = TextureSet::New();
 411           mImpl->mRenderer.SetTextures(textureSet);
 412
 413           mImpl->mRenderer.RegisterProperty(ATLAS_RECT_UNIFORM_NAME, FULL_TEXTURE_RECT);
 414           mAtlasRect = FULL_TEXTURE_RECT;
 415         }
 416
 417         if(textureSet)
 418         {
 419           textureSet.SetTexture(0, texture);
 420         }
 421       }
 422
 423       // Rasterized pixels are uploaded to texture. If weak handle is holding a placement actor, it is the time to add the renderer to actor.
 424       Actor actor = mPlacementActor.GetHandle();
 425       if(actor)
 426       {
 427         actor.AddRenderer(mImpl->mRenderer);
 428         // reset the weak handle so that the renderer only get added to actor once
 429         mPlacementActor.Reset();
 430       }
 431
 432       // Svg loaded and ready to display
 433       ResourceReady(Toolkit::Visual::ResourceStatus::READY);
 434     }
 435   }
 436   else if(!mLoadFailed)
 437   {
 438     mLoadFailed = true;
 439
 440     // Remove rasterizing task if we requested before.
 441     if(mRasterizingTask)
 442     {
 443       Dali::AsyncTaskManager::Get().RemoveTask(mRasterizingTask);
 444       mRasterizingTask.Reset();
 445     }
 446
 447     // We don't need to keep tasks anymore. reset now.
 448     if(task == mLoadingTask)
 449     {
 450       mLoadingTask.Reset();
 451     }
 452
 453     Actor actor = mPlacementActor.GetHandle();
 454     if(actor)
 455     {
 456       Vector2 imageSize = Vector2::ZERO;
 457       imageSize         = actor.GetProperty(Actor::Property::SIZE).Get<Vector2>();
 458       mFactoryCache.UpdateBrokenImageRenderer(mImpl->mRenderer, imageSize);
 459       actor.AddRenderer(mImpl->mRenderer);
 460     }
 461
 462     ResourceReady(Toolkit::Visual::ResourceStatus::FAILED);
 463   }
 464 }
 465
 466 void SvgVisual::OnSetTransform()
 467 {
 468   if(IsOnScene() && !mLoadFailed)
 469   {
 470     Vector2 size;
 471     if(mDesiredSize.GetWidth() > 0 && mDesiredSize.GetHeight() > 0)
 472     {
 473       // Use desired size
 474       size = Vector2(mDesiredSize.GetWidth(), mDesiredSize.GetHeight());
 475     }
 476     else
 477     {
 478       // Use visual size
 479       size = mImpl->mTransform.GetVisualSize(mImpl->mControlSize);
 480     }
 481
 482     if(size != mRasterizedSize || mDefaultWidth == 0 || mDefaultHeight == 0)
 483     {
 484       mRasterizedSize = size;
 485       AddRasterizationTask(size);
 486     }
 487   }
 488
 489   if(mImpl->mRenderer)
 490   {
 491     mImpl->mTransform.SetUniforms(mImpl->mRenderer, Direction::LEFT_TO_RIGHT);
 492   }
 493 }
 494
 495 void SvgVisual::UpdateShader()
 496 {
 497   if(mImpl->mRenderer)
 498   {
 499     Shader shader = GenerateShader();
 500     mImpl->mRenderer.SetShader(shader);
 501   }
 502 }
 503
 504 Shader SvgVisual::GenerateShader() const
 505 {
 506   Shader shader;
 507   if(!mImpl->mCustomShader)
 508   {
 509     shader = mImageVisualShaderFactory.GetShader(
 510       mFactoryCache,
 511       ImageVisualShaderFeatureBuilder()
 512         .EnableTextureAtlas(mAttemptAtlasing)
 513         .EnableRoundedCorner(IsRoundedCornerRequired())
 514         .EnableBorderline(IsBorderlineRequired()));
 515   }
 516   else
 517   {
 518     shader = Shader::New(mImpl->mCustomShader->mVertexShader.empty() ? mImageVisualShaderFactory.GetVertexShaderSource().data() : mImpl->mCustomShader->mVertexShader,
 519                          mImpl->mCustomShader->mFragmentShader.empty() ? mImageVisualShaderFactory.GetFragmentShaderSource().data() : mImpl->mCustomShader->mFragmentShader,
 520                          mImpl->mCustomShader->mHints);
 521
 522     shader.RegisterProperty(PIXEL_AREA_UNIFORM_NAME, FULL_TEXTURE_RECT);
 523   }
 524   return shader;
 525 }
 526
 527 } // namespace Internal
 528
 529 } // namespace Toolkit
 530
 531 } // namespace Dali