diff --git a/commands/CmdAB.c b/commands/CmdAB.c index 4d662dc3..c753aab2 100644 --- a/commands/CmdAB.c +++ b/commands/CmdAB.c @@ -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]) diff --git a/doc/html/addcommandentry.html b/doc/html/addcommandentry.html index a52cea10..0aec687a 100644 --- a/doc/html/addcommandentry.html +++ b/doc/html/addcommandentry.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

addcommandentry

@@ -67,6 +67,6 @@ Generate a new frame for command-line entry. Return to command index -

Last updated: October 5, 2004 at 3:19am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/addpath.html b/doc/html/addpath.html index 9fa5ad05..e86cd7f3 100644 --- a/doc/html/addpath.html +++ b/doc/html/addpath.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

addpath

@@ -67,6 +67,6 @@ Append to current search path Return to command index -

Last updated: October 3, 2004 at 6:53am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/antennacheck.html b/doc/html/antennacheck.html new file mode 100644 index 00000000..ded54529 --- /dev/null +++ b/doc/html/antennacheck.html @@ -0,0 +1,86 @@ + + + + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

antennacheck

+
+Run antenna violation checks on the current edit cell. +
+ +

Usage:

+
+ antennacheck [option]

+
+ where option may be one of the following: +
+
run +
"antennacheck run" is equivalent to "antennacheck" + with no arguments, and causes an antenna violation check to be + run. +
debug +
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. +
+
+
+ +

Summary:

+
+ The antennacheck 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. +

+ + The extract command must be run prior to antennacheck to + obtain the extracted characteristics of the design, so that all + sensitive transistor gates can be identified and enumerated.

+

+ +

Implementation Notes:

+
+ antennacheck is implemented as a built-in magic command. + The antennacheck 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). +
+ +

See Also:

+
+ extract
+
+ +

+ + + +
Return to command index +
+

Last updated: March 7, 2020 at 1:06pm

+ + diff --git a/doc/html/array.html b/doc/html/array.html index 3b78ef85..844c567d 100644 --- a/doc/html/array.html +++ b/doc/html/array.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

array

@@ -113,6 +113,6 @@ Array everything in the current selection Return to command index -

Last updated: October 16, 2004 at 2:20pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/box.html b/doc/html/box.html index 19bfe369..b5b0caa7 100644 --- a/doc/html/box.html +++ b/doc/html/box.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

box

@@ -59,6 +59,8 @@ Move box dist units in direction or (with no arguments) show box size.
Reposition a box corner
exists
Is the cursor box present? +
remove +
Make the cursor box disappear from the window
help
Print help information @@ -81,6 +83,12 @@ Move box dist units in direction or (with no arguments) show box size. (see above). The -edit 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.

+ + NOTE: Prior to magic 8.1.43, the "-edit" switch + did not work with "position". Starting from magic + 8.1.43, "-edit" works with any box 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.

For a discussion of valid distances, see the page distance. This includes @@ -142,6 +150,6 @@ Move box dist units in direction or (with no arguments) show box size. Return to command index -

Last updated: November 8, 2004 at 2:53pm

+

Last updated: October 8, 2020 at 1:53pm

diff --git a/doc/html/calma.html b/doc/html/calma.html deleted file mode 100644 index 770aa901..00000000 --- a/doc/html/calma.html +++ /dev/null @@ -1,189 +0,0 @@ - - - - -Magic-7.3 Command Reference - -

Magic VLSI Layout Tool Version 7.3 - *

- -

gds, calma

-
-Read GDSII input or generate GDSII output. -
- -

Usage:

-
- gds [option]

- calma [option]

