GENLIB_COPY_UP_CON_FACE.3alc man page
GENLIB_COPY_UP_CON_FACE
GENLIB_COPY_UP_CON_FACE — copy a physical connector from an instance in the current figure COPY_UP_CON_FACE copies a instance connector into the current layout figure, and gives to the new connector the name newname. The face and conname arguments are not suffiscient for non ambiguiously identify a single connector. So, if more than one connector matches these arguments, the behaviour described below is applied on all of them. The figure connector is place right over the instance connector. The single connector is duplicated. 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. 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. No connector matches both the conname and the face arguments. genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_COPY_UP_ALL_CON(3), GENLIB_COPY_UP_CON(3), GENLIB_PHCON(3), GENLIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3). genlib.1alc(1), GENLIB_COPY_UP_ALL_CON.3alc(3), GENLIB_COPY_UP_CON.3alc(3), GENLIB_PHCON.3alc(3), GENLIB_REVERSE_PHCON.3alc(3).Synopsis
#include <genlib.h>
void GENLIB_COPY_UP_CON_FACE(face, conname, insname, newname)
long index;
char ∗insname;
char ∗conname;
char ∗newname;
Parameters
Description
Two behaviour are expected, depending on the instance connector location regarding the abutment box of the current figure.Errors
"GENLIB_COPY_UP_CON_FACE impossible : missing GENLIB_DEF_PHFIG"
"*** genlib error *** GENLIB_COPY_UP_CON_FACE impossible : connector
conname face
face of instance
insname,
current figure doesn't exist"
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
Referenced By