Input/Output

This module offers convenience overloads of input/ouput functions available in the Point Set Processing package. These overloads, available after including CGAL/Point_set_3/IO.h, allow the user to call point set processing algorithms without having to handle manually property maps and iterators.

Simon Giraudot

This component provides the user with a flexible 3D point set data structure. The user can define any additional property needed such as normal vectors, colors or labels. CGAL algorithms can be easily applied to this data structure.

Introduced in: CGAL 4.10
BibTeX: cgal:g-ps-20a
License: GPL
Windows Demo: Polyhedron demo
Common Demo Dlls: dlls

Classified Reference Pages

Class

• CGAL::Point_set_3<Point,Vector>

Input functions instanciate all the necessary property maps:

• if found in the input, normal vectors are stored in the usual CGAL::Point_set_3 property normal with template type Vector
• for PLY and LAS input, other properties are stored as properties in the CGAL::Point_set_3 class with the name and type given by the PLY header or by the LAS standard.

For a complete documentation of these functions, please refer to the Point Set Processing Reference manual.

Functions
template<typename Point , typename Vector >
bool	CGAL::read_xyz_point_set (std::istream &stream, CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::read_off_point_set (std::istream &stream, CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::read_ply_point_set (std::istream &stream, CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::write_ply_point_set (std::ostream &stream, const CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::read_las_point_set (std::istream &stream, CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::write_las_point_set (std::ostream &stream, CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::write_xyz_point_set (std::ostream &stream, const CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
bool	CGAL::write_off_point_set (std::ostream &stream, const CGAL::Point_set_3< Point, Vector > &point_set)
template<typename Point , typename Vector >
std::istream &	operator>> (std::istream &is, CGAL::Point_set_3< Point, Vector > &ps)
	Reads the point set from an input stream that can be either: More...
template<typename Point , typename Vector >
std::ostream &	operator<< (std::ostream &os, const CGAL::Point_set_3< Point, Vector > &ps)
	Inserts the point set in an output stream in ASCII PLY format. More...

Function Documentation

operator

template<typename Point , typename Vector >

std::ostream & operator<< ( std::ostream &  os, const CGAL::Point_set_3< Point, Vector > &  ps  )

related

Inserts the point set in an output stream in ASCII PLY format.

All properties are inserted in their instantiation order.

operator>>()

template<typename Point , typename Vector >

std::istream & operator>> ( std::istream &  is, CGAL::Point_set_3< Point, Vector > &  ps  )

related

Reads the point set from an input stream that can be either:

• XYZ
• OFF
• PLY
• LAS

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.

read_las_point_set()

template<typename Point , typename Vector >

bool CGAL::read_las_point_set	(	std::istream &	stream,
		CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	input stream.
point_set	point set

read_off_point_set()

template<typename Point , typename Vector >

bool CGAL::read_off_point_set	(	std::istream &	stream,
		CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	input stream.
point_set	point set

read_ply_point_set()

template<typename Point , typename Vector >

bool CGAL::read_ply_point_set	(	std::istream &	stream,
		CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	input stream.
point_set	point set

Examples:

Point_set_3/point_set_read_ply.cpp.

read_xyz_point_set()

template<typename Point , typename Vector >

bool CGAL::read_xyz_point_set	(	std::istream &	stream,
		CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	input stream.
point_set	point set

Examples:

Point_set_3/point_set_read_xyz.cpp.

write_las_point_set()

template<typename Point , typename Vector >

bool CGAL::write_las_point_set	(	std::ostream &	stream,
		CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	output stream.
point_set	point set

write_off_point_set()

template<typename Point , typename Vector >

bool CGAL::write_off_point_set	(	std::ostream &	stream,
		const CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	output stream.
point_set	point set

Examples:

Point_set_3/point_set_read_xyz.cpp.

write_ply_point_set()

template<typename Point , typename Vector >

bool CGAL::write_ply_point_set	(	std::ostream &	stream,
		const CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	output stream.
point_set	point set

Examples:

Point_set_3/point_set_read_ply.cpp.

write_xyz_point_set()

template<typename Point , typename Vector >

bool CGAL::write_xyz_point_set	(	std::ostream &	stream,
		const CGAL::Point_set_3< Point, Vector > &	point_set
	)

#include <CGAL/Point_set_3/IO.h>

Parameters

stream	output stream.
point_set	point set