Chapter 5:
Advanced (OpenGL) Attributes (A3D_ADV_)

ATTRIBUTE

Description

A3D_ADV_2DDEPTH_DATA

Advanced 2D Depth of the data layer

A3D_ADV_2DDEPTH_FRAME

Advanced 2D Depth of Frame

A3D_ADV_2DDEPTH_LEGEND

Advanced 2D Depth of Legend

A3D_ADV_2DFRAMEFOOT

Advanced 2D Frame Foot definition

A3D_ADV_2DFRAMEMARGIN

Advanced 2D Frame Margin definition

A3D_ADV_2DVIEWER_DIST

Advanced 2D Viewer Distance

A3D_ADV_2DVIEWER_X

Advanced 2D Viewer X

A3D_ADV_2DVIEWER_Y

Advanced 2D Viewer Y

A3D_ADV_ANTIALIAS

Advanced Antialiasizing

A3D_ADV_BGRADIOSITY

Advanced Background Radiosity (back lighting)

A3D_ADV_CHARTLIGHT_1/2/3

Advanced Chart Light 1 definition

A3D_ADV_DEFAULT_MATERIAL

Advanced Default Material for objects

A3D_ADV_DOADV_CHART

Advanced Do Advanced Drawing of Chart

A3D_ADV_DOADV_TITLES

Advanced Do Advanced Drawing of Chart Titles

A3D_ADV_DROP_SHADOW

Advanced Drop Shadow around a Pie Chart

A3D_ADV_FLOATER_VARIANT

Advanced risers types in a 3D floating cube chart

A3D_ADV_FOV

Advanced Field-of-View (FOV)

A3D_ADV_HIFI_OBJECTS

Advanced HiFi Objects

A3D_ADV_LABEL_MATERIAL

Advanced Label Material

A3D_ADV_LIGHTAMBIENT

Advanced Light Ambient

A3D_ADV_LOFT_SHAPE

Advanced Loft Shape of risers

A3D_ADV_LOFT_TWIST

Advanced Loft Twist of risers

A3D_ADV_MATAMBIENT

Advanced Material Ambient light reflecting from default material

A3D_ADV_MATGLOW

Advanced Material Glow from the default material

A3D_ADV_PIE_EDGETYPE

Advanced Pie Edge Style

A3D_ADV_PIE_FEELERTYPE

Advanced feeler type in a pie chart

A3D_ADV_PIE_LABELSFACE

Advanced Pie Labels Face (How much pie labels are turned to face the camera)

A3D_ADV_PIE_TINTLABELS

Advanced Pie Tint Labels

A3D_ADV_RISER_SIDES

Advanced riser sides

A3D_ADV_ROUNDING

Advanced Rounding to apply to advanced 3D generated objects

A3D_ADV_TEXT_STYLE

Advanced Text Style

A3D_ADV_TITLELIGHT

Advanced Title Light definition

A3D_ADV_2DDEPTH_DATA

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the thickness of the layer that is used for Markers and Risers. It is specified in OpenGL Units.

Type:

REAL64

Valid Range:

0 to 10.0

Default:

0.25

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 DataDepth=1.5;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DDEPTH_DATA, (void FAR *) &DataDepth);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DDEPTH_FRAME, A3D_ADV_2DDEPTH_LEGEND, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DDEPTH_FRAME

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the thickness of the layer that is used for the chart frame. It is specified in OpenGL Units.

Type:

REAL64

Valid Range:

0...10.0

Default:

0.25

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 DepthFrame=6.0;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DDEPTH_FRAME, (void FAR *) &DepthFrame);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DDEPTH_DATA, A3D_ADV_2DDEPTH_LEGEND, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DDEPTH_LEGEND

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the thickness of the legend box (and markers). It is specified in OpenGL Units. Note that this attribute controls BOTH the thickness of the legend box itself as well as the legend markers.

Type:

REAL64

Valid Range:

0.1...6.0

Default:

0.2

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 LegendDepth=1.0;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DDEPTH_LEGEND, (void FAR *) &LegendDepth);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DDEPTH_DATA, A3D_ADV_2DDEPTH_FRAME, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DFRAMEFOOT

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, the value assigned to this attribute will show/hide the chart foot. In order for this foot (or ledge) to appear properly, the minimum value of the Y1 and/or Y2 scale should be excluded. Otherwise, the foot will draw OVER the minimum scale value.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Display the foot. The minimum scale value on the Y1 and/or Y2 axis will not display.

 

FALSE=

Do not draw the foot; minimum scale values will display properly.

Default:

