be_image_netpbm.h

Go to the documentation of this file.

/*
 * This software was developed at the National Institute of Standards and
 * Technology (NIST) by employees of the Federal Government in the course
 * of their official duties. Pursuant to title 17 Section 105 of the
 * United States Code, this software is not subject to copyright protection
 * and is in the public domain. NIST assumes no responsibility whatsoever for
 * its use by other parties, and makes no guarantees, expressed or implied,
 * about its quality, reliability, or any other characteristic.
 */
 
#ifndef __BE_IMAGE_NETPBM__
#define __BE_IMAGE_NETPBM__
 
#include <stdexcept>
 
#include <be_framework_enumeration.h>
#include <be_image_image.h>
 
namespace BiometricEvaluation
{
        namespace Image
        {
                class NetPBM : public Image
                {
                public:
                        enum class Kind {
                                ASCIIPortableBitmap = 1,        /* P1 */
                                ASCIIPortableGraymap = 2,       /* P2 */
                                ASCIIPortablePixmap = 3,        /* P3 */
                                BinaryPortableBitmap = 4,       /* P4 */
                                BinaryPortableGraymap = 5,      /* P5 */
                                BinaryPortablePixmap = 6        /* P6 */
                        };
 
                        NetPBM(
                            const uint8_t *data,
                            const uint64_t size,
                            const std::string &identifier = "",
                            const statusCallback_t &statusCallback =
                                Image::defaultStatusCallback);
 
                        NetPBM(
                            const Memory::uint8Array &data,
                            const std::string &identifier = "",
                            const statusCallback_t &statusCallback =
                                Image::defaultStatusCallback);
 
                        ~NetPBM() = default;
 
                        Memory::uint8Array
                        getRawData()
                            const;
 
                        Memory::uint8Array
                        getRawGrayscaleData(
                            uint8_t depth) const;
 
                        static bool
                        isNetPBM(
                            const uint8_t *data,
                            uint64_t size);
 
                        /*
                         * Utility methods for parsing buffers.
                         */
 
                        static void
                        skipLine(
                            const uint8_t *data,
                            size_t dataSize,
                            size_t &offset);
 
                        static void
                        skipComment(
                            const uint8_t *data,
                            size_t dataSize,
                            size_t &offset);
 
                        static std::string
                        getNextValue(
                            const uint8_t *data,
                            size_t dataSize,
                            size_t &offset,
                            size_t sizeOfValue = 0);
 
                        /*
                         * Buffer type conversions.
                         */
 
                        static Memory::uint8Array
                        ASCIIBitmapTo8Bit(
                            const uint8_t *bitmap,
                            uint64_t bitmapSize,
                            uint32_t width,
                            uint32_t height);
 
                        static Memory::uint8Array
                        ASCIIPixmapToBinaryPixmap(
                            const uint8_t *ASCIIBuf,
                            uint64_t ASCIIBufSize,
                            uint32_t width,
                            uint32_t height,
                            uint8_t depth,
                            uint32_t maxColor);
 
                        static Memory::uint8Array
                        BinaryBitmapTo8Bit(
                            const uint8_t *bitmap,
                            uint64_t bitmapSize,
                            uint32_t width,
                            uint32_t height);
 
                private:
                        void
                        parseHeader();
 
                        uint32_t _maxColorValue;
                        uint64_t _headerLength;
                        Kind _kind;
                };
        }
}
 
BE_FRAMEWORK_ENUMERATION_DECLARATIONS(
    BiometricEvaluation::Image::NetPBM::Kind,
    BE_Image_NetPBM_Kind_EnumToStringMap);
 
#endif /* __BE_IMAGE_NETPBM__ */