Skip to content

Commit

Permalink
Update docs, changelog & manifest [0.2.0]
Browse files Browse the repository at this point in the history
  • Loading branch information
ahmed-shariff committed Sep 29, 2024
1 parent 3594f6d commit 599a3ab
Show file tree
Hide file tree
Showing 4 changed files with 33 additions and 8 deletions.
12 changes: 11 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,15 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]
## [0.2.0]
### Added
- Complete refactor to use [XRI](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) and [XR Hands](https://docs.unity3d.com/Packages/[email protected]/manual/index.html).
- Adds HPUI Interactor and related logic implementations
- Adds HPUI Interactables
- `HPUIBaseInteractable` - desrete targets
- `HPUIGeneratedContinuousInteractable` - deformable continuous interactable which can be generated at runtime
- `HPUIMeshContinuousInteractable` - deformable continuous interactable that uses existing skinned mesh renderer.
- Adds `JointFollower` and related components to hook into XR Hands
- Adds simple UI components built on HPUI
- `HPUIInteractorLRVisual` - Use a linerender as a cursor showing where the interactor thinks the interaction is gooing to happe.
- `HPUIInteractorTransformVisual` - Positions a transform as a cursor showing where the interactor thinks the interaction is gooing to happe.
19 changes: 15 additions & 4 deletions Documentation~/docs/usage.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,27 @@
# Usage
This can be imported as a git package in Unity. The package is built to use [Unity XRHands](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) and [Unity XR Interaction Toolkit](https://docs.unity3d.com/Packages/[email protected]/manual/index.html). Hence, it is interoperable with any package that implements the Unity XRHands.
The `Sample scene with HPUI` has an example with the HPUI components setup.

## Scene setup
- Setup the Scene with an XR Origin & XR Interaction Manager (see documentation [XRI documentation for more details](https://docs.unity3d.com/Packages/[email protected]/manual/general-setup.html#create-the-xr-origin-camera-rig-for-tracked-devices)).
- Place atleast one HPUIInteractor component. You may use the `HPUIInteractable` prefab that is provided with the package.
- Create intractables with the HPUI Interactables components added to them (i.e., `HPUIBaseInteractable` & `HPUIContinuousInteractable`).
- Place atleast one HPUIInteractor component. You may use the `HPUIInteractor` prefab that is provided with the package.
- Create intractables with the HPUI Interactables components added to them (i.e., `HPUIBaseInteractable`, `HPUIGeneratedContinuousInteractable`, & `HPUIMeshContinuousInteractable`).
- Add and configure the `JointFollower` component to all gameobjects with HPUI Interactables or HPUI Interactor. This component makes sure the game objects location is set to the respective joint(s) of a given hand. The Interactor and Interactables don't depend on these, but they play nice with each other - i.e., the HPUI Interactables and HPUI Interactors will respect the configuration (Handedness) of the JointFollower.

Note that, the HPUI interactor/interactables do not have to be under the `XROrigin` even though the data from the XRHands subsystem is relative to the `XROrigin`. `JointFollower` transforms the location so that its not necessay for the components to be under the `XROrigin`.
Note that, the HPUI interactables do not have to be under the `XROrigin` even though the data from the XRHands subsystem is relative to the `XROrigin`. `JointFollower` transforms the location so that its not necessay for the components to be under the `XROrigin`.

## Interactables
TODO
### `HPUIBaseInteractable`
### `HPUIGeneratedContinuousInteractable`
### `HPUIMeshContinuousInteractable`

## Interactors
### `HPUIInteractor`
#### Detection logic
#### Gesture logic

## `JointFollower`


# Usage of V1 (Legacy)
The following is the documentation of the Legacy version of HPUI (the `Legacy` namespace) which did not use the XRI/XR-Hands.
Expand Down
2 changes: 1 addition & 1 deletion Doxyfile
Original file line number Diff line number Diff line change
Expand Up @@ -917,7 +917,7 @@ WARN_LOGFILE =
# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
# Note: If this tag is empty the current directory is searched.

INPUT = "README.md" "Runtime" "Editor" "Tests" "Documentation~/docs/" "Documentation~/docs/"
INPUT = "README.md" "Runtime" "Editor" "Tests" "Documentation~/docs/" "CHANGELOG.md"

# This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
Expand Down
8 changes: 6 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "ubc.ok.ovilab.hpui-core",
"version": "0.2.0-pre",
"version": "0.2.0",
"displayName": "HPUI Core",
"description": "Core functionality of HPUI",
"unity": "2021.3",
Expand All @@ -9,10 +9,14 @@
"com.unity.xr.interaction.toolkit": "3.0.4",
"com.unity.textmeshpro": "3.0.6"
},
"license": "MIT",
"licenseUrl": "https://github.com/ovi-lab/HPUI-Core/blob/master/LICENSE",
"author": {
"name": "Shariff Faleel",
"email": "[email protected]"
"email": "[email protected]",
"url": "https://shariff-faleel.com"
},
"documentationUrl": "https://ovi-lab.github.io/HPUI-Core/",
"scopedRegistries": [
],
"samples": [
Expand Down

0 comments on commit 599a3ab

Please sign in to comment.