Class PointCreationTO

java.lang.Object
org.opentcs.access.to.CreationTO
org.opentcs.access.to.model.PointCreationTO
All Implemented Interfaces:
java.io.Serializable

public class PointCreationTO
extends CreationTO
implements java.io.Serializable
A transfer object describing a point in the plant model.
See Also:
Serialized Form
  • Constructor Details

    • PointCreationTO

      public PointCreationTO​(@Nonnull java.lang.String name)
      Creates a new instance.
      Parameters:
      name - The name of this point.
  • Method Details

    • withName

      public PointCreationTO withName​(@Nonnull java.lang.String name)
      Creates a copy of this object with the given name.
      Overrides:
      withName in class CreationTO
      Parameters:
      name - The new name.
      Returns:
      A copy of this object, differing in the given name.
    • getPosition

      @Nonnull public Triple getPosition()
      Returns the position of this point (in mm).
      Returns:
      The position of this point (in mm).
    • withPosition

      public PointCreationTO withPosition​(@Nonnull Triple position)
      Creates a copy of this object with the given position (in mm).
      Parameters:
      position - The new position.
      Returns:
      A copy of this object, differing in the given position.
    • getVehicleOrientationAngle

      public double getVehicleOrientationAngle()
      Returns a vehicle's orientation angle at this position. (-360..360, or Double.NaN, if an orientation angle is not specified for this point.)
      Returns:
      The vehicle's orientation angle when it's at this position.
    • withVehicleOrientationAngle

      public PointCreationTO withVehicleOrientationAngle​(double vehicleOrientationAngle)
      Creates a copy of this object with the vehicle's (assumed) orientation angle when it's at this position. Allowed value range: [-360..360], or Double.NaN to indicate that there is no specific orientation angle for this point.
      Parameters:
      vehicleOrientationAngle - The new angle.
      Returns:
      A copy of this object, differing in the given angle.
    • getType

      @Nonnull public Point.Type getType()
      Returns the type of this point.
      Returns:
      The type of this point.
    • withType

      public PointCreationTO withType​(@Nonnull Point.Type type)
      Creates a copy of this object with the given type.
      Parameters:
      type - The new type.
      Returns:
      A copy of this object, differing in the given type.
    • withProperties

      public PointCreationTO withProperties​(@Nonnull java.util.Map<java.lang.String,​java.lang.String> properties)
      Creates a copy of this object with the given properties.
      Overrides:
      withProperties in class CreationTO
      Parameters:
      properties - The new properties.
      Returns:
      A copy of this object, differing in the given properties.
    • withProperty

      public PointCreationTO withProperty​(@Nonnull java.lang.String key, @Nonnull java.lang.String value)
      Creates a copy of this object and adds the given property. If value == null, then the key-value pair is removed from the properties.
      Overrides:
      withProperty in class CreationTO
      Parameters:
      key - the key.
      value - the value
      Returns:
      A copy of this object that either includes the given entry in it's current properties, if value != null or excludes the entry otherwise.