inc/FUixVisionQrCodeGenerator.h

   1 //
   2 // Open Service Platform
   3 // Copyright (c) 2013 Samsung Electronics Co., Ltd.
   4 //
   5 // Licensed under the Apache License, Version 2.0 (the License);
   6 // you may not use this file except in compliance with the License.
   7 // You may obtain a copy of the License at
   8 //
   9 //     http://www.apache.org/licenses/LICENSE-2.0
  10 //
  11 // Unless required by applicable law or agreed to in writing, software
  12 // distributed under the License is distributed on an "AS IS" BASIS,
  13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 // See the License for the specific language governing permissions and
  15 // limitations under the License.
  16 //
  17
  18
  19 /**
  20  * @file     FUixVisionQrCodeGenerator.h
  21  * @brief    This is the header file for the %Tizen::Uix::Vision::QrCodeGenerator class.
  22  */
  23
  24 #ifndef _FUIX_VISION_QR_CODE_GENERATOR_H_
  25 #define _FUIX_VISION_QR_CODE_GENERATOR_H_
  26 #include <FBaseObject.h>
  27 #include <FGrpBitmap.h>
  28 #include <FBase.h>
  29 #include <FMedia.h>
  30 #include "FUixVisionQrCodeTypes.h"
  31
  32
  33 namespace Tizen { namespace Uix { namespace Vision
  34 {
  35
  36 /**
  37  * @class    QrCodeGenerator
  38  * @brief    This class provides methods to generate QR code image.
  39  *
  40  * @since    2.1
  41  * The following example demonstrates how to use the %QrCodeGenerator class.
  42  *
  43  * @code
  44  * Tizen::Uix::Vision::QrCodeGenerator qrGen;
  45  * qrGen.Construct();
  46  *
  47  * qrGen.EncodeToFile("test message", Tizen::Uix::Vision::QR_MODE_UTF8, Tizen::Uix::Vision::QR_ECL_Q, "/mnt/ums/Others/temp.bmp", Tizen::Media::IMG_FORMAT_PNG);
  48  * @endcode
  49  */
  50 class _OSP_EXPORT_ QrCodeGenerator
  51     : public Tizen::Base::Object
  52 {
  53 public:
  54
  55     /**
  56      * This is the default constructor for this class.
  57      * The object is not fully constructed after this constructor is called.
  58      * For full construction, the Construct() method must be called right after calling this constructor.
  59      *
  60      * @since    2.1
  61      */
  62     QrCodeGenerator(void);
  63
  64     /**
  65      * This is the destructor for this class. @n
  66      * The resources are deallocated by this method.
  67      * This destructor overrides Tizen::Base::Object::~Object().
  68      *
  69      * @since    2.1
  70      */
  71     ~QrCodeGenerator(void);
  72
  73     /**
  74      * Initializes this instance of QRCodeGenerator.
  75      * Every application must call Construct() before calling any other method of QRCodeGenerator.
  76      *
  77      * @since        2.1
  78      * @exception    E_SUCCESS          The method is successful.
  79      * @exception    E_OUT_OF_MEMORY    The memory is insufficient.
  80      * @see
  81      */
  82     result Construct(void);
  83
  84     /**
  85      * Returns list of supported image file formats .
  86      *
  87      * @return       list of supported image file formats
  88      * @since        2.1
  89      *
  90      * @remarks
  91      * @see
  92      */
  93     static Tizen::Base::Collection::IListT<Tizen::Media::ImageFormat>* GetSupportedImageFileFormatsListN(void);
  94
  95     /**
  96      * Generates QR code into file
  97      *
  98      * @since        2.1
  99      *
 100      * @return       An error code.
 101      * @param[in]    message                Text to be encoded to QR code image
 102      * @param[in]    mode                   Input text encoding format (QR_CODE_MODE_ALPHANUMERIC, QR_CODE_MODE_BYTE, QR_CODE_MODE_UTF8)
 103      * @param[in]    errorCorrectionLevel   QR code error correction level
 104      * @param[in]    compatibility          Compatibility mode with zxing library for UTF-8 codes mode when mode is selected with QR_MODE_UTF8
 105      * @param[in]    imageFilePath          File path of the generated QR code image
 106      * @param[in]    imageFormat            Image file format of the generated QR code image
 107      * @param[out]   width                  Width of the generated QR code image
 108      * @param[out]   height                 Height of the generated QR code image
 109      * @exception    E_SUCCESS              The method is successful.
 110      * @exception    E_INVALID_ARG          A specified input parameter is invalid.
 111      * @exception    E_FILE_NOT_FOUND       The specified file cannot be found or accessed.
 112      *
 113      * @remarks      QR code encoding for UTF-8 is not standardized yet.
 114      *               So we support UTF-8 encoding/decoding compatibility to zxing(http://http://code.google.com/p/zxing/) library.
 115      * @see
 116      */
 117     result EncodeToFile(const Tizen::Base::String& message, QrCodeMode mode, QrCodeErrorCorrectionLevel errorCorrectionLevel, bool compatibility, const Tizen::Base::String& imageFilePath, Tizen::Media::ImageFormat imageFormat, int& width, int& height);
 118
 119     /**
 120      * Generates QR code into a byte buffer
 121      *
 122      * @since        2.1
 123      *
 124      * @return       A pointer to the ByteBuffer instance containing the generated QR code image
 125      * @param[in]    message                  Text to be encoded to QR code image
 126      * @param[in]    mode                     Input text encoding format (QR_MODE_ALPHANUMERIC, QR_MODE_BYTE, QR_MODE_UTF8)
 127      * @param[in]    errorCorrectionLevel     QR code error correction level
 128      * @param[in]    compatibility            Compatibility mode with zxing library for UTF-8 codes mode when mode is selected with QR_MODE_UTF8
 129      * @param[out]   width                    Width of the generated QR code image
 130      * @param[out]   height                   Height of the generated QR code image
 131      * @exception    E_SUCCESS                The method is successful.
 132      * @exception    E_INVALID_ARG            A specified input parameter is invalid.
 133      *
 134      * @remarks      QR code encoding for UTF-8 is not standardized yet.
 135      *               So we support UTF-8 encoding/decoding compatibility to zxing(http://http://code.google.com/p/zxing/) library.
 136      * @see
 137      */
 138     Tizen::Base::ByteBuffer* EncodeToBufferN(const Tizen::Base::String& message, QrCodeMode mode, QrCodeErrorCorrectionLevel error_level, bool compatibility, int& width, int& height);
 139
 140
 141 private:
 142     /**
 143      * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
 144      */
 145     QrCodeGenerator(const QrCodeGenerator& in);
 146
 147     /**
 148      * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
 149      */
 150     QrCodeGenerator& operator=(const QrCodeGenerator& in);
 151
 152 private:
 153     class _QrCodeGeneratorImpl* __pQrCodeGeneratorImpl;
 154     friend class _QrCodeGeneratorImpl;
 155 };
 156
 157 } } } //Tizen::Uix::Vision
 158
 159 #endif // _FUIX_VISION_QR_CODE_GENERATOR_H_