image_encodings.h

Go to the documentation of this file.

/*********************************************************************
* Software License Agreement (BSD License)
* 
*  Copyright (c) 2009, Willow Garage, Inc.
*  All rights reserved.
* 
*  Redistribution and use in source and binary forms, with or without
*  modification, are permitted provided that the following conditions
*  are met:
* 
*   * Redistributions of source code must retain the above copyright
*     notice, this list of conditions and the following disclaimer.
*   * Redistributions in binary form must reproduce the above
*     copyright notice, this list of conditions and the following
*     disclaimer in the documentation and/or other materials provided
*     with the distribution.
*   * Neither the name of the Willow Garage nor the names of its
*     contributors may be used to endorse or promote products derived
*     from this software without specific prior written permission.
* 
*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
*  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
*  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
*  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
*  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
*  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
*  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
*  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
*  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
*  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
*  ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
*  POSSIBILITY OF SUCH DAMAGE.
*********************************************************************/

#ifndef SENSOR_MSGS_IMAGE_ENCODINGS_H
#define SENSOR_MSGS_IMAGE_ENCODINGS_H

#include <stdexcept>
#include <string>

namespace sensor_msgs
{
  namespace image_encodings
  {
    const std::string RGB8 = "rgb8";
    const std::string RGBA8 = "rgba8";
    const std::string RGB16 = "rgb16";
    const std::string RGBA16 = "rgba16";
    const std::string BGR8 = "bgr8";
    const std::string BGRA8 = "bgra8";
    const std::string BGR16 = "bgr16";
    const std::string BGRA16 = "bgra16";
    const std::string MONO8="mono8";
    const std::string MONO16="mono16";

    // OpenCV CvMat types
    const std::string TYPE_8UC1="8UC1";
    const std::string TYPE_8UC2="8UC2";
    const std::string TYPE_8UC3="8UC3";
    const std::string TYPE_8UC4="8UC4";
    const std::string TYPE_8SC1="8SC1";
    const std::string TYPE_8SC2="8SC2";
    const std::string TYPE_8SC3="8SC3";
    const std::string TYPE_8SC4="8SC4";
    const std::string TYPE_16UC1="16UC1";
    const std::string TYPE_16UC2="16UC2";
    const std::string TYPE_16UC3="16UC3";
    const std::string TYPE_16UC4="16UC4";
    const std::string TYPE_16SC1="16SC1";
    const std::string TYPE_16SC2="16SC2";
    const std::string TYPE_16SC3="16SC3";
    const std::string TYPE_16SC4="16SC4";
    const std::string TYPE_32SC1="32SC1";
    const std::string TYPE_32SC2="32SC2";
    const std::string TYPE_32SC3="32SC3";
    const std::string TYPE_32SC4="32SC4";
    const std::string TYPE_32FC1="32FC1";
    const std::string TYPE_32FC2="32FC2";
    const std::string TYPE_32FC3="32FC3";
    const std::string TYPE_32FC4="32FC4";
    const std::string TYPE_64FC1="64FC1";
    const std::string TYPE_64FC2="64FC2";
    const std::string TYPE_64FC3="64FC3";
    const std::string TYPE_64FC4="64FC4";

    // Bayer encodings
    const std::string BAYER_RGGB8="bayer_rggb8";
    const std::string BAYER_BGGR8="bayer_bggr8";
    const std::string BAYER_GBRG8="bayer_gbrg8";
    const std::string BAYER_GRBG8="bayer_grbg8";
    const std::string BAYER_RGGB16="bayer_rggb16";
    const std::string BAYER_BGGR16="bayer_bggr16";
    const std::string BAYER_GBRG16="bayer_gbrg16";
    const std::string BAYER_GRBG16="bayer_grbg16";

    // Miscellaneous
    // This is the UYVY version of YUV422 codec http://www.fourcc.org/yuv.php#UYVY
    // with an 8-bit depth
    const std::string YUV422="yuv422";

    // Utility functions for inspecting an encoding string
    static inline bool isColor(const std::string& encoding)
    {
      return encoding == RGB8  || encoding == BGR8 ||
             encoding == RGBA8 || encoding == BGRA8 ||
             encoding == RGB16 || encoding == BGR16 ||
             encoding == RGBA16 || encoding == BGRA16;
    }

