cgal_buffer_multi_point

Geometric functions > cgal_buffer_multi_point

syntax

  • cgal_buffer_multi_point(multipoint_data_item, size, nr_angles)

description

cgal_buffer_multi_point(multipoint_data_item, size, nr_angles) results in a multi polygon data item with buffer circles around each coordinate in the multipoint_data_item. The resulting data item has the same domain unit as the multipoint_data_item.

The size argument indicates the buffer circle size (radius) in the units of the coordinate system.

The nr_angles argument indicates how many angles are used to make the buffer circles. More angles result in smoother circles but also in more data.

The cgal_ prefix of the function name indicates that the implementation of the operator uses CGAL, which provides exact predicates and exact constructions for maximum numerical precision.

applies to

arc or polygon geometry as first argument

The first argument has multipoint composition type. An arc or polygon attribute as first argument is deprecated: it works, with a deprecation warning, and GeoDMS 21 will refuse it. Make multipoint geometry with points2multi_point.

conditions

  1. size must be a positive value.
  2. nr_angles must be at least 3.

since version

14.0

example

attribute<dpoint> points         (district, multipoint) := points2multi_point(point, Sequence_rel, ordinal);
attribute<dpoint> buffer_circles (district, polygon)    := cgal_buffer_multi_point(points, 10.0, 16b);

More examples of buffer functions can be found here: Buffer processing example

see also