-
- where option is one of the following: -
-
help -
Print usage information -
arrays [yes|no] -
Output arrays as individual subuses (like in CIF). Default - is "no". Normally there is no reason to do this. -
contacts [yes|no] -
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. -
flatten [yes|no] -
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. -
ordering [yes|no] -
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 gds flatten. Otherwise, the default behavior - is ordering no to avoid lengthy searches through the - GDS stream file. -
labels [yes|no] -
Cause labels to be output when writing GDSII. Default - is "yes". Normally there is no reason not to do this. -
lower [yes|no] -
Allow both upper and lower case in labels. Default is "yes". -
read file -
Read GDSII format from file file into the edit cell. - If file does not have a file extension, then magic - searches for a file named file, file.gds, - file.gds2, or file.strm. -
readonly [yes|no] -
Set cell as "read-only". This has the effect of marking each - cell definition (using the property 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 magic's GDS reader and writer to - prevent the layout from being altered. Note that "read-only" - layout can be written to a .mag 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. -
rescale [yes|no] -
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 "cif limit" function may also be used to limit - grid subdivision to a minimum value. -
warning [option] -
Set warning information level. "option" may be one - of the following: -
-
default -
The default setting is equivalent to all the other - options (align, limit, redirect, - and none) being disabled. -
align -
Generate warnings during a "cif see" 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. -
limit -
Limit warnings to the first 100 warnings or errors only. -
redirect [file] -
Redirect all warnings to an output file named file. - If file is not given, then redirection is disabled. -
none -
Do not produce any warning messages on GDS input. -
-
write file -
Output GDSII format to "file" for the window's root cell. -
polygon subcells [yes|no] -
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 magic 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. -
-
-
- -

Summary:

-
- The gds 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 cif command options (q.v.) also - affect GDS input and output. In particular, cif istyle and - cif ostyle set the input and output styles from the technology - file, respectively.

- - 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".

-

- -

Implementation Notes:

-
- gds is implemented as a built-in function in magic. - The calma command is an alias for gds and is - exactly equivalent. -
- -

Bugs:

-
- -
- -

See Also:

-
- cif
-
- -

- - - -
Return to command index -
-

Last updated: December 4, 2005 at 3:17pm

- - diff --git a/doc/html/calma.html b/doc/html/calma.html new file mode 120000 index 00000000..2a37aae1 --- /dev/null +++ b/doc/html/calma.html @@ -0,0 +1 @@ +gds.html \ No newline at end of file diff --git a/doc/html/caption.html b/doc/html/caption.html index c48781b8..50cff68c 100644 --- a/doc/html/caption.html +++ b/doc/html/caption.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

caption

@@ -58,6 +58,6 @@ Configures the titlebar of the GUI wrapper on a layout window Return to command index -

Last updated: October 3, 2004 at 8:01am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/cellmanager.html b/doc/html/cellmanager.html index eec725c6..c49e88cb 100644 --- a/doc/html/cellmanager.html +++ b/doc/html/cellmanager.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

cellmanager

@@ -164,6 +164,6 @@ Invoke the cell manager GUI window Return to command index -

Last updated: October 6, 2004 at 12:47am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/cellname.html b/doc/html/cellname.html index c0af2524..e115c405 100644 --- a/doc/html/cellname.html +++ b/doc/html/cellname.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

cellname

@@ -32,6 +32,9 @@ Operations on cell definitions.
[list] children [name]
List all of the children definitions of cell name, or the children of the currently selected cell instance. +
[list] childinst [name] +
List all of the children instances of cell name, + or the children of the currently selected cell instance.
[list] parent [name]
List the parent cell definition of cell name, or the parent of the currently selected cell instance. @@ -74,6 +77,11 @@ Operations on cell definitions. will be prohibited. If the cell name is currently the topmost cell in the window, the window will be loaded with default cell "(UNNAMED)". +
dereference name +
Perform a flush of the cell (per the "flush" 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.
flags
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. -
writeable [true|false] +
timestamp name [value] +
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 clock + command, e.g., "clock format [cellname timestamp]". +
filepath name [default|pathname] +
With no option, this command returns the path to the file + for the cell name, or the keyword "default" + if the cell is not associated with a specific file path. + With option "default", if the cell is associated + with a specific file path, that association is removed. + With option "pathname", 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 + "save" 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. +
writeable name [true|false]
Option writeable false 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.
instance
load
+ path
+ flush
tk_path_name
@@ -141,6 +171,6 @@ Operations on cell definitions. Return to command index -

Last updated: December 4, 2005 at 5:38pm

+

Last updated: February 3, 2021 at 3:52pm

diff --git a/doc/html/cellsearch.html b/doc/html/cellsearch.html index 2369902b..fe35af59 100644 --- a/doc/html/cellsearch.html +++ b/doc/html/cellsearch.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

cellsearch

@@ -108,6 +108,6 @@ Execute a TCL procedure on each cell definition or instance in the hierarchy Return to command index -

Last updated: October 4, 2004 at 5:05am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/center.html b/doc/html/center.html index 342af7d5..cd69e796 100644 --- a/doc/html/center.html +++ b/doc/html/center.html @@ -1,7 +1,3 @@ - -center [x y] - - + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

drop

+
+Paint into descendents of the current edit cell coincident with a selection. +
+ +

Usage:

+
+ drop layers

+
+ where layers is a comma-separated list of types to paint. +
+
+ +

Summary:

+
+ The drop 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 layers back into those subcells in an area coincident + with the selected paint.

+ + 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: "select area dnwell ; + select intersect ~nwell ; drop pwell" will ensure that the pwell + layer exists over the area inside a deep nwell p-region.

+ + Be aware that because other instances of a cell may exist outside of + the selection area, that all instances of a cell modified by drop + will be likewise modified.

+ +

+ +

Implementation Notes:

+
+ drop is implemented as a built-in command in magic. +
+ +

See Also:

+
+ select
+
+ +

+ + + +
Return to command index +
+

Last updated: March 25, 2021 at 9:48pm

+ + diff --git a/doc/html/dump.html b/doc/html/dump.html index e9a79404..2a25e854 100644 --- a/doc/html/dump.html +++ b/doc/html/dump.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

dump

@@ -67,6 +67,6 @@ Copy contents of the indicated cell into the current edit cell. Return to command index -

Last updated: October 6, 2004 at 2:53am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/edit.html b/doc/html/edit.html index d0b41985..79677855 100644 --- a/doc/html/edit.html +++ b/doc/html/edit.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

edit

@@ -49,6 +49,6 @@ Use selected cell as new edit cell Return to command index -

Last updated: October 6, 2004 at 12:55am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/element.html b/doc/html/element.html index 8603355b..f939baf6 100644 --- a/doc/html/element.html +++ b/doc/html/element.html @@ -1,5 +1,3 @@ - - + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

locking

+
+Control the behavior of file locking. +
+ +

Usage:

+
+ locking [enable|disable]

+
+ +

Summary:

+
+ The locking 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.

+ + Any cell that is read-only can be forced editable using the + "cellname writeable" 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.

+ + This is not a perfect protection mechanism, since the "cellname + writeable" 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.

+ + 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 locking disable + command option will prevent issues with the filesystem at the + expense of file lock protection.

+ + With no arguments, locking returns the state of the + file locking, either "enabled" or "disabled".

+ +

+ +

Implementation Notes:

+
+ locking is implemented as a built-in command in magic + from version tag 8.3.249. +
+ +

See Also:

+
+ cellname
+
+ +

+ + + +
Return to command index +
+

Last updated: January 1, 2022 at 3:11pm

+ + diff --git a/doc/html/logcommands.html b/doc/html/logcommands.html index 9e4ec4ca..7c15ec74 100644 --- a/doc/html/logcommands.html +++ b/doc/html/logcommands.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

logcommands

@@ -50,6 +50,6 @@ Log all commands into a file Return to command index -

Last updated: October 7, 2004 at 2:06am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/macro.html b/doc/html/macro.html index e12e96e0..19a3e0fc 100644 --- a/doc/html/macro.html +++ b/doc/html/macro.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

macro

@@ -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 keysymdef.h are "XK_Pointer_Button1", + in keysymdef.h are "XK_Pointer_Button_1", etc., the macro command accepts the abbreviated forms Button1, and so forth.

@@ -97,6 +97,6 @@ Define or print a macro called char Return to command index -

Last updated: November 10, 2004 at 10:34am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/maketoolbar.html b/doc/html/maketoolbar.html index f65844d6..1bd3f99b 100644 --- a/doc/html/maketoolbar.html +++ b/doc/html/maketoolbar.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

maketoolbar

@@ -96,6 +96,6 @@ Generate the GUI layout window toolbar. Return to command index -

Last updated: October 7, 2004 at 3:12am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/measure.html b/doc/html/measure.html index 7c2d9a95..cece15c4 100644 --- a/doc/html/measure.html +++ b/doc/html/measure.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

measure

@@ -61,6 +61,6 @@ Create a ruler to measure the distance between two points on a layout. Return to command index -

Last updated: December 4, 2005 at 9:12pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/move.html b/doc/html/move.html index 36daa736..b1fd74c3 100644 --- a/doc/html/move.html +++ b/doc/html/move.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

move

@@ -33,7 +33,7 @@ Move the cursor box and the selection.

Usage:

- move [option]

+ move [origin] [option]

where option is one of the following:
@@ -62,6 +62,15 @@ Move the cursor box and the selection. indicated amount. The default distance is 1 unit (usually lambda; see distance for further explication).

+ + The option origin does not require a selection. It will + relocate the entire design such that the origin (coordianate 0, 0) + is at the position indicated by option. 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 "move origin" is always + preferred.

Implementation Notes:

@@ -81,6 +90,6 @@ Move the cursor box and the selection. Return to command index -

Last updated: October 7, 2004 at 3:19am

+

Last updated: March 20, 2020 at 1:50pm

diff --git a/doc/html/netlist.html b/doc/html/netlist.html index 5e843cb0..3893d6e2 100644 --- a/doc/html/netlist.html +++ b/doc/html/netlist.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

netlist

@@ -76,6 +76,6 @@ Netlist operations for use with the "netlist tool" in a layout window. Return to command index -

Last updated: November 10, 2004 at 10:44am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/openwindow.html b/doc/html/openwindow.html index 21754f0e..668c3eff 100644 --- a/doc/html/openwindow.html +++ b/doc/html/openwindow.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

openwindow

@@ -76,6 +76,6 @@ Open a new (non-GUI) layout window with indicated name, bound to indicated cell Return to command index -

Last updated: December 4, 2005 at 9:03pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/openwrapper.html b/doc/html/openwrapper.html index d88b4e81..34bf0236 100644 --- a/doc/html/openwrapper.html +++ b/doc/html/openwrapper.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

openwrapper

@@ -68,6 +68,6 @@ Open a GUI layout window and all of its associated frames. Return to command index -

Last updated: October 7, 2004 at 5:40am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/orient.html b/doc/html/orient.html new file mode 100644 index 00000000..0fe50021 --- /dev/null +++ b/doc/html/orient.html @@ -0,0 +1,76 @@ + + + + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

orient

+
+Orient the selection according to the specified orientation. +
+ +

Usage:

+
+ orient [orientation] [-origin]

+
+ where orientation is an orientaton in the form given by + the instance orientation command, or an orienation in + DEF format (see below). +
+
+ +

Summary:

+
+ The orient command orients the selection according to the + given orientation, which may be in the same syntax returned + by the "instance orientation" command, or according to the + syntax used by the DEF format.

+ + Valid values for orientation are: 0, 90, 180, + 270, h, v, or any combination of rotation and + h or v (e.g., 90h); or the DEF orientations + N, S, E, W, FN, FS, + FE, and FW.

+ + If -origin is specified, the orientation is around the + origin of the selection, not around the lower left-hand + corner (see the clockwise command). +

+ +

Implementation Notes:

+
+ orient is implemented as a built-in magic command. +
+ +

See Also:

+
+ clockwise
+ sideways
+ upsidedown
+ instance
+ getcell
+
+ +

+ + + +
Return to command index +
+

Last updated: October 30, 2020 at 10:50am

+ + diff --git a/doc/html/paint.html b/doc/html/paint.html index 0db2b4d5..328eccb2 100644 --- a/doc/html/paint.html +++ b/doc/html/paint.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

paint

@@ -71,6 +71,6 @@ Paint mask information into the current edit cell Return to command index -

Last updated: November 8, 2004 at 3:02pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/path.html b/doc/html/path.html index 41138c7f..741384cf 100644 --- a/doc/html/path.html +++ b/doc/html/path.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

path

@@ -69,6 +69,6 @@ path [search|cell|sys] [[+]path] Return to command index -

Last updated: October 7, 2004 at 5:54am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/peekbox.html b/doc/html/peekbox.html index 1924f937..db094d91 100644 --- a/doc/html/peekbox.html +++ b/doc/html/peekbox.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

peekbox

@@ -55,6 +55,6 @@ Query the last saved cursor box position Return to command index -

Last updated: October 7, 2004 at 5:59am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/plot.html b/doc/html/plot.html index 2bcc1e88..0b238046 100644 --- a/doc/html/plot.html +++ b/doc/html/plot.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

plot

@@ -36,7 +36,44 @@ Hardcopy plotting layout underneath the box. The output size is propotional to scale, where a scale of 1 is one output pixel per magic internal unit. The default scale - value, if unspecified, is 0.5. + value, if unspecified, is 0.5.

+ Note: Magic version 7.5.45 changed the syntax to
+ plot pnm file [width [layers]]
+ where width 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 "pnmplotRTL" is + set to true, 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. +
svg file +
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 only availble when magic is invoked with + the Cairo graphics interface ("magic -d XR"), + because the libcairo 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, + all 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. +
versatec scale [layers] +
Generate an HPRTL or HPGL2 rasterized rendering of the + layout underneath the box. The scale 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).
parameters [name value]
Set or print out plotting parameters (see Summary below).
help @@ -91,6 +128,43 @@ Hardcopy plotting PS_margin 72 (1in) Minimum margin to allow on all sides of the output page + HPRTL/HPGL2 parameters: + + + + + + + + + + + + + + + + + + + + + + + +
parameter name default value explanation
cellIdFont vfont.I.12 Font used for cell use identifier names. The default + font is part of the Magic distribution.
cellNameFont vfont.B.12 Font used for cell definition names. The default + font is part of the Magic distribution.
labelFont vfont.R.8 Font used for labels. The default font is part of + the Magic distribution.
directory /tmp The directory used to store the temporary output file + that is generated prior to spooling for the printer.
dotsPerInch 300 The native resolution of the target rendering device + (printer or plotter)
printer versatec Name of the print spool queue.
spoolCommand lp -d %s %s The OS command to use to send the plot to the printer + or plotter.
swathHeight 64 The number of lines of output resolution that Magic + will generate at a time. Normally it is not necessary to + mess with this value.
width 2400 The pixel width of the output device.
plotType hprtl The format of the plot to make. The choices are + hprtl (equivalent to PCL5) and hpgl2 for + the most common raster plot formats. The two (very!) + outdated formats versatec_color and + versatec_bw are retained for compatibility.
PNM parameters: @@ -129,6 +203,19 @@ Hardcopy plotting memory blocksize pnmmaxmem will force downsampling regardless of the value of pnmdownsample. + +
parameter name default value
pnmplotRTL false When set to value true, 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. +
@@ -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.

Implementation Notes:

@@ -158,6 +249,6 @@ Hardcopy plotting Return to command index -

Last updated: December 4, 2005 at 3:24pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/plow.html b/doc/html/plow.html index be49aa27..f9ee7eb4 100644 --- a/doc/html/plow.html +++ b/doc/html/plow.html @@ -1,6 +1,3 @@ - - - + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.3 + *

+ +

random

+
+Generate a random number or set a random seed. +
+ +

Usage:

+
+ random [seed [value]]

+
+ where value is any integer. +
+
+ +

Summary:

+
+ The random command with no arguments generates and returns a + random integer value. With option seed and no additional + argument, it sets the random seed value according to the current + time. With option seed and additional argument value, + it sets the random seed to the specified value.

+ + When used with option seed, no value is returned.

+ + 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.

+ + 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.

+ +

+ +

Implementation Notes:

+
+ random is implemented as a built-in magic command. +
+ +

See Also:

+
+ gds
+
+ +

+ + + +
Return to command index +
+

Last updated: January 15, 2021 at 1:00pm

+ + diff --git a/doc/html/readspice.html b/doc/html/readspice.html new file mode 100644 index 00000000..ccebcdca --- /dev/null +++ b/doc/html/readspice.html @@ -0,0 +1,67 @@ + + + + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

readspice

+
+Read a SPICE netlist file and use the information from subcircuit definitions in the file to set port indexes. +
+ +

Usage:

+
+ readspice filename

+
+ where filename is the path name of a SPICE netlist file containing one or more subcircuit definitions. +
+
+ +

Summary:

+
+ The readspice 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 cifinput section. +
+ +

Implementation Notes:

+
+ readspice is implemented as a Tcl procedure defined + in the GUI wrapper script. It is only available when the wrapper + is used, that is, when magic is invoked with argument -w, + although the script can be sourced from the runtime library. +
+ +

See Also:

+
+ port
+
+ +

+ + + +
Return to command index +
+

Last updated: May 28, 2020 at 11:46am

+ + diff --git a/doc/html/redo.html b/doc/html/redo.html index b7fe393f..07996857 100644 --- a/doc/html/redo.html +++ b/doc/html/redo.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

redo

@@ -64,6 +64,6 @@ Redo commands Return to command index -

Last updated: October 15, 2004 at 5:54am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/redraw.html b/doc/html/redraw.html index bf71f47e..842dbc7b 100644 --- a/doc/html/redraw.html +++ b/doc/html/redraw.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

redraw

@@ -49,6 +49,6 @@ Redraw the display. Return to command index -

Last updated: October 8, 2004 at 1:07am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/render3d.html b/doc/html/render3d.html index f744a482..bc5d8a2b 100644 --- a/doc/html/render3d.html +++ b/doc/html/render3d.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

render3d

@@ -54,6 +54,6 @@ Create a top-level GUI frame for handling the 3D display window. Return to command index -

Last updated: November 10, 2004 at 1:09pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/resumeall.html b/doc/html/resumeall.html index 850388fd..0058422a 100644 --- a/doc/html/resumeall.html +++ b/doc/html/resumeall.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

resumeall

@@ -63,6 +63,6 @@ Resume normal display refresh on all windows. Return to command index -

Last updated: October 8, 2004 at 1:25am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/rotate.html b/doc/html/rotate.html index 69e21b42..7ed43b1f 100644 --- a/doc/html/rotate.html +++ b/doc/html/rotate.html @@ -1,9 +1,3 @@ - -rotate [+/-][deg] - rotate selection and box (counter)clockwise - only manhattan rotations (90, 180, 270) are - supported - + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

setlabel

+
+Manipulate rendered font labels +
+ +

Usage:

+
+ setlabel [-default] option

+
+ where option is one of the following: +
+
text [string] +
Report the text string of all selected labels, or change + the text string of selected labels to string. +
font [name [scale]] +
Report the font of all selected labels, or set the font + to the font named name, where name is one + of the known fonts returned by the command "setlabel + fontlist". If the named font is not in the list, magic + will attempt to load it, if the font vector list can be + found (the font vector list should be in an unencoded + PostScript Type3 font format). Magic scales all fonts + such that label size can be specified in database units. + Unfortunately, fonts tend to have characters (accents, for + example) well above the height of a standard capital letter, + and these characters result in the inability to extract the + font height from the font metrics. In such (common) cases, + the optional floating-point scale value specifies the + difference between the character height and the font height + reported by the font metrics. Typically, this number is + around 0.6. +
font number +
For number zero or larger, this option returns the + name of the font that is index number into the list + of loaded fonts. No other action is taken. For number + equal to -1, the font of the selected label is reset + to the default X11 font, and properties such as scale, + offset, and rotation are ignored. Justification is retained. +
fontlist +
Return a list of the known, loaded fonts. +
justify [position] +
Report the justification of all selected labels, or change the + justification to position, which may be any compass + direction or "center". +
size [value] +
Report the size of all selected labels, or change the size of + selected labels to value, which may be given in units + of lambda, or a metric measurement (e.g., "1um"). The + text will be adjusted so that the height of capitalized text + from the text baseline is equal to the requested value. +
offset [x y] +
Report the offset of all selected labels (in x y pairs), + or change the offset, which is the spacing between the point + marked by the label and the label text. In the case of a + rectangle identifying a label, the spacing is measured from the + center of the rectangle. +
rotate [value] +
Report the angle of rotation of all selected labels, or change + the angle, which is measured in degrees counterclockwise. + Any integer angle is acceptable. Labels are always drawn + upright, so labels rotated from 90 to 270 degrees undergo an + additional 180 degree rotation within their bounding box + to ensure that the text always remains upright. Likewise, + rotations and reflections of subcells are applied to the + label bounding box, with the text rotated within the bounding + box to ensure an upright orientation. If this explanation is + a bit obscure, then the rule is: if a label is drawn on a cell + such that it occupies a specific place with respect to the cell + layout, then it will always appear in that same place regardless + of how the cell is oriented in the hierarchy of a layout. +
layer [name] +
Report the layer type to which the label is attached. + If the optional name is given, and is a valid layer + name, then the label is modified to be attached to that + layer type. Note that if the layer is not also declared + "sticky" (see below), then it is likely to be reattached to + the original layer during certain operations. +
sticky [true|false] +
Report the status of the "sticky" flag for the label. Labels + which have the "sticky" flag set can only attach to the + assigned layer type. Such labels may be placed over a layer + that exists only in a subcell, unlike non-sticky labels, + which will reattach to any available layer or else be + assigned to "space". Value returned is 1 (true) or 0 (false). + If "true" or "false" is specified, then the + sticky flag is set or cleared, respectively. +
+
+
+ +

Summary:

+
+ The setlabel command manipulates selected text labels. In versions + of magic prior to 8.0, labels could not be manipulated, but could + only be changed by removing and replacing the label. Labels were drawn + in an X11 font that was scaled relative to the window, not the layout. + setlabel not only allows text strings to be modified on any labels, + but also allows labels to be drawn in scaled fonts, rotated and offset + to a specific position. Fonts are read from simple, ASCII-encoded + PostScript Type-3 font files, such as provided by the Freefont project. +

+ + If -default is specified, then the given option is set as a + default, if a value is supplied. If no value is supplied, then the + value of the default is returned. The default values are applied + when the "label command is issued without the full set of + values. The -default option may be used with any label + property except for text. +

+ + The default values, if not changed by using the -default option, + are as follows: +
+
font +
default Fixed-width X11 bitmap font. +
justify +
-1 Default justification, automatically determined. +
size +
0 Size is determined by the default font. +
offset +
0 0 Text is not offset. +
rotate +
0 Text is not rotated. +
layer +
-1 Default layer type, automatically determined. +
sticky +
0 Labels are not sticky by default. +
+
+ +

Implementation Notes:

+
+ setlabel is implemented as a built-in command in magic + version 8.0 (or higher) only. +
+ +

See Also:

+
+ label
+
+ +

+ + + +
Return to command index +
+

Last updated: March 17, 2021 at 11:16am

+ + diff --git a/doc/html/setpoint.html b/doc/html/setpoint.html index e2297ff8..833ca7ec 100644 --- a/doc/html/setpoint.html +++ b/doc/html/setpoint.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

setpoint

@@ -79,6 +79,6 @@ Set the value of the cursor reference point in a specific window. Return to command index -

Last updated: December 4, 2005 at 9:02pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/shell.html b/doc/html/shell.html index 4bd031e9..96e17052 100644 --- a/doc/html/shell.html +++ b/doc/html/shell.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

shell

@@ -61,6 +61,6 @@ Execute a command in a UNIX subshell Return to command index -

Last updated: October 8, 2004 at 3:55am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/sideways.html b/doc/html/sideways.html index 411e7916..71640cce 100644 --- a/doc/html/sideways.html +++ b/doc/html/sideways.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

sideways

@@ -56,6 +56,6 @@ Flip selection and box sideways Return to command index -

Last updated: October 8, 2004 at 6:02am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/sleep.html b/doc/html/sleep.html index 1d0b69a3..c3875165 100644 --- a/doc/html/sleep.html +++ b/doc/html/sleep.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

sleep

@@ -51,6 +51,6 @@ Sleep for a number of seconds Return to command index -

Last updated: October 8, 2004 at 6:28am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/snap.html b/doc/html/snap.html index 3e40e5a3..b1bdb30a 100644 --- a/doc/html/snap.html +++ b/doc/html/snap.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

snap

@@ -89,6 +89,6 @@ in the selected grid. Return to command index -

Last updated: October 8, 2004 at 7:16am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/specialopen.html b/doc/html/specialopen.html index 70311e21..78562cea 100644 --- a/doc/html/specialopen.html +++ b/doc/html/specialopen.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

specialopen

@@ -75,6 +75,6 @@ Open a window of a specific type. Return to command index -

Last updated: October 8, 2004 at 7:29am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/spliterase.html b/doc/html/spliterase.html index 9a72ead8..2ae305a4 100644 --- a/doc/html/spliterase.html +++ b/doc/html/spliterase.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

spliterase

@@ -72,6 +72,6 @@ the other. Return to command index -

Last updated: October 8, 2004 at 7:41am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/splitpaint.html b/doc/html/splitpaint.html index 36a23905..47219c18 100644 --- a/doc/html/splitpaint.html +++ b/doc/html/splitpaint.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

splitpaint

@@ -70,6 +70,6 @@ the other. Return to command index -

Last updated: October 8, 2004 at 7:38am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/startup.html b/doc/html/startup.html index 33c9be3d..8dcd460d 100644 --- a/doc/html/startup.html +++ b/doc/html/startup.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

startup

@@ -58,6 +58,6 @@ Start magic from inside the Tcl interpreter. Return to command index -

Last updated: October 8, 2004 at 8:00am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/straighten.html b/doc/html/straighten.html index 0935ae0f..595ef61c 100644 --- a/doc/html/straighten.html +++ b/doc/html/straighten.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

straighten

@@ -56,6 +56,6 @@ Straighten jogs by pulling in direction Return to command index -

Last updated: October 8, 2004 at 8:34pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/stretch.html b/doc/html/stretch.html index bd4f8403..c5a188d7 100644 --- a/doc/html/stretch.html +++ b/doc/html/stretch.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

stretch

@@ -91,6 +91,6 @@ Stretch the cursor box and the selection. Return to command index -

Last updated: October 16, 2004 at 2:00pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/suspendall.html b/doc/html/suspendall.html index 4a0c8fd7..4133a5ee 100644 --- a/doc/html/suspendall.html +++ b/doc/html/suspendall.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

suspendall

@@ -64,6 +64,6 @@ of a corresponding resumeall command. Return to command index -

Last updated: October 8, 2004 at 1:24am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/tag.html b/doc/html/tag.html index c65e7896..bdcb0950 100644 --- a/doc/html/tag.html +++ b/doc/html/tag.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

tag

@@ -111,6 +111,6 @@ Register a tag callback command. Return to command index -

Last updated: October 8, 2004 at 10:15pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/tech.html b/doc/html/tech.html index 8f0a511f..1a638025 100644 --- a/doc/html/tech.html +++ b/doc/html/tech.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

tech

@@ -46,6 +46,19 @@ technology.
Show defined planes
layers [layer]
Show defined layers +
layers lock|unlock [layer] +
Lock or unlock layers. When locked, a layer cannot be changed + on the layout. Paint of that layer type cannot be copied, moved, + deleted, or operated upon in any manner that would change the + geometry of that layer. This is useful, for example, to + prevent mask layers from being modified when working on + modifications to a process back-end. Note that layers can + be marked locked in a tech file by prefixing the layer name + with "-". +
layers revert +
Return the set of locked and unlock layers to the state + subsequent to reading the tech file (available from magic + version 8.0.183).
drc option
Query the DRC ruleset, where option is one of the following: @@ -126,6 +139,6 @@ technology. Return to command index -

Last updated: October 16, 2004 at 1:59pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/techmanager.html b/doc/html/techmanager.html index 209e672f..ee2a2b2d 100644 --- a/doc/html/techmanager.html +++ b/doc/html/techmanager.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

techmanager

@@ -66,6 +66,6 @@ Generate the technology manager GUI window. Return to command index -

Last updated: October 8, 2004 at 11:09pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/template.html b/doc/html/template.html index 288e491d..6984ede5 100644 --- a/doc/html/template.html +++ b/doc/html/template.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

command_name

@@ -61,6 +61,6 @@ Short summary. Return to command index -

Last updated: October 6, 2004 at 12:21am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/tk_path_name.html b/doc/html/tk_path_name.html index 55019fd8..76e19732 100644 --- a/doc/html/tk_path_name.html +++ b/doc/html/tk_path_name.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

tk_path_name

@@ -71,7 +71,23 @@ Execute a window command in the indicated window. specialopen command have their Tk path names registered as commands with the Tcl interpreter, and can be passed commands recognized by the specific window type (e.g., - netlist commands in the netlist special window). + netlist commands in the netlist special window).

