IO: write_PLY() for Epeck

[afabri]

Summary of Changes

As reported in #7868 the function CGAL::IO::write_PLY() used in binary mode does not correctly write the coordinates if the points are from a kernel with exact constructions.
This PR applies `to_double()" to the coordinates.

After a discussion with @MaelRL we decided that the user is in charge to pass a vertex_point_map as named parameter that does the conversion. This is straightforward as we offer the Cartesian_converter_property_map.

As the problem is the same for the vertex normals we add a named parameter vertex_normal_map.

Todo

• Fix the generic function write_polygon_mesh(). Currently it is fixed for Surface_mesh

Release Management

• Affected package(s): Stream_support
• Issue(s) solved (if any): fix invalid result from CGAL::IO::write_PLY() #7868 and fix Writing a binary PLY file does not work with an EPECK mesh #7327
• License and copyright ownership: unchanged

[sloriot]

BGL tests failing in CGAL-6.0-Ic-112

[sloriot]

Successfully tested in CGAL-6.0-Ic-116

[lrineau]

@afabri There is still an undone TODO in the top message of this other PR. Do you want this PR merged as it is?

[afabri]

@afabri There is still an undone TODO in the top message of this other PR. Do you want this PR merged as it is?

No, I still want to fix the generic code.

[sloriot]

@afabri any chance you can fix that today (if inclusion in 5.6.1 is needed)?

[sloriot]

@afabri, this PR was marked tested 2 month ago and is still waiting for a TODO. Maybe you want to open an issue instead and integrate the PR.

[lrineau]

Ping @afabri

[afabri]

Ping @afabri

Will be treated somewhere in the future.

[github-actions]

This pull-request was previously marked with the label Tested, but has been modified with new commits. That label has been removed.

[afabri]

/build:v0

[github-actions]

The documentation is built. It will be available, after a few minutes, here: https://cgal.github.io/7874/v0/Manual/index.html

[MaelRL]

Note that 6096748#diff-7a13764173912394a4970cfc328f818e714d19b9ac486d1ded974155934cdc8fR59 goes in the other direction from the current conclusion (users must give a VPM that converts to double), so this will need more discussions.

[lrineau]

/build:v0

[github-actions]

There was an error while building the doc:

/home/runner/work/cgal/cgal/Stream_support/include/CGAL/IO/PLY.h:356: warning: The following parameter of CGAL::IO::read_PLY(const std::string &fname, PointRange &points, PolygonRange &polygons, std::string &comments, const NamedParameters &np=parameters::default_values()) is not documented:
  parameter 'comments'
/home/runner/work/cgal/cgal/Stream_support/include/CGAL/IO/PLY.h:277: warning: The following parameter of CGAL::IO::read_PLY(std::istream &is, PointRange &points, PolygonRange &polygons, std::string &comments, const NamedParameters &np=parameters::default_values()) is not documented:
  parameter 'comments'
/home/runner/work/cgal/cgal/Surface_mesh/include/CGAL/Surface_mesh/IO/PLY.h:782: warning: argument 'verbose' of command @param is not found in the argument list of CGAL::IO::read_PLY(std::istream &is, Surface_mesh< P > &sm, std::string &comments, const NamedParameters &np=parameters::default_values())
/home/runner/work/cgal/cgal/Surface_mesh/include/CGAL/Surface_mesh/IO/PLY.h:782: warning: The following parameter of CGAL::IO::read_PLY(std::istream &is, Surface_mesh< P > &sm, std::string &comments, const NamedParameters &np=parameters::default_values()) is not documented:
  parameter 'np'

https://github.com/CGAL/cgal/actions/runs/11464164997