File: select.html

package info (click to toggle)
magic 7.5.241-1
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 17,772 kB
  • ctags: 12,301
  • sloc: ansic: 170,465; sh: 10,446; perl: 4,105; lisp: 2,554; tcl: 2,469; makefile: 1,887; cpp: 587; csh: 148; awk: 140
file content (152 lines) | stat: -rw-r--r-- 6,330 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<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>select</H2>
<HR>
Select or unselect portions of the layout according to the options, or
create a new cell definition from a selection.
<HR>

<H3>Shortcuts:</H3>
   <BLOCKQUOTE>
      Key macro <B>,</B> (comma) implements the command <B>select clear</B>. <BR>
      Key macro <B>s</B> implements the command <B>select</B>. <BR>
      Key macro <B>S</B> implements the command <B>select more</B>. <BR>
      Key macro <I>Control-</I><B>S</B> implements the
		command <B>select less</B>. <BR>
      Key macro <B>a</B> implements the command <B>select visible</B>. <BR>
      Key macro <B>A</B> implements the command <B>select more visible</B>. <BR>
      Key macro <I>Control-</I><B>A</B> implements the
		command <B>select less visible</B>. <BR>
      Key macro <B>i</B> implements the command <B>select cell</B>. <BR>
      Key macro <B>I</B> implements the command <B>select more cell</B>. <BR>
      Key macro <I>Control-</I><B>I</B> implements the
		command <B>select less cell</B>.
   </BLOCKQUOTE>

<H3>Usage:</H3>
   <BLOCKQUOTE>
      <B>select</B> <I>option</I> <BR><BR>
      <BLOCKQUOTE>
         where <I>option</I> may be one of the following:
	 <DL>
	   <DT> [<B>more</B> | <B>less</B>] [<I>layers</I>]
	   <DD> [De]select material under cursor, or
		[de]select a subcell if the cursor is over space.
	   <DT>	<B>nocycle</B> [<I>layers</I>]
	   <DD> Select material without cycling through different tile
	   	types when "select" is called from the same cursor position
		more than once.
	   <DT>	[<B>more</B> | <B>less</B>] <B>area</B> [<I>layers</I>]
	   <DD> [De]select all material under box in layers <I>layers</I>
	   <DT>	[<B>more</B> | <B>less</B>] <B>visible</B> [<I>layers</I>]
	   <DD> [De]select all visible material under box in layers <I>layers</I>.
	   <DT>	[<B>more</B> | <B>less</B>] <B>box</B> [<I>layers</I>]
	   <DD> [De]select material specified by the boundary of the cursor box
	   <DT>	[<B>more</B> | <B>less</B>] <B>chunk</B> [<I>layers</I>]
	   <DD> [De]select a network chunk (largest rectangle) specified by
		the lower left corner of the cursor box
	   <DT>	[<B>more</B> | <B>less</B>] <B>region</B> [<I>layers</I>]
	   <DD> [De]select a network region specified by
		the lower left corner of the cursor box
	   <DT>	[<B>more</B> | <B>less</B>] <B>net</B> [<I>layers</I>]
	   <DD> [De]select an entire electrical network specified by
		the lower left corner of the cursor box
	   <DT>	[<B>more</B> | <B>less</B>] <B>cell</B> [<I>name</I>]
	   <DD> [De]select the cell under cursor, or the cell use (instance)
		named <I>name</I>.
	   <DT>	<B>top cell</B>
	   <DD> Select the topmost cell in the window, which does not have
		an instance name and therefore cannot be selected with the
		<B>select cell</B> command.
	   <DT>	<B>save</B> <I>cell</I>
	   <DD> Save selection as cell named <I>cell</I>, which is also
		saved to disk as <I>cell</I><TT>.mag</TT>.
	   <DT>	<B>clear</B>
	   <DD> Clear selection
	   <DT>	<B>pick</B>
	   <DD> Remove the selection from the layout, but retain the
	   	selection buffer for interactive processing.
	   <DT>	<B>keep</B>
	   <DD> Copy the selection from the layout into the selection
	   	buffer, and keep the selection buffer for interactive
		processing.
	   <DT>	<B>move</B> <I>x y</I>
	   <DD> Move the selection buffer to position <I>x y</I>,
	   	relative to the cell definition origin.
	   <DT>	<B>help</B>
	   <DD> Print help information
	 </DL>
      </BLOCKQUOTE>
   </BLOCKQUOTE>

<H3>Summary:</H3>
   <BLOCKQUOTE>
      The <B>select</B> command changes what material is in the current
      selection.  <B>magic</B> maintains a separate cell definition
      that represents the current selection.  Without the options
      <B>more</B> or <B>less</B>, the selection is cleared prior to
      executing the new selection command.  Otherwise, <B>more</B>
      adds to the existing selection and <B>less</B> subtracts from
      it. <P>

      Network selection differs from other types of selection in
      that <B>magic</B> uses a sophisticated algorithm to determine
      what is electrically connected together throughout the layout.
      A <B>chunk</B> is the largest rectangle containing a single
      layer type.  A <B>region</B> is the largest network area
      containing a single layer type.  The region stops where the
      net connects to a different layer type.  The <B>net</B> is
      the entire electrical network. <P>

      The <B>select save</B> options differs from the rest in that it
      does not alter the current selection, but creates a new cell
      definition from the current selection.  Note that this cell
      is created as a top-level cell, and does not replace the current
      selection as a use in the edit cell.  To do that requires
      "<B>select save</B> <I>cell</I>" followed by "<B>delete</B>"
      and "<B>getcell child 0 0 parent 0 0</B>".  The last command
      syntax is used because the bounds of the selection may differ
      from the cursor box.
   </BLOCKQUOTE>

<H3>Implementation Notes:</H3>
   <BLOCKQUOTE>
      <B>select</B> is implemented as a built-in command in <B>magic</B>.
      The <B>select keep</B>, <B>select move</B>, and <B>select pick</B>
      are interactive functions used by the "pick" tool.
   </BLOCKQUOTE>

<H3>Bugs:</H3>
   <BLOCKQUOTE>
      To be consistent, <B>select save</B> should be a separate command,
      since like other commands it operates on the selection rather than
      alter what is in the selection.
   </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 5:06pm <P>
</BODY>
</HTML>