Add an alternative shortcut for creating a pattern variant

Closes #84.

Author: YuriSizov

docs/src/arrangements.md

@@ -36,6 +36,10 @@ _Bosca Ceoil Blue_ automatically keeps track of every bar that you fill with pat
 
 To add a pattern to the arrangement, drag and drop it from the pattern dock, or <kbd>Left Click</kbd> and drag one of the existing patterns on the grid onto another cell, making a copy. Hold <kbd>Alt</kbd> as you do this, and instead of a copy a new variant of the original pattern will be created. You can also simply <kbd>Alt + Left Click</kbd> on a pattern to turn it into a variant.
 
+<p class="warning">
+If your operating system intercepts <kbd>Alt + Left Click</kbd>, you can also create a variant by hovering over a pattern and pressing <kbd>Ctrl/Cmd + D</kbd>.
+</p>
+
 <kbd>Right Click</kbd> removes the clicked pattern from the grid. This doesn't delete the pattern, however, and you can still use it later.
 
 ![](/images/arrangements-patterns.png)

docs/src/shortcuts.md

@@ -89,14 +89,14 @@ Shortcuts related to creating pattern arrangements.
 
 ### Arrangement building
 
-Drag'n'drop patterns from the dock on the right to add them to the grid.
-
-Drag'n'drop patterns on the grid to copy them to a different bar. Hold <kbd>Alt</kbd> while dragging to create a variant instead!
+Drag'n'drop patterns from the dock on the right to add them to the grid. Drag'n'drop patterns on the grid to copy them to a different bar.
 
 | Combination  | Description  |
 |--------------|--------------|
 | <kbd>Right Click</kbd>         | Remove the clicked pattern  |
-| <kbd>Alt + Left Click</kbd>    | Replace the clicked pattern with a new variant  |
+| <kbd>Ctrl/Cmd + D</kbd>        | Replace the pattern at the cursor with a new variant  |
+
+Or hold <kbd>Alt</kbd> while dragging/clicking on the grid to create a pattern variant!
 
 
 ## Timeline

gui/views/pattern_map/PatternMap.gd

@@ -129,6 +129,7 @@ func _gui_input(event: InputEvent) -> void:
 	if event is InputEventMouseButton:
 		var mb := event as InputEventMouseButton
 
+		# On mouse button press.
 		if mb.pressed:
 			if mb.button_index == MOUSE_BUTTON_WHEEL_UP:
 				if mb.shift_pressed:
@@ -153,6 +154,7 @@ func _gui_input(event: InputEvent) -> void:
 			elif mb.button_index == MOUSE_BUTTON_RIGHT:
 				_clear_pattern_at_cursor()
 
+		# On mouse button release.
 		else:
 			if mb.button_index == MOUSE_BUTTON_LEFT && mb.alt_pressed:
 				_clone_pattern_at_cursor()
@@ -168,6 +170,9 @@ func _shortcut_input(event: InputEvent) -> void:
 	elif event.is_action_pressed("bosca_patternmap_scale_smaller", true, true):
 		_resize_pattern_width(-1)
 		get_viewport().set_input_as_handled()
+	elif event.is_action_pressed("bosca_patternmap_duplicate", false, true):
+		_clone_pattern_at_cursor()
+		get_viewport().set_input_as_handled()
 
 
 func _physics_process(_delta: float) -> void:

gui/widgets/popups/ShortcutHelpPopup.tscn

@@ -390,28 +390,31 @@ size_flags_horizontal = 0
 theme_type_variation = &"CreditsLabel"
 text = "DRAG'N'DROP patterns on grid to copy them."
 
-[node name="Label2" type="Label" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="1"]
-auto_translate_mode = 1
-layout_mode = 2
-size_flags_horizontal = 0
-theme_type_variation = &"CreditsLabel"
-text = "Hold ALT while dragging to create a variant instead!"
-
-[node name="Spacer" type="Control" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="2"]
+[node name="Spacer" type="Control" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="1"]
 custom_minimum_size = Vector2(0, 12)
 layout_mode = 2
 
-[node name="ShortcutLine3" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="3" instance=ExtResource("2_1wrnf")]
+[node name="ShortcutLine3" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="2" instance=ExtResource("2_1wrnf")]
 layout_mode = 2
 key_text = "RIGHT CLICK"
 key_is_action = false
 description_text = "Remove the pattern"
 
-[node name="ShortcutLine4" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="4" instance=ExtResource("2_1wrnf")]
+[node name="ShortcutLine4" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="3" instance=ExtResource("2_1wrnf")]
 layout_mode = 2
-key_text = "ALT + LEFT CLICK"
-key_is_action = false
-description_text = "Create pattern variant"
+key_text = "bosca_patternmap_duplicate"
+description_text = "Create a pattern variant"
+
+[node name="Spacer2" type="Control" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="4"]
+custom_minimum_size = Vector2(0, 6)
+layout_mode = 2
+
+[node name="Label2" type="Label" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3/ArrangementBuildingList" index="5"]
+auto_translate_mode = 1
+layout_mode = 2
+size_flags_horizontal = 0
+theme_type_variation = &"CreditsLabel"
+text = "Or hold ALT while dragging/clicking to create a variant!"
 
 [node name="LastSpacer" type="Control" parent="Layout/Content/ContentBox/ScrollContainer/MarginContainer/Layout/Section3" index="6"]
 custom_minimum_size = Vector2(0, 16)

project.godot

@@ -139,6 +139,11 @@ bosca_patternmap_scale_smaller={
 , Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"command_or_control_autoremap":true,"alt_pressed":false,"shift_pressed":false,"pressed":false,"keycode":4194435,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
 ]
 }
+bosca_patternmap_duplicate={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"command_or_control_autoremap":true,"alt_pressed":false,"shift_pressed":false,"pressed":false,"keycode":68,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
 bosca_debug_1={
 "deadzone": 0.5,
 "events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"command_or_control_autoremap":true,"alt_pressed":false,"shift_pressed":false,"pressed":false,"keycode":4194332,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)