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

  
 
  

home | help
GENLIB_CO...CON_FACE.3(October 1, 1997)  GENLIB_CO...CON_FACE.3(October 1, 1997)

NAME
     GENLIB_COPY_UP_CON_FACE - copy a physical connector from an instance in the
     current figure

SYNOPSIS
     #include <genlib.h>
     void GENLIB_COPY_UP_CON_FACE(face, conname, insname, newname)
     long index;
     char *insname;
     char *conname;
     char *newname;

PARAMETERS
     face		 Connector face in the instance

     conname		 Name of the connector in the instance model

     insname		 Name of the instance the connector belongs to

     newname		 Name to be given to the connector in the current figure

DESCRIPTION
     COPY_UP_CON_FACE  copies  a instance connector into the current layout fig-
     ure, and gives to the new connector the name newname.  The face and conname
     arguments are not suffiscient for non ambiguiously identify a  single  con-
     nector.  So, if more than one connector matches these arguments, the behav-
     iour described below is applied on all of them.
     Two  behaviour  are  expected, depending on the instance connector location
     regarding the abutment box of the current figure.

     Connector on the abutment box
			 The figure connector is place right over  the	instance
			 connector. The single connector is duplicated.

     Connector inside the abutment box
			 The  instance connector face is computed in the figure,
			 and then, the connector  is  duplicated  on  the  given
			 face,	at  the right coordinates for this face.  Then a
			 wire is drawn between the instance  connector	and  the
			 figure connector in the connector layer.

ERRORS
     "GENLIB_COPY_UP_CON_FACE impossible : missing GENLIB_DEF_PHFIG"
	    No figure has been yet specified by a call to DEF_PHFIG. So it isn't
	    possible  to  place  a connector inside it.  you must call DEF_PHFIG
	    before any other layout action.
     "*** genlib error *** GENLIB_COPY_UP_CON_FACE impossible :  connector  con-
     name face face of instance insname, current figure doesn't exist"
	    No connector matches both the conname and the face arguments.

EXAMPLE
     #include <genlib.h>
     main()
     {
	  /* Create a figure to work on  */
	  GENLIB_DEF_PHFIG("cell");
	  .
	  .
	  GENLIB_PLACE_LEFT("gaer0_f", "insN", SYMXY);
	  .
	  .
	  GENLIB_DEF_AB(0L, 0L, 0L, 0L);
	  /* Put a connector */
	  GENLIB_COPY_UP_CON_FACE("i0", 1, "insN", "inz0");
	  /* Save that on disk */
	  GENLIB_SAVE_PHFIG();
     }

SEE ALSO
     genlib(1),       GENLIB_DEF_PHFIG(3),	 GENLIB_SAVE_PHFIG(3),	    GEN-
     LIB_COPY_UP_ALL_CON(3),   GENLIB_COPY_UP_CON(3),	GENLIB_PHCON(3),    GEN-
     LIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).

PROCEDURAL GENERATION LANGUAGE	    ASIM/GENLIB_CO...CON_FACE.3(October 1, 1997)

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

home | help