org.edisonwj.draw3d

Class Draw3D

java.lang.Object

javafx.application.Application

org.edisonwj.draw3d.Draw3D

All Implemented Interfaces:

Draw3DDefaults

public class Draw3D
extends javafx.application.Application
implements Draw3DDefaults

This application provides a GUI and program interface for 3D drawing.

Version:

1.12 June 2017 Draw3D was developed, using JavaFX 8, in support of a colleague developing a linear algebra course to provide students/teachers with basic methods for displaying and working with three dimensional data involving vectors, lines, arrows, planes, and other geometric shapes and constructs. It is a work in progress and has evolved from a data entry and display tool to be primarily program driven. It provides methods for displaying three dimensional data, and supports the creation of a series of views (particularly for teachers) that can be paged through (forward and backward), rotated, zoomed, and moved around as a whole on the screen. Two sets of methods are provided. A basic set provides methods for drawing and setting parameters, such as color and size, related to drawing the objects. These methods are intended to free students from having to construct and manage objects, and just focus on mathematical constructs. Basic drawing methods are: - drawArrow(double x1, double y1, double z1, double x2, double y2, double z2) - drawBezier(Point3D[] p) - drawCircle(double x, double y, double z, double r) - drawCircle(double x, double y, double z, double r, double rx, double ry, double rz) - drawCone(double x, double y, double z, double r, double h) - drawCone(double x, double y, double z, double r, double h, double rx, double ry, double rz) - drawCuboid(double x, double y, double z, double width, double height, double depth) - drawCuboid(double x, double y, double z, double width, double height, double depth, double rx, double ry, double rz) - drawCylinder(double x, double y, double z, double r, double h) - drawCylinder(double x, double y, double z, double r, double h, double rx, double ry, double rz) - drawGrid(int sector, int div, PhongMaterial m) - drawLabel(double x, double y, double z, String s) - drawLabel(double x, double y, double z, String s, Font f, Color c) - drawLabel(double x, double y, double z, double rx, double ry, double rz, String s) - drawLabel(double x, double y, double z, double rx, double ry, double rz, String s, Font f, Color c) - drawLine(double x1, double y1, double z1, double x2, double y2, double z2) - drawLineEquation(double a1, double a2, double a3, double b1, double b2, double b3) - drawOval(double xi, double yi, double zi, double a, double b) - drawOval(double xi, double yi, double zi, double a, double b, double rx, double ry, double rz) - drawPlane(double a, double b, double c, double d) - drawPlane(double x1, double y1, double z1, double x2, double y2, double z2, double x3, double y3, double z3) - drawPoint(double x, double y, double z) - drawPolygon(Point3D[] v) - drawPolygon(Point3D[] v, boolean drawEdges, boolean drawVertices, boolean drawVertexLabels) - drawRectangle(double x, double y, double z, double w, double h) - drawRectangle(double x, double y, double z, double w, double h, double rx, double ry, double rz) - drawSphere(double x, double y, double z, double r) - drawSquare(double x, double y, double z, double ln) - drawSquare(double x, double y, double z, double ln, double rx, double ry, double rz) - drawVector(double[] v) - drawVector(double x, double y, double z) - openFile(String filePath, String fileName) Opens the specified file using the default application for that file type - openFile(String fileName) Opens the specified file in executable directory using the default application for that file type - loadData(String filePath, String fileName) Loads the specified data text file - loadData(String fileName) Loads the specified data text file from the current executable directory - loadAlgorithm(String className) Loads and returns, as an org.edisonwj.draw3D.Algoriththm object, the specified Algorithm class file from the current classPath. Multiple algorithms may be loaded and are run nearly concurrently. - saveData(String filePath, String fileName) Saves the specified data text file - saveData(String fileName) Saves the specified data text file to the current executable directory - saveScene(Scene scene, String format, String filePath, String fileName) Saves the current scene to the specified file in format: bmp, gif, jpg, png - saveScene(Scene scene, String format, String fileName) Saves the current scene to the specified file in the current executable directory in format: bmp, gif, jpg, png - saveSubScene(Scene scene, String format, String filePath, String fileName) Saves the current subScene to the specified file in format: bmp, gif, jpg, png - saveSubScene(Scene scene, String format, String fileName) Saves the current subScene to the specified file in the current executable directory in format: bmp, gif, jpg, png Drawing parameter setting methods are: (these parameter setting methods apply only to the basic drawing methods listed above.) - setPointSize(double d) (pixels) - setLineRadius(double d) (pixels) - setArrowRadius(double d) (pixels) - setVectorRadius(double d) (pixels) - setConeDivisions(int i) - setCylinderDivisions(int i) - setOvalDivisions(int i) - setSphereDivisions(int i) - setCullFace(CullFace cf ) - setDrawMode(DrawMode dm) - setDrawColor(Color c) Sets the default PhongMaterial diffuse Color - setDrawColor(Color c1, Color c2) Sets the default PhongMaterial diffuse and specular colors - setLabelFont(Font f) - setLabelFontSize(double d) - setMaterial(PhongMaterial m) Sets the default PhongMaterial - setTexture(Image i) Sets the default PhongMaterial with the image As well as the basic drawing methods above, another set is provided that allows for more extensive object customization. Most of the drawing methods above are implemented using the following methods: - drawArrow3D(Arrow3D a3d) - drawBox3D(Box3D b3d) - drawCone3D(Cone3D c3d) - drawCylinder3D(Cylinder3D c3d)) - drawDrone3D(Drone3D d3d) - drawLabel3D(Text3D t3d) - drawLine3D(Line3D ln) - drawLine3DSet(Line3D[] ln) - drawMesh3D(Mesh3D m3d) - drawOval3D(Oval3D o3d) - drawPlane3D(Plane3D pl) - drawPoint3D(Point3D p) - drawPoint3DSet(Point3D[] p) - drawPolygon3D(Polygon3D p3d) - drawPolyhedron3D(Polyhedron3D p3d) where abstract Polyhedron3D is an instance of: Dodecahedron3D, Icosahedron3D, Octahedron3D, Tetrahedron3D - drawPolyhedronEdges3D(Polyhedron3D p3d) - drawPolyLine3D(Point3D[] p) - drawRectangle3D(Rectangle3D r) - drawSphere3D(Sphere3D s3d) - drawSphere3DSet(Sphere3D[] ss) - drawTriangle3D(Triangle3D t3d) - drawVector3D(Vector3D vc) - drawVector3DSet(Vector3D v) - rotateLine3D(Line3D ln, double rxd, double ryd, double rzd, boolean zUp) The following parameter setting methods apply to all drawing methods. - setDefaults() - setAmbientLight(boolean b) - setPointLight(boolean b) - setShowAxes(boolean b) - setShowYAxisUp(boolean b) - X+ to right, Y+ upward, Z+ toward viewer - setShowYAxisUpNoZ(boolean b) - X+ to right, Y + upward, and no Z axis displayed (Shape specification still requires x, y, and z.) Camera specification are changed to center on origin - setShowZAxisUp(boolean b) - X+ toward user, Y+ to right, Z+ upward - setXYaxesOnly(boolean b) - shows only X and Y axes centered on origin - setShowBoundaryCube(boolean b) - setBackgroundColor(Color c) - setCumulate(boolean b) - setStart(int i) Specify initial view to display - setStart() Start display with view zero - incrSequence() Begin definition of a new view and mark it visible - setCamera(double x-angle, double y-angle, double z-distance) Sets camera location/orientation with JavaFX X axis positive to the right, Y axis positive down, and Z axis positive away from the viewer. (-10, -200, -1000) is default and offsets camera from axes. (0, -180, -800) centers camera on Z axis. - setOriginView(int x, int y, int z) Sets view center point to specified screen position. (0, 0, 0) pixels is default. - setScale(double scaleX, double scaleY, double scaleZ) Sets scale vales for x , y, z - setXYZRange(double minmaxX, double minmaxY, double minmaxZ) Sets user coordinate space ranges. (10, 10, 10) is default. The following mouse and keyboard commands are available to modify views. Reset Double clicking the mouse stops executing concurrent tasks, clears current views, associated data structures and settings, and reinitialize the subScene. Rotation The mouse can be used to rotate the displayed items about all axes. Scale/Zoom The mouse wheel can be used to zoom in or out. (This can also be done with the keypad +/- keys.) Keyboard short cuts (alphabetic keys are not case sensitive) - B: moves backward to display previous data view. - C: toggles manual cumulate mode. When manual cumulate is on, it overrides program defined cumulate, and when moving forward the current data group(s) is retained for viewing, i.e. data groups are overlaid. - F: or Space: advances forward to display next data group. - R: resets origin to current default and redraws current data group. - T: generates a basic set of vector test data. - X: marks all currently displayed data groups invisible and advances to display the next data group. - Z: marks all data groups invisible, returns viewing to data group number 0, and displays it. - + on keypad: zooms in. - - on keypad: zooms out. - Up arrow: moves displayed data up in the view space. (NumLk must be off.) - Down arrow: moves displayed data down in the view space. (NumLk must be off.) - Left arrow: moves displayed data left in the view space. (NumLk must be off.) - Right arrow: moves displayed data right in the view space. (NumLk must be off.) Menu Bar - Main Menu (Draw3D looks for a Resources directory for the Open and Load operations; if not found the current working directory is used. All other operations default to the current working directory, but the selection dialogue can be used to select any directory.) - Open: opens the file selected from a File Chooser dialogue using the default application for the selected file type. - Load Data: loads and displays data using the format described below. - Run Algorithm: loads and executes an algorithm class file (contents described below). - Load AlgorithmS: provides for loading multiple algorithms, one at a time, making them ready for execution. - Run AlgorthmS: executes concurrently all of the Algorithm class files previously loaded. - Save Data File: saves currently displayed data using the format described below. - Save Scene: saves the current display in bmp, jpg, or png format. - Save SubScene: saves the current display excluding the menu bar in bmp, jpg, png format. - View Menu - Axes: show axes. - Axis Y Up: display data with positive Y axis pointing up (Axis Y Up and Axis Z Up are mutually exclusive). - Axis Y up and No Z: display data with positive Y axis pointing up, X axis horizontal and no Z axis displayed. (Shape specification still requires x, y, and z). - Axis Z Up: display data with positive Z axis pointing up. - Tick Marks: show tick marks on axes. - Boundary Cube: display boundary cube based on minmaxX, minmaxY, and minmaxZ. - Default Grid: displays grid lines across all sectors with 4 lines per axis. - Ambient Light: use ambient light. - Point Light: use point light. - Help Menu - Open Help Text: opens and displays this file. Algorithm Class File The Algorithm class file must implement the Algorithm Interface which supports animation style execution with several parameter values. The class file must specify: - iterations (int) - the number of iterations to be executed - delay (long) - the wait time in milliseconds between each iteration - clear flag (boolean) - indicates whether current display contents should be cleared before displaying the next iteration - drone flag (boolean) - indicates the algorithm is implementing a drone - id (int) - identifier used only by drones - info (double[]) - information array used only by drones - vMaterial - PhongMaterial to be used in display of the item (vMaterial can be changed at each iteration) (PhongMaterial can also be embedded in the returned objects.) When executed by selecting the Run Algorithm Main Menu option, the selected algorithm class file is executed returning an object of type listed below. When the Load AlgorithmS Main Menu option is used to load two or more algorithm class files (only two drone class files may be executed concurrently), the loaded class files are executed concurrently when Run AlgorithmS is selected. The concurrently executing class files return objects of type listed below. Currently supported return types are: - Arrow3D - Box3D - Cone3D - Cylinder3D - Dodecahedron3D - Drone3D - Icosahedron3D - Line3D - Line3D[] - Mesh3D - Octahedron3D - Oval3D - Plane3D - Point3D - Point3D[] - Polygon3D - Rectangle3D - Sphere3D - Sphere3D[] - Tetrahedron3D - Text3D - Triangle3D - Vector3D - Object[] Array containing the above listed 3D objects The Main Menu Load and Save data use the following formats: The file data fields may be separated by a comma, blank, colon, or semicolon and are formatted with an initial data type indicator followed by parameters: Comment: // indicates a comment line DataGroup: Starts a DataGroup/View definition View: showAxes-flag, showTickMarks-flag, axisZup-flag, showBoundaryCubeflag, ambientLight-flag, pointLight-flag, cumulate-flag Camera: x-angle, y-angle, z-distance Origin: x-coor, y-coor, z-coor (pixels) Range: x-minmax, y-minmax, z-minmax (The range statement triggers rebuild of the axes, tick marks, boundary, and/or grid based on the view, camera, and origin settings.) Arrow data: Arrow: x1-coor, y1-ccor, z1-coor, x2-coor, y2-coor, z2-coor, drawMode, cullFace, material Box data: Box: center-x-coor, center-y-coor, center-z-coor, width, height, depth, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Cone data: Cone: tip-x-coor, tip-y-coor, tip-z-coor, height, radius, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Cylinder data: Cylinder: center-x-coor, center-y-coor, center-z-coor, height, radius, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Dodecahedron data: Dodecahedron: center-x-coor, center-y-coor, center-z-coor, size, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Icosahedron data: Icosahedron: center-x-coor, center-y-coor, center-z-coor, size, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Line data: Line: x1-coor, y1-coor, z1-coor, x2-coor, y2-coor, z2-coor, drawMode, cullFace, material Octahedron data: Octahedron: center-x-coor, center-y-coor, center-z-coor, size, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Oval data: Oval: center-x1-coor, center-y1-coor, center-z1-coor, majorRadius, minorRadius, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Plane data: Plane: (plane equation coordinates) a, b, c, d, drawMode, cullFace, material Point data: Point: x-coor, y-coor, z-coor, drawMode, cullFace, material Polygon data: Polygon: ( x-coor, y-coor, z-coor ), ... #, drawEdges, drawVertices, drawVertexLabels, drawMode, cullFace, material Sphere data: Sphere: center-x-coor, center-y-coor, center-z-coor, radius, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Tetrahedron data: Tetrahedron: center-x-coor, center-y-coor, center-z-coor, size, x-rotation, y-rotation, z-rotation, drawMode, cullFace, material Text data: Text: center-x-coor; center-y-coor; center-z-coor; x-rotation; y-rotation; z-rotation; Font; Color; String (for Text only, values must be : or ; delimited) Triangle data: Triangle: ( x1-coor, y1-coor, z1-coor ), ( x2-coor, y2-coor, z2-coor ), ( x3-coor, y3-coor, z3-coor ), #, drawMode, cullFace, material Vector data: Vector: endx-coor, endy-coor, endz-coor, drawMode, cullFace, material See example data files: line check 1-4.txt, vector check 1-2.txt, shapes.txt. See JavaDoc for a full description of the classes and methods. Draw3D implements Draw3DDefaults to initialize state.