+ + The tk_path_name commands effectively implement the command + "send" as it is used in the non-Tcl-based versions of Magic. + For example, the command "send netlist shownet" can be written, + in Tcl-based Magic, as the following: +

+ [windownames netlist] shownet +
+ Note here the nested command "windownames netlist" that + returns the Tk path name of the netlist window, which is then + evaluated as a command. + + +

See Also:

+
+ windownames

Implementation Notes:

@@ -88,6 +104,6 @@ Execute a window command in the indicated window. Return to command index -

Last updated: October 16, 2004 at 1:54pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/tool.html b/doc/html/tool.html index 995beb7e..699fb2fd 100644 --- a/doc/html/tool.html +++ b/doc/html/tool.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

tool

@@ -114,6 +114,6 @@ button bindings are for the current tool. This page describes the Return to command index -

Last updated: December 4, 2005 at 5:11pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/undo.html b/doc/html/undo.html index 5362d367..c59eceed 100644 --- a/doc/html/undo.html +++ b/doc/html/undo.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

undo

@@ -31,6 +31,7 @@ Undo commands

Usage:

undo [print [count]]

+ undo enable|disable

where count indicates a number of events to be undone (default 1 event), and must be a nonzero positive integer. @@ -47,11 +48,17 @@ Undo commands Certain commands in magic disable the undo mechanism, thus preventing the command from being undone. These include layout reads and writes, CIF, GDS, and LEF/DEF reads and - writes. + writes.

