Hot pixel snap rounding

Classes and functions to round segments or polygons using hot pixel SR method.

Classes
class	CGAL::Hot_pixel_snap_rounding_traits_2< K >
	The class Hot_pixel_snap_rounding_traits_2<Kernel> is a model of the HotPixelSnapRoundingTraits_2 concept. More...

Functions
template<class SegmentRange , class OutputContainer , class NamedParameters = parameters::Default_named_parameters>
void	CGAL::hot_pixel_snap_rounding_2 (const SegmentRange &segments, OutputContainer &out, const NamedParameters &np=parameters::default_values())
	subdivides and rounds a range of segments so that they are pairwise disjoint in their interiors.
template<class PolygonRange , class OutputContainer , class NamedParameters = parameters::Default_named_parameters>
void	CGAL::hot_pixel_snap_rounding_2 (const PolygonRange &polygons, OutputContainer &out, const NamedParameters &np=parameters::default_values())
	subdivides and rounds a range of polygons so that their boundary segments are pairwise disjoint in their interiors.

Function Documentation

hot_pixel_snap_rounding_2() [1/2]

template<class PolygonRange , class OutputContainer , class NamedParameters = parameters::Default_named_parameters>

void CGAL::hot_pixel_snap_rounding_2	(	const PolygonRange &	polygons,
		OutputContainer &	out,
		const NamedParameters &	np = parameters::default_values()
	)

#include <CGAL/hot_pixel_snap_rounding_2.h>

subdivides and rounds a range of polygons so that their boundary segments are pairwise disjoint in their interiors.

If the input polygons are disjoint, the output polygons remain non-overlapping, although they may share vertices or edges. Each output polygon is free of self-intersections but may present pinched sections.

Template Parameters

PolygonRange	model of a ConstRange whose iterator is model of ForwardIterator and whose value_type is model of CGAL::Polygon_2.
OutputContainer	model of the concept BackInsertionSequence whose value type is model of CGAL::Polygon_2.
NamedParameters	a sequence of Named Parameters

Parameters

polygons	the range of input polygons
out	the output container
np	an optional sequence of Named Parameters among the ones listed below

Optional Named Parameters

pixel_size The size of the pixel. The plane will be tiled with square pixels of that width such that the origin is the center of a pixel. Type: geom_traits::FT Default: 1
do_iterative_snap_rounding determines whether to apply Iterative Snap Rounding, see the user manual for more details. Type: Boolean Default: true
use_grid_coordinates If set to true, the output coordinates are expressed in the integer grid (pixel indices). Otherwise, they are given in the input coordinate system. Type: Boolean Default: true
geom_traits an instance of a geometric traits class Type: The traits class must respect the concept of HotPixelSnapRoundingTraits_2 Default: an instance of CGAL::Hot_pixel_snap_rounding_traits_2<Kernel> where Kernel is deduced from the point type of the polygons, using CGAL::Kernel_traits

Warning

a convex input polygon might no longer be convex after rounding.

hot_pixel_snap_rounding_2() [2/2]

template<class SegmentRange , class OutputContainer , class NamedParameters = parameters::Default_named_parameters>

void CGAL::hot_pixel_snap_rounding_2	(	const SegmentRange &	segments,
		OutputContainer &	out,
		const NamedParameters &	np = parameters::default_values()
	)

#include <CGAL/hot_pixel_snap_rounding_2.h>

subdivides and rounds a range of segments so that they are pairwise disjoint in their interiors.

By default, each polyline of the output corresponds to an input segment. Consequently, duplicate segments may appear in the output, for instance when multiple input segments collapse. When the parameter output_unique_segments is set to true, the polylines are decomposed into individual segments (represented as polylines with two points), and duplicates are removed.

Template Parameters

SegmentRange	model of a ConstRange whose iterator is model of ForwardIterator and whose value_type is geom_traits::Segment_2, where the type of geom_traits is detailed by np::geom_traits.
OutputContainer	model of the concept BackInsertionSequence whose value type is itself a model of the concepts DefaultConstructible and BackInsertionSequence whose value type is geom_traits::Point_2
NamedParameters	a sequence of Named Parameters

Parameters

segments	the input segment range
out	the output container
np	an optional sequence of Named Parameters among the ones listed below

Optional Named Parameters

pixel_size The size of the pixel. The plane will be tiled with square pixels of that width such that the origin is the center of a pixel. Type: geom_traits::FT Default: 1
do_iterative_snap_rounding determines whether to apply Iterative Snap Rounding, see the user manual for more details. Type: Boolean Default: true
use_grid_coordinates If set to true, the output coordinates are expressed in the integer grid (pixel indices). Otherwise, they are given in the input coordinate system. Type: Boolean Default: true
output_unique_segments If set to true, the output polylines are unique pairs of distinct points represented a segment. As a result, the total number of output polylines may differ from the number of input segments. Type: Boolean Default: false
geom_traits an instance of a geometric traits class Type: The traits class must be a model of HotPixelSnapRoundingTraits_2 Default: an instance of CGAL::Hot_pixel_snap_rounding_traits_2<Kernel> where Kernel is deduced from the segment type, using CGAL::Kernel_traits

Examples

Snap_rounding_2/iterative_snap_rounding.cpp, and Snap_rounding_2/snap_rounding_to_integer.cpp.