Plane()

Plots a diffusively-lit coloured plane in a three dimensional window

PLANE/DRAW vertices=Realarray table=Colourtable [transparency=Integer] [eye=Realarray] [light=Realarray] Plots a plane in a 3d window.
PLANE/ALTER [table=Colourtable] [transparency=Integer] [eye=Realarray] [light=Realarray] object=Gobject Alters a previously drawn plane.

example:

	#Plot a non transparent plane
	>> p=Plane:draw(vertices,table)
	#Alter the transparency of the plane
	>> Plane/alter transparency=25 object=p

Plane/Draw

Plots a diffusively-lit, optionaly semi-transparent coloured plane in a 3d window. All the verticies must lie in a flat plane, and the bounding polygon should be convex (so that the angle at any vertex <= 180 degres). All (x,y,z) values are taken to be given in world coordinates.

Parameters:

vertices (Realarray)

(x,y,z) coordinates of the vertices. The array should be allocated by DIMENSIONS(NV,3), where NV is the number of vertices.

table (Colourtable)

The colour table to be used, see ColourTable for details.

transparency (Integer)

The level of transparency expressed as a percentage. By default this is zero.

eye (Realarray)

(x,y,z) coordinate of the eye position, see Win_ThreeD for details.

light (Realarray)

(x,y,z) direction of the flood-light, see Win_ThreeD for details.

RESULT = (Gobject)

Returns the properties of the newly created plane.

Plane/Alter

Alters a Plane in a 3d window.

Parameters:

table (Colourtable)

The colour table to be used, see ColourTable for details.

transparency (Integer)

The level of transparency expressed as a percentage.

eye (Realarray)

(x,y,z) coordinate of the eye position, see Win_ThreeD for details.

light (Realarray)

(x,y,z) direction of the flood-light, see Win_ThreeD for details.

object (Gobject)

The plane object to be altered.

RESULT = (Gobject)

Returns the properties of the altered plane.