The print option generates a stack trace of the top count events in the undo stack, in excruciating - detail. + detail.

+ + The undo disable option disables the command queue and + prevents all following commands to be undoable until the + undo enable command option is given. This can save + time and memory for operations in a batch file where commands + will never be able to be undone.

Implementation Notes:

@@ -70,6 +77,6 @@ Undo commands Return to command index -

Last updated: October 15, 2004 at 5:55am

+

Last updated: June 22, 2021 at 8:26pm

diff --git a/doc/html/unexpand.html b/doc/html/unexpand.html index bc6adc15..6ff8bf7b 100644 --- a/doc/html/unexpand.html +++ b/doc/html/unexpand.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

unexpand

@@ -57,6 +57,6 @@ Unexpand everything inside or touching the cursor box. Return to command index -

Last updated: October 16, 2004 at 1:58pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/unmeasure.html b/doc/html/unmeasure.html index a24acef9..0e73f155 100644 --- a/doc/html/unmeasure.html +++ b/doc/html/unmeasure.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

unmeasure

@@ -52,6 +52,6 @@ Remove a ruler generated with the measure script. Return to command index -

Last updated: December 4, 2005 at 9:20pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/updatedisplay.html b/doc/html/updatedisplay.html index e1a369de..b2a9079e 100644 --- a/doc/html/updatedisplay.html +++ b/doc/html/updatedisplay.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

