eu.printingin3d.javascad.coords

Class Coords3d

java.lang.Object

eu.printingin3d.javascad.coords.Abstract3d

eu.printingin3d.javascad.coords.Basic3dFunc<Coords3d>

eu.printingin3d.javascad.coords.Coords3d

public class Coords3d
extends Basic3dFunc<Coords3d>

Immutable representation of a 3D coordinate with useful helper methods.

Author:

ivivan

Field Summary

Fields

Modifier and Type	Field and Description
static Coords3d	MINUS_TINY Can be used to move the object that tiny bit that will solve the different annoying manifold issues and CSG rendering problems.
static Coords3d	TINY Can be used to move the object that tiny bit that will solve the different annoying manifold issues and CSG rendering problems.
static Coords3d	X Represents the (1,0,0) coordinate.
static Coords3d	Y Represents the (0,1,0) coordinate.
static Coords3d	Z Represents the (0,0,1) coordinate.
static Coords3d	ZERO Represents the (0,0,0) coordinate.

Fields inherited from class eu.printingin3d.javascad.coords.Abstract3d

x, y, z

Constructor Summary

Constructors

Constructor and Description
Coords3d(double x, double y, double z) Instantiating a new coordinate with the given coordinates.

Method Summary

Modifier and Type	Method and Description
protected Coords3d	create(double x, double y, double z)
Coords3d	cross(Coords3d a) Returns the cross product of this vector and the specified vector.
static Coords3d	fromByteBuffer(ByteBuffer bb) Creates a coordinate based on the given byte array.
Coords3d	lerp(Coords3d a, double t) Linearly interpolates between this and the specified vector.
static Coords3d	midPoint(Coords3d a, Coords3d b) Calculates the midpoint of the ab segment.
Coords3d	rotate(Angles3d angles) Rotating this coordinate by the given angle, but this object will be unchanged and this method will create a new object with the new coordinates.
Coords3d	unit() Returns a normalized copy of this vector with length.
static Coords3d	xOnly(double x) Creates a coordinate where the Y and Z fields are zero.
static Coords3d	yOnly(double y) Creates a coordinate where the X and Z fields are zero.
static Coords3d	zOnly(double z) Creates a coordinate where the X and Y fields are zero.

Methods inherited from class eu.printingin3d.javascad.coords.Basic3dFunc

add, createVariances, distance, inverse, mul, mul, withX, withY, withZ

Methods inherited from class eu.printingin3d.javascad.coords.Abstract3d

closeEquals, dot, equals, format, getX, getY, getZ, hashCode, isIdent, isXZero, isYZero, isZero, isZZero, magnitude, toByteArray, toString

Methods inherited from class java.lang.Object

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

Field Detail

X

public static final Coords3d X

Represents the (1,0,0) coordinate.

Y

public static final Coords3d Y

Represents the (0,1,0) coordinate.

Z

public static final Coords3d Z

Represents the (0,0,1) coordinate.

ZERO

public static final Coords3d ZERO

Represents the (0,0,0) coordinate.

TINY

public static final Coords3d TINY

Can be used to move the object that tiny bit that will solve the different annoying manifold issues and CSG rendering problems.

MINUS_TINY

public static final Coords3d MINUS_TINY

Can be used to move the object that tiny bit that will solve the different annoying manifold issues and CSG rendering problems.

Constructor Detail

Coords3d

public Coords3d(double x,
                double y,
                double z)

Instantiating a new coordinate with the given coordinates.

Parameters:

x - X coordinate

y - Y coordinate

z - Z coordinate

Method Detail

xOnly

public static Coords3d xOnly(double x)

Creates a coordinate where the Y and Z fields are zero.

Parameters:

x - the X coordinate

Returns:

the newly create coordinate which points to (x,0,0)

yOnly

public static Coords3d yOnly(double y)

Creates a coordinate where the X and Z fields are zero.

Parameters:

y - the Y coordinate

Returns:

the newly create coordinate which points to (0,y,0)

zOnly

public static Coords3d zOnly(double z)

Creates a coordinate where the X and Y fields are zero.

Parameters:

z - the Z coordinate

Returns:

the newly create coordinate which points to (0,0,z)

fromByteBuffer

public static Coords3d fromByteBuffer(ByteBuffer bb)

Creates a coordinate based on the given byte array. This is the inverse operation of the Abstract3d#toByteArray() method.

Parameters:

bb - the byte buffer to be read

Returns:

the new coordinate

midPoint

public static Coords3d midPoint(Coords3d a,
                                Coords3d b)

Calculates the midpoint of the ab segment.

Parameters:

a - first point

b - second point

Returns:

the coordinate of the midpoint of the ab segment

rotate

public Coords3d rotate(Angles3d angles)

Rotating this coordinate by the given angle, but this object will be unchanged and this method will create a new object with the new coordinates.

Parameters:

angles - the angles used by the rotation

Returns:

a new coordinate instance which points to the new location

cross

public Coords3d cross(Coords3d a)

Returns the cross product of this vector and the specified vector.

Parameters:

a - the vector

Returns:

the cross product of this vector and the specified vector.

unit

public Coords3d unit()

Returns a normalized copy of this vector with length. Note: this vector is not modified.

Returns:

a normalized copy of this vector with length

lerp

public Coords3d lerp(Coords3d a,
                     double t)

Linearly interpolates between this and the specified vector. Note: this vector is not modified.

Parameters:

a - vector

t - interpolation value

Returns:

copy of this vector if t = 0; copy of a if t = 1; the point midway between this and the specified vector if t = 0.5

create

protected Coords3d create(double x,
                          double y,
                          double z)

Specified by:

create in class Basic3dFunc<Coords3d>