1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
// Copyright (c) 2016 GeometryFactory Sarl (France).
// All rights reserved.
//
// This file is part of CGAL (www.cgal.org).
//
// $URL: https://github.com/CGAL/cgal/blob/v6.1.1/Point_set_3/include/CGAL/Point_set_3/IO.h $
// $Id: include/CGAL/Point_set_3/IO.h 08b27d3db14 $
// SPDX-License-Identifier: GPL-3.0-or-later OR LicenseRef-Commercial
//
//
// Author(s) : Simon Giraudot
#ifndef CGAL_POINT_SET_3_IO
#define CGAL_POINT_SET_3_IO
#include <CGAL/license/Point_set_3.h>
#include <CGAL/IO/helpers.h>
#include <CGAL/Point_set_3/IO/LAS.h>
#include <CGAL/Point_set_3/IO/OFF.h>
#include <CGAL/Point_set_3/IO/PLY.h>
#include <CGAL/Point_set_3/IO/XYZ.h>
#include <fstream>
#include <string>
namespace CGAL {
template <typename Point, typename Vector>
class Point_set_3;
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
// Read
/*!
\ingroup PkgPointSet3IO
\brief reads the point set from an input stream.
Supported file formats are the following:
- \ref IOStreamOFF (`.off`)
- \ref IOStreamPLY (`.ply`)
- \ref IOStreamLAS (`.las`)
- \ref IOStreamXYZ (`.xyz`)
The format is detected from the stream. If the stream contains
normal vectors, the normal map is added to the point set. For PLY
input, all point properties found in the header are added.
\attention To read a binary file, the flag `std::ios::binary` must be set during the creation of the `ifstream`.
\param is input stream
\param ps point set
\return `is`
\relates Point_set_3
*/
template <typename Point, typename Vector>
std::istream& operator>>(std::istream& is,
CGAL::Point_set_3<Point, Vector>& ps)
{
// Check format identifier on first line
std::string line;
if(!getline(is, line))
return is;
is.seekg(0);
if(line.find("OFF") == 0 || line.find("NOFF") == 0)
CGAL::IO::read_OFF(is, ps);
else if(line.find("ply") == 0)
CGAL::IO::read_PLY(is, ps);
#ifdef CGAL_LINKED_WITH_LASLIB
else if(line.find("LASF") == 0)
CGAL::IO::read_LAS(is, ps);
#endif // LAS
else
CGAL::IO::read_XYZ(is, ps);
return is;
}
namespace IO {
/*!
\ingroup PkgPointSet3IO
\brief reads the point set from an input file.
Supported file formats are the following:
- \ref IOStreamOFF (`.off`)
- \ref IOStreamPLY (`.ply`)
- \ref IOStreamLAS (`.las`)
- \ref IOStreamXYZ (`.xyz`)
The format is detected from the filename extension (letter case is not important).
If the file contains normal vectors, the normal map is added to the point set.
For PLY input, all point properties found in the header are added.
\tparam Point the point type of the `Point_set_3`
\tparam Vector the vector type of the `Point_set_3`
\tparam NamedParameters a sequence of \ref bgl_namedparameters "Named Parameters"
\param fname name of the input file
\param ps the point set
\param np an optional sequence of \ref bgl_namedparameters "Named Parameters" among the ones listed below
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamExtra{This parameter is only relevant for `PLY` writing: the `OFF` and `XYZ` formats
are always \ascii, and the `LAS` format is always binary.}
\cgalParamNEnd
\cgalNamedParamsEnd
\return `true` if the reading was successful, `false` otherwise.
*/
template <typename Point, typename Vector, typename CGAL_NP_TEMPLATE_PARAMETERS>
bool read_point_set(const std::string& fname,
CGAL::Point_set_3<Point, Vector>& ps,
const CGAL_NP_CLASS& np = parameters::default_values())
{
const std::string ext = internal::get_file_extension(fname);
if(ext == "xyz" || ext == "pwn")
return read_XYZ(fname, ps);
else if(ext == "off")
return read_OFF(fname, ps);
else if(ext =="ply")
return read_PLY(fname, ps, np);
#ifdef CGAL_LINKED_WITH_LASLIB
else if(ext == "las")
return read_LAS(fname, ps);
#endif
return false;
}
} // namespace IO
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
// Write
/*!
\ingroup PkgPointSet3IO
\brief writes the point set in an output stream in the \ref IOStreamPLY.
All properties are inserted in their instantiation order.
\attention To write to a binary file, the flag `std::ios::binary` must be set during the creation
of the `ofstream`, and the \link PkgStreamSupportEnumRef `IO::Mode` \endlink
of the stream must be set to `BINARY`.
\param os the output stream
\param ps the point set
\return `os`
\relates Point_set_3
*/
template <typename Point, typename Vector>
std::ostream& operator<<(std::ostream& os,
const CGAL::Point_set_3<Point, Vector>& ps)
{
IO::write_PLY(os, ps);
return os;
}
namespace IO {
/*!
\ingroup PkgPointSet3IO
\brief writes the point set in an output file.
Supported file formats are the following:
- \ref IOStreamOFF (`.off`)
- \ref IOStreamPLY (`.ply`)
- \ref IOStreamLAS (`.las`)
- \ref IOStreamXYZ (`.xyz`)
The format is detected from the filename extension (letter case is not important).
\tparam Point the point type of the `Point_set_3`
\tparam Vector the vector type of the `Point_set_3`
\tparam NamedParameters a sequence of \ref bgl_namedparameters "Named Parameters"
\param fname name of the output file
\param ps the point set
\param np an optional sequence of \ref bgl_namedparameters "Named Parameters" among the ones listed below
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamExtra{This parameter is only relevant for `PLY` writing: the `OFF` and `XYZ` formats
are always \ascii, and the `LAS` format is always binary.}
\cgalParamNEnd
\cgalParamNBegin{stream_precision}
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{`6`}
\cgalParamNEnd
\cgalNamedParamsEnd
\return `true` if the writing was successful, `false` otherwise.
*/
template <typename Point, typename Vector, typename CGAL_NP_TEMPLATE_PARAMETERS>
bool write_point_set(const std::string& fname,
CGAL::Point_set_3<Point, Vector>& ps,
const CGAL_NP_CLASS& np = parameters::default_values())
{
const std::string ext = internal::get_file_extension(fname);
if(ext == "xyz")
return write_XYZ(fname, ps, np);
else if(ext == "off")
return write_OFF(fname, ps, np);
else if(ext == "ply")
return write_PLY(fname, ps, np);
#ifdef CGAL_LINKED_WITH_LASLIB
else if(ext == "las")
return write_LAS(fname, ps);
#endif
return false;
}
} // namespace IO
} // namespace CGAL
#endif // CGAL_POINT_SET_3_IO
|