Author:

William Edison

Nested Class Summary

Nested classes/interfaces inherited from class javafx.application.Application

javafx.application.Application.Parameters

Field Summary

Fields inherited from class javafx.application.Application

STYLESHEET_CASPIAN, STYLESHEET_MODENA

Fields inherited from interface org.edisonwj.draw3d.Draw3DDefaults

AMBIENT_LIGHT_ON, ARROW_POINT_HEIGHT, ARROW_POINT_RADIUS, ARROW_RADIUS, AV_POINT_DIVISIONS, AXIS_LENGTH, AXIS_RADIUS, BACKGROUND_COLOR, BOUNDRY_RADIUS, CAMERA_FAR_CLIP, CAMERA_INITIAL_DISTANCE, CAMERA_INITIAL_X_ANGLE, CAMERA_INITIAL_Y_ANGLE, CAMERA_NEAR_CLIP, CONE_DIVISIONS, CUMULATE_DEFAULT, CUMULATE_MANUAL_DEFAULT, CYLINDER_DIVISIONS, DEFAULT_ORIGIN, EDGE_RADIUS, EPSILON, LABEL_FONT, LABEL_FONT_SIZE, LINE_RADIUS, MIN_MAX_X, MIN_MAX_Y, MIN_MAX_Z, MOUSE_SPEED, OVAL_DIVISIONS, POINT_LIGHT_1_X, POINT_LIGHT_1_Y, POINT_LIGHT_1_Z, POINT_LIGHT_2_X, POINT_LIGHT_2_Y, POINT_LIGHT_2_Z, POINT_LIGHT_ON, POINT_SIZE, ROTATION_SPEED, SCENE_HEIGHT, SCENE_WIDTH, SCROLL_DELTA, SCROLL_FACTOR, SHOW_AXES, SHOW_BOUNDARY_CUBE, SHOW_DEFAULT_GRID, SHOW_TICK_MARKS, SHOW_X_Y_ONLY, SHOW_Z_AXIS_UP, SPHERE_DIVISIONS, TICK_MARK_LENGTH, TICK_MARK_RADIUS, VECTOR_POINT_HEIGHT, VECTOR_POINT_RADIUS, VECTOR_RADIUS, VERTEX_SIZE

