it.unibo.alchemist.model.interfaces.geometry.GeometricShape.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of alchemist-interfaces Show documentation

Interfaces of core and model components of Alchemist

There is a newer version: 20.0.1

package it.unibo.alchemist.model.interfaces.geometry

import java.io.Serializable

/**
 * Models a generic shape.
 *
 * @param  Vector type for the space this shapes is defined in
 * @param  The transformations supported by the shapes in this space
 */
interface GeometricShape, A : GeometricTransformation> : Serializable {

    /**
     * The largest distance between any pair of vertices.
     */
    val diameter: Double

    /**
     * Half the [diameter].
     */
    val radius: Double get() = diameter / 2

    /**
     * The geometric center.
     */
    val centroid: S

    /**
     * A shape intersects another if any of its points is contained in the other one.
     *
     * @param other the other shape
     * @return true if the intersection is not empty
     */
    fun intersects(other: GeometricShape): Boolean

    /**
     * Check if the shape contains a vector.
     * @param vector the position vector
     * @return true if the vector is contained in the shape
     */
    fun contains(vector: S): Boolean

    /**
     * Transforms the shape.
     * @param transformation describes the transformations to apply to the shape
     * @return a copy of the shape transformed accordingly
     */
    fun transformed(transformation: A.() -> Unit): GeometricShape
}