Syntax
[C/C++:]
void ggSetBlockChartAttribs(int coloff, float azim, float elev, float depth, float top, float side);
[F90:]
subroutine ggSetBlockChartAttribs(coloff, azim, elev, depth, top, side)
integer, intent(in) :: coloff
real, intent(in) :: azim, elev, depth, top, side
Arguments
coloff
Colour index offset for shading (default = 20)
azim
Azimuth angle of block in range -60.0 to 60.0 (default = 30.0)
elev
Elevation angle of block in range -60.0 to 60.0 (default = 30.0)
depth
Depth as fraction of column width in range 0.1 to 10.0 (default = 1.0)
top
The relative lightness of the top of a column compared to that of the front in range 0.0 to 100.0 (default = 0.67)
side
The relative lightness of the side of a column compared to that of the front in range 0.0 to 100.0 (default = 0.33)
Description
The routine ggSetBlockChartAttribs() sets the Block Chart attributes for all the Block Chart routines.
The colour index offset is used for the allocation of colour table entries to set the top and side shading colours. The first index used is
coloff+1. Each of the standard block chart routines require two indices where as the multi-histogram routine requires 2 * the number of groups indices. User should be aware that the colour table entries
coloff+1 and beyond are modified by the block filling routines and are not reset by any GINOGRAF routine.
The azimuth and elevation angles determine the shape of the block filling. When both are positive, the filling is to the right and above the front of the column or area. Negative values switch the block shading to the alternative side.
The depth fraction (
depth) is used as specified above in the histogram and bar chart routines, but because the width is variable in the step and area charts,
depth is multiplied by a fixed value (10% of the specified axis length) to determine the nominal block depth.
Both arguments
top and
side may be set to make the top and side panels of the block either darker or lighter than the front. i.e Values less than 1.0 will produce darker colours and values greater than 1.0 will produce lighter colours. In all cases the hue of the front panel is maintained.
The default block chart attributes may be restored using the routine ggRestoreBlockChartAttribs().
See Also
ggSetBlockChartAttribs UsageggBlockFillAreaChartggBlockFillBarChartggBlockFillHistogramggBlockFillMultiHistogramggBlockFillStepChartggEnqBlockChartAttribsggRestoreBlockChartAttribs