updatedisplay

@@ -62,6 +62,6 @@ Force display update, or suspend/resume updates Return to command index -

Last updated: October 9, 2004 at 1:45am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/upsidedown.html b/doc/html/upsidedown.html index d82bb1bd..2e974877 100644 --- a/doc/html/upsidedown.html +++ b/doc/html/upsidedown.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

upsidedown

@@ -56,6 +56,6 @@ Flip selection and box upside down Return to command index -

Last updated: October 8, 2004 at 6:17am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/version.html b/doc/html/version.html index 2e04dc41..43f40c8a 100644 --- a/doc/html/version.html +++ b/doc/html/version.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

version

@@ -46,6 +46,6 @@ Print version and revision info Return to command index -

Last updated: December 4, 2005 at 3:19pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/view.html b/doc/html/view.html index 2bc64671..f9a8d783 100644 --- a/doc/html/view.html +++ b/doc/html/view.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

view

@@ -68,6 +68,6 @@ view [get|bbox|llx lly urx ury] Return to command index -

Last updated: October 9, 2004 at 1:59am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/what.html b/doc/html/what.html index d03c5105..03948750 100644 --- a/doc/html/what.html +++ b/doc/html/what.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

what

@@ -31,7 +31,7 @@ Short summary.

Usage:

- what [-list]

