addphcon

ADDPHCON(3)                 MBK PHYSICAL FUNCTIONS                 ADDPHCON(3)



NAME
       addphcon - create a physical connector

>> Included manual page: man1/alc_origin.1alc

SYNOPSIS
       #include "mph.h"
       phcon_list ∗addphcon(ptfig, orient, conname, x, y, layer, width)
       phfig_list ∗ptfig;
       char orient;
       char ∗conname;
       long x, y;
       char layer;
       long width;

PARAMETERS
       ptfig               Pointer to the figure in which the connector should
                           be added

       orient              Face of the connector

       conname             Name of the connector

       x, y                Absolute connector coordinates

       layer               Connector symbolic layer

       width               Connector symbolic width

DESCRIPTION
       addphcon creates a new connector called conname and adds it to the list
       of connectors pointed to by ptfig->PHCON. The new connector is added in
       front of the list, and becomes itself the list head.
       The parameters conname, orient, x, y, layer, width fill respectivly the
       NAME, ORIENT, XCON, YCON, LAYER, WIDTH fields of the phcon structure.
       See phcon(3) for details.
       The INDEX field is computed by the addphcon function in order to
       warranty index unicity. A topological sort is performed, checking x,
       then y, then the layer. So for a given figure, each connector will have
       a constant INDEX.
       The x, y coordinates must be placed inside the butment box of the
       figure.
       The width is a layer extension that takes place in parallel to the
       connector face.
       For a list of valid orient and layers, see locon(3).

RETURN VALUE
       addphcon returns a pointer to the newly created connector.

ERRORS
       "∗∗∗ mbk error ∗∗∗ illegal addphcon unknown layer layer in conname"
              The layer parameter is out of range, and does not represent a
              legal symbolic layer. See locon(3) for a complete list of
              layers.
       "∗∗∗ mbk error ∗∗∗ illegal addphcon connector conname not in abutment
       box"
              The connector coordinates are not included in the rectangle of
              the figure abutment box. This means that the abutment box field
              of the phfig must be filled befor any call to addphcon.
       "∗∗∗ mbk error ∗∗∗ illegal addphcon orientation is orient in conname"
              The orient parameter is not in the set of legal values. See
              locon(3) for the complete list of orientations.

EXAMPLE
       #include "mph.h"
       phcon_list ∗du_con(ptfig, ptcon) /∗ duplicate connector ∗/
       phfig_list ∗ptfig;
       phcon_list ∗ptcon;
       {
          /∗ the index depends from what's in ptfig->PHCON, not from me ∗/
          return addphcon(ptfig, ptcon->ORIENT, ptcon->NAME,
                          ptcon->XCON, ptcon->YCON,
                          ptcon->LAYER, ptcon->WIDTH);
       }

SEE ALSO
       mbk(1), phfig(3), phcon(3), getphcon(3), delphcon(3), locon(3).



>> Included manual page: man1/alc_bug_report.1alc




ASIM/LIP6                       October 1, 1997                    ADDPHCON(3)