Open3D (C++ API)
ScalableTSDFVolume.h
Go to the documentation of this file.
1 // ----------------------------------------------------------------------------
2 // - Open3D: www.open3d.org -
3 // ----------------------------------------------------------------------------
4 // The MIT License (MIT)
5 //
6 // Copyright (c) 2018 www.open3d.org
7 //
8 // Permission is hereby granted, free of charge, to any person obtaining a copy
9 // of this software and associated documentation files (the "Software"), to deal
10 // in the Software without restriction, including without limitation the rights
11 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12 // copies of the Software, and to permit persons to whom the Software is
13 // furnished to do so, subject to the following conditions:
14 //
15 // The above copyright notice and this permission notice shall be included in
16 // all copies or substantial portions of the Software.
17 //
18 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
23 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
24 // IN THE SOFTWARE.
25 // ----------------------------------------------------------------------------
26 
27 #pragma once
28 
29 #include <memory>
30 #include <unordered_map>
31 
33 #include "Open3D/Utility/Helper.h"
34 
35 namespace open3d {
36 namespace integration {
37 
38 class UniformTSDFVolume;
39 
59 public:
60  struct VolumeUnit {
61  public:
62  VolumeUnit() : volume_(NULL) {}
63 
64  public:
65  std::shared_ptr<UniformTSDFVolume> volume_;
66  Eigen::Vector3i index_;
67  };
68 
69 public:
70  ScalableTSDFVolume(double voxel_length,
71  double sdf_trunc,
72  TSDFVolumeColorType color_type,
73  int volume_unit_resolution = 16,
74  int depth_sampling_stride = 4);
75  ~ScalableTSDFVolume() override;
76 
77 public:
78  void Reset() override;
79  void Integrate(const geometry::RGBDImage &image,
80  const camera::PinholeCameraIntrinsic &intrinsic,
81  const Eigen::Matrix4d &extrinsic) override;
82  std::shared_ptr<geometry::PointCloud> ExtractPointCloud() override;
83  std::shared_ptr<geometry::TriangleMesh> ExtractTriangleMesh() override;
85  std::shared_ptr<geometry::PointCloud> ExtractVoxelPointCloud();
86 
87 public:
91 
95  std::unordered_map<Eigen::Vector3i,
96  VolumeUnit,
99 
100 private:
101  Eigen::Vector3i LocateVolumeUnit(const Eigen::Vector3d &point) {
102  return Eigen::Vector3i((int)std::floor(point(0) / volume_unit_length_),
103  (int)std::floor(point(1) / volume_unit_length_),
104  (int)std::floor(point(2) / volume_unit_length_));
105  }
106 
107  std::shared_ptr<UniformTSDFVolume> OpenVolumeUnit(
108  const Eigen::Vector3i &index);
109 
110  Eigen::Vector3d GetNormalAt(const Eigen::Vector3d &p);
111 
112  double GetTSDFAt(const Eigen::Vector3d &p);
113 };
114 
115 } // namespace integration
116 } // namespace open3d
double volume_unit_length_
Definition: ScalableTSDFVolume.h:89
Definition: ScalableTSDFVolume.h:58
TSDFVolumeColorType
Definition: TSDFVolume.h:40
Definition: Helper.h:92
int volume_unit_resolution_
Definition: ScalableTSDFVolume.h:88
Contains the pinhole camera intrinsic parameters.
Definition: PinholeCameraIntrinsic.h:51
Base class of the Truncated Signed Distance Function (TSDF) volume.
Definition: TSDFVolume.h:60
Eigen::Vector3i index_
Definition: ScalableTSDFVolume.h:66
int depth_sampling_stride_
Definition: ScalableTSDFVolume.h:90
VolumeUnit()
Definition: ScalableTSDFVolume.h:62
void Integrate(const geometry::RGBDImage &image, const camera::PinholeCameraIntrinsic &intrinsic, const Eigen::Matrix4d &extrinsic) override
Function to integrate an RGB-D image into the volume.
Definition: ScalableTSDFVolume.cpp:53
std::shared_ptr< geometry::TriangleMesh > ExtractTriangleMesh() override
Function to extract a triangle mesh, using the marching cubes algorithm. (https://en.wikipedia.org/wiki/Marching_cubes)
Definition: ScalableTSDFVolume.cpp:211
RGBDImage is for a pair of registered color and depth images,.
Definition: RGBDImage.h:46
std::shared_ptr< geometry::PointCloud > ExtractVoxelPointCloud()
Debug function to extract the voxel data into a point cloud.
Definition: ScalableTSDFVolume.cpp:361
std::unordered_map< Eigen::Vector3i, VolumeUnit, utility::hash_eigen::hash< Eigen::Vector3i > > volume_units_
Definition: ScalableTSDFVolume.h:98
~ScalableTSDFVolume() override
Definition: ScalableTSDFVolume.cpp:49
Definition: Open3DViewer.h:29
Definition: ScalableTSDFVolume.h:60
ScalableTSDFVolume(double voxel_length, double sdf_trunc, TSDFVolumeColorType color_type, int volume_unit_resolution=16, int depth_sampling_stride=4)
Definition: ScalableTSDFVolume.cpp:39
std::shared_ptr< geometry::PointCloud > ExtractPointCloud() override
Function to extract a point cloud with normals.
Definition: ScalableTSDFVolume.cpp:108
void Reset() override
Function to reset the TSDFVolume.
Definition: ScalableTSDFVolume.cpp:51
std::shared_ptr< UniformTSDFVolume > volume_
Definition: ScalableTSDFVolume.h:65