+ what [-list[all]]

Summary:

@@ -48,7 +48,13 @@ Short summary. items: The label text, the layer the label is attached to, and the cell def containing the label. Each subcell in the third sub-list is itself a list of two items: The subcell instance - ID name, and the cell definition name. + ID name, and the cell definition name.

+ + -listall is a variant of the Tcl list, in which the first + sub-list contains the types found, where each entry is itself a + list. Each list entry first item is the name of the layer, and + the second entry is a list containing the names of all subcells + where that type is found.

Implementation Notes:

@@ -62,6 +68,6 @@ Short summary. Return to command index -

Last updated: October 15, 2004 at 6:25am

+

Last updated: March 24, 2021 at 3:30pm

diff --git a/doc/html/windowborder.html b/doc/html/windowborder.html index 4b935c7b..e3b803ab 100644 --- a/doc/html/windowborder.html +++ b/doc/html/windowborder.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

windowborder

@@ -51,6 +51,6 @@ Toggle border drawing for new windows Return to command index -

Last updated: October 9, 2004 at 2:20am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/windowcaption.html b/doc/html/windowcaption.html index db87461b..8d6a6c6c 100644 --- a/doc/html/windowcaption.html +++ b/doc/html/windowcaption.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

windowcaption

@@ -52,6 +52,6 @@ Toggle title caption for new windows Return to command index -

