CGAL 6.2 - Geometric Object Generators: CGAL::Random_points_in_triangle_mesh_3< TriangleMesh, VertexPointMap, Creator > Struct Template Reference

CGAL 6.2 - Geometric Object Generators

Loading...
Searching...
No Matches
List of all members
CGAL::Random_points_in_triangle_mesh_3< TriangleMesh, VertexPointMap, Creator > Struct Template Reference

`#include <CGAL/point_generators_3.h>`

## Definition

template<class TriangleMesh, class VertexPointMap = typename boost::property_map<TriangleMesh, CGAL::vertex_point_t>::type, class Creator = Creator_uniform_3< typename Kernel_traits< typename boost::property_traits<VertexPointMap>::value_type >::Kernel::RT, typename boost::property_traits<VertexPointMap>::value_type >>
struct CGAL::Random_points_in_triangle_mesh_3< TriangleMesh, VertexPointMap, Creator >

The class `Random_points_in_triangle_mesh_3` is an input iterator creating points uniformly distributed inside the faces of a triangle mesh model of `FaceListGraph`.

The triangle mesh must be valid and unchanged while the generator is used.

Is model of
  `InputIterator`
  `PointGenerator`

See also
  `CGAL::Random_points_in_disc_2<Point_2, Creator>`
  `CGAL::Random_points_in_cube_3<Point_3, Creator>`
  `CGAL::Random_points_in_triangle_3<Point_3, Creator>`
  `CGAL::Random_points_on_sphere_3<Point_3, Creator>`
  `CGAL::Random_points_in_triangle_mesh_2<Point_2, Triangulation>`
  `CGAL::Random_points_in_tetrahedral_mesh_boundary_3<C3T3>`
  `CGAL::Random_points_in_tetrahedral_mesh_3<C3T3>`
  `CGAL::Random_points_in_triangles_2<Point_2>`
  `CGAL::Random_points_in_triangles_3<Point_3>`

Examples
  Generator/random_points_on_triangle_mesh_3.cpp.

## Types
typedef std::input_iterator_tag | iterator_category
typedef boost::property_traits< VertexPointMap >::value_type | Point_3
typedef Point_3 | value_type
typedef std::ptrdiff_t | difference_type
typedef const Point_3 * | pointer
typedef const Point_3 & | reference

## Functions
| Random_points_in_triangle_mesh_3 (const TriangleMesh &mesh, VertexPointMap vpm=get(vertex_point, mesh), Random &rnd=get_default_random())
| creates an input iterator `g` generating points of type `Point_3` uniformly distributed in the faces of `mesh`.
std::pair< Point_3, typename boost::graph_traits< TriangleMesh >::face_descriptor > | point_and_support () const
| returns the last point generated and a descriptor of the face used to generate that point.

## Constructor & Destructor Documentation

## ◆ Random_points_in_triangle_mesh_3()

template<class TriangleMesh , class VertexPointMap = typename boost::property_map<TriangleMesh, CGAL::vertex_point_t>::type, class Creator = Creator_uniform_3< typename Kernel_traits< typename boost::property_traits<VertexPointMap>::value_type >::Kernel::RT, typename boost::property_traits<VertexPointMap>::value_type >>

CGAL::Random_points_in_triangle_mesh_3< TriangleMesh, VertexPointMap, Creator >::Random_points_in_triangle_mesh_3 | ( | const TriangleMesh & | mesh,
|  | VertexPointMap | vpm = `get(vertex_point, mesh)`,
|  | Random & | rnd = `get_default_random()`
| ) |  |

creates an input iterator `g` generating points of type `Point_3` uniformly distributed in the faces of `mesh`.

Each triangle has a probability to be chosen to hold the point depending on its area.