Constructor Summary

Constructors

Constructor and Description
Draw3D()

Method Summary

Modifier and Type	Method and Description
javafx.scene.Scene	buildScene() Builds the Scene for display and use by Draw3D methods.
void	buildSubScene() Builds the SubScene, creates the data structures and groups required for Draw3D, and initializes to default state per the settings in Draw3DDefaults.
void	buildTest() Draws a test set of eight vectors, one in each quadrant of the user coordinate space.
void	drawArrow(double x1, double y1, double z1, double x2, double y2, double z2) Constructs an Arrow3D object with specified start and end points and draws it.
void	drawArrow3D(Arrow3D a3d) Draws an Arrow3D object.
void	drawBezier(javafx.geometry.Point3D[] p) Draws a Bezier curve defined by the specified array of control points.
void	drawBox3D(Box3D b3d) Draws a Box3D object.
void	drawBox3D(Box3D b3d, boolean showEdges) Draws a Box3D object, optionally with edges highlighted.
void	drawBoxEdges3D(Box3D b3d) Draws the edges of Box3D
void	drawCircle(double x, double y, double z, double r) Constructs a circle object (JavaFX Cylinder w/ height .1) with specified center point and radius and draws it.
void	drawCircle(double x, double y, double z, double r, double rx, double ry, double rz) Constructs a circle object (JavaFX Cylinder w/ height .1) with specified center point, radius, and x-rotation, y-rotation, z-rotation and draws it.
void	drawCone(double x, double y, double z, double r, double h) Constructs a Cone3D object with point at specified coordinates, radius, and height and draws it.
void	drawCone(double x, double y, double z, double r, double h, double rx, double ry, double rz) Constructs a Cone3D object with point at specified coordinates, radius, height, and xyz rotations and draws it.
void	drawCone3D(Cone3D c3d) Draws a Cone3D object.
void	drawCuboid(double x, double y, double z, double width, double height, double depth) Constructs a Box3D object with specified center point, width, height, and depth and draws it.
void	drawCuboid(double x, double y, double z, double width, double height, double depth, double rx, double ry, double rz) Constructs a Box3D object with specified center point, width, height, depth, and x-rotation, y-rotation, z-rotation and draws it.
void	drawCylinder(double x, double y, double z, double r, double h) Constructs a Cylinder3D object with specified center point, radius, and height and draws it.
void	drawCylinder(double x, double y, double z, double r, double h, double rx, double ry, double rz) Constructs a Cylinder3D object with specified center point, radius, height, x-rotation, y-rotation, z-rotation and draws it.
void	drawCylinder3D(Cylinder3D c3d) Draws a Cylinder3D object.
void	drawDrone3D(Drone3D d3d) Draws a Drone3D object.
void	drawDrone3D(int view, Drone3D d3d) Draws a Drone3D object.
void	drawGrid(int sector, int div, javafx.scene.paint.PhongMaterial m) Draws grid lines in the user coordinate space.
void	drawLabel(double x, double y, double z, double rx, double ry, double rz, java.lang.String s) Constructs a Text3D object and draws it with center at xyz location and xyz rotation specifications.
void	drawLabel(double x, double y, double z, double rx, double ry, double rz, java.lang.String s, javafx.scene.text.Font f, javafx.scene.paint.Color c) Constructs a Text3D object and draws it with center at xyz location and xyz rotation with the specified color and size.
void	drawLabel(double x, double y, double z, java.lang.String s) Constructs a Text3D object and draws it with center at xyz location.
void	drawLabel(double x, double y, double z, java.lang.String s, javafx.scene.text.Font f, javafx.scene.paint.Color c) Constructs a Text3D object and draws it with center at xyz location with the specified color and size.
void	drawLabel3D(Text3D t3d) Draws a Text3D object according to its xyz location, xyz rotation, String contents, with default or object specific font and color specifications.
void	drawLine(double x1, double y1, double z1, double x2, double y2, double z2) Constructs a line object with specified start and end points and draws it.
void	drawLine3D(Line3D ln) Draws a Line3D object.
void	drawLine3DSet(Line3D[] ln) Draws a set of Line3D line segments with specified color
void	drawLineEquation(double a1, double a2, double a3, double b1, double b2, double b3) Constructs a Line3D object given the symmetric line equation coefficients, finds the intersection points with the current boundary of the user coordinate space, and draws the line between the intersection points.
void	drawMesh3D(Mesh3D m3d) Draws a variable Mesh3D object.
void	drawOval(double xi, double yi, double zi, double a, double b) Constructs an oval object with specified center points, major radius, minor radius, and drawing parameters and draws it.
void	drawOval(double xi, double yi, double zi, double a, double b, double rx, double ry, double rz) Constructs an Oval3D object with specified center points, major radius, minor radius, x-rotation, y-rotation, z-rotation and draws it.
void	drawOval3D(Oval3D o3d) Draws an Oval3D object.
void	drawPlane(double a, double b, double c, double d) Constructs a plane object with specified plane equation coordinates and draws it.
void	drawPlane(double x1, double y1, double z1, double x2, double y2, double z2, double x3, double y3, double z3) Constructs a plane object using specification of three points in the plane and draws it.
void	drawPlane3D(Plane3D pl) Draws a plane object terminated at the bounding box defined by minmaxX, minmaxY, minmaxZ.
void	drawPlanePoints(Plane3D pl) Displays a series of points lying in the specified Plane.
void	drawPoint(double x, double y, double z) Constructs a Sphere3D object corresponding to the point using the coordinates specified as its center and with radius of size pointSize (in pixels).
void	drawPoint3D(javafx.geometry.Point3D p) Constructs a Sphere3D object corresponding to the coordinates of the Point3D specified as its center and with radius of size pointSize (in pixels).
void	drawPoint3DSet(javafx.geometry.Point3D[] p) Draws a set of points with specified color.
void	drawPolygon(javafx.geometry.Point3D[] v) Constructs a polygon object using the Point3D array of vertices and draws it.
void	drawPolygon(javafx.geometry.Point3D[] v, boolean drawEdges, boolean drawVertices, boolean drawVertexLabels) Constructs a polygon object using the Point3D array of vertices and draws it.
void	drawPolygon3D(Polygon3D p3d) Draws the polygon object specified.
void	drawPolyhedron3D(org.edisonwj.draw3d.Polyhedron3D p3d) Draws a Polyhedron3D object.
void	drawPolyhedron3D(org.edisonwj.draw3d.Polyhedron3D p3d, boolean showEdges) Draws a Polyhedron3D object.
void	drawPolyhedronEdges3D(org.edisonwj.draw3d.Polyhedron3D p3d) Draws the edges of a Polyhedron3D object
void	drawPolyLine3D(javafx.geometry.Point3D[] p) Draws a polyline as specified by the parameter array of points.
void	drawRectangle(double x, double y, double z, double w, double h) Constructs a rectangle object with specified center point, width, and height, and draws it.
void	drawRectangle(double x, double y, double z, double w, double h, double rx, double ry, double rz) Constructs a rectangle object with specified center point, width, height, x rotation, y rotation, and z rotation and draws it.
void	drawRectangle3D(Rectangle3D r) Draws the rectangle object specified.
void	drawSphere(double x, double y, double z, double r) Constructs a Sphere3D object with specified center point and radius and draws it.
void	drawSphere3D(Sphere3D s3d) Draws the Sphere3D object specified.
void	drawSphere3DSet(Sphere3D[] ss) Draws a set of Sphere3D objects
void	drawSquare(double x, double y, double z, double ln) Constructs a square object (Rectangle3D) with specified center point and side length and draws it.
void	drawSquare(double x, double y, double z, double ln, double rx, double ry, double rz) Constructs a square object (Rectangle3D) with specified center point, side length, x-rotation, y-rotation, z-rotation and draws it.
void	drawTriangle3D(Triangle3D t3d) Draws a Triangle3D object.
void	drawVector(double[] v) Constructs a Vector3D object with specified end points and draws it.
void	drawVector(double x, double y, double z) Constructs a Vector3D object with specified end point and draws it.
void	drawVector3D(Vector3D vc) Draws the Vector3D object specified.
void	drawVector3DSet(Vector3D[] v) Draws a set of Vector3D objects as specified in the parameter array.
double	dX(double xu) Converts x coordinate value from user to screen coordinate space.
double	dY(double yu) Converts y coordinate value from user to screen coordinate space.
double	dZ(double zu) Converts z coordinate value from user to screen coordinate space.
double	getXMinMax() Gets the current minimum/maximum value for the X coordinate in user space.
double	getYMinMax() Gets the current minimum/maximum value for the Y coordinate in user space.
double	getZMinMax() Gets the current minimum/maximum value for the Z coordinate in user space.
void	incrSequence() Initiates a new view and makes it immediately visible while making the previous view invisible in a sequence of views with associated data objects.
Algorithm	loadAlgorithm(java.lang.String className) Loads the specified Algorithm class.
void	loadData(java.lang.String fileName) Loads the specified data file.
void	loadData(java.lang.String pathName, java.lang.String fileName) Loads the specified data file.
static void	main(java.lang.String[] args)
void	openFile(java.lang.String fileName) Opens the specified file using the default application for its extension.
void	openFile(java.lang.String pathName, java.lang.String fileName) Opens the specified file using the default application for its extension.
Line3D	rotateLine3D(Line3D ln, double rxd, double ryd, double rzd) Computes a new Line3D object with start and end coordinates transformed by rotations on each axis about the origin.
void	saveData(java.lang.String fileName) Saves current view data to the specified data file.
void	saveData(java.lang.String pathName, java.lang.String fileName) Saves current view data to the specified data file.
void	saveScene(java.lang.String format, java.lang.String fileName) Saves the current scene with the specified format to the specified file.
void	saveScene(java.lang.String format, java.lang.String pathName, java.lang.String fileName) Saves the current scene with the specified format to the specified file.
void	saveSubScene(java.lang.String format, java.lang.String fileName) Saves the current subScene with the specified format to the specified file.
void	saveSubScene(java.lang.String format, java.lang.String pathName, java.lang.String fileName) Saves the current subScene with the specified format to the specified file.
void	setAmbientLight(boolean b) Activates (true value) ambient light for a view.
void	setArrowRadius(double d) Specifies the radius (pixels) to be used with basic drawArrow() methods.
void	setBackgroundColor(javafx.scene.paint.Color c) Sets the scene Background Color.
void	setCamera(double x, double y, double z) Sets the camera location associated with a view.
void	setConeDivisions(int i) Specifies the number of divisions to be used with basic drawCone() methods.
void	setCullFace(javafx.scene.shape.CullFace cf) Sets the default CullFace value.
void	setCumulate(boolean b) Activates (true value) overlay of subsequent views in the sequence of displays.
void	setCylinderDivisions(int i) Specifies the number of divisions to be used with basic drawCylinder() methods.
void	setDefaults() Set defaults: -View settings -Origin -Scale -XYZ Range -Camera position -Drawing settings
void	setDrawColor(javafx.scene.paint.Color c1) Creates a new default PhongMaterial object (drawMaterial) to be used in drawing all objects and sets the default diffuse color.
void	setDrawColor(javafx.scene.paint.Color c1, javafx.scene.paint.Color c2) Creates a new default PhongMaterial object (drawMaterial) to be used in drawing all objects and sets the default diffuse and specular colors.
void	setDrawMode(javafx.scene.shape.DrawMode dm) Sets the default DrawMode value.
void	setLabelFont(javafx.scene.text.Font f) Sets the default Label font and size.
void	setLabelFontSize(double d) Sets the default Label font to "Regular" with specified size.
void	setLineRadius(double d) Specifies the radius (pixels) to be used with basic drawLine() methods.
void	setMaterial(javafx.scene.paint.PhongMaterial m) Sets the default PhongMaterial value.
void	setOriginView(int x, int y, int z) Sets the default origin (center) x, y, z coordinates in screen space (pixels).
void	setOvalDivisions(int i) Specifies the number of divisions to be used with basic drawOval() methods.
void	setPointLight(boolean b) Activates (true value) point lights for a view.
void	setPointSize(double d) Specifies the radius (pixels) to be used with basic drawPoint() methods.
void	setScale(double scaleX, double scaleY, double scaleZ) Sets the scale associated with a view.
void	setSequencingOn() Indicates the beginning of a sequence of views with associated data objects.
void	setShowAxes(boolean b) Activates (true value) display of axes.
void	setShowBoundaryCube(boolean b) Activates (true value) display of the boundary cube determined by the current values of minX, maxX, minY, maxY, minZ, and maxZ
void	setShowTickMarks(boolean b) Activates (true value) display of tick marks.
void	setSphereDivisions(int i) Specifies the number of divisions to be used with basic drawSphere() methods.
void	setStart() Sets the default (0) initially displayed view number in a sequence of views.
void	setStart(int num) Sets the initially displayed view number in a sequence of views.
void	setTexture(javafx.scene.image.Image image) Sets the default Texture value.
void	setVectorRadius(double d) Specifies the radius (pixels) to be used with basic drawVector() methods.
void	setXYaxesOnly(boolean b) Activates (true value) display of coordinate axes with the positive Y axis pointing up and no Z axis displayed.
void	setXYZRange(double minmaxX, double minmaxY, double minmaxZ) Sets the user coordinate range for x, y, and z dimensions.
void	setYaxisUp(boolean b) Activates (true value) display of coordinate axes with the positive Y axis pointing up.
void	setZaxisUp(boolean b) Activates (true value) display of coordinate axes with the positive Z axis pointing up.
void	start(javafx.stage.Stage stage)
double	uX(double xs) Converts an x value in screen coordinate space to user space.

