Back to Logisim Evolution

Edit Tool

src/main/resources/doc/en/html/libs/base/edit.html

4.1.03.6 KB
Original Source

Edit Tool

| Library: | Base | | Introduced: | 2.3.0 |

Behavior

The Edit tool allows the user to rearrange existing components and to add wires. Exactly what the tool does depends on where the user presses the mouse on the canvas.

  • When the mouse is over a wiring point for an existing component, or if it is atop a current wire, the Edit Tool will display a small green circle around the mouse's location. Pressing the button there initiates the addition of a new wire. But if the user doesn't drag the mouse far enough to initiate a wire before releasing the button, the press is treated as a mouse click, and so the wire is simply added into the current selection.

  • If, however, the user presses the Alt key at a point in the middle of the wire, then the green circle will disappear. A mouse press selects the wire, and a mouse drag moves it.

  • Pressing the mouse button while it is within a currently selected component begins a drag moving all elements of the selection.

  • Pressing the mouse within an unselected component (but not at one of the component's wiring points) drops all components from the current selection and selects instead the component(s) containing the clicked location.

  • Shift-clicking the mouse within a component toggles that component's presence within the selection. If multiple components include the same location, all components' presence will be toggled.

  • Dragging the mouse starting at a location not contained within any components drops all components from the current selection and initiates a rectangular selection. All component(s) contained by the rectangle will be placed into the selection.

  • Shift-dragging the mouse starting at a location not contained within any components initiates a rectangular selection. The presence in the selection of all component(s) contained by the rectangle will be toggled.

  • However, if the Alt key is pressed at a location not contained within any components, this initiates the addition of a new wire. A small green circle is drawn in such a circumstance to indicate this.

After selecting the desired items in the selection, you can of course cut/copy/paste/delete/duplicate all the items via the Edit menu.

Some keys have an effect with the Edit Tool.

  • The arrow keys change the Facing attribute for all components in the selection that have such an attribute.

  • The Delete and Backspace keys will delete everything in the selection from the circuit.

  • The Insert and MenuKey-D keys will create a duplicate of the currently selected components.

Logisim's behavior when duplicating a selection or pasting the clipboard into a circuit is somewhat peculiar: It will not immediately place the components into the circuit; instead, the selection will be a collection of "ghosts," which will be dropped into the circuit as soon as they are either dragged to another location or removed from the selection. (This peculiar behavior is necessary because pasting will otherwise merge the wires of the selection into the current circuit at once, and the wires there previously will be dragged with the pasted clipboard if the user wants to move the pasted components somewhere else.)

Attributes

None. Selecting a component, though, will display its attributes. With multiple components selected, attributes shared by all are shown, blank if they have different values and otherwise with the value they all have in common. (Wires are ignored if there are any non-wires in the selection.) Changes to the attribute value affect all selected components.

Back to Library Reference