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 4d68b50ede main: minor bugfix		2024-10-08 17:11:14 +02:00
.github/workflows	main: minor bugfix	2024-05-17 18:02:18 +02:00
dist	better support for camera-switching/animation	2024-10-07 19:02:52 +00:00
doc	main: update documentation	2024-10-07 19:03:02 +00:00
example	better support for camera-switching/animation	2024-10-07 19:02:52 +00:00
src	main: minor bugfix	2024-10-08 17:11:14 +02:00
test	fixed voodoo bug (xrwg lines messing with src scaling: always use xrf.add() ) + activated AGPL	2024-08-01 16:25:05 +02:00
.domains	pages: work in progress [might break]	2024-07-10 15:00:28 +02:00
.gitignore	feat/godot wip	2024-05-10 13:41:20 +02:00
.gitmodules	moved godot repo to its own codeberg repo to submit as godot extension	2024-05-20 10:03:45 +02:00
.vimrc	updated vimrc	2023-11-16 14:58:51 +01:00
LICENSE	fixed voodoo bug (xrwg lines messing with src scaling: always use xrf.add() ) + activated AGPL	2024-08-01 16:25:05 +02:00
README.md	main: update documentation	2024-05-20 10:21:46 +02:00
build.hxml	main: minor bugfix	2024-05-20 11:50:28 +02:00
index.glb	main: minor bugfix	2024-10-08 17:11:14 +02:00
index.html	main: update documentation	2024-10-07 19:03:02 +00:00
make	fixed voodoo bug (xrwg lines messing with src scaling: always use xrf.add() ) + activated AGPL	2024-08-01 16:25:05 +02:00
other.glb	main: minor bugfix	2024-10-08 17:11:14 +02:00
shell.nix	debug	2024-08-06 10:35:57 +02:00

README.md

A tiny specification for viewing 3D models 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 ❤

Documentation / Website

https://xrfragment.org

Getting started

https://xrfragmenorg

available parser-implementations

javascript (+example)
javascript module
python (+example)
lua (+example)
haXe (allows exporting to various programming languages)
Godot exports to all platforms

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

Godot (>=v4.3.1)

$ ./make install godot       # this installs the godot-xr-tools addon

NOTE: the godot project is in src/xrfragment/godot (open the folder in godot)