luke
/
magic
mirror of https://github.com/RTimothyEdwards/magic.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated all of the documentation by copying back from the website. 

The website documentation now points to these contents in a clone
of the repository on opencircuitdesign.com, so all future edits of
the command-line documentation will be made directly to the git
repository.  Also:  Changed the precision of box values printed in
microns from 2 to 3 digits after the decimal place, so that 5 nanometer
grids do not get values clipped in the output.
This commit is contained in:
Tim Edwards 2022-01-21 10:44:13 -05:00
parent 5629c2a6cd
commit 09577b5636
146 changed files with 2436 additions and 693 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
commands/CmdAB.c
View File

@ -1118,13 +1118,13 @@ CmdBox(w, cmd)
if (area > 0)
TxPrintf(" area (units^2)");
TxPrintf("\n\nmicrons: %6.2f x %-6.2f (% 6.2f, % -6.2f), "
"(% 6.2f, % -6.2f)",
TxPrintf("\n\nmicrons: %6.3f x %-6.3f (% 6.3f, % -6.3f), "
"(% 6.3f, % -6.3f)",
(float)width *oscale, (float)height * oscale,
(float)boxptr->r_xbot * oscale, (float)boxptr->r_ybot * oscale,
(float)boxptr->r_xtop * oscale, (float)boxptr->r_ytop * oscale);
if (area > 0)
TxPrintf(" %-10.2f", (float)area * oscale * oscale);
TxPrintf(" %-10.3f", (float)area * oscale * oscale);
TxPrintf("\nlambda:");
if (DBLambda[0] != DBLambda[1])

4
doc/html/addcommandentry.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>addcommandentry</H2>
@ -67,6 +67,6 @@ Generate a new frame for command-line entry.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 5, 2004 at 3:19am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/addpath.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>addpath</H2>
@ -67,6 +67,6 @@ Append to current search path
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 3, 2004 at 6:53am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

86
doc/html/antennacheck.html Normal file
View File

@ -0,0 +1,86 @@
<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_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>antennacheck</H2>
<HR>
Run antenna violation checks on the current edit cell.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>antennacheck</B> [<I>option</I>] <BR><BR>
<BLOCKQUOTE>
where <I>option</I> may be one of the following:
<DL>
<DT> <B>run</B>
<DD> "<B>antennacheck run</B>" is equivalent to "<B>antennacheck</B>"
with no arguments, and causes an antenna violation check to be
run.
<DT> <B>debug</B>
<DD> Sets up debug mode for the next antenna run. In addition to
feedback entries, additional information will be printed to
the terminal about each error encountered.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>antennacheck</B> command runs a full check for antenna violations
on the entire area of the cell being edited. Antenna violations are
defined in the technology file as the ratios of metal area to sensitive
MOSFET transistor gate areas to which the metal is attached. The antenna
effect is a manufacturing problem caused by charge buildup on gates
during metal etching. The metal being etched forms an antenna that
gathers charge on the net connected to the gate. If the area of metal
is large enough the gate can be destroyed by the process of etching.
The foundry specifies what the area ratio limit must be. The check is
done progressively from the lowest metal layer to the highest. If
violations are found, then feedback entries are created covering the
area of both the gate and the metal layer at which the violation occurred.
<P>
The <B>extract</B> command must be run prior to <B>antennacheck</B> to
obtain the extracted characteristics of the design, so that all
sensitive transistor gates can be identified and enumerated. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>antennacheck</B> is implemented as a built-in <B>magic</B> command.
The <B>antennacheck</B> command was introduced in magic version
8.2.150 along with technology file extensions to support the antenna
rule violations (see the online Maintainer's Manual #2).
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=extract.html><I>extract</I></A> <BR>
</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> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/array.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>array</H2>
@ -113,6 +113,6 @@ Array everything in the current selection
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:20pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

12
doc/html/box.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>box</H2>
@ -59,6 +59,8 @@ Move box dist units in direction or (with no arguments) show box size.
<DD> Reposition a box corner
<DT> <B>exists</B>
<DD> Is the cursor box present?
<DT> <B>remove</B>
<DD> Make the cursor box disappear from the window
<DT> <B>help</B>
<DD> Print help information
</DL>
@ -81,6 +83,12 @@ Move box dist units in direction or (with no arguments) show box size.
(see above). The <B>-edit</B> switch causes coordinate values
to be reported relative to the origin of the current edit cell,
if the edit cell is not the topmost cell in the layout window. <P>
<B>NOTE:</B> Prior to magic 8.1.43, the "<B>-edit</B>" switch
did not work with "<B>position</B>". Starting from magic
8.1.43, "<B>-edit</B>" works with any <B>box</B> option and
returns values in the coordinate system of the child cell, if
the current edit cell is not the topmost cell in the window. <P>
For a discussion of valid distances, see the page
<A HREF=distance.html><I>distance</I></A>. This includes
@ -142,6 +150,6 @@ Move box dist units in direction or (with no arguments) show box size.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 8, 2004 at 2:53pm <P>
<P><I>Last updated:</I> October 8, 2020 at 1:53pm <P>
</BODY>
</HTML>

189
doc/html/calma.html
View File

@ -1,189 +0,0 @@
<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>gds, calma</H2>
<HR>
Read GDSII input or generate GDSII output.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>gds</B> [<I>option</I>] <BR><BR>
<B>calma</B> [<I>option</I>] <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
<DT> <B>help</B>
<DD> Print usage information
<DT> <B>arrays</B> [<B>yes</B>|<B>no</B>]
<DD> Output arrays as individual subuses (like in CIF). Default
is "no". Normally there is no reason to do this.
<DT> <B>contacts</B> [<B>yes</B>|<B>no</B>]
<DD> Causes contacts to be written to the GDS file as subcell
arrays (experimental, introduced in version 7.3.55). This
method can produce very efficient output compared to writing
each contact cut square separately.
<DT> <B>flatten</B> [<B>yes</B>|<B>no</B>]
<DD> Flatten simple cells (e.g., contacts) on input. This helps
magic to use its contact-area representation of contacts,
and can also avoid situations where contacts are lost or
translated to "generic" types because the arrayed part of
the contacts is missing one or more residue layers.
<DT> <B>ordering</B> [<B>yes</B>|<B>no</B>]
<DD> Forces post-ordering of subcells read from a GDS file; that
is, if a cell use is encountered before it is defined, magic
will read through the remainder of the file until it finds
the definition, read it, and then return to the original file
position to continue reading. This option is always enabled
when using <B>gds flatten</B>. Otherwise, the default behavior
is <B>ordering no</B> to avoid lengthy searches through the
GDS stream file.
<DT> <B>labels</B> [<B>yes</B>|<B>no</B>]
<DD> Cause labels to be output when writing GDSII. Default
is "yes". Normally there is no reason not to do this.
<DT> <B>lower</B> [<B>yes</B>|<B>no</B>]
<DD> Allow both upper and lower case in labels. Default is "yes".
<DT> <B>read</B> <I>file</I>
<DD> Read GDSII format from file <I>file</I> into the edit cell.
If <I>file</I> does not have a file extension, then <B>magic</B>
searches for a file named <I>file</I>, <I>file</I>.gds,
<I>file</I>.gds2, or <I>file</I>.strm.
<DT> <B>readonly</B> [<B>yes</B>|<B>no</B>]
<DD> Set cell as "read-only". This has the effect of marking each
cell definition (using the <B>property</B> method) with the
start and end positions of the cell definition in the input
file. In subsequent output, the cell definition will be
transferred verbatim from the input to the output file. This
is useful for 3rd-party standard cells or pad cells where the
original GDS is trusted and it is desirable to bypass the
boolean operators of <B>magic</B>'s GDS reader and writer to
prevent the layout from being altered. Note that "read-only"
layout can be written to a <TT>.mag</TT> file, but the
contents of this file are representational only. It can
be useful to keep a simplified respresentation in the case
of pad cells or digital standard cells, for example, by
reading them using a GDS input style that defines only metal
layers.
<DT> <B>rescale</B> [<B>yes</B>|<B>no</B>]
<DD> Allow or disallow internal grid subdivision while reading
GDS input. Default is "yes". Normally, one wants to allow
rescaling to ensure that the GDS is displayed exactly as it
is in the input file. Occasionally, however, the GDS input
is on a very fine scale, such as nanometers, and it is
preferable to snap the input to lambda boundaries rather
than to subsplit the internal grid to such a fine value.
The "<B>cif limit</B>" function may also be used to limit
grid subdivision to a minimum value.
<DT> <B>warning</B> [<I>option</I>]
<DD> Set warning information level. "<I>option</I>" may be one
of the following:
<DL>
<DT><B>default</B>
<DD> The default setting is equivalent to all the other
options (<B>align</B>, <B>limit</B>, <B>redirect</B>,
and <B>none</B>) being disabled.
<DT><B>align</B>
<DD> Generate warnings during a "<B>cif see</B>" command
if the alignment of geometry is on fractional lambda.
Normally, magic allows contacts to be drawn at
half-lambda positions. If this violates DRC requirements
for the minimum output grid, this warning setting can be
used to detect such violations.
<DT><B>limit</B>
<DD> Limit warnings to the first 100 warnings or errors only.
<DT><B>redirect</B> [<I>file</I>]
<DD> Redirect all warnings to an output file named <I>file</I>.
If <I>file</I> is not given, then redirection is disabled.
<DT><B>none</B>
<DD> Do not produce any warning messages on GDS input.
</DL>
<DT> <B>write</B> <I>file</I>
<DD> Output GDSII format to "<I>file</I>" for the window's root cell.
<DT> <B>polygon subcells</B> [<B>yes</B>|<B>no</B>]
<DD> Put non-Manhattan polygons into subcells. Default is "no".
Normally this option is not needed. However, input layout
that defines a number of angled wires, particularly those
that are closely spaced, can cause <B>magic</B> to generate
literally millions of internal tiles. This tends to be
true in particular for corner cells in padframes for deep
submicron feature sizes, where the angled corners are
required to meet the DRC specification. When set to "yes",
each polygon encountered in the GDS input is placed in its
own uniquely-named subcell. This prevents interations with
other polygons on the same plane and so reduces tile splitting.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>gds</B> command reads or produces GDSII output (also known as
"stream" output, or "calma" output after the name of the company
that invented the format), or sets various parameters affecting
the GDS input and output. In magic, the GDS read and write routines
are a subset of the CIF read and write routines, and so it is
important to note that certain <B>cif</B> command options (q.v.) also
affect GDS input and output. In particular, <B>cif istyle</B> and
<B>cif ostyle</B> set the input and output styles from the technology
file, respectively. <P>
If no option is given, a CALMA GDS-II stream file is produced for the
root cell, with the default name of the root cell definition and the
filename extension ".gds". <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>gds</B> is implemented as a built-in function in <B>magic</B>.
The <B>calma</B> command is an alias for <B>gds</B> and is
exactly equivalent.
</BLOCKQUOTE>
<H3>Bugs:</H3>
<BLOCKQUOTE>
<UL>
<LI> The <B>cif</B> command options that affect GDS input and output
should <I>really</I> be duplicates as options of the GDS command.
<LI> GDS input is "interpreted" through boolean operations in the
technology file definition, and so it is not guaranteed that
all input will be read correctly.
<LI> Not all non-Manhattan geometry is read correctly.
<LI> The input can be fouled up if the magic grid is rescaled during
input. This error can be avoided by scaling the grid prior
to GDS read-in.
<LI> "polygon subcells" in GDS creates a duplicate image of the
layout read into the subcells; this needs to be fixed.
</UL>
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=cif.html><B>cif</B></A> <BR>
</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 3:17pm <P>
</BODY>
</HTML>

1
doc/html/calma.html Symbolic link
View File

@ -0,0 +1 @@
gds.html

4
doc/html/caption.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>caption</H2>
@ -58,6 +58,6 @@ Configures the titlebar of the GUI wrapper on a layout window
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 3, 2004 at 8:01am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/cellmanager.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>cellmanager</H2>
@ -164,6 +164,6 @@ Invoke the cell manager GUI window
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 12:47am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

36
doc/html/cellname.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>cellname</H2>
@ -32,6 +32,9 @@ Operations on cell definitions.
<DT> [<B>list</B>] <B>children</B> [<I>name</I>]
<DD> List all of the children definitions of cell <I>name</I>,
or the children of the currently selected cell instance.
<DT> [<B>list</B>] <B>childinst</B> [<I>name</I>]
<DD> List all of the children instances of cell <I>name</I>,
or the children of the currently selected cell instance.
<DT> [<B>list</B>] <B>parent</B> [<I>name</I>]
<DD> List the parent cell definition of cell <I>name</I>,
or the parent of the currently selected cell instance.
@ -74,6 +77,11 @@ Operations on cell definitions.
will be prohibited. If the cell <I>name</I> is currently
the topmost cell in the window, the window will be loaded
with default cell "(UNNAMED)".
<DT> <B>dereference</B> <I>name</I>
<DD> Perform a flush of the cell (per the "<B>flush</B>" command),
first removing any file path associated with the cell, so
that the cell will be reloaded from the first valid location
found using the search paths.
<DT> <B>flags</B>
<DD> Reports flag settings for the cell. Flags which are reported
are "available", "modified", and "readonly". Flag "available"
@ -81,7 +89,27 @@ Operations on cell definitions.
"modified" is true if layout changes have been made to the
cell. Flag "readonly" is true if the cell has been locked to
prevent edits.
<DT> <B>writeable</B> [<B>true</B>|<B>false</B>]
<DT> <B>timestamp</B> <I>name</I> [<I>value</I>]
<DD> Reports or sets the cell timestamp value. Note that timestamps
should be handled automatically, so setting the timestamp is
discouraged outside of limited functions like creating cell
libraries. The timestamp is in the usual integer format and
can be printed as a human-readable date using the Tcl <B>clock</B>
command, e.g., "<TT>clock format [cellname timestamp]</TT>".
<DT> <B>filepath</B> <I>name</I> [<B>default</B>|<I>pathname</I>]
<DD> With no option, this command returns the path to the file
for the cell <I>name</I>, or the keyword "<B>default</B>"
if the cell is not associated with a specific file path.
With option "<B>default</B>", if the cell is associated
with a specific file path, that association is removed.
With option "<I>pathname</I>", the cell is associated with
the given file path. Note that this is meant to be used
to resolve issues with database libraries being moved
from one location or another. More typically, the
"<B>save</B>" command should be used to create a copy
of the (possibly modified) cell in a new location. Changing
the filepath will not perform any disk reads or writes.
<DT> <B>writeable</B> <I>name</I> [<B>true</B>|<B>false</B>]
<DD> Option <B>writeable false</B> makes the current cell
read-only and therefore prevents any edits from being
written to disk. If magic is compiled with file-locking,
@ -132,6 +160,8 @@ Operations on cell definitions.
<BLOCKQUOTE>
<A HREF=instance.html><B>instance</B></A> <BR>
<A HREF=load.html><B>load</B></A> <BR>
<A HREF=path.html><B>path</B></A> <BR>
<A HREF=flush.html><B>flush</B></A> <BR>
<A HREF=tk_path_name.html><I>tk_path_name</I></A> <BR>
</BLOCKQUOTE>
@ -141,6 +171,6 @@ Operations on cell definitions.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 5:38pm <P>
<P><I>Last updated:</I> February 3, 2021 at 3:52pm <P>
</BODY>
</HTML>

4
doc/html/cellsearch.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>cellsearch</H2>
@ -108,6 +108,6 @@ Execute a TCL procedure on each cell definition or instance in the hierarchy
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 5:05am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

8
doc/html/center.html
View File

@ -1,7 +1,3 @@
center [x y]
<HTML>
<HEAD>
<STYLE type="text/css">
@ -19,7 +15,7 @@ center [x y]
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>center</H2>
@ -70,6 +66,6 @@ or the indicated coordinate if present.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 3:59am <P>
<P><I>Last updated:</I> January 15, 2021 at 12:47pm <P>
</BODY>
</HTML>

4
doc/html/changetool.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>tool</H2>
@ -145,6 +145,6 @@ version of the command used by the Tcl version of magic.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 5:25pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/channels.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>channels</H2>
@ -59,6 +59,6 @@ See channels (as feedback) without doing routing.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 5:13am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

85
doc/html/cif.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>cif</H2>
@ -32,25 +32,36 @@ Read CIF input or generate CIF output.
<DT> <B>help</B>
<DD> Print usage information
<DT> <B>arealabels</B> [<B>yes</B>|<B>no</B>]
<DD> Enable/diable use of the CIF area label extension. The
<DD> Enable/disable use of the CIF area label extension. The
default is "yes". Normally there is no reason not to
do this.
<DT> <B>coverage</B> <I>layer</I>
<DT> [<B>list</B>] <B>coverage</B> <I>layer</I> [<B>box</B>]
<DD> Report the coverage of the indicated CIF layer within the
bounds of the current edit cell. This is useful for
fabrication processes that require a minimum amount of
coverage for specific layers (usually the metal routing
layers).
layers). With option <B>list</B> in front, return only
the coverage value, as a decimal. Otherwise, the value
is returned as a percentage, with additional diagnostic
information about the area analyzed. <P>
With option "<B>box</B>", report the density inside the
cursor box area only.
<DT> <B>idcell</B> [<B>yes</B>|<B>no</B>]
<DD> Enable/diable use of the CIF cell ID extension. The
<DD> Enable/disable use of the CIF cell ID extension. The
default is "yes". Normally there is no reason not to
do this.
<DT> <B>lambda</B> <B>in</B>|<B>out</B>
<DD> Report the number of microns per lambda for the current
style. If "<B>in</B>" is specified, the value is
reported for the current CIF/GDS input style. If
"<B>out</B>" is specified, the value is reported for
the current CIF/GDS output style.
<DT> <B>scale</B> <B>in</B>|<B>out</B>
<DD> Report the number of microns per internal unit for
the current style. If "<B>in</B>" is specified,
the value is reported for the current CIF/GDS input
style. If "<B>out</B>" is specified, the value is
reported for the current CIF/GDS output style. <P>
<I>Warning:</I> For a long time (prior to magic 8.0.180),
this function was
"<B>cif lambda in</B>|<B>out</B>" and claimed to
return the number of microns per lambda. For
backwards compatibility, this syntax is retained,
but its use is discouraged.
<DT> <B>limit</B> [<I>value</I>]
<DD> Limit the amount of internal grid subdivision to the
indicated value (which is dimensionless, the ratio
@ -70,6 +81,12 @@ Read CIF input or generate CIF output.
than to subsplit the internal grid to such a fine value.
The <B>limit</B> option may also be used to limit grid
subdivision to a minimum value (see above).
<DT> <B>drccheck</B> [<B>yes</B>|<B>no</B>]
<DD> (Introduced in Magic version 8.0.176) Set to "yes" by
default, causing all cells in the input file to be
marked as not checked by DRC as they are input. Set this
to "no" to force magic to treat the CIF cells as "known
DRC clean".
<DT> <B>warning</B> [<I>option</I>]
<DD> Set warning information level. "<I>option</I>" may be one
of the following:
@ -105,6 +122,18 @@ Read CIF input or generate CIF output.
each polygon encountered in the CIF input is placed in its
own uniquely-named subcell. This prevents interations with
other polygons on the same plane and so reduces tile splitting.
<DT> <B>paint</B> <I>cif_layers</I> <I>magic_layer</I> [<I>cellname</I>]
<DD> Generate the CIF layer(s) specified by <I>cif_layers</I>,
then import them into the Magic database as layer
<I>magic_layer</I>. If <I>cellname</I> is specified, then
the paint is generated in that cell (which will be created,
if it does not already exist). Otherwise, paint is generated
directly in the edit cell. This is a very useful function,
as it allows the automatic generation of layout from boolean
operations. Principal uses are to auto-generate fill
patterns, auto-generate obstruction geometry in a standard
cell, to automatically place substrate and well contacts
into a standard-cell array, and so forth.
<DT> <B>see</B> <I>layers</I>
<DD> View the CIF/GDS output layers in the comma-separated list
<I>layers</I> as feedback entries on the layout. This is
@ -154,6 +183,38 @@ Read CIF input or generate CIF output.
<DD> Output CIF format to "<I>file</I>" for the window's root cell.
</DL>
</BLOCKQUOTE>
<BLOCKQUOTE>
<BR>
"Wizard" options: Where <I>option</I> is one of the following:
<BR>
<DL>
<DT> <B>*hier</B> <I>layer</I>
<DD> This option is like "<B>cif see</B>" but shows the layers
that are generated as the result of hierarchical interactions
between subcells (not including interactions between components
of a subcell array; see below).
<DT> <B>*array</B> <I>layer</I>
<DD> This option is like "<B>cif see</B>" but shows the layers
that are generated as the result of hierarchical interactions
between components of subcell arrays.
<DT> <B>*hier write</B> [ <B>enable</B> | <B>disable</B> ]
<DD> This sets a global option that enables (default) or disables
the generation of output CIF or GDS layers due to interaction
between subcells (not including inter-array interactions;
see below). For large standard cell layouts where the
standard cells are known to abut properly without causing
spacing or overlap errors, disabling hierarchical generation
can greatly reduce the amount of time needed to generate
output.
<DT> <B>*array write</B> [ <B>enable</B> | <B>disable</B> ]
<DD> This sets a global option that enables (default) or disables
the generation of output CIF or GDS layers due to interaction
between components of subcell arrays. If cells are known to
abut properly without generating spacing errors between them,
disabling hierarchical generation can greatly reduce the
amount of time needed to generate output.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
@ -188,6 +249,6 @@ Read CIF input or generate CIF output.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 8:03am <P>
<P><I>Last updated:</I> February 8, 2021 at 11:12am <P>
</BODY>
</HTML>

4
doc/html/clockwise.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>clockwise</H2>
@ -73,6 +73,6 @@ Rotate the selection and box clockwise
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 15, 2004 at 10:09am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/closewindow.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>closewindow</H2>
@ -69,6 +69,6 @@ Close a (non-GUI) window
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 10, 2004 at 6:08pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/closewrapper.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>closewrapper</H2>
@ -66,6 +66,6 @@ Close a GUI layout window and all of its associated frames.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 12:45am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

91
doc/html/commands.html
View File

@ -15,7 +15,7 @@
</HEAD>
<TITLE>Magic-7.4 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title2.gif ALT="Magic VLSI Layout Tool Version 7.4">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H1> Magic User's Guide </H1>
@ -364,182 +364,182 @@
<TR>
<TD> <A HREF=addcommandentry.html><B>addcommandentry</B></A><TD>
<TD> <A HREF=addpath.html> <B>addpath</B></A><TD>
<TD> <A HREF=array.html> <B>array</B></A><TD>
<TD> <A HREF=antennacheck.html> <B>antennacheck</B></A><TD>
</TR>
<TR>
<TD> <A HREF=array.html> <B>array</B></A><TD>
<TD> <A HREF=box.html> <B>box</B></A><TD>
<TD> <A HREF=calma.html> <B>calma</B></A><TD>
<TD> <A HREF=caption.html> <B>caption</B></A><TD>
</TR>
<TR>
<TD> <A HREF=caption.html> <B>caption</B></A><TD>
<TD> <A HREF=cellmanager.html> <B>cellmanager</B></A><TD>
<TD> <A HREF=cellname.html> <B>cellname</B></A><TD>
<TD> <A HREF=cellsearch.html> <B>cellsearch</B></A><TD>
</TR>
<TR>
<TD> <A HREF=cellsearch.html> <B>cellsearch</B></A><TD>
<TD> <A HREF=channels.html> <B>channels</B></A><TD>
<TD> <A HREF=cif.html> <B>cif</B></A><TD>
<TD> <A HREF=clockwise.html> <B>clockwise</B></A><TD>
</TR>
<TR>
<TD> <A HREF=clockwise.html> <B>clockwise</B></A><TD>
<TD> <A HREF=closewrapper.html> <B>closewrapper</B></A><TD>
<TD> <A HREF=contact.html> <B>contact</B></A><TD>
<TD> <A HREF=copy.html> <B>copy</B></A><TD>
</TR>
<TR>
<TD> <A HREF=copy.html> <B>copy</B></A><TD>
<TD> <A HREF=corner.html> <B>corner</B></A><TD>
<TD> <A HREF=crash.html> <B>crash</B></A><TD>
<TD> <A HREF=crashbackups.html> <B>crashbackups</B></A><TD>
</TR>
<TR>
<TD> <A HREF=crashbackups.html> <B>crashbackups</B></A><TD>
<TD> <A HREF=crosshair.html> <B>crosshair</B></A><TD>
<TD> <A HREF=def.html> <B>def</B></A><TD>
<TD> <A HREF=delete.html> <B>delete</B></A><TD>
</TR>
<TR>
<TD> <A HREF=delete.html> <B>delete</B></A><TD>
<TD> <A HREF=deletecommandentry.html> <B>deletecommandentry</B></A><TD>
<TD> <A HREF=down.html> <B>down</B></A><TD>
<TD> <A HREF=drc.html> <B>drc</B></A><TD>
</TR>
<TR>
<TD> <A HREF=drc.html> <B>drc</B></A><TD>
<TD> <A HREF=dump.html> <B>dump</B></A><TD>
<TD> <A HREF=edit.html> <B>edit</B></A><TD>
<TD> <A HREF=element.html> <B>element</B></A><TD>
</TR>
<TR>
<TD> <A HREF=element.html> <B>element</B></A><TD>
<TD> <A HREF=erase.html> <B>erase</B></A><TD>
<TD> <A HREF=expand.html> <B>expand</B></A><TD>
<TD> <A HREF=ext.html> <B>ext</B></A><TD>
</TR>
<TR>
<TD> <A HREF=ext.html> <B>ext</B></A><TD>
<TD> <A HREF=ext2sim.html> <B>ext2sim</B></A><TD>
<TD> <A HREF=ext2spice.html> <B>ext2spice</B></A><TD>
</TR>
<TR>
<TD> <A HREF=extract.html> <B>extract</B></A><TD>
</TR>
<TR>
<TD> <A HREF=extresist.html> <B>extresist</B></A><TD>
<TD> <A HREF=exttosim.html> <B>exttosim</B></A><TD>
<TD> <A HREF=exttospice.html> <B>exttospice</B></A><TD>
<TD> <A HREF=ext2sim.html> <B>exttosim</B></A><TD>
</TR>
<TR>
<TD> <A HREF=ext2spice.html> <B>exttospice</B></A><TD>
<TD> <A HREF=feedback.html> <B>feedback</B></A><TD>
<TD> <A HREF=fill.html> <B>fill</B></A><TD>
<TD> <A HREF=findbox.html> <B>findbox</B></A><TD>
</TR>
<TR>
<TD> <A HREF=findbox.html> <B>findbox</B></A><TD>
<TD> <A HREF=findlabel.html> <B>findlabel</B></A><TD>
<TD> <A HREF=flatten.html> <B>flatten</B></A><TD>
<TD> <A HREF=flush.html> <B>flush</B></A><TD>
</TR>
<TR>
<TD> <A HREF=flush.html> <B>flush</B></A><TD>
<TD> <A HREF=garoute.html> <B>garoute</B></A><TD>
<TD> <A HREF=gds.html> <B>gds</B></A><TD>
<TD> <A HREF=get.html> <B>get</B></A><TD>
</TR>
<TR>
<TD> <A HREF=get.html> <B>get</B></A><TD>
<TD> <A HREF=getcell.html> <B>getcell</B></A><TD>
<TD> <A HREF=getnode.html> <B>getnode</B></A><TD>
<TD> <A HREF=goto.html> <B>goto</B></A><TD>
</TR>
<TR>
<TD> <A HREF=goto.html> <B>goto</B></A><TD>
<TD> <A HREF=grid.html> <B>grid</B></A><TD>
<TD> <A HREF=help.html> <B>help</B></A><TD>
<TD> <A HREF=identify.html> <B>identify</B></A><TD>
</TR>
<TR>
<TD> <A HREF=identify.html> <B>identify</B></A><TD>
<TD> <A HREF=initialize.html> <B>initialize</B></A><TD>
<TD> <A HREF=instance.html> <B>instance</B></A><TD>
<TD> <A HREF=iroute.html> <B>iroute</B></A><TD>
</TR>
<TR>
<TD> <A HREF=iroute.html> <B>iroute</B></A><TD>
<TD> <A HREF=irsim.html> <B>irsim</B></A><TD>
<TD> <A HREF=label.html> <B>label</B></A><TD>
<TD> <A HREF=lef.html> <B>lef</B></A><TD>
</TR>
<TR>
<TD> <A HREF=lef.html> <B>lef</B></A><TD>
<TD> <A HREF=load.html> <B>load</B></A><TD>
<TD> <A HREF=maketoolbar.html> <B>maketoolbar</B></A><TD>
<TD> <A HREF=measure.html> <B>measure</B></A><TD>
</TR>
<TR>
<TD> <A HREF=move.html> <B>move</B></A><TD>
<TD> <A HREF=measure.html> <B>measure</B></A><TD>
<TD> <A HREF=openwrapper.html> <B>openwrapper</B></A><TD>
<TD> <A HREF=paint.html> <B>paint</B></A><TD>
</TR>
<TR>
<TD> <A HREF=paint.html> <B>paint</B></A><TD>
<TD> <A HREF=path.html> <B>path</B></A><TD>
<TD> <A HREF=peekbox.html> <B>peekbox</B></A><TD>
<TD> <A HREF=plot.html> <B>plot</B></A><TD>
</TR>
<TR>
<TD> <A HREF=plot.html> <B>plot</B></A><TD>
<TD> <A HREF=plow.html> <B>plow</B></A><TD>
<TD> <A HREF=polygon.html> <B>polygon</B></A><TD>
<TD> <A HREF=popbox.html> <B>popbox</B></A><TD>
</TR>
<TR>
<TD> <A HREF=popbox.html> <B>popbox</B></A><TD>
<TD> <A HREF=popstack.html> <B>popstack</B></A><TD>
<TD> <A HREF=port.html> <B>port</B></A><TD>
<TD> <A HREF=promptload.html> <B>promptload</B></A><TD>
</TR>
<TR>
<TD> <A HREF=promptload.html> <B>promptload</B></A><TD>
<TD> <A HREF=promptsave.html> <B>promptsave</B></A><TD>
<TD> <A HREF=property.html> <B>property</B></A><TD>
<TD> <A HREF=pushbox.html> <B>pushbox</B></A><TD>
</TR>
<TR>
<TD> <A HREF=pushbox.html> <B>pushbox</B></A><TD>
<TD> <A HREF=pushstack.html> <B>pushstack</B></A><TD>
<TD> <A HREF=render3d.html> <B>render3d</B></A><TD>
<TD> <A HREF=resumeall.html> <B>resumeall</B></A><TD>
</TR>
<TR>
<TD> <A HREF=resumeall.html> <B>resumeall</B></A><TD>
<TD> <A HREF=rotate.html> <B>rotate</B></A><TD>
<TD> <A HREF=route.html> <B>route</B></A><TD>
<TD> <A HREF=save.html> <B>save</B></A><TD>
</TR>
<TR>
<TD> <A HREF=save.html> <B>save</B></A><TD>
<TD> <A HREF=scalegrid.html> <B>scalegrid</B></A><TD>
<TD> <A HREF=search.html> <B>search</B></A><TD>
<TD> <A HREF=see.html> <B>see</B></A><TD>
</TR>
<TR>
<TD> <A HREF=see.html> <B>see</B></A><TD>
<TD> <A HREF=select.html> <B>select</B></A><TD>
<TD> <A HREF=setlabel.html> <B>setlabel</B> <I>(version 8.0)</I></A><TD>
</TR>
<TR>
<TD> <A HREF=shell.html> <B>shell</B></A><TD>
<TD> <A HREF=sideways.html> <B>sideways</B></A><TD>
<TD> <A HREF=snap.html> <B>snap</B></A><TD>
</TR>
<TR>
<TD> <A HREF=snap.html> <B>snap</B></A><TD>
<TD> <A HREF=spliterase.html> <B>spliterase</B></A><TD>
<TD> <A HREF=splitpaint.html> <B>splitpaint</B></A><TD>
<TD> <A HREF=startup.html> <B>startup</B></A><TD>
</TR>
<TR>
<TD> <A HREF=startup.html> <B>startup</B></A><TD>
<TD> <A HREF=straighten.html> <B>straighten</B></A><TD>
<TD> <A HREF=stretch.html> <B>stretch</B></A><TD>
<TD> <A HREF=suspendall.html> <B>suspendall</B></A><TD>
</TR>
<TR>
<TD> <A HREF=suspendall.html> <B>suspendall</B></A><TD>
<TD> <A HREF=tag.html> <B>tag</B></A><TD>
<TD> <A HREF=tech.html> <B>tech</B></A><TD>
<TD> <A HREF=techmanager.html> <B>techmanager</B></A><TD>
</TR>
<TR>
<TD> <A HREF=techmanager.html> <B>techmanager</B></A><TD>
<TD> <A HREF=tool.html> <B>tool</B> <I>(non-Tcl version)</I></A><TD>
<TD> <A HREF=changetool.html> <B>tool</B> <I>(Tcl version)</I></A><TD>
<TD> <A HREF=unexpand.html> <B>unexpand</B></A><TD>
</TR>
<TR>
<TD> <A HREF=unexpand.html> <B>unexpand</B></A><TD>
<TD> <A HREF=unmeasure.html> <B>unmeasure</B></A><TD>
<TD> <A HREF=upsidedown.html> <B>upsidedown</B></A><TD>
<TD> <A HREF=what.html> <B>what</B></A><TD>
</TR>
<TR>
<TD> <A HREF=what.html> <B>what</B></A><TD>
<TD> <A HREF=wire.html> <B>wire</B></A><TD>
<TD> <A HREF=writeall.html> <B>writeall</B></A><TD>
</TR>
<TR>
<TD> <A HREF=xload.html> <B>xload</B></A><TD>
<TD></TD>
<TD></TD>
</TR>
</TBODY>
</TABLE>
@ -567,20 +567,21 @@
</TR>
<TR>
<TD> <A HREF=netlist/netlist.html><B>netlist</B></A><TD>
<TD> <A HREF=netlist/orient.html><B>orient</B></A><TD>
<TD> <A HREF=netlist/pushbutton.html><B>pushbutton</B></A><TD>
<TD> <A HREF=netlist/print.html><B>print</B></A><TD>
</TR>
<TR>
<TD> <A HREF=netlist/print.html><B>print</B></A><TD>
<TD> <A HREF=netlist/ripup.html><B>ripup</B></A><TD>
<TD> <A HREF=netlist/savenetlist.html><B>savenetlist</B></A><TD>
<TD> <A HREF=netlist/shownet.html><B>shownet</B></A><TD>
</TR>
<TR>
<TD> <A HREF=netlist/shownet.html><B>shownet</B></A><TD>
<TD> <A HREF=netlist/showterms.html><B>showterms</B></A><TD>
<TD> <A HREF=netlist/trace.html><B>trace</B></A><TD>
<TD> <A HREF=netlist/verify.html><B>verify</B></A><TD>
</TR>
<TR>
<TD> <A HREF=netlist/verify.html><B>verify</B></A><TD>
<TD> <A HREF=netlist/writeall.html><B>writeall</B></A><TD>
<TD></TD>
</TR>
@ -698,6 +699,6 @@ To be done:
<TD> <IMG BORDER=0 SRC=graphics/email_address.png>
</TR>
</TABLE>
<P><I>Last updated:</I> December 15, 2005 at 6:59am <P>
<P><I>Last updated:</I> April 11, 2021 at 11:07am <P>
</BODY>
</HTML>

8
doc/html/commands.list
View File

@ -1,5 +1,6 @@
addcommandentry
addpath
antennacheck
array
box
calma
@ -14,13 +15,16 @@ clockwise
closewindow
closewrapper
copy
contact
corner
crashbackups
cursor
def
delete
deletecommandentry
down
drc
drop
dump
edit
element
@ -57,6 +61,7 @@ iroute
label
lef
load
locking
logcommands
macro
maketoolbar
@ -68,6 +73,7 @@ path
peekbox
plot
plow
polygon
popbox
popstack
port
@ -78,6 +84,7 @@ pushbox
pushbutton
pushstack
quit
random
redo
redraw
render
@ -122,6 +129,7 @@ windowscrollbars
wire
writeall
xload
xor
xview
zoom
tk_path_name

4
doc/html/contact.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>contact</H2>
@ -55,6 +55,6 @@ Paint a contact at the intersection of two layers.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 8:18pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/copy.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>copy</H2>
@ -81,6 +81,6 @@ Make a copy of the selection.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 12:41am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/corner.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>corner</H2>
@ -93,6 +93,6 @@ Make L-shaped wires inside the cursor box.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 7:56am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

6
doc/html/crash.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>crash</H2>
@ -65,7 +65,7 @@ Handle crash backup files
<DT> <B>crash recover</B> <I>filename</I>
<DD> recovers the database from the contents of the saved crash
file <I>filename</I> upon successful read-in, the file
<I>filename</I> is removed. <B>
<I>filename</I> is removed. <P>
</DL>
If a crash file has been generated during a layout editing session,
@ -99,6 +99,6 @@ Handle crash backup files
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 7, 2005 at 3:06pm <P>
<P><I>Last updated:</I> January 12, 2021 at 10:10am <P>
</BODY>
</HTML>

27
doc/html/crashbackups.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>crashbackups</H2>
@ -25,7 +25,8 @@ Handle periodic backups during a layout editing session.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>crashbackups </B>[<B>start</B>|<B>stop</B>] <BR><BR>
<B>crashbackups </B>[<B>start</B>|<B>stop</B>|<B>resume</B>|<B>disable</B>]
<BR><BR>
</BLOCKQUOTE>
<H3>Summary:</H3>
@ -42,14 +43,30 @@ Handle periodic backups during a layout editing session.
<B>crashbackups stop</B> removes the timer callback and thus
prevents further writing of backup files. Note that if
crash recovery is stopped or started multiple times during
a session, the same filename is used to save the data.
a session, the same filename is used to save the data. <BR><BR>
<B>crashbackups resume</B> resumes running interval backups if
stopped using <B>crashbackups stop</B>. If the interval backups
have never been started, or have been disabled, this command
does nothing. <BR><BR>
<B>crashbackups disable</B> stops running interval backups and
resets to the state of never having started interval backups.
<B>resume</B> will have no effect in this state, and <B>start</B>
must be issued to start the interval backups again. <BR><BR>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>crashbackups</B> is implemented as a Tcl procedure in the
"tools.tcl" script file. It calls the magic command
"<B>crash save</B>".
"<B>crash save</B>". <BR><BR>
The crash backup interval is handled by the <B>itimer</B> system
subroutine. There is only one timer per process. A timer is also
used by some long-running commands such as <B>extract</B> to track
progress, so the crash backups must necessarily be suspended when
those commands are using the process timer.
</BLOCKQUOTE>
<H3>See Also:</H3>
@ -63,6 +80,6 @@ Handle periodic backups during a layout editing session.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 7, 2005 at 3:15pm <P>
<P><I>Last updated:</I> March 17, 2021 at 10:53am <P>
</BODY>
</HTML>

4
doc/html/crosshair.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>crosshair</H2>
@ -52,6 +52,6 @@ Implements a crosshair highlight on top of the layout.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 5:05pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

45
doc/html/cursor.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>cursor</H2>
@ -25,14 +25,36 @@ Return <B>magic</B> internal coordinates of the cursor (X11 pointer)
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>cursor</B> <BR><BR>
<B>cursor</B> <I>glyphnum</I> <BR><BR>
<B>cursor</B> [<B>internal</B>|<B>lambda</B>|<B>user</B>] <BR><BR>
<B>cursor</B> [<B>microns</B>|<B>window</B>|<B>screen</B>]
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>cursor</B> command returns the current position of the
cursor (the X11 pointer, not the <B>magic</B> cursor box) in
internal layout coordinates.
The <B>cursor</B> command has two distinct uses. When followed
by an integer value, the cursor glyph is changed to the indicated
glyph, as defined internally to Magic. <BR>
When used without an option, or when followed by a measurement
metric "internal", "lambda", or "user", the <B>cursor</B> command
returns the current position of the cursor (the X11 pointer, not
the <B>magic</B> cursor box) in layout coordinates. The coordinates
are given in the indicated metric, or in internal units by default. <P>
Magic version 8.1 defines the additional option "<B>microns</B>",
which is like the metrics mentioned above bug returns the current
position of the cursor in micron units, where the scalefactor for
determining micron units is defined by the current CIF/GDS output
style. <P>
Magic version 8.1 also defines two options for returning pixel
coordinates: Option "<B>window</B>" returns the pointer coordinate
in pixels from the bottom left-hand corner of the layout window.
Option "<B>screen</B>" returns the pointer coordinate in pixels
relative to the root screen. In X11, this is defined as the top
left-hand corner of the screen. This second form is useful for
interacting with the window manager, for example, to open up a new
window or drop-down menu next to the pointer position.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -45,11 +67,20 @@ Return <B>magic</B> internal coordinates of the cursor (X11 pointer)
if only one window is present, or the active window if called with
the "<TT>:</TT>" macro. Otherwise, it must be called using the
<I>tk_path_name</I> command to specify relative to which layout
window the cursor coordinates will be given.
window the cursor coordinates will be given. <P>
The value returned by <B>cursor</B> may be modified according to the
state set by the <B>snap</B> command. <B>cursor user</B> reports
units relative to the grid set by the <B>grid</B> command, which may
differ in aspect between the X and Y axes. <P>
Note, as stated above, which versions of magic support which options. <P>
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=snap.html><B>snap</B></A> <BR>
<A HREF=grid.html><B>grid</B></A> <BR>
<A HREF=tk_path_name.html><I>tk_path_name</I></A> <BR>
</BLOCKQUOTE>
@ -59,6 +90,6 @@ Return <B>magic</B> internal coordinates of the cursor (X11 pointer)
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 5, 2004 at 2:47am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

23
doc/html/def.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>def</H2>
@ -29,9 +29,9 @@ Read or write DEF format files.
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
<DT> <B>read</B> [<I>filename</I>]
<DT> <B>read</B> <I>filename</I> [<B>-labels</B>]
<DD> Read a DEF file <I>filename</I>[<B>.def</B>]
<DT> <B>write</B> [<I>cell</I>]
<DT> <B>write</B> [<I>cell</I>] [<B>-units</B> <I>value</I>]
<DD> Write DEF for current or indicated cell named <I>cell</I>
<DT> <B>help</B>
<DD> Print help information (command summary)
@ -55,6 +55,21 @@ Read or write DEF format files.
an appropriate LEF file exists and is read prior to writing a
DEF format file, the technology will be initialized from the
file if it is not declared in the technology file. <P>
Normally the DEF file is written in units of nanometers according to
the active GDS output scale (UNITS DISTANCE MICRONS 1000). If option
"<B>-units</B> <I>value</I>" is used, then the units indicated by
<I>value</I> are used instead of 1000. This option can be used, for
example, to preserve units when re-writing a DEF file that was read
with "<B>def read</B>". There is no guarantee that values can be
accurately represented at the specified scale. The <B>-units</B>
option was introduced in magic version 8.2.113. <P>
The "<B>-labels</B>" option to the "<B>def read</B>" command
causes each net in the NETS and SPECIALNETS sections of the DEF
file to be annotated with a label having the net name as the label
text. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -79,6 +94,6 @@ Read or write DEF format files.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 1:45am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/delete.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>delete</H2>
@ -50,6 +50,6 @@ Delete everything in selection
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 12:48am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/deletecommandentry.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>deletecommandentry</H2>
@ -60,6 +60,6 @@ Remove the GUI window frame for additional command-line entry.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 5, 2004 at 3:17am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/direction.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2><I>direction</I></H2>
@ -70,6 +70,6 @@ Valid direction options in magic
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 7:30am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/distance.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2><I>distance</I></H2>
@ -62,6 +62,6 @@ Valid distance specifications in magic.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 4, 2004 at 7:21am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/down.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>down</H2>
@ -57,6 +57,6 @@ Load selected cell into a window
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 5, 2004 at 3:27am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

60
doc/html/drc.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>drc</H2>
@ -33,9 +33,8 @@ Background design rule checker control and status.
<DD> Run checker and wait for it to complete
<DT> <B>check</B>
<DD> Recheck area under box in all cells
<DT> <B>count</B> [<B>total</B>]
<DD> Count error tiles in each cell under box. Option <B>total</B>
returns the total number of DRC error tiles in the cell.
<DT> <B>count</B>
<DD> Count and report error tiles in the edit cell.
<DT> <B>euclidean on</B>|<B>off</B>
<DD> Enable/disable Euclidean geometry checking
<DT> <B>find</B> [<I>nth</I>]
@ -75,6 +74,57 @@ Background design rule checker control and status.
step size.
</DL>
</BLOCKQUOTE>
<P>
The Tcl/Tk version of magic defines additional handling with the
"<B>list</B>" and "<B>listall</B>" keyword before the option name,
indicating that the information be passed back to the interpreter
as a list instead of being printed to the terminal window as text.
<P>
<B>drc list</B> <I>option</I> <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
<DT> <B>style</B>
<DD> Return the currently active DRC style name to the interpreter.
<DT> <B>count</B> [<B>total</B>]
<DD> Return the DRC error count as a list pair comprising the
edit cell name and the total number of errors found. With
<B>total</B>, returns just the count as an integer.
<DT> <B>find</B> [<I>nth</I>]
<DD> Return the error description of the next, or <I>nth</I>,
error to the interpreter.
<DT> <B>why</B>
<DD> Return the error description of all errors intersecting the
cursor box to the interpreter, as a list
</DL>
</BLOCKQUOTE>
<B>drc listall</B> <I>option</I> <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
<DT> <B>style</B>
<DD> Return a list of all available DRC styles to the interpreter.
<DT> <B>count</B> [<B>total</B>]
<DD> Return the DRC error count as a nested list, where each list
item is a pair comprising the cell name of the cell containing
the errors, and the total number of errors found. With
<B>total</B>, returns only the sum of all the values (probably
not very useful).
<DT> <B>why</B>
<DD> Return a nested list containing a detailed description of all
errors intersecting the cursor box to the interpreter. In the
topmost list, every other entry is the text description of a
DRC error class. The list item following the DRC error
description is a list of all errors of that type. Each error
is presented as a list of four values indicating the bounding
box of the error, as {<I>llx lly urx ury</I>} values in
internal database units.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
@ -130,6 +180,6 @@ Background design rule checker control and status.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 5:39pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

80
doc/html/drop.html Normal file
View File

@ -0,0 +1,80 @@
<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_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>drop</H2>
<HR>
Paint into descendents of the current edit cell coincident with a selection.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>drop</B> <I>layers</I> <BR><BR>
<BLOCKQUOTE>
where <I>layers</I> is a comma-separated list of types to paint.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>drop</B> command paints layer types into descendents of the
current edit cell where selected paint is found. Normally, paint and
erase operations will only change the current edit cell. Selections
can copy paint out of descendents of the current edit cell, but the
descendent cells are not themselves affected. This specialized
command scans an existing selection and determines from which
subcell each bit of paint in the selection was copied from. Then,
it paints <I>layers</I> back into those subcells in an area coincident
with the selected paint. <P>
The primary reason this command was created was to deal with regions
such as a pwell region inside a deep nwell. The pwell is often not
a layer in the GDS but is defined by the absence of nwell, over a
deep nwell layer. A drawn pwell is needed for magic to properly
extract the bulk terminal of any transistor in the pwell. But the
pwell must exist in the same cell as the transistor. After reading
GDS, a command sequence such as the following: "<B>select area dnwell ;
select intersect ~nwell ; drop pwell</B>" will ensure that the pwell
layer exists over the area inside a deep nwell p-region. <P>
Be aware that because other instances of a cell may exist outside of
the selection area, that all instances of a cell modified by <B>drop</B>
will be likewise modified. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>drop</B> is implemented as a built-in command in <B>magic</B>.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=select.html><B>select</B></A> <BR>
</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> March 25, 2021 at 9:48pm <P>
</BODY>
</HTML>

4
doc/html/dump.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>dump</H2>
@ -67,6 +67,6 @@ Copy contents of the indicated cell into the current edit cell.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 2:53am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/edit.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>edit</H2>
@ -49,6 +49,6 @@ Use selected cell as new edit cell
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 12:55am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

8
doc/html/element.html
View File

@ -1,5 +1,3 @@
<HTML>
<HEAD>
<STYLE type="text/css">
@ -17,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>element</H2>
@ -108,7 +106,7 @@ Handle generic drawing elements (line, box, text) in the layout.
<DD> Indicates an element that is not saved to the
database with a <B>save</B> or <B>writeall</B>
command (the default flag).
<DT> <B>persistant</B>
<DT> <B>persistent</B>
<DD> Indicates an element that is saved to the
database with a <B>save</B> or <B>writeall</B>
command, and can be recovered with a <B>load</B>
@ -193,6 +191,6 @@ Handle generic drawing elements (line, box, text) in the layout.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 5, 2004 at 6:32am <P>
<P><I>Last updated:</I> January 15, 2021 at 12:47pm <P>
</BODY>
</HTML>

4
doc/html/erase.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>erase</H2>
@ -79,6 +79,6 @@ Erase paint from the layout inside the bounds of the cursor box.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 8, 2004 at 3:02pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/expand.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>expand</H2>
@ -64,6 +64,6 @@ expanded/unexpanded cells in the current selection.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:17pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/ext.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>ext, extract</H2>
@ -133,6 +133,6 @@ Circuit netlist extractor
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 3:16am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

26
doc/html/ext2sim.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>ext2sim, exttosim</H2>
@ -33,9 +33,14 @@ Convert extracted file(s) to a ".sim" format file.
<DD> Run exttosim on current cell, with command-line options
(see Summary, below).
<DT> <B>alias on</B>|<B>off</B>
<DD> Enable/disable alias (.al) file
<DD> Enable/disable alias (.al) file. This file contains all of
the node aliases (different node names that correspond to the
same node). If "off", the statements are output directly to
the .sim file. If "on", the statements are moved to the ".al"
file.
<DT> <B>labels on</B>|<B>off</B>
<DD> Enable/disable labels (.nodes) file
<DD> Enable/disable labels (.nodes) file. The labels file is used
by the extresist command.
<DT> <B>default</B>
<DD> Reset to default values
<DT> <B>format MIT</B>|<B>SU</B>|<B>LBL</B>
@ -140,6 +145,19 @@ Convert extracted file(s) to a ".sim" format file.
<B>exttosim</B> is an alias for <B>ext2sim</B>, to satisfy the
grammatically anal retentive.
<B>ext2sim</B> is also implemented as a script to be run from
the shell command line, where it executes magic in batch mode
(i.e., using the <B>-dnull</B> option) and runs the ext2sim
command automatically. With this usage, the syntax is:
<BLOCKQUOTE>
<B>ext2sim</B> [ <I>magic_options</I> <B>--</B> ]
<I>ext2sim_runtime_options ext_file</I>
</BLOCKQUOTE>
The double-dash separates command options passed to magic on
startup (such as "<B>-T</B> <I>technology</I>" to specify the
technology) from those runtime options (see above) passed to
the <B>ext2sim</B> command.
</BLOCKQUOTE>
<H3>See Also:</H3>
@ -156,6 +174,6 @@ Convert extracted file(s) to a ".sim" format file.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 12, 2005 at 9:40pm <P>
<P><I>Last updated:</I> September 13, 2021 at 12:31pm <P>
</BODY>
</HTML>

180
doc/html/ext2spice.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>ext2spice, exttospice</H2>
@ -25,7 +25,7 @@ Convert extracted file(s) to a SPICE format file.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>ext2spice</B> [<I>option</I>] <BR><BR>
<B>ext2spice</B> [<I>option</I>] [<I>cellname</I>] <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
@ -34,7 +34,7 @@ Convert extracted file(s) to a SPICE format file.
(see Summary, below).
<DT> <B>default</B>
<DD> Reset to default values
<DT> <B>format hspice</B>|<B>spice2</B>|<B>spice3</B>
<DT> <B>format hspice</B>|<B>spice2</B>|<B>spice3</B>|<B>ngspice</B>
<DD> Set output format. <B>spice3</B> is the default,
for compatibility with <B>tclspice</B>. This is a
change from previous versions of magic, where the
@ -55,9 +55,8 @@ Convert extracted file(s) to a SPICE format file.
<DT><B>conservative</B>
<DD> Merge transistors and capacitors having the same device
type and node connections and having the same width and
length. Widths are summed in the final output for
transistors. Capacitor values are summed in the final
output.
length. Device multipliers ("M=") are output for each
set of merged devices.
<DT><B>aggressive</B>
<DD> Merge transistors having the same node
connections and having the same length. Widths
@ -80,16 +79,114 @@ Convert extracted file(s) to a SPICE format file.
may produce warnings about unknown nodes. However, use of
this option may conflict with LVS (layout-vs.-schematic),
when only one resistor is expected per drawn device.
<DT> <B>subcircuits</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>on</B> (the default), standard cells become
subcircuit calls ("X") in the SPICE output. The contents
of the standard cells are not output, and it is assumed
that a pre-characterized SPICE deck exists modeling the
behavior of each standard cell definition. Standard cells
are defined by the use of the <B>port</B> method for
labeling input and output ports. When set to <B>off</B>,
ports are ignored, and the entire circuit hierarchy is
flattened down to the device level.
<DT> <B>subcircuit</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>on</B> (the default), and if the cell selected
for SPICE output has defined ports on the top level, then
the cell becomes a subcircuit definition in the output, and
the output has no top-level calls to any devices. This
format is appropriate for including in a testbench netlist,
for example. If the top-level cell does not have defined
ports, then there is no way for magic to determine what
the ports might be, or what order they may be in, making
it impossible to generate a consistent subcircuit, so in
the absence of ports, this option has no function.
Ports are defined by the use of the <B>port</B> method for
labeling input and output ports. When option
<B>subcircuit</B> is set to <B>off</B>, the top-level
circuit will be the top level of the netlist, and it
will have no associated subcircuit definition.
<DT> <B>subcircuit top</B> [<B>on</B>|<B>off</B>]
<DD> This variant of the <B>subcircuit</B> option controls
whether or not ext2spice generates a .subckt wrapper
around the top-level circuit. If the top-level circuit
does not have defined ports, then no .subckt wrapper
will ever be generated, because ext2spice will not
be able to know which nets are the ports.
<DT> <B>subcircuit descend</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>off</B>, the <B>subcircuit descend</B>
option will not descend into any subcells below the
top level, writing only the top-level circuit to the
output. The default is <B>on</B>. This option can be
useful for writing out digital circuits made from
standard cells, since the digital subcircuits can usually
be included from a vendor library.
<DT> <B>scale</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>on</B>, the scale value is set by the
SPICE "<B><TT>.scale</TT></B>" card, recognized by some
SPICE parsers. All device lengths, widths, and areas
are then given in integer units (internal database
units). When set to <B>off</B>, all device widths,
lengths, and areas are given in unscaled, physical
dimensions.
<DT> <B>short</B> [<B>voltage</B>|<B>resistor</B>|<B>none</B>]
<DD> Determines behavior with respect to ports with different
names connected to the same net. SPICE does not have a
universal method for describing a net with more than one
name. A common way of handling this is by separating
differently-named parts of a net with a zero-ohm ideal
resistor or a zero-volt DC source. "<B>ext2spice short</B>"
uses one of these methods to preserve duplicate port names.
"<B>ext2spice short resistor</B>" uses the zero-ohm resistor
method, which "<B>ext2spice short voltage</B>" uses the
zero-volt source method. "<B>ext2spice short none</B>"
reverts to the default behavior, which is to remove all
port names except for one from the netlist.
<DT> <B>hierarchy</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>on</B>, magic will extract a hierarchical
representation of the circuit, in which the cell hierarchy
of the layout is represented in SPICE by
"<B><TT>.subckt</TT></B>" macros. "ext2spice hierarchy"
does not require that subcircuits have port labels. Each
subcircuit will be analyzed for port connections, and port
connections will be consistent in the SPICE output between
the subcircuit definition (".subckt") and instantiated
calls ("X") to that subcircuit.
<DT> <B>blackbox</B> [<B>on</B>|<B>off</B>]
<DD> When set to "on", views marked as abstract will be output
as subcircuit calls ("X") but there will be no associated
subcircuit definition output. A circuit is considered
"abstract" if at the time of extraction it has a property
named "LEFview". A cell will automatically be given this
property if it is read from a LEF input file. It may also
be given this property using the "<B>property</B>" command.
In order for the blackbox view to be meaningful, the
subcell must declare ports (see the "port" command).
<DT> <B>renumber</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>on</B>, subcircuit calls (see above; only
used for certain options such as "subcircuit", "hierarchy",
or with extracted device types "subcircuit" or "rsubcircuit")
are numbered sequentially "X1", "X2", etc., as encountered
by the extractor. When set to <B>off</B>, subcircuit
calls (when used with options "subcircuit" or "hierarchy",
but not applying to low-level extracted subcircuit devices)
will be rendered in the SPICE output file as "X" followed
by the ID (name) of the cell instance.
<DT> <B>global</B> [<B>on</B>|<B>off</B>]
<DD> When set to <B>on</B> or default, unconnected global nets
of the same name in subcells are merged in the output. When
set to <B>off</B>, such nets are left unconnected.
<DT> <I>cellname</I>
<DD> Name of the cell to generate output for. This item is optional;
if not specified, then ext2spice generates output for the
current edit cell.
<DT> <B>lvs</B>
<DD> Apply settings appropriate for running LVS (layout vs. schematic).
These settings are as follows:
<UL>
<LI> hierarchy on
<LI> format ngspice
<LI> cthresh infinite
<LI> rthresh infinite
<LI> renumber off
<LI> scale off
<LI> blackbox on
<LI> subcircuit top auto
<LI> global off
</UL>
This command applies the settings but does not generate output
(<I>i.e.</I>, does not run <B>ext2spice</B>), so that settings
can be overridden if necessary. <BR>
(The <B>lvs</B> option was introduced in version 8.2.79).
<DT> <B>help</B>
<DD> Print help information.
</DL>
@ -112,6 +209,42 @@ Convert extracted file(s) to a SPICE format file.
Valid <I>runtime_options</I> are:
<BLOCKQUOTE>
<DL>
<DT> <B>-M</B>
<DD> Aggressive merging of devices. If the lengths of FET
devices connected in parallel are equal, then add their
widths together to form a single device. Overrides any
value specified by the "ext2spice merge" command option.
<DT> <B>-m</B>
<DD> Conservative merging of devices. If the lengths and
widths of FET devices connected in parallel are equal,
then add their widths together to form a single device.
Overrides any value specified by the "ext2spice merge"
command option.
<DT> <B>-o</B> <I>filename</I>
<DD> Save the output as file <I>filename</I> (<I>filename</I>
must include any file extension, as there is no standard
extension for SPICE files).
<DT> <B>-j</B> <I>device</I><B>:</B><I>class</I>
[<B>/</B><I>subclass</I>] <B>/</B><I>subsnode</I>
<DD> Override values of resistance class, substrate resistance
class, and substrate node name for device type <I>device</I>.
Resistance classes are indexed by number and must match the
definition in the technology file's extract section.
<DT> <B>-f spice2</B>|<B>spice3</B>|<B>hspice</B>|<B>ngspice</B>
<DD> Choose the output SPICE format for compatibility with
different versions of SPICE.
<DT> <B>-d</B>
<DD> Distribute junction areas and perimeters. The Magic extractor
computes area and perimter values per <I>node</I>, not per
<I>device</I>. For devices that share a node, Magic cannot
distinguish between the devices (for parasitic calculations,
it's not necessary to distinguish between the devices).
Normally, when generating device output, Magic writes the
lumped area and perimeter values along with the first device
attached to a node, and sets the area and perimeter values
for all remaining devices on that node to zero. The <B>-d</B>
option causes Magic to distribute the node area and perimeter
evenly among all devices attached to that node.
<DT> <B>-B</B>
<DD> Don't output transistor or node attributes in the SPICE file.
This option will also disable the output of information such
@ -157,6 +290,19 @@ Convert extracted file(s) to a SPICE format file.
<B>exttospice</B> is an alias for <B>ext2spice</B>, to satisfy the
grammatically anal retentive.
<B>ext2spice</B> is also implemented as a script to be run from
the shell command line, where it executes magic in batch mode
(i.e., using the <B>-dnull</B> option) and runs the ext2spice
command automatically. With this usage, the syntax is:
<BLOCKQUOTE>
<B>ext2spice</B> [ <I>magic_options</I> <B>--</B> ]
<I>ext2spice_runtime_options ext_file</I>
</BLOCKQUOTE>
The double-dash separates command options passed to magic on
startup (such as "<B>-T</B> <I>technology</I>" to specify the
technology) from those runtime options (see above) passed to
the <B>ext2spice</B> command.
</BLOCKQUOTE>
<H3>See Also:</H3>
@ -171,6 +317,6 @@ Convert extracted file(s) to a SPICE format file.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 12, 2005 at 9:40pm <P>
<P><I>Last updated:</I> September 17, 2021 at 10:12am <P>
</BODY>
</HTML>

108
doc/html/extract.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>ext, extract</H2>
@ -34,26 +34,79 @@ Circuit netlist extractor
the incremental extraction and ensures that a new <TT>.ext</TT>
file is written for every cell definition.
<DT> <B>cell</B> <I>name</I>
<DD> Extract the indicated cell into file <I>name</I>
<DD> Extract the currently selected cell into file <I>name</I>
<DT> <B>do</B>|<B>no</B> [<I>option</I>]
<DD> Enable or disable an extractor option, where <I>option</I>
may be one of the following:
<BLOCKQUOTE>
<DL>
<DT> <B>capacitance</B>
<DD>
<DD> Extract local parasitic capacitance values to substrate
<DT> <B>resistance</B>
<DD>
<DD> Extract lumped resistance values. Note that this
is <I>not</I> the same as full parasitic resistance.
The values extracted are "lumped" resistance and
indicate the value for which the delay through the
net can be computed with R times C, where R is the
lumped resistance and C is the parasitic capacitance.
This is a very coarse approximation, as it assumes
equal delay from the driver to any receiver. For
full R-C extraction, see the <B>extresist</B>
command. Lumped resistances have no meaning in
SPICE netlists and will only be used when running
<B>ext2sim</B> to generate a .sim netlist.
<DT> <B>coupling</B>
<DD>
<DD> Extract the parasitic coupling capacitance between
nodes.
<DT> <B>length</B>
<DD>
<DD> Extract the length of the shortest path from a driver
to a receiver, for computing more accurate parasitic
resistances.
<DT> <B>adjust</B>
<DD>
<DD> Adjust all capacitances for overlap between a parent
cell and child instance, or between instances in an
array. Parasitic capacitance is removed to account
for the amount of overlap. Note that this method
can produce negative capacitors in the parent. When
the netlist is flattened for simulation, the total
of all capacitances in parent and child, or between
array instances, is guaranteed to be strictly positive.
<DT> <B>all</B>
<DD>
<DD> Apply all standard options (does not include options
"local", "labelcheck", or "aliases").
<DT> <B>local</B>
<DD> Write all .ext files to the current working directory.
If not specified, each .ext file will be placed in the
same directory as the .mag file from which it is
derived, unless the .mag file is in a directory which
is not writable. In that case, the .ext file will also
be written to the current working directory.
<DT> <B>labelcheck</B>
<DD> Check for labels which have zero area and connect
to a subcell on the edge; this case is rare but is
computationally expensive to check for, so the feature
is disabled by default.
<DT> <B>aliases</B>
<DD> By default (starting with version 8.3.217), magic only
extracts a single name for a net, unless the net connects
to a port, in which case the port name is extracted as
well. With the <B>aliases</B> option enabled, all names
for a net are extracted; this can be useful for debugging
but will usually just slow down processing by commands
like "ext2spice" that use the .ext file contents, so it
is disabled by default.
</DL>
</BLOCKQUOTE>
These options (except for "local") determine how much
information is written to the output file. By default,
all options are selected. Normally, the options in
<B>ext2spice</B> or <B>ext2sim</B> are used to select
which information from the .ext file is used in the
resulting netlist. There is no need to restrict the
information being extracted. All options add relatively
little overhead to the extraction time. The output file
size can be reduced by not generating some extraction
information.
<DT> <B>length</B> [<I>option</I>]
<DD> Control pathlength extraction information, where <I>option</I>
@ -85,7 +138,42 @@ Circuit netlist extractor
all valid extraction styles for the technology as a Tcl
list.
<DT> <B>unique</B> [<I>#</I>]
<DD> Generate unique names when different nodes have the same name
<DD> Generate unique names when different nodes have the same name.
When option "<I>#</I>" is present, only make unique names for
labels tagged by ending with the "<B>#</B>" character. <BR>
<I>Warning:</I> This operation immediately modifies the
existing layout in preparation for extraction. Label
modifications are permanent, and cannot be undone. All
cells in the hierarchy may potentially be modified. <BR>
<DT> <B>unique</B> [<I>option</I>]
<DD> (From Magic 8.1.24) With no option, generate unique names
when different nodes have the same name. <I>option</I> may
be one of the following:
<BLOCKQUOTE>
<DL>
<DT> <B>all</B>
<DD> Equivalent to no option; all labels with the same
name on different nets are given unique names.
<DT> <B>#</B>
<DD> Labels that are tagged by ending with the character
"<B>#</B>" are made unique for each instance on an
electrically unique node.
<DT> <B>noports</B>
<DD> Labels that are not ports are made unique when on
different nets. Ports, however, are ignored. This
option is useful for standard cells which may be
hiding internal connectivity.
<DT> <B>notopports</B>
<DD> This option behaves like <B>extract unique noports</B>
on the topmost cell in the hierarchy, and otherwise
behaves like <B>extract unique all</B> on all cells
below the top (available from magic 8.3.205).
</DL>
</BLOCKQUOTE>
<I>Warning:</I> This operation immediately modifies the
existing layout in preparation for extraction. Label
modifications are permanent, and cannot be undone. All
cells in the hierarchy may potentially be modified. <BR>
<DT> <B>warn</B> [[<B>no</B>] <I>option</I>]
<DD> Enable/disable reporting of non-fatal errors, where <I>option</I>
may be one of the following:
@ -133,6 +221,6 @@ Circuit netlist extractor
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 3:16am <P>
<P><I>Last updated:</I> October 8, 2021 at 4:56pm <P>
</BODY>
</HTML>

16
doc/html/extresist.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>extresist</H2>
@ -45,6 +45,18 @@ information.
<DD> Turn off/on printing of net statistics.
<DT> <B>skip</B> <I>mask</I>
<DD> Don't extract types indicated in the comma-separated list <I>mask</I>
<DT> <B>ignore</B> [<I>netname</I>|<B>none</B>]
<DD> Don't extract the net named <I>netname</I>. The list of ignored
nets is global, cumulative, and persistent; it will only be cleared
when the <B>extresist ignore none</B> command is issued
(option available from version 8.3.207).
<DT> <B>include</B> [<I>netname</I>|<B>all</B>]
<DD> Extract the net named <I>netname</I>. When this option is called
at least once, the behavior of the extraction changes to extract
only the nets that have been specified by <B>extresist include</B>
commands. The list of included nets is global, cumulative, and
persistent; it will only be cleared when the <B>extresist include
all</B> command is issued (option available from version 8.3.213).
<DT> <B>box</B> <I>type</I>
<DD> Extract the signal under the cursor box on layer <I>type</I>
<DT> <B>cell</B> <I>cellname</I>
@ -113,6 +125,6 @@ information.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 21, 2004 at 10:48am <P>
<P><I>Last updated:</I> October 4, 2021 at 3:32pm <P>
</BODY>
</HTML>

4
doc/html/feedback.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>feedback</H2>
@ -122,6 +122,6 @@ Query or manipulate feedback entry areas.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 8:32pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/fill.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>fill</H2>
@ -62,6 +62,6 @@ Fill layers from one side of box to other.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 1:42am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/findbox.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>findbox</H2>
@ -55,6 +55,6 @@ Center the window on the box and optionally zoom in.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 1:46am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

17
doc/html/findlabel.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>findlabel</H2>
@ -25,9 +25,10 @@ Set the cursor box to the location of the indicated label
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>findlabel</B> <I>label</I> [<B>-glob</B>] <BR><BR>
<B>findlabel</B> [<B>-glob</B>] <I>label</I> [<I>occur</I>]<BR><BR>
<BLOCKQUOTE>
where <I>label</I> is the name of an existing label in magic.
where <I>label</I> is the name of an existing label in magic,
and optional argument <I>occur</I> is an integer.
</BLOCKQUOTE>
</BLOCKQUOTE>
@ -39,7 +40,13 @@ Set the cursor box to the location of the indicated label
The <B>-glob</B> option causes <B>findlabel</B> to find all labels
containing the text pattern of <I>label</I>. This is the way the
<B>findlabel</B> command worked in versions of <B>magic</B> prior
to 7.2.
to 7.2. <P>
The optional argument <I>occur</I> will center the cursor box on the
<I>N</I>th instance of the label, where <I>N</I>=<I>occur</I>
(option introduced in version 8.3.86). If <I>occur</I> is greater
than the number of labels in the edit cell, then the result is the
same as for a label that is not found.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -53,6 +60,6 @@ Set the cursor box to the location of the indicated label
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 7, 2004 at 3:32pm <P>
<P><I>Last updated:</I> November 20, 2020 at 10:18am <P>
</BODY>
</HTML>

32
doc/html/flatten.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>flatten</H2>
@ -25,12 +25,13 @@ Flatten edit cell into the indicated destination cell.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>flatten</B> <I>cellname</I> [<I>option</I>] <BR><BR>
<B>flatten</B> [<I>option</I>] <I>cellname</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>.
<I>option</I> may be one of <B>-nolabels</B>, <B>-nosubcircuits</B>,
or <B>-noports</B>, <B>-novendor</B>, <B>-dotoplabels</B>, and
<B>-dobox</B>.
</BLOCKQUOTE>
</BLOCKQUOTE>
@ -46,23 +47,38 @@ Flatten edit cell into the indicated destination cell.
<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>
<DT> <B>-nosubcircuits</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>-noports</B>
<DD> Removes port information from labels when flattening, so that
the flattened view will have only labels and not ports.
<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.
<DT> <B>-dotoplabels</B>
<DD> This option tells magic to preserve in the flattened view
only the labels that are in the top level cell. Labels in
subcells will be ignored.
<DT> <B>-dobox</B>
<DD> When this option is specified, magic flattens only the area
of the circuit that is inside the boundary of the cursor box.
</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.
layout. <P>
The target cell <I>cellname</I> must not already exist in the
database except when using the <B>-dobox</B> option. With <B>-dobox</B>,
using the same target <I>cellname</I> allows a layout to be flattened
in pieces. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -76,6 +92,6 @@ Flatten edit cell into the indicated destination cell.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 8:04pm <P>
<P><I>Last updated:</I> June 23, 2021 at 5:48pm <P>
</BODY>
</HTML>

19
doc/html/flush.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>flush</H2>
@ -26,7 +26,7 @@ last saved version.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>flush</B> [<I>cellname</I>] <BR><BR>
<B>flush</B> [<I>cellname</I>] [<B>-dereference</B>]<BR><BR>
<BLOCKQUOTE>
where <I>cellname</I> is the name of a cell definition to be
flushed.
@ -41,7 +41,13 @@ last saved version.
Otherwise, the named cell is flushed. <P>
The effects of the <B>flush</B> command are irrevocable; the
command cannot be undone with an <B>undo</B> command.
command cannot be undone with an <B>undo</B> command. <P>
With the <B>-dereference</B> option, any file path that has been
associated with the cell is discarded, and the cell is reloaded
from the first location found in the search path. With search
path manipulations, this can be used, for example, to switch
between abstract and full views of a cell.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -52,12 +58,17 @@ last saved version.
is intended.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=path.html><B>path</B></A> <BR>
</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> October 6, 2004 at 2:06am <P>
<P><I>Last updated:</I> December 10, 2020 at 1:15pm <P>
</BODY>
</HTML>

4
doc/html/garoute.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>garoute</H2>
@ -76,6 +76,6 @@ Gate-array router
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 2:35am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

232
doc/html/gds.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>gds, calma</H2>
@ -28,24 +28,94 @@ Read GDSII input or generate GDSII output.
<B>gds</B> [<I>option</I>] <BR><BR>
<B>calma</B> [<I>option</I>] <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
where <I>option</I> is one of the following: <BR>
Primary options:
<DL>
<DT> <B>help</B>
<DD> Print usage information
<DT> <B>arrays</B> [<B>yes</B>|<B>no</B>]
<DD> Output arrays as individual subuses (like in CIF). Default
is "no". Normally there is no reason to do this.
<DT> <B>contacts</B> [<B>yes</B>|<B>no</B>]
<DD> Causes contacts to be written to the GDS file as subcell
arrays (experimental, introduced in version 7.3.55). This
method can produce very efficient output compared to writing
each contact cut square separately.
<DT> <B>flatten</B> [<B>yes</B>|<B>no</B>]
<DT> <B>read</B> <I>file</I>
<DD> Read GDSII format from file <I>file</I> into the edit cell.
If <I>file</I> does not have a file extension, then <B>magic</B>
searches for a file named <I>file</I>, <I>file</I>.gds,
<I>file</I>.gds2, or <I>file</I>.strm.
<DT> <B>warning</B> [<I>option</I>]
<DD> Set warning information level. "<I>option</I>" may be one
of the following:
<DL>
<DT><B>default</B>
<DD> The default setting is equivalent to all the other
options (<B>align</B>, <B>limit</B>, <B>redirect</B>,
and <B>none</B>) being disabled.
<DT><B>align</B>
<DD> Generate warnings during a "<B>cif see</B>" command
if the alignment of geometry is on fractional lambda.
Normally, magic allows contacts to be drawn at
half-lambda positions. If this violates DRC requirements
for the minimum output grid, this warning setting can be
used to detect such violations.
<DT><B>limit</B>
<DD> Limit warnings to the first 100 warnings or errors only.
<DT><B>redirect</B> [<I>file</I>]
<DD> Redirect all warnings to an output file named <I>file</I>.
If <I>file</I> is not given, then redirection is disabled.
<DT><B>none</B>
<DD> Do not produce any warning messages on GDS input.
</DL>
<DT> <B>write</B> <I>file</I>
<DD> Output GDSII format to "<I>file</I>" for the window's root cell.
</DL>
Options for <B>gds read</B>:
<DL>
<DT> <B>drccheck</B> [<B>yes</B>|<B>no</B>]
<DD> If set to <B>no</B>, then do not mark cells read from GDS as
requiring DRC checks (default <B>yes</B>).
<DT> <B>flatglob</B> [<B>none</B>|<I>string</I>]
<DD> Flatten cells by name pattern on input. This is the more
exacting version of <B>flatten</B>, as it allows specific
cells to be flattened. Each call with an argument <I>string</I>
adds <I>string</I> to the list of name patterns to be checked.
A call with the option <B>none</B> will remove all patterns.
A call with no options will return the list of string patterns
that will be applied to inputs. The strings may use standard
shell-type glob patterns, with <B>*</B> for any length string
match, <B>?</B> for any single character match, <B>\</B> for
special characters, and <B>[]</B> for matching character sets
or ranges (introduced in version 8.3.102).
<DT> <B>flatten</B> [<B>yes</B>|<B>no</B>|<I>number</I>]
<DD> Flatten simple cells (e.g., contacts) on input. This helps
magic to use its contact-area representation of contacts,
and can also avoid situations where contacts are lost or
translated to "generic" types because the arrayed part of
the contacts is missing one or more residue layers.
the contacts is missing one or more residue layers. The
default number of shapes in an input to be considered
"simple" is 10, but this can be set with the <I>number</I>
argument. A <I>number</I> of zero implies <B>flatten no</B>,
and a non-zero <I>number</I> implies <B>flatten yes</B>.
Otherwise, the use of <B>yes</B> and <B>no</B> toggles the
flattening behavior without affecting any value previously
set by <B>flatten</B> <I>number</I>.
<DT> <B>maskhints</B> [<B>yes</B>|<B>no</B>]
<DD> When set to <B>yes</B>, then after reading each cell
definition from the GDS file, magic will re-generate the
GDS output data from its internal representation of the
cell. Where the output data does not match the input
data, and where the technology file defines mask hints in
the <B>cifoutput</B> section for a GDS layer, magic will
automatically generate the mask hint property for the cell
such that writing GDS of the cell will produce exactly the
same mask data as was in the original GDS file.
(default <B>no</B>).
<DT> <B>noduplicates</B> [<B>yes</B>|<B>no</B>]
<DD> When reading a GDS file, this option forces magic to ignore
cell definitions in the GDS file that are already present in
the database (that is, for which a cell of the same name
already exists). This can be used, for example, to pre-load
an abstract view of a cell before reading a GDS file containing
that cell. This option should be used with extreme caution,
since there is no check as to whether the existing view is
compatible with the one in the GDS file.
<DT> <B>ordering</B> [<B>yes</B>|<B>no</B>]
<DD> Forces post-ordering of subcells read from a GDS file; that
is, if a cell use is encountered before it is defined, magic
@ -55,16 +125,18 @@ Read GDSII input or generate GDSII output.
when using <B>gds flatten</B>. Otherwise, the default behavior
is <B>ordering no</B> to avoid lengthy searches through the
GDS stream file.
<DT> <B>labels</B> [<B>yes</B>|<B>no</B>]
<DD> Cause labels to be output when writing GDSII. Default
is "yes". Normally there is no reason not to do this.
<DT> <B>lower</B> [<B>yes</B>|<B>no</B>]
<DD> Allow both upper and lower case in labels. Default is "yes".
<DT> <B>read</B> <I>file</I>
<DD> Read GDSII format from file <I>file</I> into the edit cell.
If <I>file</I> does not have a file extension, then <B>magic</B>
searches for a file named <I>file</I>, <I>file</I>.gds,
<I>file</I>.gds2, or <I>file</I>.strm.
<DT> <B>polygon subcells</B> [<B>yes</B>|<B>no</B>]
<DD> Put non-Manhattan polygons into subcells. Default is "no".
Normally this option is not needed. However, input layout
that defines a number of angled wires, particularly those
that are closely spaced, can cause <B>magic</B> to generate
literally millions of internal tiles. This tends to be
true in particular for corner cells in padframes for deep
submicron feature sizes, where the angled corners are
required to meet the DRC specification. When set to "yes",
each polygon encountered in the GDS input is placed in its
own uniquely-named subcell. This prevents interations with
other polygons on the same plane and so reduces tile splitting.
<DT> <B>readonly</B> [<B>yes</B>|<B>no</B>]
<DD> Set cell as "read-only". This has the effect of marking each
cell definition (using the <B>property</B> method) with the
@ -91,43 +163,83 @@ Read GDSII input or generate GDSII output.
than to subsplit the internal grid to such a fine value.
The "<B>cif limit</B>" function may also be used to limit
grid subdivision to a minimum value.
<DT> <B>warning</B> [<I>option</I>]
<DD> Set warning information level. "<I>option</I>" may be one
of the following:
<DL>
<DT><B>default</B>
<DD> The default setting is equivalent to all the other
options (<B>align</B>, <B>limit</B>, <B>redirect</B>,
and <B>none</B>) being disabled.
<DT><B>align</B>
<DD> Generate warnings during a "<B>cif see</B>" command
if the alignment of geometry is on fractional lambda.
Normally, magic allows contacts to be drawn at
half-lambda positions. If this violates DRC requirements
for the minimum output grid, this warning setting can be
used to detect such violations.
<DT><B>limit</B>
<DD> Limit warnings to the first 100 warnings or errors only.
<DT><B>redirect</B> [<I>file</I>]
<DD> Redirect all warnings to an output file named <I>file</I>.
If <I>file</I> is not given, then redirection is disabled.
<DT><B>none</B>
<DD> Do not produce any warning messages on GDS input.
</DL>
<DT> <B>write</B> <I>file</I>
<DD> Output GDSII format to "<I>file</I>" for the window's root cell.
<DT> <B>polygon subcells</B> [<B>yes</B>|<B>no</B>]
<DD> Put non-Manhattan polygons into subcells. Default is "no".
Normally this option is not needed. However, input layout
that defines a number of angled wires, particularly those
that are closely spaced, can cause <B>magic</B> to generate
literally millions of internal tiles. This tends to be
true in particular for corner cells in padframes for deep
submicron feature sizes, where the angled corners are
required to meet the DRC specification. When set to "yes",
each polygon encountered in the GDS input is placed in its
own uniquely-named subcell. This prevents interations with
other polygons on the same plane and so reduces tile splitting.
<DT> <B>unique</B> [<B>yes</B>|<B>no</B>]
<DD> When reading a GDS file, this option forces magic to rename
cell definitions in the database when a cell of the same name
is encountered in the GDS file. The default behavior is to
overwrite the cell with the new definition. The existing
cell is renamed by adding a suffix with an underscore and a
number. The number is incremented until the name fails to
match any known cell name in the database.
</DL>
Options for <B>gds write</B>:
<DL>
<DT> <B>addendum</B> [<B>yes</B>|<B>no</B>]
<DD> Do not output vendor (readonly) cell definitions. Only the
references will be output. This makes the output file an
addendum to any existing vendor GDS libraries.
<DT> <B>arrays</B> [<B>yes</B>|<B>no</B>]
<DD> Output arrays as individual subuses (like in CIF). Default
is "no". Normally there is no reason to do this.
<DT> <B>contacts</B> [<B>yes</B>|<B>no</B>]
<DD> Causes contacts to be written to the GDS file as subcell
arrays (experimental, introduced in version 7.3.55). This
method can produce very efficient output compared to writing
each contact cut square separately.
<DT> <B>datestamp</B> [<B>yes</B>|<B>no</B>|<I>value</I>]
<DD> When writing a GDS file, each cell definition is given a
header containing two date stamps, one for the creation date,
and one for the modification date. By default, magic writes
the cell's internal timestamp as the creation date, and sets
the modification date stamp to zero. The <B>datestamp</B>
option, if set to <B>no</B>, will also set the creation
date stamp to zero. If set to <I>value</I>, then the specified
stamp value will be output for the creation date. The stamp
value should be an integer in the format used by the UNIX
time() system call, which is the number of seconds since
January 1, 1970, or equivalently the Tcl command
"<B>clock seconds</B>". Note that very few tools make use of
the GDS date stamps. But having a valid date stamp means that
a GDS file cannot be written twice with the exact same contents,
which has implications for repositories like git. When writing
libraries, it is useful to set a date stamp tied to a version
number and apply that date stamp to all files written for the
library.
<DT> <B>labels</B> [<B>yes</B>|<B>no</B>]
<DD> Cause labels to be output when writing GDSII. Default
is "yes". Normally there is no reason not to do this.
<DT> <B>library</B> [<B>yes</B>|<B>no</B>]
<DD> Do not write the top level cell into the output GDS file, but
write only the subcells of the top level cell. Default is "no".
<DT> <B>lower</B> [<B>yes</B>|<B>no</B>]
<DD> Allow both upper and lower case in labels. Default is "yes".
<DT> <B>merge</B> [<B>yes</B>|<B>no</B>]
<DD> Concatenate connected tiles into polygons when generating
output. Depending on the tile geometry, this may make the
output file up to four times smaller, at the cost of speed
in generating the output file. Some programs like the field
equation solver HFSS won't work properly with layout broken
into many tiles; other programs like Calibre will complain
about acute angles when non-Manhattan geometry is broken
into triangles. GDS output limits polygon boundaries to
a maximum of 200 points, which limits the efficiency of the
merge method. The default value if "no"; e.g., all GDS output
is a direct conversion of tiles to rectangle and triangle
boundary records.
<DT> <B>nodatestamp</B> [<B>yes</B>|<B>no</B>]
<DD> Backwardly compatible alternative to the <B>datestamp</B>
option. Setting <B>nodatestamp yes</B> is equivalent to
setting <B>datestamp no</B> (see above).
<DT> <B>undefined</B> [<B>allow</B>|<B>disallow</B>]
<DD> Define the behavior for undefined cells (e.g., cells whose
layout contents could not be found). If allowed, then the
calls to these cells will be written to GDS even if the cell
itself is not defined in the GDS (see the <B>addendum</B>
option, above). If disallowed, the GDS file will not be
written if undefined references exist. The default behavior
is <B>disallow</B>.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
@ -184,6 +296,6 @@ Read GDSII input or generate GDSII output.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 3:17pm <P>
<P><I>Last updated:</I> April 27, 2021 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/get.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>get, getcell</H2>
@ -97,6 +97,6 @@ Import a cell as a subcell of the current edit cell.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 3:32am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

22
doc/html/getcell.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>get, getcell</H2>
@ -26,7 +26,8 @@ Import a cell as a subcell of the current edit cell.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>getcell</B> <I>cellname</I> [<I>orientation</I>] <BR><BR>
<B>getcell</B> <I>cellname</I> [<B>child</B> <I>child_refpoint</I>]
<B>getcell</B> <I>cellname</I> [<I>orientation</I>]
[<B>child</B> <I>child_refpoint</I>]
[<B>parent</B> <I>parent_refpoint</I>] <BR><BR>
<BLOCKQUOTE>
where <I>orientation</I> may be one of the following:
@ -57,11 +58,16 @@ Import a cell as a subcell of the current edit cell.
and <I>child_refpoint</I> and <I>parent_refpoint</I> may be
<I>x y</I> coordinate pairs, or one of the four keywords
<B>ll</B>, <B>lr</B>, <B>ul</B>, or <B>ur</B>, indicating
one of the four box corners. For the child,
coordinate pairs are in the coordinate system of the child,
and corners indicate cell bounding box corners. For the
parent, coordinate pairs are in the coordinate system of
the parent, and corners indicate corners of the cursor box.
one of the four box corners, or the name of a label in the
parent or child cell. For the child, coordinate pairs are
in the coordinate system of the child, and corners indicate
cell bounding box corners. For the parent, coordinate pairs
are in the coordinate system of the parent, and corners indicate
corners of the cursor box. If <B>child</B> or <B>parent</B>
options are not provided, then the default behavior is the same
as "<B>child ll</B>" and "<B>parent ll</B>", respectively.
If a label name is given, then the position (anchor point) of
the label will be used as the reference point.
</BLOCKQUOTE>
</BLOCKQUOTE>
@ -97,6 +103,6 @@ Import a cell as a subcell of the current edit cell.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 3:32am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/getnode.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>getnode</H2>
@ -72,6 +72,6 @@ Get node names of all selected paint
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 6:01am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/goto.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>goto</H2>
@ -70,6 +70,6 @@ Goto the named node
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:15pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/grid.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>grid</H2>
@ -110,6 +110,6 @@ Toggle the grid lines on or off, and set grid parameters
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 7, 2004 at 3:24pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/help.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>help</H2>
@ -74,6 +74,6 @@ restrict output to those containing the indicated pattern)
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 7:02pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/identify.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>identify</H2>
@ -57,6 +57,6 @@ Set the use identifier of the selected cell
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 9:32pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/imacro.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>imacro</H2>
@ -75,6 +75,6 @@ Define or print an interactive macro.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 9, 2004 at 10:13am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/initialize.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>initialize</H2>
@ -63,6 +63,6 @@ Initialization of <B>magic</B> from the Tcl interpreter.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 7:59am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

45
doc/html/instance.html
View File

@ -1,4 +1,3 @@
<HTML>
<HEAD>
<STYLE type="text/css">
@ -16,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>instance</H2>
@ -31,7 +30,7 @@ Operations on cell instances (uses).
where <I>option</I> is one of the following:
<DL>
<DT> [<B>list</B>] <B>children</B> [<I>name</I>]
<DD> List all of the children definitions of cell use <I>name</I>,
<DD> List all of the children instances of cell use <I>name</I>,
or the children of the currently selected cell instance.
<DT> [<B>list</B>] <B>parent</B> [<I>name</I>]
<DD> List the parent cell definition of cell use <I>name</I>,
@ -46,6 +45,36 @@ Operations on cell instances (uses).
<DD> List all of the cell instances in the database. Note that
expansion is not automatic, so cells that are not expanded
are not searched.
<DT> <B>orientation</B> [<I>name</I>] [<B>-def</B>]
<DD> Returns the orientation of the instance. By default, returns
the orientation in the naming convention used by the
"<B>getcell</B>" command. If the option "<B>-def</B>" is
specified, then the orientation is given in the naming
convention used by the DEF format for component placement.
if <I>name</I> is given, then return the orientation of the
named instance. Otherwise, the orientation of all selected
instances is returned as an unordered list.
<DT> [<B>list</B>] <B>abutment</B>
<DD> Returns the coordinates of the instance's abutment box
(the bounding box formed by the coordinates saved in the
FIXED_BBOX property in the cell), translated into the
coordinate system of the parent cell (which must be the
edit cell). This should be used, for example, when
replacing an instance of a standard cell with another
standard cell, to move the cursor box to the abutment box
position so that the new cell has the same alignment as
the old cell (see also <B>orientation</B>, above).
<DT> <B>lock</B>|<B>unlock</B> [<I>name</I>]
<DD> Locking an instance prevents it from being moved, rotated,
flipped, deleted, or copied. This is useful, for example,
when part of a layout is declared "final" and changes to
that area are prohibited. The cell instance's lock status
can be saved to and read from the layout file, so the lock
will remain in effect until the instance is unlocked.
Cells that are locked have the character "<B>*</B>" prepended
to the instance name in the display. With no <I>name</I>
given to the command, the lock will be applied to all
selected cell instances.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
@ -72,6 +101,13 @@ Operations on cell instances (uses).
(q.v.). A number of options to <B>cellname</B> are meaningless
for instances. <P>
<I>Warning:</I> Because instance names are arbitrary, looking up
an instance name is computationally intensive compared to looking
up a cell name. When used inside a loop, such as to search the
cell name hierarchy, use command <B>cellname</B> on cell definitions
instead of command <B>instance</B> on cell instance names whenever
possible. <P>
The command option <B>instance list exists</B> is nonsensical from
the standpoint of the end-user (if the cell is selected, of course
it exists). However, it is a very useful function for Tcl scripts
@ -89,6 +125,7 @@ Operations on cell instances (uses).
<BLOCKQUOTE>
<A HREF=cellname.html><B>cellname</B></A> <BR>
<A HREF=load.html><B>load</B></A> <BR>
<A HREF=getcell.html><B>getcell</B></A> <BR>
<A HREF=tk_path_name.html><I>tk_path_name</I></A> <BR>
</BLOCKQUOTE>
@ -98,6 +135,6 @@ Operations on cell instances (uses).
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 8:06am <P>
<P><I>Last updated:</I> January 15, 2021 at 12:47pm <P>
</BODY>
</HTML>

68
doc/html/iroute.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>iroute</H2>
@ -62,7 +62,48 @@ cursor box
</DL>
<DT> <B>route</B> <I>node_name</I>...
<DD> Connect point to named node(s)
<DT> <B>saveParameters</B>
<DT> <B>route</B> <I>option</I>...
<DT> Connect points as specified in the options. <I>option</I> my
be one of the following:
<DL>
<DT> <B>-dbox</B>
<DD> Route to the area of the cursor box.
<DT> <B>-dlabel</B> <I>node_name</I>
<DD> Route to the destination network named <I>node_name</I>.
The name may be hierarchical, specifying a labeled node
in a nested list of subcell instances.
<DT> <B>-dlayers</B> <I>layer_list</I>
<DD> Force the route to end on of one the layers in the
comma-separated list.
<DT> <B>-drect</B> <I>llx lly urx ury</I>
<DD> Force the route to end within the designated rectangular
area.
<DT> <B>-dselection</B>
<DD> Force the route to end on the area of selected paint.
<DT> <B>-scursor</B>
<DD> Start the route at the cursor position.
<DT> <B>-slabel</B> <I>node_name</I>
<DD> Route from the start network named <I>node_name</I>.
The name may be hierarchical, specifying a labeled node
in a nested list of subcell instances.
<DT> <B>-slayers</B> <I>layer_list</I>
<DD> Force the route to start on one of the layers in the
comma-separated list.
<DT> <B>-spoint</B> <I>px py</I>
<DD> Start the route at the indicated point.
<DT> <B>-timeout</B> <I>value</I>
<DD> If the maze router is unable to find a valid
route, it may wander off into an indefinitely
long search. The search can be interrupted by
typing a control-C into the calling terminal,
but one can also specify a timed break using
the timeout option, where <I>value</I> is in
seconds. Typically, 4 or 5 seconds is a useful
value.
</DL>
By far, the most useful and most common invocation is
"<B>iroute route -slabel</B> <I>sname</I> <B>-dlabel</B>
<I>dname</I>" to route between two named pins.
<DD> Write out all irouter parameters. These are written out
as command calls so they can be read back with the Tcl
<B>source</B> command.
@ -99,7 +140,26 @@ cursor box
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>iroute</B> command is. . .
The <B>iroute</B> command invokes Magic's maze router algorithm.
This is a point-to-point, over-the-cell algorithm based on costs
specified in the technology file's "<B>mzrouter</B>" section,
style "<B>iroute</B>". It is not a channel router, and will
select the best path to connect the chosen start and destination
nodes, using whatever layers are specified as active in the
technology file, switching layers and adding contacts as
necessary, and avoiding obstacles. The quality of the route is
highly dependent upon both the existing layout and the cost
specification. <P>
Special layer types "<B>fence</B>", "<B>rotate</B>", and "<B>magnet</B>"
are built-in types available in all technologies. Painting the
"<B>fence</B>" layer creates a boundary inside of which Magic will
not route. Under a block of "<B>rotate</B>" layer paint, Magic will
reverse the vertical and horizontal costs of all layers. If the
technology file specifies unbalanced horizontal and vertical costs,
for example to tend to force horizontal routes in metal2 and vertical
routes in metal3, then areas painted with "rotate" will tend to get
horizontal routes in metal3 and vertical routes in metal2.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -119,6 +179,6 @@ cursor box
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 6, 2004 at 11:11pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/irsim.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>irsim</H2>
@ -73,6 +73,6 @@ Invoke the <B>irsim</B> switch-level digital simulator.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 1:01am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

42
doc/html/label.html
View File

@ -15,10 +15,10 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>command_name</H2>
<H2>label</H2>
<HR>
Place a label in the layout
<HR>
@ -32,6 +32,27 @@ Place a label in the layout
in <B>magic</B>, and <I>layer</I> may be any valid layer in
the technology.
</BLOCKQUOTE>
<B>label</B> <I>string</I> [<I>font</I> [<I>size</I> [<I>rotation</I>
[<I>offsetx offsety</I> [<I>position</I> [<I>layer</I>]]]]] <BR><BR>
<BLOCKQUOTE>
where <I>string</I> is the text of the label,
<I>font</I> is the name or number of a font, <I>size</I> is
the integer size of the font, in standard <A HREF=distance.html>
distance</A> units; <I>rotation</I> is the rotation
(in degrees) of the font, <I>offsetx</I> and <I>offsety</I>
are the distance of the printed text relative to the reference
position (in quarter units of <A HREF=distance.html>distance</A>);
<I>position</I> may be any valid
<A HREF=direction.html>direction</A> in <B>magic</B>,
and <I>layer</I> may be any valid layer in the technology.
This usage is only available in <B>magic</B> version 8.0 and above.
See the <A HREF=setlabel.html><B>setlabel</B></A> command for
details on each of the label options. <B>setlabel -default</B> can
be used to set default values for all of the optional properties
when they are not present on the <B>label</B> command line.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
@ -53,9 +74,17 @@ Place a label in the layout
example, "<B>label text north</B>" will draw the label string
"<TT>text</TT>" to the north (above) the marker. <P>
Labels cannot be directly modified; modifications should be
handled by first erasing the label with "<B>erase label</B>"
and then redrawing.
In versions of <B>magic</B> prior to 8.0, labels cannot be
directly modified; modifications should be handled by first
erasing the label with "<B>erase label</B>" and then redrawing.
Versions 8.0 and higher use the <A HREF=setlabel.html><B>setlabel</B></A>
command to modify selected labels. <P>
Versions of <B>magic</B> from 8.0.139 allow the <I>layer</I> name
to have a dash ("<B>-</B>") in front (e.g., "<B>-metal1</B>") to
indicate a "sticky label", that is, one that is attached to the
specified layer type <I>layer</I>, and which cannot be reattached
to another layer. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -65,6 +94,7 @@ Place a label in the layout
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=setlabel.html><B>setlabel</B></A> <BR>
<A HREF=port.html><B>port</B></A> <BR>
</BLOCKQUOTE>
@ -74,6 +104,6 @@ Place a label in the layout
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 1:11am <P>
<P><I>Last updated:</I> March 17, 2021 at 11:11am <P>
</BODY>
</HTML>

78
doc/html/lef.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>lef</H2>
@ -31,20 +31,45 @@ LEF-format input and output
<DL>
<DT> <B>read</B> [<I>filename</I>]
<DD> Read a LEF file named <I>filename</I>[<B>.lef</B>]
<DT> [<I>filename</I>] <B>-import</B>
<DT> <B>read</B> [<I>filename</I>] <B>-import</B>
<DD> Read a LEF file. Import standard cells from <TT>.mag</TT>
files
<DT> <B>write</B> [<I>cell</I>]
<DD> Write LEF for the current or indicated cell.
<DT> <B>writeall</B>
<DT> <B>read</B> [<I>filename</I>] <B>-annotate</B>
<DD> Read a LEF file. Use any macros defined in the LEF file
to annotate existing layouts, and ignore all other macros.
<DT> <B>write</B> [<I>cell</I>] [<B>-tech</B>]
[<B>-hide</B> [<I>distance</I>]] [<B>-toplayer</B>]
[<B>-nomaster</B>]
<DD> Write LEF for the current or indicated cell.<BR>
Option <B>-tech</B> writes the technology information (layer
mapping and rules) to the same file as the cell macro. <BR>
Option <B>-hide</B> generates an abstract view that has all
interior detail removed, leaving only pins and obstruction
layers covering the entire cell with cut-out areas for the
pins. Option <B>-hide</B> may take an additional value
argument <I>distance</I> which will hide the central part
of a cell starting a distance <I>distance</I> from the edge.
The <I>distance</I> value is in units of lambda by default,
but like other distance measurements changes with respect
to the <B>snap</B> command setting, and can take a suffix
such as "<B>um</B>" to specify a physical distance relative
to the current CIF/GDS output scale. <BR>
Option <B>-toplayer</B> outputs pin geometry only for the
topmost layer belonging to the pin; all connected layers
underneath will be output as obstructions. <BR>
Option <B>-nomaster</B> will prevent the generation of
output geometry on layers defined as MASTERSLICE.
<DT> <B>writeall</B> [<B>-tech</B>] [<B>-hide</B> [<I>distance</I>]]
[<B>-notop</B>] [<B>-toplayer</B>] [<B>-nomaster</B>]
<DD> Write all cells including the top-level cell. This might
be appropriate if the top-level cell is a compendium of
standard cells.
<DT> <B>writeall -notop</B>
<DD> write all subcells of the top-level cell, but not the top-level
cell itself. This is appropriate for generating a LEF library
from a layout, for which the layout itself would be written to
a DEF file.
standard cells. <BR>
With option <B>-notop</B>: Write all subcells of the top-level cell,
but not the top-level cell itself. This is appropriate for
generating a LEF library from a layout, for which the layout
itself would be written to a DEF file. <BR>
Options <B>-hide</B>, <B>-tech</B>, and <B>-toplayer</B> are
the same as for the <B>lef write</B> command.
<DT> <B>help</B>
<DD> Print help information
</DL>
@ -94,6 +119,12 @@ LEF-format input and output
There are specific property names associated with the LEF format.
These are as follows:
<DL>
<DT> <B>LEFshape</B>
<DD> Corresponds to the value of <B>SHAPE</B> for a macro
cell in the LEF format.
<DT> <B>LEFuse</B>
<DD> Corresponds to the value of <B>USE</B> for a macro
cell in the LEF format.
<DT> <B>LEFclass</B>
<DD> Corresponds to the value of <B>CLASS</B> for a macro
cell in the LEF format.
@ -101,15 +132,33 @@ LEF-format input and output
<DD> Corresponds to the value of <B>SOURCE</B> for a macro
cell in the LEF format.
<DT> <B>LEFsymmetry</B>
<DD> Corresponds to the vlaue of <B>SYMMETRY</B> for a macro
<DD> Corresponds to the value of <B>SYMMETRY</B> for a macro
cell in the LEF format.
<DT> <B>LEFsite</B>
<DD> Corresponds to the value of <B>SITE</B> for a macro
cell in the LEF format.
<DT> <B>LEFproperties</B>
<DD> Corresponds to the value of <B>PROPERTY</B> for a macro
cell in the LEF format. LEF properties should be specified
in a single cell property, in key:value pairs and space-separated.
Like all properties containing spaces, the entire property string
should be enclosed in quotes. When writing output, each of the
space-separated entries will be output on its own PROPERTY line
in the LEF file.
</DL>
Normally, when importing a LEF/DEF layout into <B>magic</B>, one
will first execute a <B>lef read</B> command followed by a
<B>def read</B> command. Likewise, when writing a layout, one
will first execute a <B>lef writeall -notop</B> command followed
by a <B>def write</B> command.
by a <B>def write</B> command. <P>
If a LEF file of macro definitions is read when the same cells
as named in the macros already exist in the magic database, then
the LEF file macros will be used to annotate the existing layout.
This includes setting pin properties (see above), extending the
area of labels to cover an entire port, and setting a bounding
box on the cell corresponding to the LEF origin and size.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -125,6 +174,7 @@ LEF-format input and output
<A HREF=def.html><B>def</B></A> <BR>
<A HREF=port.html><B>port</B></A> <BR>
<A HREF=property.html><B>property</B></A> <BR>
<A HREF=snap.html><B>snap</B></A> <BR>
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>
@ -133,6 +183,6 @@ LEF-format input and output
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 1:43am <P>
<P><I>Last updated:</I> June 28, 2021 at 12:28pm <P>
</BODY>
</HTML>

34
doc/html/load.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>load</H2>
@ -26,7 +26,8 @@ Load a cell into the layout window
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>load</B> [<I>cellname</I> [<B>scaled</B> <I>n</I> [<I>d</I>]]]
[<B>-force</B>] <BR><BR>
[<B>-force</B>] [<B>-dereference</B>] [<B>-quiet</B>] [<B>-fail</B>]
<BR><BR>
<BLOCKQUOTE>
where <I>cellname</I> is the name of a cell that presumably
exists either in the database memory or on disk as a
@ -69,11 +70,36 @@ Load a cell into the layout window
do for layout such as logos and text lettering drawn in
routing layers. <P>
The <B>-quiet</B> option prevents magic from generating error
messages during loads. This can be used to prevent magic from
complaining that a file does not exist when "<B>load</B>" is
being used to create a new cell, rather than load one from
disk. <P>
By default, if a cell cannot be found in the search path, then
a new empty layout is created with the name of the specified
cell. The <B>-fail</B> option prevents magic from creating a
new cell. Instead, if the cell cannot be found in the search
path, the load will simply fail. <P>
Since version 8.2.50, magic saves the path to each subcell
used in a design in the .mag file, to help with version
control. This breaks backwards compatibility with the
traditional <B>load</B> command, which would always use
the search paths set by the <A HREF=addpath.html><B>addpath</B></A>
command. The <B>-dereference</B> option restores the
traditional behavior by ignoring all path references in the
input file and relying only on known search paths to locate
the source file for each subcell in the layout. <P>
Note that if it is not desired to have <I>cellname</I>
created if not found on disk (e.g., because the path for
the cell was missing from the search path), the database
can be updated with the <B>flush</B> command or the
<B>cellname delete</B> command.
<B>cellname delete</B> command. <P>
Use of <B>load</B> with no <I>cellname</I> given will result in
creating a new cell called "<TT>(UNNAMED)</TT>". <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -92,6 +118,6 @@ Load a cell into the layout window
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 2:02am <P>
<P><I>Last updated:</I> February 10, 2021 at 10:05pm <P>
</BODY>
</HTML>

95
doc/html/locking.html Normal file
View File

@ -0,0 +1,95 @@
<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_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>locking</H2>
<HR>
Control the behavior of file locking.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>locking</B> [<B>enable</B>|<B>disable</B>] <BR><BR>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>locking</B> command controls the behavior of file locking,
which is an operating system-level protocol for preventing multiple
processes from attempting to write to the same file at the same
time. The behavior of the protocol is operating system dependent;
for Linux/UNIX systems, this is a feature of the system fcntl()
call. When a file is opened, the file descriptor is associated
with an exclusive lock that prevents any other process from opening
the same file for writing or appending. When using the file locking
feature, two processes of magic cannot open the same file in read/write
mode. The first process to open the file will have the exclusive
right to alter the file contents. The second process may only view
the layout in read-only mode. <P>
Any cell that is read-only can be forced editable using the
"<B>cellname writeable</B>" command option. Note that this does
not make the file writeable if another process has obtained a lock
on the file; it merely makes it editable, but to save the modified
layout to disk would require that the name of the cell be changed
or that the process holding the file lock releases it. <P>
This is not a perfect protection mechanism, since the "<B>cellname
writeable</B>" command option can subvert the intent of the file
lock by allowing a cell to be read in read-only mode while another
process has it locked; then, after the other process has released
the lock, the file can be forced writeable and saved to the same
file, potentially overwriting modifications made by the other
process. In normal use cases, however, the file locking serves
to prevent unintended overwriting of file modifications. <P>
The file locking is enabled by default when magic starts up.
Generally speaking, there is no reason to disable it. However,
some operating systems have strict limits on the allowed number
of open file descriptors, and it is possible for a sufficiently
complex layout for there to be more files open than available
file descriptors. In that case, the <B>locking disable</B>
command option will prevent issues with the filesystem at the
expense of file lock protection. <P>
With no arguments, <B>locking</B> returns the state of the
file locking, either "<B>enabled</B>" or "<B>disabled</B>". <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>locking</B> is implemented as a built-in command in <B>magic</B>
from version tag 8.3.249.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=cellname.html><B>cellname</B></A> <BR>
</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> January 1, 2022 at 3:11pm <P>
</BODY>
</HTML>

4
doc/html/logcommands.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>logcommands</H2>
@ -50,6 +50,6 @@ Log all commands into a file
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 2:06am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

6
doc/html/macro.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>macro</H2>
@ -68,7 +68,7 @@ Define or print a macro called char
Buttons are treated just like keys for the purpose of
defining macros. While the official names for buttons
in <TT>keysymdef.h</TT> are "<B>XK_Pointer_Button1</B>",
in <TT>keysymdef.h</TT> are "<B>XK_Pointer_Button_1</B>",
etc., the <B>macro</B> command accepts the abbreviated
forms <B>Button1</B>, and so forth. <P>
@ -97,6 +97,6 @@ Define or print a macro called char
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 10, 2004 at 10:34am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/maketoolbar.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>maketoolbar</H2>
@ -96,6 +96,6 @@ Generate the GUI layout window toolbar.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 3:12am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/measure.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>measure</H2>
@ -61,6 +61,6 @@ Create a ruler to measure the distance between two points on a layout.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 9:12pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

15
doc/html/move.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>move</H2>
@ -33,7 +33,7 @@ Move the cursor box and the selection.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>move</B> [<I>option</I>] <BR><BR>
<B>move</B> [<B>origin</B>] [<I>option</I>] <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
@ -62,6 +62,15 @@ Move the cursor box and the selection.
indicated amount. The default distance is 1 unit (usually
lambda; see <A HREF=distance.html><I>distance</I></A> for
further explication).<P>
The option <B>origin</B> does not require a selection. It will
relocate the entire design such that the origin (coordianate 0, 0)
is at the position indicated by <I>option</I>. Note that this is
more efficient than unexpanding the contents of the top-level cell,
selecting everything, and moving the selection. For very large
layouts, repositioning the origin of a cell can be prohibitive
(may overrun available memory), and "<B>move origin</B>" is always
preferred.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -81,6 +90,6 @@ Move the cursor box and the selection.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 3:19am <P>
<P><I>Last updated:</I> March 20, 2020 at 1:50pm <P>
</BODY>
</HTML>

4
doc/html/netlist.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>netlist</H2>
@ -76,6 +76,6 @@ Netlist operations for use with the "netlist tool" in a layout window.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 10, 2004 at 10:44am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/openwindow.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>openwindow</H2>
@ -76,6 +76,6 @@ Open a new (non-GUI) layout window with indicated name, bound to indicated cell
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 9:03pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/openwrapper.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>openwrapper</H2>
@ -68,6 +68,6 @@ Open a GUI layout window and all of its associated frames.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 5:40am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

76
doc/html/orient.html Normal file
View File

@ -0,0 +1,76 @@
<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_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>orient</H2>
<HR>
Orient the selection according to the specified orientation.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>orient</B> [<I>orientation</I>] [<B>-origin</B>] <BR><BR>
<BLOCKQUOTE>
where <I>orientation</I> is an orientaton in the form given by
the <B>instance orientation</B> command, or an orienation in
DEF format (see below).
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>orient</B> command orients the selection according to the
given <I>orientation</I>, which may be in the same syntax returned
by the "<B>instance orientation</B>" command, or according to the
syntax used by the DEF format. <P>
Valid values for <I>orientation</I> are: <B>0</B>, <B>90</B>, <B>180</B>,
<B>270</B>, <B>h</B>, <B>v</B>, or any combination of rotation and
<B>h</B> or <B>v</B> (e.g., <B>90h</B>); or the DEF orientations
<B>N</B>, <B>S</B>, <B>E</B>, <B>W</B>, <B>FN</B>, <B>FS</B>,
<B>FE</B>, and <B>FW</B>. <P>
If <B>-origin</B> is specified, the orientation is around the
origin of the selection, not around the lower left-hand
corner (see the <B>clockwise</B> command).
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>orient</B> is implemented as a built-in <B>magic</B> command.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=clockwise.html><B>clockwise</B></A> <BR>
<A HREF=sideways.html><B>sideways</B></A> <BR>
<A HREF=upsidedown.html><B>upsidedown</B></A> <BR>
<A HREF=instance.html><B>instance</B></A> <BR>
<A HREF=getcell.html><B>getcell</B></A> <BR>
</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> October 30, 2020 at 10:50am <P>
</BODY>
</HTML>

4
doc/html/paint.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>paint</H2>
@ -71,6 +71,6 @@ Paint mask information into the current edit cell
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 8, 2004 at 3:02pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/path.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>path</H2>
@ -69,6 +69,6 @@ path [search|cell|sys] [[+]path]
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 5:54am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/peekbox.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>peekbox</H2>
@ -55,6 +55,6 @@ Query the last saved cursor box position
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 5:59am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

99
doc/html/plot.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>plot</H2>
@ -36,7 +36,44 @@ Hardcopy plotting
layout underneath the box. The output size is propotional
to <I>scale</I>, where a scale of 1 is one output pixel per
<B>magic</B> internal unit. The default <I>scale</I>
value, if unspecified, is 0.5.
value, if unspecified, is 0.5. <BR><BR>
<I>Note:</I> Magic version 7.5.45 changed the syntax to <BR>
<B>plot pnm</B> <I>file</I> [<I>width</I> [<I>layers</I>]] <BR>
where <I>width</I> is the width of the output, in pixels,
having a default value of 1500 if unspecified (which is
reasonably photographic when scaled to the size of a
printed page). If the parameter "<B>pnmplotRTL</B>" is
set to <B>true</B>, then output is filtered into HPRTL
or HPGL2 format according to the "color versatec" style
settings. In that case, the filename is optional; if
missing, a temporary file is created.
<DT> <B>svg</B> <I>file</I>
<DD> Generate an SVG (scalable vector graphics) file of the
exact contents of the layout window. Note that this
command has no options other than the name of the output
file: SVG graphics are scalable, so no scalefactor is
necessary, and it is intended as a WYSIWYG option. This
option is <I>only</I> availble when magic is invoked with
the Cairo graphics interface ("<TT>magic -d XR</TT>"),
because the <TT>libcairo</TT> library has interchangeable
back-end rendering engines and can quickly swap out the
X11 window rendering target for an SVG file rendering
target, something that cannot be done in the straight-up
Xlib or OpenGL interfaces. Note that when rendering to
the screen, no layout can be represented below the scale
of a screen pixel, whereas with scalable vector graphics,
<I>all</I> layout is rendered, no matter how dense.
Therefore, for large full-chip layouts, the SVG output
can be very large and very dense. For full-chip rendering,
the PNM plot style is usually a better choice.
<DT> <B>versatec</B> <I>scale</I> [<I>layers</I>]
<DD> Generate an HPRTL or HPGL2 rasterized rendering of the
layout underneath the box. The <I>scale</I> value is an
absolute scale, according to the physical size of the layout
as determined by the CIF or GDS output style, and the
resolution of the rendering device (i.e., printer or plotter).
The device resolution is declared in the plot parameters
(see below).
<DT> <B>parameters</B> [<I>name value</I>]
<DD> Set or print out plotting parameters (see Summary below).
<DT> <B>help</B>
@ -91,6 +128,43 @@ Hardcopy plotting
<TR> <TD> <B>PS_margin</B> </TD><TD> <B>72 (1in)</B> </TD>
<TD> Minimum margin to allow on all sides of the output page</TD></TR>
</TABLE>
HPRTL/HPGL2 parameters:
<TABLE BORDER=0>
<TR> <TD> <I>parameter name</I> </TD><TD> <I>default value</I> </TD>
<TD> <I>explanation</I> </TD> </TR>
<TR> <TD> <B>cellIdFont</B> </TD><TD> <B>vfont.I.12</B> </TD>
<TD> Font used for cell use identifier names. The default
font is part of the Magic distribution. </TD></TR>
<TR> <TD> <B>cellNameFont</B> </TD><TD> <B>vfont.B.12</B> </TD>
<TD> Font used for cell definition names. The default
font is part of the Magic distribution. </TD></TR>
<TR> <TD> <B>labelFont</B> </TD><TD> <B>vfont.R.8</B> </TD>
<TD> Font used for labels. The default font is part of
the Magic distribution. </TD></TR>
<TR> <TD> <B>directory</B> </TD><TD> <B>/tmp</B> </TD>
<TD> The directory used to store the temporary output file
that is generated prior to spooling for the printer. </TD></TR>
<TR> <TD> <B>dotsPerInch</B> </TD><TD> <B>300</B> </TD>
<TD> The native resolution of the target rendering device
(printer or plotter) </TD></TR>
<TR> <TD> <B>printer</B> </TD><TD> <B>versatec</B> </TD>
<TD> Name of the print spool queue. </TD></TR>
<TR> <TD> <B>spoolCommand</B> </TD><TD> <B>lp -d %s %s</B> </TD>
<TD> The OS command to use to send the plot to the printer
or plotter. </TD></TR>
<TR> <TD> <B>swathHeight</B> </TD><TD> <B>64</B> </TD>
<TD> The number of lines of output resolution that Magic
will generate at a time. Normally it is not necessary to
mess with this value. </TD></TR>
<TR> <TD> <B>width</B> </TD><TD> <B>2400</B> </TD>
<TD> The pixel width of the output device. </TD></TR>
<TR> <TD> <B>plotType</B> </TD><TD> <B>hprtl</B> </TD>
<TD> The format of the plot to make. The choices are
<B>hprtl</B> (equivalent to PCL5) and <B>hpgl2</B> for
the most common raster plot formats. The two (very!)
outdated formats <B>versatec_color</B> and
<B>versatec_bw</B> are retained for compatibility. </TD></TR>
</TABLE>
PNM parameters:
<TABLE BORDER=0>
<TR> <TD> <I>parameter name</I> </TD><TD> <I>default value</I> </TD>
@ -129,6 +203,19 @@ Hardcopy plotting
memory blocksize <B>pnmmaxmem</B> will force
downsampling regardless of the value of
<B>pnmdownsample</B>. </TD> </TR>
<TR> <TD> <B>pnmplotRTL</B> </TD><TD> <B>false</B> </TD>
<TD>When set to value <B>true</B>, this parameter pipes the
PNM plot output through the raster driver used by
"plot versatec". This allows rendered, antialiased
PNM plots to be sent directly to a printer. The
versatec parameters are used to determine what format,
printer, spooler command, temporary directory, and
printer pixel width and resolution. The filename is
optional in the "plot pnm" command when this parameter
is set. If the filename is missing, a temporary filename
will be generated for creating the file that is spooled
to the printer queue.
</TD> </TR>
</TABLE>
</BLOCKQUOTE>
@ -140,7 +227,11 @@ Hardcopy plotting
Although such entries can fine-tune the output, this is usually
not necessary. Also, since version 7.3.56, magic makes intelligent
decisions about memory usage, so it's generally not necessary to
change the PNM plot parameters.
change the PNM plot parameters. Raster plotting in HPGL2 and HPRTL
formats are a good alternative to PostScript for printers and plotters
that support those formats. The output is not scalable, but the size
of the output plot is much smaller and the speed of rendering is much
faster.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -158,6 +249,6 @@ Hardcopy plotting
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 3:24pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

7
doc/html/plow.html
View File

@ -1,6 +1,3 @@
<HTML>
<HEAD>
<STYLE type="text/css">
@ -18,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>plow</H2>
@ -89,6 +86,6 @@ Layout stretching and compaction
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 8:32pm <P>
<P><I>Last updated:</I> January 15, 2021 at 12:47pm <P>
</BODY>
</HTML>

4
doc/html/polygon.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>polygon</H2>
@ -72,6 +72,6 @@ Generate polygons from the command line.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 8:39pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/popbox.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>popbox</H2>
@ -54,6 +54,6 @@ Retrieve the last saved cursor box position
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 6:07am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/popstack.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>popstack</H2>
@ -58,6 +58,6 @@ Return from editing a cell that was loaded using <B>pushstack</B>.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 11:47pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

52
doc/html/port.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>port</H2>
@ -25,7 +25,7 @@ Declare a label to be a subcircuit port, or manipulate port parameters.
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>port</B> <I>option</I> <BR><BR>
<B>port</B> [<I>name</I>|<I>index</I>] <I>option</I> <BR><BR>
<BLOCKQUOTE>
where <I>option</I> may be one of the following:
<DL>
@ -39,8 +39,21 @@ Declare a label to be a subcircuit port, or manipulate port parameters.
<DD> Get [set] port class type (see Summary, below).
<DT> <B>use</B> [<I>type</I>]
<DD> Get [set] port use type (see Summary, below).
<DT> <B>shape</B> [<I>type</I>]
<DD> Get [set] port shape type (see Summary, below).
<DT> <B>index</B> [<I>number</I>]
<DD> Get [set] port number
<DT> <B>name</B> [<I>name</I>]
<DD> Get [set] port name. This is equivalent to <B>setlabel text</B>.
<DT> <B>first</B>
<DD> Return the first (lowest) port number used
<DT> <B>next</B> [<I>number</I>]
<DD> Return the next (higher) port number used after port <I>number</I>
if specified, or after the currently selected port if not specified.
If <I>number</I> or the currently selected port is the last port
number used, then this command returns the value -1.
<DT> <B>last</B>
<DD> Return the last (highest) port number used.
<DT> <B>equivalent</B> [<I>number</I>]
<DD> Make the port equivalent to the (other) port numbered
<I>number</I>.
@ -59,6 +72,13 @@ Declare a label to be a subcircuit port, or manipulate port parameters.
<DT> <B>remove</B>
<DD> Turn a port back into an ordinary label, removing
all of its port properties.
<DT> <B>renumber</B>
<DD> Renumber all of the (unique) ports in the edit cell by
alphabetical order of the port label text. This will
ensure that the order of ports in a SPICE netlist
generated by "extract" and "ext2spice" will always be
the same and not depend on artifacts of the way the
cell is extracted.
<DT> <B>help</B>
<DD> Print help information
</DL>
@ -105,17 +125,33 @@ Declare a label to be a subcircuit port, or manipulate port parameters.
The "direction" property of the port has no particular
meaning to magic but may be used by other programs to control
the allowed direction of routes into a standard cell. <P>
the allowed direction of routes into a standard cell. The
"direction" value should be a string containing one or more
of the compass directions <B>n</B>, <B>s</B>, <B>e</B>,
and/or <B>w</B>. The default direction when not specified
is all four directions, <B>nsew</B>. <P>
The "class" and "use" properties of the port have no
internal meaning to magic but are used by the LEF and DEF
The "class", "use", and "shape" properties of the port have
no internal meaning to magic but are used by the LEF and DEF
format read and write routines, and match the LEF/DEF
CLASS and USE properties for macro cell pins. Valid
CLASS, USE, and SHAPE properties for macro cell pins. Valid
classes are: <B>default</B>, <B>input</B>, <B>output</B>,
<B>tristate</B>, <B>bidirectional</B>, <B>inout</B>,
<B>feedthrough</B>, and <B>feedthru</B>. Valid uses are:
<B>default</B>, <B>analog</B>, <B>signal</B>, <B>digital</B>,
<B>power</B>, <B>ground</B>, and <B>clock</B>.
<B>power</B>, <B>ground</B>, and <B>clock</B>. Valid shapes
are: <B>default</B>, <B>abutment</B>, <B>ring</B>, and
<B>feedthrough</B> or <B>feedthru</B>. <P>
Normally the <B>port</B> command operates on a selected label.
However, use of the optional <I>name</I> or <I>index</I> value
in front of the command option will cause the command to
operate on the given label as determined by the label text
(<I>name</I>) or port index (<I>index</I>). In the case of
an invalid <I>name</I> or <I>index</I>, the command returns
a null value (empty string) and prints an error message. If
the command ends with the "<B>-quiet</B>" option, then no
error message is printed.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
@ -135,6 +171,6 @@ Declare a label to be a subcircuit port, or manipulate port parameters.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:10pm <P>
<P><I>Last updated:</I> November 11, 2021 at 10:13am <P>
</BODY>
</HTML>

4
doc/html/promptload.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>promptload</H2>
@ -69,6 +69,6 @@ a file to load.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 12:30am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/promptsave.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>promptsave</H2>
@ -67,6 +67,6 @@ a file to load.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:09pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/property.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>property</H2>
@ -61,6 +61,6 @@ Attach a "property" (string key and value pair) to the edit cell
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 8:05pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/pushbox.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>pushbox</H2>
@ -54,6 +54,6 @@ Save the cursor box position on a stack for later restoring.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 7, 2004 at 6:00am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/pushbutton.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>pushbutton</H2>
@ -61,6 +61,6 @@ Emulate a mouse button event.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 12:44am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/pushstack.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>pushstack</H2>
@ -61,6 +61,6 @@ using <B>popstack</B>.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:08pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/quit.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>quit</H2>
@ -58,6 +58,6 @@ Exit magic
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 1:00am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

81
doc/html/random.html Normal file
View File

@ -0,0 +1,81 @@
<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_title8_2.png ALT="Magic VLSI Layout Tool Version 8.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>random</H2>
<HR>
Generate a random number or set a random seed.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>random</B> [<B>seed</B> [<I>value</I>]]<BR><BR>
<BLOCKQUOTE>
where <I>value</I> is any integer.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>random</B> command with no arguments generates and returns a
random integer value. With option <B>seed</B> and no additional
argument, it sets the random seed value according to the current
time. With option <B>seed</B> and additional argument <I>value</I>,
it sets the random seed to the specified value. <P>
When used with option <B>seed</B>, no value is returned. <P>
Random numbers are generally frowned upon in layout because they
can make certain things non-reproducible from run to run. Magic
uses random numbers in only one very restricted circumstance,
for GDS output. The use in GDS output is restricted to the
single circumstance of writing an entire GDS file
due to use of the "GDS_FILE" property in a cell with a "GDS_START"
property value of "0". Because the GDS file may contain cells of
unknown names, and these names could collide with names in the
database, the GDS file cells are all prefixed with a random
two-character string. To prevent the same prefix from being
used on any run of magic, the random number generator should be
appropriately seeded. <P>
Note that there is no random number seeding on startup of magic,
so if needed, the random seed should be set in the startup file
or on the command line. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>random</B> is implemented as a built-in <B>magic</B> command.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=gds.html><B>gds</B></A> <BR>
</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> January 15, 2021 at 1:00pm <P>
</BODY>
</HTML>

67
doc/html/readspice.html Normal file
View File

@ -0,0 +1,67 @@
<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_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>readspice</H2>
<HR>
Read a SPICE netlist file and use the information from subcircuit definitions in the file to set port indexes.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>readspice</B> <I>filename</I> <BR><BR>
<BLOCKQUOTE>
where <I>filename</I> is the path name of a SPICE netlist file containing one or more subcircuit definitions.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>readspice</B> command is used to ensure that port indexes on
port labels in a cell match the port order specified in an existing
SPICE netlist for that cell. This is generally used with standard
cell libraries to ensure that port order is maintained in cells that
are read from GDS or LEF, neither of which declares a port order.
It will also create ports from labels in the case where a file read
from GDS does not contain layers that are interpreted as ports by
the technology file's <B>cifinput</B> section.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>readspice</B> is implemented as a Tcl procedure defined
in the GUI wrapper script. It is only available when the wrapper
is used, that is, when <B>magic</B> is invoked with argument <B>-w</B>,
although the script can be sourced from the runtime library.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=port.html><B>port</B></A> <BR>
</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> May 28, 2020 at 11:46am <P>
</BODY>
</HTML>

4
doc/html/redo.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>redo</H2>
@ -64,6 +64,6 @@ Redo commands
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 15, 2004 at 5:54am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/redraw.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>redraw</H2>
@ -49,6 +49,6 @@ Redraw the display.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 8, 2004 at 1:07am <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

4
doc/html/render3d.html
View File

@ -15,7 +15,7 @@
</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">
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>render3d</H2>
@ -54,6 +54,6 @@ Create a top-level GUI frame for handling the 3D display window.
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> November 10, 2004 at 1:09pm <P>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>

Some files were not shown because too many files have changed in this diff Show More