Methods inherited from class javafx.application.Application

getHostServices, getParameters, getUserAgentStylesheet, init, launch, launch, notifyPreloader, setUserAgentStylesheet, stop

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Draw3D

public Draw3D()

Method Detail

start

public void start(javafx.stage.Stage stage)
           throws java.lang.Exception

Specified by:

start in class javafx.application.Application

Throws:

java.lang.Exception

buildScene

public javafx.scene.Scene buildScene()

Builds the Scene for display and use by Draw3D methods. By default the origin of the user space is located at the center of the display space

Returns:

scene Contains all of the groups and objects required for use of Draw3D methods.

buildSubScene

public void buildSubScene()

Builds the SubScene, creates the data structures and groups required for Draw3D, and initializes to default state per the settings in Draw3DDefaults.

drawGrid

public void drawGrid(int sector,
                     int div,
                     javafx.scene.paint.PhongMaterial m)

Draws grid lines in the user coordinate space.

Parameters:

sector - int code indicating the grid sector to draw 0 - grid lines across all sectors 1 - +X, +Y, +Z sector 2 - +X, -Y, +Z sector 3 - -X, -Y, +Z sector 4 - -X, +Y, +Z sector 5 - +X, +Y, -Z sector 6 - +X, -Y, -Z sector 7 - -X, -Y, -Z sector 8 - -X, +Y, -Z sector

