The Visuo-haptic Illusions Toolkit

This toolkit is a an open-source plugin for the Unity game engine. It aims to promote the use of visuo-haptic illusions in the industry (e.g. video games) and in academia by implementing popular visuo-haptic techniques and a simple architecture to create new ones. It also provides low-code tools to debug, log, and visualize the effects of each technique.

Getting Started

This video (to come) explains the basic concepts of visuo-haptic illusions and this toolkit.

You will find

• tutorials and details about the different modules in the Wiki,
• an overview of the tookit in the scientific paper (to come),
• C# classes and their documentation in the autogenerated docs,
• the source code on GitHub.

List of Implemented Techniques

Body Redirection

• Azmandian et al., 2016, Body Warping
• Azmandian et al., 2016, Hybrid Warping
• Han et al., 2019, Translational Shift
• Han et al., 2019, Interpolated Reach
• Cheng et al., 2017, Sparse Haptics
• Geslain et al., 2022, 2^nd order polynomials
• Poupyrev et al., 1996, The Go-Go

World Redirection

• Razzaque et al., 2001, Over Time Rotation
• Razzaque et al., 2001, Rotational
• Razzaque et al., 2001, Curvature
• Razzaque et al., 2001, Redirected Walking Hybrid
• Azmandian et al., 2016, World Warping
• Williams et al., 2006, Translational

Pseudo-Haptic

• Lécuyer et al., 2000, Swamp Illusion
• Lécuyer et al., 2000, Spring stiffness
• Samad et al., 2019, Pseudo-haptic weight
• Rietzler et al., 2018, Breaking the tracking, weight

Steering Strategies

• Langbehn and Steinicke, 2013, Steer To Center
• Langbehn and Steinicke, 2013, Steer To Orbit
• Langbehn and Steinicke, 2013, Steer To Targets
• Langbehn and Steinicke, 2013, Steer To Targets + Center
• Thomas and Rosenberg, 2019, APF P2R
• Thomas et al., 2022, Inverse Kinematics (WIP)

Not Yet Implemented (Roadmap)

World Redirection

• Abtahi and Follmer, 2019, World-in-miniature

Interpolation

• Kohli et al., 2010, Redirected Touching
• Zhao et Follmer et al., 2018, Complex Boundaries

Pseudo-Haptic

• Gomez Jauregui et al., 2014, Avatar Weight
• Argelaguet et al., 2013, Deformable materials
• Kasahara et al., 2017, Malleable Embodiement

Reporting Issues

Bug reports and feature requests are very welcome at the GitHub Issues page.

Contributing

All contributions are welcome. Please find more details on the wiki.

Main contributors:

• Benoît Geslain (benoi.nosp@m.tges.nosp@m.lain@.nosp@m.gmai.nosp@m.l.com, https://github.com/BenoitGeslain)
• Bruno Jartoux (bruno.nosp@m..jar.nosp@m.toux@.nosp@m.sii..nosp@m.fr, https://github.com/bjrtx)
• Other Contributors:
• Maxence Theriot (https://github.com/Ldeeprenard)
• Théo Machon (https://github.com/TMachon)

Reference

TODO

Copyright and Licensing

Copyright (c) 2023-2024 SII Société pour l’Informatique Industrielle

This project is licensed under the open-source MIT X11 license, see the LICENSE file. In particular, you may not distribute any copy or substantial portion of this project without the contents of the LICENSE file.