Awesome
crux
Shared interfaces for point types
This library provides some small interfaces meant to be shared by (subclasses of) various incompatible types such as libGDX's GridPoint2, Vector2, GridPoint3, Vector3, and Vector4, as well as SquidSquad's Coord, and potentially AWT's Point. The code here was pulled from gand, and now gand depends on this.
The interfaces provided here can be used for mutable or immutable points, using
int
or float
components. Anything they provide in the form of default methods
can (and is sometimes meant to) be overridden by an implementing class. Code can
often be written to accept a more general type, such as Point2
, instead of
requiring a specific class, such as Vector2
or GridPoint2
. You can get a
component as a float with the x()
method or int with the xi()
method, with
more of these for higher dimensions (y for 2D, z for 3D, etc.). There's also
overloads of these that take float (for x()
) or int (for xi()
) parameters, to
set that component. Setting edits the point in place if it is mutable, but if the
point is immutable, it either creates a copy or sometimes obtains an existing
immutable point from some type of pool. You can use set()
to set with floats, or
seti()
to set with ints.
Sometimes, though not often, you can even go as general as the superinterface of
all point types here, PointN
. Using PointN is a little more limited, since it
doesn't even know what components a particular point will have, but an example
of types using it (from gand) would be:
public class PathSmoother<V extends PointN<V>> {
//...
}
Installation
The main way should be via Maven Central, where most libraries in the JVM ecosystem tend to be downloaded from. The dependency is
api "com.github.tommyettinger:crux:$cruxVersion"
where cruxVersion
is often defined in gradle.properties
with
cruxVersion=0.1.0
You could instead replace any occurrences of $cruxVersion
with 0.1.0
.
To depend on this on GWT, in addition to the earlier dependency in your core module (assuming a libGDX project), you would have this dependency in your html module:
implementation "com.github.tommyettinger:crux:$cruxVersion:sources"
And this line in your GdxDefinition.gwt.xml
file, before any inherits that might
use crux:
<inherits name="com.github.tommyettinger.crux" />
You can also use JitPack instead of Maven
Central. You probably want the latest commit, not the -SNAPSHOT
version. If
you target GWT, you still need to append :sources
after the version of the
JitPack dependency and use that in the html module, and use the same inherits
line.
License
Name
The name was picked because the crux is a crucial point between (inter-, as in interface) two parts. This is meant to bridge the libGDX-based position code used by some of my libraries, like gand, with the independent position code used by SquidSquad's SquidGrid module.