addphcon.3alc man page
addphcon
addphcon
addphcon — create a physical connector 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. addphcon returns a pointer to the newly created connector. The layer parameter is out of range, and does not represent a legal symbolic layer. See locon(3) for a complete list of layers. 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. The orient parameter is not in the set of legal values. See locon(3) for the complete list of orientations. mbk(1), phfig(3), phcon(3), getphcon(3), delphcon(3), locon(3). delphcon.3alc(3), getphcon.3alc(3), phcon.3alc(3).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
Description
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
Errors
"∗∗∗ 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"
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
Referenced By