[4.0] Exposing Exif Image metadata
[platform/core/uifw/dali-adaptor.git] / platform-abstractions / tizen / image-loaders / loader-jpeg.h
1 #ifndef __DALI_TIZEN_PLATFORM_LOADER_JPEG_H__
2 #define __DALI_TIZEN_PLATFORM_LOADER_JPEG_H__
3
4 /*
5  * Copyright (c) 2017 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 <stdio.h>
22 #include <dali/public-api/common/dali-vector.h>
23 #include <dali/public-api/images/pixel.h>
24 #include "image-encoder.h"
25 #include "image-loader-input.h"
26
27 namespace Dali
28 {
29 namespace Devel
30 {
31 class PixelBuffer;
32 }
33
34
35 namespace TizenPlatform
36 {
37
38 class ResourceLoadingClient;
39
40 namespace Jpeg
41 {
42 const unsigned char MAGIC_BYTE_1 = 0xFF;
43 const unsigned char MAGIC_BYTE_2 = 0xD8;
44 } // namespace Jpeg
45
46 /**
47  * Loads the bitmap from an JPEG file.  This function checks the header first
48  * and if it is not a JPEG file, then it returns straight away.
49  * @param[in]  input  Information about the input image (including file pointer)
50  * @param[out] bitmap The bitmap class where the decoded image will be stored
51  * @return  true if file decoded successfully, false otherwise
52  */
53 bool LoadBitmapFromJpeg( const ImageLoader::Input& input, Dali::Devel::PixelBuffer& bitmap );
54
55 /**
56  * Loads the header of a JPEG file and fills in the width and height appropriately.
57  * If the width and height are set on entry, it will set the width and height
58  * to the closest scaled size (exactly as will be loaded by LoadBitmapFromJpeg with the same
59  * attributes)
60  * @param[in]   fp      Pointer to the Image file
61  * @param[in]  attributes  Describes the dimensions, pixel format and other details for loading the image data
62  * @param[in/out]  width   Is set with the width of the image
63  * @param[in/out]  height  Is set with the height of the image
64  * @return true if the file's header was read successully, false otherwise
65  */
66 bool LoadJpegHeader( const ImageLoader::Input& input, unsigned int& width, unsigned int& height );
67
68 /**
69  * Encode raw pixel data to JPEG format.
70  * @param[in]  pixelBuffer    Pointer to raw pixel data to be encoded
71  * @param[out] encodedPixels  Encoded pixel data. Existing contents will be overwritten
72  * @param[in]  width          Image width
73  * @param[in]  height         Image height
74  * @param[in]  pixelFormat    Input pixel format (must be Pixel::RGB888)
75  * @param[in]  quality        JPEG quality on usual 1 to 100 scale.
76  */
77 bool EncodeToJpeg(const unsigned char* pixelBuffer, Vector< unsigned char >& encodedPixels, std::size_t width, std::size_t height, Pixel::Format pixelFormat, unsigned quality = 80);
78
79 } // namespace TizenPlatform
80
81 } // namespace Dali
82
83 #endif // __DALI_TIZEN_PLATFORM_LOADER_JPEG_H__