.\"   $Id: addphfig.3,v 1.1.1.1 2002/03/08 13:51:01 fred Exp $
.\" @(#)addphfig.2 2.11 91/08/22 ; Labo masi cao-vlsi; Author : Frederic Petrot
.if t \{\
.XS \n%
.ti 0.2i
addphfig
.XE
.XS0 \n%
.ti 0.2i
addphfig
.XE0 \}
.TH ADDPHFIG 3 "October 1, 1997" "ASIM/LIP6" "MBK PHYSICAL FUNCTIONS"
.SH NAME
addphfig \- create a new physical cell model 
.so jessie/alliance/alc_origin.1.en.gz
.SH SYNOPSYS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mph.h"
phfig_list \(**addphfig(figname)
char \(**figname;
.ft R
.fi
.SH PARAMETER
.TP 20
\fIfigname\fP
Name of the figure to be created
.SH DESCRIPTION
\fBaddphfig\fP creates a new figure called \fIfigname\fP and adds it to the
list of figure in memory. The new figure is added in front of the list, and
becomes itself the list head. No check is performed to see if a figure with
the \fIfigname\fP exists on disk. If it is the case, the preexisting file will
be erased while saving.
.br
The fields \fIPHCON\fP, \fIPHINS\fP, \fIPHSEG\fP, \fIPHVIA\fP, \fIPHREF\fP and
\fIUSER\fP are set to \fBNULL\fP.
.br
The fields \fIXAB1\fP,  \fIYAB1\fP,  \fIXAB2\fP,  \fIXAB2\fP are set to
\fB0L\fP.
.br
The field \fIMODE\fP is set to \fB'A'\fP.
.br
The field \fINEXT\fP points to the previous head of list.
.SH RETURN VALUE
\fBaddphfig\fP returns a pointer to the newly created figure.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"\(**\(**\(** mbk error \(**\(**\(** illegal addphfig figure \fIfigname\fP already exists"
.ft R
.RS
There is already a figure called \fIfigname\fP in memory, so it's impossible
to give this name to a cell to be created.
.RE
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mph.h"
phfig_list \(**get_the_fig(name)
char \(**name;
{
phfig_list \(**pt, \(**fill_fig(/\(** phfig_list \(** \(**/);
	/\(** scan figure list \(**/
	for (pt = HEAD_PHFIG; pt; pt = pt\->NEXT)
		if (!strcmp(pt\->NAME, figname))
			break;
	return pt ? pt : fill_fig(addphfig(figname));
}
.ft R
.fi
.SH SEE ALSO
.BR mbk (1),
.BR phfig (3),
.BR getphfig (3),
.BR delphfig (3),
.BR loadphfig (3),
.BR savephfig (3),
.BR flattenphfig (3),
.BR rflattenphfig (3).


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