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

SYNOPSYS
       #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 unknow 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)

NAME | SYNOPSYS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO

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

home | help