pub struct PolyLine {
    pts: Vec<Pt2D>,
    length: Distance,
}

Fields

pts: Vec<Pt2D>length: Distance

Implementations

Doesn’t check for duplicates. Use at your own risk.

First dedupes adjacent points

Like make_polygons, but make sure the points actually form a ring.

Returns the quadrant where the overall angle of this polyline (pointing from the first to last point) is in. Output between 0 and 3.

Glue together two polylines in order. The last point of self must be the same as the first point of other. This method handles removing unnecessary intermediate points if the extension happens to be at the same angle as the last line segment of self.

Like extend, but panics on failure.

Extends self by a single point. If the new point is close enough to the last, dedupes. Doesn’t clean up any intermediate points.

Like extend, but handles the last and first point not matching by inserting that point. Doesn’t clean up any intermediate points.

One or both args might be empty.

Returns the excess distance left over from the end

No excess leftover distance allowed.

Perpendicularly shifts the polyline to the right if positive or left if negative.

self represents some center, with total_width. Logically this shifts left by total_width / 2, then right by width_from_left_side, but without exasperating sharp bends.

This produces a Polygon with a valid Ring. It may crash if this polyline was made with unchecked_new

Just produces a Tessellation

This does the equivalent of make_polygons, returning the (start left, start right, end left, end right). Fails rarely.

Don’t draw the dashes too close to the ends.

Fail if the length is too short.

If the length is too short, just give up and make the thick line

Also return the angle of the line where the hit was found

Panics if the pt is not on the polyline. Returns None if the point is the first point (meaning the slice is empty).

Returns None if the point is the last point.

Same as get_slice_ending_at, but returns None if the point isn’t on the polyline.

Same as get_slice_starting_at, but returns None if the point isn’t on the polyline.

If the current line is at least this long, return it. Otherwise, extend the end of it, following the angle of the last line.

Produces a GeoJSON linestring, optionally mapping the world-space points back to GPS.

Returns the point on the polyline closest to the query.

Returns the angle from the start to end of this polyline.

Walk along the PolyLine, starting buffer_ends from the start and ending buffer_ends before the end. Advance in increments of step_size. Returns the point and angle at each step.

Walk along the PolyLine, from start_buffer to length - end_buffer. Advance in increments of step_size. Returns the point and angle at each step.

use geom::{PolyLine, Pt2D, Distance};

let polyline = PolyLine::must_new(vec![
    Pt2D::new(0.0, 0.0),
    Pt2D::new(0.0, 10.0),
    Pt2D::new(10.0, 20.0),
]);

assert_eq!(
    polyline.interpolate_points(Distance::meters(20.0)).points(),
    &vec![
        Pt2D::new(0.0, 0.0),
        Pt2D::new(0.0, 10.0),
        Pt2D::new(10.0, 20.0),
    ]
);

assert_eq!(
    polyline.interpolate_points(Distance::meters(10.0)).points(),
    &vec![
        Pt2D::new(0.0, 0.0),
        Pt2D::new(0.0, 10.0),
        Pt2D::new(5.0, 15.0),
        Pt2D::new(10.0, 20.0),
    ]
);

An arbitrary placeholder value, when Option types aren’t worthwhile

Extracts all linestrings from raw bytes representing a GeoJSON file, along with the string key/value properties. Uses PolyLine::unchecked_new, which doesn’t dedupe or handle any invalid cases.

Trait Implementations

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Deserialize this value from the given Serde deserializer. Read more
Formats the value using the given formatter. Read more
Converts to this type from the input type.
This method tests for self and other values to be equal, and is used by ==. Read more
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more
Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
Converts the given value to a String. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.