.SHAPE INITIALIZE

This subroutine is called to initialize or reinitialize a shape spec.

Usage:

      PASS         <shape_name>          FIELD            SHARE? N
      PASS         <shape_id>            FIELD            SHARE? N
      PASS         <no_of_points>        FIELD            SHARE? N
      GOSUB    OCD .SHAPE INITIALIZE
      *        Check for error
      IF       OCD .SHAPE INITIALIZE          NE

Description:

The <shape_name> and <shape_id> are required parameters, and the subroutine will cancel if they are not received.

<shape_name> can be any name you prefer.

<shape_id> must be one of the following:

squareShape, diamondShape, triangleShape, rightTriangleShape, leftTriangleShape, invertedTriangleShape, circleShape, glassSphereShape, glassSphere2Shape, solidSphereShape, starShape, polygonShape, polygon2Shape, crossShape, cross2Shape, and customShape.

For <shape_ID>'s equal to "CustomShape", the designer must add the x,y coordinates of the vertices using .SHAPE SET NEXT POINT for each vertice.

For the Polygon shapes, you must also pass <no_of_points> for the number of sides (must be >3). For starShape, you must pass <no_of_points> for the number of points on the star (must be >3). For the cross shapes, you must pass a value between 0 and 1 to represent the percentage width of the arms of the a '+' relative to the entire shape.

Once your shape is initialized, you can assign it via .XY SET BAR SHAPE.

The newly initialized shape is set to be the "current" shape.

Comments:

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

-- JeanNeron - 2011-10-20