2 * Copyright (c) 2022 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include <dali/internal/imaging/common/webp-loading.h>
22 #ifdef DALI_WEBP_AVAILABLE
23 #include <webp/decode.h>
24 #include <webp/demux.h>
26 #if WEBP_DEMUX_ABI_VERSION > 0x0101
27 #define DALI_ANIMATED_WEBP_ENABLED 1
31 #include <dali/integration-api/debug.h>
32 #include <dali/public-api/images/pixel-data.h>
34 #include <dali/devel-api/threading/mutex.h>
35 #include <dali/internal/imaging/common/file-download.h>
36 #include <dali/internal/system/common/file-reader.h>
39 #include <sys/types.h>
44 #include <dali/devel-api/adaptor-framework/image-loading.h>
45 #include <dali/internal/imaging/common/pixel-buffer-impl.h>
47 typedef uint8_t WebPByteType;
57 #if defined(DEBUG_ENABLED)
58 Debug::Filter* gWebPLoadingLogFilter = Debug::Filter::New(Debug::NoLogging, false, "LOG_GIF_LOADING");
61 static constexpr int32_t INITIAL_INDEX = -1;
62 static constexpr size_t MAXIMUM_DOWNLOAD_IMAGE_SIZE = 50 * 1024 * 1024;
66 struct WebPLoading::Impl
69 Impl(const std::string& url, bool isLocalResource)
77 mLoadSucceeded(false),
78 mIsAnimatedImage(false),
79 mIsLocalResource(isLocalResource)
91 mLoadSucceeded(false),
92 mIsAnimatedImage(false),
93 mIsLocalResource(true)
97 bool LoadWebPInformation()
99 // Block to do not load this file again.
100 Mutex::ScopedLock lock(mMutex);
101 if(DALI_UNLIKELY(mLoadSucceeded))
103 return mLoadSucceeded;
106 #ifndef DALI_WEBP_AVAILABLE
107 // If the system doesn't support webp, loading will be failed.
109 mLoadSucceeded = false;
110 return mLoadSucceeded;
113 // mFrameCount will be 1 if the input image is non-animated image or animated image with single frame.
114 if(DALI_LIKELY(ReadWebPInformation()))
116 #ifdef DALI_WEBP_AVAILABLE
117 WebPDataInit(&mWebPData);
118 mWebPData.size = mBufferSize;
119 mWebPData.bytes = mBuffer;
121 WebPDemuxer* demuxer = WebPDemux(&mWebPData);
122 uint32_t flags = WebPDemuxGetI(demuxer, WEBP_FF_FORMAT_FLAGS);
123 if(flags & ANIMATION_FLAG)
125 mIsAnimatedImage = true;
127 WebPDemuxDelete(demuxer);
129 if(!mIsAnimatedImage)
131 int32_t imageWidth, imageHeight;
132 if(WebPGetInfo(mBuffer, mBufferSize, &imageWidth, &imageHeight))
134 mImageSize = ImageDimensions(imageWidth, imageHeight);
138 #ifdef DALI_ANIMATED_WEBP_ENABLED
141 WebPAnimDecoderOptions webPAnimDecoderOptions;
142 WebPAnimDecoderOptionsInit(&webPAnimDecoderOptions);
143 webPAnimDecoderOptions.color_mode = MODE_RGBA;
144 mWebPAnimDecoder = WebPAnimDecoderNew(&mWebPData, &webPAnimDecoderOptions);
145 WebPAnimDecoderGetInfo(mWebPAnimDecoder, &mWebPAnimInfo);
146 mTimeStamp.assign(mWebPAnimInfo.frame_count, 0);
147 mFrameCount = mWebPAnimInfo.frame_count;
148 mImageSize = ImageDimensions(mWebPAnimInfo.canvas_width, mWebPAnimInfo.canvas_height);
151 mLoadSucceeded = true;
156 mLoadSucceeded = false;
157 DALI_LOG_ERROR("Image loading failed for: \"%s\".\n", mUrl.c_str());
160 return mLoadSucceeded;
163 bool ReadWebPInformation()
168 std::unique_ptr<Internal::Platform::FileReader> fileReader;
169 Dali::Vector<uint8_t> dataBuffer;
174 fileReader = std::make_unique<Internal::Platform::FileReader>(mUrl);
179 if(DALI_LIKELY(TizenPlatform::Network::DownloadRemoteFileIntoMemory(mUrl, dataBuffer, dataSize, MAXIMUM_DOWNLOAD_IMAGE_SIZE)))
181 mBufferSize = dataBuffer.Size();
182 if(DALI_LIKELY(mBufferSize > 0U))
184 // Open a file handle on the memory buffer:
185 fileReader = std::make_unique<Internal::Platform::FileReader>(dataBuffer, mBufferSize);
192 fp = fileReader->GetFile();
196 if(DALI_LIKELY(fp != nullptr))
200 if(DALI_UNLIKELY(fseek(fp, 0, SEEK_END) <= -1))
204 mBufferSize = ftell(fp);
207 if(DALI_LIKELY(!fseek(fp, 0, SEEK_SET)))
209 mBuffer = reinterpret_cast<WebPByteType*>(malloc(sizeof(WebPByteType) * mBufferSize));
210 mBufferSize = fread(mBuffer, sizeof(WebPByteType), mBufferSize, fp);
217 void ReleaseResource()
219 #ifdef DALI_WEBP_AVAILABLE
220 if(&mWebPData != nullptr)
222 mWebPData.bytes = nullptr;
223 WebPDataInit(&mWebPData);
226 #ifdef DALI_ANIMATED_WEBP_ENABLED
229 if(mWebPAnimDecoder != nullptr)
231 WebPAnimDecoderDelete(mWebPAnimDecoder);
232 mWebPAnimDecoder = nullptr;
236 if(mBuffer != nullptr)
238 free((void*)mBuffer);
242 mLoadSucceeded = false;
245 // Moveable but not copyable
247 Impl(const Impl&) = delete;
248 Impl& operator=(const Impl&) = delete;
249 Impl(Impl&&) = default;
250 Impl& operator=(Impl&&) = default;
259 std::vector<uint32_t> mTimeStamp;
260 int32_t mLatestLoadedFrame{INITIAL_INDEX};
261 uint32_t mFrameCount;
263 // For the case the system doesn't support DALI_ANIMATED_WEBP_ENABLED
264 unsigned char* mBuffer;
265 uint32_t mBufferSize;
266 ImageDimensions mImageSize;
268 bool mIsAnimatedImage;
269 bool mIsLocalResource;
271 #ifdef DALI_WEBP_AVAILABLE
272 WebPData mWebPData{0};
275 #ifdef DALI_ANIMATED_WEBP_ENABLED
276 WebPAnimDecoder* mWebPAnimDecoder{nullptr};
277 WebPAnimInfo mWebPAnimInfo{0};
278 Dali::Devel::PixelBuffer mPreLoadedFrame{};
282 AnimatedImageLoadingPtr WebPLoading::New(const std::string& url, bool isLocalResource)
284 #ifndef DALI_ANIMATED_WEBP_ENABLED
285 DALI_LOG_ERROR("The system does not support Animated WebP format.\n");
287 return AnimatedImageLoadingPtr(new WebPLoading(url, isLocalResource));
290 AnimatedImageLoadingPtr WebPLoading::New(FILE* const fp)
292 #ifndef DALI_ANIMATED_WEBP_ENABLED
293 DALI_LOG_ERROR("The system does not support Animated WebP format.\n");
295 return AnimatedImageLoadingPtr(new WebPLoading(fp));
298 WebPLoading::WebPLoading(const std::string& url, bool isLocalResource)
299 : mImpl(new WebPLoading::Impl(url, isLocalResource))
303 WebPLoading::WebPLoading(FILE* const fp)
304 : mImpl(new WebPLoading::Impl(fp))
308 WebPLoading::~WebPLoading()
313 Dali::Devel::PixelBuffer WebPLoading::LoadFrame(uint32_t frameIndex)
315 Dali::Devel::PixelBuffer pixelBuffer;
317 // If WebP file is still not loaded, Load the information.
318 if(DALI_UNLIKELY(!mImpl->mLoadSucceeded))
320 if(DALI_UNLIKELY(!mImpl->LoadWebPInformation()))
322 mImpl->ReleaseResource();
327 // WebPDecodeRGBA is faster than to use demux API for loading non-animated image.
328 // If frame count is 1, use WebPDecodeRGBA api.
329 #ifdef DALI_WEBP_AVAILABLE
330 if(!mImpl->mIsAnimatedImage)
332 int32_t width, height;
333 if(DALI_LIKELY(WebPGetInfo(mImpl->mBuffer, mImpl->mBufferSize, &width, &height)))
335 WebPBitstreamFeatures features;
336 if(DALI_LIKELY(VP8_STATUS_NOT_ENOUGH_DATA != WebPGetFeatures(mImpl->mBuffer, mImpl->mBufferSize, &features)))
338 uint32_t channelNumber = (features.has_alpha) ? 4 : 3;
339 uint8_t* frameBuffer = nullptr;
340 if(channelNumber == 4)
342 frameBuffer = WebPDecodeRGBA(mImpl->mBuffer, mImpl->mBufferSize, &width, &height);
346 frameBuffer = WebPDecodeRGB(mImpl->mBuffer, mImpl->mBufferSize, &width, &height);
349 if(frameBuffer != nullptr)
351 Pixel::Format pixelFormat = (channelNumber == 4) ? Pixel::RGBA8888 : Pixel::RGB888;
352 int32_t bufferSize = width * height * Dali::Pixel::GetBytesPerPixel(pixelFormat);
353 Internal::Adaptor::PixelBufferPtr internal =
354 Internal::Adaptor::PixelBuffer::New(frameBuffer, bufferSize, width, height, width, pixelFormat);
355 pixelBuffer = Devel::PixelBuffer(internal.Get());
359 // The single frame resource should be released after loading.
360 mImpl->ReleaseResource();
364 #ifdef DALI_ANIMATED_WEBP_ENABLED
365 if(mImpl->mIsAnimatedImage && mImpl->mBuffer != nullptr)
367 Mutex::ScopedLock lock(mImpl->mMutex);
368 if(DALI_LIKELY(frameIndex < mImpl->mWebPAnimInfo.frame_count && mImpl->mLoadSucceeded))
370 DALI_LOG_INFO(gWebPLoadingLogFilter, Debug::Concise, "LoadFrame( frameIndex:%d )\n", frameIndex);
372 if(mImpl->mPreLoadedFrame && mImpl->mLatestLoadedFrame == static_cast<int32_t>(frameIndex))
374 pixelBuffer = mImpl->mPreLoadedFrame;
378 pixelBuffer = DecodeFrame(frameIndex);
380 mImpl->mPreLoadedFrame.Reset();
382 // If time stamp of next frame is unknown, load a frame more to know it.
383 if(frameIndex + 1 < mImpl->mWebPAnimInfo.frame_count && mImpl->mTimeStamp[frameIndex + 1] == 0u)
385 mImpl->mPreLoadedFrame = DecodeFrame(frameIndex + 1);
390 mImpl->ReleaseResource();
397 Dali::Devel::PixelBuffer WebPLoading::DecodeFrame(uint32_t frameIndex)
399 Dali::Devel::PixelBuffer pixelBuffer;
400 #ifdef DALI_ANIMATED_WEBP_ENABLED
401 if(mImpl->mLatestLoadedFrame >= static_cast<int32_t>(frameIndex))
403 mImpl->mLatestLoadedFrame = INITIAL_INDEX;
404 WebPAnimDecoderReset(mImpl->mWebPAnimDecoder);
407 uint8_t* frameBuffer = nullptr;
408 int32_t timestamp = 0u;
409 for(; mImpl->mLatestLoadedFrame < static_cast<int32_t>(frameIndex);)
411 WebPAnimDecoderGetNext(mImpl->mWebPAnimDecoder, &frameBuffer, ×tamp);
412 mImpl->mTimeStamp[++mImpl->mLatestLoadedFrame] = timestamp;
415 if(frameBuffer != nullptr)
417 const int bufferSize = mImpl->mWebPAnimInfo.canvas_width * mImpl->mWebPAnimInfo.canvas_height * sizeof(uint32_t);
418 pixelBuffer = Dali::Devel::PixelBuffer::New(mImpl->mWebPAnimInfo.canvas_width, mImpl->mWebPAnimInfo.canvas_height, Dali::Pixel::RGBA8888);
419 memcpy(pixelBuffer.GetBuffer(), frameBuffer, bufferSize);
426 ImageDimensions WebPLoading::GetImageSize() const
428 if(DALI_UNLIKELY(!mImpl->mLoadSucceeded))
430 mImpl->LoadWebPInformation();
432 return mImpl->mImageSize;
435 uint32_t WebPLoading::GetImageCount() const
437 if(DALI_UNLIKELY(!mImpl->mLoadSucceeded))
439 mImpl->LoadWebPInformation();
441 return mImpl->mFrameCount;
444 uint32_t WebPLoading::GetFrameInterval(uint32_t frameIndex) const
446 if(DALI_UNLIKELY(!mImpl->mLoadSucceeded))
448 DALI_LOG_ERROR("WebP file is still not loaded, this frame interval could not be correct value.\n");
450 if(frameIndex >= GetImageCount())
452 DALI_LOG_ERROR("Input frameIndex exceeded frame count of the WebP.");
457 int32_t interval = 0u;
458 if(GetImageCount() == 1u)
462 else if(frameIndex + 1 == GetImageCount())
464 // For the interval between last frame and first frame, use last interval again.
465 interval = mImpl->mTimeStamp[frameIndex] - mImpl->mTimeStamp[frameIndex - 1];
469 interval = mImpl->mTimeStamp[frameIndex + 1] - mImpl->mTimeStamp[frameIndex];
472 if(DALI_UNLIKELY(interval < 0))
474 DALI_LOG_ERROR("This interval value is not correct, because the frame still hasn't ever been decoded.");
477 return static_cast<uint32_t>(interval);
481 std::string WebPLoading::GetUrl() const
486 bool WebPLoading::HasLoadingSucceeded() const
488 return mImpl->mLoadSucceeded;
491 } // namespace Adaptor
493 } // namespace Internal