magic/doc/html/flatten.html

82 lines
2.7 KiB
HTML

<HTML>
<HEAD>
<STYLE type="text/css">
H1 {color: black }
H2 {color: maroon }
H3 {color: #007090 }
A.head:link {color: #0060a0 }
A.head:visited {color: #3040c0 }
A.head:active {color: white }
A.head:hover {color: yellow }
A.red:link {color: red }
A.red:visited {color: maroon }
A.red:active {color: yellow }
</STYLE>
</HEAD>
<TITLE>Magic-7.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title2.gif ALT="Magic VLSI Layout Tool Version 7.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>flatten</H2>
<HR>
Flatten edit cell into the indicated destination cell.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>flatten</B> <I>cellname</I> [<I>option</I>] <BR><BR>
<BLOCKQUOTE>
where <I>cellname</I> is the name of a cell definition to be
created, and into which the flattened geometry will be placed.
<I>option</I> may be one of <B>-nolabels</B>, <B>-nosubcircuit</B>,
or <B>-novendor</B>.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>flatten</B> command creates a new cell with the indicated
name, then flattens the hierarchy of the current edit cell and
copies the result into the new cell. <P>
The options allow selective flattening, as follows:
<DL>
<DT> <B>-nolabels</B>
<DD> Prevents magic from copying labels into the flattened cell.
Otherwise, magic flattens labels by prepending the cell
hierarchy to each label as it copies it into the flat cell.
<DT> <B>-nosubcircuit</B>
<DD> Prevents magic from flattening cells declared to be subcircuits
(by the presence of ports in the cell). These cells are
retained as subcells in the flattened version.
<DT> <B>-novendor</B>
<DD> Prevents magic from flattening cells that are vendor cells,
that is, cells that are generated by reading GDS using the
<B>gds readonly</B> option, or which have the appropriate
property values set.
</DL>
Note that <I>cellname</I> is a top-level cell but is not displayed
or saved subsequent to the <B>flatten</B> command. The usual
procedure is to follow the command "<B>flatten</B> <I>cellname</I>"
with "<B>load</B> <I>cellname</I>", to view the new flattened
layout.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>flatten</B> is implemented as a built-in command in <B>magic</B>.
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
<TR>
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 8:04pm <P>
</BODY>
</HTML>