div - int specification of the number of divisions of the grid space

m - PhongMaterial value determining the color of the boundary line

setScale

public void setScale(double scaleX,
                     double scaleY,
                     double scaleZ)

Sets the scale associated with a view.

Parameters:

scaleX - Scale value for x coordinate.

scaleY - Scale value for y coordinate.

scaleZ - Scale value for z coordinate.

setCamera

public void setCamera(double x,
                      double y,
                      double z)

Sets the camera location associated with a view.

Parameters:

x - Camera angle relative to the x axis in screen coordinate space

y - Camera angle relative to the y axis in screen coordinate space

z - Camera distance on the z axis in screen coordinate space (pixels) Negative toward the viewer and positive going into the screen.

setOriginView

public void setOriginView(int x,
                          int y,
                          int z)

Sets the default origin (center) x, y, z coordinates in screen space (pixels). Each view in a sequence may have a different default origin. The general default is: DEFAULT_ORIGIN. Dynamic user changes to the view origin using the arrow keys do NOT change the default origin settings associated with a view.

Parameters:

x - int value for the origin (center) x coordinate in pixels

y - int value for the origin (center) y coordinate in pixels

z - int value for the origin (center) z coordinate in pixels

setXYZRange

public void setXYZRange(double minmaxX,
                        double minmaxY,
                        double minmaxZ)

Sets the user coordinate range for x, y, and z dimensions. Each dimension can be different. For each dimension, the minimum and maximum must have the same absolute value. Each view in a sequence may have a different range.

Parameters:

minmaxX - Double minimum and maximum value for the x dimension

minmaxY - Double minimum and maximum value for the y dimension

minmaxZ - Double minimum and maximum value for the z dimension

getXMinMax

public double getXMinMax()

Gets the current minimum/maximum value for the X coordinate in user space.

Returns:

maxX double current minimum/maximum value for the X coordinate

getYMinMax

public double getYMinMax()

Gets the current minimum/maximum value for the Y coordinate in user space.

Returns:

maxY double current minimum/maximum value for the Y coordinate

getZMinMax

public double getZMinMax()

Gets the current minimum/maximum value for the Z coordinate in user space.

Returns:

maxZ double current minimum/maximum value for the Z coordinate

buildTest

public void buildTest()

Draws a test set of eight vectors, one in each quadrant of the user coordinate space.

setDefaults

public void setDefaults()

Set defaults: -View settings -Origin -Scale -XYZ Range -Camera position -Drawing settings

setAmbientLight

public void setAmbientLight(boolean b)

Activates (true value) ambient light for a view.

Parameters:

b - boolean value that for true turns on ambient light and for false turns it off

setPointLight

public void setPointLight(boolean b)

Activates (true value) point lights for a view. Two point light sources are used: - one near the point forward, slightly to the left and above center - the other point to the back, slightly to the right, and below center

Parameters:

b - boolean value that for true turns on point lights and for false turns then off

setStart

public void setStart()

Sets the default (0) initially displayed view number in a sequence of views.

setStart

public void setStart(int num)

Sets the initially displayed view number in a sequence of views.

Parameters:

num - Integer number of the initially displayed view

setShowAxes

public void setShowAxes(boolean b)

Activates (true value) display of axes.

Parameters:

b - boolean value that for true turns on axes display and for false turns axes display off

setShowTickMarks

public void setShowTickMarks(boolean b)

Activates (true value) display of tick marks.

Parameters:

b - boolean value that for true turns on tick mark display and for false turns tick mark display off

setYaxisUp

public void setYaxisUp(boolean b)

Activates (true value) display of coordinate axes with the positive Y axis pointing up. Changing axes orientation does not change shapes which are defined independent of the displayed axes orientation. Axes orientation change does alter shape location and rotations whether done by invoking the setYaxisUp method or by selecting the orientation on the View Menu. Changing orientation using the View Menu does not adjust Label rotations.

Parameters:

b - boolean value that for true turns on axes display with Y up and for false sets axes display to Z up

setXYaxesOnly

public void setXYaxesOnly(boolean b)

Activates (true value) display of coordinate axes with the positive Y axis pointing up and no Z axis displayed. Shape parameters still require x, y, and z specification. Changing axes orientation does not change shapes which are defined independent of the displayed axes orientation. Axes orientation change does alter shape location and rotations whether done by invoking the setYaxisUp method or by selecting the orientation on the View Menu. Changing orientation using the View Menu does not adjust Label rotations.

Parameters:

b - boolean value that for true turns on axes display with Y up and for false sets axes display to Z up

setZaxisUp

public void setZaxisUp(boolean b)

Activates (true value) display of coordinate axes with the positive Z axis pointing up. Changing axes orientation does not change shapes which are defined independent of the displayed axes orientation. Axes orientation change does alter shape location and rotations whether done by invoking the setYaxisUp method or by selecting the orientation on the View Menu. Changing orientation using the View Menu does not adjust Label rotations.

Parameters:

b - boolean value that for true turns on axes display with Z up and for false sets axes display to Y up

setShowBoundaryCube

public void setShowBoundaryCube(boolean b)

Activates (true value) display of the boundary cube determined by the current values of minX, maxX, minY, maxY, minZ, and maxZ

Parameters:

b - boolean value that for true turns on boundary cube display and false turns it off

setPointSize

public void setPointSize(double d)

Specifies the radius (pixels) to be used with basic drawPoint() methods.

Parameters:

d - radius in pixels of point objects

setLineRadius

public void setLineRadius(double d)

Specifies the radius (pixels) to be used with basic drawLine() methods.

Parameters:

d - radius in pixels of line objects

setArrowRadius

public void setArrowRadius(double d)

Specifies the radius (pixels) to be used with basic drawArrow() methods.

Parameters:

d - radius in pixels of arrow objects

setVectorRadius

public void setVectorRadius(double d)

Specifies the radius (pixels) to be used with basic drawVector() methods.

Parameters:

d - radius in pixels of vector objects

setConeDivisions

public void setConeDivisions(int i)

Specifies the number of divisions to be used with basic drawCone() methods.

Parameters:

i - Number of divisions to be used in drawing cones

setCylinderDivisions

public void setCylinderDivisions(int i)

Specifies the number of divisions to be used with basic drawCylinder() methods.

Parameters:

i - Number of divisions to be used in drawing cylinders

setOvalDivisions

public void setOvalDivisions(int i)

Specifies the number of divisions to be used with basic drawOval() methods.

Parameters:

i - Number of divisions to be used in drawing ovals

setSphereDivisions

public void setSphereDivisions(int i)

Specifies the number of divisions to be used with basic drawSphere() methods.

Parameters:

i - Number of divisions to be used in drawing spheres

setBackgroundColor

public void setBackgroundColor(javafx.scene.paint.Color c)

Sets the scene Background Color.

Parameters:

c - Color specification for background color

setCullFace

public void setCullFace(javafx.scene.shape.CullFace cf)

Sets the default CullFace value.

Parameters:

cf - default CullFace value

setDrawMode

public void setDrawMode(javafx.scene.shape.DrawMode dm)

Sets the default DrawMode value.

Parameters:

dm - default DrawMode value

setDrawColor

public void setDrawColor(javafx.scene.paint.Color c1)

Creates a new default PhongMaterial object (drawMaterial) to be used in drawing all objects and sets the default diffuse color.

