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