.XY SET BAR SHAPE

This subroutine sets the shape of the bars in the current Data Point, Data Set Template, Data Group, or XY Bar Layer.

Usage:

      PASS         <shape_name>               FIELD            SHARE? N
      PASS         <data_point_no>            FIELD            SHARE? N
      GOSUB    0CD .XY SET BAR SHAPE
      *        Check for error
      IF       0CD .XY SET BAR SHAPE          NE

Description:

This subroutine sets the shape of the bars in the current Data Point, Data Set Template, Data Group, or XY Bar Layer.

<shape_name> must refer to a shape you previously defined using .SHAPE INITIALIZE. The subroutine will cancel if this parameter is not passed.

<data_point_no> is optional, and if passed, should refer to a point added via .POINT ADD NEW. The first data point you add will have a <data_point_no> of 1, the second will be 2, and so on.

If <data_point_no> is not passed, then the shape will be applied in the following order:

- "current" data point, if there is one, otherwise
- "current" data set template, if there is one, otherwise
- "current" data group, if there is one, otherwise
- "current" data layer, if there is one, otherwise an error is returned.

See Datasets Overview for more information on working with data.

Also see .XY SET BAR SHAPE:DP to set the shape for the "current" data point, .XY SET BAR SHAPE:DS to set the shape for the "current" data set template, .XY SET BAR SHAPE:DG to set the shape for the "current" data group, and .XY SET BAR SHAPE:LR to set the shape for the "current" layer.

<shape_name> becomes the "current" shape spec after calling this routine.

Comments:

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

-- JeanNeron - 2011-10-21