Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 20 additions & 3 deletions Packages/com.unity.inputsystem/Documentation~/TableOfContents.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,22 +9,39 @@
* [Workflow - Direct](using-direct-workflow.md)
* [Setting up input](setting-up-input.md)
* [Actions](actions.md)
* [Action Assets](action-assets.md)
* [Action assets](action-assets.md)
* [About action assets](about-action-assets.md)
* [About project-wide actions](about-project-wide-actions.md)
* [Create and assign project-wide actions](create-project-wide-actions.md)
* [Create and assign a project-wide action asset](create-project-wide-actions.md)
* [Create an empty action asset](create-empty-action-asset.md)
* [Assign a project-wide action asset](assign-project-wide-actions.md)
* [Default actions](default-actions.md)
* [Generate C# API from actions](generate-cs-api-from-actions.md)
* [Create action maps](create-edit-delete-action-maps.md)
* [Create, edit and delete actions](create-edit-delete-actions.md)
* [Configure actions](configure-actions.md)
* [Action and control types](action-and-control-types.md)
* [About action and control types](about-action-control-types.md)
* [Configure action type](configure-action-type.md)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This might be a bit overkill for such a short section, but I think it's lacking a little overview explaining what action and control types are. I feel like an intro page might be useful here. I also wonder if both task pages could be combined somehow so you have something like:

  • Action and control types (potentially rename this to something more outcome based like, "Configure how actions are triggered" ?)
    • Action and control types overview (you can configure how actions are triggered with action types and control types...)
    • Configure action and control types (to set the types, open the window and do XYZ...)
    • Action and control types reference (Unsure if you need the reference here or if you have this somewhere else in an overarching window reference page)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

addressed in new changes

* [Action types reference](action-type-reference.md)
* [Configure control type](configure-control-type.md)
* [Bindings](bindings.md)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, "Bindings" is a feature based term - I'm trying to think of a good outcome-based name for this but I think it needs to be along the lines of "Configure what actions are performed." or "Connect actions to input" or similar.

These titles are absolutely terrible though and it might be better to brainstorm as a group - @siobhan-unity is usually better at these things than I am 😄

* [Introduction to bindings](introduction-to-bindings.md)
* [Binding types](binding-types.md)
* [Composite bindings](composite-bindings-reference.md)
* [Add, duplicate or delete a binding](add-duplicate-delete-binding.md)
* [Select a control for binding](select-control-binding.md)
* [Edit composite bindings](edit-composite-bindings.md)
* [Group bindings to control schemes](group-binding-to-control-scheme.md)
* [Binding resolution](binding-resolution.md)
* [Restrict binding to a specific device](restrict-binding-specific-device.md)
* [Binding conflicts](binding-conflicts.md)
* [Initial state checks](binding-initial-state-checks.md)
* [Stand-alone actions](stand-alone-actions.md)
* [Load actions from JSON](load-actions-from-json.md)
* [Create actions in code](create-actions-in-code.md)
* [Action properties](action-and-control-types.md)
* [Bindings](action-bindings.md)
* [Bindings](ActionBindings-Old-Content.md)
* [Controls](controls.md)
* [Controls schemes](control-schemes.md)
* [Interactions](interactions.md)
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# About action and control types

Each action has an **action type** and a **control type**. These settings are displayed in the [Action Properties panel](./action-properties-panel.md) when you select an action in the [Actions Editor window](./actions-editor.md).

![The Action Properties panel in the Actions Editor Window](Images/ActionProperties.png)

When you configure an action, you can select an action type and control type that best represents what your action is for, and how you want it to be activated by the [controls](./Controls.md) it is [bound](./bindings.md) to.

## Action type

The **action type** influences how the Input System processes state changes for the action, and relates to whether this action represents a discrete on/off button-style interaction or a value that can change gradually over time.

## Control type

The **control type** determines the type of value that should be sent to the action, such as an in integer or float value, or a 1D, 2D, or 3D axis.

The control type that you select has the effect of filtering the available controls to only those that are capable of providing the values appropriate for that control.

For example, if you select **2D axis** as the control type, only those types of controls that can supply a 2D vector as value are available as options for the binding control path, such as a thumb stick or Dpad.

There are more specific control types available which further filter the available bindings, such as **Stick**, **Dpad** or **Touch**. If you select one of these control types, the list of available controls is further limited to only those controls of those specific types when you [select a binding for your action](add-duplicate-delete-binding.md).

Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Action and control types




If you select an action in the actions pane of the [Actions Editor window](actions-editor.md), the right-hand pane displays the action-properties-panel.mdn-properties-panel.md) panel.

![Action Properties](Images/ActionProperties.png)
Actions have an **Action Type** and **Control Type** which you can configure in the [Actions Editor window](actions-editor.md). These settings allow you to configure the basic behaviour of an action.

| **Topic** | **Description** |
| :------------------------------ | :------------------------------- |
| **[Configure action type](./configure-action-type.md)** | Summary |
| **[Configure control type](./configure-control-type.md.md)** | Summary |
| **[About action and control types](./about-action-control-types.md)** | Learn about what action types and control types are, and the effects that the different settings can have. |
| **[Configure action type](./configure-action-type.md)** | Configure the action's Action Type, which relates to whether an action represents a discrete on/off button-style interaction or a value that can change gradually over time. |
| **[Action type reference](./action-type-reference.md)** | Information about each of the available action type options. |
| **[Configure control type](./configure-control-type.md.md)** | Select the type of control expected by the action. |

## Additional resources
[Control types reference](./control-types.md)
Loading