Support YUV decoding for JPEG
[platform/core/uifw/dali-adaptor.git] / dali / internal / imaging / common / loader-jpeg.h
1 #ifndef DALI_TIZEN_PLATFORM_LOADER_JPEG_H
2 #define DALI_TIZEN_PLATFORM_LOADER_JPEG_H
3
4 /*
5  * Copyright (c) 2022 Samsung Electronics Co., Ltd.
6  *
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  *
11  * http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  *
19  */
20
21 #include <dali/devel-api/adaptor-framework/image-loader-input.h>
22 #include <dali/internal/legacy/tizen/image-encoder.h>
23 #include <dali/public-api/common/dali-vector.h>
24 #include <dali/public-api/images/pixel.h>
25 #include <stdio.h>
26
27 namespace Dali
28 {
29 namespace Devel
30 {
31 class PixelBuffer;
32 }
33
34 namespace TizenPlatform
35 {
36 class ResourceLoadingClient;
37
38 namespace Jpeg
39 {
40 const unsigned char MAGIC_BYTE_1 = 0xFF;
41 const unsigned char MAGIC_BYTE_2 = 0xD8;
42 } // namespace Jpeg
43
44 /**
45  * Loads the bitmap from an JPEG file.  This function checks the header first
46  * and if it is not a JPEG file, then it returns straight away.
47  * @param[in]  input  Information about the input image (including file pointer)
48  * @param[out] bitmap The bitmap class where the decoded image will be stored
49  * @return  true if file decoded successfully, false otherwise
50  */
51 bool LoadBitmapFromJpeg(const Dali::ImageLoader::Input& input, Dali::Devel::PixelBuffer& bitmap);
52
53 /**
54  * Loads the image planes from an JPEG file.  This function checks the header first
55  * and if it is not a JPEG file, then it returns straight away.
56  * @param[in]  input  Information about the input image (including file pointer)
57  * @param[out] pixelBuffers The buffer list where the each plane will be stored
58  * @return true if file decoded successfully, false otherwise
59  * @note If the image file doesn't support to load planes, this method returns one RGB bitmap image.
60  */
61 bool LoadPlanesFromJpeg(const Dali::ImageLoader::Input& input, std::vector<Dali::Devel::PixelBuffer>& pixelBuffers);
62
63 /**
64  * Loads the header of a JPEG file and fills in the width and height appropriately.
65  * If the width and height are set on entry, it will set the width and height
66  * to the closest scaled size (exactly as will be loaded by LoadBitmapFromJpeg with the same
67  * attributes)
68  * @param[in]   fp      Pointer to the Image file
69  * @param[in]  attributes  Describes the dimensions, pixel format and other details for loading the image data
70  * @param[in/out]  width   Is set with the width of the image
71  * @param[in/out]  height  Is set with the height of the image
72  * @return true if the file's header was read successully, false otherwise
73  */
74 bool LoadJpegHeader(const Dali::ImageLoader::Input& input, unsigned int& width, unsigned int& height);
75
76 /**
77  * Encode raw pixel data to JPEG format.
78  * @param[in]  pixelBuffer    Pointer to raw pixel data to be encoded
79  * @param[out] encodedPixels  Encoded pixel data. Existing contents will be overwritten
80  * @param[in]  width          Image width
81  * @param[in]  height         Image height
82  * @param[in]  pixelFormat    Input pixel format (must be Pixel::RGB888)
83  * @param[in]  quality        JPEG quality on usual 1 to 100 scale.
84  */
85 bool EncodeToJpeg(const unsigned char* pixelBuffer, Vector<unsigned char>& encodedPixels, std::size_t width, std::size_t height, Pixel::Format pixelFormat, unsigned quality = 80);
86
87 } // namespace TizenPlatform
88
89 } // namespace Dali
90
91 #endif // DALI_TIZEN_PLATFORM_LOADER_JPEG_H