hAPI

Tool Summary

General Purpose Information
Year of First Releaseⓘ The year a tool was first publicly released or discussed in an academic paper.	2018
Platformⓘ The OS or software framework needed to run the tool.	Java, C#
Availabilityⓘ If the tool can be obtained by the public.	Available
Licenseⓘ Tye type of license applied to the tool.	Open Source (GPL 3)

Hardware Control Information
Haptic Categoryⓘ The general types of haptic output devices controlled by the tool.	Force Feedback
Hardware Abstractionⓘ How broad the type of hardware support is for a tool. Bespoke: Hardware is custom built, including open hardware. Consumer: Support is limited to a specific commercial device or a family of devices. Class: Any device with the same affordances can be used, possibly with some configuration required.	Consumer (Haply 2DIY)

Interaction and Interface Information
Driving Featureⓘ If haptic content is controlled over time, by other actions, or both.	Action
Effect Localizationⓘ How the desired location of stimuli is mapped to the device. Device-centric: No spatial information is taken into acccount. Actuators are directly controlled. Target-centric: Stimuli are placed on the body or are assigned to a virtual object to be triggered through interaction. The tool handles how the device will display the effect. Location-aware: The desired location of an effect is taken into account to some extent, but is ultimately presented in context of the output device.	Location-aware
Media Supportⓘ Support for non-haptic media in the workspace, even if just to aid in manual synchronization.	None
Iterative Playbackⓘ If haptic effects can be played back from the tool to aid in the design process.	N/A
Design Approachesⓘ Broadly, the methods available to create a desired effect. Direct parametric control (DPC): low-level parameters are directly modifiable. Process: parameters are controllable by an abstract process. Sequencing: reusable effects are ordered in time to create complex effects. Library: a library of pre-existing effects is available for use or re-use. Description: a natural language description of the experience is used to find an appropriate effect, often through searching a library.	DPC
Interaction Metaphorsⓘ Common UI metaphors that define how a user interacts with a tool. Track: a timeline represents an interactive channel containing effects. Keyframe: key points of the effect are set and behavior between them is interpolated. Score: an adaptation of a musical score or notation represents haptic effects. Dataflow: a dataflow programming model is used to control haptic output. Demonstration: physical actions or other data are mapped simply to effects or parameters. Generic Menu: typical GUI elements (e.g., sliders) are used to control effects with the absence of other metaphors.	N/A

Additional Information

hAPI is a low-level API for controlling the Haply 2DIY device. In its basic form, it handles communication between the host and device and mapping between positions and forces within the device’s workspace and angles and torques used by the hardwware itself. hAPI can also be combined with physics engines such as Fisica for convenience.

For more information on hAPI, please consult the GitLab repository, the 2DIY development kit page, and the hAPI/Fisica repository.