CDPieSetSectorShading < Main

Tags: view all tags
---+ .PIE SET SECT SHADING

_This subroutine sets the shading method of the "current" or specified sector specs._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;shade_method&gt;             FIELD            SHARE? N
      PASS         &lt;beg_sector_no&gt;            FIELD            SHARE? N
      PASS         &lt;end_sector_no&gt;            FIELD            SHARE? N
      GOSUB    0CD .PIE SET SECT SHADING
      *        Check for error
      IF       0CD .PIE SET SECT SHADING      NE
</pre>
---++ Description:

This subroutine sets the shading method of the sector for the "current" or specified sector(s).

If the &lt;shade_method&gt; parameter is not received or if the value received is blank, then the shading method of the sector spec is cleared and the default method will be rendered. The valid &lt;shade_methods&gt; are:

Default Shading (or blank) - This is the default shading method. The top surfaces are shaded with flat colors. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.

Flat Shading - All surfaces are shaded with flat colors.

Local Gradient Shading - The top surfaces are shaded with linear gradient colors. For each sector, the gradient is from the bottom of the sector bounding box to the top of the sector bounding box, with the bottom side brighter and the top side darker. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.

Global Gradient Shading - The top surfaces are shaded with linear gradient colors. The gradient is from the bottom the pie bounding box to the top of the pie bounding box, with the bottom side brighter and the top side darker. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.

Concave Shading - The top surfaces are shaded with a special effect so that they look concave, with the pie center appears to be depressed relative to the perimeter. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.

Rounded Edge Shading - The top surfaces are shaded with a special effect so that the pie looks raised with a rounded raised edge at the perimeter.

Radial Shading - The top surfaces are shaded with radial gradient colors, with the pie center brighter and the perimeter darker. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.

Ring Shading - This effect is intended to be used with 2D donut charts only. The top surfaces are shaded with a special effect so that a 2D donut will look like a torus.

Note that spaces are optional in the &lt;shade_method&gt; and that it is not case sensitive.

If &lt;beg_sect_no&gt; is "ALL" or "0" and &lt;end_sect_no&gt; is not received or is blank, then the shading spec applies to all pie sectors.

If &lt;beg_sect_no&gt; and &lt;end_sect_no&gt; are both received and are both numeric integers, then the shading spec applies to the range of pie sectors from &lt;beg_sect_no&gt; thru &lt;end_sect_no&gt; and is stored in the corresponding pie sector specs.

If &lt;beg_sect_no&gt; is received and is a numeric integer and &lt;end_sect_no&gt; is not received or is blank, then the shading spec applies only to the &lt;beg_sect_no&gt; pie sector.

If &lt;beg_sect_no&gt; and &lt;end_sect_no&gt; are both not received or are blank, then the shading spec applies to the "current" pie sector and is stored in the "current" pie sector spec.

Any pie sector specs that are referenced but which do not exist are automatically created and initialized so that the shading spec can be stored.

The last pie sector spec updated becomes the "current" pie sector spec.
---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2011-10-04
Topic revision: r3 - 2012-02-24 - JeanNeron