Package com.io7m.jregions.core.unparameterized.volumes

Class VolumeI

java.lang.Object
com.io7m.jregions.core.unparameterized.volumes.VolumeI
All Implemented Interfaces:
VolumeSizeValuesIType, VolumeIType, VolumeValuesIType
public final class VolumeI
extends java.lang.Object
implements VolumeIType

A volume with int coordinates.

The coordinates of the area are given in half-closed form. That is, minimumX() refers to the minimum inclusive value on the X axis, and maximumX() refers to the maximum exclusive value on the X axis. Likewise for the Y and Z axes.

  • Nested Class Summary

    Nested Classes 
    Modifier and Type Class Description
    static class  VolumeI.Builder
    Builds instances of type VolumeI.

  • Method Summary

    Modifier and Type Method Description
    static VolumeI.Builder builder()
    Creates a builder for VolumeI.
    static VolumeI copyOf​(VolumeIType instance)
    Creates an immutable copy of a VolumeIType value.
    boolean equals​(java.lang.Object another)
    This instance is equal to all instances of VolumeI that have equal attribute values.
    int hashCode()
    Computes a hash code from attributes: minimumX, maximumX, minimumY, maximumY, minimumZ, maximumZ.
    int maximumX()  
    int maximumY()  
    int maximumZ()  
    int minimumX()  
    int minimumY()  
    int minimumZ()  
    static VolumeI of​(int minimumX, int maximumX, int minimumY, int maximumY, int minimumZ, int maximumZ)
    Construct a new immutable VolumeI instance.
    java.lang.String toString()
    Prints the immutable value VolumeI with attribute values.
    VolumeI withMaximumX​(int value)
    Copy the current immutable object by setting a value for the maximumX attribute.
    VolumeI withMaximumY​(int value)
    Copy the current immutable object by setting a value for the maximumY attribute.
    VolumeI withMaximumZ​(int value)
    Copy the current immutable object by setting a value for the maximumZ attribute.
    VolumeI withMinimumX​(int value)
    Copy the current immutable object by setting a value for the minimumX attribute.
    VolumeI withMinimumY​(int value)
    Copy the current immutable object by setting a value for the minimumY attribute.
    VolumeI withMinimumZ​(int value)
    Copy the current immutable object by setting a value for the minimumZ attribute.

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface com.io7m.jregions.core.unparameterized.volumes.VolumeIType

    checkPreconditions

    Methods inherited from interface com.io7m.jregions.core.unparameterized.volumes.VolumeValuesIType

    sizeX, sizeY, sizeZ

  • Method Details

    • minimumX

      public int minimumX()
      Specified by:
      minimumX in interface VolumeIType
      Specified by:
      minimumX in interface VolumeValuesIType
      Returns:
      The value of the minimumX attribute

    • maximumX

      public int maximumX()
      Specified by:
      maximumX in interface VolumeIType
      Specified by:
      maximumX in interface VolumeValuesIType
      Returns:
      The value of the maximumX attribute

    • minimumY

      public int minimumY()
      Specified by:
      minimumY in interface VolumeIType
      Specified by:
      minimumY in interface VolumeValuesIType
      Returns:
      The value of the minimumY attribute

    • maximumY

      public int maximumY()
      Specified by:
      maximumY in interface VolumeIType
      Specified by:
      maximumY in interface VolumeValuesIType
      Returns:
      The value of the maximumY attribute

    • minimumZ

      public int minimumZ()
      Specified by:
      minimumZ in interface VolumeIType
      Specified by:
      minimumZ in interface VolumeValuesIType
      Returns:
      The value of the minimumZ attribute

    • maximumZ

      public int maximumZ()
      Specified by:
      maximumZ in interface VolumeIType
      Specified by:
      maximumZ in interface VolumeValuesIType
      Returns:
      The value of the maximumZ attribute

    • withMinimumX

      public final VolumeI withMinimumX​(int value)
      Copy the current immutable object by setting a value for the minimumX attribute. A value equality check is used to prevent copying of the same value by returning this.
      Parameters:
      value - A new value for minimumX
      Returns:
      A modified copy of the this object

    • withMaximumX

      public final VolumeI withMaximumX​(int value)
      Copy the current immutable object by setting a value for the maximumX attribute. A value equality check is used to prevent copying of the same value by returning this.
      Parameters:
      value - A new value for maximumX
      Returns:
      A modified copy of the this object

    • withMinimumY

      public final VolumeI withMinimumY​(int value)
      Copy the current immutable object by setting a value for the minimumY attribute. A value equality check is used to prevent copying of the same value by returning this.
      Parameters:
      value - A new value for minimumY
      Returns:
      A modified copy of the this object

    • withMaximumY

      public final VolumeI withMaximumY​(int value)
      Copy the current immutable object by setting a value for the maximumY attribute. A value equality check is used to prevent copying of the same value by returning this.
      Parameters:
      value - A new value for maximumY
      Returns:
      A modified copy of the this object

    • withMinimumZ

      public final VolumeI withMinimumZ​(int value)
      Copy the current immutable object by setting a value for the minimumZ attribute. A value equality check is used to prevent copying of the same value by returning this.
      Parameters:
      value - A new value for minimumZ
      Returns:
      A modified copy of the this object

    • withMaximumZ

      public final VolumeI withMaximumZ​(int value)
      Copy the current immutable object by setting a value for the maximumZ attribute. A value equality check is used to prevent copying of the same value by returning this.
      Parameters:
      value - A new value for maximumZ
      Returns:
      A modified copy of the this object

    • equals

      public boolean equals​(java.lang.Object another)
      This instance is equal to all instances of VolumeI that have equal attribute values.
      Overrides:
      equals in class java.lang.Object
      Returns:
      true if this is equal to another instance

    • hashCode

      public int hashCode()
      Computes a hash code from attributes: minimumX, maximumX, minimumY, maximumY, minimumZ, maximumZ.
      Overrides:
      hashCode in class java.lang.Object
      Returns:
      hashCode value

    • toString

      public java.lang.String toString()
      Prints the immutable value VolumeI with attribute values.
      Overrides:
      toString in class java.lang.Object
      Returns:
      A string representation of the value

    • of

      public static VolumeI of​(int minimumX, int maximumX, int minimumY, int maximumY, int minimumZ, int maximumZ)
      Construct a new immutable VolumeI instance.
      Parameters:
      minimumX - The value for the minimumX attribute
      maximumX - The value for the maximumX attribute
      minimumY - The value for the minimumY attribute
      maximumY - The value for the maximumY attribute
      minimumZ - The value for the minimumZ attribute
      maximumZ - The value for the maximumZ attribute
      Returns:
      An immutable VolumeI instance

    • copyOf

      public static VolumeI copyOf​(VolumeIType instance)
      Creates an immutable copy of a VolumeIType value. Uses accessors to get values to initialize the new immutable instance. If an instance is already immutable, it is returned as is.
      Parameters:
      instance - The instance to copy
      Returns:
      A copied immutable VolumeI instance

    • builder

      public static VolumeI.Builder builder()
      Creates a builder for VolumeI. 
       VolumeI.builder()
    .setMinimumX(int) // required minimumX
    .setMaximumX(int) // required maximumX
    .setMinimumY(int) // required minimumY
    .setMaximumY(int) // required maximumY
    .setMinimumZ(int) // required minimumZ
    .setMaximumZ(int) // required maximumZ
    .build();
      Returns:
      A new VolumeI builder