PolyMode

Purpose

This property controls several modes of the 3D Scientific Graph Object. When constructing a 3D chart, this should be the very first property initialized.

Possible values are defined by the following constants:

Comments

When PEPM_SURFACEPOLYGON is used, XData, YData, ZData is processed into a list of polygons which produce a surface. If AddSkirts is set to TRUE, additional polygons will be added to form sides of surface. Generally, the XData and ZData should be equally spaced but this is not mandatory.

When PEPM_3DBAR is used, the object behaves much like the 2D Graph Object. Bars are equally spaced along the x axis and z axis. The number of bars along x axis is controlled by Points and the number of bars along the z axis is controlled by Subsets. SubsetLabels are placed along the z axis and PointLabels are placed along x axis. You only pass YData in this mode.

When PEPM_POLYGONDATA is used, PEP_structPOLYDATA is used to pass data. AddSkirts should be set to TRUE if the polygon data forms an enclosed surface and you want to produce a surface or shaded surface image. When passing polygon data, the polygon vertices must be ordered in a counter-clockwise order as viewed from outside of the object. This is only necessary for hidden line removal and shading purposes. If you are only producing a wireframe image, the ordering of vertices is not critical.

When PEPM_SCATTER is used, XData, YData, ZData is passed and the object behaves much like the 2D Scientific Graph's scatter graph. Possible plotting methods (PlottingMethod) are Point, Line, Points + Line, and Area. Area forms area layers for each subset and can produce a Waterfall chart.

For more information on this property, see Chapter 6 which talks about creating 3D charts. Also refer to the example code 400.