DOCS: How to use processors #2171

ritamerkl · 2025-04-23T15:02:53Z

Description

This adds more documentation on how to use processors.

Testing status & QA

No testing

Overall Product Risks

Complexity: low
Halo Effect: low

Comments to reviewers

Checklist

Before review:

Changelog entry added.
- Explains the change in Changed, Fixed, Added sections.
- For API change contains an example snippet and/or migration example.
- JIRA ticket linked, example (case %%). If it is a private issue, just add the case ID without a link.
- Jira port for the next release set as "Resolved".
Tests added/changed, if applicable.
- Functional tests Area_CanDoX, Area_CanDoX_EvenIfYIsTheCase, Area_WhenIDoX_AndYHappens_ThisIsTheResult.
- Performance tests.
- Integration tests.
Docs for new/changed API's.
- Xmldoc cross references are set correctly.
- Added explanation how the API works.
- Usage code examples added.
- The manual is updated, if needed.

During merge:

Commit message for squash-merge is prefixed with one of the list:
- NEW: ___.
- FIX: ___.
- DOCS: ___.
- CHANGE: ___.
- RELEASE: 1.1.0-preview.3.

After merge:

Create forward/backward port if needed. If you are blocked from creating a forward port now please add a task to ISX-1444.

…es/InputSystem into docs-processors

lilisha-unity

I did my first pass on the PR. Please fix the note formatting and replace the placeholder image alt text with something more descriptive. Also, there are quite a few sentences written in passive voice—please rewrite them in active voice where appropriate. You can refer to the Unity style guide for reference: https://docs-style-guide.unity.com/style/use-active-voice.

Packages/com.unity.inputsystem/Documentation~/HowToApplyProcessors.md

Packages/com.unity.inputsystem/Documentation~/ProcessorTypes.md

Packages/com.unity.inputsystem/Documentation~/HowToApplyProcessors.md

Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

jfreire-unity · 2025-05-15T07:55:55Z

Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

+
+![Here should be a picture of the Input Action Editor](./Images/Processors-Clamp-Editor.png)
+
+Note that the Bindings can contain input values with very different ranges. In that case, a Scale Processor on the Bindings can help preprocess the values before clamping them (Processors on Actions are applied after Processors on Bindings).


In that case, a Scale Processor on the Bindings can help preprocess the values before clamping them (Processors on Actions are applied after Processors on Bindings).

I think it would be good to have an example or expand an existing one to show examples of order of execution of processors. Always better to have an example than saying it in words IMO.

Do you have a specific example in mind?

…sors.md Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

…sors.md Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

codecov-github-com · 2025-05-27T17:33:31Z

Codecov Report

All modified and coverable lines are covered by tests ✅

@@           Coverage Diff            @@
##           develop    #2171   +/-   ##
========================================
  Coverage    65.44%   65.44%           
========================================
  Files          367      367           
  Lines        53505    53505           
========================================
  Hits         35019    35019           
  Misses       18486    18486

