Class DiagonalWorldMap

java.lang.Object
com.github.yellowstonegames.world.WorldMapGenerator
com.github.yellowstonegames.world.DiagonalWorldMap
public class DiagonalWorldMap extends WorldMapGenerator
A concrete implementation of WorldMapGenerator that is like StretchWorldMap but rotates the world so the South Pole is in the lower-left corner (0,0), the North Pole is in the upper right corner (near (width,height)), and wrapping transposes rather than wraps.

  • Field Details

    • terrainFreq

      protected static final float terrainFreq
      See Also:

    • terrainLayeredFreq

      protected static final float terrainLayeredFreq
      See Also:

    • heatFreq

      protected static final float heatFreq
      See Also:

    • moistureFreq

      protected static final float moistureFreq
      See Also:

    • otherFreq

      protected static final float otherFreq
      See Also:

    • minHeat0

      protected float minHeat0

    • maxHeat0

      protected float maxHeat0

    • minHeat1

      protected float minHeat1

    • maxHeat1

      protected float maxHeat1

    • minWet0

      protected float minWet0

    • maxWet0

      protected float maxWet0

    • terrainRidged

      public final com.github.yellowstonegames.grid.NoiseWrapper terrainRidged

    • heat

      public final com.github.yellowstonegames.grid.NoiseWrapper heat

    • moisture

      public final com.github.yellowstonegames.grid.NoiseWrapper moisture

    • otherRidged

      public final com.github.yellowstonegames.grid.NoiseWrapper otherRidged

    • terrainBasic

      public final com.github.yellowstonegames.grid.NoiseWrapper terrainBasic

    • xPositions

      public final float[][] xPositions

    • yPositions

      public final float[][] yPositions

    • zPositions

      public final float[][] zPositions

    • alpha

      public final float alpha
      See Also:

    • kappa

      public final float kappa
      See Also:

    • epsilon

      public final float epsilon

  • Constructor Details

    • DiagonalWorldMap

      public DiagonalWorldMap()
      Always makes a 256x256 map. Uses Noise as its noise generator, with 1f as the octave multiplier affecting detail. If you were using DiagonalWorldMap(long, int, INoise, float), then this would be the same as passing the parameters 0x1337BABE1337D00DL, 256, 256, new Noise(DEFAULT_NOISE), 1f.

    • DiagonalWorldMap

      public DiagonalWorldMap(int mapSize)
      Parameters:
      mapSize - the width and height of the map(s) to generate; cannot be changed later

    • DiagonalWorldMap

      public DiagonalWorldMap(long initialSeed, int mapSize)
      Parameters:
      initialSeed - the seed for the FlowRandom this uses; this may also be set per-call to generate
      mapSize - the width and height of the map(s) to generate; cannot be changed later

    • DiagonalWorldMap

      public DiagonalWorldMap(long initialSeed, int mapSize, float octaveMultiplier)
      Parameters:
      initialSeed - the seed for the FlowRandom this uses; this may also be set per-call to generate
      mapSize - the width and height of the map(s) to generate; cannot be changed later
      octaveMultiplier - used to adjust the level of detail, with 0.5f at the bare-minimum detail and 1f normal

    • DiagonalWorldMap

      public DiagonalWorldMap(long initialSeed, int mapSize, com.github.yellowstonegames.grid.INoise noiseGenerator)
      Parameters:
      initialSeed - the seed for the FlowRandom this uses; this may also be set per-call to generate
      mapSize - the width and height of the map(s) to generate; cannot be changed later
      noiseGenerator - an instance of a noise generator capable of 3D noise, usually Noise

    • DiagonalWorldMap

      public DiagonalWorldMap(long initialSeed, int mapSize, com.github.yellowstonegames.grid.INoise noiseGenerator, float octaveMultiplier)
      Parameters:
      initialSeed - the seed for the FlowRandom this uses; this may also be set per-call to generate
      mapSize - the width and height of the map(s) to generate; cannot be changed later
      noiseGenerator - an instance of a noise generator capable of 3D noise, usually Noise.instance
      octaveMultiplier - used to adjust the level of detail, with 0.5f at the bare-minimum detail and 1f normal

    • DiagonalWorldMap

      public DiagonalWorldMap(DiagonalWorldMap other)
      Copies the DiagonalWorldMap other to construct a new one that is exactly the same. References will only be shared to Noise classes.
      Parameters:
      other - a DiagonalWorldMap to copy

    • DiagonalWorldMap

      public DiagonalWorldMap(int mapSize, String serialized)
      Creates a new generator from the given serialized String, produced by stringSerialize(), but this also requires width and height that match the first two lines of the given String (in Base.BASE86). It is almost always easier to use recreateFromString(String) instead.
      Parameters:
      mapSize - width and height of the map or maps to generate; must match the first line of the given String in Base.BASE86
      serialized - should have been produced by stringSerialize()

  • Method Details

    • stringSerialize

      public String stringSerialize()
      Serializes this generator's entire state to a String; it can be read back when creating a new instance of this type with DiagonalWorldMap(int, String) or (preferably) recreateFromString(String). Uses Base.BASE86 to represent values very concisely, but not at all readably. The String this produces tends to be very long because it includes several 2D arrays and a Region as Strings.
      Overrides:
      stringSerialize in class WorldMapGenerator
      Returns:
      a String that stores the entire state of this generator

    • recreateFromString

      public static DiagonalWorldMap recreateFromString(String data)
      Creates a new instance of this class from a serialized String produced by stringSerialize(). This can get the width and height from the String, which makes this probably preferable to using the constructor DiagonalWorldMap(int, String). This stores the last-generated map in this WorldMapGenerator, where it can be used by other code like a WorldMapView.
      Parameters:
      data - the output of stringSerialize()
      Returns:
      the map that was serialized, as a new generator

    • wrapX

      public int wrapX(int x, int y)
      Overrides:
      wrapX in class WorldMapGenerator

    • wrapY

      public int wrapY(int x, int y)
      Overrides:
      wrapY in class WorldMapGenerator

    • zoomIn

      public void zoomIn(int zoomAmount, int zoomCenterX, int zoomCenterY)
      Description copied from class: WorldMapGenerator
      Floats the resolution of the map and halves the area it covers repeatedly, doubling zoomAmount times; the 2D arrays this uses keep their sizes. This version of zoomIn allows you to specify where the zoom should be centered, using the current coordinates (if the map size is 256x256, then coordinates should be between 0 and 255, and will refer to the currently used area and not necessarily the full world size).
      Although there is no technical restriction on maximum zoom, zooming in more than 5 times (64x scale or greater) will make the map appear somewhat less realistic due to rounded shapes appearing more bubble-like and less like a normal landscape.
      Overrides:
      zoomIn in class WorldMapGenerator
      Parameters:
      zoomCenterX - the center X position to zoom in to; if too close to an edge, this will stop moving before it would extend past an edge
      zoomCenterY - the center Y position to zoom in to; if too close to an edge, this will stop moving before it would extend past an edge

    • zoomOut

      public void zoomOut(int zoomAmount, int zoomCenterX, int zoomCenterY)
      Description copied from class: WorldMapGenerator
      Halves the resolution of the map and floats the area it covers repeatedly, halving zoomAmount times; the 2D arrays this uses keep their sizes. This version of zoomOut allows you to specify where the zoom should be centered, using the current coordinates (if the map size is 256x256, then coordinates should be between 0 and 255, and will refer to the currently used area and not necessarily the full world size).
      Only has an effect if you have previously zoomed in using WorldMapGenerator.zoomIn(int, int, int) or its overload.
      Overrides:
      zoomOut in class WorldMapGenerator
      Parameters:
      zoomCenterX - the center X position to zoom out from; if too close to an edge, this will stop moving before it would extend past an edge
      zoomCenterY - the center Y position to zoom out from; if too close to an edge, this will stop moving before it would extend past an edge

    • project

      public com.github.yellowstonegames.grid.Coord project(float latitude, float longitude)
      Given a latitude and longitude in radians (the conventional way of describing points on a globe), this gets the (x,y) Coord on the map projection this generator uses that corresponds to the given lat-lon coordinates. If this generator does not represent a globe (if it is toroidal, for instance) or if there is no "good way" to calculate the projection for a given lat-lon coordinate, this returns null. This implementation never returns null. If this is a supported operation and the parameters are valid, this returns a Coord with x between 0 and WorldMapGenerator.width, and y between 0 and WorldMapGenerator.height, both exclusive. Automatically wraps the Coord's values using wrapX(int, int) and wrapY(int, int).
      Overrides:
      project in class WorldMapGenerator
      Parameters:
      latitude - the latitude, from -TrigTools.HALF_PI to TrigTools.HALF_PI
      longitude - the longitude, from 0f to TrigTools.PI2
      Returns:
      the point at the given latitude and longitude, as a Coord with x between 0 and WorldMapGenerator.width and y between 0 and WorldMapGenerator.height, or null if unsupported

    • regenerate

      protected void regenerate(int startX, int startY, int usedWidth, int usedHeight, float landMod, float heatMod, long stateA, long stateB)
      Specified by:
      regenerate in class WorldMapGenerator

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object