NAME

       PadComp,  PadView,  PadGraphic,  PSPad  - pad connector subject, view, structured graphic, and PostScript
       external representation

SYNOPSIS

       #include <Unidraw/Components/pad.h>

DESCRIPTION

       PadComp is a Connector subclass that supports connectivity with  two  degrees  of  freedom.   It  uses  a
       PadGraphic to store its graphical attributes.  PadView is a GraphicView for displaying the pad.  PSPad is
       a PostScriptView that externalizes the subject's information in PostScript form.

PADCOMP PUBLIC OPERATIONS

       PadComp(PadGraphic* = nil)
              The constructor takes an optional PadGraphic that defines the pad's graphical attributes.

       virtual void Interpret(Command*)
       virtual void Uninterpret(Command*)
              PadComp (un)interprets a subset of  commands  that  connectors  can  generally  interpret,  namely
              MoveCmd, BrushCmd, AlignCmd, MobilityCmd, DeleteCmd, and CutCmd.

       virtual Mobility GetMobility()
       virtual void SetMobility(Mobility)
              PadComp  redefines  these  functions to return and assign its _mobility protected member.  The pad
              has fixed mobility initially.

       Pad* GetPad()
              Return the Pad graphic that defines the line's attributes.  GetPad is simply a more specific  form
              of the GetGraphic operation.

PADVIEW PUBLIC OPERATIONS

       PadView(PadComp* = nil)
              Create an PadView, optionally supplying the subject.

       virtual void Interpret(Command*)
              PadView interprets AlignToGridCmd to align its lower left to the grid.

       virtual Manipulator* CreateManipulator(
          Viewer*, Event&, Transformer*, Tool*
       )

       virtual void InterpretManipulator(Manipulator*)
              PadViews  respond  only  to manipulation by GraphicCompTools, MoveTools, and ConnectTools. PadView
              inherits its MoveTool response from ConnectorView.  GraphicCompTool will let the user sweep out  a
              rectangle  that  reflects the pad's size.  Creation will be influenced by gravity, if any. PadView
              creates a ConnectManip in response to the ConnectTool, which will exhibit a gravational attraction
              to  potential  target  connectors.   PadView  will  produce a ConnectCmd to connect the pad to its
              target. A pad connected in this way will receive floating mobility.

       PadComp* GetPadComp()
              Return the subject.

PADVIEW PROTECTED OPERATIONS

       PadGraphic* GetPad()
              Return the PadGraphic that defines the pad's attributes.  GetPad is simply a more specific form of
              the GetGraphic operation.

       virtual PadComp* NewSubject(PadGraphic*)
              A  helper  function  that  creates  a  PadComp  subject  with the given pad graphic. This function
              produces the proper subject when the GraphicCompTool's manipulator is interpreted.  Subclasses can
              redefine  this  operation  to  return a PadComp subclass, thus eliminating the need to reimplement
              InterpretManipulator.

       Manipulator* CreateGraphicCompManip(
           Viewer*, Event&, Transformer*, Tool*
       )

       Manipulator* CreateConnectManip(
           Viewer*, Event&, Transformer*, Tool*
       )

       Command* InterpretGraphicCompManip(Manipulator*)
       Command* InterpretConnectManip(Manipulator*)
              Helper functions used by CreateManipulator and InterpretManipulator to create  and  interpret  the
              manipulators associated with GraphicCompTool and ConnectTool.

PADGRAPHIC PUBLIC OPERATIONS

       PadGraphic(
           Coord = 0, Coord = 0, Coord = 0, Coord = 0,
           Graphic* = nil
       )
              Create  a  PadGraphic, optionally specifying lower-left and upper-right corners and a graphic from
              which to obtain its default graphics attributes.

       void GetOriginal(Coord&, Coord&, Coord&, Coord&)
              Return the PadGraphic's original coordinates as specified in the constructor.

PSPAD PUBLIC OPERATIONS

       PSPad(PadComp* = nil)
              Construct a PostScript external representation of the given subject, if any.

SEE ALSO

       BrushCmd(3U),    ConnectTool(3U),    Connector(3U),     ConnectorView3U),     Event(3I),     Graphic(3U),
       GraphicCompTool(3U),   Grid(3U),   MoveTool(3U),   PatternCmd(3U),  PostScriptView(3U),  Transformer(3I),
       Viewer(3U), align(3U), edit(3U), manips(3U), transforms(3U)