FALSE

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DFRAMEMARGIN, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DFRAMEMARGIN

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, the value assigned to this attribute will show/hide an extra margin around the chart frame.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Draw the chart with the extra margin. (default setting).

 

FALSE=

Do not draw the extra margin; draw the chart frame as if it were a normal 2D chart.

Default:

TRUE

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DFRAMEMARGIN, (void FAR *) &bON);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DFRAMEFOOT, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DVIEWER_DIST

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the distance of the viewer from the chart. Larger numbers send the chart further into the distance making it appear smaller. Smaller values bring the chart closer making the chart appear larger. Set a smaller size to increase the size of the chart. Use a larger value to decrease the size of the chart. Very small values will zoom the chart so close that it will clip the edges of the window (e.g., values smaller than 2.0).

Type:

REAL64

Valid Range:

0.1...20.0

Default:

6.0

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 rDist=10.0;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DVIEWER_DIST, (void FAR *) &rDist);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DVIEWER_X, A3D_ADV_2DVIEWER_Y, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DVIEWER_X

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the X-angle of the chart. A value of zero produces a flat chart. A negative value will rotate the chart to the left (if viewed from the front). A positive value will rotate it to the right.

Type:

REAL64

Valid Range:

-10.0...10.0

Default:

Zero

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 rViewX=-4.0;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DVIEWER_X, (void FAR *) &rViewX);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DVIEWER_DIST, A3D_ADV_2DVIEWER_Y, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_2DVIEWER_Y

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the Y-angle of the chart. A value of zero produces a flat chart. A negative value will rotate the chart up (if viewed from the front). A positive value will rotate it down.

Type:

REAL64

Valid Range:

-10.0...10.0

Default:

Zero

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 rViewY=-6.0;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_2DVIEWER_Y, (void FAR *) &rViewY);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DVIEWER_DIST, A3D_ADV_2DVIEWER_X, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_ANTIALIAS

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE, the value assigned to this attribute enables/disables anti-alias drawing. When enabled, this drawing mode will smooth lines and font edges. The quality of anti-alias drawing depends on the hardware/software platform. This feature vastly improves the appearance of a chart if the platform has 3D-hardware acceleration. However, it can slow the drawing of charts on machines without hardware acceleration.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Use anti-alias drawing

 

FALSE=

Draw the chart normally

Default:

TRUE

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_ANTIALIAS, (void FAR *) &bON);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

A3D_ADV_BGRADIOSITY

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the amount of radiant color from the background material (default material).

Type:

REAL64

Valid Range:

0.0...3.0

Default:

.33

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

REAL64 rGrad=1.5;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_BGRADIOSITY, (void FAR *) &rGrad);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DEFAULT_MATERIAL, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_CHARTLIGHT_1/2/3

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, these attributes enable/disable and define three lights (1, 2, 3) to shine on a chart. Each element of the structure controls a specific segment of light.

Type:

typedef struct {
     BOOLEAN16 bLightOn;
     REAL64 fRed;
     REAL64 fGreen;
     REAL64 fBlue;
     REAL64 fDiffuseAmt;
     REAL64 fSpecularAmt;
     REAL64 fPositionX;
     REAL64 fPositionY;
     REAL64 fPositionZ;
     REAL64 fAttenuation;
     INT32 nFlags;
} Light3DStruct, FAR * Light3DPtr;

Valid Range:

See the Light3DStruct in Appendix A for information about how to fill in the fields in this data structure to enable/disable and define Light 1.

Default:

None

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_TITLELIGHT, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_DEFAULT_MATERIAL

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the structure for the material of the chart. There are two materials: one for the entire chart (defined by this attribute) and one for the floating labels (defined by the A3D_ADV_LABEL_MATERIAL attribute).

Type:

typedef struct {
     REAL64 fDiffRed;
     REAL64 fDiffGreen;
     REAL64 fDiffBlue;
     REAL64 fSpecRed;
     REAL64 fSpecGreen;
     REAL64 fSpecBlue;
     REAL64 fShininess;
     REAL64 fTextureTint;
     REAL64 fTextureScale;
     INT32 nFlags;
} Material3DStruct, FAR * Material3DPtr;

Valid Range:

See the Material3DStruct in Appendix A for information about how to fill in the fields in this data structure to define the default material.

Default:

None

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_BGRADIOSITY, A3D_ADV_LABEL_MATERIAL, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_DOADV_CHART

 

This attribute enables/disables Advanced 3D rendering for the entire chart. When TRUE, all charts are processed through the OpenGL port and rendered in advanced form. When FALSE, all charts are drawn using standard Windows graphics methods.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Advanced 3D drawing is used. All charts are drawn using OpenGL

 

