// Copyright (c) 2015-2020 Geometry Factory // All rights reserved. // // This file is part of CGAL (www.cgal.org) // // $URL$ // $Id$ // SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-Commercial // // Author(s) : Simon Giraudot #ifndef CGAL_IO_PLY_H #define CGAL_IO_PLY_H #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace CGAL { //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////////////////////////// // Read namespace IO { namespace internal { // HEdgesRange = range of std::pair // HUVRange = range of std::pair template bool read_PLY(std::istream& is, PointRange& points, PolygonRange& polygons, std::string& comments, HEdgesOutputIterator hedges_out, ColorOutputIterator fc_out, ColorOutputIterator vc_out, HUVOutputIterator huvs_out, const bool verbose = false, std::enable_if_t::value>* = nullptr) { typedef typename boost::range_value::type Point_3; typedef CGAL::IO::Color Color_rgb; if(!is.good()) { if(verbose) std::cerr << "Error: cannot open file" << std::endl; return false; } internal::PLY_reader reader(verbose); if(!(reader.init(is))) { is.setstate(std::ios::failbit); return false; } comments = reader.comments(); for(std::size_t i=0; i("red") || element.has_property("r")) && (element.has_property("green") || element.has_property("g")) && (element.has_property("blue") || element.has_property("b"))) { has_colors = true; if(element.has_property("red")) { rtag = "red"; gtag = "green"; btag = "blue"; } } for(std::size_t j=0; jget(is); if(is.fail()) return false; } std::tuple new_vertex; if(has_colors) { internal::process_properties(element, new_vertex, make_ply_point_reader(CGAL::make_nth_of_tuple_property_map<0>(new_vertex)), std::make_pair(CGAL::make_nth_of_tuple_property_map<1>(new_vertex), PLY_property(rtag.c_str())), std::make_pair(CGAL::make_nth_of_tuple_property_map<2>(new_vertex), PLY_property(gtag.c_str())), std::make_pair(CGAL::make_nth_of_tuple_property_map<3>(new_vertex), PLY_property(btag.c_str()))); *vc_out++ = Color_rgb(get<1>(new_vertex), get<2>(new_vertex), get<3>(new_vertex)); } else { internal::process_properties(element, new_vertex, make_ply_point_reader(CGAL::make_nth_of_tuple_property_map<0>(new_vertex))); } points.push_back(get<0>(new_vertex)); } } else if(element.name() == "face" || element.name() == "faces") { if(element.has_property >("vertex_indices")) { internal::read_PLY_faces(is, element, polygons, fc_out, "vertex_indices"); } else if(element.has_property >("vertex_indices")) { internal::read_PLY_faces(is, element, polygons, fc_out, "vertex_indices"); } else if(element.has_property >("vertex_index")) { internal::read_PLY_faces(is, element, polygons, fc_out, "vertex_index"); } else if(element.has_property >("vertex_index")) { internal::read_PLY_faces(is, element, polygons, fc_out, "vertex_index"); } else { if(verbose) std::cerr << "Error: can't find vertex indices in PLY input" << std::endl; return false; } } else if(element.name() == "halfedge" ) { bool has_uv = false; std::string stag = "source", ttag = "target", utag = "u", vtag = "v"; if(element.has_property("source") && element.has_property("target") && element.has_property("u") && element.has_property("v")) { has_uv = true; } std::tuple new_hedge; for(std::size_t j=0; jget(is); if(is.fail()) return false; } if(has_uv) { internal::process_properties(element, new_hedge, std::make_pair(CGAL::make_nth_of_tuple_property_map<0>(new_hedge), PLY_property(stag.c_str())), std::make_pair(CGAL::make_nth_of_tuple_property_map<1>(new_hedge), PLY_property(ttag.c_str())), std::make_pair(CGAL::make_nth_of_tuple_property_map<2>(new_hedge), PLY_property(utag.c_str())), std::make_pair(CGAL::make_nth_of_tuple_property_map<3>(new_hedge), PLY_property(vtag.c_str()))); *hedges_out++ = std::make_pair(get<0>(new_hedge), get<1>(new_hedge)); *huvs_out++ = std::make_pair(get<2>(new_hedge), get<3>(new_hedge)); } else { internal::process_properties(element, new_hedge, std::make_pair(CGAL::make_nth_of_tuple_property_map<0>(new_hedge), PLY_property(stag.c_str())), std::make_pair(CGAL::make_nth_of_tuple_property_map<1>(new_hedge), PLY_property(ttag.c_str()))); } } } else // Read other elements and ignore { for(std::size_t j=0; jget(is); if(is.fail()) return false; } } } } return !is.fail(); } } // namespace internal /// \cond SKIP_IN_MANUAL template bool read_PLY(std::istream& is, PointRange& points, PolygonRange& polygons, std::string& comments, HEdgesRange& hedges, ColorRange& fcolors, ColorRange& vcolors, HUVRange& huvs, const bool verbose = false, std::enable_if_t::value>* = nullptr) { return internal::read_PLY(is, points, polygons, comments, std::back_inserter(hedges), std::back_inserter(fcolors), std::back_inserter(vcolors), std::back_inserter(huvs), verbose); } template bool read_PLY(std::istream& is, PointRange& points, PolygonRange& polygons, std::string& comments, ColorRange& fcolors, ColorRange& vcolors, const bool verbose = false) { std::vector > dummy_pui; std::vector > dummy_pf; return internal::read_PLY(is, points, polygons, comments, std::back_inserter(dummy_pui), std::back_inserter(fcolors), std::back_inserter(vcolors), std::back_inserter(dummy_pf), verbose); } /// \endcond /*! * \ingroup PkgStreamSupportIoFuncsPLY * * \brief reads the content of `is` into `points` and `polygons`, using the \ref IOStreamPLY. * * \attention The polygon soup is not cleared, and the data from the stream are appended. * * \attention To read a binary file, the flag `std::ios::binary` must be set during the creation of the `ifstream`. * * \tparam PointRange a model of the concepts `RandomAccessContainer` and `BackInsertionSequence` * whose value type is the point type * \tparam PolygonRange a model of the concepts `SequenceContainer` and `BackInsertionSequence` * whose `value_type` is itself a model of the concept `SequenceContainer` * and `BackInsertionSequence` whose `value_type` is an unsigned integer type * convertible to `std::size_t` * \tparam NamedParameters a sequence of \ref bgl_namedparameters "Named Parameters" * * \param is the input stream * \param points points of the soup of polygons * \param polygons a range of polygons. Each element in it describes a polygon * using the indices of the points in `points` * \param comments a string that will contain all the comments found in the PLY file * \param np optional \ref bgl_namedparameters "Named Parameters" described below * * \cgalNamedParamsBegin * \cgalParamNBegin{use_binary_mode} * \cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)} * \cgalParamType{Boolean} * \cgalParamDefault{`true`} * \cgalParamNEnd * * \cgalParamNBegin{verbose} * \cgalParamDescription{indicates whether output warnings and error messages should be printed or not.} * \cgalParamType{Boolean} * \cgalParamDefault{`false`} * \cgalParamNEnd * \cgalNamedParamsEnd * * \returns `true` if the reading was successful, `false` otherwise. */ template bool read_PLY(std::istream& is, PointRange& points, PolygonRange& polygons, std::string& comments, const CGAL_NP_CLASS& np = parameters::default_values() #ifndef DOXYGEN_RUNNING , std::enable_if_t::value>* = nullptr #endif ) { using parameters::choose_parameter; using parameters::get_parameter; std::vector > dummy_pui; std::vector > dummy_pf; return internal::read_PLY(is, points, polygons, comments, std::back_inserter(dummy_pui), choose_parameter(get_parameter(np, internal_np::face_color_output_iterator), CGAL::Emptyset_iterator()), choose_parameter(get_parameter(np, internal_np::vertex_color_output_iterator), CGAL::Emptyset_iterator()), std::back_inserter(dummy_pf), choose_parameter(get_parameter(np, internal_np::verbose), true)); } template bool read_PLY(std::istream& is, PointRange& points, PolygonRange& polygons, const CGAL_NP_CLASS& np = parameters::default_values() #ifndef DOXYGEN_RUNNING , std::enable_if_t::value>* = nullptr #endif ) { std::string unused_comments; return read_PLY(is, points, polygons, unused_comments, np); } /*! * \ingroup PkgStreamSupportIoFuncsPLY * * \brief reads the content of `fname` into `points` and `polygons`, using the \ref IOStreamPLY. * * \attention The polygon soup is not cleared, and the data from the file are appended. * * \tparam PointRange a model of the concept `RandomAccessContainer` whose value type is the point type. * \tparam PolygonRange a model of the concepts `SequenceContainer` and `BackInsertionSequence` * whose `value_type` is itself a model of the concept `SequenceContainer` * and `BackInsertionSequence` whose `value_type` is an integer type * \tparam NamedParameters a sequence of \ref bgl_namedparameters "Named Parameters" * * \param fname the path to the input file * \param points points of the soup of polygons * \param polygons a range of polygons. Each element in it describes a polygon * using the indices of the points in `points` * \param comments a string that will contain all the comments found in the PLY file * \param np optional \ref bgl_namedparameters "Named Parameters" described below * * \cgalNamedParamsBegin * \cgalParamNBegin{use_binary_mode} * \cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)} * \cgalParamType{Boolean} * \cgalParamDefault{`true`} * \cgalParamNEnd * * \cgalParamNBegin{verbose} * \cgalParamDescription{indicates whether output warnings and error messages should be printed or not.} * \cgalParamType{Boolean} * \cgalParamDefault{`false`} * \cgalParamNEnd * \cgalNamedParamsEnd * * \returns `true` if the reading was successful, `false` otherwise. */ template bool read_PLY(const std::string& fname, PointRange& points, PolygonRange& polygons, std::string& comments, const CGAL_NP_CLASS& np = parameters::default_values() #ifndef DOXYGEN_RUNNING , std::enable_if_t::value>* = nullptr #endif ) { const bool binary = parameters::choose_parameter(parameters::get_parameter(np, internal_np::use_binary_mode), true); if(binary) { std::ifstream is(fname, std::ios::binary); CGAL::IO::set_mode(is, CGAL::IO::BINARY); return read_PLY(is, points, polygons, comments, np); } else { std::ifstream is(fname); CGAL::IO::set_mode(is, CGAL::IO::ASCII); return read_PLY(is, points, polygons, comments, np); } } template bool read_PLY(const std::string& fname, PointRange& points, PolygonRange& polygons, const CGAL_NP_CLASS& np = parameters::default_values() #ifndef DOXYGEN_RUNNING , std::enable_if_t::value>* = nullptr #endif ) { std::string unused_comments; return read_PLY(fname, points, polygons, unused_comments, np); } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////////////////////////// // Write // @todo comments /*! * \ingroup PkgStreamSupportIoFuncsPLY * * \brief writes the content of `points` and `polygons` in `out`, using the \ref IOStreamPLY. * * \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`. * * \tparam PointRange a model of the concept `RandomAccessContainer` whose value type is the point type * \tparam PolygonRange a model of the concept `SequenceContainer` * whose `value_type` is itself a model of the concept `SequenceContainer` * whose `value_type` is an unsigned integer type convertible to `std::size_t` * \tparam NamedParameters a sequence of \ref bgl_namedparameters "Named Parameters" * * \param out the output stream * \param points points of the soup of polygons * \param polygons a range of polygons. Each element in it describes a polygon * using the indices of the points in `points`. * \param np optional \ref bgl_namedparameters "Named Parameters" described below * * \cgalNamedParamsBegin * \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{the precision of the stream `os`} * \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.} * \cgalParamNEnd * \cgalNamedParamsEnd * * \return `true` if the writing was successful, `false` otherwise. */ template bool write_PLY(std::ostream& out, const PointRange& points, const PolygonRange& polygons, const CGAL_NP_CLASS& np = parameters::default_values() #ifndef DOXYGEN_RUNNING , std::enable_if_t::value>* = nullptr #endif ) { typedef typename boost::range_value::type Point_3; typedef typename boost::range_value::type Polygon_3; if(!out.good()) return false; set_stream_precision_from_NP(out, np); // Write header out << "ply" << std::endl << ((get_mode(out) == BINARY) ? "format binary_little_endian 1.0" : "format ascii 1.0") << std::endl << "comment Generated by the CGAL library" << std::endl << "element vertex " << points.size() << std::endl; internal::output_property_header(out, make_ply_point_writer(CGAL::Identity_property_map())); out << "element face " << polygons.size() << std::endl; internal::output_property_header(out, std::make_pair(CGAL::Identity_property_map(), PLY_property >("vertex_indices"))); out << "end_header" << std::endl; for(std::size_t i=0; i())); for(std::size_t i=0; i(), PLY_property >("vertex_indices"))); return out.good(); } /*! * \ingroup PkgStreamSupportIoFuncsPLY * * \brief writes the content of `points` and `polygons` in the file `fname`, using the \ref IOStreamPLY. * * \tparam PointRange a model of the concept `RandomAccessContainer` whose value type is the point type * \tparam PolygonRange a model of the concept `SequenceContainer` * whose `value_type` is itself a model of the concept `SequenceContainer` * whose `value_type` is an unsigned integer type convertible to `std::size_t` * \tparam NamedParameters a sequence of \ref bgl_namedparameters "Named Parameters" * * \param fname the path to the output file * \param points points of the soup of polygons * \param polygons a range of polygons. Each element in it describes a polygon * using the indices of the points in `points`. * \param np optional \ref bgl_namedparameters "Named Parameters" described below * * \cgalNamedParamsBegin * \cgalParamNBegin{use_binary_mode} * \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)} * \cgalParamType{Boolean} * \cgalParamDefault{`true`} * \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`} * \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.} * \cgalParamNEnd * \cgalNamedParamsEnd * * \return `true` if the writing was successful, `false` otherwise. */ template bool write_PLY(const std::string& fname, const PointRange& points, const PolygonRange& polygons, const CGAL_NP_CLASS& np = parameters::default_values() #ifndef DOXYGEN_RUNNING , std::enable_if_t::value>* = nullptr #endif ) { const bool binary = CGAL::parameters::choose_parameter(CGAL::parameters::get_parameter(np, internal_np::use_binary_mode), true); if(binary) { std::ofstream os(fname, std::ios::binary); CGAL::IO::set_mode(os, CGAL::IO::BINARY); return write_PLY(os, points, polygons, np); } else { std::ofstream os(fname); CGAL::IO::set_mode(os, CGAL::IO::ASCII); return write_PLY(os, points, polygons, np); } } } // namespace IO } // namespace CGAL #endif // CGAL_IO_PLY_H