120 lines
2.9 KiB
Groff
120 lines
2.9 KiB
Groff
.\" $Id: GENLIB_COPY_UP_CON.3,v 1.1 2000/09/28 15:19:49 fred Exp $
|
|
.\" @(#)COPY_UP_CON.3 2.11 91/08/22 ; Labo Cao-vlsi; Author : Frederic Petrot
|
|
.if t \{\
|
|
.so man1/alc_contents.mac
|
|
.XS \n%
|
|
.ti 0.2i
|
|
COPY_UP_CON
|
|
.XE \}
|
|
.TH COPY_UP_CON 3 "October 1, 1997" "ASIM/LIP6" "PROCEDURAL GENERATION LANGUAGE"
|
|
.SH NAME
|
|
COPY_UP_CON \- copy a physical connector from an instance in the
|
|
current figure
|
|
.SH SYNOPSYS
|
|
.nf
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
#include <genlib.h>
|
|
void COPY_UP_CON(index, conname, insname, newname)
|
|
long index;
|
|
char \(**insname;
|
|
char \(**conname;
|
|
char \(**newname;
|
|
.ft R
|
|
.fi
|
|
.so man1/alc_origin.1
|
|
.SH PARAMETERS
|
|
.TP 20
|
|
\fIindex\fP
|
|
Connector index in the instance
|
|
.TP
|
|
\fIconname\fP
|
|
Name of the connector in the instance model
|
|
.TP
|
|
\fIinsname\fP
|
|
Name of the instance the connector belongs to
|
|
.TP
|
|
\fInewname\fP
|
|
Name to be given to the connector in the current figure
|
|
.SH DESCRIPTION
|
|
\fBCOPY_UP_CON\fP copies a instance connector into the current layout figure,
|
|
and gives to the new connector the name \fInewname\fP. The instance connector
|
|
is identified by its name, \fIconname\fP, and index, \fIindex\fP.
|
|
.br
|
|
Two behaviour are expected, depending on the instance connector location
|
|
regarding the \fIabutment box\fP of the current figure.
|
|
.TP 20
|
|
Connector on the \fIabutment box\fP
|
|
The figure connector is place right over the instance connector. The single
|
|
connector is duplicated.
|
|
.TP
|
|
Connector inside the \fIabutment box\fP
|
|
The instance connector face is computed in the figure, and then, the connector
|
|
is duplicated \fIon\fP 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.
|
|
.LP
|
|
If \fInewname\fP is \fBNULL\fP, then not connector is copied up, on the segment
|
|
is drawn to the side of the \fIabutment\fP box.
|
|
.SH ERRORS
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
"COPY_UP_CON impossible : missing DEF_PHFIG"
|
|
.ft R
|
|
.RS
|
|
No figure has been yet specified by a call to \fBDEF_PHFIG\fP. So it isn't
|
|
possible to place a connector inside it.
|
|
you must call \fBDEF_PHFIG\fP before any other layout action.
|
|
.RE
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
"*** genlib error *** COPY_UP_CON impossible : connector \fIconname\fP index
|
|
\fIindex\fP of instance \fIinsname\fP, \fIcurrent\fP figure doesn't exist"
|
|
.ft R
|
|
.RS
|
|
The given connector does not exist in the current figure.
|
|
.RE
|
|
.SH EXAMPLE
|
|
.nf
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
#include <genlib.h>
|
|
main()
|
|
{
|
|
/\(** Create a figure to work on \(**/
|
|
DEF_PHFIG("cell");
|
|
.
|
|
.
|
|
PLACE_LEFT("gaer0_f", "insN", SYMXY);
|
|
.
|
|
.
|
|
DEF_AB(0L, 0L, 0L, 0L);
|
|
/\(** Put a connector \(**/
|
|
COPY_UP_CON("i0", 1, "insN", "inz0");
|
|
/\(** Save that on disk \(**/
|
|
SAVE_PHFIG();
|
|
}
|
|
.ft R
|
|
.fi
|
|
.SH SEE ALSO
|
|
.BR genlib (1),
|
|
.BR DEF_PHFIG (3),
|
|
.BR SAVE_PHFIG (3),
|
|
.BR COPY_UP_ALL_CON (3),
|
|
.BR COPY_UP_CON_FACE (3),
|
|
.BR PHCON (3),
|
|
.BR THRU_CON_H (3),
|
|
.BR THRU_CON_V (3).
|
|
|
|
|
|
.so man1/alc_bug_report.1
|
|
|