.\"   $Id: GENLIB_WIRE1.3,v 1.1 2002/03/08 14:08:11 fred Exp $
.\" @(#)GENLIB_WIRE1.3 2.11 91/08/22 ; Labo Cao-vlsi; Author : Frederic Petrot
.if t \{\
.XS \n%
.ti 0.2i
GENLIB_WIRE1
.XE \}
.TH GENLIB_WIRE1.3 "October 1, 1997" "ASIM/LIP6" "PROCEDURAL GENERATION LANGUAGE"
.SH NAME
GENLIB_WIRE1 \- place a physical segment in the current figure
.SH SYNOPSYS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
void GENLIB_WIRE1(layer, width, ins1, con1, index1, ins2, con2, index2)
char layer;
long width;
char \(**ins1, \(**con1, \(**ins2, \(**con2;
.ft R
.fi
.so buster/alliance/alc_origin.1.en.gz
.SH PARAMETERS
.TP 20
\fIlayer\fP
Layout layer of the segment
.TP
\fIwidth\fP
Width of the segment
.TP
\fIins1\fP
Name of the instance in which the connector \fIcon1\fP is to be looked for
.TP
\fIcon1\fP
Name of a connector, or reference, used as first endpoint of the wire
.TP
\fIins2\fP
Name of the instance in which the connector \fIcon2\fP is to be looked for
.TP
\fIcon2\fP
Name of a connector, or reference, used as last endpoint of the wire
.SH DESCRIPTION
\fBWIRE1\fP adds a segment made of the \fIlayer\fP level in the current
layout cell, the starting point
beeing the connector, or reference, \fIcon1\fP of the instance \fIins1\fP, and
the ending point beeing the connector, or reference, \fIcon2\fP of the instance
\fIins1\fP. The segment is drawn between the coordinates of \fIcon1\fP in
the current figure and the
coordinates of \fIcon2\fP in the current figure. 
.LP
If the endpoints are connectors, the indexes \fIindex1\fP and \fIindex2\fP must
respectivly refer to \fIcon1\fP and \fIcon2\fP.
If they are references, then they are not taked care of.
One shall notice that connectors and references of a given model should not
share names if \fBWIRE1\fP is to be used.
.LP
The \fIlayer\fP argument can take the following legal values :
.RS
.TP
\fBNWELL\fP 
.TP
\fBPWELL\fP 
.TP
\fBNTIE\fP 
.TP
\fBPTIE\fP 
.TP
\fBNDIF\fP 
.TP
\fBPDIF\fP 
.TP
\fBNTRANS\fP 
.TP
\fBPTRANS\fP 
.TP
\fBPOLY\fP 
.TP
\fBALU1\fP 
.TP
\fBALU2\fP 
.TP
\fBALU3\fP 
.TP
\fBTPOLY\fP 
.TP
\fBTALU1\fP 
.TP
\fBTALU2\fP 
.TP
\fBTALU3\fP 
.RE
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"GENLIB_WIRE1 impossible : missing GENLIB_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 an instance inside it.
you must call \fBDEF_PHFIG\fP before any other layout action.
.RE
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"illegal addphseg : x1, y1, x2, y2"
.ft R
.RS
A symbolic segment must be either vertical or horizontal, so either
\fIx1 = x2\fP, or \fIy1 = y2\fP. Since \fBWIRE1\fP creates a segment from
relative coordinates, care must be taken to follow the previous rule.
.RE
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"GENLIB_WIRE1 impossible : same name \fIconX\fP, for connector and reference in
\fIinsX\fP"
.ft R
.RS
The model of the instance \fIinsX\fP has both a connector and a reference
that matches the \fIconX\fP name. This is not legal since genlib doesn't know
which one to choose as point.
.RE
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"illegal getphins : instance \fIinsX\fP does not exist"
.ft R
.RS
The instance called \fIinsX\fP does not currently belong to the figure.
.RE
.SH EXAMPLE
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
main()
{
	/\(** Create a figure to work on  \(**/
	GENLIB_DEF_PHFIG("cell");
	GENLIB_PLACE("gaci0_b", "r_addin_1", NOSYM, 0, 0);
	GENLIB_PLACE_RIGHT("gapgn_b", "pg", NOSYM);
	GENLIB_PLACE_RIGHT("gacin_b", "r_addin_2", NOSYM);
	/\(** Draw a segment \(**/
	GENLIB_WIRE1(ALU1, 1, "r_addin_1", "out", 0L, "r_addin_2", "in", 1L);
	/\(** Save that on disk \(**/
	GENLIB_SAVE_PHFIG();
}
.ft R
.fi
.SH SEE ALSO
.BR genlib (1),
.BR GENLIB_DEF_PHFIG (3),
.BR GENLIB_SAVE_PHFIG (3),
.BR GENLIB_COPY_UP_SEG (3),
.BR GENLIB_PHSEG (3),
.BR GENLIB_THRU_H (3),
.BR GENLIB_THRU_CON_H (3),
.BR GENLIB_THRU_V (3),
.BR GENLIB_THRU_CON_V (3),
.BR GENLIB_WIRE2 (3),
.BR GENLIB_WIRE3 (3).


.so buster/alliance/alc_bug_report.1.en.gz