Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fki-htw/vrsketchinggeometry
Unity package for sketching in Virtual Reality using geometry based objects.
https://github.com/fki-htw/vrsketchinggeometry
centis htw-berlin package sketching unity virtual-reality
Last synced: about 13 hours ago
JSON representation
Unity package for sketching in Virtual Reality using geometry based objects.
- Host: GitHub
- URL: https://github.com/fki-htw/vrsketchinggeometry
- Owner: FKI-HTW
- License: mit
- Created: 2023-04-27T14:07:58.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-05T12:46:38.000Z (7 months ago)
- Last Synced: 2024-07-09T17:48:03.824Z (7 months ago)
- Topics: centis, htw-berlin, package, sketching, unity, virtual-reality
- Language: C#
- Homepage:
- Size: 1.54 MB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VR Sketching Geometry
Work in progress. Features may not be complete and the API may change.
This is a framework for developing 3D sketching applications in Unity.
## Features:
- smoothly interpolated lines
- patch surfaces
- ribbon shaped lines
- organisation of sketch objects with groups
- undo and redo
- serialization of sketches
- OBJ export of sketches
## Installation
### Manually from a local folder
- open the Package Manager
- click on "+"
- choose "Add package from disk..."
- locate the downloaded package
- select the package.json file within the package
### Automatically from URL
- open the Package Manager
- click on "+"
- choose "Add package from git URL..."
- enter the URL
```
https://github.com/hunsri/VRSketchingGeometryUP.git#0.1.0
```
## Import the examples
- open the Package Manager
- locate the installed package
- click on "Samples"
- click on "Import"
- files will be imported under `Assets/Samples/`
## API documentation
Read the **developer guide** and **API documentation** at the GitHub pages site.
Alternatively, you can host these yourself too,
check out the [Docs Reference](../../Docs.md) for further details!
## Quick start
The following example script shows how to create a new line sketch object and add few control points to it using a command invoker.
At the end one command is undone.
You will have to reference a `DefaultReference` Scriptable Object in the inspector.
An example can be found under `SharedAssets/Assets/DefaultReferences.asset`.
To access `SharedAssets` you have to import it in the Package Manager (see [Import the examples](./README.md#import-the-examples))
```C#
using UnityEngine;
using VRSketchingGeometry.SketchObjectManagement;
using VRSketchingGeometry;
using VRSketchingGeometry.Commands;
using VRSketchingGeometry.Commands.Line;
public class CreateLineSketchObject : MonoBehaviour
{
public DefaultReferences Defaults;
private LineSketchObject LineSketchObject;
private SketchWorld SketchWorld;
private CommandInvoker Invoker;
void Start()
{
SketchWorld = Instantiate(Defaults.SketchWorldPrefab).GetComponent();
LineSketchObject = Instantiate(Defaults.LineSketchObjectPrefab).GetComponent();
Invoker = new CommandInvoker();
Invoker.ExecuteCommand(new AddObjectToSketchWorldRootCommand(LineSketchObject, SketchWorld));
Invoker.ExecuteCommand(new AddControlPointCommand(this.LineSketchObject, new Vector3(1, 2, 3)));
Invoker.ExecuteCommand(new AddControlPointCommand(this.LineSketchObject, new Vector3(1, 4, 2)));
Invoker.ExecuteCommand(new AddControlPointCommand(this.LineSketchObject, new Vector3(1, 5, 3)));
Invoker.ExecuteCommand(new AddControlPointCommand(this.LineSketchObject, new Vector3(1, 5, 2)));
Invoker.Undo();
}
}
```
## Workflow
1. Instantiate a sketch world prefab. Easy access to prefabs is provided through the DefaultReferences asset at `SharedAssets/Assets/DefaultReferences.asset`.
2. Create sketch objects and groups from prefabs and add them to the sketch object world. Execute commands using a CommandInvoker object for undo and redo functionality. All scripts are in the VRSketchingGeometry namespace.
4. Serialize or export using methods of the sketch world script.
5. Load serialized sketch world from the serialized xml file for further editing.
The [LegacyExample](./README.md#legacy-example) also shows this process in practice.
## Samples
Various examples are provided under `VRSketchingGeometryPackage/Samples`.
These can be imported via the Unity Package Manager.
(see [Import the examples](./README.md#import-the-examples))
### Shared Assets
Contains all the assets required to run the examples.
Can be used as a reference for the creation of own assets.
### [Example Scenes](./Samples/ExampleScenes/Scenes/README.md)
Contains various examples. For further details please refer to [this readme](./Samples/ExampleScenes/Scenes/README.md).
### Legacy Example
Contains a static scene with various messy test scripts and corresponding game objects.
## Notes
This is a conversion from the plugin version (https://github.com/tterpi/VRSketchingGeometry) to a package version.
Originally based on code from: https://github.com/bittermanq/KochanekBartelsSplines
## Tests
There are unit tests using Unity Testing Framework. (https://docs.unity3d.com/Packages/[email protected]/manual/index.html)
They mostly cover the undoable commands and the generation and applying of data objects.
Coverage of the unit tests should be expanded.
**Before you can run the tests, you have to make sure the `CommandTestScene` is added in the Build Settings**
The tests are located at `Assets/VRSketchingGeometryPackage/Tests`.
To do that go to "File>Build Settings..." and check if `VRSKetchingGeometryPackage/Tests/Scenes/CommandTestScene` is present there.
If that's not the case you have to add it.
**To run the tests you have to open the Test Runner**
You can find it under "Window>General>Test Runner".
Once the Test Runner is open, click on "Play Mode".
You can then select and perform the tests of your choice!