    static inline bool isMono(const std::string& encoding)
    {
      return encoding == MONO8 || encoding == MONO16;
    }

    static inline bool isBayer(const std::string& encoding)
    {
      return encoding == BAYER_RGGB8 || encoding == BAYER_BGGR8 ||
             encoding == BAYER_GBRG8 || encoding == BAYER_GRBG8 ||
             encoding == BAYER_RGGB16 || encoding == BAYER_BGGR16 ||
             encoding == BAYER_GBRG16 || encoding == BAYER_GRBG16;
    }

    static inline bool hasAlpha(const std::string& encoding)
    {
      return encoding == RGBA8 || encoding == BGRA8 ||
             encoding == RGBA16 || encoding == BGRA16;
    }

    static inline int numChannels(const std::string& encoding)
    {
      // First do the common-case encodings
      if (encoding == MONO8 ||
          encoding == MONO16)
        return 1;
      if (encoding == BGR8 ||
          encoding == RGB8 ||
          encoding == BGR16 ||
          encoding == RGB16)
        return 3;
      if (encoding == BGRA8 ||
          encoding == RGBA8 ||
          encoding == BGRA16 ||
          encoding == RGBA16)
        return 4;
      if (encoding == BAYER_RGGB8 ||
          encoding == BAYER_BGGR8 ||
          encoding == BAYER_GBRG8 ||
          encoding == BAYER_GRBG8 ||
          encoding == BAYER_RGGB16 ||
          encoding == BAYER_BGGR16 ||
          encoding == BAYER_GBRG16 ||
          encoding == BAYER_GRBG16)
        return 1;

      // Now all the generic content encodings
#define CHECK_CHANNELS(N)                       \
      if (encoding == TYPE_8UC##N  ||           \
          encoding == TYPE_8SC##N  ||           \
          encoding == TYPE_16UC##N ||           \
          encoding == TYPE_16SC##N ||           \
          encoding == TYPE_32SC##N ||           \
          encoding == TYPE_32FC##N ||           \
          encoding == TYPE_64FC##N)             \
        return N;                               \
      /***/
      
      CHECK_CHANNELS(1);
      CHECK_CHANNELS(2);
      CHECK_CHANNELS(3);
      CHECK_CHANNELS(4);

#undef CHECK_CHANNELS

      if (encoding == YUV422)
        return 2;

      throw std::runtime_error("Unknown encoding " + encoding);
      return -1;
    }

    static inline int bitDepth(const std::string& encoding)
    {
      if (encoding == MONO16)
        return 16;
      if (encoding == MONO8       ||
          encoding == BGR8        ||
          encoding == RGB8        ||
          encoding == BGRA8       ||
          encoding == RGBA8       ||
          encoding == BAYER_RGGB8 ||
          encoding == BAYER_BGGR8 ||
          encoding == BAYER_GBRG8 ||
          encoding == BAYER_GRBG8)
        return 8;

      if (encoding == MONO16       ||
          encoding == BGR16        ||
          encoding == RGB16        ||
          encoding == BGRA16       ||
          encoding == RGBA16       ||
          encoding == BAYER_RGGB16 ||
          encoding == BAYER_BGGR16 ||
          encoding == BAYER_GBRG16 ||
          encoding == BAYER_GRBG16)
        return 16;

      // B = bits (8, 16, ...), T = type (U, S, F)
#define CHECK_BIT_DEPTH(B, T)                   \
      if (encoding == TYPE_##B##T##C1 ||        \
          encoding == TYPE_##B##T##C2 ||        \
          encoding == TYPE_##B##T##C3 ||        \
          encoding == TYPE_##B##T##C4)          \
        return B;                               \
      /***/

      CHECK_BIT_DEPTH(8, U);
      CHECK_BIT_DEPTH(8, S);
      CHECK_BIT_DEPTH(16, U);
      CHECK_BIT_DEPTH(16, S);
      CHECK_BIT_DEPTH(32, S);
      CHECK_BIT_DEPTH(32, F);
      CHECK_BIT_DEPTH(64, F);

#undef CHECK_BIT_DEPTH

      if (encoding == YUV422)
        return 8;

      throw std::runtime_error("Unknown encoding " + encoding);
      return -1;
    }
  }
}

#endif