GENLIB_COPY_UP_CON.3(October 1, 1997)									     GENLIB_COPY_UP_CON.3(October 1, 1997)

NAME

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

SYNOPSYS

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

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

PARAMETERS

       index		   Connector index 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 copies a instance connector into the current layout figure, and gives to the new connector the name newname. The instance  con-
       nector is identified by its name, conname, and index, index.
       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.

       If newname is NULL, then not connector is copied up, on the segment is drawn to the side of the abutment box.

ERRORS

       "GENLIB_COPY_UP_CON 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 impossible : connector conname index index of instance insname, current figure doesn't exist"
	      The given connector does not exist in the current figure.

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("i0", 1, "insN", "inz0");
	    /* Save that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO

       genlib(1),  GENLIB_DEF_PHFIG(3),  GENLIB_SAVE_PHFIG(3),	GENLIB_COPY_UP_ALL_CON(3),   GENLIB_COPY_UP_CON_FACE(3),   GENLIB_PHCON(3),   GEN-
       LIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

PROCEDURAL GENERATION LANGUAGE
					     ASIM/LIP6				     GENLIB_COPY_UP_CON.3(October 1, 1997)