Last updated: October 9, 2004 at 2:21am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/windownames.html b/doc/html/windownames.html index df73f760..f8b75576 100644 --- a/doc/html/windownames.html +++ b/doc/html/windownames.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

windownames

@@ -51,7 +51,8 @@ Get name of current or all windows

See Also:

setpoint
-
+ tk_path_name +

Implementation Notes:

@@ -66,6 +67,6 @@ Get name of current or all windows Return to command index -

Last updated: December 4, 2005 at 8:40pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/windowscrollbars.html b/doc/html/windowscrollbars.html index e0dc0f87..4d5c0f62 100644 --- a/doc/html/windowscrollbars.html +++ b/doc/html/windowscrollbars.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

windowscrollbars

@@ -52,6 +52,6 @@ Toggle scroll bars for new windows Return to command index -

Last updated: October 9, 2004 at 2:22am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/wire.html b/doc/html/wire.html index f9f11cbe..f42bd683 100644 --- a/doc/html/wire.html +++ b/doc/html/wire.html @@ -20,7 +20,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

wire

@@ -55,6 +55,10 @@ Generate wires from the command line.
add a new vertical wire leg
segment layer width x1 y1 x2 y2... [-noendcap]
Paint one or more wire segments +
segment layer width filename [-noendcap] +
Paint one or more wire segments taken from the text file + filename containing two coordinates X and Y per line, + one line per path point.
show
Determine where the next wire leg will be according to the rules for wire leg, but place the result in @@ -90,7 +94,28 @@ Generate wires from the command line. the wire width. The -noendcap option causes the wire to end at the coordinate, with no extension. The wire segment command is intended to be used from Tcl scripts for automatic - layout generation. + layout generation.

