Skip to content

Commit 599a3ab

Browse files
committed
Update docs, changelog & manifest [0.2.0]
1 parent 3594f6d commit 599a3ab

File tree

4 files changed

+33
-8
lines changed

4 files changed

+33
-8
lines changed

CHANGELOG.md

+11-1
Original file line numberDiff line numberDiff line change
@@ -4,5 +4,15 @@ All notable changes to this project will be documented in this file.
44
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
55
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
66

7-
## [Unreleased]
7+
## [0.2.0]
88
### Added
9+
- 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).
10+
- Adds HPUI Interactor and related logic implementations
11+
- Adds HPUI Interactables
12+
- `HPUIBaseInteractable` - desrete targets
13+
- `HPUIGeneratedContinuousInteractable` - deformable continuous interactable which can be generated at runtime
14+
- `HPUIMeshContinuousInteractable` - deformable continuous interactable that uses existing skinned mesh renderer.
15+
- Adds `JointFollower` and related components to hook into XR Hands
16+
- Adds simple UI components built on HPUI
17+
- `HPUIInteractorLRVisual` - Use a linerender as a cursor showing where the interactor thinks the interaction is gooing to happe.
18+
- `HPUIInteractorTransformVisual` - Positions a transform as a cursor showing where the interactor thinks the interaction is gooing to happe.

Documentation~/docs/usage.md

+15-4
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,27 @@
11
# Usage
22
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.
3+
The `Sample scene with HPUI` has an example with the HPUI components setup.
34

45
## Scene setup
56
- 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)).
6-
- Place atleast one HPUIInteractor component. You may use the `HPUIInteractable` prefab that is provided with the package.
7-
- Create intractables with the HPUI Interactables components added to them (i.e., `HPUIBaseInteractable` & `HPUIContinuousInteractable`).
7+
- Place atleast one HPUIInteractor component. You may use the `HPUIInteractor` prefab that is provided with the package.
8+
- Create intractables with the HPUI Interactables components added to them (i.e., `HPUIBaseInteractable`, `HPUIGeneratedContinuousInteractable`, & `HPUIMeshContinuousInteractable`).
89
- 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.
910

10-
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`.
11+
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`.
1112

1213
## Interactables
13-
TODO
14+
### `HPUIBaseInteractable`
15+
### `HPUIGeneratedContinuousInteractable`
16+
### `HPUIMeshContinuousInteractable`
17+
18+
## Interactors
19+
### `HPUIInteractor`
20+
#### Detection logic
21+
#### Gesture logic
22+
23+
## `JointFollower`
24+
1425

1526
# Usage of V1 (Legacy)
1627
The following is the documentation of the Legacy version of HPUI (the `Legacy` namespace) which did not use the XRI/XR-Hands.

Doxyfile

+1-1
Original file line numberDiff line numberDiff line change
@@ -917,7 +917,7 @@ WARN_LOGFILE =
917917
# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
918918
# Note: If this tag is empty the current directory is searched.
919919

920-
INPUT = "README.md" "Runtime" "Editor" "Tests" "Documentation~/docs/" "Documentation~/docs/"
920+
INPUT = "README.md" "Runtime" "Editor" "Tests" "Documentation~/docs/" "CHANGELOG.md"
921921

922922
# This tag can be used to specify the character encoding of the source files
923923
# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses

package.json

+6-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "ubc.ok.ovilab.hpui-core",
3-
"version": "0.2.0-pre",
3+
"version": "0.2.0",
44
"displayName": "HPUI Core",
55
"description": "Core functionality of HPUI",
66
"unity": "2021.3",
@@ -9,10 +9,14 @@
99
"com.unity.xr.interaction.toolkit": "3.0.4",
1010
"com.unity.textmeshpro": "3.0.6"
1111
},
12+
"license": "MIT",
13+
"licenseUrl": "https://github.com/ovi-lab/HPUI-Core/blob/master/LICENSE",
1214
"author": {
1315
"name": "Shariff Faleel",
14-
"email": "[email protected]"
16+
"email": "[email protected]",
17+
"url": "https://shariff-faleel.com"
1518
},
19+
"documentationUrl": "https://ovi-lab.github.io/HPUI-Core/",
1620
"scopedRegistries": [
1721
],
1822
"samples": [

0 commit comments

Comments
 (0)