frink.graphics

Class Point3DDouble

java.lang.Object

frink.graphics.Point3DDouble

public class Point3DDouble
extends java.lang.Object

This is a simple data structure that represents a 3-D point or vector with the coordinates represented as double. It does not currently have as many methods as Point3DFloat (which is sufficient for most 3-D modeling applications,) but is mostly used for spherical and cylindrical coordinate systems to not lose too much data when converting back and forth.

When discussing spherical coordinate systems, this uses the physics conventions (ISO 80000-2:2019) discussed in the Wikipedia article for Spherical Coordinate System

A spherical coordinate is represented as (r, theta, phi) where r is the distance to the origin, theta is the angle down from the z axis (in radians), and phi is the angle starting from the x axis and rotating toward the y axis (in radians.) When these are mapped to a Point3DDouble, x is r, y is theta, and z is phi.

An altitude-azimuth (altAz) coordinate is represented as (r, alt, az) where r is the distance to the origin, alt is the angle "up" from the horizon, and az is the azimuth angle in radians with 0 being north and increasing toward the east. When these are mapped to a Point3DDouble, x is r, y is alt, and z is az.

A cylindrical coordinate is similar to altitude-azimuth and represented as (r, az, h) where r is the distance in the x-y plane to the z axis, az is the azimuth angle in radians with 0 being north (y axis) and increasing toward the east (x axis), and h is the height (equal to the z axis.) When these are mapped to a Point3DDouble, x is r, y is az, and z is h.

Author:

Alan Eliasen, eliasen@mindspring.com

Field Summary

Fields

Modifier and Type	Field and Description
double	x The x coordinate.
double	y The y coordinate.
double	z The z coordinate.

Constructor Summary

Constructors

Constructor and Description
Point3DDouble(double x, double y, double z) Construct a Point3DDouble with the specified coordinates.
Point3DDouble(Point3DFloat orig) Construct a Point3DDouble from a Point3DFloat
Point3DDouble(Point3DInt orig) Construct a Point3DDouble from a Point3DInt

Method Summary

Modifier and Type	Method and Description
java.lang.String	toString() Returns a String representation of this point.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

x

public double x

The x coordinate.

y

public double y

The y coordinate.

z

public double z

The z coordinate.

Constructor Detail

Point3DDouble

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

Construct a Point3DDouble with the specified coordinates.

Point3DDouble

public Point3DDouble(Point3DInt orig)

Construct a Point3DDouble from a Point3DInt

Point3DDouble

public Point3DDouble(Point3DFloat orig)

Construct a Point3DDouble from a Point3DFloat

Method Detail

toString

public java.lang.String toString()

Returns a String representation of this point.

Overrides:

toString in class java.lang.Object