a tiny specification for (viewing) 3D models (metadata) as linkable AR/VR websites. Address and Control anything inside a 3D model with W3C Media Fragments and URI Templates. Simply SURF a 3D file-verse and design for a Spatial Open Internet with the highest degree of interoperability. https://xrfragment.org
Go to file
Leon van Kammen a456cd8264 work in progress [might break] 2024-03-12 11:32:59 +01:00
.github/workflows CI fix 4: change version of action 2024-01-30 12:07:59 +01:00
dist temporary disable accessibility + improve gaze and movement for phone 2024-03-01 13:35:36 +00:00
doc updated docs 2024-02-29 14:07:20 +00:00
example work in progress [might break] 2024-03-12 11:32:59 +01:00
src work in progress [might break] 2024-03-12 11:32:59 +01:00
test work in progress [might break] 2024-02-28 09:05:56 +01:00
.gitignore updated gitignoignore 2024-02-29 09:56:39 +00:00
.vimrc updated vimrc 2023-11-16 14:58:51 +01:00
LICENSE update documentation 2023-08-08 13:22:19 +02:00
README.md update documentation 2023-12-07 19:53:09 +01:00
build.hxml wip 2023-08-04 09:11:26 +02:00
index.html doc: added descriptive metadata video 2024-02-29 16:15:30 +00:00
make wip 2024-02-29 09:57:20 +00:00
shell.nix work in progress [might break] 2024-01-03 14:23:34 +00:00

README.md

Actions Status

Documentation / Website

https://xrfragment.org

Getting started

Here are various ways to enhance your 3D assets/scenes with XR Fragments:

difficulty how notes
1 easiest the xrfragment.org Sandbox open 3D file (fbx/gltf) in Blender, add custom properties, and load exported files into the sandbox
2 easy hosted sandbox by forking xrfragment-helloworld Basically #1 but it will be hosted for free at your own github URL
3 developer fork xfragment-aframe-helloworld requires javascript- and aframe.io developer-knowledge
4 developer fork xfragment-three-helloworld requires javascript- and threejs developer-knowledge
5 developer++ use a parser-library below lowlevel approach, more suitable for other scenarios

available parser-implementations

See documentation for more info

development

Pre-build libraries can be found in /dist folder
If you really want to build from source:

$ nix-shell           # nix-users: drops you into a dev-ready shell 
$ ./make install      # debian-users: install deps via apt-get
$ ./make build && ./make tests

NOTE #1: to rebundle the THREE/AFRAME javascripts during dev run ./make build js NOTE #2: to regenerate the parser in various languages (via haxe), run ./make build parser

Credits