Flag	Coverage Δ
linux_2021.3_project	`70.41% <ø> (ø)`
linux_2022.3_project	`65.27% <ø> (ø)`
linux_6000.0_project	`65.34% <ø> (ø)`
linux_6000.1_project	`65.34% <ø> (ø)`
linux_trunk_project	`65.34% <ø> (-0.02%)`	⬇️
mac_2021.3_pkg	`5.41% <ø> (ø)`
mac_2021.3_project	`70.42% <ø> (ø)`
mac_2022.3_pkg	`5.19% <ø> (ø)`
mac_2022.3_project	`65.29% <ø> (ø)`
mac_6000.0_pkg	`5.20% <ø> (ø)`
mac_6000.0_project	`65.37% <ø> (ø)`
mac_6000.1_pkg	`5.20% <ø> (ø)`
mac_6000.1_project	`65.38% <ø> (+0.01%)`	⬆️
mac_trunk_pkg	`5.20% <ø> (ø)`
mac_trunk_project	`65.36% <ø> (ø)`
win_2021.3_pkg	`5.42% <ø> (ø)`
win_2021.3_project	`70.49% <ø> (ø)`
win_2022.3_pkg	`5.20% <ø> (ø)`
win_2022.3_project	`65.37% <ø> (ø)`
win_6000.0_pkg	`5.20% <ø> (ø)`
win_6000.0_project	`65.44% <ø> (+<0.01%)`	⬆️
win_6000.1_pkg	`5.20% <ø> (ø)`
win_6000.1_project	`65.45% <ø> (ø)`
win_trunk_pkg	`5.20% <ø> (ø)`
win_trunk_project	`65.44% <ø> (-0.01%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

lilisha-unity

Finished my review with some suggestions.

Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

…es/InputSystem into docs-processors

ritamerkl added 2 commits April 17, 2025 16:42

restructure processors documentation

55f2803

added scenarios for each processor

8472341

ritamerkl marked this pull request as draft April 23, 2025 15:05

ritamerkl added 6 commits April 25, 2025 17:32

uniforming scenarios & explanation and adding more details

1bfff7b

added pictures and code

db25dc2

refined scenarios and added pictures

5e9ee17

added example for clamp processor with picture

d37dcd5

replaced image for clamp processor

c824127

corrected grammar and spelling

32317b2

ritamerkl marked this pull request as ready for review April 29, 2025 13:32

Merge branch 'develop' into docs-processors

c365673

ritamerkl requested a review from jfreire-unity April 29, 2025 13:32

ritamerkl added 5 commits April 29, 2025 15:46

fixed formatting

1218ba0

Merge branch 'docs-processors' of https://github.com/Unity-Technologi…

bbea9d6

…es/InputSystem into docs-processors

updated file references to processors

3bc0a6e

fixed docs link

58a726e

Fixed Doc link

bc03750

LeoUnity requested a review from JonMUnity May 1, 2025 12:26

lilisha-unity requested changes May 9, 2025

View reviewed changes

jfreire-unity reviewed May 15, 2025

View reviewed changes

ritamerkl and others added 10 commits May 27, 2025 15:39

Update Packages/com.unity.inputsystem/Documentation~/HowToApplyProces…

0c8f1db

…sors.md Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/ProcessorTypes.md

518e2dc

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/ProcessorTypes.md

cda1e1d

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/HowToApplyProces…

bda4aba

…sors.md Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/HowToApplyProces…

80d8410

…sors.md Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

31b1c1e

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

4b22e08

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

45e2105

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

c1b6852

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

9dab870

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

ritamerkl and others added 14 commits May 27, 2025 15:41

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

f25ebc5

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

d2e51b1

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

06a2074

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

185ddae

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/ActionBindings.md

67be9c1

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

f50c2e6

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

deee7ff

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

bfa2d22

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

Update Packages/com.unity.inputsystem/Documentation~/UsingProcessors.md

75fb0e0

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

remove TOC for autogenerated TOC

72361ec

fixed alt text for normalize example

8f5bf2c

fixed clamp picture alt text

834e2c4

reworked alt text for images

8988c27

Merge branch 'develop' into docs-processors

9393fbc

lilisha-unity approved these changes May 28, 2025

View reviewed changes

ritamerkl and others added 6 commits May 28, 2025 18:13

added formatting to Notes

801884f

Apply suggestions from code review

542f977

Co-authored-by: lilisha-unity <94024889+lilisha-unity@users.noreply.github.com>

fixed note comment

58d212b

Merge branch 'docs-processors' of https://github.com/Unity-Technologi…

c90e7fb

…es/InputSystem into docs-processors

change to active language

cf18c91

fix formatting

3e09334


		![Here should be a picture of the Input Action Editor](./Images/Processors-Clamp-Editor.png)

		Note that the Bindings can contain input values with very different ranges. In that case, a Scale Processor on the Bindings can help preprocess the values before clamping them (Processors on Actions are applied after Processors on Bindings).

DOCS: How to use processors #2171

Are you sure you want to change the base?

DOCS: How to use processors #2171

Uh oh!

Conversation

ritamerkl commented Apr 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Testing status & QA

Overall Product Risks

Comments to reviewers

Checklist

Uh oh!

lilisha-unity left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jfreire-unity May 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ritamerkl May 28, 2025

Choose a reason for hiding this comment

Uh oh!

codecov-github-com bot commented May 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

lilisha-unity left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pFad - (p)hone/(F)rame/(a)nonymizer/(d)eclutterfier! Saves Data!

ritamerkl commented Apr 23, 2025 •

edited

Loading

jfreire-unity May 15, 2025 •

edited

Loading

codecov-github-com bot commented May 27, 2025 •

edited

Loading