Parameters:

c1 - default PhongMaterial (drawMaterial) Diffuse Color is set to this value.

setDrawColor

public void setDrawColor(javafx.scene.paint.Color c1,
                         javafx.scene.paint.Color c2)

Creates a new default PhongMaterial object (drawMaterial) to be used in drawing all objects and sets the default diffuse and specular colors.

Parameters:

c1 - default PhongMaterial (drawMaterial) Diffuse Color is set to this value.

c2 - default PhongMaterial (drawMaterial) Specular Color is set to this value.

setLabelFontSize

public void setLabelFontSize(double d)

Sets the default Label font to "Regular" with specified size.

Parameters:

d - font size

setLabelFont

public void setLabelFont(javafx.scene.text.Font f)

Sets the default Label font and size.

Parameters:

f - specifies default Label font with format: Font.font("name", size)

setMaterial

public void setMaterial(javafx.scene.paint.PhongMaterial m)

Sets the default PhongMaterial value. The PhongMaterial diffuse.color and specular.color (if defined) values will be used by default

Parameters:

m - PhongMaterial

setTexture

public void setTexture(javafx.scene.image.Image image)

Sets the default Texture value. The specified Texture value will be used by default

Parameters:

image - Image texture to be applied

setSequencingOn

public void setSequencingOn()

Indicates the beginning of a sequence of views with associated data objects. This method is now redundant. Sequencing is always on by default.

incrSequence

public void incrSequence()

Initiates a new view and makes it immediately visible while making the previous view invisible in a sequence of views with associated data objects. This enables automatically saving scene/subscene contents to a file during initial creation.

setCumulate

public void setCumulate(boolean b)

Activates (true value) overlay of subsequent views in the sequence of displays.

Parameters:

b - boolean value indicating cumulation of views is on (true) or off (false)

uX

public double uX(double xs)

Converts an x value in screen coordinate space to user space.

Parameters:

xs - x value to be converted

Returns:

x coordinate value in user space

dX

public double dX(double xu)

Converts x coordinate value from user to screen coordinate space.

Parameters:

xu - x coordinate to be converted

Returns:

x coordinate value in screen coordinate space

dY

public double dY(double yu)

Converts y coordinate value from user to screen coordinate space.

Parameters:

yu - y coordinate to be converted

Returns:

y coordinate value in screen coordinate space

dZ

public double dZ(double zu)

Converts z coordinate value from user to screen coordinate space.

Parameters:

zu - z coordinate to be converted

Returns:

z coordinate value in screen coordinate space

drawArrow

public void drawArrow(double x1,
                      double y1,
                      double z1,
                      double x2,
                      double y2,
                      double z2)

Constructs an Arrow3D object with specified start and end points and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x1 - defines start point x coordinate

y1 - defines start point y coordinate

z1 - defines start point z coordinate

x2 - defines end point x coordinate

y2 - defines end point y coordinate

z2 - defines end point z coordinate

drawArrow3D

public void drawArrow3D(Arrow3D a3d)

Draws an Arrow3D object.

Parameters:

a3d - specifies an Arrow3D object with start point, end point, x-rotation, y-rotation, z-rotation and drawing parameters.

drawBezier

public void drawBezier(javafx.geometry.Point3D[] p)

Draws a Bezier curve defined by the specified array of control points. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

p - Point3D[] array of control points defining the curve

drawBox3D

public void drawBox3D(Box3D b3d)

Draws a Box3D object.

Parameters:

b3d - specifies a Box3D object with center point, width, height, and depth, x-rotation, y-rotation, z-rotation and drawing parameters.

drawBox3D

public void drawBox3D(Box3D b3d,
                      boolean showEdges)

Draws a Box3D object, optionally with edges highlighted.

Parameters:

b3d - specifies a Box3D object with center point, width, height, and depth, x-rotation, y-rotation, z-rotation and drawing parameters.

showEdges - boolean value indicating whether to show edges or not

drawBoxEdges3D

public void drawBoxEdges3D(Box3D b3d)

Draws the edges of Box3D

Parameters:

b3d - specifies a BOX3D object with center point, size, x-rotation, y-rotation, z-rotation and drawing parameters.

drawCircle

public void drawCircle(double x,
                       double y,
                       double z,
                       double r)

Constructs a circle object (JavaFX Cylinder w/ height .1) with specified center point and radius and draws it. Rotations default to zero. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

drawCircle

public void drawCircle(double x,
                       double y,
                       double z,
                       double r,
                       double rx,
                       double ry,
                       double rz)

Constructs a circle object (JavaFX Cylinder w/ height .1) with specified center point, radius, and x-rotation, y-rotation, z-rotation and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

rx - x-rotation

ry - y-rotation

rz - z-rotation

drawCone

public void drawCone(double x,
                     double y,
                     double z,
                     double r,
                     double h)

Constructs a Cone3D object with point at specified coordinates, radius, and height and draws it. Rotations default to zero. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

h - specifies height

drawCone

public void drawCone(double x,
                     double y,
                     double z,
                     double r,
                     double h,
                     double rx,
                     double ry,
                     double rz)

Constructs a Cone3D object with point at specified coordinates, radius, height, and xyz rotations and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

h - height

rx - x-rotation

ry - y-rotation

rz - z-rotation

drawCone3D

public void drawCone3D(Cone3D c3d)

Draws a Cone3D object.

Parameters:

c3d - specifies a Cone3D object with tip point, radius, height, x-rotation, y-rotation, z-rotation and drawing parameters.

drawCuboid

public void drawCuboid(double x,
                       double y,
                       double z,
                       double width,
                       double height,
                       double depth)

Constructs a Box3D object with specified center point, width, height, and depth and draws it. Rotations default to zero. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

width - specifies width

height - specifies height

depth - specifies depth

drawCuboid

public void drawCuboid(double x,
                       double y,
                       double z,
                       double width,
                       double height,
                       double depth,
                       double rx,
                       double ry,
                       double rz)

Constructs a Box3D object with specified center point, width, height, depth, and x-rotation, y-rotation, z-rotation and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

width - specifies width

height - specifies height

depth - specifies depth

rx - x-rotation

ry - y-rotation

rz - z-rotation

drawCylinder

public void drawCylinder(double x,
                         double y,
                         double z,
                         double r,
                         double h)

Constructs a Cylinder3D object with specified center point, radius, and height and draws it. Rotations default to zero. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

h - specifies height

drawCylinder

public void drawCylinder(double x,
                         double y,
                         double z,
                         double r,
                         double h,
                         double rx,
                         double ry,
                         double rz)

Constructs a Cylinder3D object with specified center point, radius, height, x-rotation, y-rotation, z-rotation and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

h - specifies height

rx - specifies x-rotation

ry - specifies y-rotation

rz - specifies z-rotation

drawCylinder3D

public void drawCylinder3D(Cylinder3D c3d)

Draws a Cylinder3D object.

Parameters:

c3d - specifies a Cylinder3D object with center point, radius, height, x-rotation, y-rotation, z-rotation and drawing parameters.

drawDrone3D

public void drawDrone3D(Drone3D d3d)

Draws a Drone3D object.

Parameters:

d3d - specifies a Drone3D object with xyz location, xyz rotations, and drawing parameters.

drawDrone3D

public void drawDrone3D(int view,
                        Drone3D d3d)

Draws a Drone3D object.

Parameters:

view - specifies the view number to use for drawing

d3d - specifies a Drone3D object with xyz location, xyz rotations, and drawing parameters.

drawLabel

public void drawLabel(double x,
                      double y,
                      double z,
                      java.lang.String s)

Constructs a Text3D object and draws it with center at xyz location. If Z axis is up, the label is rotated 180 degrees about the y axis, else it is rotated 180 degrees about the x axis. The current value of drawMaterial determines the color. The current value of labelFont determines the font and font size.

Parameters:

x - x coordinate of the center of the Text label

y - y coordinate of the center of the Text label

