Skip to content

Commit

Permalink
Merge branch 'develop'
Browse files Browse the repository at this point in the history
  • Loading branch information
TiborUdvari committed Sep 10, 2024
2 parents 68c2e85 + 5904fcf commit 71c2711
Show file tree
Hide file tree
Showing 6 changed files with 323 additions and 48 deletions.
14 changes: 4 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,23 +18,17 @@ p5.xr is an add-on for [p5.js](https://p5js.org/), a Javascript library that mak

p5.xr sketches can be run with [p5's online editor.](https://editor.p5js.org/) All of the existing p5 functionality works, and in addition, p5.xr allows you to:
- __Virtual Reality__
- Run any 2D or 3D p5 sketch in mobile VR with Google Cardboard
- Do the above but with Desktop VR (Vive and Oculus)
- Run any 2D or 3D p5 sketch in VR ( mobile, desktop or standalone device )

- __Augmented Reality__
- Make sketches that use Augmented Reality with any device that supports ARCore.
- Use marker-based AR on any mobile device <small><em>Coming Soon</em></small>
- Set anchors and detects planes in your environment --- <small><em>Coming Soon</em></small>

- __Raycasting__
- Do some simple raycasting for gaze-based interaction in both AR and VR
- Make sketches that use Augmented Reality with any device that supports immersive AR Session

## Getting Started
1. Use the [the most recent version of p5.js](https://p5js.org/download/) or at least version `1.7.0`.
1. Use the [the most recent version of p5.js](https://p5js.org/download/)
2. Check out the [Device and Browser Support Section](https://stalgiag.github.io/p5.xr/#/quick-start/device-support).
3. Add p5.xr to your project. This can be done most easily by adding the script link to a CDN in the `<head>` of your HTML file underneath the p5 link:
```
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.9.2/p5.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.10.0/p5.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/p5.xr/dist/p5xr.min.js"></script>
```
4. Change the `createCanvas()` call in your p5 WEBGL sketch to `createVRCanvas()` and put it in `preload()` -or-
Expand Down
23 changes: 11 additions & 12 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,19 +9,18 @@ p5.xr is an add-on for [p5.js](https://p5js.org/), a Javascript library that mak

p5.xr sketches can be run with [p5's online editor.](https://editor.p5js.org/) All of the existing p5 functionality works, and in addition, p5.xr allows you to:
- __Virtual Reality__
- Run any 2D or 3D p5 sketch in mobile VR with Google Cardboard
- Do the above but with Desktop VR (Vive and Oculus)
- Run any 2D or 3D p5 sketch in VR ( mobile, desktop or standalone device )

- __Augmented Reality__ <small><em>All AR features are waiting for the AR module spec to be implemented in browsers</em></small>
- Make sketches that use Augmented Reality with any device that supports ARCore. <small><em>Coming Soon</em></small>
- Use marker-based AR on any mobile device <small><em>Coming Soon</em></small>
- Set anchors and detects planes in your environment --- <small><em>Coming Soon</em></small>

- __Raycasting__
- Do some simple raycasting for gaze-based interaction in both AR and VR
- __Augmented Reality__
- Make sketches that use Augmented Reality with any device that supports immersive AR Session

## Getting Started
1. Make sure that you have [the most recent version of p5.js](https://p5js.org/download/).
1. Use the [the most recent version of p5.js](https://p5js.org/download/)
2. Check out the [Device and Browser Support Section](https://stalgiag.github.io/p5.xr/#/quick-start/device-support).
3. [Try out one of the Examples](https://stalgiag.github.io/p5.xr/#/quick-start/examples)!
4. Check out the [Releases section of the Github repo](https://github.com/stalgiag/p5.xr/releases) if you want to run this locally.
3. Add p5.xr to your project. This can be done most easily by adding the script link to a CDN in the `<head>` of your HTML file underneath the p5 link:
```
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.10.0/p5.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/p5.xr/dist/p5xr.min.js"></script>
```
4. Change the `createCanvas()` call in your p5 WEBGL sketch to `createVRCanvas()` and put it in `preload()` -or-
5. [Try out one of the Examples](https://stalgiag.github.io/p5.xr/#/quick-start/examples)!
3 changes: 2 additions & 1 deletion docs/_sidebar.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,10 @@
- __GENERAL__
- [General Info](README.md)
- [Community](general/community.md)

***
- __QUICK START__
- [Device and Browser Support](quick-start/device-support.md)
- [Device and Browser Support](webxr-test.html)
- [Examples](quick-start/examples.md)
***
- __REFERENCE__
Expand Down
2 changes: 1 addition & 1 deletion docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
<script>
window.$docsify = {
auto2top: true,
coverpage: true,
coverpage: false,
executeScript: true,
subMaxLevel: 2,
loadSidebar: true,
Expand Down
24 changes: 0 additions & 24 deletions docs/quick-start/device-support.md

This file was deleted.

Loading

0 comments on commit 71c2711

Please sign in to comment.