ImageHeightmap.hh

Go to the documentation of this file.

/*
 * Copyright (C) 2016 Open Source Robotics Foundation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
*/
#ifndef IGNITION_COMMON_IMAGEHEIGHTMAPDATA_HH_
#define IGNITION_COMMON_IMAGEHEIGHTMAPDATA_HH_

#include <limits>
#include <string>
#include <vector>
#include <ignition/math/Vector3.hh>

#include <ignition/common/graphics/Export.hh>
#include <ignition/common/HeightmapData.hh>
#include <ignition/common/Image.hh>

namespace ignition
{
  namespace common
  {
    class IGNITION_COMMON_GRAPHICS_VISIBLE ImageHeightmap
      : public ignition::common::HeightmapData
    {
      public: ImageHeightmap();

      public: int Load(const std::string &_filename = "");

      // Documentation inherited.
      public: void FillHeightMap(int _subSampling, unsigned int _vertSize,
          const ignition::math::Vector3d &_size,
          const ignition::math::Vector3d &_scale, bool _flipY,
          std::vector<float> &_heights);

      public: std::string Filename() const;

      // Documentation inherited.
      public: unsigned int Height() const;

      // Documentation inherited.
      public: unsigned int Width() const;

      // Documentation inherited.
      public: float MaxElevation() const;

      private: ignition::common::Image img;

      private: template <typename T>
      void FillHeights(T *_data, int _imgHeight, int _imgWidth,
        unsigned int _pitch, int _subSampling, unsigned int _vertSize,
        const ignition::math::Vector3d &_size,
        const ignition::math::Vector3d &_scale,
        bool _flipY, std::vector<float> &_heights)
      {
        // bytes per pixel
        const unsigned int bpp = _pitch / _imgWidth;
        // number of channels in a pixel
        const unsigned int channels = bpp / sizeof(T);
        // number of pixels in a row of image
        const unsigned int pitchInPixels = _pitch / bpp;

        const double maxPixelValue =
            static_cast<double>(std::numeric_limits<T>::max());

        // Iterate over all the vertices
        for (unsigned int y = 0; y < _vertSize; ++y)
        {
          // yf ranges between 0 and 4
          const double yf = y / static_cast<double>(_subSampling);
          const int y1 = static_cast<int>(std::floor(yf));
          int y2 = static_cast<int>(std::ceil(yf));
          if (y2 >= _imgHeight)
            y2 = _imgHeight - 1;
          const double dy = yf - y1;

          for (unsigned int x = 0; x < _vertSize; ++x)
          {
            const double xf = x / static_cast<double>(_subSampling);
            const int x1 = static_cast<int>(std::floor(xf));
            int x2 = static_cast<int>(std::ceil(xf));
            if (x2 >= _imgWidth)
              x2 = _imgWidth - 1;
            const double dx = xf - x1;

            const double px1 = static_cast<int>(
              _data[(y1 * pitchInPixels + x1) * channels]) / maxPixelValue;
            const double px2 = static_cast<int>(
              _data[(y1 * pitchInPixels + x2) * channels]) / maxPixelValue;
            const float h1 = (px1 - ((px1 - px2) * dx));

            const double px3 = static_cast<int>(
              _data[(y2 * pitchInPixels + x1) * channels]) / maxPixelValue;
            const double px4 = static_cast<int>(
              _data[(y2 * pitchInPixels + x2) * channels]) / maxPixelValue;
            const float h2 = (px3 - ((px3 - px4) * dx));
            float h = (h1 - ((h1 - h2) * dy)) * _scale.Z();

            // invert pixel definition so 1=ground, 0=full height,
            //   if the terrain size has a negative z component
            //   this is mainly for backward compatibility
            if (_size.Z() < 0)
              h = 1.0 - h;

            // Store the height for future use
            if (!_flipY)
              _heights[y * _vertSize + x] = h;
            else
              _heights[(_vertSize - y - 1) * _vertSize + x] = h;
          }
        }
      }
    };
  }
}
#endif