z - z coordinate of the center of the Text label

s - String contents of the label

drawLabel

public void drawLabel(double x,
                      double y,
                      double z,
                      java.lang.String s,
                      javafx.scene.text.Font f,
                      javafx.scene.paint.Color c)

Constructs a Text3D object and draws it with center at xyz location with the specified color and size. If Z axis is up, the label is rotated 180 degrees about the y axis, else it is rotated 180 degrees about the x axis.

Parameters:

x - x coordinate of the center of the Text label

y - y coordinate of the center of the Text label

z - z coordinate of the center of the Text label

s - String contents of the label

f - Font for the label

c - Color for the label

drawLabel

public void drawLabel(double x,
                      double y,
                      double z,
                      double rx,
                      double ry,
                      double rz,
                      java.lang.String s)

Constructs a Text3D object and draws it with center at xyz location and xyz rotation specifications. The current value of drawMaterial determines the color. The current value of labelFont determines the font and font size.

Parameters:

x - x coordinate of the center of the Text label

y - y coordinate of the center of the Text label

z - z coordinate of the center of the Text label

rx - degrees of rotation about the x axis

ry - degrees of rotation about the y axis

rz - degrees of rotation about the z axis

s - String contents of the label

drawLabel

public void drawLabel(double x,
                      double y,
                      double z,
                      double rx,
                      double ry,
                      double rz,
                      java.lang.String s,
                      javafx.scene.text.Font f,
                      javafx.scene.paint.Color c)

Constructs a Text3D object and draws it with center at xyz location and xyz rotation with the specified color and size.

Parameters:

x - x coordinate of the center of the Text label

y - y coordinate of the center of the Text label

z - z coordinate of the center of the Text label

rx - degrees of rotation about the x axis

ry - degrees of rotation about the y axis

rz - degrees of rotation about the z axis

s - String contents of the label

f - Font for the label

c - Color for the label

drawLabel3D

public void drawLabel3D(Text3D t3d)

Draws a Text3D object according to its xyz location, xyz rotation, String contents, with default or object specific font and color specifications.

Parameters:

t3d - Text3D object to be drawn

drawLine

public void drawLine(double x1,
                     double y1,
                     double z1,
                     double x2,
                     double y2,
                     double z2)

Constructs a line object with specified start and end points and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x1 - defines start point x coordinate

y1 - defines start point y coordinate

z1 - defines start point z coordinate

x2 - defines end point x coordinate

y2 - defines end point y coordinate

z2 - defines end point z coordinate Uses value lineRadius for radius of line Uses value drawMaterial for drawing color

drawLine3D

public void drawLine3D(Line3D ln)

Draws a Line3D object.

Parameters:

ln - specifies a Line3D object with start point, end point, drawing parameters.

drawLine3DSet

public void drawLine3DSet(Line3D[] ln)

Draws a set of Line3D line segments with specified color

Parameters:

ln - Array of Line3D object to be drawn

drawLineEquation

public void drawLineEquation(double a1,
                             double a2,
                             double a3,
                             double b1,
                             double b2,
                             double b3)

Constructs a Line3D object given the symmetric line equation coefficients, finds the intersection points with the current boundary of the user coordinate space, and draws the line between the intersection points. Symmetric line equation: (x-a1)/b1 = (y-a2)/b2 = (z-a3)/b3, b1!=0, b2!=0, b3!=0

Parameters:

a1 - a1 coordinate of Cartesian line equation

a2 - a2 coordinate of Cartesian line equation

a3 - a3 coordinate of Cartesian line equation

b1 - b1 coordinate of Cartesian line equation

b2 - b2 coordinate of Cartesian line equation

b3 - b3 coordinate of Cartesian line equation

drawMesh3D

public void drawMesh3D(Mesh3D m3d)

Draws a variable Mesh3D object. (Under construction)

Parameters:

m3d - specifies a Mesh3D object with location point, x-rotation, y-rotation, z-rotation and drawing parameters.

drawOval

public void drawOval(double xi,
                     double yi,
                     double zi,
                     double a,
                     double b)

Constructs an oval object with specified center points, major radius, minor radius, and drawing parameters and draws it. Rotations default to zero. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

xi - specifies center point x coordinate

yi - specifies center point y coordinate

zi - specifies center point z coordinate

a - specifies major radius

b - specifies minor radius

drawOval

public void drawOval(double xi,
                     double yi,
                     double zi,
                     double a,
                     double b,
                     double rx,
                     double ry,
                     double rz)

Constructs an Oval3D object with specified center points, major radius, minor radius, x-rotation, y-rotation, z-rotation and draws it. The object is drawn with the color specified by drawMaterial as determined by setDrawColor().

Parameters:

xi - specifies center point x coordinate

yi - specifies center point y coordinate

zi - specifies center point z coordinate

a - specifies major radius

b - specifies minor radius

rx - x-rotation

ry - y-rotation

rz - z-rotation

drawOval3D

public void drawOval3D(Oval3D o3d)

Draws an Oval3D object.

Parameters:

o3d - specifies an Oval3D object with center point, major radius, minor radius, x-rotation, y-rotation, z-rotation and drawing parameters.

drawPlane

public void drawPlane(double a,
                      double b,
                      double c,
                      double d)

Constructs a plane object with specified plane equation coordinates and draws it. The general equation of a plane is ax + by + cz + d = 0. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

a - x coefficient of plane equation

b - y coefficient of plane equation

c - z coefficient of plane equation

d - coefficient of equation

drawPlane

public void drawPlane(double x1,
                      double y1,
                      double z1,
                      double x2,
                      double y2,
                      double z2,
                      double x3,
                      double y3,
                      double z3)

Constructs a plane object using specification of three points in the plane and draws it. The general equation of a plane is ax + by + cz + d = 0. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x1 - point 1 x coordinate

y1 - point 1 y coordinate

z1 - point 1 z coordinate

x2 - point 2 x coordinate

y2 - point 2 y coordinate

z2 - point 2 z coordinate

x3 - point 3 x coordinate

y3 - point 3 y coordinate

z3 - point 3 z coordinate

drawPlane3D

public void drawPlane3D(Plane3D pl)

Draws a plane object terminated at the bounding box defined by minmaxX, minmaxY, minmaxZ.

Parameters:

pl - specifies a plane object with drawing parameters.

drawPlanePoints

public void drawPlanePoints(Plane3D pl)

Displays a series of points lying in the specified Plane.

Parameters:

pl - Plane3D object defining a Plane

drawPoint

public void drawPoint(double x,
                      double y,
                      double z)

Constructs a Sphere3D object corresponding to the point using the coordinates specified as its center and with radius of size pointSize (in pixels). Pointsize is converted to user coordinates before calling drawSphere3D. The object is drawn with the color specified by drawMaterial.

Parameters:

x - y coordinate of point

y - y coordinate of point

z - z coordinate of point

drawPoint3D

public void drawPoint3D(javafx.geometry.Point3D p)

Constructs a Sphere3D object corresponding to the coordinates of the Point3D specified as its center and with radius of size pointSize (in pixels). Pointsize is converted to user coordinates before calling drawSphere3D. The object is drawn with the color specified by drawMaterial.

Parameters:

p - Point3D specifying point location

drawPoint3DSet

public void drawPoint3DSet(javafx.geometry.Point3D[] p)

Draws a set of points with specified color.

Parameters:

p - Point3D[] array specifying point locations

drawPolygon

public void drawPolygon(javafx.geometry.Point3D[] v)

Constructs a polygon object using the Point3D array of vertices and draws it. The object is drawn with the color specified by drawMaterial = setDrawColor().

Parameters:

v - Point3D array containing polygon vertices in counter clockwise order

drawPolygon

public void drawPolygon(javafx.geometry.Point3D[] v,
                        boolean drawEdges,
                        boolean drawVertices,
                        boolean drawVertexLabels)

