Open3D (C++ API)  0.19.0
Loading...
Searching...
No Matches
FilamentGeometryBuffersBuilder.h
Go to the documentation of this file.
1// ----------------------------------------------------------------------------
2// - Open3D: www.open3d.org -
3// ----------------------------------------------------------------------------
4// Copyright (c) 2018-2024 www.open3d.org
5// SPDX-License-Identifier: MIT
6// ----------------------------------------------------------------------------
7
8#pragma once
9
13
14// clang-format off
15// NOTE: This header must precede the Filament headers otherwise a conflict
16// occurs between Filament and standard headers
18
19// 4068: Filament has some clang-specific vectorizing pragma's that MSVC flags
20// 4146: Filament's utils/algorithm.h utils::details::ctz() tries to negate
21// an unsigned int.
22// 4293: Filament's utils/algorithm.h utils::details::clz() does strange
23// things with MSVC. Somehow sizeof(unsigned int) > 4, but its size is
24// 32 so that x >> 32 gives a warning. (Or maybe the compiler can't
25// determine the if statement does not run.)
26#ifdef _MSC_VER
27#pragma warning(push)
28#pragma warning(disable : 4068 4146 4293)
29// Filament uses OPAQUE and TRANSPARENT as enums which conflicts with windows.h
30#undef OPAQUE
31#undef TRANSPARENT
32#endif // _MSC_VER
33
34#include <filament/Box.h>
35#include <filament/RenderableManager.h>
36
37#ifdef _MSC_VER
38#pragma warning(pop)
39#endif // _MSC_VER
40// clang-format on
41
42#include <memory>
43#include <tuple>
44
45namespace open3d {
46
47namespace geometry {
48class Geometry3D;
49class LineSet;
50class PointCloud;
51class TriangleMesh;
52} // namespace geometry
53
54namespace visualization {
55namespace rendering {
56
58public:
59 // Note that the downsampled index buffer may be kBadId if a downsampled
60 // buffer was not requested, failed, or cannot be created (e.g. if not
61 // a point cloud).
62 using Buffers = std::tuple<VertexBufferHandle, // vertex buffer
63 IndexBufferHandle, // index buffer
64 IndexBufferHandle>; // downsampled buffer
65 using IndexType = std::uint32_t;
66
67 static std::unique_ptr<GeometryBuffersBuilder> GetBuilder(
68 const geometry::Geometry3D& geometry);
69 static std::unique_ptr<GeometryBuffersBuilder> GetBuilder(
70 const t::geometry::Geometry& geometry);
71
72 virtual ~GeometryBuffersBuilder() = default;
73
74 virtual filament::RenderableManager::PrimitiveType GetPrimitiveType()
75 const = 0;
76
77 // Defaults to infinity (that is, no downsampling). If threshold is
78 // set and the number of points exceeds the threshold, ConstructBuffers()
79 // will return a downsampled index buffer. Certain builders may ignore
80 // this threshold.
81 virtual void SetDownsampleThreshold(size_t min_points) {
82 downsample_threshold_ = min_points;
83 }
84
85 // Instructs LineSetBuffersBuilder to build lines out of triangles for wide
86 // lines shader.
87 virtual void SetWideLines() { wide_lines_ = true; }
88
89 virtual void SetAdjustColorsForSRGBToneMapping(bool adjust) {
91 }
92
94 virtual filament::Box ComputeAABB() = 0;
95
96protected:
97 size_t downsample_threshold_ = SIZE_MAX;
98 bool wide_lines_ = false;
100
101 static void DeallocateBuffer(void* buffer, size_t size, void* user_ptr);
102
103 static IndexBufferHandle CreateIndexBuffer(size_t max_index,
104 size_t n_subsamples = SIZE_MAX);
105};
106
108public:
109 explicit TriangleMeshBuffersBuilder(const geometry::TriangleMesh& geometry);
110
111 filament::RenderableManager::PrimitiveType GetPrimitiveType()
112 const override;
113
114 Buffers ConstructBuffers() override;
115 filament::Box ComputeAABB() override;
116
117private:
118 const geometry::TriangleMesh& geometry_;
119};
120
122public:
123 explicit PointCloudBuffersBuilder(const geometry::PointCloud& geometry);
124
125 filament::RenderableManager::PrimitiveType GetPrimitiveType()
126 const override;
127
128 Buffers ConstructBuffers() override;
129 filament::Box ComputeAABB() override;
130
131private:
132 const geometry::PointCloud& geometry_;
133};
134
136public:
137 explicit LineSetBuffersBuilder(const geometry::LineSet& geometry);
138
139 filament::RenderableManager::PrimitiveType GetPrimitiveType()
140 const override;
141
142 Buffers ConstructBuffers() override;
143 filament::Box ComputeAABB() override;
144
145private:
146 Buffers ConstructThinLines();
147
148 const geometry::LineSet& geometry_;
149};
150
152public:
153 explicit TMeshBuffersBuilder(const t::geometry::TriangleMesh& geometry);
154
155 filament::RenderableManager::PrimitiveType GetPrimitiveType()
156 const override;
157
158 Buffers ConstructBuffers() override;
159 filament::Box ComputeAABB() override;
160
161private:
163};
164
166public:
167 explicit TPointCloudBuffersBuilder(const t::geometry::PointCloud& geometry);
168
169 filament::RenderableManager::PrimitiveType GetPrimitiveType()
170 const override;
171
172 Buffers ConstructBuffers() override;
173 filament::Box ComputeAABB() override;
174
175private:
176 t::geometry::PointCloud geometry_;
177};
178
180public:
181 explicit TLineSetBuffersBuilder(const t::geometry::LineSet& geometry);
182
183 filament::RenderableManager::PrimitiveType GetPrimitiveType()
184 const override;
185
186 Buffers ConstructBuffers() override;
187 filament::Box ComputeAABB() override;
188
189private:
192 void ConstructThinLines(uint32_t& n_vertices,
193 float** vertex_data,
194 uint32_t& n_indices,
195 uint32_t& indices_bytes,
196 uint32_t** line_indices);
199 void ConstructWideLines(uint32_t& n_vertices,
200 float** vertex_data,
201 uint32_t& n_indices,
202 uint32_t& indices_bytes,
203 uint32_t** line_indices);
204 t::geometry::LineSet geometry_;
205};
206
207} // namespace rendering
208} // namespace visualization
209} // namespace open3d
The base geometry class for 3D geometries.
Definition Geometry3D.h:28
LineSet define a sets of lines in 3D. A typical application is to display the point cloud corresponde...
Definition LineSet.h:29
A point cloud consists of point coordinates, and optionally point colors and point normals.
Definition PointCloud.h:36
Triangle mesh contains vertices and triangles represented by the indices to the vertices.
Definition TriangleMesh.h:35
The base geometry class.
Definition Geometry.h:23
A LineSet contains points and lines joining them and optionally attributes on the points and lines.
Definition LineSet.h:84
A point cloud contains a list of 3D points.
Definition PointCloud.h:81
A triangle mesh contains vertices and triangles.
Definition TriangleMesh.h:96
Definition FilamentGeometryBuffersBuilder.h:57
std::tuple< VertexBufferHandle, IndexBufferHandle, IndexBufferHandle > Buffers
Definition FilamentGeometryBuffersBuilder.h:64
bool adjust_colors_for_srgb_tonemapping_
Definition FilamentGeometryBuffersBuilder.h:99
static void DeallocateBuffer(void *buffer, size_t size, void *user_ptr)
Definition FilamentGeometryBuffersBuilder.cpp:269
virtual void SetAdjustColorsForSRGBToneMapping(bool adjust)
Definition FilamentGeometryBuffersBuilder.h:89
std::uint32_t IndexType
Definition FilamentGeometryBuffersBuilder.h:65
static std::unique_ptr< GeometryBuffersBuilder > GetBuilder(const geometry::Geometry3D &geometry)
Definition FilamentGeometryBuffersBuilder.cpp:200
bool wide_lines_
Definition FilamentGeometryBuffersBuilder.h:98
size_t downsample_threshold_
Definition FilamentGeometryBuffersBuilder.h:97
virtual void SetWideLines()
Definition FilamentGeometryBuffersBuilder.h:87
static IndexBufferHandle CreateIndexBuffer(size_t max_index, size_t n_subsamples=SIZE_MAX)
Definition PointCloudBuffers.cpp:89
virtual void SetDownsampleThreshold(size_t min_points)
Definition FilamentGeometryBuffersBuilder.h:81
virtual filament::RenderableManager::PrimitiveType GetPrimitiveType() const =0
Definition FilamentGeometryBuffersBuilder.h:135
filament::RenderableManager::PrimitiveType GetPrimitiveType() const override
Definition LineSetBuffers.cpp:86
Buffers ConstructBuffers() override
Definition LineSetBuffers.cpp:226
filament::Box ComputeAABB() override
Definition LineSetBuffers.cpp:349
Definition FilamentGeometryBuffersBuilder.h:121
Buffers ConstructBuffers() override
Definition PointCloudBuffers.cpp:160
filament::RenderableManager::PrimitiveType GetPrimitiveType() const override
Definition PointCloudBuffers.cpp:155
filament::Box ComputeAABB() override
Definition PointCloudBuffers.cpp:266
Definition FilamentGeometryBuffersBuilder.h:179
Buffers ConstructBuffers() override
Definition LineSetBuffers.cpp:550
filament::RenderableManager::PrimitiveType GetPrimitiveType() const override
Definition LineSetBuffers.cpp:402
filament::Box ComputeAABB() override
Definition LineSetBuffers.cpp:632
Definition FilamentGeometryBuffersBuilder.h:151
Buffers ConstructBuffers() override
Definition TriangleMeshBuffers.cpp:614
filament::RenderableManager::PrimitiveType GetPrimitiveType() const override
Definition TriangleMeshBuffers.cpp:610
filament::Box ComputeAABB() override
Definition TriangleMeshBuffers.cpp:810
Definition FilamentGeometryBuffersBuilder.h:165
Buffers ConstructBuffers() override
Definition PointCloudBuffers.cpp:337
filament::Box ComputeAABB() override
Definition PointCloudBuffers.cpp:468
filament::RenderableManager::PrimitiveType GetPrimitiveType() const override
Definition PointCloudBuffers.cpp:332
Definition FilamentGeometryBuffersBuilder.h:107
filament::Box ComputeAABB() override
Definition TriangleMeshBuffers.cpp:549
Buffers ConstructBuffers() override
Definition TriangleMeshBuffers.cpp:415
filament::RenderableManager::PrimitiveType GetPrimitiveType() const override
Definition TriangleMeshBuffers.cpp:410
int size
Definition FilePCD.cpp:40
REHandle< EntityType::IndexBuffer > IndexBufferHandle
Definition RendererHandle.h:139
REHandle< EntityType::VertexBuffer > VertexBufferHandle
Definition RendererHandle.h:138
Definition PinholeCameraIntrinsic.cpp:16