Magic-7.3 Command Reference

#

## tool

Change layout tool or print info about what the button bindings are for the current tool

### Shortcuts:

> Key macro space implements the command tool.
> Key macro shift-space implements the command tool box.

### Usage:

> tool [name|info]

> > where name may be one of box, wiring, or netlist.

### Summary:

> The tool command selects or queries the mode of operation of the mouse buttons in the layout window. Each tool type has a unique set of button bindings.

> Without arguments, the tool command selects the next tool type in round-robin fashion. With a tool type as argument, the button bindings switch to those for the indicated tool. With the info option, a summary of the mouse buttons is given for the current tool.

> The mouse bindings for each of the three tools is as follows:

> - Box Tool
>   left
>     Move the box so its lower-left corner is at cursor position
>   right
>     Resize box by moving upper-right corner to cursor position
>   middle
>     Paint box area with material underneath cursor
>   In addition, you can move or resize the box by different corners by pressing left or right, holding it down, moving the cursor near a different corner and clicking the other (left or right) button down then up without releasing the initial button.
> - Wiring Tool
>   left
>     Pick a wiring layer and width (same as "wire type")
>   right
>     Add a leg to the wire (same as "wire leg")
>   middle
>     Place a contact to switch layers (same as "wire switch")
> - Netlist Tool
>   left
>     Select the net containing the terminal nearest the cursor
>   right
>     Toggle the terminal nearest the cursor into/out of current net
>   middle
>     Join current net and net containing terminal nearest the cursor

### Implementation Notes:

> tool is implemented as a built-in command in magic. Note that in the non-Tcl version of magic, there is an rsim tool type to aid in querying the simulation state of the layout; because IRSIM is integrated into the command-line functions in the Tcl version of magic, this tool type is no longer provided.

> As of magic 7.3, revision 60, the "tool" command's only function in the Tcl version of magic is to set the cursor style in the window. The button callback functions are nonfunctional, as they are handled by macros, and the macros are re-bound to implement each "tool".

### See Also:

> changetool

Return to command index

Last updated: October, 2004