+ + The first format for wire segment has coordinates specified + on the command line. For wire segments with too many points, this + command may overrun the internal limit on either number of command-line + arguments or the total number of characters in the command line. To + work around these limits, the second format of the command specifies + a filename in place of the coordinate list. The file is a simple + text file, with one line per coordinate pair. X and Y values must be + separated by whitespace. The syntax for each value is the same as for + the command; e.g., one can use integers which will be interpreted + relative to the current snap setting, or one can specify the units, + such as "100um".

+ + When generating path points from a script, the most convenient method + is to create an empty list ("{}"), then use "lappend" to add coordinates + to the list. Once the list is complete, it is necessary to use "eval" + to decompose the list. +

+ Incorrect: wire segment m1 50 $pointlist
+ Correct: eval "wire segment m1 50 $pointlist" +

Implementation Notes:

@@ -109,6 +134,6 @@ Generate wires from the command line. Return to command index -

Last updated: December 4, 2005 at 8:38pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/writeall.html b/doc/html/writeall.html index 5f3ba554..a36d87fc 100644 --- a/doc/html/writeall.html +++ b/doc/html/writeall.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

writeall

@@ -88,6 +88,6 @@ Write out all modified cells to disk Return to command index -

Last updated: December 4, 2005 at 8:09pm

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/xload.html b/doc/html/xload.html index 285f4655..e2694e2a 100644 --- a/doc/html/xload.html +++ b/doc/html/xload.html @@ -15,10 +15,10 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

-

command_name

+

xload

Load a cell into a window unexpanded
@@ -57,6 +57,6 @@ Load a cell into a window unexpanded Return to command index -

Last updated: October 9, 2004 at 7:17am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/xor.html b/doc/html/xor.html new file mode 100644 index 00000000..0eb4bcc3 --- /dev/null +++ b/doc/html/xor.html @@ -0,0 +1,117 @@ + + + + +Magic-7.3 Command Reference + +

Magic VLSI Layout Tool Version 8.2 + *

+ +

xor

+
+Perform exclusive-or between the current cell and the indicated destination cell. +The destination cell is overwritten with the result. +
+ +

Usage:

+
+ xor [option] cellname

+
+ where cellname is the name of a cell definition to be + compared against, and into which the compared geometry will be placed. + option may be one of -nolabels, -nosubcircuit, + or -novendor, similar to the "flatten" command. +
+
+ +

Summary:

+
+ The xor command compares the current edit cell against + the target cell cellname by flattening and exclusive-or, + replacing the target cell paint as it works. The result is an + empty cell if the two cells have exactly the same geometry; + otherwise, paint remains in the target cell where the geometry + of the current edit cell does not match the geometry of the + target cell. +

+ + The target cell is assumed to be flattened already. That is, + to compare hierarchical layout layout1 to hierarchical + layout layout2, one would normally do: + +

+ load layout1
+ flatten dest
+ load layout2
+ xor dest
+
+ + This will result in cell dest containing geometry + mismatches between cell layout1 and cell layout2.

+ + The options allow selective flattening, as follows: +

+
-nolabels +
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. +
-nosubcircuit +
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. +
-novendor +
Prevents magic from flattening cells that are vendor cells, + that is, cells that are generated by reading GDS using the + gds readonly option, or which have the appropriate + property values set. +
+ + In effect, xor is just the command flatten called + with a special paint translation table that erases paint in the + target when painted with the same type from the source.

+ + Note that cellname is a top-level cell but is not displayed + or saved subsequent to the xor command. The usual + procedure is to follow the command "xor cellname" + with "load cellname", to view the new compared + layout.

+ + Also note that a technology file's paint and erase tables + can interfere with strict XOR function results. Typical paint + and erase rules will tend to generate a result that is useful + for a yes-no answer (cells either match or not), and for finding + places in mismatched cells where differences occur. But it may + not be possible to determine exactly what the difference is + from the xor output. For a "proper" XOR function, use + a techfile that does not have interacting types and planes, and + draws contact cuts on separate planes rather than using magic's + contact types (which automatically have interacting paint and + erase rules). +

+ +

Implementation Notes:

+
+ xor is implemented as a built-in command in magic, + available from magic version 8.1.64. +
+ +

+ + + +
Return to command index +
+

Last updated: March 7, 2020 at 1:06pm

+ + diff --git a/doc/html/xview.html b/doc/html/xview.html index 887f22d1..0d2a2652 100644 --- a/doc/html/xview.html +++ b/doc/html/xview.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

xview

@@ -54,6 +54,6 @@ visible but unexpanded. Return to command index -

Last updated: October 9, 2004 at 7:17am

+

Last updated: March 7, 2020 at 1:06pm

diff --git a/doc/html/zoom.html b/doc/html/zoom.html index 54eec620..6dc4efb6 100644 --- a/doc/html/zoom.html +++ b/doc/html/zoom.html @@ -15,7 +15,7 @@ Magic-7.3 Command Reference -

Magic VLSI Layout Tool Version 7.3 +

Magic VLSI Layout Tool Version 8.2 *

zoom

@@ -69,6 +69,6 @@ Zoom window by specified magnification factor. Return to command index -

Last updated: October 9, 2004 at 7:23am

+

Last updated: March 7, 2020 at 1:06pm