PkR at 07:51, 3 October 2025

2025-10-03T07:51:59Z

← Older revision		Revision as of 07:51, 3 October 2025
Line 28:		Line 28:

	For a complete list of actions and hotkeys, open Editor Preferences and click the Control Options tab.		For a complete list of actions and hotkeys, open Editor Preferences and click the Control Options tab.


	== Configuring Controls ==		== Configuring Controls ==

	You can customize all actions that have configurable hotkeys. Each action can have a main key, an alternative key and a modifier. If a modifier doesn't exist, the action will trigger when you press the main key or the alternative key. If a modifier exists, the action will only trigger when both the modifier and the main or alternative key are pressed. To change keys, select the action you want to modify, click on the field for the key you would like to change and press the key you want to assign.		You can customize all actions that have configurable hotkeys. Each action can have a main key, an alternative key and a modifier. If a modifier doesn't exist, the action will trigger when you press the main key or the alternative key. If a modifier exists, the action will only trigger when both the modifier and the main or alternative key are pressed. To change keys, select the action you want to modify, click on the field for the key you would like to change and press the key you want to assign.
	![~~https~~:~~//user-images.githubusercontent.com/23312549/~~107621390-84dffd00-6c99-11eb-9a84-643875ea618b.png ~~image~~]
			[[File:107621390-84dffd00-6c99-11eb-9a84-643875ea618b.png]]

	== Camera Modifier Setting ==		== Camera Modifier Setting ==

	Older versions of 3D editors in SA Tools used a "tethered" control scheme, where all camera controls required a "main" camera key to be held. To use this scheme, select the "main" camera action for the Camera Modifier setting, and then set the "main" key as the modifier for other camera actions. For example, if you want Zoom and Look actions to depend on the key used for the Move action, set the Camera Move key as the modifier for Camera Zoom and Camera Look, and set Camera Modifier to Move.		Older versions of 3D editors in SA Tools used a "tethered" control scheme, where all camera controls required a "main" camera key to be held. To use this scheme, select the "main" camera action for the Camera Modifier setting, and then set the "main" key as the modifier for other camera actions. For example, if you want Zoom and Look actions to depend on the key used for the Move action, set the Camera Move key as the modifier for Camera Zoom and Camera Look, and set Camera Modifier to Move.


	''Example based on the old control scheme for SA Tools''		''Example based on the old control scheme for SA Tools''

	Camera Move: Main Key is <code>Middle Mouse Button</code>, Alternative Key and Modifier are disabled.		Camera Move: Main Key is <code>Middle Mouse Button</code>, Alternative Key and Modifier are disabled.


	Camera Look: Main Key is <code>Shift</code> (<code>Menu / Alt</code> in older versions), Modifier is <code>Middle Mouse Button</code>.		Camera Look: Main Key is <code>Shift</code> (<code>Menu / Alt</code> in older versions), Modifier is <code>Middle Mouse Button</code>.


	Camera Zoom: Main Key is <code>Control</code>, Modifier is <code>Middle Mouse Button</code>.		Camera Zoom: Main Key is <code>Control</code>, Modifier is <code>Middle Mouse Button</code>.

PkR: Created page with "This page lists default camera controls for 3D editors in SA Tools, as well as instructions on how to change them. == Basic Camera Movement == '''Camera Look'''. Hold the `Middle Mouse Button` and move the mouse cursor to look around (camera pan/rotation). '''Camera Move'''. Hold `Shift + Middle Mouse Button` and move the mouse cursor to move camera position. '''Camera Zoom'''. Hold `CTRL + Middle Mouse Button` and move the mouse cu..."

2025-10-03T07:50:41Z

Created page with "This page lists default camera controls for 3D editors in SA Tools, as well as instructions on how to change them. == Basic Camera Movement == '''Camera Look'''. Hold the <code>Middle Mouse Button</code> and move the mouse cursor to look around (camera pan/rotation). '''Camera Move'''. Hold <code>Shift + Middle Mouse Button</code> and move the mouse cursor to move camera position. '''Camera Zoom'''. Hold <code>CTRL + Middle Mouse Button</code> and move the mouse cu..."

New page

This page lists default camera controls for 3D editors in SA Tools, as well as instructions on how to change them.

== Basic Camera Movement ==

'''Camera Look'''. Hold the <code>Middle Mouse Button</code> and move the mouse cursor to look around (camera pan/rotation).

'''Camera Move'''. Hold <code>Shift + Middle Mouse Button</code> and move the mouse cursor to move camera position.

'''Camera Zoom'''. Hold <code>CTRL + Middle Mouse Button</code> and move the mouse cursor vertically to zoom in and out.

== Camera Adjustments ==

'''Change Camera Mode'''. Press <code>X</code> to alternate between Normal and Orbit camera modes.

'''Change Camera Speed'''. Press <code>Numpad +</code> and <code>Numpad -</code> to increase or decrease camera speed. Press <code>Numpad 5</code> to reset camera speed to default.

'''Reset Camera Position'''. Press <code>E</code> to set camera position to X 0, Y 0, Z 0.

'''Reset Camera Rotation'''. Press <code>R</code> to reset camera rotation to default.

'''Zoom to Target'''. Press <code>Z</code> to zoom the camera onto the selected object.

== Other Actions ==

'''Change Render Mode'''. Press <code>N</code> or <code>F3</code> to switch between normal, vertex only and wireframe renreding modes.

'''Delete'''. Press <code>Delete</code> to delete selected items.

For a complete list of actions and hotkeys, open Editor Preferences and click the Control Options tab.

== Configuring Controls ==

You can customize all actions that have configurable hotkeys. Each action can have a main key, an alternative key and a modifier. If a modifier doesn't exist, the action will trigger when you press the main key or the alternative key. If a modifier exists, the action will only trigger when both the modifier and the main or alternative key are pressed. To change keys, select the action you want to modify, click on the field for the key you would like to change and press the key you want to assign.
![https://user-images.githubusercontent.com/23312549/107621390-84dffd00-6c99-11eb-9a84-643875ea618b.png image]

== Camera Modifier Setting ==

Older versions of 3D editors in SA Tools used a "tethered" control scheme, where all camera controls required a "main" camera key to be held. To use this scheme, select the "main" camera action for the Camera Modifier setting, and then set the "main" key as the modifier for other camera actions. For example, if you want Zoom and Look actions to depend on the key used for the Move action, set the Camera Move key as the modifier for Camera Zoom and Camera Look, and set Camera Modifier to Move.

''Example based on the old control scheme for SA Tools''

Camera Move: Main Key is <code>Middle Mouse Button</code>, Alternative Key and Modifier are disabled.

Camera Look: Main Key is <code>Shift</code> (<code>Menu / Alt</code> in older versions), Modifier is <code>Middle Mouse Button</code>.

Camera Zoom: Main Key is <code>Control</code>, Modifier is <code>Middle Mouse Button</code>.

== Developer Notes ==
The text below was copied as-is from the previous version of this page.

For those who want to contribute code to the toolkit, especially those who want to use the keybinding system in new editors or update the existing editors, we will now cover the input system from a technical implementation perspective.

=== Action Mapping List ===
[https://github.com/sonicretro/sa_tools/blob/master/SAEditorCommon/UI/ActionMappingList.cs ActionMappingList] is responsible for storing a list of action to input mappings. In addition to being able to instantiate an empty new list and construct an arbitrary one via the <code>ActionKeyMappings<> List</code>, it can serialize and deserialize action mappings to disk.

=== Action Input Collector ===
The [https://github.com/sonicretro/sa_tools/blob/master/SAEditorCommon/UI/ActionInputCollector.cs ActionInputCollector] is an event-emitting system that you can subscribe to whenever you'd like to know when actions have changed state. To be notified when an Action has either started or released, subscribe to the OnActionStart and OnActionRelease events respectively.

=== Driving The Input Collector ===
Due to architectural limitations, the input collection does not automatically hook into the editor inputs. Therefore you will need to feed the input collector yourself. To do so, call the '''KeyDown''' and '''KeyUp''' methods whenever you'd like to register a key press or clear event.

3D Editor Controls - Revision history

PkR at 07:51, 3 October 2025