addphcon.3alc - Man Page

#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;

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

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).

addphcon returns a pointer to the newly created connector.

"∗∗∗ mbk error ∗∗∗ illegal addphcon unknown layer layer in conname"

"∗∗∗ mbk error ∗∗∗ illegal addphcon connector conname not in abutment box"

"∗∗∗ mbk error ∗∗∗ illegal addphcon orientation is orient in  conname"

#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);
}

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

delphcon.3alc(3), getphcon.3alc(3), phcon.3alc(3).