Constructs a polygon object using the Point3D array of vertices and draws it. The object is drawn with the color specified by drawMaterial = setDrawColor(). Specified flags indicate whether to draw with edges, vertices, and or vertex labels.

Parameters:

v - Point3D array containing polygon vertices in counter clockwise order

drawEdges - Boolean flag indicating whether to draw edges

drawVertices - Boolean flag indicating whether to draw vertices

drawVertexLabels - Boolean flag indicating whether to draw vertex labels

drawPolygon3D

public void drawPolygon3D(Polygon3D p3d)

Draws the polygon object specified.

Parameters:

p3d - Polygon3D object to be drawn

drawPolyhedron3D

public void drawPolyhedron3D(org.edisonwj.draw3d.Polyhedron3D p3d)

Draws a Polyhedron3D object.

Parameters:

p3d - specifies a Polyhedron3D object with center point, size, x-rotation, y-rotation, z-rotation and drawing parameters.

drawPolyhedron3D

public void drawPolyhedron3D(org.edisonwj.draw3d.Polyhedron3D p3d,
                             boolean showEdges)

Draws a Polyhedron3D object.

Parameters:

p3d - specifies a Polyahedron3D object with center point, size, x-rotation, y-rotation, z-rotation and drawing parameters.

showEdges - Boolean value indicating whether to show the Polyhedron edges (true) or not (false).

drawPolyhedronEdges3D

public void drawPolyhedronEdges3D(org.edisonwj.draw3d.Polyhedron3D p3d)

Draws the edges of a Polyhedron3D object

Parameters:

p3d - specifies a Polyhedron3D object with center point, size, x-rotation, y-rotation, z-rotation and drawing parameters.

drawPolyLine3D

public void drawPolyLine3D(javafx.geometry.Point3D[] p)

Draws a polyline as specified by the parameter array of points.

Parameters:

p - Point3D{} array of points defining successive line segments to be displayed

drawRectangle

public void drawRectangle(double x,
                          double y,
                          double z,
                          double w,
                          double h)

Constructs a rectangle object with specified center point, width, and height, and draws it. Rotations default to zero. The object is drawn with the color specified by drawMaterial = setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

w - specifies width

h - height

drawRectangle

public void drawRectangle(double x,
                          double y,
                          double z,
                          double w,
                          double h,
                          double rx,
                          double ry,
                          double rz)

Constructs a rectangle object with specified center point, width, height, x rotation, y rotation, and z rotation and draws it. The object is drawn with the color specified by drawMaterial = setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

w - specifies width

h - height

rx - x-rotation

ry - y-rotation

rz - z-rotation

drawRectangle3D

public void drawRectangle3D(Rectangle3D r)

Draws the rectangle object specified.

Parameters:

r - Rectangle3D object to be drawn

drawSphere

public void drawSphere(double x,
                       double y,
                       double z,
                       double r)

Constructs a Sphere3D object with specified center point and radius and draws it. The object is drawn with the color specified by drawMaterial = setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

r - specifies radius

drawSphere3D

public void drawSphere3D(Sphere3D s3d)

Draws the Sphere3D object specified.

Parameters:

s3d - Sphere3D object to be drawn

drawSphere3DSet

public void drawSphere3DSet(Sphere3D[] ss)

Draws a set of Sphere3D objects

Parameters:

ss - Array of Sphere3D objects to be drawn

drawSquare

public void drawSquare(double x,
                       double y,
                       double z,
                       double ln)

Constructs a square object (Rectangle3D) with specified center point and side length and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

ln - specifies side length

drawSquare

public void drawSquare(double x,
                       double y,
                       double z,
                       double ln,
                       double rx,
                       double ry,
                       double rz)

Constructs a square object (Rectangle3D) with specified center point, side length, x-rotation, y-rotation, z-rotation and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies center point x coordinate

y - specifies center point y coordinate

z - specifies center point z coordinate

ln - specifies side length

rx - x-rotation

ry - y-rotation

rz - z-rotation

drawTriangle3D

public void drawTriangle3D(Triangle3D t3d)

Draws a Triangle3D object.

Parameters:

t3d - specifies a Triangle3D object with vertices and drawing parameters.

drawVector

public void drawVector(double[] v)

Constructs a Vector3D object with specified end points and draws it. The object is drawn with the color specified by drawMaterial = setDrawColor().

Parameters:

v - specifies double[3] array containing x, y, z coordinates of vector end point

drawVector

public void drawVector(double x,
                       double y,
                       double z)

Constructs a Vector3D object with specified end point and draws it. The object is drawn with the color specified by drawMaterial as set by setDrawColor().

Parameters:

x - specifies vector end point x coordinate

y - specifies vector end point y coordinate

z - specifies vector end point z coordinate

drawVector3D

public void drawVector3D(Vector3D vc)

Draws the Vector3D object specified.

Parameters:

vc - Vector3D object to be drawn with Cartesian coordinates

drawVector3DSet

public void drawVector3DSet(Vector3D[] v)

Draws a set of Vector3D objects as specified in the parameter array.

Parameters:

v - Vector3D{} array of Vector3D objects

openFile

public void openFile(java.lang.String pathName,
                     java.lang.String fileName)

Opens the specified file using the default application for its extension.

Parameters:

pathName - String specification of file path

fileName - String specification of file name

openFile

public void openFile(java.lang.String fileName)

Opens the specified file using the default application for its extension.

Parameters:

fileName - String specification of file name in current working directory (or Resources directory if present)

loadData

public void loadData(java.lang.String pathName,
                     java.lang.String fileName)

Loads the specified data file.

Parameters:

pathName - String specification of the full file path

fileName - String specification of file name

loadData

public void loadData(java.lang.String fileName)

Loads the specified data file.

Parameters:

fileName - String specification of file name in current working directory (or Resources directory if present)

loadAlgorithm

public Algorithm loadAlgorithm(java.lang.String className)

Loads the specified Algorithm class.

Parameters:

className - String name of the Algorithm class file to be executed

Returns:

algorithm Returns loaded Algorithm class object

saveScene

public void saveScene(java.lang.String format,
                      java.lang.String pathName,
                      java.lang.String fileName)

Saves the current scene with the specified format to the specified file.

Parameters:

format - String "bmp", "jpg", "png", "gif"

pathName - String specification of file path

fileName - String specification of file name

saveScene

public void saveScene(java.lang.String format,
                      java.lang.String fileName)

Saves the current scene with the specified format to the specified file.

Parameters:

format - String "bmp", "jpg", "png", "gif"

fileName - String specification of file name in current working directory (or Resources directory if present)

saveSubScene

public void saveSubScene(java.lang.String format,
                         java.lang.String pathName,
                         java.lang.String fileName)

Saves the current subScene with the specified format to the specified file.

Parameters:

format - String "bmp", "jpg", "png", "gif"

pathName - String specification of file path

fileName - String specification of file name

saveSubScene

public void saveSubScene(java.lang.String format,
                         java.lang.String fileName)

Saves the current subScene with the specified format to the specified file.

Parameters:

format - String "bmp", "jpg", "png", "gif"

fileName - String specification of file name in current working directory (or Resources directory if present)

saveData

public void saveData(java.lang.String pathName,
                     java.lang.String fileName)

Saves current view data to the specified data file.

Parameters:

pathName - String specification of file path

fileName - String specification of file name

saveData

public void saveData(java.lang.String fileName)

Saves current view data to the specified data file.

Parameters:

fileName - String specification of file name in current working directory (or Resources directory if present)

rotateLine3D

public Line3D rotateLine3D(Line3D ln,
                           double rxd,
                           double ryd,
                           double rzd)

Computes a new Line3D object with start and end coordinates transformed by rotations on each axis about the origin. Intended for rotating edges of objects with center at the origin.

Parameters:

ln - Line to be rotated

rxd - Rotation with respect to x axis

ryd - Rotation with respect to y axis

rzd - Rotation with respect to z axis

Returns:

Rotated line

main

public static void main(java.lang.String[] args)