FALSE=

Charts are drawn using standard Windows graphics methods

Default:

FALSE

Example:

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bON);

 

 

BOOLEAN16 bOFF=FALSE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DOADV_CHART, (void FAR *) &bOFF);

 

Notes:

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_TITLES

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

         

A3D_ADV_DOADV_TITLES

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute enables/disables advanced 3D rendering for the fonts of the Title, Subtitle, and Footnote.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Convert Title, Subtitle and Footnote fonts to 3D fonts using the OpenGL drawing routines.

 

FALSE=

Use normal Windows fonts for the Title, Subtitle, and Footnote.

Default:

FALSE

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_DROP_SHADOW

 

This attribute enables/disables the drop shadow that is shown around a pie chart when advanced drawing is used.

Type:

BOOLEAN16

Valid Range:

TRUE (Draw Drop Shadow ) / FALSE (Do Not draw drop shadow)

Default:

TRUE

 

BOOLEAN16 bON=TRUE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DROP_SHADOW, (void FAR *) &bON);

 

 

BOOLEAN16 bOFF=FALSE;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_DROP_SHADOW, (void FAR *) &bOFF);

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

Pie Charts ONLY

A3D_ADV_FLOATER_VARIANT

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute selects an extended riser type for risers in 3D floating marker-type charts

Type:

INT16

Valid Range:

One of the following values from the ExtRiserType enum:

 

ExtRiserType Enum

 
 

EXTRISER_NONE

 
 

EXTRISER_PRISM

 
 

EXTRISER_PYRAMID_UP

 
 

EXTRISER_PYRAMID_DOWN

 
 

EXTRISER_PYRAMID_DOUBLE

 
 

EXTRISER_PYRAMID_PRISM

 
 

EXTRISER_SPHERE

 
 

EXTRISER_HEMISPHERE

 
 

EXTRISER_HALFPRISM

 

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

3D Floating Cubes only

         

A3D_ADV_FOV

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the camera Field of View (FOV) in degrees. This setting controls how much perspective distortion the chart will receive. Smaller numbers will make the chart more isometric. Larger values will show more perspective distortion.

Type:

REAL64

Valid Range:

1.0...179.0

Default:

1.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_2DVIEWER_DIST, A3D_ADV_2DVIEWER_X, A3D_ADV_2DVIEWER_Y, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_HIFI_OBJECTS

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute enables or disables the substitution of hi-resolution OpenGL models for 3D risers. The current risers that may be substituted are as follows:

 

Graph Type:

OpenGL Substitution:

 

Floating Spheres

TRUE spheres

 

Floating Cubes

Rounded-edge cubes

 

3D Bars

Rounded-edge bars

 

Pyramids

Smoothed cones

 

Octagons

Cylinders with chamfered tops

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Substitute the new models for the "standard" risers.

 

FALSE=

Use the "old style" risers for all charts, even if drawing in OpenGL.

Default:

FALSE

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_LOFT_SHAPE, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_LABEL_MATERIAL

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute sets up the structure for the material of the floating labels. Currently, there are two materials, one for the entire chart and one for the floating labels (title, subtitle, and footnote).

Type:

typedef struct {
     REAL64 fDiffRed;
     REAL64 fDiffGreen;
     REAL64 fDiffBlue;
     REAL64 fSpecRed;
     REAL64 fSpecGreen;
     REAL64 fSpecBlue;
     REAL64 fShininess;
     REAL64 fTextureTint;
     REAL64 fTextureScale;
     INT32 nFlags;
} Material3DStruct, FAR * Material3DPtr;

Valid Range:

See the Material3DStruct in Appendix A for information about how to fill in the fields in this data structure to define the label material.

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ ADV_DEFAULT_MATERIAL, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_LIGHTAMBIENT

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the amount of ambient (non-directional) light that falls on all of the objects. This is a global adjustment that affects the entire chart.

Type:

REAL64

Valid Range:

0.0...1.0

Default:

0.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_MATAMBIENT, A3D_ADV_DOADV_CHART

   

A3D_ADV_LOFT_SHAPE

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the shape of 2D3D-risers. If this attribute is set to minus one, the marker shape for each series is used. A value in the range zero to 48 selects the marker shape that is used to loft the risers.

Type:

INT64

Valid Range:

-1...48 -1 = use the marker shape for each series. See A2D_MARKER_SHAPE for a description of these values.

Default:

