.XY SET BAR GAP

This subroutine sets the gap between the bars or a bar group in a bar chart layer.

.XY SET BAR GAP

Usage:

      PASS         <bar_gap>                  FIELD            SHARE? N
      PASS         <subBar_gap>               FIELD            SHARE? N
      GOSUB    0CD .XY SET BAR GAP
      *        Check for error 
      IF       0CD .XY SET BAR GAP            NE

Description:

Sets the gap between the bars in a bar chart layer. The subroutine accepts 2 optional parameters:

<bar_gap> - The portion of the space between the bars (or between bar groups for multi-bar layers).

<subBar_gap> - This argument only applies to multi-bar charts. It is the portion of the space between the bars in a bar group.

The gap between the bars is expressed as the portion of the space between the bars. For example, a bar gap of 0.2 means 20% of the distance between two adjacent bars is the gap between the bars. A bar gap of 0 means there is no gap in between the bars. The bar gap can be negative. In this case, the bars will overlap. You can also use the predefined constant 'TouchBar' to indicate the bars should touch (same as gap of zero).

For multi-bar layers (bar layers using the Side data combine method, or for stacked bar layers with multiple data groups, see .XY ADD BAR LAYER), barGap refers to the portion of the space between bar groups, while subBarGap refers to the portion of the space between bars within the bar group.

Values greater than or equal to 1 will result in one pixel wide bars, since 100% of the space is allocated to the gap. The larger the gap, the narrower the bars have to be to fit in the space.

Comments:

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

-- JeanNeron - 2011-10-14

Topic revision: r5 - 2012-02-25 - JeanNeron