3D Plotting

The drawing attribute commands include:

Translate 2D 3D, Draw Cube Front 3D, Draw Cube Back 3D, Draw Surface 3D, View 3D, Data Window 3D, Light_Source 3D, Data Viewport 3D, Model 3D, Draw Cube 3D, and Data Line 3D.

Translate 2D 3D

This command enables the translation of 2D objects onto a 3D plane.

For example, setting it to 0 means that if you issued a Overlay_Rangs() cmd, you would get a map projected through the 3D data window/viewport. Setting it back to 0, would result in a normal map projected through the 2D data window/viewport.

Parameter:

1 - enable 3d translation.

or

0 - disable 3d translation.

Translate_2d_3d(1);

initial program state - disabled

Draw Cube Front 3D

This command draws the front of a 3D cube bounding the current 3D window.

Draw_Cube_Front_3D();

Draw Cube Back 3D

This command draws the back of a 3D cube bounding the current 3D window.

Draw_Cube_Back_3D();

Draw Surface 3D

This command draws a 3D surface representation of the Delaunay triangulated data surface within the current 3D window.

Parameters:

xyz matrix - a matrix containing the x, y, and z data as 3 columns.

or

x, y, and z vectors- 3 vectors containing the data to be plotted.

Draw_Surface_3D(xyz matrix);
Draw_Surface_3D(x vector, y vector, z vector);

Draw_Surface_3D(xyz);

View 3D

This command specifies the viewing positon of the 3D data surface. The position of the viewer in terms of (your) x position, y position, z position, and (perspective) distance from the center of the cube to be viewed are specified.

There are 4 parameters:

x position - x axis position of the viewer in relation to the 3D viewport.

y position - y axis position of the viewer in relation to the 3D viewport.

z position - z axis position of the viewer in relation to the 3D viewport.

perspective distance - the viewing distance from the center of the cube.

View_3D(x position NDC´s, y position NDC´s, z position NDC´s, perspective distance NDC´s);

View_3D(mm(200),mm(500),mm(600),mm(1000));

initial program state - undefined

Data Window 3D

This command specifies the limits of the 3D data surface in user coordinates. The minimum and maximum for the x, y, and z axes are specified.

There are 6 parameters:

x min - the minimum x value in users units (left edge)

x max - the maximum x value in users units (right edge)

y min - the minimum y value in users units (front edge)

y max - the maximum y value in users units (back edge)

zmin - the minimum z value in users units (bottom edge)

zmax - the maximum z value in users units (top edge)

Data_Window_3D(x min, x max, y min, y max, z min, z max);

Data_Window_3D(-67.5,-60,40,45,0,2000);

initial program state - undefined

Light Source 3D

This command specifies the light source for illumination of the 3D data surface. The x position of the light source, y position, z position, brightness of the light source, default background brightness, reflectivity of the surface, refractive index of the surface, and the glossyness of the surface are specified.

There are 9 parameters:

x position - x axis position of the light source in NDC units.

y position - y axis position of the light source in NDC units.

z position - z axis position of the light source in NDC units.

brightness - the relative brightness of the light source (0-1).

background brightness - the relative brightness of the backgroun illumination (0-1).

reflection - the relative brightness of the light source (0-1).

refraction - the relative refractive index of the surface (0-1).

gloss - the relative glossiness of the surface (0-1).

Light_Source_3D(x position NDC´s, y position NDC´s, z position NDC´s, brightness, background brightness, reflection, refraction,gloss);

Light_Source_3D(mm(200),mm(500),mm(600),2,0.2,0.1,0.1,0.1);

initial program state - light source parameters are undefinded

Data Viewport 3D

This command specifies the limits of the 3D data surface on the page in page coordinates. The x axis page minimum, x axis page maximum, y axis page minimum, y axis page maximum, z axis pseudo page minimum , and the z axis pseudo page maximum are specified. The z axis pseudo page minimum , and the z axis pseudo page maximum are used to scale the viewport box height to width ratio.

There are 6 parameters:

x min - the minimum x position in NDC units (left edge).

y min - the minimum y position in NDC units (front edge)..

y max - the maximum y position in NDC units (back edge)..

z min - the minimum y position in NDC units (bottom edge)..

z max - the maximum y position in NDC units (top edge)..

Data_Viewport_3D(x position NDC´s, x position NDC´s, y position NDC´s, y position NDC´s, z position NDC´s, z position NDC´s);

Data_Viewport_3D(mm(50),mm(150),mm(170),mm(270),mm(0),mm(75));

initial program state - light source parameters are undefined

Model 3D

This command specifies the drawing model to be used to render the 3D data surface. The contour shading flag, and the light source flag are specified. If contour shading is disabled, a uniformly shaded white surface is drawn. The surface is created using the delaunay triangulated surface. The borders of the delaunay triangles are stroked. When contour shading is enabled, the data contour shading defined using the Data_Contour_Levels() command is used to colour the delaunay surface. When the light source is enabled, the surface is rendered including the effects of a single light source on the surface.

There are 2 parameters:

contour shading- contour shading flag (0= white suface, 1 = surface has contour level shading). light model - light source flag (0 - no light source effect, 1 - light source model used).

Model_3D(contour shading,light model);

Model_3D(0,0);

initial program state - model parameters are undefinded

Draw Cube 3D

This command draws the data as a 3D hidden surface using delanay triangulation and draws a unit cube around the surface.

Parameters:

xyz matrix - a matrix containing the x, y, and z data as 3 columns.

or

x, y, and z vectors- 3 vectors containing the data to be plotted.

Draw_Cube_3D(xyz matrix);
Draw_Cube_3D(x vector, y vector, z vector);

Draw_Cube_3D(xyz);

Data Line 3D

This command draws a 3D line between the data pointsin their order of occurance.

Parameters:

xyz(p) matrix - a matrix containing the x, y, and z data as 3 columns (optional 4th column may contain pen up 0, pen down 1 flags).

or

x, y, and z vectors- 3 vectors containing the data to be plotted (with an optional 4th vector).

Data_Line_3D(xyzp matrix);
Data_Line_3D(x vector, y vector, z vector);

Data_Line_3D(mat);