-1 (Use marker shape for each series)

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_LOFT_TWIST, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_LOFT_TWIST

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the amount of twist applied to 2D3D risers as they rise. For example, setting this attribute to 90 would make the risers twist by 90-degrees between their base and top.

Type:

REAL64

Valid Range:

-360...360 degrees

Default:

Zero

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_LOFT_SHAPE, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_MATAMBIENT

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the amount of ambient light reflecting from the default material. Higher values will tend to wash out any directed lights. Lower values will sharpen the effect of the main three lights on the graph itself. If set to the maximum, the effect of the additional lights will be minimal.

Type:

REAL64

Valid Range:

0.0...1.0

Default:

0.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_LIGHTAMBIENT, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_MATGLOW

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the amount of color glow from the default material defined by A3D_ADV_DEFAULT_MATERIAL..

Type:

REAL64

Valid Range:

0.0...1.0

Default:

0.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DEFAULT_MATERIAL, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_PIE_EDGETYPE

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE and the graph type is set to one of the pie charts, this attribute controls the pie edge type.

Type:

INT16

Valid Range:

0...5

 

0=

Flat

 

1=

Smoothed

 

2=

Rounded

 

3=

V-Shaped

 

4=

Corrugated

 

5=

Oil Drum

Default:

0 (Flat)

Example:

INT16 Corrugated=4;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_PIE_EDGETYPE, (void FAR *) &Corrugated);

 

 

INT16 OilDrum=5;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID,NULL_SERIESID, NULL_GROUPID,
     A3D_ADV_PIE_EDGETYPE, (void FAR *) &OilDrum);

 

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

Pie ONLY

   

A3D_ADV_PIE_FEELERTYPE

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE and the graph type is set to one of the pie charts, this attribute controls the type of pie feelers used: "regular" or "stick pin" types.

Type:

INT16

Valid Range:

0/1

 

0=

Regular pie feelers

 

1=

Stick pins

Default:

0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_PIE_LABELSFACE

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls how much pie labels are tilted toward or away from the viewer. If this attribute is set to one, the pie labels will face the viewer directly. If this attribute is set to zero, the labels will come straight off of the pie. A value of .5 will show them somewhere in-between.

Type:

REAL64

Valid Range:

0.0....1.0

Default:

0.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_PIE_TINTLABELS, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_PIE_TINTLABELS

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute controls the percentage of the slice color that slice labels will receive.

Type:

REAL64

Valid Range:

0.0....1.0

Default:

0.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_PIE_LABELSFACE, A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A3D_ADV_RISER_SIDES

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute can be used to define the number of sides to draw for 3D cylinder (column) risers. Larger values draw a smoother cylinder. Smaller values make the column risers more octagonal.

Type:

INT16

Valid Range:

Any integer

Default:

1000

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

3D Column

   

A3D_ADV_ROUNDING

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute defines the percentage of rounding on the edges of chamfered risers and along the edges of pies.

Type:

REAL64

Valid Range:

0.0...1.0

Default:

0.0

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

A3D_ADV_TEXT_STYLE

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute selects advanced text styles.

Type:

BOOLEAN16

Valid Range:

One of the following #defines:

 

OGLTEXT_GDI

0

GDI (Windows) 2D text

 

OGLTEXT_OUTLINE

1

Flat tessellated outline text

 

OGLTEXT_EXTRUDED

2

Extruded tessellated outline text

 

OGLTEXT_TEXMAP

3

Texture-mapped text

Default:

OGLTEXT_GDI (0)

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

A3D_ADV_TITLELIGHT

 

When the A3D_ADV_DOADV_CHART attribute is set to TRUE to enable advanced drawing, this attribute enables/disables and defines a light to shine on the chart title. Each element of the structure controls a specific segment of light.

Type:

typedef struct {
     BOOLEAN16 bLightOn;
     REAL64 fRed;
     REAL64 fGreen;
     REAL64 fBlue;
     REAL64 fDiffuseAmt;
     REAL64 fSpecularAmt;
     REAL64 fPositionX;
     REAL64 fPositionY;
     REAL64 fPositionZ;
     REAL64 fAttenuation;
     INT32 nFlags;
} Light3DStruct, FAR * Light3DPtr;

Valid Range:

See the Light3DStruct in Appendix A for information about how to fill in the fields in this data structure to enable/disable and define title light.

Notes:

1.

If A3D_ADV_DOADV_CHART is FALSE, this attribute is not used.

 

2.

See Advanced 3D Rendering in the PGSDK Programmer's Manual for additional information about using the advanced 3D (A3D_ADV...) attributes.

Also See:

A3D_ADV_DOADV_CHART

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All