NAME

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

SYNOPSIS

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

See the file man1/alc_origin.1.

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 connector 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"

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), GENLIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).

See the file man1/alc_bug_report.1.