Name

---

      CAT_POLYGON__DEFINE

Purpose

---

      The purpose of this routine is to provide a polygon that can be displayed
      in a direct graphics draw widget. The coordinate system of the Cat_Polygon
      object is either passed to it (a CatCoord object) or is a normalized
      coordinate system by default.

Authors

---

        FANNING SOFTWARE CONSULTING BURRIDGE COMPUTING
        1645 Sheely Drive 18 The Green South
        Fort Collins Warborough, Oxon
        CO 80526 USA OX10 7DN, ENGLAND
        Phone: 970-221-0438 Phone: +44 (0)1865 858279
        E-mail: davidf@dfanning.com E-mail: davidb@burridgecomputing.co.uk

Category

---

      Objects.

Syntax

---

      polygonObject = Obj_New("CAT_POLYGON", XPTS, YPTS)
      drawObject -> Add, polygonObject

Superclasses

---

      SELECTABLEOBJECT
      CATDATAATOM
      CATATOM
      CATCONTAINER IDLITCOMPONENT
      IDL_CONTAINER

Class Structure

---

  class = { CAT_POLYGON, $
            background: 0L, $ ; A flag to indicate if a background polygon is drawn.
            bg_color: "", $ ; The background color.
            color: "", $ ; The name of a color to draw polygon in.
            linestyle: 0L, $ ; The line style of the polygon.
            xpts: Ptr_New(), $ ; The X points making up the polygon.
            ypts: Ptr_New(), $ ; The X points making up the polygon.
            npoints: 0L, $ ; The number of points in the polygon
            thickness: 0.0, $ ; The thickness of the polygon.
            sx: 0L, $ ; The static X location.
            sy: 0L, $ ; The static Y location.
            INHERITS SelectableObject $
          }

Messages

---

  CAT_POLYGON_CHANGED: This message is sent whenever SetProperty method is called and the NOMESSAGE
                      keyword is NOT set.

Event Structure

---

      This object will add the following fields to the event structure created by an interaction.
      The fields are defined as:
      BOUNDARY_BOX: A 2x5 element array in normalized coordinates giving the boundary box of
                        the object.
      XPTS: An array of X points in data coordinates descriping a polygon.
      YPTS: An array of Y points in data coordinates descriping a polygon.

Modification History

---

      Written by: David W. Fanning, 25 Jan 2004.