Skip to content

Commit 76305df

Browse files
authored
Update links in point cloud to mesh tutorial and fix screenshot link (#2632)
* Update links and fix image * use image tag Signed-off-by: Ian Chen <ichen@openrobotics.org>
1 parent 0e1f254 commit 76305df

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

tutorials/point_cloud_to_mesh.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ After installing, open CloudCompare and import your point cloud file by going to
2121
Depending on the number of points in your point cloud, this could take several minutes.
2222
Once loaded, you should see the following tunnel section:
2323

24-
![Opening the point cloud](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/cloudcompare2.png)
24+
\image html files/point_cloud_to_mesh/cloudcompare2.png
2525

2626
Many 3D scans will be composed of millions, sometimes hundreds of millions of points.
2727
Converting a scan to a 3D model with that many points would be very difficult due to the number of polygons that would be created and the long processing time necessary to compute the normals.
@@ -35,21 +35,21 @@ We'll still walk through reducing points, however, to make the process quicker.
3535

3636
To reduce the number of points in your cloud, click on the tunnel so a yellow cube outline appears around it, then go to `Edit` > `Subsample`.
3737

38-
![Min. space between points](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/min_space.jpg)
38+
\image html files/point_cloud_to_mesh/min_space.jpg
3939

4040
The number you will need to enter in the `min. space between points` field will vary depending on your point cloud.
4141
A value of .01 was sufficient to bring our point cloud to an easy-to-manage 1 million points.
4242
Point count is visible in the `Properties` window on the lower left side of the screen.
4343

44-
![Point count of subsample](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/properties.png)
44+
\image html files/point_cloud_to_mesh/properties.png
4545

4646
How many points you reduce down to will largely depend on how long you are willing to wait for the point cloud to be converted into a mesh.
4747
The more points you start with, the longer it will take to compute the normals and create the mesh.
4848

4949
After the operation is complete you’ll have two clouds in your scene: the original point cloud and your subsampled point cloud.
5050
Most operations in CloudCompare will create new point clouds and keep the original, so make sure that you have the new point cloud selected before running an operation.
5151

52-
![Selecting the new point cloud](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/secondcloud.png)
52+
\image html files/point_cloud_to_mesh/secondcloud.png
5353

5454
### Create a Polygonal Mesh
5555

@@ -60,7 +60,7 @@ A normal is essentially the direction a polygon is facing.
6060
To do this, go to `Edit` > `Normals` > `Compute`.
6161
You'll see this dialog box:
6262

63-
![Choose Triangulation surface model](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/compute_normals.png)
63+
\image html files/point_cloud_to_mesh/compute_normals.png
6464

6565
You’ll see various options in the dialog box that appears.
6666
The main thing you’ll want to consider is what `Local surface model` to use.
@@ -73,7 +73,7 @@ Now we get to actually convert our point cloud to a mesh.
7373
To do this go to `Plugins` > `PoissonRecon`.
7474
You'll see this dialog box:
7575

76-
![Octree depth and output density selection](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/outputdensity.png)
76+
\image html files/point_cloud_to_mesh/outputdensity.png
7777

7878
The value you enter in the `Octree depth` field will determine the polygon count of the created model.
7979
You may have to run the surface reconstruction a couple times with varying values before you land on a polygon count that is suitable for your needs.
@@ -94,18 +94,18 @@ Our tunnel has turned into a blob shape.
9494
This is because the mesh that CloudCompare creates will always be water tight even if it has to add polygons where there are no points.
9595
We just want our tunnels, though, so we need to remove those unnecessary polygons.
9696

97-
![The blob shape](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/blob2.jpg)
97+
\image html files/point_cloud_to_mesh/blob2.jpg
9898

9999
This is where our scalar field comes in.
100100
In the mesh's `Properties` window go to `SF display params` and take the left handle in the graph and drag it to the right until it hits the area where the bulk of the scalar field starts.
101101

102-
![Adjusting scalar filed params](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/sf_display.png)
102+
\image html files/point_cloud_to_mesh/sf_display.png
103103

104104
This will display only the polygons that were created from the point cloud and hide the polygons used to make the model watertight.
105105
The polygons are only hidden however.
106106
We still need to actually remove them.
107107

108-
![Display original polygons](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/hidden_polygons2.jpg)
108+
\image html files/point_cloud_to_mesh/hidden_polygons2.jpg
109109

110110
To remove the hidden polygons go to `Edit` > `Scalar fields` > `Filter By Value`.
111111

@@ -114,11 +114,11 @@ Hitting export will simply export the mesh within that range.
114114
Instead, we'll hit `Split` to create two meshes.
115115
One with the polygons inside our specified range and one containing polygons outside that range.
116116

117-
![Splitting the mesh](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/split.png)
117+
\image html files/point_cloud_to_mesh/split.png
118118

119119
It is possible that you will get error "Visibility table not instantiated". This error causes only the "wanted" part of the mesh to be created when splitting, while the other ("unwanted") part will not be generated. But that is not a problem for our use-case.
120120

121-
![Error "Visibility table not instantiated"](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/error.jpg)
121+
\image html files/point_cloud_to_mesh/error.jpg
122122

123123
### The Completed Model
124124

@@ -128,6 +128,6 @@ Your file format will depend on the software you want to use but `.obj` is a wid
128128

129129
Before exporting, check your mesh for holes. If still checked, disable display of the pointcloud, so that only your output mesh is shown. Inspect ground parts of the mesh (or any other parts you are most interested in) and check if there aren't holes in it. If there are some, you can try to repeat the trimming step with more relaxed threshold.
130130

131-
![The completed mesh](https://raw.githubusercontent.com/gazebosim/gz-sim/main/tutorials/files/point_cloud_to_mesh/complete2.png)
131+
\image html files/point_cloud_to_mesh/complete2.png
132132

133133
You can find more information on CloudCompare and a more in depth look at the tools we used in this tutorial on [the CloudCompare website](https://www.cloudcompare.org/) and the [CloudCompare wiki](https://www.cloudcompare.org/doc/wiki/index.php?title=Main_Page).

0 commit comments

Comments
 (0)