dungen_minion_geometry 0.3.2

Geometry support for dungen_minion.
Documentation
// External includes.

// Standard includes.

// Internal includes.
use super::{
    ContainsLocalPosition, HasHeight, HasSize, HasWidth, IntersectsLocalPosition, ShapeIterator,
};

/// Defines a 2D tile-based shape that does not have a [`Position`](struct.Position.html).
///
/// "shape" is used instead of "polygon" as shapes do not necessarily have regular vertices or edges, nor do they necessarily conform to any regular geometric definition.
pub trait Shape:
    ContainsLocalPosition + HasSize + HasHeight + HasWidth + IntersectsLocalPosition
{
    /// A helper method to allow structs implementing `Map` to be `Clone`'ed.
    ///
    /// [https://users.rust-lang.org/t/solved-is-it-possible-to-clone-a-boxed-trait-object/1714/5](https://users.rust-lang.org/t/solved-is-it-possible-to-clone-a-boxed-trait-object/1714/5)
    fn box_shape_clone(&self) -> Box<dyn Shape>;

    /// Returns true if this shape has no valid local positions.
    /// The default method iterates the shape and returns true on the first local position found.
    fn is_empty(&self) -> bool {
        !self.iter().any(|_| true)
    }

    /// Returns an iterator that iterates over all valid positions in a `Shape`.
    fn iter(&self) -> ShapeIterator;
}

impl Clone for Box<dyn Shape> {
    fn clone(&self) -> Box<dyn Shape> {
        self.box_shape_clone()
    }
}