Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ADDPHCON(3)		    MBK	PHYSICAL FUNCTIONS		   ADDPHCON(3)

NAME
       addphcon	- create a physical connector

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  war-
       ranty  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 fig-
       ure.
       The width is a layer extension that takes place in parallel to the con-
       nector 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 lay-
	      ers.
       "*** 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 lo-
	      con(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).

ASIM/LIP6			October	1, 1997			   ADDPHCON(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=addphcon&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help