geo/algorithm/
buffer.rs

1//! Create a new geometry whose boundary is offset the specified distance from the input.
2
3use crate::algorithm::orient::{Direction, Orient};
4use crate::bool_ops::i_overlay_integration::{
5    BoolOpsCoord,
6    convert::{line_string_to_shape_path, multi_polygon_from_shapes, ring_to_shape_path},
7};
8use crate::bool_ops::{BoolOpsNum, BooleanOps, unary_union};
9use crate::dimensions::{Dimensions, HasDimensions};
10use crate::geometry::{
11    Coord, Geometry, GeometryCollection, Line, LineString, MultiLineString, MultiPoint,
12    MultiPolygon, Point, Polygon, Rect, Triangle,
13};
14use i_overlay::mesh::{
15    outline::offset::OutlineOffset,
16    stroke::offset::StrokeOffset,
17    style::{OutlineStyle, StrokeStyle},
18};
19// Re-export these i_overlay style types. Alternatively, we could implement our own version,
20// but they'd be a 1:1 mapping, so it seems overly ceremonious.
21use geo_types::coord;
22pub use i_overlay::mesh::style::{LineCap, LineJoin};
23use num_traits::Float;
24
25/// Create a new geometry whose boundary is offset the specified distance from the input.
26///
27/// The buffer operation creates polygons which represent all points within a specified distance from the input geometry.
28/// For example, buffering a point creates a circle, buffering a line creates a "pill" shape, and buffering a polygon
29/// creates a larger polygon (or a smaller one if a negative distance is requested).
30///
31/// # Examples
32///
33/// Basic buffering with default style:
34/// ```
35/// use geo::{Point, Buffer, MultiPolygon};
36///
37/// let point = Point::new(0.0, 0.0);
38/// // Creates an approximated circle with radius 2.0
39/// let buffered: MultiPolygon = point.buffer(2.0);
40/// ```
41///
42/// Default buffering rounds the point where geometries meet and where lines end.
43/// Use a custom style for more control:
44/// ```
45/// use geo::{wkt, MultiPolygon, Buffer};
46/// use geo::algorithm::buffer::{BufferStyle, LineCap, LineJoin};
47///
48/// let lines = wkt! {            
49///     MULTILINESTRING(
50///         (0. 0.,2. 0.,1. 2.),
51///         (0. -1.,2. 1.,3. 3.)
52///     )
53/// };
54/// let style = BufferStyle::new(0.5)
55///     .line_cap(LineCap::Square)
56///     .line_join(LineJoin::Miter(1.0));
57/// let buffered: MultiPolygon = lines.buffer_with_style(style);
58/// ```
59pub trait Buffer {
60    type Scalar: BoolOpsNum + 'static;
61
62    /// Create a new geometry whose boundary is offset the specified distance from the input.
63    ///
64    /// By default, buffering uses rounded joins and end caps.
65    /// See [`buffer_with_style`](Self::buffer_with_style) for more control.
66    ///
67    /// # Arguments
68    ///
69    /// * `distance` - The buffer distance. Positive values create an outward buffer,
70    ///   negative values create an inward buffer (for polygons).
71    ///
72    /// # Returns
73    ///
74    /// A `MultiPolygon` representing the buffered geometry.
75    ///
76    /// # Examples
77    ///
78    /// ```
79    /// # use approx::assert_relative_eq;
80    /// use geo::{Point, Buffer, MultiPolygon};
81    ///
82    /// let point = Point::new(5.0, 5.0);
83    /// let circle: MultiPolygon = point.buffer(3.0);
84    ///
85    /// use geo::algorithm::Area;
86    /// // Creates an approximately circular polygon centered at (5, 5) with radius 30
87    /// assert_relative_eq!(circle.unsigned_area(), std::f64::consts::PI * 3.0f64.powi(2), epsilon = 2e-1);
88    /// ```
89    fn buffer(&self, distance: Self::Scalar) -> MultiPolygon<Self::Scalar> {
90        let default_style = BufferStyle::new(distance);
91        self.buffer_with_style(default_style)
92    }
93
94    /// Create a new geometry whose boundary is offset the specified distance from the input using
95    /// the specific styling options where lines intersect (line joins) and end (end caps).
96    /// For default (rounded) styling, see [`buffer`](Self::buffer).
97    ///
98    /// This method allows control over the buffer appearance through the `BufferStyle` parameter.
99    ///
100    /// # Arguments
101    ///
102    /// * `style` - A `BufferStyle` that specifies the distance, line caps, and line joins.
103    ///
104    /// # Returns
105    ///
106    /// A `MultiPolygon` representing the buffered geometry.
107    ///
108    /// # Examples
109    ///
110    /// ```
111    /// use geo::{wkt, Buffer};
112    /// use geo::algorithm::buffer::{BufferStyle, LineCap, LineJoin};
113    ///
114    /// let line_string = wkt! { LINESTRING (0. 0.,2. 0.,1. 2.) };
115    /// let style = BufferStyle::new(1.5)
116    ///     .line_cap(LineCap::Square)
117    ///     .line_join(LineJoin::Bevel);
118    /// let buffered = line_string.buffer_with_style(style);
119    /// ```
120    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar>;
121}
122
123/// Configuration for buffer styling operations.
124///
125/// `BufferStyle` controls how the buffer operation creates the resulting polygon,
126/// including the distance from the original geometry and how line segments are joined or capped.
127///
128/// # Examples
129///
130/// ```
131/// use geo::algorithm::buffer::{BufferStyle, LineCap, LineJoin};
132///
133/// // Default round style
134/// let round_style = BufferStyle::new(2.0);
135///
136/// // Square caps with mitered joins
137/// let square_style = BufferStyle::new(2.0)
138///     .line_cap(LineCap::Square)
139///     .line_join(LineJoin::Miter(1.0));
140/// ```
141pub struct BufferStyle<T: BoolOpsNum> {
142    distance: T,
143    line_cap: LineCap<BoolOpsCoord<T>, T>,
144    line_join: LineJoin<T>,
145}
146
147impl<T: BoolOpsNum> Clone for BufferStyle<T> {
148    fn clone(&self) -> Self {
149        Self {
150            distance: self.distance,
151            line_cap: self.clone_line_cap(),
152            line_join: self.clone_line_join(),
153        }
154    }
155}
156
157impl<T: BoolOpsNum> BufferStyle<T> {
158    /// Creates a new `BufferStyle` with the specified distance and default round caps/joins.
159    ///
160    /// # Arguments
161    ///
162    /// * `distance` - The buffer distance from the original geometry
163    ///
164    /// # Examples
165    ///
166    /// ```
167    /// use geo::algorithm::buffer::BufferStyle;
168    ///
169    /// let style = BufferStyle::new(1.5);
170    /// ```
171    pub fn new(distance: T) -> Self {
172        BufferStyle {
173            distance,
174            line_cap: LineCap::Round(Self::default_join_angle()),
175            line_join: LineJoin::Round(Self::default_join_angle()),
176        }
177    }
178
179    /// Sets how two edges of a geometry should meet at vertices.
180    ///
181    /// Note: This has no effect on point geometries.
182    ///
183    /// # Arguments
184    ///
185    /// * `line_join` - The join style: `Round`, `Miter`, or `Bevel`
186    ///
187    /// # Examples
188    ///
189    /// ```
190    /// use geo::algorithm::buffer::{Buffer, BufferStyle, LineJoin};
191    ///
192    /// let style = BufferStyle::new(2.0).line_join(LineJoin::Miter(1.0));
193    /// ```
194    pub fn line_join(mut self, line_join: LineJoin<T>) -> Self {
195        self.line_join = line_join;
196        self
197    }
198
199    /// Sets how the ends of linear geometries and points should be capped.
200    ///
201    /// This only affects `Line`, `LineString`, `MultiLineString`, `Point`, and `MultiPoint` geometries.
202    /// Two dimensional geometries, like Polygons, ignore setting.
203    ///
204    /// # Arguments
205    ///
206    /// * `line_cap` - The cap style: `Round`, `Square`, `Butt`, or `Custom`
207    ///
208    /// # Examples
209    ///
210    /// ```
211    /// use geo::algorithm::buffer::{Buffer, BufferStyle, LineCap};
212    ///
213    /// let style = BufferStyle::new(2.0).line_cap(LineCap::Square);
214    /// ```
215    pub fn line_cap(mut self, line_cap: LineCap<BoolOpsCoord<T>, T>) -> Self {
216        self.line_cap = line_cap;
217        self
218    }
219
220    // Annoyingly, i_overlay doesn't implement Clone for LineJoin
221    fn clone_line_join(&self) -> LineJoin<T> {
222        match self.line_join {
223            LineJoin::Bevel => LineJoin::Bevel,
224            LineJoin::Miter(angle) => LineJoin::Miter(angle),
225            LineJoin::Round(angle) => LineJoin::Round(angle),
226        }
227    }
228
229    // Annoyingly, i_overlay doesn't implement Clone for LineCap
230    fn clone_line_cap(&self) -> LineCap<BoolOpsCoord<T>, T> {
231        match &self.line_cap {
232            LineCap::Butt => LineCap::Butt,
233            LineCap::Round(angle) => LineCap::Round(*angle),
234            LineCap::Square => LineCap::Square,
235            LineCap::Custom(points) => LineCap::Custom(points.clone()),
236        }
237    }
238
239    fn default_join_angle() -> T {
240        // This is arbitrary, but the results seem to match pretty closely with JTS's own default.
241        T::from_f32(0.20).expect("valid float constant")
242    }
243
244    // Used by i_overlay for buffering (Multi)Polygons
245    fn outline_style(&self) -> OutlineStyle<T> {
246        OutlineStyle::new(self.distance).line_join(self.clone_line_join())
247    }
248
249    // Used by i_overlay for buffering (Multi)LineStrings
250    fn stroke_style(&self) -> StrokeStyle<BoolOpsCoord<T>, T> {
251        // "Buffer width" is like radius, whereas "stroke width" is more like diameter, so double the
252        // "stroke width" to reconcile semantics with "buffer width".
253        let two = T::one() + T::one();
254        StrokeStyle::new(self.distance * two)
255            .line_join(self.clone_line_join())
256            .end_cap(self.clone_line_cap())
257            .start_cap(self.clone_line_cap())
258    }
259}
260
261impl<F: BoolOpsNum + 'static> Buffer for Geometry<F> {
262    type Scalar = F;
263    crate::geometry_delegate_impl! {
264        fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar>;
265    }
266}
267
268impl<F: BoolOpsNum + 'static> Buffer for Point<F> {
269    type Scalar = F;
270    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
271        if style.distance <= F::zero() {
272            return MultiPolygon::new(vec![]);
273        }
274
275        match style.line_cap {
276            // Without length, i_overlay can't sensible reason about orientation of template points.
277            LineCap::Custom(_) => MultiPolygon::new(vec![]),
278            LineCap::Butt => MultiPolygon::new(vec![]),
279            LineCap::Square => {
280                let a = coord!(x: self.x() - style.distance, y: self.y() - style.distance);
281                let b = coord!(x: self.x() + style.distance, y: self.y() + style.distance);
282                MultiPolygon(vec![Rect::new(a, b).to_polygon()])
283            }
284            LineCap::Round(angle) => {
285                // approximate a circle
286                let num_segments = (2.0 * std::f64::consts::PI / angle.to_f64()).ceil() as usize;
287                let center = self.0;
288                let radius = style.distance;
289
290                let mut coords = Vec::with_capacity(num_segments + 1);
291                for i in 0..num_segments {
292                    let angle = F::from_f64(
293                        2.0 * std::f64::consts::PI / num_segments as f64 * i as f64
294                            + std::f64::consts::PI,
295                    )
296                    .expect("valid float constant");
297                    let x = center.x + radius * Float::cos(angle);
298                    let y = center.y + radius * Float::sin(angle);
299                    coords.push(Coord { x, y });
300                }
301                // Close the ring
302                coords.push(coords[0]);
303
304                let polygon = Polygon::new(LineString::new(coords), vec![]);
305                MultiPolygon::new(vec![polygon])
306            }
307        }
308    }
309}
310
311impl<F: BoolOpsNum + 'static> Buffer for MultiPoint<F> {
312    type Scalar = F;
313    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
314        if style.distance <= F::zero() {
315            return MultiPolygon::new(vec![]);
316        }
317
318        if self.0.is_empty() {
319            return MultiPolygon::new(vec![]);
320        }
321
322        // Buffer each point individually
323        let buffered_points: Vec<MultiPolygon<F>> = self
324            .0
325            .iter()
326            .map(|point| point.buffer_with_style(style.clone()))
327            .collect();
328
329        // Union all the buffered circles to merge overlapping ones
330        unary_union(buffered_points.iter())
331    }
332}
333
334impl<F: BoolOpsNum + 'static> Buffer for LineString<F> {
335    type Scalar = F;
336    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
337        if style.distance <= F::zero() {
338            return MultiPolygon::new(vec![]);
339        }
340        match self.dimensions() {
341            Dimensions::Empty => MultiPolygon::new(vec![]),
342            // Treat degenerate line like a point, similar to JTS, whereas i_overlay returns an
343            // empty result
344            Dimensions::ZeroDimensional => Point(self.0[0]).buffer_with_style(style),
345            Dimensions::OneDimensional => {
346                let subject = line_string_to_shape_path(self);
347                let shapes = subject.stroke(style.stroke_style(), false);
348                multi_polygon_from_shapes(shapes)
349            }
350            Dimensions::TwoDimensional => unreachable!("linestring can't be 2 dimensional"),
351        }
352    }
353}
354
355impl<F: BoolOpsNum + 'static> Buffer for MultiLineString<F> {
356    type Scalar = F;
357    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
358        if style.distance <= F::zero() {
359            return MultiPolygon::new(vec![]);
360        }
361
362        let mut degenerate_points = Vec::new();
363        let mut subject = Vec::with_capacity(self.0.len());
364        for line_string in self {
365            match line_string.dimensions() {
366                Dimensions::Empty => {}
367                // Treat degenerate line like a point, similar to JTS, whereas i_overlay returns an
368                // empty result
369                Dimensions::ZeroDimensional => degenerate_points.push(Point(line_string[0])),
370                Dimensions::OneDimensional => subject.push(line_string_to_shape_path(line_string)),
371                Dimensions::TwoDimensional => unreachable!("linestring can't be 2 dimensional"),
372            }
373        }
374
375        let stroked_lines = if subject.is_empty() {
376            MultiPolygon::new(vec![])
377        } else {
378            let shapes = subject.stroke(style.stroke_style(), false);
379            multi_polygon_from_shapes(shapes)
380        };
381
382        if degenerate_points.is_empty() {
383            stroked_lines
384        } else {
385            MultiPoint(degenerate_points)
386                .buffer_with_style(style)
387                .union(&stroked_lines)
388        }
389    }
390}
391
392impl<F: BoolOpsNum + 'static> Buffer for Polygon<F> {
393    type Scalar = F;
394    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
395        let rewound = self.orient(Direction::Default);
396        let subject = rewound.rings().map(ring_to_shape_path).collect::<Vec<_>>();
397        let shapes = subject.outline(&style.outline_style());
398        multi_polygon_from_shapes(shapes)
399    }
400}
401
402impl<F: BoolOpsNum + 'static> Buffer for MultiPolygon<F> {
403    type Scalar = F;
404    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
405        let rewound = self.orient(Direction::Default);
406        let subject = rewound.rings().map(ring_to_shape_path).collect::<Vec<_>>();
407        let shapes = subject.outline(&style.outline_style());
408        multi_polygon_from_shapes(shapes)
409    }
410}
411
412impl<F: BoolOpsNum + 'static> Buffer for Line<F> {
413    type Scalar = F;
414    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
415        if style.distance <= F::zero() {
416            return MultiPolygon::new(vec![]);
417        }
418        match self.dimensions() {
419            Dimensions::TwoDimensional => unreachable!("line can't be 2-D"),
420            Dimensions::Empty => unreachable!("line can't be empty"),
421            // Treat degenerate line like a point, similar to JTS, whereas i_overlay returns an
422            // empty result
423            Dimensions::ZeroDimensional => Point(self.start).buffer_with_style(style),
424            Dimensions::OneDimensional => {
425                let subject: Vec<_> = [self.start, self.end]
426                    .iter()
427                    .map(|c| BoolOpsCoord(*c))
428                    .collect();
429                let shapes = subject.stroke(style.stroke_style(), false);
430                multi_polygon_from_shapes(shapes)
431            }
432        }
433    }
434}
435
436impl<F: BoolOpsNum + 'static> Buffer for Rect<F> {
437    type Scalar = F;
438    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
439        self.to_polygon().buffer_with_style(style)
440    }
441}
442
443impl<F: BoolOpsNum + 'static> Buffer for Triangle<F> {
444    type Scalar = F;
445    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
446        self.to_polygon().buffer_with_style(style)
447    }
448}
449
450impl<F: BoolOpsNum + 'static> Buffer for GeometryCollection<F> {
451    type Scalar = F;
452    fn buffer_with_style(&self, style: BufferStyle<Self::Scalar>) -> MultiPolygon<Self::Scalar> {
453        let buffered_geometries: Vec<MultiPolygon<F>> = self
454            .iter()
455            .map(|geom| geom.buffer_with_style(style.clone()))
456            .collect();
457
458        // Union all the buffered results to merge overlapping geometries
459        unary_union(buffered_geometries.iter())
460    }
461}
462
463#[cfg(test)]
464mod tests {
465    // There are a lot of numeric constants in the test fixtures which equate to named constants (e.g. SQRT_2),
466    // but it doesn't make sense to name them given that the fixture data is intentionally copy/pasted from an external tool
467    #![allow(clippy::approx_constant)]
468
469    use super::*;
470    use crate::algorithm::Relate;
471    use crate::{coord, wkt};
472    use jts_test_runner::{assert_jts_tests_succeed, check_buffer_test_case};
473
474    #[test]
475    fn buffer_polygon() {
476        let polygon = wkt! { POLYGON((2.0 2.0,2.0 6.0,4.0 6.0,2.0 2.0)) };
477        let actual = polygon.buffer(2.0);
478        let expected_output_from_jts = wkt! {
479            POLYGON ((3.7888543819998315 1.1055728090000843, 3.5861818680937785 0.7817934980757446, 3.325649726266169 0.502451068161567, 3.016761464967688 0.2777351761831863, 2.6707844932058173 0.115842850589523, 2.3003391159142073 0.0226794859072865, 1.9189381793348277 0.0016434299078536, 1.540494158905278 0.0535020210645394, 1.1788116697530158 0.1763635981188107, 0.8470839116422293 0.3657465027708164, 0.5574114167008071 0.6147425584625696, 0.3203606547097724 0.9142690619895666, 0.1445785968413555 1.253400095967856, 0.0364772975189096 1.6197650767731142, 0. 2., 0. 6., 0.0384294391935391 6.390180644032257, 0.1522409349774265 6.76536686473018, 0.3370607753949093 7.111140466039204, 0.5857864376269051 7.414213562373095, 0.8888595339607961 7.662939224605091, 1.2346331352698205 7.847759065022574, 1.6098193559677436 7.961570560806461, 2. 8., 4. 8., 4.404087761316691 7.958752940305148, 4.791508090620394 7.836713081154064, 5.14628103846132 7.638914207902305, 5.453773263881755 7.373514942482458, 5.70130161670408 7.051462224238267, 5.8786562801832645 6.686039780864038, 5.9785218959276225 6.292320213695469, 5.996779300923084 5.88654329722259, 5.932675430895927 5.485446136141952, 5.7888543819998315 5.105572809000084, 3.7888543819998315 1.1055728090000843))
480        };
481        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
482    }
483
484    #[test]
485    fn buffer_line_string() {
486        let line_string = wkt! { LINESTRING(0.0 0.0, 10.0 0.0, 10.0 10.0) };
487        let actual = line_string.buffer(2.0);
488        let expected_output_from_jts = wkt! {
489            POLYGON ((8. 2., 8. 10., 8.03842943919354 10.390180644032258, 8.152240934977426 10.76536686473018, 8.33706077539491 11.111140466039204, 8.585786437626904 11.414213562373096, 8.888859533960796 11.66293922460509, 9.23463313526982 11.847759065022574, 9.609819355967744 11.96157056080646, 10. 12., 10.390180644032256 11.96157056080646, 10.76536686473018 11.847759065022574, 11.111140466039204 11.66293922460509, 11.414213562373096 11.414213562373096, 11.66293922460509 11.111140466039204, 11.847759065022574 10.76536686473018, 11.96157056080646 10.390180644032258, 12. 10., 12. 0., 11.96157056080646 -0.3901806440322565, 11.847759065022574 -0.7653668647301796, 11.66293922460509 -1.1111404660392044, 11.414213562373096 -1.414213562373095, 11.111140466039204 -1.6629392246050905, 10.76536686473018 -1.8477590650225735, 10.390180644032256 -1.9615705608064609, 10. -2., 0. -2., -0.3901806440322573 -1.9615705608064609, -0.7653668647301807 -1.847759065022573, -1.1111404660392044 -1.6629392246050905, -1.4142135623730954 -1.414213562373095, -1.662939224605091 -1.111140466039204, -1.8477590650225735 -0.7653668647301792, -1.9615705608064609 -0.3901806440322567, -2. 0., -1.9615705608064609 0.3901806440322572, -1.8477590650225735 0.7653668647301798, -1.6629392246050907 1.1111404660392044, -1.414213562373095 1.4142135623730951, -1.111140466039204 1.6629392246050907, -0.7653668647301795 1.8477590650225735, -0.3901806440322568 1.9615705608064609, 0. 2., 8. 2.))
490        };
491        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
492    }
493
494    #[test]
495    fn buffer_linestring_closed() {
496        let line_string = wkt! { LINESTRING(0.0 0.0, 5.0 0.0, 5.0 5.0, 0.0 5.0, 0.0 0.0) };
497        let actual = line_string.buffer(2.0);
498        let expected_output_from_jts = wkt! {
499            POLYGON (
500                (-2. 0., -2. 5., -1.9615705608064609 5.390180644032257, -1.8477590650225735 5.76536686473018, -1.6629392246050907 6.111140466039204, -1.414213562373095 6.414213562373095, -1.111140466039204 6.662939224605091, -0.7653668647301795 6.847759065022574, -0.3901806440322564 6.961570560806461, 0. 7., 5. 7., 5.390180644032257 6.961570560806461, 5.765366864730179 6.847759065022574, 6.111140466039204 6.662939224605091, 6.414213562373095 6.414213562373095, 6.662939224605091 6.111140466039204, 6.847759065022574 5.765366864730179, 6.961570560806461 5.390180644032257, 7. 5., 7. 0., 6.961570560806461 -0.3901806440322565, 6.847759065022574 -0.7653668647301796, 6.662939224605091 -1.1111404660392044, 6.414213562373095 -1.414213562373095, 6.111140466039204 -1.6629392246050905, 5.765366864730179 -1.8477590650225735, 5.390180644032257 -1.9615705608064609, 5. -2., 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0.),
501                (2. 2., 3. 2., 3. 3., 2. 3., 2. 2.)
502            )
503        };
504        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
505    }
506
507    #[test]
508    fn buffer_linestring_empty() {
509        let line_string = wkt! { LINESTRING EMPTY };
510        let actual = line_string.buffer(2.0);
511        assert_eq!(actual.0.len(), 0);
512        let expected_output_from_jts = wkt! { POLYGON EMPTY };
513        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
514    }
515
516    #[test]
517    fn buffer_linestring_length_1() {
518        let line_string = wkt! { LINESTRING(2.0 3.0) };
519
520        let actual = line_string.buffer(2.0);
521
522        let point_buffer = Point::new(2.0, 3.0).buffer(2.0);
523        assert_eq!(&point_buffer, &actual);
524    }
525
526    #[test]
527    fn buffer_collapsed_linestring() {
528        let line_string = wkt! { LINESTRING(2.0 3.0,2.0 3.0) };
529
530        let actual = line_string.buffer(2.0);
531
532        let point_buffer = Point::new(2.0, 3.0).buffer(2.0);
533        assert_eq!(&point_buffer, &actual);
534    }
535
536    #[test]
537    fn buffer_custom_capped_line_string() {
538        let line_string = wkt! { LINESTRING(0.0 0.0, 10.0 0.0, 10.0 10.0) };
539        let arrow_cap = vec![
540            coord!(x: -1.0, y: -2.0).into(),
541            coord!(x:  3.0, y:  0.0).into(),
542            coord!(x: -1.0, y:  2.0).into(),
543        ];
544        let style = BufferStyle::new(2.0).line_cap(LineCap::Custom(arrow_cap));
545        let actual = line_string.buffer_with_style(style);
546        let expected_output = wkt! {
547            MULTIPOLYGON(((-6.0 0.0,2.0 -4.0,0.0 -2.0,10.0 -2.0,10.3901806473732 -1.9615705609321594,10.765366852283478 -1.8477590680122375,11.111140459775925 -1.6629392206668854,11.414213567972183 -1.4142135679721832,11.662939220666885 -1.1111404597759247,11.847759068012238 -0.7653668522834778,11.96157056093216 -0.39018064737319946,12.0 0.0,12.0 10.0,14.0 8.0,10.0 16.0,6.0 8.0,8.0 10.0,8.0 2.0,0.0 2.0,2.0 4.0,-6.0 0.0)))
548        };
549        check_buffer_test_case(&actual.into(), &expected_output.into()).unwrap();
550    }
551
552    #[test]
553    fn buffer_empty_multi_line_string() {
554        let multi_line_string = wkt! { MULTILINESTRING EMPTY };
555        let actual = multi_line_string.buffer(2.0);
556        let expected_output_from_jts = wkt! { POLYGON EMPTY };
557        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
558    }
559
560    #[test]
561    fn buffer_multi_line_string_stay_separate() {
562        let multi_line_string = wkt! { MULTILINESTRING ((0.0 0.0, 5.0 0.0), (10.0 0.0, 15.0 0.0)) };
563        let actual = multi_line_string.buffer(2.0);
564        let expected_output_from_jts = wkt! {
565            MULTIPOLYGON (
566                ((15. 2., 15.390180644032256 1.9615705608064609, 15.76536686473018 1.8477590650225735, 16.111140466039206 1.6629392246050905, 16.414213562373096 1.414213562373095, 16.66293922460509 1.1111404660392044, 16.847759065022572 0.7653668647301796, 16.96157056080646 0.3901806440322565, 17. 0., 16.96157056080646 -0.3901806440322565, 16.847759065022572 -0.7653668647301796, 16.66293922460509 -1.1111404660392041, 16.414213562373096 -1.414213562373095, 16.111140466039203 -1.6629392246050907, 15.76536686473018 -1.8477590650225735, 15.390180644032258 -1.9615705608064609, 15. -2., 10. -2., 9.609819355967742 -1.9615705608064609, 9.234633135269819 -1.847759065022573, 8.888859533960796 -1.6629392246050905, 8.585786437626904 -1.414213562373095, 8.337060775394908 -1.111140466039204, 8.152240934977426 -0.7653668647301792, 8.03842943919354 -0.3901806440322567, 8. 0., 8.03842943919354 0.3901806440322572, 8.152240934977426 0.7653668647301798, 8.33706077539491 1.1111404660392044, 8.585786437626904 1.4142135623730951, 8.888859533960796 1.6629392246050907, 9.23463313526982 1.8477590650225735, 9.609819355967744 1.9615705608064609, 10. 2., 15. 2.)),
567                ((5. 2., 5.390180644032257 1.9615705608064609, 5.765366864730179 1.8477590650225735, 6.111140466039204 1.6629392246050905, 6.414213562373095 1.414213562373095, 6.662939224605091 1.1111404660392044, 6.847759065022574 0.7653668647301796, 6.961570560806461 0.3901806440322565, 7. 0., 6.961570560806461 -0.3901806440322565, 6.847759065022574 -0.7653668647301796, 6.662939224605091 -1.1111404660392041, 6.414213562373095 -1.414213562373095, 6.111140466039204 -1.6629392246050907, 5.765366864730179 -1.8477590650225735, 5.390180644032257 -1.9615705608064609, 5. -2., 0. -2., -0.3901806440322573 -1.9615705608064609, -0.7653668647301807 -1.847759065022573, -1.1111404660392044 -1.6629392246050905, -1.4142135623730954 -1.414213562373095, -1.662939224605091 -1.111140466039204, -1.8477590650225735 -0.7653668647301792, -1.9615705608064609 -0.3901806440322567, -2. 0., -1.9615705608064609 0.3901806440322572, -1.8477590650225735 0.7653668647301798, -1.6629392246050907 1.1111404660392044, -1.414213562373095 1.4142135623730951, -1.111140466039204 1.6629392246050907, -0.7653668647301795 1.8477590650225735, -0.3901806440322568 1.9615705608064609, 0. 2., 5. 2.))
568            )
569        };
570        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
571    }
572
573    #[test]
574    fn buffer_multi_line_string_with_zero_length_line_strings() {
575        let multi_line_string =
576            wkt! { MULTILINESTRING ((0.0 0.0, 0.0 0.0), (10.0 0.0, 10.0 15.0)) };
577        let actual = multi_line_string.buffer(2.0);
578        let expected_output_from_jts = wkt! {
579            MULTIPOLYGON (
580                ((8. 15., 8.03842943919354 15.390180644032258, 8.152240934977426 15.76536686473018, 8.33706077539491 16.111140466039203, 8.585786437626904 16.414213562373096, 8.888859533960796 16.66293922460509, 9.23463313526982 16.847759065022572, 9.609819355967744 16.96157056080646, 10. 17., 10.390180644032256 16.96157056080646, 10.76536686473018 16.847759065022572, 11.111140466039204 16.66293922460509, 11.414213562373096 16.414213562373096, 11.66293922460509 16.111140466039203, 11.847759065022574 15.76536686473018, 11.96157056080646 15.390180644032258, 12. 15., 12. 0., 11.96157056080646 -0.3901806440322565, 11.847759065022574 -0.7653668647301796, 11.66293922460509 -1.1111404660392044, 11.414213562373096 -1.414213562373095, 11.111140466039204 -1.6629392246050905, 10.76536686473018 -1.8477590650225735, 10.390180644032256 -1.9615705608064609, 10. -2., 9.609819355967744 -1.9615705608064609, 9.23463313526982 -1.8477590650225735, 8.888859533960796 -1.6629392246050907, 8.585786437626904 -1.4142135623730951, 8.33706077539491 -1.1111404660392044, 8.152240934977426 -0.7653668647301798, 8.03842943919354 -0.3901806440322572, 8. 0., 8. 15.)),
581                ((2. 0., 1.9615705608064609 -0.3901806440322565, 1.8477590650225735 -0.7653668647301796, 1.6629392246050905 -1.1111404660392044, 1.4142135623730951 -1.414213562373095, 1.1111404660392046 -1.6629392246050905, 0.7653668647301797 -1.8477590650225735, 0.3901806440322567 -1.9615705608064609, 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -1.9615705608064609 0.3901806440322567, -1.8477590650225735 0.7653668647301792, -1.662939224605091 1.111140466039204, -1.4142135623730954 1.414213562373095, -1.1111404660392044 1.6629392246050905, -0.7653668647301807 1.847759065022573, -0.3901806440322573 1.9615705608064609, 0. 2., 0.3901806440322566 1.9615705608064609, 0.76536686473018 1.8477590650225733, 1.1111404660392037 1.662939224605091, 1.4142135623730947 1.4142135623730954, 1.6629392246050905 1.1111404660392044, 1.847759065022573 0.7653668647301808, 1.9615705608064606 0.3901806440322574, 2. 0.))
582            )
583        };
584        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
585    }
586
587    #[test]
588    fn buffer_multi_line_string_elements_merge() {
589        let multi_line_string = wkt! { MULTILINESTRING ((0.0 0.0, 5.0 0.0), (10.0 0.0, 15.0 0.0)) };
590        let actual = multi_line_string.buffer(3.0);
591        let expected_output_from_jts = wkt! {
592           POLYGON ((5. 3., 5.585270966048385 2.9423558412096913, 6.14805029709527 2.77163859753386, 6.666710699058807 2.4944088369076356, 7.121320343559643 2.1213203435596424, 7.494408836907636 1.6667106990588065, 7.5 1.65625036864414, 7.5055911630923635 1.6667106990588065, 7.878679656440358 2.121320343559643, 8.333289300941194 2.494408836907636, 8.851949702904731 2.77163859753386, 9.414729033951614 2.9423558412096913, 10. 3., 15. 3., 15.585270966048386 2.9423558412096913, 16.14805029709527 2.77163859753386, 16.666710699058807 2.4944088369076356, 17.121320343559642 2.1213203435596424, 17.494408836907635 1.6667106990588065, 17.771638597533858 1.1480502970952693, 17.94235584120969 0.5852709660483848, 18. 0., 17.94235584120969 -0.5852709660483848, 17.771638597533858 -1.1480502970952693, 17.494408836907635 -1.666710699058806, 17.121320343559642 -2.1213203435596424, 16.666710699058807 -2.494408836907636, 16.14805029709527 -2.77163859753386, 15.585270966048386 -2.9423558412096913, 15. -3., 10. -3., 9.414729033951614 -2.9423558412096913, 8.85194970290473 -2.7716385975338595, 8.333289300941193 -2.4944088369076356, 7.878679656440357 -2.1213203435596424, 7.5055911630923635 -1.6667106990588059, 7.5 -1.6562503686441403, 7.4944088369076365 -1.666710699058806, 7.121320343559643 -2.1213203435596424, 6.666710699058806 -2.494408836907636, 6.14805029709527 -2.77163859753386, 5.585270966048386 -2.9423558412096913, 5. -3., 0. -3., -0.585270966048386 -2.9423558412096913, -1.148050297095271 -2.7716385975338595, -1.6667106990588065 -2.4944088369076356, -2.121320343559643 -2.1213203435596424, -2.4944088369076365 -1.6667106990588059, -2.77163859753386 -1.1480502970952688, -2.9423558412096913 -0.585270966048385, -3. 0., -2.9423558412096913 0.5852709660483858, -2.77163859753386 1.1480502970952697, -2.494408836907636 1.6667106990588065, -2.1213203435596424 2.121320343559643, -1.6667106990588059 2.494408836907636, -1.1480502970952693 2.77163859753386, -0.5852709660483852 2.9423558412096913, 0. 3., 5. 3.))
593        };
594        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
595    }
596
597    #[test]
598    fn buffer_multi_polygon_elements_stay_separate() {
599        let multi_polygon = wkt! { MULTIPOLYGON (
600            ((20. 40., 50. 40., 50. 30., 20. 30., 20. 40.)),
601            ((0. 40., 10. 40., 10. 20., 0. 20., 0. 40.))
602        )};
603        let actual = multi_polygon.buffer(2.);
604        let expected_output_from_jts = wkt! {
605           MULTIPOLYGON (
606               ((18. 40., 18.03842943919354 40.390180644032256, 18.152240934977428 40.76536686473018, 18.33706077539491 41.1111404660392, 18.585786437626904 41.41421356237309, 18.888859533960797 41.66293922460509, 19.23463313526982 41.84775906502257, 19.609819355967744 41.961570560806464, 20. 42., 50. 42., 50.390180644032256 41.961570560806464, 50.76536686473018 41.84775906502257, 51.1111404660392 41.66293922460509, 51.41421356237309 41.41421356237309, 51.66293922460509 41.1111404660392, 51.84775906502257 40.76536686473018, 51.961570560806464 40.390180644032256, 52. 40., 52. 30., 51.961570560806464 29.609819355967744, 51.84775906502257 29.23463313526982, 51.66293922460509 28.888859533960797, 51.41421356237309 28.585786437626904, 51.1111404660392 28.33706077539491, 50.76536686473018 28.152240934977428, 50.390180644032256 28.03842943919354, 50. 28., 20. 28., 19.609819355967744 28.03842943919354, 19.23463313526982 28.152240934977428, 18.888859533960797 28.33706077539491, 18.585786437626904 28.585786437626904, 18.33706077539491 28.888859533960797, 18.152240934977428 29.23463313526982, 18.03842943919354 29.609819355967744, 18. 30., 18. 40.)),
607               ((-2. 40., -1.9615705608064609 40.390180644032256, -1.8477590650225735 40.76536686473018, -1.6629392246050907 41.1111404660392, -1.414213562373095 41.41421356237309, -1.111140466039204 41.66293922460509, -0.7653668647301795 41.84775906502257, -0.3901806440322564 41.961570560806464, 0. 42., 10. 42., 10.390180644032256 41.961570560806464, 10.76536686473018 41.84775906502257, 11.111140466039204 41.66293922460509, 11.414213562373096 41.41421356237309, 11.66293922460509 41.1111404660392, 11.847759065022574 40.76536686473018, 11.96157056080646 40.390180644032256, 12. 40., 12. 20., 11.96157056080646 19.609819355967744, 11.847759065022574 19.23463313526982, 11.66293922460509 18.888859533960797, 11.414213562373096 18.585786437626904, 11.111140466039204 18.33706077539491, 10.76536686473018 18.152240934977428, 10.390180644032256 18.03842943919354, 10. 18., 0. 18., -0.3901806440322573 18.03842943919354, -0.7653668647301807 18.152240934977428, -1.1111404660392044 18.33706077539491, -1.4142135623730954 18.585786437626904, -1.662939224605091 18.888859533960797, -1.8477590650225735 19.23463313526982, -1.9615705608064609 19.609819355967744, -2. 20., -2. 40.))
608           )
609        };
610        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
611    }
612
613    #[test]
614    fn buffer_multi_polygon_elements_merge() {
615        let multi_polygon = wkt! { MULTIPOLYGON (
616            ((20. 40., 50. 40., 50. 30., 20. 30., 20. 40.)),
617            ((0. 40., 10. 40., 10. 20., 0. 20., 0. 40.))
618        )};
619        let actual = multi_polygon.buffer(5.);
620        let expected_output_from_jts = wkt! {
621            POLYGON ((-5. 40., -4.903926402016152 40.97545161008064, -4.619397662556434 41.91341716182545, -4.157348061512726 42.777851165098014, -3.5355339059327373 43.53553390593274, -2.77785116509801 44.15734806151273, -1.9134171618254485 44.61939766255644, -0.975451610080641 44.903926402016154, 0. 45., 10. 45., 10.975451610080642 44.903926402016154, 11.91341716182545 44.61939766255644, 12.777851165098012 44.15734806151273, 13.535533905932738 43.53553390593274, 14.157348061512726 42.777851165098014, 14.619397662556434 41.91341716182545, 14.903926402016152 40.97545161008064, 15. 40., 15.096073597983848 40.97545161008064, 15.380602337443566 41.91341716182545, 15.842651938487274 42.777851165098014, 16.464466094067262 43.53553390593274, 17.22214883490199 44.15734806151273, 18.08658283817455 44.61939766255644, 19.02454838991936 44.903926402016154, 20. 45., 50. 45., 50.97545161008064 44.903926402016154, 51.91341716182545 44.61939766255644, 52.777851165098014 44.15734806151273, 53.53553390593274 43.53553390593274, 54.15734806151273 42.777851165098014, 54.61939766255644 41.91341716182545, 54.903926402016154 40.97545161008064, 55. 40., 55. 30., 54.903926402016154 29.02454838991936, 54.61939766255644 28.08658283817455, 54.15734806151273 27.22214883490199, 53.53553390593274 26.464466094067262, 52.777851165098014 25.842651938487272, 51.91341716182545 25.380602337443566, 50.97545161008064 25.096073597983846, 50. 25., 20. 25., 19.024548389919357 25.096073597983846, 18.08658283817455 25.38060233744357, 17.22214883490199 25.842651938487272, 16.464466094067262 26.464466094067262, 15.842651938487272 27.22214883490199, 15.380602337443566 28.08658283817455, 15.096073597983848 29.024548389919357, 15. 30., 15. 20., 14.903926402016152 19.02454838991936, 14.619397662556434 18.08658283817455, 14.157348061512726 17.22214883490199, 13.535533905932738 16.464466094067262, 12.777851165098012 15.842651938487274, 11.91341716182545 15.380602337443566, 10.975451610080642 15.096073597983848, 10. 15., 0. 15., -0.9754516100806433 15.096073597983848, -1.9134171618254516 15.380602337443568, -2.777851165098011 15.842651938487274, -3.5355339059327386 16.464466094067262, -4.157348061512727 17.22214883490199, -4.619397662556434 18.08658283817455, -4.903926402016152 19.024548389919357, -5. 20., -5. 40.))
622        };
623        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
624    }
625
626    #[test]
627    fn buffer_rect() {
628        let rect = Rect::new((0.0, 0.0), (10.0, 5.0));
629        let actual = rect.buffer(2.0);
630        // First converted to Poly to use as JTS test runner input
631        // println!("{:?}", rect.to_polygon());
632        let expected_output_from_jts = wkt! {
633            POLYGON ((10. -2., 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -2. 5., -1.9615705608064609 5.390180644032257, -1.8477590650225735 5.76536686473018, -1.6629392246050907 6.111140466039204, -1.414213562373095 6.414213562373095, -1.111140466039204 6.662939224605091, -0.7653668647301795 6.847759065022574, -0.3901806440322564 6.961570560806461, 0. 7., 10. 7., 10.390180644032256 6.961570560806461, 10.76536686473018 6.847759065022574, 11.111140466039204 6.662939224605091, 11.414213562373096 6.414213562373095, 11.66293922460509 6.111140466039204, 11.847759065022574 5.765366864730179, 11.96157056080646 5.390180644032257, 12. 5., 12. 0., 11.96157056080646 -0.3901806440322565, 11.847759065022574 -0.7653668647301796, 11.66293922460509 -1.1111404660392044, 11.414213562373096 -1.414213562373095, 11.111140466039204 -1.6629392246050905, 10.76536686473018 -1.8477590650225735, 10.390180644032256 -1.9615705608064609, 10. -2.))
634        };
635        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
636    }
637
638    #[test]
639    fn buffer_triangle() {
640        let triangle: Triangle = Triangle::new(
641            coord!(x: 0.0, y: 0.0),
642            coord!(x: 5.0, y: 0.0),
643            coord!(x: 2.5, y: 4.0),
644        );
645        // First converted to Poly to use as JTS test runner input
646        // println!("{:?}", triangle.to_polygon());
647        let actual = triangle.buffer(2.0);
648        let expected_output_from_jts = wkt! {
649            POLYGON ((-1.695996608010176 1.05999788000636, 0.804003391989824 5.05999788000636, 1.0517599500179284 5.379347946541381, 1.358665447443173 5.642362761127975, 1.7121852670464854 5.838300287369118, 2.0978809720606573 5.959158055739536, 2.5 6., 2.902119027939343 5.959158055739536, 3.287814732953515 5.838300287369118, 3.641334552556827 5.642362761127975, 3.948240049982071 5.379347946541382, 4.1959966080101765 5.05999788000636, 6.6959966080101765 1.05999788000636, 6.868234748006532 0.713932018010797, 6.9706814490978655 0.3411958765599848, 6.999509621199342 -0.0442862815244382, 6.953642333473384 -0.4281140418868183, 6.834793045115888 -0.7959487933242723, 6.647401595850507 -1.1340493736999298, 6.398468347327018 -1.4297853970174819, 6.097292671385227 -1.6721090853542637, 5.755125554449403 -1.851967979479527, 5.384749295672485 -1.9626431105729658, 5. -2., 0. -2., -0.3847492956724843 -1.9626431105729658, -0.7551255544494029 -1.851967979479527, -1.0972926713852271 -1.6721090853542635, -1.3984683473270176 -1.4297853970174825, -1.6474015958505068 -1.13404937369993, -1.8347930451158885 -0.7959487933242725, -1.9536423334733846 -0.428114041886819, -1.9995096211993426 -0.044286281524438, -1.9706814490978655 0.3411958765599851, -1.8682347480065324 0.7139320180107968, -1.695996608010176 1.05999788000636))
650        };
651        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
652    }
653
654    #[test]
655    fn buffer_collapsed_line() {
656        let line = Line::new(coord!(x: 2.0, y: 3.0), coord!(x: 2.0, y: 3.0));
657        let actual = line.buffer(2.0);
658
659        let point_buffer = Point::new(2.0, 3.0).buffer(2.0);
660        assert_eq!(&point_buffer, &actual);
661    }
662
663    #[test]
664    fn buffer_line() {
665        let line = Line::new(coord!(x: 0.0, y: 0.0), coord!(x: 5.0, y: 0.0));
666        let actual = line.buffer(2.0);
667        let expected_output_from_jts = wkt! {
668            POLYGON ((5. 2., 5.390180644032257 1.9615705608064609, 5.765366864730179 1.8477590650225735, 6.111140466039204 1.6629392246050905, 6.414213562373095 1.414213562373095, 6.662939224605091 1.1111404660392044, 6.847759065022574 0.7653668647301796, 6.961570560806461 0.3901806440322565, 7. 0., 6.961570560806461 -0.3901806440322565, 6.847759065022574 -0.7653668647301796, 6.662939224605091 -1.1111404660392041, 6.414213562373095 -1.414213562373095, 6.111140466039204 -1.6629392246050907, 5.765366864730179 -1.8477590650225735, 5.390180644032257 -1.9615705608064609, 5. -2., 0. -2., -0.3901806440322573 -1.9615705608064609, -0.7653668647301807 -1.847759065022573, -1.1111404660392044 -1.6629392246050905, -1.4142135623730954 -1.414213562373095, -1.662939224605091 -1.111140466039204, -1.8477590650225735 -0.7653668647301792, -1.9615705608064609 -0.3901806440322567, -2. 0., -1.9615705608064609 0.3901806440322572, -1.8477590650225735 0.7653668647301798, -1.6629392246050907 1.1111404660392044, -1.414213562373095 1.4142135623730951, -1.111140466039204 1.6629392246050907, -0.7653668647301795 1.8477590650225735, -0.3901806440322568 1.9615705608064609, 0. 2., 5. 2.))
669        };
670        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
671    }
672
673    #[test]
674    fn buffer_point() {
675        let point = Point::new(2.0, 3.0);
676        let actual = point.buffer(2.0);
677        let expected_output_from_jts = wkt! {
678            POLYGON ((4. 3., 3.961570560806461 2.6098193559677436, 3.8477590650225735 2.2346331352698203, 3.6629392246050907 1.8888595339607956, 3.414213562373095 1.585786437626905, 3.1111404660392044 1.3370607753949095, 2.7653668647301797 1.1522409349774265, 2.390180644032257 1.0384294391935391, 2. 1., 1.6098193559677436 1.0384294391935391, 1.2346331352698205 1.1522409349774265, 0.8888595339607961 1.3370607753949093, 0.5857864376269051 1.5857864376269049, 0.3370607753949093 1.8888595339607956, 0.1522409349774265 2.2346331352698203, 0.0384294391935391 2.6098193559677427, 0. 3., 0.0384294391935391 3.390180644032257, 0.1522409349774265 3.7653668647301792, 0.3370607753949091 4.111140466039204, 0.5857864376269046 4.414213562373095, 0.8888595339607956 4.662939224605091, 1.2346331352698194 4.847759065022573, 1.6098193559677427 4.961570560806461, 2. 5., 2.390180644032257 4.961570560806461, 2.76536686473018 4.847759065022573, 3.1111404660392035 4.662939224605091, 3.414213562373095 4.414213562373096, 3.6629392246050907 4.111140466039204, 3.847759065022573 3.765366864730181, 3.961570560806461 3.3901806440322573, 4. 3.))
679        };
680        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
681    }
682
683    #[test]
684    fn buffer_square_capped_point() {
685        let point = Point::new(0.0, 0.0);
686        let actual = point.buffer_with_style(BufferStyle::new(2.0).line_cap(LineCap::Square));
687        let expected_output_from_jts = wkt! {
688            POLYGON((2. 2.,2. -2.,-2. -2.,-2. 2.,2. 2.))
689        };
690        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
691    }
692
693    #[test]
694    fn buffer_butt_capped_point() {
695        let point = Point::new(0.0, 0.0);
696        let actual = point.buffer_with_style(BufferStyle::new(2.0).line_cap(LineCap::Butt));
697        let expected_output_from_jts = wkt! {
698            POLYGON EMPTY
699        };
700        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
701    }
702
703    #[test]
704    fn buffer_custom_capped_point() {
705        let point = Point::new(0.0, 0.0);
706        let arrow_cap = vec![
707            coord!(x: -1.0, y: -2.0).into(),
708            coord!(x:  3.0, y:  0.0).into(),
709            coord!(x: -1.0, y:  2.0).into(),
710        ];
711        let style = BufferStyle::new(2.0).line_cap(LineCap::Custom(arrow_cap));
712        let actual = point.buffer_with_style(style);
713        let expected_output = wkt! {
714            POLYGON EMPTY
715        };
716        check_buffer_test_case(&actual.into(), &expected_output.into()).unwrap();
717    }
718
719    #[test]
720    fn buffer_multi_point_separate() {
721        let multi_point = wkt! { MULTIPOINT (0.0 0.0, 10.0 0.0) };
722        let actual = multi_point.buffer(2.0);
723        // Should result in two separate circles
724        assert_eq!(actual.0.len(), 2);
725
726        let expected_output_from_jts = wkt! {
727            MULTIPOLYGON (
728                ((12. 0., 11.96157056080646 -0.3901806440322565, 11.847759065022574 -0.7653668647301796, 11.66293922460509 -1.1111404660392044, 11.414213562373096 -1.414213562373095, 11.111140466039204 -1.6629392246050905, 10.76536686473018 -1.8477590650225735, 10.390180644032256 -1.9615705608064609, 10. -2., 9.609819355967744 -1.9615705608064609, 9.23463313526982 -1.8477590650225735, 8.888859533960796 -1.6629392246050907, 8.585786437626904 -1.4142135623730951, 8.33706077539491 -1.1111404660392044, 8.152240934977426 -0.7653668647301798, 8.03842943919354 -0.3901806440322572, 8. 0., 8.03842943919354 0.3901806440322567, 8.152240934977426 0.7653668647301792, 8.337060775394908 1.111140466039204, 8.585786437626904 1.414213562373095, 8.888859533960796 1.6629392246050905, 9.234633135269819 1.847759065022573, 9.609819355967742 1.9615705608064609, 10. 2., 10.390180644032256 1.9615705608064609, 10.76536686473018 1.8477590650225733, 11.111140466039204 1.662939224605091, 11.414213562373094 1.4142135623730954, 11.66293922460509 1.1111404660392044, 11.847759065022572 0.7653668647301808, 11.96157056080646 0.3901806440322574, 12. 0.)),
729                ((2. 0., 1.9615705608064609 -0.3901806440322565, 1.8477590650225735 -0.7653668647301796, 1.6629392246050905 -1.1111404660392044, 1.4142135623730951 -1.414213562373095, 1.1111404660392046 -1.6629392246050905, 0.7653668647301797 -1.8477590650225735, 0.3901806440322567 -1.9615705608064609, 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -1.9615705608064609 0.3901806440322567, -1.8477590650225735 0.7653668647301792, -1.662939224605091 1.111140466039204, -1.4142135623730954 1.414213562373095, -1.1111404660392044 1.6629392246050905, -0.7653668647301807 1.847759065022573, -0.3901806440322573 1.9615705608064609, 0. 2., 0.3901806440322566 1.9615705608064609, 0.76536686473018 1.8477590650225733, 1.1111404660392037 1.662939224605091, 1.4142135623730947 1.4142135623730954, 1.6629392246050905 1.1111404660392044, 1.847759065022573 0.7653668647301808, 1.9615705608064606 0.3901806440322574, 2. 0.))
730            )
731        };
732        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
733    }
734
735    #[test]
736    fn buffer_multi_point_overlapping() {
737        let multi_point = wkt! { MULTIPOINT (0.0 0.0, 2.0 0.0) };
738        let actual = multi_point.buffer(2.0);
739        // Should result in one merged polygon since circles overlap
740        assert_eq!(actual.0.len(), 1);
741        let expected_output_from_jts = wkt! {
742            POLYGON ((1. 1.722345041357806, 1.2346331352698194 1.847759065022573, 1.6098193559677427 1.9615705608064609, 2. 2., 2.390180644032257 1.9615705608064609, 2.76536686473018 1.8477590650225733, 3.1111404660392035 1.662939224605091, 3.414213562373095 1.4142135623730954, 3.6629392246050907 1.1111404660392044, 3.847759065022573 0.7653668647301808, 3.961570560806461 0.3901806440322574, 4. 0., 3.961570560806461 -0.3901806440322565, 3.8477590650225735 -0.7653668647301796, 3.6629392246050907 -1.1111404660392044, 3.414213562373095 -1.414213562373095, 3.1111404660392044 -1.6629392246050905, 2.7653668647301797 -1.8477590650225735, 2.390180644032257 -1.9615705608064609, 2. -2., 1.6098193559677436 -1.9615705608064609, 1.2346331352698205 -1.8477590650225735, 1.0000000000000002 -1.722345041357806, 0.7653668647301797 -1.8477590650225735, 0.3901806440322567 -1.9615705608064609, 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -1.9615705608064609 0.3901806440322567, -1.8477590650225735 0.7653668647301792, -1.662939224605091 1.111140466039204, -1.4142135623730954 1.414213562373095, -1.1111404660392044 1.6629392246050905, -0.7653668647301807 1.847759065022573, -0.3901806440322573 1.9615705608064609, 0. 2., 0.3901806440322566 1.9615705608064609, 0.76536686473018 1.8477590650225733, 1. 1.722345041357806))
743        };
744        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
745    }
746
747    #[test]
748    fn buffer_multi_point_empty() {
749        let multi_point = wkt! { MULTIPOINT EMPTY };
750        let actual = multi_point.buffer(2.0);
751        assert_eq!(actual.0.len(), 0);
752    }
753
754    #[test]
755    fn buffer_multi_point_zero_distance() {
756        let multi_point = wkt! { MULTIPOINT (0.0 0.0,5.0 0.0) };
757        let actual = multi_point.buffer(0.0);
758        assert_eq!(actual.0.len(), 0);
759    }
760
761    #[test]
762    fn buffer_multi_point_single_point() {
763        let multi_point = wkt! { MULTIPOINT (2.0 3.0) };
764        let actual = multi_point.buffer(2.0);
765
766        let single_point_buffer = Point::new(2.0, 3.0).buffer(2.);
767        check_buffer_test_case(&actual.into(), &single_point_buffer.into()).unwrap();
768    }
769
770    #[test]
771    fn buffer_geometry_collection_separate_geometries() {
772        let geometry_collection = wkt! {
773            GEOMETRYCOLLECTION(
774                POINT(0.0 0.0),
775                LINESTRING(10.0 0.0, 15.0 0.0)
776            )
777        };
778        let actual = geometry_collection.buffer(2.0);
779        // Should result in two separate buffered geometries
780        assert_eq!(actual.0.len(), 2);
781        let expected_output_from_jts = wkt! {
782            MULTIPOLYGON (
783                ((15. 2., 15.390180644032256 1.9615705608064609, 15.76536686473018 1.8477590650225735, 16.111140466039206 1.6629392246050905, 16.414213562373096 1.414213562373095, 16.66293922460509 1.1111404660392044, 16.847759065022572 0.7653668647301796, 16.96157056080646 0.3901806440322565, 17. 0., 16.96157056080646 -0.3901806440322565, 16.847759065022572 -0.7653668647301796, 16.66293922460509 -1.1111404660392041, 16.414213562373096 -1.414213562373095, 16.111140466039203 -1.6629392246050907, 15.76536686473018 -1.8477590650225735, 15.390180644032258 -1.9615705608064609, 15. -2., 10. -2., 9.609819355967742 -1.9615705608064609, 9.234633135269819 -1.847759065022573, 8.888859533960796 -1.6629392246050905, 8.585786437626904 -1.414213562373095, 8.337060775394908 -1.111140466039204, 8.152240934977426 -0.7653668647301792, 8.03842943919354 -0.3901806440322567, 8. 0., 8.03842943919354 0.3901806440322572, 8.152240934977426 0.7653668647301798, 8.33706077539491 1.1111404660392044, 8.585786437626904 1.4142135623730951, 8.888859533960796 1.6629392246050907, 9.23463313526982 1.8477590650225735, 9.609819355967744 1.9615705608064609, 10. 2., 15. 2.)),
784                ((2. 0., 1.9615705608064609 -0.3901806440322565, 1.8477590650225735 -0.7653668647301796, 1.6629392246050905 -1.1111404660392044, 1.4142135623730951 -1.414213562373095, 1.1111404660392046 -1.6629392246050905, 0.7653668647301797 -1.8477590650225735, 0.3901806440322567 -1.9615705608064609, 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -1.9615705608064609 0.3901806440322567, -1.8477590650225735 0.7653668647301792, -1.662939224605091 1.111140466039204, -1.4142135623730954 1.414213562373095, -1.1111404660392044 1.6629392246050905, -0.7653668647301807 1.847759065022573, -0.3901806440322573 1.9615705608064609, 0. 2., 0.3901806440322566 1.9615705608064609, 0.76536686473018 1.8477590650225733, 1.1111404660392037 1.662939224605091, 1.4142135623730947 1.4142135623730954, 1.6629392246050905 1.1111404660392044, 1.847759065022573 0.7653668647301808, 1.9615705608064606 0.3901806440322574, 2. 0.))
785            )
786        };
787        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
788    }
789
790    #[test]
791    fn buffer_geometry_collection_overlapping_geometries() {
792        let geometry_collection = wkt! {
793            GEOMETRYCOLLECTION(
794                POINT(0.0 0.0),
795                LINESTRING(1.0 0.0, 3.0 0.0)
796            )
797        };
798        let actual = geometry_collection.buffer(2.0);
799        assert_eq!(actual.0.len(), 1);
800
801        let expected_output_from_jts = wkt! {
802            POLYGON ((0.4999999999999998 -1.9282572233777517, 0.3901806440322567 -1.9615705608064609, 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -1.9615705608064609 0.3901806440322567, -1.8477590650225735 0.7653668647301792, -1.662939224605091 1.111140466039204, -1.4142135623730954 1.414213562373095, -1.1111404660392044 1.6629392246050905, -0.7653668647301807 1.847759065022573, -0.3901806440322573 1.9615705608064609, 0. 2., 0.3901806440322566 1.9615705608064609, 0.4999999999999999 1.9282572233777517, 0.6098193559677432 1.9615705608064609, 1. 2., 3. 2., 3.390180644032257 1.9615705608064609, 3.7653668647301797 1.8477590650225735, 4.111140466039204 1.6629392246050905, 4.414213562373095 1.414213562373095, 4.662939224605091 1.1111404660392044, 4.847759065022574 0.7653668647301796, 4.961570560806461 0.3901806440322565, 5. 0., 4.961570560806461 -0.3901806440322565, 4.847759065022574 -0.7653668647301796, 4.662939224605091 -1.1111404660392041, 4.414213562373095 -1.414213562373095, 4.111140466039204 -1.6629392246050907, 3.7653668647301797 -1.8477590650225735, 3.390180644032257 -1.9615705608064609, 3. -2., 1. -2., 0.6098193559677427 -1.9615705608064609, 0.4999999999999998 -1.9282572233777517))
803        };
804
805        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap()
806    }
807
808    #[test]
809    fn buffer_geometry_collection_empty() {
810        let geometry_collection = wkt! { GEOMETRYCOLLECTION EMPTY };
811        let actual = geometry_collection.buffer(2.0);
812        assert_eq!(actual.0.len(), 0);
813    }
814
815    #[test]
816    fn buffer_geometry_collection_zero_distance() {
817        let point = Point::new(0.0, 0.0);
818        let polygon = wkt! { POLYGON((1.0 1.0, 2.0 1.0, 2.0 2.0, 1.0 2.0, 1.0 1.0)) };
819        let geometry_collection =
820            GeometryCollection::new_from(vec![point.into(), polygon.clone().into()]);
821        let actual = geometry_collection.buffer(0.0);
822
823        // Point coalesces to nothing, but the original Polygon should be maintained.
824        assert_eq!(actual.0.len(), 1);
825        assert!(actual.0[0].relate(&polygon).is_equal_topo());
826    }
827
828    #[test]
829    fn buffer_geometry_collection_mixed_types() {
830        let geometry_collection = wkt! {
831            GEOMETRYCOLLECTION(
832                POINT(0.0 0.0),
833                POLYGON((10.0 10.0, 12.0 10.0, 12.0 12.0, 10.0 12.0, 10.0 10.0)),
834                LINESTRING(20.0 0.0, 25.0 0.0)
835            )
836        };
837        let actual = geometry_collection.buffer(2.0);
838
839        // Should result in three separate buffered polygons since they don't overlap
840        assert_eq!(actual.0.len(), 3);
841
842        let expected_output_from_jts = wkt! {
843            MULTIPOLYGON (
844                ((25. 2., 25.390180644032256 1.9615705608064609, 25.76536686473018 1.8477590650225735, 26.111140466039206 1.6629392246050905, 26.414213562373096 1.414213562373095, 26.66293922460509 1.1111404660392044, 26.847759065022572 0.7653668647301796, 26.96157056080646 0.3901806440322565, 27. 0., 26.96157056080646 -0.3901806440322565, 26.847759065022572 -0.7653668647301796, 26.66293922460509 -1.1111404660392041, 26.414213562373096 -1.414213562373095, 26.111140466039203 -1.6629392246050907, 25.76536686473018 -1.8477590650225735, 25.390180644032256 -1.9615705608064609, 25. -2., 20. -2., 19.609819355967744 -1.9615705608064609, 19.23463313526982 -1.847759065022573, 18.888859533960797 -1.6629392246050905, 18.585786437626904 -1.414213562373095, 18.33706077539491 -1.111140466039204, 18.152240934977428 -0.7653668647301792, 18.03842943919354 -0.3901806440322567, 18. 0., 18.03842943919354 0.3901806440322572, 18.152240934977428 0.7653668647301798, 18.33706077539491 1.1111404660392044, 18.585786437626904 1.4142135623730951, 18.888859533960797 1.6629392246050907, 19.23463313526982 1.8477590650225735, 19.609819355967744 1.9615705608064609, 20. 2., 25. 2.)),
845                ((8. 10., 8. 12., 8.03842943919354 12.390180644032258, 8.152240934977426 12.76536686473018, 8.33706077539491 13.111140466039204, 8.585786437626904 13.414213562373096, 8.888859533960796 13.66293922460509, 9.23463313526982 13.847759065022574, 9.609819355967744 13.96157056080646, 10. 14., 12. 14., 12.390180644032256 13.96157056080646, 12.76536686473018 13.847759065022574, 13.111140466039204 13.66293922460509, 13.414213562373096 13.414213562373096, 13.66293922460509 13.111140466039204, 13.847759065022574 12.76536686473018, 13.96157056080646 12.390180644032256, 14. 12., 14. 10., 13.96157056080646 9.609819355967744, 13.847759065022574 9.23463313526982, 13.66293922460509 8.888859533960796, 13.414213562373096 8.585786437626904, 13.111140466039204 8.33706077539491, 12.76536686473018 8.152240934977426, 12.390180644032256 8.03842943919354, 12. 8., 10. 8., 9.609819355967744 8.03842943919354, 9.23463313526982 8.152240934977426, 8.888859533960796 8.33706077539491, 8.585786437626904 8.585786437626904, 8.33706077539491 8.888859533960796, 8.152240934977426 9.23463313526982, 8.03842943919354 9.609819355967742, 8. 10.)),
846                ((2. 0., 1.9615705608064609 -0.3901806440322565, 1.8477590650225735 -0.7653668647301796, 1.6629392246050905 -1.1111404660392044, 1.4142135623730951 -1.414213562373095, 1.1111404660392046 -1.6629392246050905, 0.7653668647301797 -1.8477590650225735, 0.3901806440322567 -1.9615705608064609, 0. -2., -0.3901806440322564 -1.9615705608064609, -0.7653668647301795 -1.8477590650225735, -1.111140466039204 -1.6629392246050907, -1.414213562373095 -1.4142135623730951, -1.6629392246050907 -1.1111404660392044, -1.8477590650225735 -0.7653668647301798, -1.9615705608064609 -0.3901806440322572, -2. 0., -1.9615705608064609 0.3901806440322567, -1.8477590650225735 0.7653668647301792, -1.662939224605091 1.111140466039204, -1.4142135623730954 1.414213562373095, -1.1111404660392044 1.6629392246050905, -0.7653668647301807 1.847759065022573, -0.3901806440322573 1.9615705608064609, 0. 2., 0.3901806440322566 1.9615705608064609, 0.76536686473018 1.8477590650225733, 1.1111404660392037 1.662939224605091, 1.4142135623730947 1.4142135623730954, 1.6629392246050905 1.1111404660392044, 1.847759065022573 0.7653668647301808, 1.9615705608064606 0.3901806440322574, 2. 0.))
847            )
848        };
849        check_buffer_test_case(&actual.into(), &expected_output_from_jts.into()).unwrap();
850    }
851
852    fn init_logging() {
853        use std::sync::Once;
854        static LOG_SETUP: Once = Once::new();
855        LOG_SETUP.call_once(|| {
856            pretty_env_logger::init();
857        });
858    }
859
860    #[test]
861    fn jts_tests() {
862        init_logging();
863        assert_jts_tests_succeed("*Buffer*.xml");
864    }
865}